1. REST API for Oracle Enterprise Performance Management Cloud
  2. About the REST APIs for EPM Cloud
  3. Authentication

Authentication

This topic includes important information about authentication for Oracle Enterprise Performance Management Cloud REST APIs.

These REST APIs support basic authentication (name and password). Single Sign-On (SSO) credentials are not supported. If your environment is on Gen 1 Oracle Cloud Infrastructure, use a username in the format identitydomain.username. If your environment is on Gen 2 Oracle Cloud Infrastructure, use only username (without identity domain).

All HTTP requests to the EPM Cloud REST API require authentication.

Every HTTP request to EPM Cloud should supply HTTP Basic Authentication credentials through the Authorization header.

Finding Your Identity Domain

If your environment is on Gen 1 Oracle Cloud Infrastructure, ensure that you are correctly specifying your identity domain when logging into an environment using REST APIs..

Use one of these methods to identify your identity domain:

  • Look in the Activity Report for your environment. The name of the identity domain is displayed at the top left corner of the Activity Report. See "About the Activity Report" in Getting Started with EPM Cloud for Administrators.
  • Derive the identity domain name from the URL that you use to access the environment. For example, in this fictitious URL, https://epm-exampleDomain.epm.dataCenter.oraclecloud.com/, the identity domain name is exampleDomain.

    The test and production environments of a subscription usually share the same identity domain. For example, for test environments like as this fictitious URL, https://epm-test-exampleDomain.epm.dataCenter.oraclecloud.com/, the identity domain can be derived as the string enclosed between "test-" and the next ".", in this case, exampleDomain.

    For production environments like this fictitious URL, https://epm-exampleDomain.epm.dataCenter.oraclecloud.com/, the identity domain can be derived as the string enclosed between the first "-" and next ".", in this case, exampleDomain.

    Note: In this guide, URLs are shown in the following format: https://<SERVICE_NAME>-<TENANT_NAME>.<SERVICE_TYPE>.<dcX>.oraclecloud.com/