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

# Integración con GitLab autogestionado

> Conecta Devin con tu instancia autogestionada de GitLab

<div id="overview">
  ## Resumen general
</div>

Esta guía describe la configuración completa para integrar una **instancia de GitLab** con Devin, incluida tanto la **configuración de Admin** como la **configuración del usuario final**.

La integración tiene dos partes:

1. **Configuración de Admin**
   * Conectar la instancia de GitLab autohospedada de la organización con Devin
   * Configurar una cuenta de servicio
   * Configurar el acceso al repositorio
   * Registrar OAuth para que los usuarios puedan vincular sus identidades personales de GitLab
2. **Configuración del usuario**
   * Vincular la cuenta de GitLab de un usuario con su cuenta de Devin

<Note>
  La configuración de Admin debe completarse antes de que cualquier usuario pueda vincular su cuenta de GitLab. Solo los Enterprise Admins pueden realizar los pasos de configuración de Admin.
</Note>

***

<div id="part-1-admin-setup">
  ## Parte 1: Configuración de Admin
</div>

<div id="step-1-create-a-service-account-in-gitlab">
  ### Paso 1: Crear una cuenta de servicio en GitLab
</div>

En GitLab:

1. Ve al **grupo correcto de GitLab**
2. Ve a **Settings**
3. Abre **Service Accounts**
4. Crea una nueva cuenta de servicio

Devin usará esta cuenta de servicio para acceder a los repositorios de GitLab.

<Frame>
  <img src="https://mintcdn.com/cognitionai/AnsrXvUO6uX9lwu8/images/enterprise/gitlab/gitlab-create-service-account.png?fit=max&auto=format&n=AnsrXvUO6uX9lwu8&q=85&s=e81fed639122165593233b0e2e959318" alt="Crear cuenta de servicio en GitLab" width="3158" height="1980" data-path="images/enterprise/gitlab/gitlab-create-service-account.png" />
</Frame>

***

<div id="step-2-add-the-service-account-as-a-group-member">
  ### Paso 2: Agregar la cuenta de servicio como miembro del grupo
</div>

Siguiendo en GitLab:

1. Ve a la página de **Miembros** del grupo

<Frame>
  <img src="https://mintcdn.com/cognitionai/AnsrXvUO6uX9lwu8/images/enterprise/gitlab/gitlab-group-members.png?fit=max&auto=format&n=AnsrXvUO6uX9lwu8&q=85&s=8a205b2d0ea97565ec9e4dbaca80ad87" alt="Página de miembros del grupo de GitLab" width="894" height="1156" data-path="images/enterprise/gitlab/gitlab-group-members.png" />
</Frame>

2. Agrega la cuenta de servicio como miembro del grupo
3. Asígnale el rol **Developer**

Esto es necesario para que la cuenta de servicio pueda acceder a los repositorios correctamente.

***

<div id="step-3-generate-a-personal-access-token-for-the-service-account">
  ### Paso 3: Genera un token de acceso personal para la cuenta de servicio
</div>

Después de crear la cuenta de servicio:

1. Ubica la cuenta de servicio que acabas de crear
2. Haz clic en los tres puntos > **Gestionar tokens de acceso** > **Generar un nuevo token de acceso personal** > Selecciona **api** en los ámbitos de acceso
3. Copia y guarda ese token en un lugar seguro

<Note>
  Asegúrate de seleccionar el token de la cuenta de servicio, y no tu token de acceso personal que aparece en las preferencias de tu usuario. Debes hacer que Devin actúe como la cuenta de servicio, no como tú. Usarás este token al agregar la conexión de GitLab en Devin.
</Note>

***

<div id="step-4-add-the-gitlab-connection-in-devin">
  ### Paso 4: Agrega la conexión de GitLab en Devin
</div>

En Devin:

1. Ve a **Settings de Enterprise**
2. Abre **Connections**
3. Agrega una conexión
4. Ingresa:
   * La **URL de tu GitLab autohospedado** (si corresponde)

