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.

API Keys page

Fields on the API Keys screen

Field

Description

Key ID

Randomly generated unique alphanumeric identifier of the key.

Type

The value can be Internal or External.

  • Internal. Enables Verint products to communicate with Verint servers. These keys are needed when a Verint product, such as Face to Face Interaction Recorder or Screen Capture, runs on a non-Verint installed server or system, such as an agent desktop.

  • External. Allows published APIs to access product components and services. Third parties use external keys to use the Impact 360 services.

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.

The system checks the expiry date periodically, so there may be a delay up to two hours.

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.

The system checks the expiry date periodically, so there may be a delay up to two hours.

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 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 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 iconThe Edit icon . Opens the properties dialog box for the selected API key.

Delete icon The 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.

Using API Keys when automating tasks

Generate an API Key

Copy an API Key

Display an API Key value

Delete an API key