Kurzanleitung: Installation von WinCVS mit sicherer Datenübertragung nach dem SSH-Protokoll unter Windows

Zusammenfassung

Diese Anleitung zeigt, wie WinCVS so installiert und eingerichtet wird, dass man sicher auf Quellen zugreifen kann, die auf einem CVS-Hostrechner abgelegt sind. "Sicher" bedeutet in diesem Zusammenhang, dass Unbefugte mit üblichen technischen Mitteln nicht an den übertragenen Quellcode bzw. übertragene Passwörter gelangen können. Es wird vorausgesetzt, dass der Benutzer (hier: henlich) bereits ein Konto auf dem CVS-Host (hier: mmecvs.mw.tu-dresden.de, je nach DNS-Konfiguration muss evtl. der vollständige Name host.domain angegeben werden) besitzt und dort bereits CVS und OpenSSH installiert sind (SSH-Protokoll-Version 1.5 oder höher). Mit dem kommerziellen SSH geht's prinzipiell auch, die Schlüsselverwaltung läuft jedoch etwas anders.

Begriffe

CVS ist ein Quellcode-Verwaltungssystem. Mit diesem lässt sich insbesondere die Arbeit mehrerer Entwickler an einem gemeinsamen Projekt (z. B. ein Programm oder WWW-Seiten) koordinieren. WinCVS ist eine grafische Windows-Benutzungsoberfläche für CVS. SSH ist ein Protokollstandard zur sicheren Datenübertragung in Rechnernetzen. Windows ist ein Betriebssystem für Personalcomputer. Personalcomputer sind ...

Hinweis

Die im folgenden beschriebenen Verzeichnisnamen sind nur Empfehlungen und können angepasst werden. Ebenso sind Benutzer- und Hostnamen nur Beispiele und müssen angepasst werden.

Wir installieren PuTTY

Die Programme PuTTY (Version 0.52 oder höher), Plink, PSCP, Pageant und PuTTYgen von der PuTTY-Download-Seite herunterladen und in Verzeichnis c:\bin installieren.
Ein Verzeichnis zum Speichern persönlicher Dateien (Home-Verzeichnis) anlegen, z. B. c:\home\henlich
Den Wert c:\bin der Umgebungsvariable PATH hinzufügen. Dies kann über Startmenü -> Einstellungen -> Systemsteuerung -> System -> Umgebung erfolgen. Als Trennzeichen zu anderen Verzeichnisnamen ist das Semikolon zu verwenden.
PuTTY starten und Protokoll "SSH" auswählen, Einstellungen als "Default Settings" abspeichern (siehe Bild).
Zum Testen der Plink-Installation: MS-DOS-Eingabeaufforderung öffnen.
```
plink -v henlich@mmecvs.mw.tu-dresden.de
```
(Hier sollte UNBEDINGT der Hostname GENAUSO wie später in CVS angegeben werden, inkl. Domain.) Jetzt wird Plink gestartet. Evtl. wird eine Warnung ausgeben, dass der Host unbekannt ist, mit y geht's weiter. Es wird das Benutzerpasswort für Benutzer henlich und CVS-Hostrechner mmecvs.mw.tu-dresden.de abgefragt. Passwort eingeben. Jetzt ist (hoffentlich) das Login erfolgt, mit logout abmelden.
Einen Schlüssel anlegen: Dazu PuTTYgen starten. Der Typ des Schlüssels (SSH1-RSA, SSH2-RSA oder SSH2-DSA) hängt vom Server ab. Wenn man nicht weiss, welche Schlüsseltypen vom Server unterstützt werden, fragt man den Systemverantwortlichen oder erzeugt am besten gleich drei Schlüssel und erspart sich später den Ärger. Dann einfach auf "Generate" klicken, dabei ein bisschen die Maus hin- und herschubsen (um Zufallszahlen zu erzeugen).
Als "Key comment" einen sinnvollen Text eingeben, er dient als Merkhilfe (für den Benutzer) und sollte eine eindeutige Beschreibung des eigenen Rechners (und evtl. den Benutzernamen auf dem eigenen Rechner) beinhalten Beispiel: "henlich@mmepc14 (SSH2 RSA)". Als "Key passphrase" sollte ein einfach zu merkender Satz gewählt werden (aus Bequemlichkeitsgründen nicht zu lang, aus Sicherheitsgründen nicht zu kurz). Wer mehrere Schlüsseltypen (s. o.) erzeugt, kann auch für alle die gleiche "passphrase" wählen.
SSH1-RSA-Schlüssel: Den Schlüssel mit "Save" in c:\home\henlich\.ssh\identity abspeichern. Den Public Key markieren und mit dem Editor in c:\home\henlich\.ssh\identity.pub ablegen.
SSH2-RSA-Schlüssel: Den Schlüssel mit "Save" in c:\home\henlich\.ssh\id_rsa abspeichern. Den Public Key markieren und mit dem Editor in c:\home\henlich\.ssh\id_rsa.pub ablegen.
SSH2-DSA-Schlüssel: Den Schlüssel mit "Save" in c:\home\henlich\.ssh\id_dsa abspeichern. Den Public Key markieren und mit dem Windows-Editor in c:\home\henlich\.ssh\id_dsa.pub ablegen.
Sicherheitshinweis

