API Tokens
Overview
API tokens can be used authenticate accounts (both local Nucleus and Single Sign-On accounts) from automated clients and systems that cannot log in interactively (e.g., batch processing, IoT robots, etc.)
API Tokens are generated using Nucleus Navigator. When generating a token, it is only visible during creation time (due to security), however it can be deleted (and re-created, if necessary), at any time.
Token Generation
Within Nucleus Navigator, right-click the Nucleus Server where you want to create the token, then click API Tokens from the menu:
The API Tokens window will display as shown:
Specify a unique name for the token and enter it into the Token Name field, then click Create.
The token will be displayed in the window:
Click Copy to copy the generated token to your workstation’s clipboard.
Warning
Do not close the API Tokens dialog window until you have copied the token as once the window is closed, it cannot be retrieved.
Using an API Token
To use an API token to authenticate with Nucleus, the following options are available:
Option 1: Logging in interactively: (Entering a username and password into the authentication dialog window.)
Use
$omni-api-token
(specify the string exactly as written including the leading dollar sign) as the usernameUse the generated API token as the password
Option 2: Using client environment variables: (Supported on both Microsoft Windows and Linux.)
Variable:
OMNI_USER
, Value:$omni-api-token
(specify the string exactly as written including the leading dollar sign) as the usernameVariable:
OMNI_PASS
, Value: Use the generated API token as the password