Skip to content

Configuring the GitHub SaaS Connector

To connect GitHub to Agentic Fabric, you'll create a GitHub app. This will allow Agentic Fabric to discover GitHub app installations and other resources and aggregate them as non-human identities and accounts.

Important

If your organization has already configured a GitHub SaaS source, you can use the existing source for agent discovery. The fields will be prepopulated with the source's information. You can edit these fields to configure a new integration.

Creating and Installing a GitHub App

  1. Follow the GitHub product documentation to create and register a GitHub app.
  2. Select the permissions the app requires. Refer to the GitHub connector documentation for information on the required permissions for aggregating specific types of datasets.
  3. Generate a private key for the app.
  4. Download and store the .pem file to a safe location. You'll provide it to connect GitHub to Agentic Fabric.
  5. Install the app on your organization.

Connecting GitHub to Agentic Fabric

  1. Go to the Connect Source step of the Agentic Fabric onboarding experience.
  2. Select GitHub from the left pane.

  3. In the GitHub section, complete the following:

    • In the Source Name field, enter a unique name for the source.

    • In the Source Owner field, select the identity who will own the source.

    • In the Description field, enter a unique description for the source to distinguish it from similar connections.

  4. In the Configure Authentication section, complete the following:

    • In the Organization Name field, enter the public profile name of your GitHub organization. To find the name of an organization, select your profile picture in the upper-right corner of GitHub and then select Organizations.
    • In the GitHub App ID field, enter the unique identifier for the GitHub app installation. To find the App ID of the app you created and installed, go to the GitHub Apps page.

    • In the GitHub App private key field, enter the private key you generated for the GitHub app.

      Note

      When you enter the private key you must enter the whole private key, including the BEGIN PRIVATE KEY and END PRIVATE KEY lines.

    • In the Installation ID field, enter the installation identifier. After you install the app, the URL includes the installation ID: https://github.com/organizations/<org>/settings/installations/<installation-id>.

  5. Select Test Connection to ensure the connection is successful.

  6. If the test is successful, select Aggregate to run an aggregation for the source. Select Exit to skip this step. You can configure aggregations for the source's datasets later in the source's configuration. For datasets specific to GitHub, refer to the GitHub connector documentation.

    A Completed status is now displayed next to the source in the left panel.

  7. Choose another connector to configure or select Continue to proceed to the next onboarding step.

Documentation Feedback

Feedback is provided as an informational resource only and does not form part of SailPoint’s official product documentation. SailPoint does not warrant or make any guarantees about the feedback (including without limitation as to its accuracy, relevance, or reliability). All feedback is subject to the terms set forth at https://developer.sailpoint.com/discuss/tos.