API Keys screen reference
To view the API Keys screen, go to System Management Module that allows performing suite-wide system management activities from a single, Web-based application, the Enterprise Manager.. Under License Management, select API Keys.
Fields on the API Keys screen
Field |
Description |
---|---|
Key ID |
Randomly generated unique alphanumeric identifier of the key. |
Type |
|
Enabled |
Indicates whether the key is enabled for use. When generated, keys are enabled by default. A key can only be enabled when the expiry date is in the future or empty (no expiry date is set). |
Expiry date |
Specifies the date and time when the system automatically disables the key. For a key that never expires, leave this field empty. When a key expires, the system disables it, and then deletes the key 7 days after its expiry date. A rotatable key must have an expiry date. Before a rotatable key expires, the system creates a replacement key within the time defined by the Overlap Hours. After the key is saved and before it rotates (expiry time less overlap hours), you can change its expiry date.
|
Rotatable |
Indicates whether an API key can be rotated, meaning it is periodically replaced with a new key. Keys marked as rotatable require an overlap period and an expiry date. |
Overlap hours |
Specifies when the system creates a replacement API key. This field appears when the Rotatable option is selected. A rotatable key must have an overlap period. Enter the number of hours (from 8 to 72) before the key's expiry date for the system to create a replacement key. After the key is saved and before it rotates (expiry time less overlap hours), you can change the overlap hours. |
Rotated from key |
Indicates the key ID of the previous API key that has been replaced. This field helps in tracking the lineage of API keys, making it easier to manage and audit key rotations. |
Description |
A user-defined description of the purpose of the key. |
Date Issued |
The date and time the key was generated. The date and time format depends on the Regional Format a user selects in the User Preferences settings. |
Key Value |
Displays the alphanumeric value of the key. This field is blank by default. To display the key value, see Actions below. |
Actions |
Contains the icons for the available actions. You must move your mouse over the Actions column to display these icons. Show the key value icon .Displays the alphanumeric value of the selected key in the Key Value column and enables the copy icon. Copy icon . Copies the selected key value to the clipboard. (You must click the Show the key value icon before you can copy the key value.) Edit icon . Opens the properties dialog box for the selected API key. Delete icon . Deletes the selected API key. For a key to be deleted, it must not be enabled or be the only internal API key. |