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

# GitLab

> Verbinden Sie GitLab mit einem Personal Access Token mit Iru Compliance, um Nachweise zu Projektinventar, Branch-Schutz, Gruppenmitgliedschaften und Audit-Ereignissen zu erfassen.

### Über GitLab

Der **GitLab**-Connector liest Projektmetadaten, Gruppenmitgliedschaften, Branch-Schutz, CI/CD-Konfiguration und (sofern Ihr Tarif und Ihr Token dies zulassen) auditbezogene Ereignisse aus Ihrer **GitLab.com-Gruppe** oder Ihrer **selbstverwalteten** Instanz. Die Daten erscheinen in Iru Compliance als Artefakte, die Sie Aktionen und Kontrollen zuordnen können. Iru sendet Anmeldeinformationen über den GitLab-Header **`PRIVATE-TOKEN`** – in der Regel mit einem **Personal Access Token**, damit sich die Lesevorgänge über die von Ihnen gewählten Gruppen und Projekte erstrecken können.

### So funktioniert es

Die REST API von GitLab authentifiziert sich mit dem Header **`PRIVATE-TOKEN`**:

```http theme={null}
PRIVATE-TOKEN: glpat-XXXXXXXXXXXXXXXXXXXX
```

Personal Access Tokens eignen sich in der Regel am besten, da sie mehrere Projekte und Gruppen abdecken können. Projekt- oder gruppenbezogene Tokens funktionieren ebenfalls, können jedoch einschränken, welche Nachweise Iru erfassen kann.

| Detail | Wert |
| - | - |
| **Kategorie** | Entwicklertools |
| **Authentifizierung** | `PRIVATE-TOKEN`-Header (Personal Access Token empfohlen) |
| **Hosting** | GitLab SaaS oder selbstverwaltet |

