SupportDeveloper Docs

Gitlab Integration Setup

Getting Started

BalkanID recommends creating a separate service account for the purposes of this integration, instead of using personal or employee named accounts.

Requirements:

Get the Personal Access token (Git lab version < 14.7)

  1. Generate a Personal Access Token using an Administrative account.

  2. Click on the Profile section. Click on Edit profile.

  3. Click on Access Tokens.

  4. Select the read_api scope.

  5. Click on Create personal access token.

  6. Store the personal access token securely and input it into your BalkanID tenant as required.

Get the Group Access Token (Git lab Version > 14.7)

  1. On the GitLab Group Page, navigate to Settings.

  2. Click on Access Tokens.

  3. Select the read_api scope and click on Create group access token.

  4. Store the group access token securely and input it into your BalkanID tenant as required.

Authorization

Access Token of Organization:

Personal Access Token (Gitlab Version < 14.7)

  • Create a personal access token in Gitlab

  • Role: administrator

  • Scopes:

    • read_api

Group Access Token (Gitlab Version > 14.7)

  • Create a group access token in Gitlab

  • Role: Guest

  • Scopes:

    • read_api

Configure Gitlab within your BalkanID tenant

  1. Login to the BalkanID application and switch to the tenant you would like to add your integration to.

  2. Head to Integrations > Third Party Applications and click Add Integration, select Gitlab. Set up the Primary Application owner and the Description, if any.

  3. Gitlab would have been added to the list of applications. Click on the Configure and Integrate button beside the integration name, and configure the fields with the values that were noted prior. It should look like this:

  4. Once you filled in the information, click Save changes. Your integration is now configured and you will see the status of the integration displayed alongside other integrations on the Integrations page. Integrations are synced daily. When data is available, the integration Status column will read Connected and the integration Message will read Data available.

Was this helpful?