# Client-Desktop verbinden

Canonical: https://synthcrew.io/de/docs/device-login

Der Client-Zugang bleibt bis zum Abschluss der Qualifizierung gesperrt. Wenn er aktiviert ist:

1. Öffnen Sie die Kontosteuerung des Clients und wählen Sie **Create sign-in code**. Lassen Sie den Dialog offen; er zeigt den Code und wartet auf Bestätigung.
2. Wählen Sie **Copy sign-in address**, öffnen Sie die Adresse im eigenen Browser und melden Sie sich mit Google oder GitHub bei Ihrem Teamkonto an. Wählen Sie einen Arbeitsbereich.
3. Geben Sie **genau** den vom Client angezeigten Code ein und bestätigen Sie ihn. Bestätigen Sie nie einen unaufgeforderten Code. Bei Erfolg meldet der Client **Customer workspace connected** und schließt den Dialog; berechtigte Modelle können bei verfügbarem Dienst geladen werden.
4. Zum späteren Trennen verwendet ein Arbeitsbereichsadministrator **Revoke** neben dem Desktop unter **Connected desktops**. Ein widerrufener Client muss erneut verbunden werden.

## Wenn die Verbindung fehlschlägt [#wenn-die-verbindung-fehlschlägt]

- **Code abgelaufen:** Kehren Sie zum Client zurück und wählen Sie bei Bereitschaft erneut **Create sign-in code**. Bestätigen Sie nur den neu angezeigten Code. Bei verlangsamter Abfrage lassen Sie den Dialog bis zur Bestätigung oder zum Ablauf offen.
- **Sicherer Speicher fehlgeschlagen:** Installieren Sie unter Linux `secret-tool` und aktivieren oder entsperren Sie den Secret Service des Desktops; erstellen und bestätigen Sie dann einen neuen Code. Prüfen Sie unter Windows das DPAPI-Profil des angemeldeten Benutzers. Der Client meldet den Fehler, statt Zugangsdaten ersatzweise im Klartext zu speichern.
- **Kein Modell erscheint:** Prüfen Sie Desktop-Verbindung, Verfügbarkeit von Arbeitsbereich und Dienst sowie den geladenen Modellkatalog. Verbinden Sie nach Behebung des gemeldeten Konto- oder Netzwerkfehlers erneut oder aktualisieren Sie Modelle ausdrücklich. Die öffentliche Freigabe kann weiterhin geschlossen sein; umgehen Sie sie nicht.

Der Client speichert seine Kundenzugangsdaten unter Windows mit DPAPI und unter Linux mit Secret Service.

## Erwartetes Ergebnis und sichere Wiederherstellung [#erwartetes-ergebnis-und-sichere-wiederherstellung]

Der Desktop meldet **Customer workspace connected**, nachdem der Code bestätigt und sicher gespeichert wurde. Ein Code gehört zu einem Verbindungsversuch; bestätigen Sie keinen nicht angeforderten Code. Bei fehlgeschlagener Bestätigung oder geschlossenem Dienst darf keine erfolgreiche Verbindung angenommen werden. Prüfen Sie den ausgewählten Arbeitsbereich und seine Dienstverfügbarkeit, bevor Sie einen neuen Code erstellen. Der Widerruf beendet künftige authentifizierte Nutzung dieses Desktops; lokale Projektdateien werden nicht gelöscht.