Technologie

Wie konfiguriere ich die SSH-Schlüssel in der GitLab App?

Melden
  1. Einleitung zur SSH-Schlüssel-Konfiguration
  2. Vorbereitungen: SSH-Schlüssel generieren
  3. Öffentlichen SSH-Schlüssel zu GitLab hinzufügen
  4. SSH-Schlüssel in der GitLab App konfigurieren
  5. SSH-Agent verwenden und Schlüssel laden
  6. Test der SSH-Verbindung
  7. Zusammenfassung

Einleitung zur SSH-Schlüssel-Konfiguration

SSH-Schlüssel bieten eine sichere Möglichkeit, sich bei GitLab zu authentifizieren, ohne bei jedem Zugriff das Passwort eingeben zu müssen. Indem man einen SSH-Schlüssel mit dem GitLab-Konto verknüpft, kann man komfortabel und sicher mit Repositories arbeiten. Die GitLab App unterstützt die Nutzung von SSH, indem sie es erlaubt, vorhandene Schlüssel zu verwenden oder neue Schlüsselpaare zu generieren. Nachfolgend wird Schritt für Schritt erklärt, wie die SSH-Schlüssel eingerichtet und in der GitLab App verwendet werden.

Vorbereitungen: SSH-Schlüssel generieren

Falls noch kein SSH-Schlüssel auf deinem Gerät existiert, musst du zunächst einen generieren. Dies funktioniert abhängig vom Betriebssystem meist über die Kommandozeile mit dem Tool ssh-keygen. Auf macOS und Linux öffnest du das Terminal und gibst folgenden Befehl ein:

ssh-keygen -t ed25519 -C "deine.email@example.com"

Falls dein System Ed25519 nicht unterstützt, kannst du alternativ RSA verwenden, indem du statt ed25519 rsa -b 4096 angibst. Folge den Anweisungen, um einen Speicherort für den Schlüssel und ein optionales Passwort festzulegen. Am Ende befinden sich im Standardpfad zwei Dateien: id_ed25519 (privater Schlüssel) und id_ed25519.pub (öffentlicher Schlüssel).

Öffentlichen SSH-Schlüssel zu GitLab hinzufügen

Um deinen öffentlichen Schlüssel in GitLab zu hinterlegen, musst du dich zunächst in der GitLab Weboberfläche einloggen. Danach gehst du über das Benutzer-Icon oben rechts in die Einstellungen und wählst dort den Abschnitt SSH-Schlüssel aus. Dort kannst du den Inhalt deiner öffentlichen Schlüsseldatei, also den Text aus id_ed25519.pub oder der entsprechenden Datei, in ein Textfeld einfügen. Diesen kannst du zum Beispiel mit einem Texteditor öffnen oder über das Terminal mit:

cat ~/.ssh/id_ed25519.pub

einsehen und kopieren. Anschließend gibst du dem Schlüssel einen aussagekräftigen Titel, damit du ihn später wiedererkennst, und speicherst ihn ab. Nach dem Hinzufügen weist GitLab den öffentlichen Schlüssel deinem Benutzerkonto zu und ermöglicht so sichere SSH-Verbindungen.

SSH-Schlüssel in der GitLab App konfigurieren

Die GitLab App selbst nutzt für SSH-Verbindungen die auf dem Gerät gespeicherten SSH-Schlüssel. Deshalb ist es wichtig, dass die privaten Schlüssel an der standardmäßigen SSH-Konfigurationsstelle vorhanden sind (~/.ssh/). Sobald dein SSH-Schlüssel in GitLab hinterlegt ist, kannst du in der App Projekte per SSH klonen oder darauf zugreifen, ohne nach Passwort gefragt zu werden. Falls die GitLab App eigene Einstellungen zur SSH-Verbindung anbietet, prüfe dort, ob du den Pfad zum privaten Schlüssel angeben kannst oder ob der Schlüssel-Manager des Betriebssystems genutzt wird. Bei manchen mobilen oder Desktop-Versionen ist es außerdem notwendig, den SSH-Agenten zu aktivieren oder den Schlüssel im Agenten zu laden, um eine reibungslose Authentifizierung zu gewährleisten.

SSH-Agent verwenden und Schlüssel laden

Um den privaten Schlüssel bequem und sicher verwenden zu können, empfiehlt es sich, einen SSH-Agenten zu nutzen. Auf Linux und macOS startest du diesen meist mit:

eval "$(ssh-agent -s)" ssh-add ~/.ssh/id_ed25519

hinzu. So wird der private Schlüssel im Speicher gehalten und steht der GitLab App jederzeit zur Authentifizierung zur Verfügung, ohne dass du jedes Mal ein Passwort eingeben musst. Unter Windows kannst du je nach eingesetztem Terminal oder Git-Client einen entsprechenden SSH-Agenten aktivieren oder den Windows-eigenen OpenSSH-Agenten verwenden.

Test der SSH-Verbindung

Nach der Einrichtung solltest du unbedingt testen, ob die SSH-Verbindung funktioniert. Dazu öffnest du das Terminal oder die Kommandozeile und gibst ein:

ssh -T git@gitlab.com

Wenn alles korrekt eingerichtet ist, bekommst du eine Willkommensnachricht von GitLab, die deinen Benutzernamen bestätigt. Sollte eine Fehlermeldung auftauchen, überprüfe, ob der richtige SSH-Schlüssel verwendet wird, dieser in GitLab hinterlegt ist und die SSH-Agent-Konfiguration korrekt ist.

Zusammenfassung

Die Konfiguration der SSH-Schlüssel in der GitLab App erfordert das Erstellen oder Vorhandensein eines SSH-Schlüssels, das Hinterlegen des öffentlichen Schlüssels in GitLab und das Sicherstellen, dass die GitLab App auf deinen privaten Schlüssel zugreifen kann. Die Nutzung eines SSH-Agenten erleichtert dabei die Handhabung der Schlüssel. Nach erfolgreicher Konfiguration kannst du über die GitLab App sicher und bequem auf deine Repositories zugreifen, ohne ständig Passwörter eingeben zu müssen.

0

Kommentare