API Keys

Defining the API Key

To be able to access the Rest API, it is necessary to generate and save at least one "User Menu path separator API Key" combination.

exclamation_mark_red

PLEASE NOTE:

  • To be able to generate an API Key, users will need to have the Role "Policy Role - Maintain API Key" assigned to them.
  • There is only one type of API Key - to grant full access to the Rest API.
  • The level of access to the SAI360 application via the Rest API is controlled by the Component Security Settings of the user for whom the Key is being generated.
  • You can create and apply multiple API keys to the same user, but the system will ensure that the combination of Key Name + User is unique.

Setting up an API Key requires these steps:

  • Navigate Designer Menu path separator Security Menu path separator API Key, and create New.
  • Define a Key Name.
  • Select the User for whom the key is generated in Create For.
    You need to make sure to select a User who has sufficient access rights to perform all the required activities against the SAI360 records.
  • Copy the API Key and save it outside of the web application BEFORE saving the record, as the Key will only be accessible before you do save. Once the record is saved, the Key is no longer displayed, and neither is it retrievable.
  • Should a Key get "lost", then it will be necessary to delete the existing key and create a new one.

Applying the API Key

Once the API Key has been defined, the user/key combination will need to be applied to the Rest API call.

In your tool of choice to run the API (for example 'Postman'), set the following attributes:

  • Authentication type: API Key
  • Key Name: APIKey
  • Value: paste the key
  • Add to: Header

See Also

Grant Use and Design Permissions to a Role

Set Use Permissions for Components

Set Permissions for BI User Console, BI Folders, Reports and Dashboards

Set Use Permissions for Policies

External API Tokens