Abbinare il client desktop al tuo account

Panoramica

Affinché il client Whisperer per macOS funzioni con le tue sessioni, l'abbonamento e la base di conoscenza, devi abbinarlo al tuo account una volta. Installare l'app da sola non concede l'accesso — il dispositivo deve essere autorizzato (device auth).

L'abbinamento si basa su un flusso sicuro con codice monouso: l'app avvia l'accesso, tu ti autentichi nel browser, ricevi un codice monouso e il browser ti riporta all'app. Il codice è monouso e ha una durata di 30 minuti.

Quando usarlo

  • Subito dopo aver installato il client e completato la procedura guidata dei permessi.
  • Quando accedi su un computer nuovo o reinstallato.
  • Quando l'app smette di vedere il tuo account (hai disconnesso tutti i dispositivi, cambiato la password, ecc.) e occorre abbinarla di nuovo.

Passo dopo passo

  1. Avvia l'accesso nell'app. Apri Whisperer sul tuo Mac e avvia l'accesso/abbinamento. L'app richiede un codice monouso al server (POST /v1/auth/desktop/code) e apre la pagina web di abbinamento nel tuo browser — /app/connect.
  2. Accedi al tuo account nel browser. Nella pagina /app/connect, accedi con la tua e-mail e password. Se non hai ancora un account — registrati e conferma la tua e-mail (vedi Registrazione e accesso). L'accesso non è possibile finché la tua e-mail non è confermata.
  3. Conferma l'abbinamento del dispositivo. Dopo l'accesso, il dashboard web collega il codice monouso al tuo account.
  4. Torna all'app. Il browser ti reindirizza automaticamente a Whisperer tramite lo schema whisperer://auth?code=...&state=.... Se compare un avviso di sistema "Aprire in Whisperer?" — confermalo.
  5. Attendi lo scambio codice-token. L'app scambia il codice monouso con i token di accesso e li memorizza in un archivio sicuro (crittografato). Dopodiché, il client è abbinato al tuo account.
  6. Verifica. Assicurati che l'app mostri il tuo account e il tuo piano. Ora puoi avviare le sessioni.

Screenshot

📸 [Screenshot: schermata di avvio dell'accesso nel client macOS]

📸 [Screenshot: pagina web /app/connect con il modulo di accesso]

📸 [Screenshot: avviso di sistema macOS "Aprire in Whisperer?" (lo schema whisperer://)]

Errori comuni

  • Codice scaduto. Il codice monouso ha una durata di 30 minuti. Se hai impiegato più tempo o sei stato interrotto, l'abbinamento non si completa. Soluzione: torna all'app e avvia di nuovo l'accesso — verrà emesso un nuovo codice.
  • Il browser non è tornato all'app. Se il reindirizzamento dello schema whisperer:// non si è attivato automaticamente, assicurati che Whisperer sia installato nella cartella "Applicazioni" e ripeti l'accesso. Quando compare un avviso di sistema per aprire l'app — confermalo.
  • L'accesso non riesce — e-mail non confermata. Non puoi accedere finché la tua e-mail non è confermata con il codice a 6 cifre. Conferma la tua e-mail e riprova.
  • Più schede /app/connect. Aprire più pagine di abbinamento contemporaneamente interrompe il flusso. Chiudi quelle in eccesso ed esegui di nuovo l'abbinamento dall'app.
  • Account congelato o bannato. Se lo stato dell'account è frozen/banned, l'abbinamento non si completa — contatta l'assistenza.

Buone pratiche

  • Esegui l'abbinamento subito dopo l'installazione, senza indugio — così rientrerai comodamente nel TTL di 30 minuti del codice.
  • Tieni la pagina /app/connect aperta in una sola scheda.
  • Se hai cambiato la password o disconnesso tutti i dispositivi, abbina di nuovo il client — i vecchi token sono invalidati (token_version).
  • Non passare il codice monouso manualmente e non condividere il link whisperer://auth?... — è un segreto destinato al tuo dispositivo.

Articoli correlati