1. REST API for Oracle Data Hub Cloud ServiceREST API for Oracle Data Hub Cloud Service
  2. Authentication

Authentication

Ensure that you have the appropriate log-in credentials for accessing Oracle Data Hub Cloud Service, and the appropriate role for creating, managing, and deleting service instances.

You must have a valid Oracle Cloud account with Oracle Data Hub Cloud Service subscription.

Oracle Data Hub Cloud Service uses a certificate authority (CA) certificate, issued by Verisign, to enable clients to connect securely to the server.

You provide credentials to the REST endpoints as HTTP request headers, and access the REST endpoints over HTTPS to ensure that these credentials are not visible to third parties. Specifically you must provide this information:

  • An SSL certificate authority (CA) certificate file or bundle to authenticate against the Verisign CA certificate. Oracle Cloud uses a CA certificate issued by Verisign to enable clients to connect securely to the server.

  • The standard Authorization header, which specifies the Oracle Data Hub Cloud Service user name and password. The user name and password are separated by a colon and encoded using Base64 encoding.

  • A custom header, X-ID-TENANT-NAME, that identifies the Oracle Data Hub Cloud Service identity domain for this user. This identity domain is typically also part of the endpoint URL.

For example, to authenticate using cURL:

  • Use the -u option to set the user name and password, which cURL uses to create the Authorization header.

  • Use the -H option to set the X-ID-TENANT-NAME custom request header.

  • When running cURL from a Windows command shell only, set the cURL environment variable, CURL_CA_BUNDLE, to the location of an SSL certificate authority (CA) certificate file or bundle to authenticate against the Verisign CA certificate. Alternatively, you can specify the location of your local CA certificate bundle on the command line, using the --cacert command line option.

    You can download an SSL CA certificate bundle from http://curl.haxx.se/docs/caextract.html or provide your own. For information about CA certificate verification using cURL, see: http://curl.haxx.se/docs/sslcerts.html.

For example:

curl -i -X GET -u "myuser:mypass" \
  -H "X-ID-TENANT-NAME: ExampleIdentityDomain" \
  -H "Accept: application/json" \
  "https://<subdomain>.<domain>.com:<port>/<resource-path>"