Basic Authentication - for Classic and OCI (Gen 2) Environments

In EPM Cloud environments on Classic or OCI (Gen 2) architecture, the REST APIs support basic authentication (name and password).

If your environment is on Classic Oracle Cloud Infrastructure, use a username in the format identitydomain.username.

If your environment is on OCI (Gen 2) Oracle Cloud Infrastructure, you can use basic authentication by supplying a username in the format of identitydomain.username or only username (without identity domain).

HTTP requests to Oracle Enterprise Performance Management Cloud should supply HTTP Basic Authentication credentials through the Authorization header.

Finding Your Identity Domain

If your environment is on Classic 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/

When using PowerShell to call EPMCloud REST API, ensure that the Authorization header is always specified. For example:

$headers = @{
"Authorization" = "Basic " + [System.Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes($userName+":"+$userPassword))
}
Invoke-RestMethod -Method 'Get' -Uri $url -Headers $headers