--- title: "Connect Clarity Security to GitLab" slug: "gitlab" description: "Learn how to connect Clarity Security to GitLab to automate your identity life cycle management and user access reviews." tags: ["How-To", "marketplace", "application", "connectors"] updated: 2023-05-03T16:39:05Z published: 2023-05-03T16:39:05Z canonical: "help.claritysecurity.com/gitlab" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.claritysecurity.com/llms.txt > Use this file to discover all available pages before exploring further. # GitLab This guide will teach you how to set up the connector between [Gitlab](https://about.gitlab.com/) and [Clarity Security](https://claritysecurity.io/). **Estimated time to complete:** 10 minutes If you encounter any problems, please contact your support team or [support@claritysecurity.io](mailto: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](https://gitlab.com) ![Gitlab homepage](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/Screenshot%202023-03-22%20at%2011.39.21%20AM.png?sv=2026-02-06&spr=https&st=2026-11-12T21%3A23%3A48Z&se=2026-11-12T22%3A23%3A48Z&sr=c&sp=r&sig=lAFAC2zxPTjt1KblO9ZkZ6vLG8tQEJ0Rg2qpzajmsMU%3D) ### Step 2: Log in with your owner account Log in to GitLab using the owner account. NoteTo import all groups & projects, they must be owned by the logged in user. ![Gitlab.com Login](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1679503620186.png?sv=2026-02-06&spr=https&st=2026-11-12T21%3A23%3A48Z&se=2026-11-12T22%3A23%3A48Z&sr=c&sp=r&sig=lAFAC2zxPTjt1KblO9ZkZ6vLG8tQEJ0Rg2qpzajmsMU%3D) ### 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](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1679503684989.png?sv=2026-02-06&spr=https&st=2026-11-12T21%3A23%3A48Z&se=2026-11-12T22%3A23%3A48Z&sr=c&sp=r&sig=lAFAC2zxPTjt1KblO9ZkZ6vLG8tQEJ0Rg2qpzajmsMU%3D) ### Step 4: Click the Preferences button Click the **Preferences** button from the Profile icon dropdown menu. ![Preferences](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1679503811426.png?sv=2026-02-06&spr=https&st=2026-11-12T21%3A23%3A48Z&se=2026-11-12T22%3A23%3A48Z&sr=c&sp=r&sig=lAFAC2zxPTjt1KblO9ZkZ6vLG8tQEJ0Rg2qpzajmsMU%3D) ### Step 5: Click on Applications from the Preferences page Click on the Applications button from the pane on the left. ![Preferences > Applications](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1679503987788.png?sv=2026-02-06&spr=https&st=2026-11-12T21%3A23%3A48Z&se=2026-11-12T22%3A23%3A48Z&sr=c&sp=r&sig=lAFAC2zxPTjt1KblO9ZkZ6vLG8tQEJ0Rg2qpzajmsMU%3D) ### 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. NoteYou must change "**your_tenant**" from the Redirect URI to match your Clarity tenant subdomain. Leave **Confidential** and **Expire access tokens** checked. ![Applications > Configured Application](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1679504116722.png?sv=2026-02-06&spr=https&st=2026-11-12T21%3A23%3A48Z&se=2026-11-12T22%3A23%3A48Z&sr=c&sp=r&sig=lAFAC2zxPTjt1KblO9ZkZ6vLG8tQEJ0Rg2qpzajmsMU%3D) ### Step 7: Click Save application Scroll to the bottom of the scopes checkboxes and click Save Application. ![Applications > Save Application](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1679504501010.png?sv=2026-02-06&spr=https&st=2026-11-12T21%3A23%3A48Z&se=2026-11-12T22%3A23%3A48Z&sr=c&sp=r&sig=lAFAC2zxPTjt1KblO9ZkZ6vLG8tQEJ0Rg2qpzajmsMU%3D) ### 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](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1679514109897.png?sv=2026-02-06&spr=https&st=2026-11-12T21%3A23%3A48Z&se=2026-11-12T22%3A23%3A48Z&sr=c&sp=r&sig=lAFAC2zxPTjt1KblO9ZkZ6vLG8tQEJ0Rg2qpzajmsMU%3D) ### 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](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1679514213802.png?sv=2026-02-06&spr=https&st=2026-11-12T21%3A23%3A48Z&se=2026-11-12T22%3A23%3A48Z&sr=c&sp=r&sig=lAFAC2zxPTjt1KblO9ZkZ6vLG8tQEJ0Rg2qpzajmsMU%3D) ### Step 11: Find GitLab Scroll to or search for GitLab in the list of applications from the marketplace, then click **Connect**. ![Marketplace > GitLab](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1679514327962.png?sv=2026-02-06&spr=https&st=2026-11-12T21%3A23%3A48Z&se=2026-11-12T22%3A23%3A48Z&sr=c&sp=r&sig=lAFAC2zxPTjt1KblO9ZkZ6vLG8tQEJ0Rg2qpzajmsMU%3D) ### 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](/v1/docs/common-app-steps#step-1-connect-app). - **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](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/Screenshot%202023-03-22%20at%202.53.13%20PM.png?sv=2026-02-06&spr=https&st=2026-11-12T21%3A23%3A48Z&se=2026-11-12T22%3A23%3A48Z&sr=c&sp=r&sig=lAFAC2zxPTjt1KblO9ZkZ6vLG8tQEJ0Rg2qpzajmsMU%3D) ### Step 13: App Settings Complete the App Settings form. Details for each field can be found in the following article: [Common App Configuration Steps](/v1/docs/common-app-steps#step-2-app-settings). ![Configure App Step 2 - App Settings](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/Configure%20App%202(3).png?sv=2026-02-06&spr=https&st=2026-11-12T21%3A23%3A48Z&se=2026-11-12T22%3A23%3A48Z&sr=c&sp=r&sig=lAFAC2zxPTjt1KblO9ZkZ6vLG8tQEJ0Rg2qpzajmsMU%3D) ### 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](/v1/docs/common-app-steps#step-3-user-settings). ![Configure App Step 3 - User Settings](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/Configure%20App%203(2).png?sv=2026-02-06&spr=https&st=2026-11-12T21%3A23%3A48Z&se=2026-11-12T22%3A23%3A48Z&sr=c&sp=r&sig=lAFAC2zxPTjt1KblO9ZkZ6vLG8tQEJ0Rg2qpzajmsMU%3D) ### Step 15: Validate Your Selections and Save SaveClicking 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](mailto:support@claritysecurity.io), open a [support ticket](https://support.claritysecurity.com/home). Our general support team is available Monday - Friday from 8:00 AM - 6:30 PM CST. A Service User is a user, or service account, discovered by Clarity in a downstream application. An Entitlement is an assignable permission found in a downstream application. Common examples include licenses, groups, and policies. Service User Entitlements are the pairings of users and active entitlement access in downstream applications. An attribute is a piece of information used to describe a service user, entitlement, or identity. Common examples include First Name, Last Name, Job Title, Department, etc.