> ## 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.

# Intégration à GitLab auto-hébergé

> Connectez Devin à votre instance GitLab auto-hébergée

<div id="overview">
  ## Vue d’ensemble
</div>

Ce guide présente la configuration complète permettant d’intégrer une **instance GitLab** à Devin, y compris la **configuration d’administration** et la **configuration utilisateur**.

L’intégration comporte deux parties :

1. **Configuration d’administration**
   * Connecter l’instance GitLab auto-hébergée de l’organisation à Devin
   * Configurer un compte de service
   * Configurer l’accès aux dépôts
   * Enregistrer OAuth afin que les utilisateurs puissent lier leurs identités GitLab personnelles
2. **Configuration utilisateur**
   * Lier le compte GitLab d’un utilisateur à son compte Devin

<Note>
  La configuration d’administration doit être terminée avant qu’un utilisateur puisse lier son compte GitLab. Seuls les administrateurs Enterprise peuvent effectuer les étapes de configuration d’administration.
</Note>

***

<div id="part-1-admin-setup">
  ## Partie 1 : Configuration d’administration
</div>

<div id="step-1-create-a-service-account-in-gitlab">
  ### Étape 1 : Créer un compte de service dans GitLab
</div>

Dans GitLab :

1. Accédez au **groupe GitLab** approprié
2. Accédez à **Settings**
3. Ouvrez **Service Accounts**
4. Créez un nouveau compte de service

Ce compte de service sera utilisé par Devin pour accéder aux dépôts dans 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="Créer un compte de service dans 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">
  ### Étape 2 : Ajouter le compte de service comme membre du groupe
</div>

Toujours dans GitLab :

1. Accédez à la page **Membres** du groupe

<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="Page des membres du groupe GitLab" width="894" height="1156" data-path="images/enterprise/gitlab/gitlab-group-members.png" />
</Frame>

2. Ajoutez le compte de service au groupe
3. Accordez-lui le rôle **Developer**

C'est nécessaire pour que le compte de service puisse accéder correctement aux dépôts.

***

<div id="step-3-generate-a-personal-access-token-for-the-service-account">
  ### Étape 3 : Générer un jeton d’accès personnel pour le compte de service
</div>

Après avoir créé le compte de service :

1. Repérez le compte de service que vous venez de créer
2. Cliquez sur les trois points > **Gérer les jetons d’accès** > **Générer un nouveau jeton d’accès personnel** > sélectionnez **api** dans les périmètres d’accès
3. Copiez ce jeton et conservez-le en lieu sûr

<Note>
  Assurez-vous de sélectionner le jeton du compte de service, et non votre jeton d’accès personnel situé dans les préférences de votre compte utilisateur. Devin doit agir en tant que compte de service, et non en votre nom. Vous utiliserez ce jeton lorsque vous ajouterez la connexion GitLab dans Devin.
</Note>

***

<div id="step-4-add-the-gitlab-connection-in-devin">
  ### Étape 4 : Ajouter la connexion GitLab dans Devin
</div>

Dans Devin :

1. Accédez à **Enterprise Settings**
2. Ouvrez **Connections**
3. Ajoutez une nouvelle connexion
4. Saisissez :
   * l’**URL de votre instance GitLab auto-hébergée** (le cas échéant)

<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="Ajouter l’URL de connexion GitLab" width="3160" height="1970" data-path="images/enterprise/gitlab/gitlab-add-connection.png" />
</Frame>

* le **jeton d’accès personnel** créé pour le compte de service

Cette opération crée la connexion GitLab au niveau de l’entreprise.

***

<div id="step-5-configure-webhook">
  ### Étape 5 : Configurer le webhook
</div>

La configuration d’un webhook permet à Devin de recevoir automatiquement des notifications en temps réel lorsque des événements spécifiques se produisent dans GitLab (comme l’ouverture ou la mise à jour de merge requests, ainsi que les commentaires sur celles-ci).

Pour configurer le webhook :

1. Dans **Enterprise Settings** > **Connections**, repérez l’instance GitLab que vous venez d’ajouter
2. Cliquez sur le menu déroulant **Manage**
3. Sélectionnez **Configure Webhook**
4. Suivez les commandes fournies pour terminer la configuration

<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="Configurer le webhook" width="452" height="388" data-path="images/enterprise/gitlab/gitlab-configure-webhook.png" />
</Frame>

Une fois configuré, Devin pourra réagir aux événements GitLab en temps réel, au lieu de dépendre d’une interrogation périodique.

***

<div id="step-6-verify-repository-access">
  ### Étape 6 : Vérifier l’accès aux dépôts
</div>

Après avoir ajouté la connexion :

