GitLab
- 03 May 2023
- 3 Minutes to read
- Print
- DarkLight
- PDF
GitLab
- Updated on 03 May 2023
- 3 Minutes to read
- Print
- DarkLight
- PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
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.
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.
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.
Step 4: Click the Preferences button
Click the Preferences button from the Profile icon dropdown menu.
Step 5: Click on Applications from the Preferences page
Click on the Applications button from the pane on the left.
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.
Leave Confidential and Expire access tokens checked.
Step 7: Click Save application
Scroll to the bottom of the scopes checkboxes and click 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.
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.
Step 11: Find GitLab
Scroll to or search for GitLab in the list of applications from the marketplace, then click Connect.
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.
Step 13: App Settings
Complete the App Settings form. Details for each field can be found in the following article: Common App Configuration Steps.
.png?sv=2022-11-02&spr=https&st=2024-10-05T12%3A19%3A48Z&se=2024-10-05T12%3A29%3A48Z&sr=c&sp=r&sig=2A5M2f%2BVffWCRf7eVC8AJ4LNLQI8DnepamBHhdqPH%2F8%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.
.png?sv=2022-11-02&spr=https&st=2024-10-05T12%3A19%3A48Z&se=2024-10-05T12%3A29%3A48Z&sr=c&sp=r&sig=2A5M2f%2BVffWCRf7eVC8AJ4LNLQI8DnepamBHhdqPH%2F8%3D)
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?
