In Oracle Cloud Infrastructure Identity and Access Management (IAM), create a client application for your Oracle Integration instance and obtain the client credentials.

To successfully use the client credentials, assign the integration-instance developer role to the client application you created previously.

1. Log in to the Oracle Cloud Infrastructure Console.
2. In the navigation pane, click Oracle Cloud Services.

   The Oracle Cloud Services page appears.

3. Select the specific application corresponding to the Oracle Integration instance.
4. In the navigation pane, click Application Roles.

   The list of all applicable roles appears.

5. Expand the ServiceDeveloper role, and then click Manage next to Assigned applications.
6. Click Show available applications.
7. Select the application you just created and click Assign, then click Close.
   Now, IAM assigns the integration-instance developer role to the application.

To use the Rapid Adapter Builder, you require additional applications or software installed on your system.

1. Download and install the Postman application. Visit the Download Postman page. Create an account on Postman to access full features.
2. Download and install VS Code. Visit the Download Visual Studio Code page.

   You must use VS Code version 1.73.0 or higher.

Download and install the VS Code extension for Rapid Adapter Builder.

1. On Visual Studio Marketplace, visit Oracle's page.
2. Find and click the Oracle Integration Cloud Rapid Adapter Builder tile.
   The Details page opens.
3. Click Install.
   The extension file opens in VS Code.
4. Click Install in VS Code.
   Now, the extension is installed and appears on the sidebar.

After you install the VS Code extension for Rapid Adapter Builder, you must initialize a workspace on your system and configure the publisher profile for the extension.

1. Initialize a workspace using the VS Code extension.
   1. In VS Code, click Explorer on the sidebar.
   2. Click Open Folder, and choose a folder on your system as the workspace for adapter development.
      The folder is now listed on the left in the Explorer view.

      Note:

      You can also click File in the top ribbon, and select Open Folder... to open a folder in VS Code.
   3. Press Ctrl + Shift + P to open the command palette, type RAB: Initialize Workspace, and hit Enter.
      The VS Code extension now initializes the workspace, and creates a few directories and template files in the workspace. The directories and files created are displayed in the Explorer view on the left. The following directories and files are created:

      • api: You can save all OpenAPI files in this folder.

        Note:

        For the VS Code extension to package an OpenAPI document into an adapter bundle, rename the OpenAPI document as openapi.resource.json.

      • definitions: The extension creates a default adapter definition document, main.add.json, in this folder. You can overwrite the default document with the data from a Postman collection or an OpenAPI file. Additionally, all the other adapter definition documents you generate are saved in this folder. The file names of all adapter definition documents are appended with .add.json.

      • misc: You can save all Postman collections in this folder. Ensure that the file names of all Postman collections are appended with .postman_collection.json.

      • logo.svg: A default logo file for your adapter is created under the root folder. You can replace this file with the required image.

2. Configure the publisher profile for the extension.
   1. In VS Code, click OIC Rapid Adapter Builder on the sidebar.
   2. In the resulting view, click Edit in the Publisher Profiles section.
      The publisher-profiles.yaml file opens in the editor.
   3. Update the file with the client credentials you obtained earlier. See Create a Client Application and Obtain Credentials. In addition, update the active field with the name of the profile to use.
   4. Press Ctrl+S on your keyboard to save the file.

   If you enter credentials for more than one Oracle Integration instance, the .yaml file stores them in a hierarchical structure, implemented by indenting the details.

   The following example shows the details of two Oracle Integration instances, named Test_Lab1 and Test_Lab2, stored in a .yaml file.

   # select which profile to use.
   active: Test_Lab1
   
   # multiple profiles can be defined.
   profiles:  
     - name: Test_Lab1
       host: https://<oicinstance.oraclecloud.com>
       integrationInstance: example-instance1
       auth:
         tokenUrl: https://<IAM-token>/oauth2/v1/token
         clientId: ef8xxxxxbf0c4101a4f74ae5fe301exx
         clientSecret: 0ebdae12-xxxx-4182-9051-8dbd83b2xxxx
         scope: https://08DADxxxx9D4496F9FBAFxxCFA1B0657.integration.region-1.oraclecloud.com:443urn:opc:resource:consumer::all
     - name: Test_Lab2
       host: https://<oicinstance.oraclecloud.com>
       integrationInstance: example-instance2
       auth:
         tokenUrl: https://<IAM-token>/oauth2/v1/token
         clientId: ef9xxxxxbf0c4101a4f74ae5fe301exx
         clientSecret: 1ebdae12-xxxx-4182-9051-8dbd83b2xxxx
         scope: https://18DADxxxx9D4496F9FBAFxxCFA1B0657.integration.region-2.oraclecloud.com:443urn:opc:resource:consumer::all