1. Vérifiez que le compte de service a accès aux dépôts que vous souhaitez utiliser
2. Dans Devin, si les dépôts n’apparaissent pas immédiatement, actualisez manuellement la liste des dépôts
3. Accédez à **Enterprise Repositories**
4. Sélectionnez l’organisation appropriée

<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="Dépôts Enterprise" width="3164" height="1980" data-path="images/enterprise/gitlab/gitlab-enterprise-repositories.png" />
</Frame>

5. Ouvrez **Manage Permissions**
6. Ajoutez les dépôts concernés avec les autorisations **lecture/écriture** appropriées

<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="Gérer les autorisations des dépôts" width="540" height="128" data-path="images/enterprise/gitlab/gitlab-manage-permissions.png" />
</Frame>

<Note>
  Si certains dépôts sont absents, c’est peut-être parce que Devin actualise la liste des dépôts périodiquement, et non instantanément.
</Note>

***

<div id="part-2-enable-user-linking-for-self-hosted-gitlab">
  ## Partie 2 : Activer l’association des utilisateurs pour GitLab auto-hébergé
</div>

<div id="step-7-register-an-oauth-application-on-the-self-hosted-gitlab-instance">
  ### Étape 7 : Enregistrer une application OAuth sur l’instance GitLab auto-hébergée
</div>

Pour permettre aux utilisateurs de lier leur identité GitLab à Devin, l’administrateur doit enregistrer une application OAuth pour l’instance GitLab auto-hébergée.

Dans Devin :

1. Accédez à la section de connexion GitLab de l’Enterprise
2. Ouvrez **Avancé**
3. Accédez à la section GitLab auto-hébergé
4. Lancez le processus pour **enregistrer une application 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="Enregistrer une application 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">
  ### Étape 8 : Finalisez l’enregistrement de l’application OAuth dans GitLab
</div>

Suivez le lien dans la fenêtre modale d’enregistrement pour ouvrir le formulaire de l’application GitLab. Remplissez les champs comme indiqué :

1. Renseignez **Name** et **Redirect URI** exactement comme indiqué dans la fenêtre modale Devin
2. Cochez la case **Confidential**
3. Sélectionnez le périmètre **api**
4. Cliquez sur **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="Paramètres de l’application OAuth GitLab" width="2060" height="1792" data-path="images/enterprise/gitlab/gitlab-oauth-app-settings.png" />
</Frame>

5. Copiez l’**Application ID** et l’**Application Secret** depuis GitLab
6. Revenez à Devin et collez ces valeurs dans la fenêtre modale d’enregistrement
7. Cliquez sur **Register**

Cela finalise la configuration côté administrateur nécessaire à la liaison des identités utilisateur.

***

<div id="part-3-organization-membership-requirement">
  ## Partie 3 : Condition d’appartenance à l’organisation
</div>

<div id="step-9-make-sure-the-user-belongs-to-the-correct-devin-organization">
  ### Étape 9 : Assurez-vous que l’utilisateur appartient à la bonne organisation Devin
</div>

Avant de pouvoir lier son compte GitLab, l’utilisateur doit être membre d’une organisation Devin disposant des autorisations sur les dépôts GitLab.

Dans Devin :

1. Accédez à la section d’appartenance à l’organisation
2. Vérifiez que l’utilisateur fait partie d’une organisation Devin disposant des autorisations sur les dépôts GitLab
3. Sinon, ajoutez-le d’abord

<Note>
  **Personal Connections n’affiche que les intégrations des organisations auxquelles l’utilisateur appartient.** Si un utilisateur ne fait pas partie d’une organisation Devin disposant des autorisations sur les dépôts GitLab, l’intégration GitLab peut ne pas apparaître du tout.
</Note>

***

<div id="part-4-end-user-setup">
  ## Partie 4 : Configuration des utilisateurs finaux
</div>

<div id="step-10-open-personal-connections">
  ### Étape 10 : Ouvrir Personal Connections
</div>

En tant qu’utilisateur final de Devin :

1. Accédez à **Personal Connections**
2. Recherchez l’intégration GitLab auto-hébergée

Si elle n’apparaît pas, vérifiez d’abord que vous faites bien partie de l’organisation.

***

<div id="step-11-link-the-users-gitlab-account">
  ### Étape 11 : Associer le compte GitLab de l'utilisateur
</div>

Une fois que l'intégration apparaît :

1. Sélectionnez la connexion GitLab auto-hébergée
2. Suivez la procédure d'association
3. Associez le **compte GitLab** de l'utilisateur à son **compte Devin**

Après cela, Devin devrait pouvoir agir au nom de cet utilisateur pour les opérations GitLab.