Configuration of GitLab Enterprise

The Snow Integration Connector for GitLab Enterprise is used to determine the number of registered GitLab 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 GitLab Enterprise user account is required to connect to the GitLab Enterprise API, extract the number of users and their last login date. The GitLab Enterprise user account must have the role Administrator with read permission for the user scope, to be able to connect to the GitLab Enterprise API and extract user data. The GitLab Enterprise connector supports on-premise and cloud-hosted GitLab Enterprise instances.

Note

The GitLab Enterprise connector does not allow aggregation of data from gitlab.com.

Generate and get the token

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

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

  2. Go to your profile picture and select Settings.

  3. Select Access tokens.

    The Personal Access Tokens page appears.

  4. Enter a name in the Name box.

  5. Choose a desired date from the Expires at box.

    If a date is not chosen, the token will last indefinitely.

  6. Select the checkboxes for api and read_user.

  7. Select Generate personal access token.

  8. Select and copy the personal access token.

Caution

We advise you to save the token in a safe place, as it cannot be recreated via GitLab Enterprise.

Configure the GitLab 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.

    gitlab.png
  2. Enter the hostname for your GitLab Enterprise instance in the Endpoint box.

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

  4. Select the Active checkbox to enable the connector.

  5. Select Save.