Skip to main content

Configure GitLab Enterprise connector

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

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

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 both cloud and self-hosted instances of GitLab Enterprise.

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.

  4. In the Personal Access Tokens, enter a Name.

  5. Select a desired date from the Expires at. If a date is not selected, the token lasts indefinitely.

  6. Select the checkboxes for api and read_user.

  7. Select Generate personal access token.

  8. Select and copy the personal access token.

Tip

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

Procedure

In the Configure GitHub section, at the bottom of the Connector Configuration: SaaS, do the following.

  1. In Access token, paste the copied Personal Access Token, as saved in Generate and get the token.

  2. Based on the GitLab version you use, do one of the following:

    • For the self-hosted version of GitLab Enterprise,

      1. In Endpoint, enter the network address for your GitLab Enterprise instance.

      2. Leave the Group empty.

    • For the SaaS version of GitLab Enterprise hosted on gitlab.com,

      1. In Endpoint, enter https://gitlab.com.

      2. In the Group, enter the group name for which you want to collect the users.

  3. To verify that the connection between Snow Integration Manager and the GitLab Enterprise API is successful, select Test Connection.

  4. To enable the connector, select Active.

  5. Select Save.