<Frame>
  <img src="https://mintcdn.com/cognitionai/AnsrXvUO6uX9lwu8/images/enterprise/gitlab/gitlab-add-connection.png?fit=max&auto=format&n=AnsrXvUO6uX9lwu8&q=85&s=e7425687734160e1004131a22b9d1d14" alt="Agregar URL de conexión de GitLab" width="3160" height="1970" data-path="images/enterprise/gitlab/gitlab-add-connection.png" />
</Frame>

* El **token de acceso personal** creado para la cuenta de servicio

Esto crea la conexión de GitLab a nivel de Enterprise.

***

<div id="step-5-configure-webhook">
  ### Paso 5: Configurar Webhook
</div>

Configurar un webhook permite que Devin reciba automáticamente notificaciones en tiempo real cuando se producen eventos específicos en GitLab (como la apertura o actualización de solicitudes de fusión y los comentarios en ellas).

Para configurar el webhook:

1. En **Settings de Enterprise** > **Connections**, ubica la instancia de GitLab que acabas de agregar
2. Haz clic en el menú desplegable **Gestionar**
3. Selecciona **Configurar Webhook**
4. Sigue los comandos proporcionados para completar la configuración

<Frame>
  <img src="https://mintcdn.com/cognitionai/pyEbN3xdufu0Z31G/images/enterprise/gitlab/gitlab-configure-webhook.png?fit=max&auto=format&n=pyEbN3xdufu0Z31G&q=85&s=d2e01d6fd89ca40302f9ea9ebf61848b" alt="Configurar Webhook" width="452" height="388" data-path="images/enterprise/gitlab/gitlab-configure-webhook.png" />
</Frame>

Una vez configurado, Devin podrá responder a los eventos de GitLab en tiempo real en lugar de depender de un sondeo periódico.

***

<div id="step-6-verify-repository-access">
  ### Paso 6: Verificar el acceso a los repositorios
</div>

Después de agregar la conexión:

1. Confirma que la cuenta de servicio tenga acceso a los repositorios que quieres usar
2. En Devin, si los repositorios no aparecen de inmediato, actualiza manualmente la lista de repositorios
3. Ve a **Repositorios Enterprise**
4. Selecciona la organización correcta

<Frame>
  <img src="https://mintcdn.com/cognitionai/AnsrXvUO6uX9lwu8/images/enterprise/gitlab/gitlab-enterprise-repositories.png?fit=max&auto=format&n=AnsrXvUO6uX9lwu8&q=85&s=ef2b4392c4b1fdf004a26f2304576959" alt="Repositorios Enterprise" width="3164" height="1980" data-path="images/enterprise/gitlab/gitlab-enterprise-repositories.png" />
</Frame>

5. Abre **Gestionar permisos**
6. Agrega los repositorios relevantes con los permisos de **lectura/escritura** adecuados

<Frame>
  <img src="https://mintcdn.com/cognitionai/AnsrXvUO6uX9lwu8/images/enterprise/gitlab/gitlab-manage-permissions.png?fit=max&auto=format&n=AnsrXvUO6uX9lwu8&q=85&s=e833b6573eedb18bf62079456d077b74" alt="Gestionar permisos de repositorios" width="540" height="128" data-path="images/enterprise/gitlab/gitlab-manage-permissions.png" />
</Frame>

<Note>
  Si faltan repositorios, puede deberse a que Devin actualiza la lista de repositorios periódicamente en lugar de hacerlo al instante.
</Note>

***

<div id="part-2-enable-user-linking-for-self-hosted-gitlab">
  ## Parte 2: Habilitar la vinculación de usuarios en GitLab autohospedado
</div>

<div id="step-7-register-an-oauth-application-on-the-self-hosted-gitlab-instance">
  ### Paso 7: Registrar una aplicación OAuth en la instancia autohospedada de GitLab
