TortoiseGIT, Git Bash und PLink/PuTTY gemeinsam mit einem SSH-Schlüsselpaar verwenden

Um Git unter Windows benutzen zu können gibt es verschiedene Möglichkeiten. Die Kombination aus msysGit und TortoiseGit scheint mir aber ganz gute Dienste zu leisten. Ähnlich wie TortoiseSVN fügt sich TortoiseGit in das Kontextmenü des Explorers ein. Das ist gerade für Leute ohne viel Erfahrung mit der Kommandozeilen (CLI, Command line interface) hilfreich. Obwohl Git auf jeden Fall wunderbar und schnell via CLI zu bedienen ist. Um im Windows eine halbwegs gute Shell zur Git zur Verfügung zu haben, bietet sich Git Bash an. Bei der Installation von msysGit kann man diese ebenfalls ins Kontextmenü integrieren:

MsysGit-Setup: GitBash

Aber gerade um manche (und vielleicht zunehmend mehr ;-) ) Git-Arbeitsschritte mittels CLI zu versuchen ist es wichtig, dass man sich nicht unnötig Steine in den Weg legt. Ein möglicher Stein ist die Authentifizierung. Git verwendet standardmäßig SSH als Authentifizierungsmechanismus. SSH baut in den meisten Fällen auf einem Public-Key-Verfahren auf, nutzt nach erfolgreicher Authentifizierung aber ein symmetrisches Verfahren. MsysGit hat die dafür notwendigen Programme schon für sich und Git Bash verfügbar gemacht.

Um SSH für TortoiseGit verfügbar zu machen, kann man sich bei dessen Installation wahlweise für TortoisePLink oder OpenSSH entscheiden. Letzteres ist das eben erwähnte, von msysGit verwendete Paket:

TortoiseGit Setup: Authentifizierung

TortoiseGit kann mit beidem Umgehen, aber wie auch im Setup beschrieben integriert sich TortoiseGit deutlich besser in Windows und soll hier verwendet werden.

Das Ziel ist es also, dass TortoiseGit sich mit Hilfe von TortoisePLink bei anderen Git-Repositories authentifizieren kann. Außerdem soll selbiges auch mit Git Bash möglich sein, idealerweise mit so wenig Redundanz wie möglich.

Schlüssel generieren

Für die Verwendung von SSH sind hier ein öffentlicher und ein privater Schlüssel notwendig. Diese werden letztlich einfach durch zwei Dateien dargestellt. Oft werden diese "id_" und "id_.pub" genannt, wobei beispielsweise für "rsa" steht. In der Unix und GNU/Linux-Welt werden diese normalerweise im Ordner ".ssh" im Home-Verzeichnis des Benutzers abgelegt.

Dieses Schlüsselpaar muss zunächst generiert werden. Am einfachsten geht das mittels Git Bash. Das ist über den Startmenüeintrag "Git" aufrufbar. Nachdem sich die Shell geöffnet hat erwartet einen eine leere Eingabeaufforderung. Oft wird als Bezeichnung des Schlüssels die E-Mail-Adresse angegeben, im Beispiel ist diese "my@email.de". Dort muss jetzt folgendes Eingegeben werden:

Darauf hin sollte die Ausgabe ungefähr so aussehen:

Der Standardspeicherort kann übernommen werden (Enter) und das Passwort sollte, wie jedes Passwort, ein gutes sein. Das Ergebnis sind die zwei neue Schlüsseldateien: id_rsa und id_rsa.pub. Daraufhin kann man zumindest schon mal in Git Bash SSH nutzen.

Übrigens, dass Passwort ist weder (!) öffentlicher noch privater Schlüssel. Es wird genutzt um den privaten Schlüssel zu schützen. Dieser soll nämlich nicht unverschlüsselt herum liegen.

TortoiseGit

Als nächstes muss TortoiseGit mit dem soeben generierten Schlüsselpaar bekannt gemacht werden. Das geht mittels dem von TortoiseGit installierten Programm puttygen. Es befindet sich im Startmenüeintrag von TortoiseGit. Wir wollen damit aber keinen neues Schlüsselpaar genieren. Stattdessen soll der eben mittels OpenSSH generierte Schlüssel eingelesen und im PuTTY-eigenen Format gespeichert werden.

