Wie fügt man in Sourcetree einen SSH-Key hinzu?
- Warum SSH-Keys für Sourcetree verwenden?
- SSH-Key generieren
- SSH-Key in Sourcetree hinzufügen
- SSH-Key auf dem Git-Server hinterlegen
- Verbindung testen und Probleme beheben
Sourcetree ist ein beliebter Git-Client, der das Verwalten von Repositories durch eine grafische Benutzeroberfläche erleichtert. Wenn du SSH zur Authentifizierung mit einem entfernten Git-Repository nutzen möchtest, musst du deinen SSH-Key in Sourcetree hinzufügen. In dieser ausführlichen Anleitung erfährst du, wie du einen SSH-Key in Sourcetree generierst und konfigurierst, um eine sichere und komfortable Verbindung mit deinem Git-Server herzustellen.
Warum SSH-Keys für Sourcetree verwenden?
SSH-Keys bieten eine sicherere Alternative zu herkömmlichen Passwörtern, wenn es um die Authentifizierung bei Git-Servern wie GitHub, Bitbucket oder GitLab geht. Durch die Verwendung eines privaten und öffentlichen Schlüsselpaares können Verbindungen automatisiert und ohne manuelle Passworteingabe hergestellt werden. Sourcetree unterstützt diese Methode, um den Zugriff auf Repositories zu vereinfachen.
SSH-Key generieren
Bevor du den SSH-Key in Sourcetree hinzufügen kannst, benötigst du zunächst einen privaten und einen öffentlichen SSH-Schlüssel. Unter Windows kannst du dafür beispielsweise die Git Bash verwenden oder einen externen SSH-Key-Manager wie PuTTYgen. Unter macOS oder Linux ist das Generieren eines SSH-Keys über das Terminal mit dem Befehl ssh-keygen möglich. Während der Erstellung wirst du nach einem Speicherort und optional einem Passwort für den Schlüssel gefragt. Der öffentliche Schlüssel, der mit der Endung .pub versehen ist, musst du später bei deinem Git-Server hinterlegen.
SSH-Key in Sourcetree hinzufügen
Nachdem der SSH-Key erzeugt wurde, muss er in Sourcetree konfiguriert werden. Öffne zunächst Sourcetree und navigiere zu den Einstellungen bzw. den Optionen. Dort gibt es eine Kategorie für SSH-Keys oder SSH-Authentication, in der du den Pfad zu deinem privaten SSH-Schlüssel hinterlegen kannst. Sourcetree arbeitet dabei meist mit einem eingebauten SSH-Agent oder mit externen Programmen wie Pageant (bei PuTTY). Achte darauf, dass der Pfad korrekt eingegeben ist und der SSH-Agent gestartet ist, damit die Schlüssel geladen werden.
SSH-Key auf dem Git-Server hinterlegen
Damit das Git-Repository deine Verbindung akzeptiert, musst du den öffentlichen Schlüssel auf dem Git-Server wie GitHub, Bitbucket oder GitLab hinterlegen. Kopiere den Inhalt der Datei mit der Endung .pub und füge ihn in deinem Nutzeraccount unter den SSH-Schlüssel-Einstellungen des Git-Servers ein. Nach dem Hinzufügen kannst du die Verbindung in Sourcetree testen, etwa durch das Klonen eines Repositorys über SSH oder das Pullen und Pushen von Änderungen.
Verbindung testen und Probleme beheben
Wenn du alles richtig eingerichtet hast, sollte Sourcetree ohne Passwortabfrage mit dem Git-Server kommunizieren. Falls Verbindungsprobleme auftreten, überprüfe zunächst, ob der SSH-Agent aktiv ist, der korrekte Schlüssel verwendet wird und der öffentliche Schlüssel am Server eingetragen ist. Mögliche Fehlermeldungen helfen oft dabei, die Ursache zu finden. Zudem kann es hilfreich sein, die Verbindung manuell über das Terminal oder eine Git-Bash mit ssh -T git@ zu testen, um sicherzustellen, dass der SSH-Zugang funktioniert.