Establishing the Connection to Oracle Cloud Infrastructure (OCI)

{"URL":["/*.*/awa/pa_view_pa_view_CONN_oci"],"heroDescriptionIdentifier":"ice_hero_CONN_Oracle_OCI","customCards":[{"id":"ice_specific_CONN_Oracle_OCI","title":"Defining the Connection Parameters","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/IG_ORACLE_OCI/*.*/Agent%20Guide/Content/Oracle_OCI_OIC/OCI_OIC_EstablishConnection.htm","languages":["en-us"]},{"id":"ice_Proxy_CONN_Oracle_OCI","title":"Defining the Proxy Parameters","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/IG_ORACLE_OCI/*.*/Agent%20Guide/Content/Oracle_OCI_OIC/OCI_OIC_EstablishConnection.htm","languages":["en-us"]},{"id":"ice_video_CONN_Oracle_OCI","title":"Watch the Video","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/IG_ORACLE_OCI/*.*/Agent%20Guide/Content/Oracle_OCI_OIC/OCI_OCI_Video.htm","languages":["en-us"]},{"id":"ice_related_information_CONN_Oracle_OCI","title":"Related Information","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/IG_ORACLE_OCI/*.*/Agent%20Guide/Content/Oracle_OCI_OIC/OCI_OIC_EstablishConnection.htm","languages":["en-us"]}]}

A Connection object contains the parameters that make the communication between the Agent and the target system possible. These parameters (target system endpoint, login data and so on) are required to authenticate on and connect to the target cloud solution.

As an administrator user, you create the OCI Connection objects that provide the log in data required to establish the connection to the Oracle Cloud Infrastructure system.

As a developer or object designer, you assign the respective Connection object to the Start Integration jobs to create and execute them on OIC without leaving the Automic Web Interface.

The Connection Object definition consists of an Agent-specific page and other pages that are common to all Connection objects.

This topic guides you through configuring the OCI Connection object.

This page includes the following:

Adding an OCI Connection Object

  1. In the Automic Web Interface, go to the Process Assembly perspective. It opens to the Explorer view which contains the list of jobs that are available to you in your system.

  2. You have two options:

    • Right-click anywhere on the list and select Add > Add Object.

    • Click the Add Object button on the toolbar.

  3. On the Add Object dialog, start typing the name of the relevant integration in the Search field.

  4. Select the corresponding Connection object and click Add. The Object Name dialog is displayed.

  5. Enter a descriptive Name.

  6. Optionally, enter a short and descriptive Title that helps you recognize the purpose of the object.

  7. Click OK. A new page opens where you can start with the object definitions.

OCI Page

This page contains a Connection and a Proxy section.

Connection Section

  • Endpoint

    URL pointing to where the Oracle integration services are running.

  • Authentication Type

    The OCI Agent Integration supports OAuth2 authentication.

  • Authentication Endpoint

    URL that clients call to request the authentication token.

  • Client ID

    Identifier as defined in your OAuth2 system.

  • Client Secret

    Encrypted secret value as defined in your OAuth2 system.

  • OAuth2

    The connection object supports OAuth2 v1.0.

  • Resource

    Range of applications that the token will grant access to.

  • OCI Version

    Enter the version you intend to use. Supported are v2 and v3.

    • Integration Instance

      If you use OCI v3, you must define your integration instance.

Proxy Section

If the Oracle Cloud Infrastructure system is behind a proxy server, you define the parameters relevant for the connection to that system in this section.

  • Proxy Host Name

    Host name or IP address of the proxy server to which you want to connect.

  • Proxy Port

    Port used by the proxy server.

  • Proxy Username

    User name used to authenticate the proxy server.

  • Proxy Password

    Password of the user used to authenticate the proxy server.

Common Definition Pages

In addition to the Agent-specific connection parameters, you can also specify optional properties. You do so on the following definition pages:

Once the Connection object is configured, developers and object designers can select it when defining the Start Integration jobs.

See also: