Setting Up the OIC Connectivity Agent
Here are the key steps to get the OIC Connectivity Agent
running on your EBS server:
•
The server must have outbound internet access on port
443
•
An OIC instance must be provisioned in Oracle Cloud
Step 1: Create an Agent Group in OIC Console
Log into OIC, go to Settings → Agents, and create a new Agent Group. Give it a meaningful name like EBS_AGENT_GROUP. Note the Agent Group Identifier.
Step 2: Get IDCS OAuth Credentials
Navigate to your IDCS console, find your OIC application under
Oracle Cloud Services, and go to the OAuth Configuration tab. You will need:
•
Client ID
•
Client Secret
•
Primary Audience (used to construct the correct scope)
Step 3: Download and Configure the Agent
Download the agent installer ZIP from OIC Console (Settings →
Agents → Download). Extract it on your server and edit the InstallerProfile.cfg
file:
oic_URL=https://<your-instance>.integration.<region>.ocp.oraclecloud.com
agent_GROUP_IDENTIFIER=EBS_AGENT_GROUP
oic_IDCS_URL=https://idcs-<id>.identity.oraclecloud.com
oic_CLIENT_ID=<your_client_id>
oic_CLIENT_SECRET=<your_client_secret>
oic_SCOPE=https://<primary_audience>urn:opc:resource:consumer::all
Important:
The oic_URL must be the runtime instance URL, not the design
console URL. The scope must use the Primary Audience value from IDCS OAuth
Configuration — not a generic scope value.
Step 4: Run the Installer
java -jar
connectivityagent.jar
When you see "Agent Started Successfully", your
agent is connected. Configure it as a Linux systemd service so it auto-starts
on server reboot.
Setting Up Integrated SOA Gateway (ISG)
ISG is already bundled with EBS but requires configuration
before it can be used.
Step 1: Configure ISGADMIN User
ISG requires a dedicated admin user called ISGADMIN. Reset its
password using the FND API in SQL:
v_result BOOLEAN;
BEGIN
v_result := fnd_user_pkg.changepassword(
username => 'ISGADMIN',
newpassword => '<your_password>'
);
COMMIT;
END;
/
Step 2: Run ISGRestSetup.pl
This is the official Oracle script to configure ISG REST
services. Run it as the oracle user with the EBS-bundled Java (not Java 17):
export
JAVA_HOME=$EBS_BUNDLED_JDK_PATH
perl
$FND_TOP/patch/115/bin/ISGRestSetup.pl
You will be prompted for the APPS password and WebLogic admin
credentials. When complete you should see: Configuration script completed
successfully.
Step 3: Deploy EBS APIs
Log into EBS and navigate to the Integrated SOA Gateway
responsibility → Integration Repository. Search for the API you need (for
example HZ_PARTY_V2PUB for Customer/Party data, or PER_EMPLOYEES for HR data).
Enter a Service Alias and click Deploy. The first deployment can take 15 to 30
minutes.
Step 4: Grant API Access
On the Grants tab, grant access to the EBS user that OIC will
authenticate as. This is a critical step that is easy to overlook.
Step 5: Test the Deployed API
Before building any OIC integration, test the API directly:
curl -u
sysadmin:<password> \
"http://<ebs-host>:8000/webservices/rest/<ServiceAlias>"
\
-H
"Accept: application/json"
A valid response confirms the API is ready for OIC to consume.
