Activity Insights - GitHub
To display activity data from Activity Insights, you first must create a personal access token in GitHub. You’ll then connect the following required sources so that IdentityNow can gather your GitHub account information and activity data.
Required Connectors
Connector | Description |
---|---|
GitHub | The identity governance connector allows you to manage your GitHub users in IdentityNow. |
Activity Insights - GitHub | The Activity Insights connector works with your GitHub identity governance connector to provide activity data for identities. |
Creating a Personal Access Token in GitHub
Before activity insights can display in IdentityNow, you must first create and authorize a personal access token in GitHub.
-
Create a personal access token with the following scopes:
repo
Full control of private repositories admin:org
Full control of orgs and teams, read and write org projects
Connecting GitHub to IdentityNow for Activity Insights
To connect GitHub to IdentityNow, you'll need to configure the GitHub Identity Governance source and the Activity Insights - GitHub source in IdentityNow. This will allow IdentityNow to gather account information and activity data from GitHub.
Configuring the GitHub Identity Governance Source
Follow the directions to configure your GitHub source in IdentityNow. You can also edit an existing source.
Configuring the Activity Insights - GitHub Source
To display activity data from Activity Insights, you must configure the Activity Insights - GitHub source in IdentityNow.
-
Go to Admin > Connections > Sources.
-
Select Create New to create a new source.
-
Search for and select the Activity Insights - GitHub connector.
-
Enter a name and description for your source.
-
In the Source Owner field, begin typing the name of an owner. Matches appear after you type two letters.
-
(Optional) Select a governance group for source management.
-
Select Continue to create the source.
-
Select Configuration from the left panel.
-
Enter the following information:
- Personal Access Token - The personal access token you created in GitHub.
- Organization Login - Your GitHub Organization Login. To find your organization login, select your profile picture in the upper-right corner of the page in GitHub. From the dropdown list, select Your organizations to view your organization login.
-
Select Save to save these settings.
- Select Review and Test from the left panel.
- Select Test Connection to test the connection between the applications. You must have a successful connection for IdentityNow to gather activity data. If the test is unsuccessful, retry your credentials or contact SailPoint Support.
To gather account data, you must correlate accounts and run an aggregation for the GitHub identity governance source. Your activity data will begin syncing immediately but may take up to 24 hours to display. Data will then update daily.