Informationen zum Hinzufügen von SSH-Schlüsseln zu deinem Konto
Sie können auf Daten in Repositorys auf GitHub mit SSH (Secure Shell Protocol) zugreifen und schreiben. Wenn du über SSH eine Verbindung herstellst, authentifizierst du dich mit einer privaten Schlüsseldatei auf deinem lokalen Computer. Weitere Informationen findest du unter Informationen zur SSH.
Sie können auch SSH verwenden, um Commits und Tags zu signieren. Weitere Informationen zum Signieren von Commits findest du unter Informationen zur Verifizierung einer Commit-Signatur.
Nachdem du ein SSH-Schlüsselpaar erzeugt hast, musst du den öffentlichen Schlüssel zu GitHub.com hinzufügen, um den SSH-Zugang für dein Konto zu aktivieren.
Voraussetzungen
Führe vor dem Hinzufügen eines neuen SSH-Schlüssels zu deinem Konto zu GitHub.com die folgenden Schritte aus.
- Suche nach vorhandenen SSH-Schlüsseln. Weitere Informationen finden Sie unter Auf vorhandene SSH-Schlüssel prüfen.
- Generiere einen neuen SSH-Schlüssel, und füge ihn dem SSH-Agent deines Computers hinzu. Weitere Informationen finden Sie unter Generieren eines neuen SSH-Schlüssels und Hinzufügen des Schlüssels zum ssh-agent.
Hinzufügen eines neuen SSH-Schlüssels zu deinem Konto
Du kannst einen SSH-Schlüssel hinzufügen und für die Authentifizierung, das Signieren von Commits oder beides verwenden. Wenn Sie denselben SSH-Schlüssel sowohl für die Authentifizierung als auch für die Signatur verwenden möchten, müssen Sie ihn zweimal hochladen.
Wenn du deinem Konto auf GitHub.com einen neuen SSH-Authentifizierungsschlüssel hinzugefügt hast, kannst du jedes lokale Repository für die Verwendung von SSH konfigurieren. Weitere Informationen finden Sie unter Remote-Repositorys verwalten.
Note
GitHub verbessert die Sicherheit, indem ältere, unsichere Schlüsseltypen am 15. März 2022 gelöscht werden.
Ab diesem Datum werden DSA-Schlüssel (ssh-dss) nicht mehr unterstützt. Sie können Ihrem persönlichen Konto keine neuen DSA-Schlüssel für GitHub hinzufügen.
RSA-Schlüssel (ssh-rsa) mit einem valid_after vor dem 2. November 2021 können weiterhin einen Signaturalgorithmus verwenden. RSA-Schlüssel, die nach diesem Datum generiert wurden, müssen einen SHA-2-Signaturalgorithmus verwenden. Einige ältere Clients müssen möglicherweise aktualisiert werden, um SHA-2-Signaturen zu verwenden.
-
Kopiere den öffentlichen SSH-Schlüssel in die Zwischenablage.
Wenn die Datei mit Deinem öffentlichen SSH-Schlüssel einen anderen Namen hat als die Datei im Beispielcode, passe den Dateinamen im Code entsprechend an. Achte beim Kopieren des Schlüssels darauf, keine neuen Zeilen oder Leerzeichen hinzuzufügen.
$ pbcopy < ~/.ssh/id_ed25519.pub # Copies the contents of the id_ed25519.pub file to your clipboardTip
Wenn
pbcopynicht funktioniert, kannst du den ausgeblendeten Ordner.sshsuchen, die Datei in deinem bevorzugten Text-Editor öffnen und in die Zwischenablage kopieren.
$ clip < ~/.ssh/id_ed25519.pub
# Copies the contents of the id_ed25519.pub file to your clipboard
Note
- Mit Windows-Subsystem für Linux (WSL) kannst du
clip.exeverwenden. Wennclipnicht funktioniert, kannst du den ausgeblendeten Ordner.sshsuchen, die Datei in deinem bevorzugten Text-Editor öffnen und in die Zwischenablage kopieren. - Bei neueren Windows-Versionen, die Windows Terminal verwenden, oder beim Nutzen der PowerShell-Befehlszeile tritt möglicherweise ein
ParseErrormit der MeldungThe '<' operator is reserved for future use.auf. In diesem Fall solltest du den alternativen Befehlclipeinsetzen:
$ cat ~/.ssh/id_ed25519.pub | clip
# Copies the contents of the id_ed25519.pub file to your clipboard
$ cat ~/.ssh/id_ed25519.pub
# Then select and copy the contents of the id_ed25519.pub file
# displayed in the terminal to your clipboard
Tip
Alternativ kannst du den ausgeblendeten Ordner .ssh suchen, die Datei in deinem bevorzugten Text-Editor öffnen und in die Zwischenablage kopieren.
-
Klicken Sie auf einer beliebigen Seite auf GitHub oben rechts auf Ihr Profilfoto und dann auf Einstellungen.
-
Klicke im Abschnitt „Zugriff“ der Seitenleiste auf SSH- und GPG-Schlüssel.
-
Klicke auf Neuer SSH-Schlüssel oder SSH-Schlüssel hinzufügen.
-
Gib im Feld „Title“ (Titel) eine aussagekräftige Kennzeichnung für den neuen Schlüssel ein. Wenn du z. B. ein einen privaten Laptop verwendest, kannst du diesen Schlüssel „Privater Laptop“ nennen.
-
Wähle den Schlüsseltyp aus, entweder Authentifizierung oder Signatur. Weitere Informationen zum Signieren von Commits findest du unter Informationen zur Verifizierung einer Commit-Signatur.
-
Kopiere deinen öffentlichen Schlüssel in das Feld „Schlüssel“.
-
Klicke auf SSH-Schlüssel hinzufügen.
-
Wenn du dazu aufgefordert wirst, bestätige den Zugriff auf dein Konto auf GitHub. Weitere Informationen finden Sie unter Sudo-Modus.
Note
Weitere Informationen zur GitHub CLI findest du unter Informationen zur GitHub CLI.
Bevor Du die GitHub CLI verwenden kannst, um Deinem Konto einen SSH-Schlüssel hinzuzufügen, musst Du dich bei der GitHub CLI authentifizieren. Weitere Informationen findest Du gh auth login in der Dokumentation zur GitHub CLI.
Um Deinem GitHub Konto einen SSH-Schlüssel hinzuzufügen, verwende den Unterbefehl ssh-key add, um Deinen öffentlichen Schlüssel anzugeben. Wenn du bei Authentifizierungsschlüsseln aufgefordert wirst, zusätzliche Bereiche anzufordern, befolge die Anweisungen in der Befehlszeile.
gh ssh-key add KEY-FILE --type {authentication|signing}
Um einen Titel für den neuen Schlüssel einzuschließen, verwende das Flag -t oder --title.
gh ssh-key add KEY-FILE --title "personal laptop"
Wenn du deinen SSH-Schlüssel gemäß den Anweisungen in Generieren eines neuen SSH-Schlüssels und Hinzufügen des Schlüssels zum ssh-agent generiert hast, kannst du den Schlüssel mit diesem Befehl zu deinem Konto hinzufügen.
gh ssh-key add ~/.ssh/id_ed25519.pub --type signing