Zum Inhalt springen
Geprüft

SSH-Zugang für Entwickler

SSH-Schlüssel des Kontos, welche Server sie erreichen können, und kurzlebige Tokens zum Verbinden mit einem Server.

Der Zugriff auf einen von Xuda verwalteten Server per SSH hat drei Ebenen: die Schlüssel, die dein Konto besitzt, welche davon ein bestimmter Server akzeptiert, und ein kurzlebiges, widerrufbares Token, das die Verbindung tatsächlich öffnet. Jede Verbindung läuft als Tunnel über Xuda; nichts hier gibt dir die eigene Adresse des Servers direkt.

Einen Schlüssel zu deinem Konto hinzufügen

Einstellungen > Sicherheit > SSH-Schlüssel enthält jeden öffentlichen Schlüssel, den dein Konto einem Server anbieten kann. Jeder Schlüssel ist eine Zeile: sein Name, der Typ und das Ende des Schlüssels, wann er hinzugefügt wurde, wie viele Server er öffnet, und ein Status: An, Aus, Läuft bald ab, Abgelaufen oder Kein Server.

Ein Schlüsselpaar erzeugen, falls du noch keins hast

Terminal
ssh-keygen

Übernimm den Standardspeicherort und lege optional eine Passphrase fest. Das erzeugt zwei Dateien: einen privaten Schlüssel, den du behältst, und eine .pub-Datei, die du teilst.

Den öffentlichen Schlüssel hinzufügen

Drücke SSH-Schlüssel hinzufügen (bei einem Konto ohne Schlüssel öffnet sich das Formular sofort). Füge im Formular Neuer SSH-Schlüssel den Inhalt der .pub-Datei in Inhalt des SSH-Schlüssels ein, gib ihm einen Schlüsselname und drücke Schlüssel hinzufügen. Der Schlüssel wird beim Einfügen geprüft, sodass ein privater Schlüssel, eine Zeile, die kein öffentlicher Schlüssel ist, oder ein Kommentar ohne @ benannt wird, bevor du etwas hinzufügst. Ein Ablaufdatum (optional) kann heute oder später liegen; lass es leer für einen Schlüssel, der nie abläuft. Der neue Schlüssel öffnet sich dann an Ort und Stelle, markiert mit Kein Server: Niemand kann ihn benutzen, bis du seine Server auswählst (siehe nächster Abschnitt).

Einen Schlüssel verwalten

Drücke die Zeile eines Schlüssels, um ihn an Ort und Stelle zu öffnen; es ist immer nur ein Schlüssel offen. Der offene Schlüssel zeigt seinen Status, den Schlüssel mit seinem Ablaufdatum und die Tage bis zu diesem Datum. Ein Schlüssel, der dich braucht, öffnet sich von selbst: einer, der abgelaufen ist, aber noch auf einem Server liegt, sonst der auf einem Server, der innerhalb von 14 Tagen am frühesten abläuft. Im offenen Schlüssel:

  • Bearbeiten ändert den Namen und das Ablaufdatum des Schlüssels. Der Schlüssel selbst ist schreibgeschützt: Um ihn zu ändern, füge einen neuen Schlüssel hinzu. Bei einem Schlüssel mit Läuft bald ab heißt die Schaltfläche Ablaufdatum verlängern, bei einem abgelaufenen Schlüssel Neues Ablaufdatum festlegen; beides ist dieselbe Bearbeitung, am Datum geöffnet. Leeren neben dem Datum entfernt das Ablaufdatum.
  • Der Schalter Zugriff schaltet den Schlüssel aus, ohne ihn zu löschen, wodurch er auf einen Schlag von jedem Server entfernt wird, auf dem er installiert ist. Ein Server, der nicht erreichbar ist, behält den Schlüssel, und die Zeile unter dem Schalter sagt, wie viele Server nicht geantwortet haben, sodass du es erneut versuchen kannst. Das Wiedereinschalten eines Schlüssels installiert ihn nicht neu: Füge ihn auf jedem Server erneut hinzu.
  • Löschen bittet um Bestätigung, nimmt den Schlüssel dann von jedem Server, den er öffnet, und löscht ihn. Antwortet ein Server nicht, wird der Schlüssel nicht gelöscht.

