SSH-Key erstellen

In dem nachfolgenden Artikel zeigen wir Ihnen für Windows 11 und Mac, wie Sie einen SSH-Key generieren und diesen für die Herstellung der SSH-Verbindung verwenden.

Der Vorteil der Anmeldung mit SSH-Key liegt darin, dass Sie dafür nicht das Passwort Ihres Webhostings verwenden und allenfalls sogar weitergeben müssen. Sie können nämlich für jede Person einen eigenen SSH-Key erstellen (z. B. für sich und für Ihren Webmaster).

Ausserdem können Sie denselben SSH-Key bei mehreren Webhostings hinterlegen und müssen sich somit nicht mehrere Passwörter merken.

Hinweis: Wie Sie SSH in Ihrem Hostpoint Control Panel erstmalig einrichten und mit einem Passwort verwenden können, ist in diesem Artikel erklärt.

Windows

SSH-Key generieren

Um sich mit einem SSH-Key anzumelden, muss der Key zuerst generiert und gespeichert werden.

Geben Sie im Suchfeld unten in der Taskleiste «Power» ein und klicken Sie im rechten Bereich auf «Öffnen». Es öffnet sich die PowerShell-Konsole und Ihr Home-Verzeichnis wird angezeigt: PS C:\Users\ihr_home_verzeichnis
Legen Sie mit folgendem Befehl ein neues Verzeichnis in Ihrem Home-Verzeichnis an:
```
mkdir .ssh
```
Wechseln Sie mit folgendem Befehl ins neue Verzeichnis:
```
cd .ssh
```
Generieren Sie mit folgendem Befehl einen SSH-Key im neuen Verzeichnis:
```
ssh-keygen -t ed25519
```
Überlegen Sie sich eine sichere Passphrase und geben Sie diese zweimal ein.

Wichtig: Die Passphrase müssen Sie sich gut merken, denn diese muss einmalig bei der Anmeldung am SSH-Client eingegeben werden. Wenn Sie diese verlieren, kann der bestehende Private Key (privater Schlüssel) nicht mehr verwendet werden. In diesem Fall muss ein neuer SSH-Key erstellt und der Public Key (öffentlicher Schlüssel) erneut auf dem Server hinterlegt werden.
Drücken Sie die ENTER-Taste.

→ Das SSH-Key-Paar (Private Key und Public Key) wurde generiert und auf Ihrem Computer gespeichert.

SSH-Key auf den Server kopieren

Nun müssen Sie den SSH-Key auf den Server kopieren. Das können Sie direkt in der PowerShell erledigen. Alternativ können Sie den SSH-Key auch im Hostpoint Control Panel hinzufügen.

PowerShell

Wenn Sie immer noch im Verzeichnis PS C:\Users\info\.ssh> sind, geben Sie cd ../../.. ein und drücken Sie erneut die ENTER-Taste. Nun befinden Sie sich im Verzeichnis PS C:\> .
Geben Sie folgenden Befehl ein, um den generierten Key auf den Server zu kopieren:
```
type $env:USERPROFILE\.ssh\id_ed25519.pub | ssh -m hmac-sha2-512 HauptAccount@HauptAccount.ssh.cloud.hostpoint.ch "cat >> .ssh/authorized_keys"
```
Info: Hinweis: Ersetzen Sie dabei den Benutzernamen HauptAccount immer durch Ihre eigenen Angaben aus dem Hostpoint Control Panel.
Sie werden nach der Eingabe dieses Befehls nach einem Passwort gefragt. Geben Sie nun das Passwort des Haupt-Accounts ein.

Info: Hinweis: Das Passwort für Ihren Haupt-Account können Sie direkt im Hostpoint Control Panel festlegen. Öffnen Sie dafür unter «Services» Ihr Webhosting, wählen Sie «Advanced» und dann «Passwort-Wechsel». Dabei handelt es sich nicht um das Passwort Ihrer Hostpoint ID, sondern um ein separates Passwort für SSH-, SQL- und FTP-Zugriffe mit dem Haupt-Account des Hostings.
Schliessen Sie alle geöffneten Terminal-Fenster.

→ Der SSH-Key wurde auf den Server kopiert.

Hostpoint Control Panel

