Contents x
Create and Manage App Keys
    • Print
    • Dark
      Light
    Contents

    Create and Manage App Keys

      • Print
      • Dark
        Light
      Article Summary

      You must generate a master application key (master app key) for your account. The master app key provides complete access to your account. Your master app key becomes invalid if you generate a new one.

      After you generate a master app key, you can create an application key (app key). For more information, see Application Keys.

      Note
      Some of the changes that you make to app keys may take a few minutes. For example, if you generate a new master app key, the old one must be invalidated before the new one is generated.

      Generate a Master App Key

      1. Sign in to your Backblaze account.
      2. In the left navigation menu under Account, click Application Keys.
      3. In the Master Application Key section, click Generate New Master Application Key.
      4. Click Yes! Generate Master Key.
      Notes
      Because your master app key is shown only when you generate it, save your master app key in a secure location if you plan to use it more than once.

      The term "master application key ID" was formerly called an "account ID." If you use an integration in which the terminology was not updated to reflect this change, the master application key ID works in place of your account ID. For a standard app key, you can use that key's keyID in place of an account ID.

      You can find your master app key ID on the Application Keys page.

      Create an App Key

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

      1. Sign in to your Backblaze account.
      2. In the left navigation menu under Account, 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. In the Allow Access to Bucket(s) dropdown menu, select All or a specific bucket.
      5. Select your access type (for example, Read and Write).
      6. Select the optional Allow List All Bucket Names checkbox (required for the Backblaze B2 S3-compatible API List Buckets operation).
      7. Click Create New Key, and note the resulting keyID and applicationKey values.
      Note
      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.

      Delete an App Key

      You can delete an app key to revoke access to a bucket.

      1. In the left navigation menu under Account, click Application Keys.
      2. In the Your Application Keys section, click Delete Key.

      The key is no longer valid for authorization. You will not be able to restore the app key.

      Was this article helpful?
      Related articles
      What's Next