GitLab
  • 03 May 2023
  • 3 Minutes to read
  • Dark
    Light
  • PDF

GitLab

  • Dark
    Light
  • PDF

Article summary

This guide will teach you how to set up the connector between Gitlab and Clarity Security.

Estimated time to complete: 10 minutes

If you encounter any problems, please contact your support team or support@claritysecurity.io.

Supported Connector Capabilities

Below are capabilities supported by the connector at this time.

Method
Supported
Ability to Act as a Source of Truth
No
Provision User
Yes
List Groups, Policies, and Roles
Yes
Add User to Groups, Policies, and Roles
Yes
Remove User from Groups, Policies, and Roles
Yes
Deactivate User
No
Delete User
Yes

How to Setup the Connector

Step 1: Sign in to GitLab

Navigate to the URL below, and click the Sign In button on the top right to get to the login screen.

https://gitlab.com

Gitlab homepage

Step 2: Log in with your owner account

Log in to GitLab using the owner account.

Note
To import all groups & projects, they must be owned by the logged in user.

Gitlab.com Login

Step 3: Click the profile icon in the upper right

Click the profile icon in the upper right corner to access the drop-down options.

Profile icon or avatar

Step 4: Click the Preferences button

Click the Preferences button from the Profile icon dropdown menu.

Preferences

Step 5: Click on Applications from the Preferences page

Click on the Applications button from the pane on the left.

Preferences > Applications

Step 6: Configure Applications Settings

Configure the application connection using the information below.

  • Name: Create a helpful name for your connector, ex: Clarity Connector
  • Redirect URI: https://your_tenant.claritysecurity.io/application/oauthProcessCode/gitlab
  • Scopes: Check the api option.
Note
You must change "your_tenant" from the Redirect URI to match your Clarity tenant subdomain.
Leave Confidential and Expire access tokens checked.

Applications > Configured Application

Step 7: Click Save application

Scroll to the bottom of the scopes checkboxes and click Save Application.

Applications > Save Application

Step 8: Collect the application credentials

Once you have saved the application, you will be brought to a screen that lists the Application ID and Secret.  Copy these details down for a later step.

Gitlab Application Credentials

Step 9: Log in to Clarity

Login to your Clarity Security tenant.

https://your_tenant.claritysecurity.io

Step 10: Navigate to Applications, then Marketplace

Click on the Applications side tab, then click on the Marketplace to list all the available connectors.

Application > Marketplace

Step 11: Find GitLab

Scroll to or search for GitLab in the list of applications from the marketplace, then click Connect.

Marketplace > GitLab

Step 12: Connect App

Complete the App Settings form.  Details for fields common to all applications can be found in the following article: Common App Configuration Steps.

  • client_id: Paste the value collected from Step 8, Application ID.
  • client_secret: Paste the value for the secret from Step 8.

Common App Configuration Steps - Step 1 - Connect App

Step 13: App Settings

Complete the App Settings form.  Details for each field can be found in the following article: Common App Configuration Steps.

Configure App Step 2 - App Settings

Step 14: User Settings

Complete the User Settings form, check the table at the top to see if any features are unsupported.  Details for each field can be found in the following article: Common App Configuration Steps.

Configure App Step 3 - User Settings

Step 15: Validate Your Selections and Save

Save
Clicking the Save button will trigger the first full sync for your application (even if you selected Manual syncing).  This includes Service Users, Entitlements, Service User Entitlements, Service User Attributes.

Need Help?

If you have any problems, contact your customer success team. You can also get in touch with our general support via email, open a support ticket. Our general support team is available Monday - Friday from 8:00 AM - 6:30 PM CST.



Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.