1. REST API for Oracle Application Container CloudREST API for Managing Applications
  2. Authentication

Authentication

Note:

Ensure that you have the appropriate log-in credentials for creating, managing, and deleting applications in Oracle Application Container Cloud. You will also need log-in credentials for your Oracle Cloud Storage Service account. For more information, see About Application Container Cloud Service Roles and Users in Using Oracle Application Container Cloud Service.

You access the Oracle Application Container Cloud REST resources over HTTPS. Provide the following information for authentication:

  • User name and password for your Oracle Application Container Cloud account.

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

If you are using Oracle Identity Cloud Service to control access to Oracle Application Container Cloud Service, you must set the X-ID-TENANT-NAME header to your Oracle Identity Cloud Service account number. This number is in the format idcs-xnxnxnxnxnxn and appears in the following places:

  • The Oracle Identity Cloud Service login URL

  • The URL on the About Service page for Oracle Identity Cloud Service

  • The Activate your account email you received after signing up for Oracle Cloud

To use Oracle Identity Cloud Service to control access to a specific application, include the authType form parameter when creating or updating the application. To learn more, see Using Oracle Identity Cloud Service with Oracle Application Container Cloud Service.

For example, to authenticate using cURL:

  • Use the -u cURL option or the -H cURL option with the Authorization header to pass the user name and password for your Oracle Application Container Cloud account (for example, joe@example.com and myPassword).

  • Use the -H cURL option to pass the X-ID-TENANT-NAME custom header .

The following example shows how to deploy a sample Java application by submitting a POST request using cURL. Because there is no archive binary specified, the welcome application will be deployed. 
curl -i -X POST -H "Authorization:joe@example.com:myPassword" -H "X-ID-TENANT-NAME:ExampleIdentityDomain" \
-H "Content-Type: multipart/form-data" \
-F "name=myApplicationName" -F "runtime=java" -F "subscription=Hourly" \
https://apaas.us.oraclecloud.com/paas/service/apaas/api/v1.1/apps/ExampleIdentityDomain