Pre-General Availability: 2024-09-02

Update the Robot Agent's Configuration File

Every robot agent contains a configuration file, which contains properties for the robot agent's name, secrets, and service instance. For every robot agent, you must enter the robot agent's name. Additionally, if the robot agent communicates with a confidential application, you must update several other properties.

1. Get the client secret and scope values from the confidential application.

   These steps are required only if the robot agent communicates with a confidential application that your organization created. If you're using the default confidential application that Oracle created, skip to the next step.

   1. Sign in to the Oracle Cloud Infrastructure Console.
   2. Open the navigation menu and select Identity & Security. Under Identity, select Domains.

      The Domains page is displayed.

   3. If not already selected, select the Compartment that holds the domain with the confidential application.
   4. In the Name column, select the domain that holds the confidential application.

      The Overview page for the domain is displayed.

   5. In the left menu below Identity domain, select Integrated applications.
   6. In the search box above the table, search for the confidential application.

      The name of the confidential application that Oracle created for you ends with RPA_AGENT_DEFAULT_APP, and its description is Integration Cloud Services RPA Agent.

   7. Scroll down, and find the client secret and scope values.

      These values are sensitive, so be mindful of where you place them after copying them.

      Value you need	Where to find it
      Client ID	Below the General Information heading, find the Client ID entry, and copy the value.
      Client secret	Below the General Information heading, find the Client secret entry. Select Show secret, and copy the value.
      Scope	Below the Token issuance policy heading, and then below the Resources heading, review the entries in the table. If multiple entries appear, copy the value that ends with consumer::all.

2. On the computer where you installed the robot agent, open the folder that contains the agent and its related files.
3. Open the InstallerProfile.cfg file in a text editor, such as Notepad.

   The file contains the following properties. The DISPLAY_NAME= property is blank, but the other properties have values specified.

   DISPLAY_NAME=
   IDCS_CLIENT_ID=
   IDCS_CLIENT_SECRET=
   IDCS_SCOPE=
   IDCS_URL=
   SERVICE_INSTANCE_ENDPOINT=
   SERVICE_INSTANCE_ID=

4. Update the properties in the file as needed.

   Property	Value to enter
   DISPLAY_NAME=	If you're using the default confidential application that Oracle created, this is the only property that you need to define. Enter the name of the robot agent in Oracle Integration. Choose a value carefully, and consider creating naming conventions for your robots. For example, you might want to distinguish individuals' local computers from the virtual machines (VMs) that host robots, and you might want to distinguish VMs for each robot.
   IDCS_CLIENT_ID= IDCS_CLIENT_SECRET= IDCS_SCOPE=	If the robot agent uses a confidential application that your organization created, update the values so that they reference the confidential application: IDCS_CLIENT_ID=: Client ID of the confidential application that the robot agent uses. IDCS_CLIENT_SECRET=: Client secret of the confidential application that the robot agent uses. IDCS_SCOPE=: Scope of the confidential application that the robot agent uses. A previous step in this procedure describes how to find these values.
   IDCS_URL= SERVICE_INSTANCE_ENDPOINT= SERVICE_INSTANCE_ID=	Do not update the values of any of these properties, even if the robot agent uses a confidential application that your organization created.

5. Save and close the file.
6. Repeat these steps as needed for other robot agents that you installed.