Dazu muss im Menü "Conversions" der Eintrag "Import key" ausgewählt werden. Im nun erscheinenden Dialog wird der private Schlüssel ausgewählt. Im Beispiel ist das c:\Users\MrPringle\.ssh\id_rsa. Das zuvor vergebene Passwort muss nun eingegeben werden und den Schlüssel ist importiert. Abschließend muss nur noch der private Schlüssel gespeichert werden. Dazu auf die "Save private key"-Schaltfläche drücken und z.B. der Übersicht halber eine Datei "id_rsa.ppk" im selben Ordner wie die anderen Schlüsseldaten anlegen. Der öffentliche Schlüssel muss nicht separat gespeichert werden. Dieser ist nämlich als Klartext in der Datei id_rsa.pub bereits problemlos lesbar.

Bei TortoiseGit kann man nun entweder einzelnen Remotes (andere Repositories) jeweils einen Schlüssel zuordnen oder ein Standardschlüssel für das lokale Repository angeben. Im Dialog für das Klonen eines Repositories kann man einen PuTTY-Key angeben:

TortoiseGit: Clone

Für ein Repository was das Lesen ohne Authentifizierung erlaubt, kann dieser Eintrag weggelassen werden. Erfordert die Kommunikation aber nun eine Authentifizierung wird die fehlende Angabe eines Schlüssels mit der folgenden Meldung beantwortet:

"No supported authentication method available"

Die zuvor erstellte id_rsa.ppk-Datei kann direkt im Clone-Dialog angegeben werden. Nach einem Klick auf "Clone" muss denn das Passwort eingegeben werden. Leider sucht TortoiseGit nicht standardmäßig im .ssh-Ordner des Nutzers.

Alternativ ist es eine Möglichkeit, ein weiteres mitgeliefertes Programm mit der Schlüsselverwaltung zu beauftragen: pagent. Ist dieses aktiv und kennt die benutzten Schlüssel, kümmert es sich bei Anfragen, wie z.B. beim Klonen, um die Preisgabe des Schlüssels. Das geschieht in einer sicheren Art und Weise und man hat den Vorteil das oder die Passwörter nur einmal beim Start von pagent eingeben zu müssen. Genauer basiert auch die direkte Angabe des Schlüssels im Clone-Dialog auf einer anschließenden automatischen Verwaltung mit pagent. Um es manuell zu starten wählt man es z.B. aus dem Startmenüeintrag von TortoiseGit aus. Über das Kontextmenü des Systray-Icons kann man dann Schlüssel hinzufügen.

Falls nach wie vor ein Fehler kommt, könnte das daran liegen, dass das Remote-Repository noch nicht über den neuen Public-Key informiert wurde. Das soll dann auch der letzte notwendige Schritt sein.

SSH und Git

Der Normalfall ist, dass beim Zielrepository der eigene öffentliche Schlüssel zu hinterlegen ist. Damit kann verifiziert werden, ob man selber den privaten Schlüssel besitzt. Webseiten wie Github, repo.or,cz oder Assembla bieten dazu in den eigenen Account-Einstellungen die Möglichkeit einen (oder mehrere) öffentlichen Schlüssel hinzuzufügen, häufig ist dann etwas von "SSH Public Keys" zu lesen. Dazu muss dieser oft in ein Textfeld kopiert werden. Eine einfache Möglichkeit ist es den Inhalt der Datei "id_rsa.pub" zu kopieren indem man sie beispielsweise in einem Editor öffnet. Es ist darauf zu achten, dass tatsächlich alles (Strg+A) kopiert wird. Zum Teil ist es auch möglich, die Datei direkt im Webinterface auszuwählen.

Ist das geschafft, steht der erfolgreichen verschlüsselten Verbindung eigentlich nichts mehr im Wege.

CLI und weitere Einstellungen

Mittels Git Bash war die Nutzung via SSH, bis auf den letzten Schritt, schonseit der Schlüsselerstellung möglich. Es lassen sich weitere kleine Einstellungen nun auch sehr gut (und für TortoiseGit nutzbar) damit einbringen. Unabhängig davon in welchem Ordner man sich befindet, kann man immer globale Einstellungen von Git ändern. Es sollten für Commits z.B. immer ein gewünschter Name und eine E-Mail-Adresse eingetragen sein: