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

# GitLab Connector

<Badge icon="arrow-left" color="gray">[Back to Search AI connectors list](/ai-for-service/searchai/content-sources#supported-connectors)</Badge>

GitLab is a DevOps platform used for version control, CI/CD, and collaborative software development, including issue tracking and management. Using the Search AI GitLab connector, you can index and search through issues tracked in your GitLab account.

## Specifications

| Specification     | Details |
| ----------------- | ------- |
| Repository type   | Cloud   |
| Supported content | Issues  |
| RACL support      | Yes     |
| Content filtering | No      |

## Authorization Support

Search AI interacts with GitLab via APIs and supports the following authentication methods:

* OAuth 2.0
* Personal Access Token

## Prerequisites

Sign in to your GitLab account and set up one of the following based on your chosen authorization type.

### Personal Access Token

1. Go to your profile (top left) and click **Edit Profile**.
2. Go to **Access Tokens** in the left navigation menu.
3. Click **Add new token**.
4. Select the `read_api` scope and create the token.

Refer to the [GitLab documentation](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html) for details.

### OAuth 2.0

1. Go to the [Applications page](https://gitlab.com/-/user_settings/applications) under your user profile.
2. Create a new app for Search AI integration.
3. Set one of the following as the redirect URL based on your region:
   * JP Region: `https://jp-bots-idp.kore.ai/workflows/callback`
   * DE Region: `https://de-bots-idp.kore.ai/workflows/callback`
   * Prod: `https://idp.kore.com/workflows/callback`
4. Select the `read_api` scope.
5. This generates an application ID and client secret. Use these credentials to generate an access token and refresh token via an API client tool such as Postman. Refer to the [GitLab OAuth2 authorization code flow](https://docs.gitlab.com/ee/api/oauth2.html#authorization-code-flow) for details.

## Configure the GitLab Connector in Search AI

1. Navigate to the **Connectors** page and select **GitLab**.

2. Provide the following fields:

   | Field                          | Description                                                                  |
   | ------------------------------ | ---------------------------------------------------------------------------- |
   | **Name**                       | Unique name for the connector                                                |
   | **Authorization Type**         | Personal Access Token (Private Token) or OAuth 2.0                           |
   | **Token / Client Credentials** | Personal Access Token, or client credentials and access tokens for OAuth 2.0 |

3. Click **Connect** to sync content from GitLab.

## RACL Support

All ingested content is associated with the GitLab project it belongs to. The `sys_racl` field is set to the `projectId` for each piece of content. A permission entity is created for each project ID.

Use the [Permission Entity APIs](/ai-for-service/apis/searchai/permission-entity-apis) to associate users with the corresponding permission entity to grant access to that project's content.