Accesso automatico
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
Apri Impostazioni → Accesso.
In Authentication, attiva Automatic login.
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
Attiva Accesso automatico in Impostazioni → Accesso.
Installa il widget nel tuo prodotto.
Chiama
uj.identify(...)una volta caricata la sessione utente (passando untokenfirmato, se necessario). Passare unemailcollega a un account UserJot esistente solo se l'indirizzo email di quell'account è stato confermato.Crea un link dalla tua app all'URL pubblico di UserJot (l'indirizzo
userjot.como il tuo dominio personalizzato).
<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.
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.identifyfirmato funziona anche per amministratori e proprietari, sincronizzandotraitsecompaniese 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.identifyviene rifiutata conIDENTIFY_FAILEDe 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.identifysia stato eseguito prima di fare clic sul link.Verifica che il link punti esattamente al tuo sottodominio
userjot.como 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.identifyriceva untokenfirmato con HS256 e con il tuo Segreto del progetto corrente.Verifica che
isscorrisponda al tuo ID progetto, cheaudsiauserjote che siaiatsiaexpsiano espressi in secondi Unix conexp - iat <= 3600(durata massima di 1 ora).Esamina la promise restituita da
uj.identifyperIDENTIFY_FAILED.
Passaggi successivi
Genera JWT lato server in Identità firmata.
Confronta tutte le opzioni di autenticazione in Identificare gli utenti.