Integrate with Backblaze B2
    • Dark

    Integrate with Backblaze B2

    • Dark

    Article summary is a secure, simple content delivery network (CDN) that delivers global content delivery, file replication, and optimization at lightning speeds. With Backblaze B2 Cloud Storage and, you can share content without the worries of scalable performance tiers or limitations.

    Before you begin, you must have an active account.

    Enable Backblaze B2

    Before you begin: You must have a Backblaze B2 Cloud Storage account. If you already have a Backblaze account and the left navigation menu contains a B2 Cloud Storage section, your account is already enabled for Backblaze B2.

    1. Sign in to the Backblaze web console.
    2. In the user menu in the upper-right corner of the page, select My Settings.
    3. Under Enabled Products, select the checkbox to enable B2 Cloud Storage.
    4. Review the Terms and Conditions, and click OK to accept them. 

    Create a Backblaze B2 Bucket

    1. Sign in to the Backblaze web console.
    2. In the left navigation menu under B2 Cloud Storage, click Buckets.
    3. Click Create a Bucket.
    4. Enter a name for your bucket. Bucket names must be at least six characters and globally unique.
      A message is displayed if your bucket name is already in use.
    5. Select a privacy setting: Private or Public. Files that are in a private bucket require authentication to perform an action, for example, downloading. Public buckets do not require authentication so you can easily share files. You can change a bucket's privacy settings at any time.
    6. If applicable, enable a Backblaze B2 server-side encryption key.
    7. Enable Object Lock to restrict a file from being modified or deleted for a specified period of time.
    8. Click Create a Bucket, and copy the value that is in the Endpoint field; you may need this value later.
    9. Click Lifecycle Settings to control how long to keep the files in your new bucket.
    If this is your first time creating a public bucket, complete the following tasks to ensure that you have the correct permissions to create a public bucket:

    1. Verify your email address.
    2. Have a payment history on file, or use the credit card form to pay a small fee that is credited to your account balance.

    Create a Backblaze B2 Application Key

    You must create an application key if your Backblaze B2 bucket is set to Private

    Application keys control access to your Backblaze B2 Cloud Storage account and the buckets that are contained in your account.

    1. Sign in to the Backblaze web console.
    2. In the left navigation menu under B2 Cloud Storage, click Application Keys.
    3. Click Add a New Application Key, and enter an app key name.
      You cannot search an app key by this name; therefore, app key names are not required to be globally unique.
    4. Select All or a specific bucket in the Allow Access to Bucket(s) dropdown menu.
    5. Optionally, select your access type (Read and Write, Read Only, or Write Only).
    6. Optionally, select the Allow List All Bucket Names checkbox (required for the B2 Native API b2_list_buckets and the S3-Compatible API S3 List Buckets operations).
    7. Optionally, enter a file name prefix to restrict application key access only to files with that prefix. Depending on what you selected in step #4, this limits application key access to files with the specified prefix for all buckets or just the selected bucket.
    8. Optionally, enter a positive integer to limit the time, in seconds, before the application key expires. The value must be less than 1000 days (in seconds).
    9. Click Create New Key, and note the resulting keyID and applicationKey values.
    When you create a new app key, the response contains the actual key string, for example N2Zug0evLcHDlh_L0Z0AJhiGGdY. You can always find the keyID on this page, but for security, the applicationKey appears only once. Make sure you copy and securely save this value elsewhere.

    Upload Files to a Backblaze B2 Bucket

    You can upload files to a Backblaze B2 bucket from your local drive. The maximum single file size that you can upload through the Backblaze web console is 500 MB. If you need to upload larger files, click here for more information. You can also use the B2 Native API or the Command-Line Interface to upload files.

    1. Sign in to the Backblaze web console.
    2. In the left navigation menu under B2 Cloud Storage, click Buckets.
    3. In your bucket details, click Upload/Download and click Upload.
    4. Drop your images from your local drive into the dialog box, or manually select your files.
    5. In the left navigation menu under B2 Cloud Storage, click Browse Files to see your uploaded file and click the image filename to see more details.

    Locate Your S3 URL

    1. In the left navigation menu under B2 Cloud Storage, click Browse Files.
    2. Select the bucket that you created.
    3. Click the information icon next to any of the files in the bucket.
    4. Copy the protocol and hostname that is in the S3 URL field, for example,

    Configure a Public CDN Pull Zone

    Follow these steps to create a public drop zone using the URL that you copied in the Locate Your S3 URL task. 

    Configure a Private CDN Pull Zone

    If the Backblaze B2 bucket that you created is private, you must configure your Pull Zone to authenticate with your bucket using S3 authentication. You must Create an Application Key before you follow these steps. If the Backblaze B2 bucket that you created is public, you do not need to follow this procedure.

    1. Sign in to your account. 
    2. In the left navigation menu, select Pull Zones, select Security, and select S3 Authentication
    3. Select the Enable AWS S3 Authentication option.
    4. In the AWS Key field, enter your Backblaze B2 keyID.
    5. In the AWS Secret field, enter your Backblaze B2 applicationKey.
    6. In the AWS Region Name, enter the endpoint value that you copied in the Create a Backblaze B2 Bucket task.
      For information about how to test your configuration, see this article.
    By default, passes a GET request to the root of the pull zone onto Backblaze B2 as an authenticated S3 API request. Backblaze B2 responds with a listing of up to 1,000 objects in the bucket, which returns to the caller. Backblaze strongly recommends that you disable this behavior. To do so, navigate to Settings and under Security in the General tab, enable Block Root Path Access. With this setting enabled, responds to GET requests for the root of the pull zone with a 403 Forbidden error.

    Was this article helpful?