API settings

The management API requires a secure account. Create an account in the EPM Configuration area.

ℹ️

Note

For authentication information to access the API, see the EPM-WM API Guide.

Create an API account

When using the EPM Management API, you must set up an account that is used to authenticate access to the API.

Not all API users will require full access to the API. Apply permissions to an account to avoid potential security risks. Configure permissions to the different areas of the API, including:

• Audit
• Insight
• Management
• Reporting
• SCIM
• JIT (formerly URM)

To create the account:

1. Click the Configuration menu, and then click API Settings.

2. Click Create an API Account.

3. Enter a name and description.

   The Client ID and Client Secret are automatically generated. The secret is only visible when initially generated for security reasons.

   You can use the copy icons to copy the values to the API tool you are using. You can access these after the account is created as well.

4. Set the permissions for the account.

5. Click Save API Account.

Generate a client secret

1. Click the Configuration menu, and then click API Settings.
2. Click the Generate new Client secret icon for the API account you use to access the API.
3. Click Generate Secret.
4. The client secret is displayed in the Client Secret column. Copy the secret to the authorization page of the API.

View API account details

View the API account details to see a snapshot of the account properties. The details include:

• Name and description
• Client ID
• Client Secret
• Access permissions

Edit an API account

On the edit page for an API account, you can:

• Change the account name and description
• Copy the client ID
• Generate a client secret
• Change API access

To edit an account:

1. Click the Configuration menu, and then click API Settings.
2. Select Edit API Account from the menu.
3. Change the properties, and click Save API Account.

Delete an API account

1. Click the Configuration menu, and then click API Settings.
2. Click the trash can icon to delete the account.
3. Click Delete Anyway on the confirmation dialog box.