Authenticate

You access Oracle Essbase REST resources over HTTPS, using HTTP Basic authentication.

To use HTTP Basic authentication to validate users, you specify the user name and password for your Essbase account in the Authorization header. The value of the Authorization header should be the base64-encoding of <username>:<password>, specified in the format:

Basic <base64-encoded value>

Many client applications, such as cURL, provide a method that creates this Authorization header for you.

For example, to authenticate using cURL,

  • Set the cURL environment variable, CURL_CA_BUNDLE, to the location of your local CA certificate bundle. For information about CA certificate verification using cURL, see http://curl.haxx.se/docs/sslcerts.html.
  • Supply the -u option to pass your Essbase account user name and password. cURL adds the Authorization header to the request when you send it.

The following example cURL command uses HTTP Basic authentication to retrieve details about the Essbase instance.

curl -i -X GET -u username:password https://myserver.example.com:9001/essbase/rest/v1/about