Dokumentation: [Personal Access Tokens](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html), [REST-Authentifizierung](https://docs.gitlab.com/ee/api/rest/authentication.html), [Token-Scopes](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html#personal-access-token-scopes).

### Voraussetzungen

* GitLab-Zugriff auf die für Compliance relevanten **Gruppen und Projekte**.
* Gruppenrolle **Besitzer** oder **Maintainer**, wo Sie Mitgliedschafts- und auditähnliche Lesevorgänge benötigen (die genauen Anforderungen hängen von Ihren Kontrollen ab).
* Bestätigen Sie bei **selbstverwaltetem** GitLab, dass Iru die **Basis-URL** Ihrer Instanz verwendet (nicht nur `gitlab.com`).

**Ausgangspunkt für Scopes**

| Scope | Zweck |
| - | - |
| `read_api` | Umfassender Lesezugriff auf API-Endpunkte, die für Inventar- und Konfigurationsnachweise verwendet werden |
| `read_repository` | Repository-Metadaten in Bezug auf Branch-Schutz und Repository-Einstellungen |
| `read_user` | Lesen von Benutzerprofilen, die für Mitgliedschaftsnachweise benötigt werden |

Fügen Sie Scopes nur hinzu, wenn Ihr Sicherheitsteam tiefergehende Lesevorgänge verlangt.

### GitLab mit Iru verbinden

<Tabs>
  <Tab title="GitLab">
    <Note>
      Schließen Sie diese Registerkarte ab, bevor Sie die Quelle in Compliance verbinden.
    </Note>

    <Steps>
      <Step title="Bei GitLab anmelden">
        Öffnen Sie Ihre GitLab-Instanz (**gitlab.com** oder die URL Ihrer selbstverwalteten Instanz) und melden Sie sich mit einem Benutzer an, der **Personal Access Tokens** für die Namespaces erstellen kann, die Iru lesen soll.
      </Step>

      <Step title="Profil öffnen">
        Wählen Sie Ihren **Avatar** oben rechts und dann **Edit profile** (bei einigen Versionen **Preferences**).
      </Step>

      <Step title="Access Tokens öffnen">
        Wählen Sie in der linken Seitenleiste Ihres Profils **Access Tokens** (manchmal unter **User settings** → **Access Tokens**).
      </Step>

      <Step title="Neues Token hinzufügen">
        Wählen Sie **Add new token** (oder **Create personal access token**).
      </Step>

      <Step title="Name, Ablaufdatum und Scopes festlegen">
        Geben Sie einen **Namen** ein (zum Beispiel **Iru Compliance**). Legen Sie ein **Ablaufdatum** fest (GitLab erfordert eines; die maximale Dauer kann von Ihrem Administrator begrenzt sein). Wählen Sie die unter **Voraussetzungen** in diesem Artikel aufgeführten **Lese**-Scopes.
      </Step>

      <Step title="Token erstellen und kopieren">
        Erstellen Sie das Token und **kopieren Sie es sofort**. GitLab zeigt es nur einmal an. Tokens beginnen in der Regel mit **`glpat-`**.
      </Step>
    </Steps>

    <Note>
      Fahren Sie auf der Registerkarte [**Iru Compliance**](#iru-compliance) fort.
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Schließen Sie zuerst die Registerkarte [**GitLab**](#gitlab) ab.
    </Note>

    <Steps>
      <Step title="Quellen öffnen">
        Erweitern Sie in Iru Compliance in der linken Navigationsleiste **Compliance** und wählen Sie **Quellen**.

        <Frame>
          <img src="https://mintcdn.com/iru/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="Linke Navigation: Compliance erweitert, Sources ausgewählt" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="GitLab aktivieren">
        Suchen Sie **GitLab** (verwenden Sie **Kategorie** oder **Nach Name oder Beschreibung suchen**). Aktivieren Sie auf dieser Karte den **Schalter**. Möglicherweise öffnet sich ein Browser-Tab oder -Fenster für den Connector-Assistenten.
      </Step>

      <Step title="Personal Access Token einfügen">
        Wenn der Assistent nach dem Wert für **`PRIVATE-TOKEN`** fragt, fügen Sie Ihr Token ein und übermitteln Sie es.
      </Step>

      <Step title="Verbindung abschließen">
        Wählen Sie **API-Schlüssel senden**. Wenn die Verbindung erfolgreich ist, zeigt der Assistent **Verbindung konfiguriert** an.
      </Step>

      <Step title="Bestätigen, dass die Quelle aktiv ist">
        Schließen Sie die Browser-Registerkarte **Iru fordert Zugriff auf externe Dienste an**, kehren Sie dann zu **Compliance** → **Quellen** zurück und bestätigen Sie, dass die Karte **GitLab** den Status **Aktiv** hat.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Fehlerbehebung

<AccordionGroup>
  <Accordion title="Beim Aktivieren der Quelle öffnet sich nichts">
    Prüfen Sie die Einstellungen des **Pop-up-Blockers** für die Iru-Website und versuchen Sie es erneut.
  </Accordion>

  <Accordion title="401 Unauthorized">
    Bestätigen Sie die vollständige Token-Zeichenfolge, prüfen Sie das Ablaufdatum und vergewissern Sie sich, dass das Konto weiterhin Zugriff auf die Zielgruppen hat.
  </Accordion>

  <Accordion title="403 Forbidden">
    Erweitern Sie die Scopes oder erhöhen Sie die Projekt-/Gruppenrolle – Ihr Token kann keine Endpunkte lesen, auf die Ihr Konto keinen Zugriff hat.
  </Accordion>

  <Accordion title="Probleme mit der URL einer selbstverwalteten Instanz">
    Stellen Sie sicher, dass die Integration auf den Hostnamen Ihrer Instanz verweist und dass die Netzwerkpfade die ausgehenden Aufrufe von Iru zulassen.
  </Accordion>

  <Accordion title="Fehlende Audit-Ereignisse">
    Einige Audit-APIs erfordern **Premium/Ultimate**-Funktionen – vergleichen Sie Ihren GitLab-Tarif mit den Nachweisen, die Ihr Framework erwartet.
  </Accordion>
</AccordionGroup>

### Hinweise

<CardGroup cols={2}>
  <Card title="Tokens laufen nach Zeitplan ab: Rotieren Sie frühzeitig und aktualisieren Sie…" icon="circle-info">
    Tokens laufen nach einem festen Zeitplan ab – rotieren Sie sie frühzeitig und aktualisieren Sie den Connector.
  </Card>

  <Card title="GitLab wendet Ratenbegrenzungen an; große Gruppen können…" icon="shield">
    GitLab wendet **Ratenbegrenzungen** an; bei großen Gruppen kann die erste Synchronisierung länger dauern.
  </Card>

  <Card title="Iru liest die von der API bereitgestellte Konfiguration: Es…" icon="server">
    Iru liest die von der API bereitgestellte Konfiguration – Pipelines oder Repository-Einstellungen werden nicht geändert.
  </Card>
</CardGroup>

### Verwandte Artikel

<CardGroup cols={2}>
  <Card title="Quellenverwaltung" icon="plug" href="/de/compliance/sources-management">
    Alle Compliance-Quellen durchsuchen und verwalten.
  </Card>

  <Card title="Erste Schritte mit Compliance" icon="rocket" href="/de/compliance/getting-started-with-compliance">
    Frameworks, Aktionen und **Artefakte**.
  </Card>

  <Card title="Iru-Übersicht" icon="layer-group" href="/de/iru/platform-overview/iru-overview">
    Wie Endpoint, Compliance und Identity zusammenwirken.
  </Card>

  <Card title="Artifacts-Verwaltung" icon="folder-open" href="/de/compliance/artifacts-management">
    Nachweise aus Quellen und Aktionen hochladen, prüfen und organisieren.
  </Card>
</CardGroup>