Authentication

REST API for Oracle Enterprise Manager uses a certificate authority (CA) certificate to enable clients to connect securely to the server. This is the same CA certificate used for securing Enterprise Manager.

You access the Oracle Enterprise Manager REST resources over HTTPS and must provide the following information for authentication:

• An SSL certificate authority (CA) certificate file or bundle to authenticate against the Verisign CA certificate.

• URL, user name, and password for your Oracle Enterprise Manager account.

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.

• Pass the user name and password for your Oracle Enterprise Manager account (for example, <username> and <password>) using the -u cURL option.

• Pass the <request-header> custom request header using the -H cURL option.

• You will be prompted for your Oracle Enterprise Manager password if you don't include it in the header.

The following provides an example cURL command:

curl -X GET -u <username>:<password> -H <request-header>:<value> https://<subdomain>.<domain>.com:<port>/<resource-path>

Example:

curl -X GET -u sysman:xxxxxxx -H <request-header>:<value>  https:// EM_HOST:EM_CONSOLE_HTTPS_PORT/em/api/incidents