Öffnen Sie den Public Key in Ihrer PowerShell mit folgendem Befehl:
```
Get-Content "$env:USERPROFILE\.ssh\id_ed25519.pub"
```
Markieren Sie den angezeigten Text mit der Maus und kopieren Sie ihn in die Zwischenablage.
Im Hostpoint Control Panel können Sie diesen unter unter «Advanced» > «SSH-Zugang» > «SSH Authorized Keys bearbeiten» hinzufügen:
Fügen Sie den Text aus der Zwischenablage im Feld «Authorized Keys» ein und speichern Sie ihn mit dem Button «Speichern».

→ Der SSH-Key wurde nun auf den Server kopiert.

Erste Verbindung herstellen

Geben Sie folgenden Befehl ein, um erstmalig eine Verbindung mit dem SSH-Key herzustellen:

PS C:\Users\ihr_home_verzeichnis\.ssh> ssh -m hmac-sha2-512 HauptAccount@HauptAccount.ssh.cloud.hostpoint.ch

Hinweis: Ersetzen Sie dabei den Benutzernamen HauptAccount immer durch Ihre eigenen Angaben aus dem Hostpoint Control Panel und ihr_home_verzeichnis durch Ihr persönliches Home-Verzeichnis.

Geben Sie Ihre persönliche Passphrase ein.
Wenn Sie sich zum ersten Mal mit SSH mit einem Server verbinden, werden Sie möglicherweise gefragt, ob Sie dem «Fingerprint» vertrauen möchten.

Zur Sicherheit können Sie überprüfen, ob die in der Meldung erwähnte IP-Adresse mit der IP-Adresse in Ihrer DNS-Zone übereinstimmt. Anschliessend können Sie die Verbindung mit «yes» herstellen. Wie Sie unsere Fingerprints automatisch prüfen lassen können, erfahren Sie im Artikel «Was sind gängige Probleme beim Zugriff via SSH?».

→ Wenn die Verbindung erfolgreich hergestellt wurde, sehen Sie folgende Seite:
Sie haben sich nun über den gespeicherten SSH-Key mit dem Server verbunden, ohne dass ein Passwort eingegeben werden musste.

Verbindungsdaten speichern

Um das Ganze noch komfortabler zu machen, können Sie Ihre Verbindungsdaten in der SSH-Konfigurationsdatei speichern. Auf diese Weise müssen Sie die Daten nicht mehr eingeben, wenn Sie eine SSH-Verbindung aufbauen möchten.

Gehen Sie dazu wie folgt vor:

Legen Sie eine Datei mit dem Namen config im Verzeichnis C:\Users\ihr_home_verzeichnis\.ssh an, indem Sie über einen Rechtsklick im Explorer auf «Neu» > «Textdokument» klicken. Achten Sie bitte darauf, dass Sie zuerst oben in der Leiste auf «Anzeigen» > «Einblenden» > «Dateinamenerweiterungen» klicken, damit Sie die Dateierweiterung .txt sehen.
Öffnen Sie die Datei mit einem Doppelklick und bearbeiten Sie diese wie folgt:

Was	Werte
Host	hostpoint (frei wählbar)
HostName	HauptAccount.ssh.cloud.hostpoint.ch
User	HauptAccount
Port	22
MACs	hmac-sha2-512

Wie immer müssen Sie dabei HauptAccount durch Ihren Benutzernamen ersetzen.

Der Inhalt der Datei sieht dann z. B. so aus:

~/config

Host hostpoint
  HostName HauptAccount.ssh.cloud.hostpoint.ch
  User HauptAccount
  Port 22
  MACs hmac-sha2-512

Speichern und schliessen Sie die Datei.
Entfernen Sie die Dateiendung .txt und bestätigen Sie den Vorgang.
Sie können die Dateinamenerweiterungen jetzt wieder ausblenden, wenn Sie möchten.

→ Die Konfigurationsdatei wurde gespeichert. Wenn Sie sich das nächste Mal via SSH mit dem Server verbinden möchten, genügt es, wenn Sie den Befehl ssh hostpoint eingeben. Die nötigen Verbindungsdaten werden dann automatisch aus der Datei abgefragt. Danach geben Sie einmal Ihre Passphrase ein und Sie sind verbunden.