REST API for Oracle Managed File Transfer Cloud Service 12.2.1

Authentication

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

Note: Ensure that you have the appropriate log-in credentials for triggering a source in Oracle Managed File Transfer Cloud Service.

You access the Oracle Managed File Transfer Cloud Service 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.
User name and password for your Oracle Managed File Transfer Cloud Service account.
Custom header, X-ID-TENANT-NAME, to identify the identity domain.

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.
Use the -u cURL option to pass the user name and password for your Oracle Managed File Transfer Cloud Service account (for example, jsmith and superstrongpassword).
Use the -H cURL option to pass the X-ID-TENANT-NAME custom header .

The following example cURL command returns detailed information for the instances created by an event with an eventSessionId of 799AE14A-9E37-42B9-9789-8F005039953E:

curl -u jsmith:superstrongpassword
 -H "Content-Type:application/json"
 -H "Accept: application/json"
 -H "X-ID-TENANT-NAME:ExampleIdentityDomain"
 -X GET https://jaas.oraclecloud.com/paas/service/mftapp/rest/v1/events/799AE14A-9E37-42B9-9789-8F005039953E/instances?inDetail=true

Note:

This example shows the URL prefix for the United States (jaas). For information about the URL prefixes for other regions of the world, see Send Requests.