Den Desktop-Client mit Ihrem Konto verbinden

Überblick

Damit der Whisperer macOS-Client mit Ihren Sitzungen, Ihrem Abonnement und Ihrer Wissensdatenbank funktioniert, müssen Sie ihn einmalig mit Ihrem Konto verbinden. Die bloße Installation der App gewährt noch keinen Zugriff — das Gerät muss autorisiert werden (Device Auth).

Die Kopplung basiert auf einem sicheren Einmalcode-Verfahren: Die App leitet die Anmeldung ein, Sie authentifizieren sich im Browser, erhalten einen Einmalcode, und der Browser leitet Sie zurück zur App. Der Code ist einmalig gültig und lebt 30 Minuten.

Wann verwenden

Direkt nach der Installation des Clients und dem Durchlaufen des Berechtigungsassistenten.
Beim Anmelden auf einem neuen oder neu installierten Computer.
Wenn die App Ihr Konto nicht mehr erkennt (Sie haben sich auf allen Geräten abgemeldet, Ihr Passwort geändert usw.) und sie erneut gekoppelt werden muss.

Schritt für Schritt

Anmeldung in der App einleiten. Öffnen Sie Whisperer auf Ihrem Mac und starten Sie die Anmeldung/Kopplung. Die App fordert einen Einmalcode vom Server an (POST /v1/auth/desktop/code) und öffnet die Kopplungs-Webseite in Ihrem Browser — /app/connect.
Im Browser bei Ihrem Konto anmelden. Melden Sie sich auf der Seite /app/connect mit Ihrer E-Mail-Adresse und Ihrem Passwort an. Wenn Sie noch kein Konto haben — registrieren Sie sich und bestätigen Sie Ihre E-Mail-Adresse (siehe Registrierung und Anmeldung). Eine Anmeldung ist erst möglich, nachdem Ihre E-Mail-Adresse bestätigt wurde.
Die Gerätekopplung bestätigen. Nach der Anmeldung verknüpft das Web-Dashboard den Einmalcode mit Ihrem Konto.
Zurück zur App. Der Browser leitet Sie automatisch über das Schema whisperer://auth?code=...&state=... zurück zu Whisperer. Wenn eine Systemabfrage „In Whisperer öffnen?" erscheint — bestätigen Sie sie.
Auf den Code-zu-Token-Austausch warten. Die App tauscht den Einmalcode gegen Zugriffstoken ein und speichert sie im sicheren Speicher (verschlüsselt). Danach ist der Client mit Ihrem Konto gekoppelt.
Überprüfen. Vergewissern Sie sich, dass die App Ihr Konto und Ihren Tarif anzeigt. Sie können nun Sitzungen starten.

Screenshots

📸 [Screenshot: Bildschirm zur Einleitung der Anmeldung im macOS-Client]

📸 [Screenshot: /app/connect Webseite mit dem Anmeldeformular]

📸 [Screenshot: macOS-Systemabfrage „In Whisperer öffnen?" (das whisperer://-Schema)]

Häufige Fehler

Code abgelaufen. Der Einmalcode lebt 30 Minuten. Wenn Sie länger gebraucht haben oder unterbrochen wurden, wird die Kopplung nicht abgeschlossen. Lösung: Kehren Sie zur App zurück und leiten Sie die Anmeldung erneut ein — es wird ein neuer Code ausgestellt.
Browser ist nicht zur App zurückgekehrt. Wenn die Weiterleitung über das whisperer://-Schema nicht automatisch ausgelöst wurde, stellen Sie sicher, dass Whisperer im Ordner „Programme" installiert ist, und wiederholen Sie die Anmeldung. Wenn eine Systemabfrage zum Öffnen der App erscheint — bestätigen Sie sie.
Anmeldung schlägt fehl — E-Mail nicht bestätigt. Sie können sich erst anmelden, nachdem Ihre E-Mail-Adresse mit dem 6-stelligen Code bestätigt wurde. Bestätigen Sie Ihre E-Mail-Adresse und versuchen Sie es erneut.
Mehrere /app/connect-Tabs. Das gleichzeitige Öffnen mehrerer Kopplungsseiten unterbricht den Ablauf. Schließen Sie die überflüssigen und starten Sie die Kopplung erneut aus der App.
Konto eingefroren oder gesperrt. Wenn der Kontostatus frozen/banned ist, wird die Kopplung nicht abgeschlossen — wenden Sie sich an den Support.

Bewährte Vorgehensweisen

Führen Sie die Kopplung direkt nach der Installation durch, ohne Verzögerung — so bleiben Sie bequem innerhalb der 30-minütigen TTL des Codes.
Halten Sie die Seite /app/connect nur in einem einzigen Tab geöffnet.
Wenn Sie Ihr Passwort geändert oder sich auf allen Geräten abgemeldet haben, koppeln Sie den Client erneut — die alten Token werden ungültig (token_version).
Geben Sie den Einmalcode nicht manuell weiter und teilen Sie den Link whisperer://auth?... nicht — er ist ein Geheimnis für Ihr Gerät.