Accesso automatico

Shayan TaslimAggiornato

L'accesso automatico consente a UserJot di trasferire la sessione di un utente autenticato dal tuo prodotto alla tua bacheca pubblica per i feedback, alla roadmap, al changelog, al Centro assistenza e agli embed inline, senza chiedere di accedere di nuovo.

Il widget può identificare gli utenti autonomamente; l'accesso automatico è l'impostazione dell'area di lavoro che consente a questa identità di autenticare gli utenti nelle tue pagine pubbliche, negli embed inline e nello Swift SDK.

Attivare l’accesso automatico

  1. Apri Impostazioni → Accesso.

  2. In Authentication, attiva Automatic login.

  3. Per le sessioni verificate dal server, attiva anche Richiedi token firmati (l'opzione appare dopo aver attivato l'accesso automatico).

L'accesso automatico richiede il piano Starter o Professional. Nel piano Free, l'interruttore è visibile ma bloccato.

A cosa serve l'opzione Richiedi token firmati

Una semplice chiamata uj.identify viene eseguita nel browser e può essere modificata da un visitatore. Con Richiedi token firmati attivato, UserJot rifiuta le chiamate identify non firmate, richiede che le appartenenze alle aziende siano incluse nel token firmato (ignorando gli companies non firmati lato client e mostrando un avviso UNSIGNED_COMPANY_IGNORED), e accetta solo identità firmate sul tuo server con un JWT HS256 (o una firma HMAC-SHA256 nell'SDK Swift). Consulta Identità firmata per esempi lato server.

Come funziona

  1. Attiva Accesso automatico in Impostazioni → Accesso.

  2. Installa il widget nel tuo prodotto.

  3. Chiama uj.identify(...) una volta caricata la sessione utente (passando un token firmato, se necessario). Passare un email collega a un account UserJot esistente solo se l'indirizzo email di quell'account è stato confermato.

  4. Crea un link dalla tua app all'URL pubblico di UserJot (l'indirizzo userjot.com o il tuo dominio personalizzato).

HTML
<a href="https://feedback.example.com/">Give feedback</a>
<a href="https://feedback.example.com/roadmap">Roadmap</a>
<a href="https://feedback.example.com/updates">Updates</a>

L'SDK allega automaticamente la sessione quando gli utenti seguono link al dominio del tuo progetto; non devi aggiungere token agli URL. Gli embed inline usano automaticamente lo stesso meccanismo di scambio una volta eseguito uj.identify.

JavaScript
if (user) {
  uj.identify({ token: user.userJotToken });
} else {
  uj.logout();
}

Limitazioni

  • Non vale per gli amministratori o i proprietari dello spazio di lavoro nelle bacheche pubbliche. L'accesso automatico non consente agli amministratori o ai proprietari dello spazio di lavoro di accedere alle bacheche pubbliche (prova sempre l'accesso automatico alle bacheche con un account cliente standard; i membri del team accedono alle bacheche pubbliche direttamente con il proprio account UserJot oppure tramite reindirizzamento SSO). Nel widget integrato nell'app, un token uj.identify firmato funziona anche per amministratori e proprietari, sincronizzando traits e companies e mantenendo invariati nome, avatar ed email gestiti dalla dashboard.

  • È separato dall'accesso singolo. L'accesso automatico trasferisce le sessioni del widget alle pagine pubbliche dall'interno della tua app; l'accesso singolo sostituisce il pulsante Accedi della bacheca con un reindirizzamento alla tua pagina di accesso.

  • In modalità rigorosa, in caso di errore l'accesso viene negato. Quando Richiedi token firmati è attivo, se il token manca o non è valido, la chiamata uj.identify viene rifiutata con IDENTIFY_FAILED e il visitatore rimane non autenticato.

Risoluzione dei problemi

L’utente continua a visualizzare una richiesta di accesso

  • Verifica che Accesso automatico sia attivato in Impostazioni → Accesso.

  • Verifica che l'SDK del widget sia caricato nella pagina che contiene il link e che uj.identify sia stato eseguito prima di fare clic sul link.

  • Verifica che il link punti esattamente al tuo sottodominio userjot.com o al tuo dominio personalizzato.

  • Verifica di non stare testando l'accesso automatico alle bacheche pubbliche usando l'indirizzo email di un amministratore o del proprietario dello spazio di lavoro.

I token firmati sono obbligatori, ma l'accesso continua a non funzionare

  • Verifica che uj.identify riceva un token firmato con HS256 e con il tuo Segreto del progetto corrente.

  • Verifica che iss corrisponda al tuo ID progetto, che aud sia userjot e che sia iat sia exp siano espressi in secondi Unix con exp - iat <= 3600 (durata massima di 1 ora).

  • Esamina la promise restituita da uj.identify per IDENTIFY_FAILED.

Passaggi successivi

Ha risposto alla tua domanda?