Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

Einen neuen SSH-Schlüssel zum GitHub-Konto hinzufügen

Du musst den Schlüssel außerdem zu deinem Konto hinzufügen, um es auf GitHub.com zu konfigurieren und den neuen (oder vorhandenen) SSH-Schlüssel zu verwenden.

Informationen zum Hinzufügen von SSH-Schlüsseln zu deinem Konto

Über SSH (Secure Shell Protocol) kannst du auf Daten in Repositorys in GitHub.com Daten in diese Repositorys 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 zu SSH.

Du kannst auch SSH verwenden, um Commits und Tags zu signieren. Weitere Informationen zum Signieren von Commits findest du unter Informationen zur Verifizierung einer Commitsignatur.

Nachdem du ein SSH-Schlüsselpaar generiert hast, musst du den öffentlichen Schlüssel zu GitHub.com hinzufügen, um denn SSH-Zugriff für dein Konto zu aktivieren.

Voraussetzungen

Wenn du deinem Konto unter GitHub.com einen neuen SSH-Schlüssel hinzufügst, führe die folgenden Schritte aus.

  1. Suche nach vorhandenen SSH-Schlüsseln. Weitere Informationen findest du unter Überprüfen auf vorhandene SSH-Schlüssel.
  2. Generiere einen neuen SSH-Schlüssel, und füge ihn dem SSH-Agent deines Computers hinzu. Weitere Informationen findest du 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

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 findest Du unter „Wechseln von Remote-URLs von HTTPS zu SSH“.

Hinweis: 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. Du kannst deinem persönlichen Konto keine neuen DSA-Schlüssel für GitHub.com 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.

  1. 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 clipboard

    Tipp: Wenn pbcopy nicht funktioniert, kannst Du den ausgeblendeten Ordner .ssh suchen, 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

    Tipp: Wenn clip nicht funktioniert, kannst Du den ausgeblendeten Ordner .ssh suchen, die Datei in Deinem bevorzugten Text-Editor öffnen und in die Zwischenablage kopieren.

    $ cat ~/.ssh/id_ed25519.pub
      # Then select and copy the contents of the id_ed25519.pub file
      # displayed in the terminal to your clipboard

    Tipp: Alternativ kannst Du den ausgeblendeten Ordner .ssh suchen, die Datei in Deinem bevorzugten Text-Editor öffnen und in die Zwischenablage kopieren.

    1. Klicken Sie auf einer beliebigen Seite in der oberen rechten Ecke auf Ihr Profilfoto und anschließend auf **Einstellungen**.

    Symbol „Settings" (Einstellungen) auf der Benutzerleiste

  2. Klicke im Abschnitt „Zugriff“ der Seitenleiste auf SSH und GPG-Schlüssel.

  3. Klicke auf Neuer SSH-Schlüssel oder SSH-Schlüssel hinzufügen. Schaltfläche für SSH-Schlüssel

  4. 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.

  5. Wähle den Schlüsseltyp aus, entweder Authentifizierung oder Signatur. Weitere Informationen zum Signieren von Commits findest du unter Informationen zur Verifizierung einer Commitsignatur.

  6. Kopiere deinen öffentlichen Schlüssel in das Feld „Schlüssel“. Das Schlüsselfeld

  7. Klicke auf SSH-Schlüssel hinzufügen. Die Schaltfläche „Schlüssel hinzufügen“

  8. Wenn du dazu aufgefordert wirst, bestätige den Zugriff auf dein Konto auf GitHub. Weitere Informationen findest du unter Sudo-Modus.

Weitere Informationen zu GitHub CLI findest du unter Informationen zu 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.

Derzeit kannst du über die GitHub CLI nur SSH-Authentifizierungsschlüssel hinzufügen. SSH-Signaturschlüssel können nicht hinzugefügt werden.

Um deinem GitHub-Konto einen SSH-Authentifizierungsschlüssel hinzuzufügen, verwende den Unterbefehl ssh-key add, zum Angeben deines öffentlichen Schlüssels.

gh ssh-key add KEY-FILE

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 generiert hast, indem Du die Anweisungen unter „Generieren eines neuen SSH-Schlüssels“ befolgt hast, kannst Du Deinem Konto mit diesem Befehl den Schlüssel hinzufügen.

gh ssh-key add ~/.ssh/id_ed25519.pub

Weiterführende Themen