The connectivity agent is used to establish the communication between SaaS and on-premises applications. Before you create the connection with on-premises applications in Oracle Integration, you must have to download the connectivity agent and install it on the host machine.

There are various ways to download the connectivity agent. So, in this short article, we’ll describe various options to download the connectivity agent of Oracle Integration.

  1. Using Oracle Integration Console

The easiest way to download the connectivity agent is using the Oracle Integration console. To download it using the Oracle Integration console follow the below steps:

  1. Login into the Oracle Integration Console.
  2. Navigate to the Integrations -> Agents page
  3. Click on the Download -> Connectivity Agent option from the upper right corner of the page.

This will start downloading the connectivity agent and a file with the name oic_connectivity_agent.zip will be downloaded on your default download location. You can then transfer it to the host machine where you want to install a connectivity agent.

2. Using Postman and similar tools

This option is pretty useful to download the connectivity agent from a client tool such as Postman and transfer it to the host machine to install it.

To use this option, you must know the correct endpoint or URL to download the connectivity agent. Below is the endpoint to download it using the client tool:

GET https://<OIC_HOST_NAME>/ic/api/integration/v1/agents/binaries/connectivity

Note: You need to replace OIC_HOST_NAME with the actual Oracle Integration hostname.

To run this endpoint, you must add the Basic Authentication as the authentication scheme.

The following screenshot shows how to hit the endpoint to download the connectivity agent using Postman.

It will download the response.zip file and you can save it on your local drive. Once downloaded transfer it to your local drive and install it.

3. Using curl command

This option is useful when you don’t have permission to access the UI of the host machine (where you will install the agent) such as a Linux machine, then this option will help you to directly download it on the host machine using curl command. Below is the curl command to download the agent using SSH(Putty, etc).

curl -X GET  https://<OIC_HOST_NAME>/ic/api/integration/v1/agents/binaries/connectivity -H 'Authorization: Basic EncodeBase64<username:password>' -o /path/to/download/oic_connectivity_agent.zip

Below screenshot shows the output of the curl command:

Note: You need to replace OIC_HOST_NAME with the actual Oracle Integration hostname. Also, replace the EncodeBase64<username:password> with the encoded base64 string of username:password of OIC. You can use an online tool to convert the username:password into a base64 string.

You can also look at my complete video also:

Further readings:

Convert JSON to String Oracle Integration

Oracle Integration Message Packs and Pricing

Business Identifiers in Oracle Integration

You can subscribe to my YouTube channel for further reading.