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

# Integration mit selbstverwaltetem GitLab

> Verbinden Sie Devin mit Ihrer selbstverwalteten GitLab-Instanz

<div id="overview">
  ## Überblick
</div>

Diese Anleitung beschreibt das vollständige Setup für die Integration einer **GitLab-Instanz** mit Devin, einschließlich des **Admin-Setups** und des **Nutzer-Setups**.

Die Integration besteht aus zwei Teilen:

1. **Admin-Setup**
   * Die self-hosted GitLab-Instanz der Organisation mit Devin verbinden
   * Ein Dienstkonto einrichten
   * Den Repository-Zugriff konfigurieren
   * OAuth registrieren, damit Nutzer ihre persönlichen GitLab-Identitäten verknüpfen können
2. **Nutzer-Setup**
   * Das GitLab-Konto eines einzelnen Nutzers mit seinem Devin-Konto verknüpfen

<Note>
  Das Admin-Setup muss abgeschlossen sein, bevor Nutzer ihr GitLab-Konto verknüpfen können. Nur Enterprise-Admins können die Schritte des Admin-Setups durchführen.
</Note>

***

<div id="part-1-admin-setup">
  ## Teil 1: Admin-Setup
</div>

<div id="step-1-create-a-service-account-in-gitlab">
  ### Schritt 1: Ein Dienstkonto in GitLab erstellen
</div>

In GitLab:

1. Gehen Sie zur richtigen **GitLab-Gruppe**
2. Navigieren Sie zu **Settings**
3. Öffnen Sie **Service Accounts**
4. Erstellen Sie ein neues Dienstkonto

Dieses Dienstkonto verwendet Devin, um in GitLab auf Repositories zuzugreifen.

<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="Dienstkonto in GitLab erstellen" 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">
  ### Schritt 2: Das Dienstkonto als Member der Gruppe hinzufügen
</div>

Weiter in GitLab:

1. Gehen Sie zur **Members**-Seite der Gruppe

<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="GitLab-Seite für Gruppen-Member" width="894" height="1156" data-path="images/enterprise/gitlab/gitlab-group-members.png" />
</Frame>

2. Fügen Sie das Dienstkonto als Member der Gruppe hinzu
3. Weisen Sie ihm die Rolle **Developer** zu

Dies ist erforderlich, damit das Dienstkonto angemessen auf Repositories zugreifen kann.

***

<div id="step-3-generate-a-personal-access-token-for-the-service-account">
  ### Schritt 3: Ein Personal Access Token für das Dienstkonto erstellen
</div>

Nach dem Erstellen des Dienstkontos:

1. Suchen Sie das neu erstellte Dienstkonto.
2. Klicken Sie auf die drei Punkte > **Zugriffstokens verwalten** > **Ein neues persönliches Zugriffstoken generieren** > Wählen Sie unter den Zugriffsbereichen **api** aus.
3. Kopieren Sie dieses Token und bewahren Sie es sicher auf.

<Note>
  Stellen Sie sicher, dass Sie das Token des Dienstkontos auswählen und nicht Ihr Personal Access Token aus den Nutzereinstellungen. Devin soll als Dienstkonto agieren, nicht in Ihrem Namen. Dieses Token verwenden Sie, wenn Sie die GitLab-Verbindung in Devin hinzufügen.
</Note>

***

<div id="step-4-add-the-gitlab-connection-in-devin">
  ### Schritt 4: Die GitLab-Verbindung in Devin hinzufügen
</div>

In Devin:

1. Gehen Sie zu **Enterprise Settings**
2. Öffnen Sie **Connections**
3. Fügen Sie eine neue Verbindung hinzu
4. Geben Sie Folgendes ein:
   * Ihre **self-hosted GitLab-URL** (falls zutreffend)

<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="GitLab-Verbindungs-URL hinzufügen" width="3160" height="1970" data-path="images/enterprise/gitlab/gitlab-add-connection.png" />
</Frame>

* Das für das Dienstkonto erstellte **Personal Access Token**

Dadurch wird die GitLab-Verbindung auf Enterprise-Ebene erstellt.

***

<div id="step-5-configure-webhook">
  ### Schritt 5: Webhook konfigurieren
</div>

Durch das Konfigurieren eines Webhooks kann Devin automatisch Echtzeitbenachrichtigungen erhalten, wenn bestimmte Ereignisse in GitLab eintreten (z. B. beim Öffnen oder Aktualisieren von Merge Requests oder beim Kommentieren von Merge Requests).

So konfigurieren Sie den Webhook:

1. Suchen Sie in **Enterprise Settings** > **Connections** nach der GitLab-Instanz, die Sie gerade hinzugefügt haben
2. Klicken Sie auf das Dropdown-Menü **Manage**
3. Wählen Sie **Webhook konfigurieren**
4. Folgen Sie den bereitgestellten Befehlen, um die Einrichtung abzuschließen

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

Nach der Konfiguration kann Devin in Echtzeit auf GitLab-Ereignisse reagieren, anstatt auf regelmäßige Abfragen angewiesen zu sein.

***

<div id="step-6-verify-repository-access">
  ### Schritt 6: Repository-Zugriff überprüfen
</div>

Nach dem Hinzufügen der Verbindung:

