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.

Generating a token in GitLab

1. Log into GitLab as an admin.
   
2. Edit your profile (or go to https://gitlab.com/-/profile/personal_access_tokens).
   
   
   
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.
  

4. Copy the access token that then appears.
   

Integrating GitLab into Authomize

1. Log into Authomize.
2. Go to Settings > Data Sources and click Add New App.
   
   
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.

When GitLab is integrated you will see it in the list of connected apps:

What data is collected

• Users
• Groups
• Repositories

• Gitlab_Integration_Guide-15Dec22.pdf600 KB