</div>

Para permitir que los usuarios individuales vinculen su identidad de GitLab con Devin, el Admin debe registrar una aplicación OAuth para la instancia autohospedada de GitLab.

En Devin:

1. Ve al área de conexión de GitLab de Enterprise
2. Abre **Advanced**
3. Ve a la sección de GitLab autohospedado
4. Inicia el flujo para **registrar una aplicación OAuth**

<Frame>
  <img src="https://mintcdn.com/cognitionai/EHv4sbxOtqeRVSwT/images/enterprise/gitlab/gitlab-register-oauth.png?fit=max&auto=format&n=EHv4sbxOtqeRVSwT&q=85&s=58275e975adaff88336802286e89eb8b" alt="Registrar aplicación OAuth" width="1428" height="1324" data-path="images/enterprise/gitlab/gitlab-register-oauth.png" />
</Frame>

***

<div id="step-8-complete-oauth-app-registration-in-gitlab">
  ### Paso 8: Completa el registro de la aplicación OAuth en GitLab
</div>

Sigue el enlace del modal de registro para abrir la forma de la aplicación de GitLab. Completa los campos como se muestra:

1. Configura **Name** y **Redirect URI** exactamente como se muestra en el modal de Devin
2. Activa la casilla **Confidential**
3. Selecciona el ámbito **api**
4. Haz clic en **Save application**

<Frame>
  <img src="https://mintcdn.com/cognitionai/hGn6kEeruNGdZWya/images/enterprise/gitlab/gitlab-oauth-app-settings.png?fit=max&auto=format&n=hGn6kEeruNGdZWya&q=85&s=f30a422acffd08b475cfdd4d70be4f0b" alt="Configuración de la aplicación OAuth de GitLab" width="2060" height="1792" data-path="images/enterprise/gitlab/gitlab-oauth-app-settings.png" />
</Frame>

5. Copia **Application ID** y **Application Secret** de GitLab
6. Vuelve a Devin y pega esos valores en el modal de registro
7. Haz clic en **Register**

Esto completa la configuración del Admin necesaria para la vinculación de identidades de usuario.

***

<div id="part-3-organization-membership-requirement">
  ## Parte 3: Requisito de pertenencia a la organización
</div>

<div id="step-9-make-sure-the-user-belongs-to-the-correct-devin-organization">
  ### Paso 9: Asegúrate de que el usuario pertenezca a la organización de Devin correcta
</div>

Antes de que un usuario pueda vincular su cuenta de GitLab, debe ser miembro de una organización de Devin con permisos para repositorios de GitLab.

En Devin:

1. Ve a la sección de pertenencia a la organización
2. Confirma que el usuario forme parte de una organización de Devin con permisos para repositorios de GitLab
3. Si no es así, agrégalo primero

<Note>
  **Personal Connections solo muestra integraciones de las organizaciones a las que pertenece el usuario.** Si un usuario no está en una organización de Devin con permisos para repositorios de GitLab, es posible que la integración de GitLab no aparezca en absoluto.
</Note>

***

<div id="part-4-end-user-setup">
  ## Parte 4: Configuración para usuarios finales
</div>

<div id="step-10-open-personal-connections">
  ### Paso 10: Abrir Personal Connections
</div>

Como usuario final en Devin:

1. Ve a **Personal Connections**
2. Busca la integración autohospedada de GitLab

Si no aparece, primero verifica la pertenencia a la organización.

***

<div id="step-11-link-the-users-gitlab-account">
  ### Paso 11: Vincular la cuenta de GitLab del usuario
</div>

Una vez que aparezca la integración:

1. Selecciona la conexión autohospedada de GitLab
2. Completa el proceso de vinculación
3. Vincula la **cuenta de GitLab** del usuario con su **cuenta de Devin**

Después de esto, Devin debería poder actuar en nombre de ese usuario en las operaciones de GitLab.