1. Vergewissern Sie sich, dass das Dienstkonto Zugriff auf die Repositorys hat, die Sie verwenden möchten
2. Wenn Repositorys in Devin nicht sofort angezeigt werden, aktualisieren Sie die Repository-Liste manuell
3. Gehen Sie zu **Enterprise Repositories**
4. Wählen Sie die richtige Organisation aus

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

5. Öffnen Sie **Manage Permissions**
6. Fügen Sie die relevanten Repositorys mit den entsprechenden **Lese-/Schreibberechtigungen** hinzu

<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="Manage repository permissions" width="540" height="128" data-path="images/enterprise/gitlab/gitlab-manage-permissions.png" />
</Frame>

<Note>
  Wenn Repos fehlen, kann das daran liegen, dass Devin die Repository-Liste regelmäßig und nicht sofort aktualisiert.
</Note>

***

<div id="part-2-enable-user-linking-for-self-hosted-gitlab">
  ## Teil 2: Nutzerverknüpfung für self-hosted GitLab aktivieren
</div>

<div id="step-7-register-an-oauth-application-on-the-self-hosted-gitlab-instance">
  ### Schritt 7: Eine OAuth-Anwendung in der self-hosted GitLab-Instanz registrieren
</div>

Damit einzelne Nutzer ihre GitLab-Identität mit Devin verknüpfen können, muss der Admin für die self-hosted GitLab-Instanz eine OAuth-App registrieren.

In Devin:

1. Gehen Sie zum Bereich für die Enterprise-GitLab-Verbindung
2. Öffnen Sie **Erweitert**
3. Gehen Sie zum Abschnitt für self-hosted GitLab
4. Starten Sie den Ablauf, um **eine OAuth-Anwendung zu registrieren**

<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="OAuth-Anwendung registrieren" width="1428" height="1324" data-path="images/enterprise/gitlab/gitlab-register-oauth.png" />
</Frame>

***

<div id="step-8-complete-oauth-app-registration-in-gitlab">
  ### Schritt 8: OAuth-App-Registrierung in GitLab abschließen
</div>

Folgen Sie dem Link im Registrierungs-Modal, um das GitLab-Anwendungsformular zu öffnen. Füllen Sie die Felder wie gezeigt aus:

1. Stellen Sie **Name** und **Redirect URI** genau wie im Devin-Modal gezeigt ein
2. Aktivieren Sie das Kontrollkästchen **Confidential**
3. Wählen Sie den **api**-Geltungsbereich aus
4. Klicken Sie auf **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="GitLab-OAuth-App-Einstellungen" width="2060" height="1792" data-path="images/enterprise/gitlab/gitlab-oauth-app-settings.png" />
</Frame>

5. Kopieren Sie die **Application ID** und das **Application Secret** aus GitLab
6. Kehren Sie zu Devin zurück und fügen Sie diese Werte in das Registrierungs-Modal ein
7. Klicken Sie auf **Register**

Damit ist die auf Administratorseite erforderliche Einrichtung für die Verknüpfung von Nutzeridentitäten abgeschlossen.

***

<div id="part-3-organization-membership-requirement">
  ## Teil 3: Voraussetzung: Mitgliedschaft in der Organisation
</div>

<div id="step-9-make-sure-the-user-belongs-to-the-correct-devin-organization">
  ### Schritt 9: Stellen Sie sicher, dass der Nutzer zur richtigen Devin-Organisation gehört
</div>

Bevor ein Nutzer sein GitLab-Konto verknüpfen kann, muss er Member einer Devin-Organisation mit GitLab-Repositoryberechtigungen sein.

In Devin:

1. Gehen Sie zum Bereich für die Organisationsmitgliedschaft
2. Vergewissern Sie sich, dass der Nutzer zu einer Devin-Organisation mit GitLab-Repositoryberechtigungen gehört
3. Falls nicht, fügen Sie ihn zuerst hinzu

<Note>
  **Personal Connections zeigt nur Integrationen für Organisationen an, denen der Nutzer angehört.** Wenn ein Nutzer keiner Devin-Organisation mit GitLab-Repositoryberechtigungen angehört, wird die GitLab-Integration möglicherweise gar nicht angezeigt.
</Note>

***

<div id="part-4-end-user-setup">
  ## Teil 4: Setup für Endnutzer
</div>

<div id="step-10-open-personal-connections">
  ### Schritt 10: Personal Connections öffnen
</div>

Als Endnutzer in Devin:

1. Gehe zu **Personal Connections**
2. Suche nach der self-hosted GitLab-Integration

Wenn sie nicht angezeigt wird, prüfe zuerst, ob du Mitglied der Organisation bist.

***

<div id="step-11-link-the-users-gitlab-account">
  ### Schritt 11: GitLab-Konto des Nutzers verknüpfen
</div>

Sobald die Integration angezeigt wird:

1. Wählen Sie die self-hosted GitLab-Verbindung aus
2. Schließen Sie den Verknüpfungsvorgang ab
3. Verknüpfen Sie das **GitLab-Konto** des Nutzers mit seinem **Devin-Konto**

Danach sollte Devin GitLab-Vorgänge im Namen dieses Nutzers ausführen können.