GitLab Integration Guide

Amir Avitzur
Amir Avitzur
  • Updated

Integrating GitLab with Authomize

Integration with GitLab provides visibility about your organization’s identities and assets. After integration, Authomize provides visibility into GitLab, enabling improved identity security and automated access reviews.

Note: To integrate GitLab into Authomize, Authomize must first be installed on your organization’s GitLab repository.

GitLab integration workflow

To integrate GitLab with Authomize, first create an access token in GitLab and then copy that token into Authomize, as described below.

GitLab_Integration_Workflow.png

Generating a token in GitLab

  1. Log into GitLab as an admin.
    Gitlab_Sign-in.png
  2. Edit your profile (or go to https://gitlab.com/-/profile/personal_access_tokens).
    Edit_Profile.png

  3. Go to the Access Tokens dialog and:
  • Enter a Token Name (eg. authomize)
  • Enter an Expiration date
  • Select the following scopes:
    • read_api
    • read_user
    • read_repository
    • read_registry
  • Click Create personal access token.
    1_Gitlab_token.png
  1. Copy the access token that then appears.
    GitLab_Token.png

Integrating GitLab into Authomize

  1. Log into Authomize.
  2. Go to Settings > Data Sources and click Add New App.
    00_Add_New_App.png
  3. When the Integrate GitLab dialog opens:
    1. Follow the steps in Generating a token in GitLab above.
    2. Enter your top-level group name of your GitLab tenant. The name appears as part of the URL of the group. For example, if the URL of the group is https://gitlab.com/groups/YOUR_GROUP_NAME, then YOUR_GROUP_NAME is the Group Name.
    3. Paste the Access Token (from GitLab)
    4. Enter your email.

Click Create.
3_Integrate_Gitlab_All.png

When GitLab is integrated you will see it in the list of connected apps:
6_Gitlab_has_Been_integrated.png

What data is collected

  • Users
  • Groups
  • Repositories

 

 

Share this

Was this article helpful?

0 out of 0 found this helpful