Configuration of GitHub Enterprise

The Snow Integration Connector for GitHub Enterprise is used to determine the number of registered GitHub users. The connector was introduced with Snow Integration Manager version 5.14.

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

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 on-premise and cloud-hosted GitHub Enterprise instances.

Note

The GitHub Enterprise connector does not allow aggregation of data from github.com.

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

W advise you to save the token in a safe place, as it can not be recreated via GitHub Enterprise.

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 hostname 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.