Associer le client de bureau à votre compte
Vue d'ensemble
Pour que le client Whisperer macOS fonctionne avec vos sessions, votre abonnement et votre base de connaissances, vous devez l'associer une seule fois à votre compte. L'installation de l'application seule ne suffit pas à accorder l'accès — l'appareil doit être autorisé (authentification de l'appareil).
L'association repose sur un flux sécurisé à code à usage unique : l'application initie la connexion, vous vous authentifiez dans le navigateur, recevez un code à usage unique, et le navigateur vous renvoie vers l'application. Le code est à usage unique et reste valide pendant 30 minutes.
Quand l'utiliser
- Juste après avoir installé le client et suivi l'assistant de permissions.
- Lors d'une connexion sur un ordinateur neuf ou réinstallé.
- Lorsque l'application ne détecte plus votre compte (vous vous êtes déconnecté de tous les appareils, vous avez changé votre mot de passe, etc.) et qu'il faut l'associer à nouveau.
Étape par étape
- Initier la connexion dans l'application. Ouvrez Whisperer sur votre Mac et lancez la connexion/l'association. L'application demande un code à usage unique au serveur (
POST /v1/auth/desktop/code) et ouvre la page web d'association dans votre navigateur —/app/connect. - Connectez-vous à votre compte dans le navigateur. Sur la page
/app/connect, connectez-vous avec votre adresse e-mail et votre mot de passe. Si vous n'avez pas encore de compte — inscrivez-vous et confirmez votre adresse e-mail (voir Inscription et connexion). La connexion est impossible tant que votre adresse e-mail n'est pas confirmée. - Confirmer l'association de l'appareil. Après la connexion, le tableau de bord web associe le code à usage unique à votre compte.
- Retourner dans l'application. Le navigateur vous redirige automatiquement vers Whisperer via le schéma
whisperer://auth?code=...&state=.... Si une invite système « Ouvrir dans Whisperer ? » apparaît — confirmez-la. - Attendre l'échange code-vers-jetons. L'application échange le code à usage unique contre des jetons d'accès et les stocke dans un espace de stockage sécurisé (chiffré). Après cela, le client est associé à votre compte.
- Vérifier. Assurez-vous que l'application affiche votre compte et votre forfait. Vous pouvez désormais démarrer des sessions.
Captures d'écran
📸 [Capture d'écran : écran d'initiation de connexion dans le client macOS]
📸 [Capture d'écran : page web
/app/connectavec le formulaire de connexion]
📸 [Capture d'écran : invite système macOS « Ouvrir dans Whisperer ? » (le schéma whisperer://)]
Erreurs courantes
- Code expiré. Le code à usage unique reste valide pendant 30 minutes. Si vous avez mis trop de temps ou avez été interrompu, l'association ne pourra pas être finalisée. Solution : revenez dans l'application et relancez la connexion — un nouveau code sera émis.
- Le navigateur n'est pas revenu dans l'application. Si la redirection via le schéma
whisperer://ne s'est pas déclenchée automatiquement, assurez-vous que Whisperer est installé dans le dossier « Applications » et recommencez la connexion. Lorsqu'une invite système pour ouvrir l'application apparaît — confirmez-la. - La connexion échoue — adresse e-mail non confirmée. Vous ne pouvez pas vous connecter tant que votre adresse e-mail n'est pas confirmée avec le code à 6 chiffres. Confirmez votre adresse e-mail et réessayez.
- Plusieurs onglets
/app/connect. Ouvrir plusieurs pages d'association simultanément perturbe le flux. Fermez les onglets superflus et relancez l'association depuis l'application. - Compte gelé ou banni. Si le statut du compte est
frozen/banned, l'association ne pourra pas être finalisée — contactez le support.
Bonnes pratiques
- Effectuez l'association juste après l'installation, sans attendre — vous resterez ainsi confortablement dans la limite de 30 minutes du code.
- Gardez la page
/app/connectouverte dans un seul onglet. - Si vous avez changé votre mot de passe ou vous êtes déconnecté de tous les appareils, associez à nouveau le client — les anciens jetons sont invalidés (token_version).
- Ne transmettez pas le code à usage unique manuellement et ne partagez pas le lien
whisperer://auth?...— il est confidentiel et réservé à votre appareil.