The Asset Administrator can manually add an API key to an account.

To add an API key

  1. Navigate to Asset Management > Accounts.

  2. In Accounts, select an account from the object list.
  3. Click (View Details) from the toolbar.
  4. Navigate to Properties > Secrets.

  5. In the API Keys section, click the New API Key button.

  6. Depending on the type of account, the following information may be required:

    1. Name: Enter the name of the API key. This must match the name used in the platform.

    2. Description: Enter a description of the API key.

    3. Expires: Enter the number of days before the key will expire.

  7. You can also set the API Key to match an existing key for the account. This option does not change the API key information on the platform. This can be done at a later time (using the Set button associated with the API key tile) or a new key will be generated when the key is changed. The following options may appear depending on the type of platform:

    1. Client Identifier: Copy the client identifier from the platform and add it to this field.

    2. Client Secret: Copy the client secret from the platform and add it to the field. Once configured, click  Copy to put it into your copy buffer. You can then log in to your device, using the old client secret, and change it to the client secret in your copy buffer.

    3. Client Secret Identifier (Azure AD only): Copy the client secret identifier from the platform and add it to the field. If the identifier doesn't match, when you attempt to change the API key for the Azure AD platform it will create a new one with the identifier set in Safeguard for SPP.

  8. Click Save.