Skip to main content

Configuration of GitHub Enterprise

The Snow Integration Connector for GitHub Enterprise is used to determine the number of registered GitHub users.

The configuration must be started and prepared according to SaaS connector configuration.

Prerequisites

A GitHub Enterprise user account is required to connect to the GitHub Enterprise API, extract the number of users and their last login date. The GitHub Enterprise user account must have the role Site Admin with read permission for the user scope, to be able to connect to the GitHub Enterprise API and extract user data. The GitHub Enterprise connector supports both cloud and self-hosted instances of GitHub Enterprise.

Note

GitHub's own cloud-hosting service API on GitHub.com does not meet the requirements for a SIM connector and hence is not supported.

Generate and get the token

Snow Integration Manager integrates with GitHub Enterprise via a unique token.

  1. Log in to GitHub Enterprise by using a user account that has the Site Admin role.

  2. Select Developer settings.

  3. Select Personal access tokens.

  4. Select Generate new token.

  5. Enter a memorable Token description.

  6. Select the user checkbox.

  7. Select Generate token.

  8. Select and copy the personal access token.

Caution

We recommend you to save the token securely as you will be unable to view it again once created. In the event that the token is lost, a new one can be created and used.

Configure the GitHub Enterprise connector

In the Configure section at the bottom of Connector Configuration: SaaS:

  1. Paste the copied personal access token, as saved in Generate and get the token, in the Access token box.

    github.png
  2. Enter the network address for your GitHub Enterprise instance in the Endpoint box.

  3. Select Test Connection to verify that the connection between Snow Integration Manager and the GitHub Enterprise API is successful.

  4. Select the Active checkbox to enable the connector.

  5. Select Save.