Zum Hauptinhalt springen
Version: 1.99.x (Q3 26)

Verbindung zum Workspace per SSH herstellen

Diese Anleitung führt durch die Einrichtung des Secure-Shell-Zugriffs (SSH) für Workspaces. Dies ermöglicht eine sichere Verbindung zur Entwicklungsumgebung direkt über das lokale Terminal.

Voraussetzungen​

Bevor eine Verbindung hergestellt werden kann, muss auf dem lokalen Rechner ein SSH-Schlüsselpaar generiert sein. Falls noch keines vorhanden ist, im lokalen Terminal folgenden Befehl ausführen:
ssh-keygen -t ed25519 -C "[email protected]"

SSH-Schlüssel hinzufügen (über die Benutzeroberfläche)​

Zu User Settings > SSH Keys navigieren und auf Add SSH Key klicken, um den öffentlichen Schlüssel hinzuzufügen oder hochzuladen.

Hinzufügen eines öffentlichen SSH-Schlüssels in der Benutzeroberfläche.

Alternative: SSH-Schlüssel hinzufügen (über die Public API)​

Einen neuen öffentlichen Schlüssel registrieren​

Voraussetzungen​

  • Ein gültiges Public API Token zur Authentifizierung der Anfragen zur Schlüsselverwaltung. Details dazu in der Public-API-Dokumentation.

Eine POST-Anfrage senden, um den öffentlichen Schlüssel hochzuladen. <YOUR_API_TOKEN> durch das eigene Authentifizierungstoken ersetzen und den öffentlichen Schlüssel in das Feld publicKey einfügen.

  • Endpunkt: POST https://<YOUR_DOMAIN>/api/ssh/keys
  • Header:
    • Authorization: Bearer <YOUR_API_TOKEN>
    • Content-Type: application/json
curl -X POST https://<YOUR_DOMAIN>/api/ssh/keys \
 -H "Authorization: Bearer <YOUR API TOKEN>" \
 -H "Content-Type: application/json" \
 -d '{  "publicKey": "<YOUR PUBLIC KEY>"  }'

Registrierte Schlüssel anzeigen​

Um eine Liste aller öffentlichen Schlüssel zu sehen, die aktuell für den Zugriff auf die Workspaces autorisiert sind, eine GET-Anfrage senden:

curl -X GET https://<YOUR_DOMAIN>.com/api/ssh/keys \
  -H "Authorization: Bearer <YOUR_API_TOKEN>"

Einen SSH-Schlüssel entfernen​

Um den Zugriff für einen bestimmten Schlüssel zu widerrufen, eine DELETE-Anfrage senden:

curl -X DELETE https://<YOUR_DOMAIN>.com/api/ssh/keys \
  -H "Authorization: Bearer <YOUR API TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "publicKeyFingerprint": "<YOUR PUBLIC KEY FINGERPRINT>"
  }'

Verbindung zum Workspace herstellen​

Sobald der öffentliche Schlüssel registriert ist, lässt sich die Verbindungszeichenfolge des Workspace direkt in der Plattform finden.

  1. Den aktiven Workspace öffnen.
  2. Auf das Editor-Dropdown-Menü oben rechts in der Symbolleiste klicken.
  3. Connect via SSH auswählen.
  4. Die Verbindungszeichenfolge aus dem Dialogfenster kopieren und in das lokale Terminal einfügen.

Kopieren der Verbindungszeichenfolge aus dem Workspace.

Beispielbefehl:

ssh -J <dcId>.ssh.<your_domain> user@<workspaceId>

Die Rechenzentrums-ID (Data Center ID) ist in den Team-Einstellungen zu finden (nur für Admins).

Verbindung von einer lokalen IDE aus​

Für die Einrichtung der SSH-Remote-Entwicklung bitte die offizielle Dokumentation der jeweiligen IDE konsultieren: