Configure Access to the Management API

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

For authentication information to access the API, see the EPM 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:

  • SCIM
  • Reporting
  • Audit
  • Management

To create the account:

  1. Click the Configuration menu, and then click API Settings.
  2. Click Create an API Account.

In EPM, the Create an API account dialog box.

  1. 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.

  2. Set the permissions for the account.
  3. 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.

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.