Skip to main content

​
Ü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:
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. Dokumentation: Personal Access Tokens, REST-Authentifizierung, 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 Fügen Sie Scopes nur hinzu, wenn Ihr Sicherheitsteam tiefergehende Lesevorgänge verlangt.

​
GitLab mit Iru verbinden

Schließen Sie diese Registerkarte ab, bevor Sie die Quelle in Compliance verbinden.
1

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

Profil öffnen

Wählen Sie Ihren Avatar oben rechts und dann Edit profile (bei einigen Versionen Preferences).
3

Access Tokens öffnen

Wählen Sie in der linken Seitenleiste Ihres Profils Access Tokens (manchmal unter User settings → Access Tokens).
4

Neues Token hinzufügen

Wählen Sie Add new token (oder Create personal access token).
5

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

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-.
Fahren Sie auf der Registerkarte Iru Compliance fort.

​
Fehlerbehebung

Prüfen Sie die Einstellungen des Pop-up-Blockers für die Iru-Website und versuchen Sie es erneut.
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.
Erweitern Sie die Scopes oder erhöhen Sie die Projekt-/Gruppenrolle – Ihr Token kann keine Endpunkte lesen, auf die Ihr Konto keinen Zugriff hat.
Stellen Sie sicher, dass die Integration auf den Hostnamen Ihrer Instanz verweist und dass die Netzwerkpfade die ausgehenden Aufrufe von Iru zulassen.
Einige Audit-APIs erfordern Premium/Ultimate-Funktionen – vergleichen Sie Ihren GitLab-Tarif mit den Nachweisen, die Ihr Framework erwartet.

​
Hinweise

Tokens laufen nach Zeitplan ab: Rotieren Sie frühzeitig und aktualisieren Sie…

Tokens laufen nach einem festen Zeitplan ab – rotieren Sie sie frühzeitig und aktualisieren Sie den Connector.

GitLab wendet Ratenbegrenzungen an; große Gruppen können…

GitLab wendet Ratenbegrenzungen an; bei großen Gruppen kann die erste Synchronisierung länger dauern.

Iru liest die von der API bereitgestellte Konfiguration: Es…

Iru liest die von der API bereitgestellte Konfiguration – Pipelines oder Repository-Einstellungen werden nicht geändert.

​
Verwandte Artikel

Quellenverwaltung

Alle Compliance-Quellen durchsuchen und verwalten.

Erste Schritte mit Compliance

Frameworks, Aktionen und Artefakte.

Iru-Übersicht

Wie Endpoint, Compliance und Identity zusammenwirken.

Artifacts-Verwaltung

Nachweise aus Quellen und Aktionen hochladen, prüfen und organisieren.