Zum Hauptinhalt springen
Version: Weekly Build

Verbindung zum Workspace via 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 ein SSH-Schlüsselpaar auf dem lokalen Rechner vorhanden sein. Falls noch keines existiert, kann es im lokalen Terminal mit folgendem Befehl erzeugt werden:
ssh-keygen -t ed25519 -C "[email protected]"

SSH-Key hinzufügen (über die UI)​

Navigiere zu User Settings > SSH Keys und klicke auf Add SSH Key, um den öffentlichen Schlüssel hinzuzufügen oder hochzuladen.

Hinzufügen eines öffentlichen SSH-Keys in der UI.

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

Einen neuen Public Key registrieren​

Voraussetzungen​

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

Sende eine POST-Anfrage, um den öffentlichen Schlüssel hochzuladen. Ersetze <YOUR_API_TOKEN> durch das eigene Authentifizierungstoken und füge den öffentlichen Schlüssel-String in das Feld publicKey ein.

  • Endpoint: POST https://<YOUR_DOMAIN>/api/ssh/keys
  • Headers:
    • 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 Keys anzeigen​

Um eine Liste aller öffentlichen Schlüssel anzuzeigen, die derzeit für den Zugriff auf die Workspaces autorisiert sind, sende eine GET-Anfrage:

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

SSH-Key entfernen​

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

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, findest du den Connection-String des Workspace direkt in der Plattform.

  1. Öffne den aktiven Workspace.
  2. Klicke auf das Editor-Dropdown in der Toolbar oben rechts.
  3. Wähle Connect via SSH.
  4. Kopiere den Connection-String aus dem Modal und füge ihn in dein lokales Terminal ein.

Kopieren des Connection-Strings aus dem Workspace.

Beispielbefehl:​

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

Die Data-Center-ID findet sich in den Resource-Group-Einstellungen (nur für Administratoren).

Verbindung von einer lokalen IDE aus​

Informationen zur Einrichtung von SSH Remote Development finden sich in der offiziellen Dokumentation der jeweiligen IDE: