GitLab

OpenLM monitors GitLab seat usage and license assignments through OpenLM Cloud Broker.

Before you begin

• An active OpenLM Platform tenant.
• OpenLM Cloud Broker, approved in Broker Hub.
• A GitLab Owner, Maintainer, or instance Administrator account that can issue a personal access token.

Generate the GitLab personal access token

1. Sign in to GitLab as a user with permission to issue tokens (Owner, Maintainer, or instance Administrator).
2. Go to your avatar in the top-right corner and select Edit profile.
3. In the left sidebar, select Access tokens.
4. Select Add new token.
5. Enter a token name and (optional) expiration date.
6. Grant the token at least the read_api and read_user scopes so OpenLM Cloud Broker can read seat and user data.
7. Select Create personal access token.
8. Copy the token and store it securely — GitLab shows the token value only once.

tip

For self-managed GitLab, the token UI lives at https://<your-gitlab-host>/-/user_settings/personal_access_tokens. For GitLab.com, use https://gitlab.com/-/user_settings/personal_access_tokens.

Add the credential in OpenLM Cloud Broker

1. Open the OpenLM Cloud Broker dashboard.

2. Locate the GitLab integration.

3. Enter the following values:

   • GitLab host URL (for example, https://gitlab.com or your self-managed URL)
   • Personal access token

   GitLab credential configuration in Cloud Broker

4. Select Test connection and confirm the test passes.

5. Select Save.

Approve GitLab in OpenLM Platform

1. Sign in to OpenLM Platform.
2. From the menu, go to License Servers → Pending Server.
3. Select the GitLab data source, then select Approve and Merge.

Verify the integration

1. In OpenLM Platform, go to Allocation.
2. Confirm GitLab usage data appears.

note

It can take up to 3 minutes for data to appear after approval.

Approve GitLab in OpenLM Platform

1. Sign in to OpenLM Platform.
2. From the menu, go to License Servers → Pending Server.
3. Select the GitLab data source, then select Approve and Merge.

Verify the integration

1. In OpenLM Platform, go to Allocation.
2. Confirm GitLab usage data appears.

note

It can take up to 3 minutes for data to appear after approval.

Viewing reports

• User activity trends — see which users are most active in the platform; reallocate seats accordingly.
• Expired or unused licenses — identify inactive users and reclaim their seats.

Reference

• Broker Hub