1. Using the GitHub Adapter with Oracle Integration 3
  2. Create a GitHub Adapter Connection
  3. Prerequisites for Creating a Connection

Prerequisites for Creating a Connection

You must satisfy the following prerequisites to create a connection with the GitHub Adapter.

Register a GitHub Application

You have the option to register a GitHub application either under your personal account or an organization for which you have been granted permission to manage all owned applications. See Registering a GitHub App.
  • During the registration process, enter the callback URL of your application in the following format:
    https://OIC_instance_URL/icsapis/agent/oauth/callback
  • Under Permissions, choose the permissions that your application needs. You need to grant Repository Permissions, Organization Permissions, and Account Permissions.

    For each permission, select the drop-down menu and click Read-only, Read & write, or No access.

  • Click Generate a New Client Secret.

    Note:

    Copy the client ID and client secret. You'll need to enter those values on the Connections page when you configure security for your GitHub Adapter connection in Oracle Integration. See Configure Connection Security.

Authorize a GitHub Application

When you authorize a GitHub application, you are providing the application with access to your GitHub account in accordance with the permissions it requested during the authorization process.

  1. Click your organization name.
  2. Click Install.
  3. Select either All repositories or Only select repositories.
  4. Click Authorize & Request.

Create an OAuth Application

Create and register an OAuth application under your personal account or under any organization. See Create an OAuth app.
  • During the registration process, enter the callback URL of your application in the following format: 
    https://OIC_instance_URL/icsapis/agent/oauth/callback
  • During the registration process, provide the Webhook URL, specifying the destination where you want to receive notifications.

Note:

  • OAuth applications can have multiple Webhook URLs.
  • Copy the client ID and client secret. You'll need to enter those values on the Connections page when you configure security for your GitHub Adapter connection in Oracle Integration. See Configure Connection Security.

Create Client Identifier

Access the Identity Domain

  1. Log in to the Oracle Cloud Infrastructure Console with your identity domain administrator credentials.
    1. In the navigation pane, click Identity & Security.
    2. Click Domains.
    3. Select your compartment.
    4. Click the identity domain.


      The Domains page shows a Create domain button and the following two columns of a table: Name and Domain type.

    5. In the navigation pane, click Integrated applications. This is the location at which you create the client application for your grant type.

Prerequisites for Resource Owner Password Credentials

To trigger the integration with OAuth, a client application is required.

Configure the Client Application

  1. Click Add application.
  2. Select Confidential Application, then click Launch workflow.


    The Add application dialog shows selections for Application Catalog, SAML Application, Mobile Application, Confidential Application, and Enterprise Application.

  3. Enter a name. The remaining fields on this page are optional and can be ignored.
  4. Click Next.
  5. Select Skip for later.
  6. Click Activate, and then Activate application to activate the client application for use.
  7. In the General Information section, note the client ID value. This value is required for configuring your connection to establish identity.


    The General Information section shows fields for Client ID and Client secret. Below this are links for Show secret and Regenerate.

    Note:

    Copy the client ID and client secret. You'll need to enter those values on the Connections page when you configure security for your GitHub Adapter connection in Oracle Integration. See Configure Connection Security.

Add Roles to the Client Application

  1. In the navigation pane, click Oracle Cloud Services.
  2. Select the specific application corresponding to the Oracle Integration instance.
  3. In the navigation pane, click Application roles.
  4. Expand ServiceInvoker, then click Manage next to either Assigned users or Assigned groups. For example, if you click Assigned users:


    The Application roles page shows Import and Export buttons. Below this is a table with columns for Name and Description. The ServiceInvoker role is expanded to show entries for Assigned users, Assigned groups, and Assigned applications. Each entry includes a link named Manage.

  5. Click Show available users.
  6. Select the user and click Assign, then click Close.