Der geheime Teil des Schlüssels (Datei identity, bzw. id_rsa, bzw. id_dsa) sollte den Rechner niemals verlassen! Bei einer Installation auf einem Zweitrechner sollte man lieber einen weiteren Schlüssel generieren.

Den öffentlichen Teil des gerade erzeugten Schlüssels auf den CVS-Server kopieren:

  c:
  cd \home\henlich\.ssh
  pscp identity.pub id_rsa.pub id_dsa.pub henlich@mmecvs.mw.tu-dresden.de:
  plink henlich@mmecvs.mw.tu-dresden.de

Auf dem CVS-Server:

  mkdir -p .ssh
  cat identity.pub >>.ssh/authorized_keys
  cat id_rsa.pub id_dsa.pub >>.ssh/authorized_keys2
  chmod -R 700 .ssh
  rm identity.pub id_rsa.pub id_dsa.pub
  logout

Pageant starten, am besten durch Einrichten eines Icons, siehe Bild. Aufnahme in die Autostart-Gruppe ist auch möglich. Pageant muss vor jeder WinCVS-Sitzung gestartet werden. Als Argument die zu benutzenden Schlüssel angeben, oder gleich alle drei.
Erneuter Test (nachdem Pageant läuft und Passphrase eingegeben wurde):
```
  plink -v henlich@mmecvs.mw.tu-dresden.de
  
```
Wenn alles geklaptt hat, erfolgt jetzt die Authentifizierung durch Pageant! Die Meldungen geben Hinweise, welche Schlüsseltypen vom Server unterstützt werden.
Sicherheitshinweis

Wenn Pageant gestartet ist, kann sich jeder, der physischen Zugang zu Deinem Rechner hat, auf dem CVS-Hostrechner einloggen! Bei längerer Abwesenheit entweder Pageant beenden (über Taskbar, siehe Bild) oder Bildschirmschoner mit Passwortschutz benutzen!

Hinweis am Rande

PuTTY (siehe oben) ist ein brauchbarer Terminal-Emulator und daher auch gut für die interaktive Arbeit auf dem Host geeignet. (Als "Härtetest" für die Güte einer Terminal-Emulation verwende ich den Midnight Commander. Sieht etwa so aus.)

Nun installieren wir WinCVS

Die Voraussetzung für die Installation von WinCVS ist das Vorhandensein einigermassen neuer DLLs (shlwapi.dll, comdlg32.dll, comctl32.dll). Diese DLLs werden z.B. durch die Installation des Internet Explorer 5.5 auf den neuesten Stand gebracht. (Wenn man die neu installierten DLLs irgendwo sichert, kann man hinterher auch den IE wieder deinstallieren, wenn man diesen nicht mag.)
WinCVS selbst ist einfach über das mitgelieferte Setup-Programm zu installieren.
Folgende Einstellungen sind anzupassen:
- CVSROOT eingeben (in der Form :ext:username@hostname:verzeichnis),
- "SSH Server" auswählen.
- Abwählen, sonst nervt's ohne Ende!
- Hier den Pfad zur plink.exe hinschreiben.
- Hier das oben angelegte Verzeichnis für persönliche Daten angeben.
- Wer gerne Dateien vergleicht (Vertrauen ist gut, Kontrolle ist besser), sollte das Programm ExamDiff (siehe unten) installieren und hier bei "External diff program" eintragen.