# JB4.3 - Se qualcosa non va

**In una frase.** I problemi più comuni con l'accesso e i permessi, cosa vuol dire ciascuno e cosa fare.

<table id="bkmrk-vedo-questo-faccio-q"><thead><tr><th>Vedo questo</th><th>Faccio questo</th></tr></thead><tbody><tr><td>«Utente o password attuale non corretti» al primo accesso</td><td>Scrivi l'utente e la password che usi oggi nel gestionale, non quella nuova</td></tr><tr><td>**Conferma** resta spento</td><td>Una regola della password non è rispettata: guarda quali non sono verdi</td></tr><tr><td>«Troppi tentativi: riprova fra un minuto»</td><td>Aspetta un minuto e riprova con calma</td></tr><tr><td>Non entro più dopo vari errori</td><td>Dopo cinque errori sei fermo 15 minuti. Aspetta, o chiedi **Sblocca** a chi amministra</td></tr><tr><td>Non ricordo la password</td><td>**Password dimenticata?** nella pagina di accesso. Il collegamento vale 15 minuti</td></tr><tr><td>L'email non arriva</td><td>Guarda nella posta indesiderata. Se manca, chiedi una password provvisoria</td></tr><tr><td>«rivolgiti all'amministratore» dopo Password dimenticata</td><td>Il sistema non può cambiarti la password da solo: la reimposta chi amministra</td></tr><tr><td>La password ha più di 12 caratteri</td><td>Non si può usare: sceglila da 10 a 12</td></tr><tr><td>Le pagine storiche chiedono ancora la password</td><td>È previsto: l'utente è già scritto, scrivi la stessa password</td></tr><tr><td>«Il login unico non è raggiungibile»</td><td>L'Accesso è spento. Avvisa chi amministra; se compare, usa **Continua col login del gestionale**</td></tr><tr><td>«Non hai i permessi»</td><td>Ti serve un livello più alto. Chiedi a chi gestisce i ruoli</td></tr><tr><td>Un pulsante è spento</td><td>Fermati sopra con il mouse: il suggerimento dice quale livello serve</td></tr><tr><td>Una scheda di Ruoli e permessi è **spento**</td><td>Quel servizio non risponde. Leggi il motivo e premi **Riprova**</td></tr><tr><td>Ho dato un ruolo ma non cambia niente</td><td>Controlla la scheda: il ruolo vale solo nel servizio dove lo hai agganciato</td></tr><tr><td>Un utente nuovo non riesce a entrare</td><td>Non è ancora stato copiato dal gestionale: serve un riallineamento</td></tr><tr><td>Si apre «Prima installazione del login unico»</td><td>L'accesso è acceso ma l'installazione non è fatta: la completa chi amministra</td></tr></tbody></table>

## Parole da sapere

- **Accesso.** Il componente che controlla utente e password. Uno solo per tutta ADSWnext.
- **Lasciapassare.** La prova che sei entrato. Viaggia con ogni richiesta e contiene i tuoi ruoli.
- **Ruolo.** Un gruppo a cui appartieni nel gestionale, per esempio «amministrazione».
- **Livello.** Uno dei quattro gradi: Lettore, Utente base, Utente avanzato, Staff.
- **Capacità.** Una cosa che un servizio permette di fare, legata a un livello minimo.
- **Primo accesso.** Il modulo dove scegli la tua password, una volta sola.
- **Password provvisoria.** Una password generata dal sistema, da cambiare al primo ingresso.
- **Deposito.** La password del gestionale custodita cifrata, che permette di cambiare le due password insieme.
- **Ruolo di prova.** Il selettore degli ambienti di prova per vedere l'applicazione con un altro ruolo.
- **Staff.** Il livello del personale Genesys. Conta solo dove è acceso.

<p class="callout info">**Per chi sviluppa.**  
• Lasciapassare = token JWT; Accesso = Keycloak; lo spazio di un'installazione = realm.  
• Le azioni su utenti e password si trovano nei registri con il marcatore `[UTENTI-PASSWORD]`.  
• Se l'Accesso non risponde nelle pagine storiche: `SBH_SSO_FALLBACK` decide se si può entrare lo stesso.  
• Disegno completo: `docs/devops/auth/SSO-DISEGNO-TECNICO.md` e `docs/devops/auth/AUTENTICAZIONE.md`. </p>