SSH-Key

Hier wird die Einrichtung eines SSH-Key erläutert. Er erlaubt den Zugriff auf deine Git-Repositories per SSH-Protokoll. Dieses würden wir dir bei der Verwendung deines eigenen Rechners/Laptops empfehlen. Für den Zugriff von einem Pool-/Laborrechner aus, verwende bitte einen Personal Access Token.

1. SSH-Schlüsselpaar erstellen

Öffne ein Terminal (PowerShell/bash/zsh) und erstelle ein neues SSH-Schlüsselpaar:

ssh-keygen -t ed25519 -C "dein.name@fh-dortmund.de"

Du wirst nun nach einem Speicherort für den Schlüssel gefragt. Drücke Enter, um den Standardpfad (~/.ssh/id_ed25519) zu verwenden. Danach wirst du gefragt, ob du eine Passphrase setzen möchtest. Dies erhöht die Sicherheit, ist aber optional.

2. SSH-Key zu Gitlab hinzufügen

Nun muss der öffentliche Schlüssel (.pub-Datei) in dein Gitlab-Profil eingefügt werden.

Zeige den öffentlichen Schlüssel an (siehe auch Bild oben):
```
cat ~/.ssh/id_ed25519.pub
```
Kopiere den gesamten Schlüssel (beginnt mit ssh-ed25519).
Logge dich in Gitlab unter git.inf.fh-dortmund.de ein.
Klicke oben links auf dein Profilbild und wähle “Edit profile”.
Gehe zu “SSH Keys”.
Klicke rechts auf "Add new key"
Füge den kopierten SSH-Key in das Feld "Key" ein und klicke auf “Add Key”.

3. Verbindung testen

Führe folgenden Befehl aus, um die SSH-Verbindung zu testen:

ssh -p 422 -T git@git.inf.fh-dortmund.de

Falls Gitlab korrekt antwortet, siehst du eine Meldung wie:

Welcome to Gitlab, @dein_username!

Falls du einen Fehler erhältst, prüfe folgende Punkte:

Hast du den richtigen SSH-Schlüssel in Gitlab hinterlegt?

Läuft dein SSH-Agent? Falls nicht, starte ihn mit:

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

4. Git-Repositories mit SSH klonen

Um ein Repository mit SSH zu klonen, nutze:

git clone ssh://git@git.inf.fh-dortmund.de:422/username/repository.git

Die genaue Adresse des Repositories kannst du auch über den "Code-Button" der Gitlab-Projekt-Seite ermittlen: