> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kobble.io/llms.txt
> Use this file to discover all available pages before exploring further.

# GitLab

> Configure GitLab OAuth for your Customer Portal.

## Overview

Offering a sign in with GitLab in your Customer Portal can be great if you target a developer audience. It allows your users to sign in with their GitLab account and provides you with their GitLab profile.

To support Sign in with GitLab you need to configure the GitLab provider in the Kobble dashboard for your project.

Once configured, the GitLab sign-in button will automatically be added on your Kobble Customer Portal.

## Configuration

1. Navigate to the [Authentication](https://app.kobble.io/p/authentication) section and choose the GitLab provider.
2. Copy the provided Redirect URI. Note this URI will change if you configure a custom domain later.

<img src="https://mintcdn.com/kobble/hy82n-p3NucxH50S/images/settings/auth/gitlab-configuration-1.png?fit=max&auto=format&n=hy82n-p3NucxH50S&q=85&s=1ae4f4de12211530ad7ad4e5e144fd22" alt="GitLab Configuration 1" width="1998" height="1712" data-path="images/settings/auth/gitlab-configuration-1.png" />

3. Open [your GitLab account](https://gitlab.com).
4. Click on your profile picture and select Edit Profile.

<img src="https://mintcdn.com/kobble/hy82n-p3NucxH50S/images/settings/auth/gitlab-configuration-2.png?fit=max&auto=format&n=hy82n-p3NucxH50S&q=85&s=37ed744a89e2ce47f05a86834d95ad0c" alt="GitLab Configuration 2" width="1414" height="986" data-path="images/settings/auth/gitlab-configuration-2.png" />

5. Then, on the left menu, choose Applications and click on Add new application.
6. Fill in the form with the information of your application and the Redirect URI provided by Kobble and select the scopes **read\_user**, **openid**, **profile**, **email**.

<img src="https://mintcdn.com/kobble/hy82n-p3NucxH50S/images/settings/auth/gitlab-configuration-3.png?fit=max&auto=format&n=hy82n-p3NucxH50S&q=85&s=8694edd5942f12c041cfafaf575fe0a5" alt="GitLab Configuration 3" width="1582" height="1654" data-path="images/settings/auth/gitlab-configuration-3.png" />

<Warning>Before saving, make sure you have checked the following scopes: **read\_user**, **openid**, **profile**, **email**.</Warning>

8. Once created, copy the given Application ID and Secret.

<img src="https://mintcdn.com/kobble/hy82n-p3NucxH50S/images/settings/auth/gitlab-configuration-4.png?fit=max&auto=format&n=hy82n-p3NucxH50S&q=85&s=4573571de221eaa8e402e2c7bee90d86" alt="GitLab Configuration 4" width="2106" height="1020" data-path="images/settings/auth/gitlab-configuration-4.png" />

9. Paste them into your Kobble settings, turn on the Enabled switch and save.

<img src="https://mintcdn.com/kobble/hy82n-p3NucxH50S/images/settings/auth/gitlab-configuration-5.png?fit=max&auto=format&n=hy82n-p3NucxH50S&q=85&s=f79fd4190abbf9346a8d17d08dcfaf01" alt="GitLab Configuration 5" width="1940" height="1698" data-path="images/settings/auth/gitlab-configuration-5.png" />

🎉 Et voilà! Your customer can now use GitLab to sign-in in your authentication portal. No further action is required on your end.

<Warning>In case you change your Customer Portal domain later, you will have to go through this process again and update your Authorized Redirect URI in your GitLab configuration.</Warning>
