GitLab einrichten

In dieser Anleitung wird gezeigt, wie Sie Amber für die Indizierung/den Zugriff auf die Daten auf der GitLab-Plattform aktivieren können.

1. Klicken Sie als Admin-Benutzer auf die Schaltfläche „Admin“ neben dem Benutzerprofil-Symbol. Dadurch wird die Admin-Oberfläche geöffnet.

   

2. Gehen Sie in der Seitenleiste links zu „Einstellungen“ → „Allgemein“. Gehen Sie in der angezeigten Liste zu „Konto und Limit“.

   

3. Dort finden Sie die Optionen „Benutzer-OAuth-Anwendungen“ und „OAuth-Autorisierungen“. Dadurch wird die Erstellung von OAuth-Anwendungen und die Möglichkeit der Anmeldung mit OAuth aktiviert.

   

Nachdem OAuth-Anwendungen nun aktiviert sind, müssen wir eine erstellen.

1. Klicken Sie als Admin-Benutzer oben rechts auf das Benutzerprofil-Symbol und gehen Sie dann in der linken Seitenleiste zu „Einstellungen“ → „Anwendungen“.

   
   

2. Klicken Sie auf „Neue Anwendung hinzufügen“.

   

3. Im Formular:

   • Geben Sie dieser App einen aussagekräftigen Namen.

   • Fügen Sie die Umleitungs-URL hinzu (ersetzen Sie kundenname.ambersearch.de durch die aktuelle URI):

     • https://customerName.ambersearch.de/api/auth/gitlab_onprem/callback

   • Markieren Sie sie als vertraulich, da Amber das Geheimnis sicher auf dem Server speichert.

   • Bereiche: Markieren Sie nur die Option „OpenID“.

     

   • Klicken Sie auf „Anwendung speichern”.

   • Kopieren Sie die Anwendungs-ID und den geheimen Schlüssel und senden Sie diese an das Amber-Team.

     

Jetzt können wir uns mit OAuth bei der GitLab-Instanz anmelden.

Der nächste Schritt ist die Generierung eines PAT (Personal Access Token). Dieses Token wird zur Indizierung von Plattformdaten verwendet.

Dieses Token sollte von einem Benutzerkonto generiert werden, das in jedem Projekt über Entwicklerzugriff (mindestens Reporter) verfügt und Mitglied der entsprechenden Gruppen ist (oder von einem Administratorkonto, da
Administratorkonten überall Zugriff haben). Klicken
Sie mit diesem Konto oben rechts auf das Benutzerprofil-Symbol, dann auf „Einstellungen“ und gehen Sie zur linken Seitenleiste „Persönliche Zugriffstoken“.

1. 

2. Klicken Sie auf „Neues Token hinzufügen“.
   

   

3. Im Formular:

   • Geben Sie diesem Token einen aussagekräftigen Namen.

   • Geben Sie diesem Token eine Beschreibung (optional).

   • Das Ablaufdatum ist ein Monat ab dem Erstellungsdatum. Ändern Sie es auf mindestens ein Jahr.

   • Bereiche: Markieren Sie „read_api“.

     

     Dadurch erhält das Zugriffstoken nur Leserechte.

   • Klicken Sie auf „Token generieren“

     

   • Achtung! Zu diesem Zeitpunkt wird das Token oben als Passwortfeld angezeigt. Dies ist die einzige Möglichkeit, es zu kopieren und an das Amber-Team zu senden. Andernfalls müssen Sie ein neues erstellen.

Anmeldedaten teilen

Diese Daten sollten an das Amber-Team gesendet werden:

1. Basis-URI des Gitlab-Hosts

2. OAuth-App-Client-ID

3. OAuth-App-Client_secret

4. PAT (Personal Access Token)

An dieser Stelle ist alles konfiguriert und bereit für die Verarbeitung durch Amber!