> ## Documentation Index
> Fetch the complete documentation index at: https://conductorone-paul-querna-mcp-sources-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up a GitLab connector

> C1 provides identity governance for GitLab. Integrate your GitLab instance with C1 to run user access reviews (UARs) and enable just-in-time access requests.

<Tip>
  **A newer version of this connector is available.** If you're setting up a GitLab connector with C1 for the first time, use the [v2 version](/baton/gitlab).
</Tip>

<Warning>
  This version of the GitLab connector does not support account provisioning in GitLab Data Center. Please go to the [GitLab Data Center](https://github.com/conductorone/baton-gitlab) connector for more information.
</Warning>

## Capabilities

| Resource | Sync                                                          | Provision |
| :------- | :------------------------------------------------------------ | :-------- |
| Accounts | <Icon icon="square-check" iconType="solid" color="#c937ae" /> |           |
| Projects | <Icon icon="square-check" iconType="solid" color="#c937ae" /> |           |
| Groups   | <Icon icon="square-check" iconType="solid" color="#c937ae" /> |           |

## Gather GitLab credentials

Configuring the connector requires you to pass in credentials generated in GitLab. Gather these credentials before you move on.

<Warning>
  A user with group **Owner** access in GitLab must perform this task.
</Warning>

### Look up your GitLab group

<Steps>
  <Step>
    In GitLab, click **Menu** > **Groups** > **Your Groups**.
  </Step>

  <Step>
    Click on the group you wish to connect to C1.
  </Step>

  <Step>
    Make a note of the Group Name or Group ID.
  </Step>

  <Step />
</Steps>

### Create a personal access token

<Steps>
  <Step>
    In the GitLab menu bar, click your profile photo then click **Edit profile**.
  </Step>

  <Step>
    In the User Settings menu, click **Access Tokens**.
  </Step>

  <Step>
    Give your token a name and set an expiration date.
  </Step>

  <Step>
    In the **Select scopes** area, select **read\_api**.
  </Step>

  <Step>
    Click **Create personal access token**.
  </Step>

  <Step>
    Carefully copy and save the newly created token.
  </Step>
</Steps>

**Done.** Next, move on to the connector configuration instructions.

## Configure the GitLab connector

<Warning>
  To complete this task, you'll need:

  * The **Connector Administrator** or **Super Administrator** role in C1
  * Access to the set of GitLab credentials generated by following the instructions above
</Warning>

<Tabs>
  <Tab title="Cloud-hosted">
    **Follow these instructions to use a built-in, no-code connector hosted by C1.**

    <Steps>
      <Step>
        In C1, navigate to **Apps** > **Connectors** and click **Add connector**.
      </Step>

      <Step>
        Search for **GitLab** and click **Add**.
      </Step>

      <Step>
        Choose where to add the connector: **Create a new app**, or **Add to an existing app** (then select the app).

        If you're creating a new app, choose whether to link it to an application discovered from your identity provider: select **Yes** and pick the IdP application, or **No** to continue with just the connector.
      </Step>

      <Step>
        Set the connector's **Name** and, optionally, a **Description**.
      </Step>

      <Step>
        Click the pencil icon next to **Owners** to choose who can configure and manage this connector.
      </Step>

      <Step>
        Click **Add**. The connector is created and its configuration page opens.
      </Step>

      <Step>
        Find the **Settings** area of the page and click **Edit**.
      </Step>

      <Step>
        In the **Group** field, enter the name of your GitLab group.
      </Step>

      <Step>
        Paste the token you into the **Personal access token** field.
      </Step>

      <Step>
        **Optional.** If you need to point this connector to a private URL (such as a self-managed GitLab instance), enter the target URL in the **URL** field.
      </Step>

      <Step>
        Click **Save**.
      </Step>

      <Step>
        The connector's label changes to **Syncing**, followed by **Connected**. You can view the logs to ensure that information is syncing.
      </Step>
    </Steps>

    **Done.** Your GitLab connector is now pulling access data into C1.
  </Tab>

  <Tab title="Self-hosted">
    **Follow these instructions to use a connector, hosted and run in your own environment.**

    *Self-hosted connector not currently available.*
  </Tab>
</Tabs>