Before you can use Oracle Integration build steps in a build job, you need to add Oracle Integration instances to your VB Studio Environment definition.

1. In the left navigator, click Environments .
2. Select an existing environment to add an Integration instance to, or create a new one.
3. In the Service Instances tab, click + Add Instance.
4. In the Add Service Instance dialog, locate and add your Integration instance.

   Most of the time, you'll simply select an instance shown in the Instance List. The instance list shows resources in a selected compartment that are connected to an OCI account and authorized for use by VB Studio. Additionally, they can be from the same identity domain as your VB Studio instance or a different one.

   If you don't see any instances even after selecting the correct region and compartment, make sure VB Studio has the authorization required to access these instances. See Authorize VB Studio to Access Visual Builder and Integration Instances.

   Note:

   If you have existing environments with IDCS resources, you can continue to use these environments, but if you're creating a new environment, only the Integration instances that are linked to your OCI account will be available to add to the environment.

   To select an Integration instance connected to an OCI account:

   1. Make sure Instance Type is set to Oracle Integration and Add Instance Using is set to Instance List. This is the preferred approach.
   2. Click next to OCI Details, select the region and compartment where your Integration instance is located, and click Update.
   3. Select your Integration instance from the instance list.
      
      
      Description of the illustration add-service-instances_add-oracle-integration-using-oracle-integration-credentials.png
      
      

   Note:

   Your region and compartment selection is saved and will be the default selection the next time you add an instance.

   If you don't see the instance you want to add (because it's connected to a different OCI account), select Oracle Integration Credentials under Add Instance Using. Note that you cannot use this option to add an Oracle Integration 3 instance.

   In Base URL, enter the Integration instance's URL. In Instance Name, enter the display name that will be used for the service instance within the environment. Next, enter the credentials of a user who can access the Integration instance in Username and Password.

5. Click Add.

   When your Integration instance uses a different identity domain than your VB Studio instance, OAuth tokens (via three-legged OAuth flows) are used to secure programmatic access to the target instance. Before any OAuth tokens can be created, you must provide authorization to acquire OAuth tokens. Click Authorize when prompted, then sign in with credentials to connect and deploy to the instance.

The Service Instances tab now displays the Integration instance you just added:

Description of the illustration oic-instance-details-card.png

Note:

OAuth tokens (access and refresh) are cycled during regular use. A refresh token is used to obtain an access token whenever a user accesses the target instance. This refresh token is typically valid for seven days. (The token expiration time is set in the IDCS resource app and may be different based on your security requirements.) If the user authenticates with the target instance within the seven-day period, the active refresh token generates a new access token and a new refresh token. This cycle continues indefinitely as long as the refresh token stays valid. If the refresh token expires during extended periods of inactivity (say, when you're away on vacation), click Actions and select Renew OAuth Access.

In addition, the Recent Activities feed on the Project Home page lists the Integration instance and the environment you added it to.