Creating and Managing Application Keys Creating and Managing Application Keys

Creating and Managing Application Keys

Myron Myron

Open the Application Keys page

Make sure you have B2 Cloud Storage enabled in your account. Then click on App Keys in the left-hand menu to open the Application Keys page.

 

appkeyspage.png

 

Add a New Application Key

Below the Master Application Key section is the Your Application Keys section. Click on Add a New Application Key here.

addnewappkey2.png

Specify Key Settings and Permissions

 Screen_Shot_2020-08-11_at_10.21.28_AM.png

 

In the pop-up panel, give the new key a name and specify its settings and permissions. Then click Create New Key.

 

Here's what each setting means:

 

Setting API value Function
Name of Key:
keyName
Alias for key (only for user identification in interface)
Allow access to Bucket(s): 
bucketName
Allow access to ALL Buckets or specify 1 Bucket
Type of Access:
capabilities
Read and Write options
Allow List All Bucket Names:
listAllBucketNames 
(Only selectable when access is limited to a single Bucket) Allow/disallow listing all bucket names including bucket creation dates (required for S3 List Buckets API)
File name prefix:
namePrefix
Limit access to file names that start with specified prefix
Duration (seconds):
validDurationSeconds
Limit time before authorization expires

 

 

Please note: the option to list all bucket names must be selected if your key is restricted to a single bucket. If not selected it will result in an authorization error.

 

listallbucketnames.png

 

Save new App Key information

You will see the newly generated Application Key information appear in a blue panel. Copy and save the information to use later. This panel will disappear when you leave the page. 

appkeygenerated.png

Use the App Key pair to connect to your Bucket

These are the two values you will need for authorizing via API:

  • keyID
  • applicationKey

Note the keyName value is not used for authorization, but helps identify the key by name.

 

The "applicationKey" value only appears once

When you leave the page or create a new App Key, the blue panel will disappear and the applicationKey value will no longer be retrievable. 

Your App Keys page will only display the keyName and keyID values for your existing keys, but not the applicationKey. If you misplace your applicationKey, simply generate a new App Key for a new set of values.

 

Copying key values may not work properly

If you are highlighting an entire value with your mouse cursor and copying the selection, please note that it may copy extra formatting in the form of hidden characters. It's a good idea to check for these hidden characters if you're pasting the value into a program for authorization.

 

Delete an Application Key

To delete an existing Application Key, click the Delete Key button. The key will no longer be valid for authorization and cannot be restored. This is one way to revoke access if needed.

deletekey.png