Das Zugriffsprotokoll, die letzte Zeile unter deinen Schlüsseln, öffnet sich an Ort und Stelle und listet jede Erteilung, Entfernung und jedes Ablaufen im Konto auf, das neueste zuerst: sechs Ereignisse, dann Alle anzeigen für den Rest (insgesamt die letzten 500). Aktivität für diesen Schlüssel in einem offenen Schlüssel öffnet dasselbe Protokoll für genau diesen Schlüssel, und Alle Schlüssel weitet es wieder auf das Konto aus.

Ablauf

Ein Schlüssel innerhalb von 14 Tagen vor seinem Ablaufdatum zeigt Läuft bald ab, solange er auf einem Server liegt; nach dem Datum zeigt er Abgelaufen. Bevor sein Datum verstreicht, zeigt ein ausgeschalteter Schlüssel Aus und einer ohne Server Kein Server. Abgelaufene Schlüssel werden einmal pro Stunde von ihren Servern genommen; schalte einen abgelaufenen Schlüssel aus, um ihn sofort zu entfernen. Sobald er von seinen Servern entfernt ist, hat er keinen Schalter mehr: Gib ihm mit Neues Ablaufdatum festlegen ein neues Datum und füge ihn dann erneut auf einem Server hinzu. Ein abgelaufener oder ausgeschalteter Schlüssel kann keinem Server neu zugewiesen werden, aber das Entfernen eines bereits zugewiesenen funktioniert weiterhin.

Wählen, welchen Server ein Schlüssel erreichen kann

Einen Schlüssel zu deinem Konto hinzuzufügen gibt ihm für sich allein keinen Zugriff auf irgendetwas, und der eigene Bildschirm des Schlüssels zeigt, wie viele Server er öffnet, nicht welche. Öffne den Tab Erweitert eines VPS, verwalteten VPS, Rechenzentrums oder Deployments und drücke Schlüssel zuweisen in der Zeile SSH-Schlüssel unter Aktuell halten, um zu wählen, welche Schlüssel deines Kontos diesen bestimmten Server erreichen dürfen.

Beim Speichern wird deine Auswahl mit dem abgeglichen, was beim Öffnen der Auswahl installiert war: Neu angehakte Schlüssel werden zuerst installiert, dann werden abgewählte entfernt, sodass ein Schlüssel, den der Server ablehnt (weil er aus oder abgelaufen ist), nie einen bereits funktionierenden Zugriff entziehen kann. Ein ausgeschalteter oder abgelaufener Schlüssel wird in der Auswahl als solcher angezeigt und kann nicht neu ausgewählt werden.

Mit dem Server verbinden

Öffne das Projekt und drücke Verbinden in der Zeile Sicher per SSH verbinden (nur Projekte der VPS-Familie), um Entwicklerzugang zu öffnen, eine Verwaltung für benannte, widerrufbare Verbindungstokens, getrennt von den Kontoschlüsseln oben.

Einen benannten Zugang erstellen

Drücke Zugang hinzufügen, gib ihm eine Bezeichnung (für wen oder was er ist) und optional ein Ablaufdatum (7, 30, 90 oder 365 Tage, oder nie). Beim Erstellen wird ein einmaliges Verbindungstoken angezeigt: Kopiere es jetzt, es kann nicht erneut angezeigt werden.

Den Client installieren und verbinden

Der Dialog liefert pro Plattform (macOS, Linux, Windows) einen kopierfertigen Installationsbefehl und einen Verbindungsbefehl, gebaut um websocat, das die Verbindung zu einem Port auf deinem eigenen Rechner tunnelt. Richte einen beliebigen SSH- oder SFTP-Client auf diese lokale Adresse, sobald der Tunnel läuft, und melde dich als root an.

Danach verwalten

Jeder benannte Zugang hat einen eigenen Schalter zum Aussetzen; das Aussetzen, das Verstreichen eines Ablaufdatums oder das Löschen eines Zugangs wird am Tunnel selbst durchgesetzt und schließt eine bereits laufende Sitzung. Neu generieren erzeugt ein frisches Token für einen bestehenden Zugang und macht das alte ungültig; es wird nie automatisch rotiert, da das jeden abschneiden würde, der es noch benutzt. Das Löschen eines Zugangs verlangt zuerst eine Bestätigung.

Permission denied (publickey)

Ein Verbindungsversuch scheitert mit diesem Fehler, wenn diesem Server noch kein Kontoschlüssel zugewiesen wurde. Füge unter Einstellungen > Sicherheit > SSH-Schlüssel einen Schlüssel hinzu und weise ihn dem Server zu, bevor du es erneut versuchst.