Authentication

Note::

Ensure that you have the appropriate log-in credentials for creating, managing, and deleting instances of Oracle SOA Cloud Service on Oracle Public Cloud Machine, as described in About Oracle SOA Cloud Service Roles and User Accounts in Using Oracle SOA Cloud Service.

You access the Oracle SOA Cloud Service REST resources over HTTPS and must provide the following information for authentication:

  • User name and password for your Oracle SOA Cloud Service account.

  • Custom header, X-ID-TENANT-NAME, to identify the identity domain.

For example, to authenticate using cURL:

  • Use the -u cURL option to pass the user name and password for your Oracle SOA Cloud Service account (for example, joe@example.com and Mypassword1!).

  • Use the -H cURL option to pass the X-ID-TENANT-NAME custom 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.

The following example cURL command retrieves the details of the ExampleService service instance:

curl -i -X GET -u joe@example.com:Mypassword1! -H "X-ID-TENANT-NAME:ExampleIdentityDomain" https://jaas.oraclecloud.com/paas/service/soa/api/v1.1/instances/ExampleIdentityDomain/ExampleService
Note:: This example shows the URL prefix for the United States ( soacs). For information about the URL prefixes for other regions of the world, see Send Requests.