home.md

@@ -119,6 +119,52 @@ Beispiel:
 
 Um das Git-Terminal zu starten klickt man mit der rechten Maustaste auf eine freie Stelle in einem Ordner und wählt _Git Bash Here_ aus.
 
+## _Hinzufügen eines SSH Keys (optional)_
+
+Die Authentifizierung beim GitLab Server kann entweder mit Username und Passwort oder mit Hilfe eines SSH Keys durchgeführt werden. Möchte man die Authentifizierung mit einem SSH KEY durchführen, so muss zuerst ein Schlüsselpaar bestehend aus einem privaten und einem öffentlichen Schlüssel erzeugt werden. Im Folgenden wird dafür der Verschlüsselungsalgorithmus EdDSA verwendet. Alternativ kann auch RSA verwendet werden.
+
+
+**Terminaleingabe (MAC/WINDOWS/LINUX):**
+
+`ssh-keygen -t ed25519 -C "<Kommentar>"`
+
+Anschließend erscheint der folgende Output:
+
+```
+Generating public/private ed25519 key pair.
+Enter file in which to save the key (/home/<user>/.ssh/id_ed25519):
+```
+
+Hier kann nun ein Speicherort für die Schlüssel angegeben werden. Durch Drücken der `Enter`-Taste ohne eine Eingabe wird der vorgeschlagene Speicherort verwendet.
+
+Anschließend kommt noch die Frage, ob man ein Passwort (passphrase) für den privaten Schlüssel anlegen möchte. 
+
+```
+Enter passphrase (empty for no passphrase):
+Enter same passphrase again:
+```
+
+
+Dies dient dazu, dass der Schlüssel selbst noch einmal mit einem Passwort geschützt ist, sodass der alleinige Besitz der Datei nicht zur Authentifizierung ausreicht. Mit einem Passwort handelt es sich dann um eine 2-Faktor-Authentifizierung.
+
+Anschließend muss der öffentliche Schlüssel bei GitLab hinterlegt werden. Hierzu muss der Inhalt der Datei des öffentlichen Schlüssels kopiert und bei GitLab hinzugefügt werden.
+
+
+**macOS:**
+```tr -d '\n' < ~/.ssh/id_ed25519.pub | pbcopy```
+
+**Linux** (benötigt `xclip` Paket):
+```xclip -sel clip < ~/.ssh/id_ed25519.pub```
+
+**Git Bash bei Windows:**
+```cat ~/.ssh/id_ed25519.pub | clip```
+
+Nach der Ausführen des entsprechenden Befehls befindet sich der öffentliche Schlüssel in der Zwischenablage. 
+
+Nun muss man sich bei GitLab einloggen und oben rechts auf den Avatar klicken. Anschließend klickt man auf **Preferences**. Dann klickt man auf der linken Leiste auf **SSH Keys**. In die **Key** Box kopiert man nun den Inhalt aus der Zwischenablage (`Strg` + `V`) und drückt anschließend auf **Add key**.
+
+ 
+
 </details>
 
 # **Benutzen von Terminalbefehlen**