Creating a Soft Coding Record for a REST Connection

This section has been updated in support of OAuth 2.0, which is supported starting with EnterpriseOne Tools 9.2.2. This type of security allows orchestrations to exchange REST calls and data with Oracle Cloud services and other third-party systems.

1. On the Tools page in the Orchestrator Studio, click the Connections icon.

2. On the Connections page, click New Connection.

3. On Connection Information, complete these fields:

   • Name. Enter a unique name for the connection.

   • Descriptions. Enter a description to identify the connection. For example, if you are creating more than one soft coding record to connect to different locations, you should include the location in the description.

   • Type. Select External Rest.

   • User/Role. Enter the user authorized to run the originating orchestration–the orchestration on the local system that will call the external REST service. The user can be an EnterpriseOne user, role, or *PUBLIC.

   • Environment. Enter the environment where the local orchestrations reside.

4. On the Service Information tab, enter the URL for accessing the REST services in the Endpoint field.

   Important: Oracle strongly recommends that all external calls use the SSL protocol (https) with a certificate from a reputable certificate authority.

5. Click the Security tab and from the Security Policy drop-down list, select the type of security you want to use and then follow the appropriate steps:

   • For Basic Authorization, complete these fields:

     • User

     • Password

   • For OAuth 2.0 Client Credential (starting with EnterpriseOne Tools 9.2.2):

     1. In the Token Endpoint URL field, enter the address of the server that will provide the OAuth token.

     2. In the Client Id field, enter ID of the client.

     3. In the Client Secret field, enter the value for client secret you have received after registering the application.

     4. If the client requires additional header parameters, in the OAuth Parameters area, click Add.

        The system adds a new row in the OAuth Parameters table.

     5. Enter a name for the parameter and its value in the table.

6. If the connection is to an external server, on the Proxy tab, specify a proxy server for accessing the external server:

   • Proxy Host. Enter the URL of the proxy server.

   • Proxy Port. Enter the port number of the proxy server.

   • Use Proxy. Toggle right to enable the proxy.

7. On the HTTP Headers tab, perform the following steps to add a header record that will be used in the HTTP request to execute the external REST service:

   1. Click the Add button.

   2. In the pop-up box, complete these fields:

      Name.

      Value.

   3. Slide the Encrypt toggle to the right to enable encryption.

   4. Click Add.

      The Orchestrator Studio adds a row to the grid in the HTTP Headers tab.

   5. Add additional header records as necessary.

8. When complete, click Save at the top of the Connections page.