Creating an API key

To allow applications to communicate directly with platform services such as IBM® X-Force® Exchange, you must provide an API key.

About this task

The API key is a two part string, consisting of a unique identifier and a secret token, which is used for authentication to the API endpoint. The Unique Identifier is comparable to a user ID and has a set of access rights specific to an identity associated with it. The secret token, comparable to a password, is a code that is used together with the Unique Identifier to verify the identity of the calling process to the API.

Important:

To keep your key secure, delete the key after 90 days and create a new one.

Procedure

  1. In the home page, click the Menu icon.
  2. Under General settings, click API Keys and then click Create API key.
  3. In the API key name field, enter a unique and meaningful name that identifies the key for you.
  4. Click Generate.

Results

When your key is created, the Create API key pane provides the API Key details: a unique identifier and a secret token are assigned.

Important: After you click Done, you cannot retrieve the secret token. To store your key details in a secure location, copy the key code and the secret token, or download them in a text file (.txt).

Viewing an API key

You can view a list of existing from the API keys page.

Procedure

  1. In the home page, click the Menu icon.
  2. Under General settings, click API Keys.
  3. On the API keys page, you can see details for the existing keys that you created. The row of values for each key contains the name that you provided and the unique identifier that is assigned. Last modified contains the creation date or the most recent date when you modified the key name.

Deleting an API key

You can easily delete an API key that you no longer need.

Procedure

  1. In the home page, click the Menu icon.
  2. Under General settings, click API Keys.
  3. Hover over the row that contains the key you want to delete.
  4. Click the delete icon.
  5. Click Delete.