# JB2 - Entrare

# JB2.1 - La pagina di accesso

**In una frase.** Come si entra ogni giorno: una pagina, utente e password, e sei dentro a tutto.

Entri una volta e non ti viene più chiesto chi sei mentre passi dall'ERP alle stampe o alle analisi. La pagina è la stessa per tutti e porta il nome della tua azienda.

1. **Apri l'applicazione.** Se non sei ancora entrato, compare la pagina di accesso con il logo SIGEAnext e, sotto, il nome dell'azienda.
    
    ![La pagina di accesso: utente, password e il pulsante Entra. Sotto il logo c'è il nome dell'azienda, qui coperto](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/la-pagina-di-accesso-utente-password-e-il-pulsante-entra-sotto-il-logo-ce-il-nome-dellazienda-qui-coperto.png)
    
    *La pagina di accesso: utente, password e il pulsante Entra. Sotto il logo c'è il nome dell'azienda, qui coperto*
2. **Scrivi utente e password e premi Entra.** L'utente è quello del gestionale. La password è quella che hai scelto al primo accesso.
3. **Lavora.** Le pagine nuove si aprono subito. Il tuo livello decide cosa vedi e cosa puoi cambiare.
4. **Se apri le pagine storiche**, l'ERP legacy/COBOL chiede la sua password. L'utente è già scritto e non si può cambiare: è quello con cui sei entrato. La password è la stessa.
    
    ![L'accesso alle pagine storiche: l'utente è fisso su quello con cui sei entrato, scrivi solo la password. Utente e nome del server coperti](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/laccesso-alle-pagine-storiche-lutente-e-fisso-su-quello-con-cui-sei-entrato-scrivi-solo-la-password-utente-e-nome-del-server-co)
    
    *L'accesso alle pagine storiche: l'utente è fisso su quello con cui sei entrato, scrivi solo la password. Utente e nome del server coperti*

Se è la prima volta che entri, usa il collegamento **Primo accesso? Imposta qui la password**. Se la password non la ricordi, **Password dimenticata?**.

<p class="callout info">**Nota.** Esiste un'opzione che toglie la seconda richiesta di password nelle pagine storiche: il sistema custodisce, cifrata, la password del gestionale e la scrive al posto tuo. Oggi è provvisoria e spenta: la accende chi amministra.</p>

<p class="callout warning">**Attenzione.** Una password più lunga di 12 caratteri non si può usare: il limite è dell'ERP legacy/COBOL e vale ovunque.</p>

<p class="callout info">**Per chi sviluppa.**  
• La pagina è quella di Keycloak con il tema `sigea`, in `devops/keycloak/themes/sigea`.  
• Il doppio passaggio nelle pagine storiche vale con `SBH_SSO_MODE=on`; l'accesso automatico è `SBH_SSO_AUTOLOGIN=true`. </p>

<p class="callout info">**Per approfondire.**  
• Login unico con Keycloak: `docs/guide/amministrazione/login-unico-keycloak/README.md`</p>

# JB2.2 - Primo accesso e password

**In una frase.** La prima volta scegli tu la password, dimostrando chi sei con quella che usi oggi nel gestionale.

Nessuno ti consegna una password su un foglietto. L'installazione copia gli utenti senza password: la tua la scegli tu, e da quel momento vale sia per l'Accesso sia per l'ERP legacy/COBOL.

1. **Apri il primo accesso.** Nella pagina di accesso premi **Primo accesso? Imposta qui la password**.
2. **Compila il modulo.** Utente del gestionale, password che usi oggi sul gestionale, la tua email, poi la password nuova due volte. Le regole si spuntano mentre scrivi.
    
    ![Il modulo del primo accesso: le regole della password diventano verdi una alla volta. Utente ed email coperti](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/il-modulo-del-primo-accesso-le-regole-della-password-diventano-verdi-una-alla-volta-utente-ed-email-coperti.png)
    
    *Il modulo del primo accesso: le regole della password diventano verdi una alla volta. Utente ed email coperti*
3. **Premi Conferma.** Il pulsante si accende solo quando tutte le regole sono rispettate. Il sistema controlla la password attuale, poi salva quella nuova nei due posti.
4. **Entra.** Compare **Primo accesso completato**: premi **Vai al login** ed entra con la password nuova.
    
    ![Primo accesso completato: il pulsante Vai al login](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/primo-accesso-completato-il-pulsante-vai-al-login.png)
    
    *Primo accesso completato: il pulsante Vai al login*

Le regole di partenza: da 10 a 12 caratteri, almeno una maiuscola, una minuscola, una cifra e un simbolo, diversa dal nome utente e dalle ultime cinque usate. Chi amministra può cambiarle.

Se qualcosa non torna, il modulo lo dice nel punto giusto: sotto la password nuova se non rispetta le regole, in cima se utente o password attuale sono sbagliati. Dopo cinque tentativi in un minuto ti chiede di aspettare.

<p class="callout info">**Nota.** L'email serve per «Password dimenticata?»: è lì che arriva il collegamento per sceglierne una nuova, valido 15 minuti e una volta sola.</p>

<p class="callout info">**Per chi sviluppa.**  
• La password nuova va prima a Keycloak e poi al gestionale. Se il gestionale la rifiuta, Keycloak torna com'era.  
• Le regole si decidono nel realm (Authentication, Policies), non nel codice. Il massimo di 12 caratteri resta comunque.  
• Disegno: `docs/sicurezza/DISEGNO-PASSWORD-UNICA.md`. </p>

<p class="callout info">**Per approfondire.**  
• Login unico con Keycloak: `docs/guide/amministrazione/login-unico-keycloak/README.md`  
• Utenti e password: `docs/guide/amministrazione/utenti-e-password/README.md`</p>

# JB2.3 - Utenti e password

**In una frase.** La pagina dove chi amministra vede lo stato della password di ogni utente e interviene senza mai leggerla.

Le password da tenere uguali sono due: quella dell'Accesso e quella dell'ERP legacy/COBOL. Questa pagina le cambia sempre insieme. Se una delle due non riesce, anche l'altra torna com'era: nessuno resta a metà.

**Dove si trova.** Modulo **EE0 Gestione Servizi**, **Impostazioni**, **Utenti e accessi**, **Utenti e password**. Serve il livello Utente avanzato: gli altri leggono «Non hai i permessi per questa funzione.».

![Il menu del modulo Gestione servizi: Impostazioni, Utenti e accessi, con le tre voci Utenti e password, Ruoli e permessi, Assesta l'installazione](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/b-accesso-e-permessi-img-utenti-e-password-01-menu.png)

*Il menu del modulo Gestione servizi: Impostazioni, Utenti e accessi, con le tre voci Utenti e password, Ruoli e permessi, Assesta l'installazione*

**Cosa vedi.** L'elenco degli utenti, con la ricerca. Per ognuno, lo stato della password:

<table id="bkmrk-stato-cosa-vuol-dire"><thead><tr><th>Stato</th><th>Cosa vuol dire</th></tr></thead><tbody><tr><td>**Allineata**</td><td>Tutto a posto</td></tr><tr><td>**Mai entrato**</td><td>Deve ancora fare il primo accesso</td></tr><tr><td>**Da cambiare**</td><td>La cambierà lui al prossimo ingresso</td></tr><tr><td>**Senza deposito**</td><td>Il sistema non può cambiargli la password da solo</td></tr><tr><td>**Non allineata**</td><td>La password è stata cambiata fuori da qui</td></tr><tr><td>**Bloccato**</td><td>Disabilitato, o fermo per troppi errori</td></tr></tbody></table>

**Cosa puoi fare.** Ogni azione chiede conferma e resta scritta nel registro, senza la password.

- **Imposta una password provvisoria.** La genera il sistema e te la mostra una volta sola. L'utente la cambia al primo ingresso.
- **Manda il collegamento di ripristino.** L'utente riceve un'email e sceglie da solo la password nuova.
- **Forza il cambio al prossimo accesso.**
- **Blocca** e **Sblocca.**
- **Rimetti al primo accesso.** Per gli utenti «Senza deposito»: prima si reimposta la password nel gestionale, poi si preme qui.

<p class="callout info">**Nota.** Questa pagina non è ancora stata provata dal vivo e non ha schermate. Funziona solo con l'Accesso acceso.</p>

<p class="callout info">**Per chi sviluppa.**  
• Pagina: `frontend/shell/src/pages/utenti-password`, indirizzo `/pages/utenti-password`.  
• «Deposito» è la password del gestionale custodita cifrata dal Ponte col COBOL: esiste solo con `SBH_SSO_AUTOLOGIN=true` e dopo un ingresso dell'utente dalle pagine storiche.  
• Per le email servono il server di posta delle impostazioni dei flussi e `SBH_PUBLIC_URL`. </p>

<p class="callout info">**Per approfondire.**  
• Utenti e password: `docs/guide/amministrazione/utenti-e-password/README.md`</p>

# JB2.4 - Utente bloccato

**In una frase.** Cosa fare quando un utente non riesce più a entrare: capire perché e scegliere il rimedio giusto.

Un utente fermo è lavoro fermo. Le cause sono poche e ognuna ha un rimedio di un minuto, quasi sempre senza toccare il gestionale.

1. **Ha sbagliato la password troppe volte.** Dopo cinque errori l'Accesso lo ferma per 15 minuti. Può aspettare, oppure chi amministra apre **Utenti e password** e preme **Sblocca**.
2. **Non ricorda la password.** Dalla pagina di accesso preme **Password dimenticata?**, scrive utente o email e riceve un collegamento. Vale 15 minuti e una volta sola. La risposta della pagina è sempre la stessa, anche se l'utente non esiste: così un estraneo non scopre chi c'è.
3. **Non ha un'email, o la posta non arriva.** Chi amministra preme **Imposta una password provvisoria**, la copia e gliela comunica. L'utente la cambia al primo ingresso.
4. **È stato disabilitato.** Nell'elenco lo stato è **Bloccato**. **Sblocca** gli ridà l'ingresso. Il gestionale non cambia.
5. **Lo stato è «Senza deposito».** Il sistema non conosce la sua password del gestionale e non può cambiarla da solo. Due passi, in quest'ordine: reimposta la password dalla gestione utenti del gestionale e comunicala; poi premi **Rimetti al primo accesso**. L'utente rifà il primo accesso e ne sceglie una nuova.

<p class="callout warning">**Attenzione.** Non invertire i due passi del punto 5: l'utente si troverebbe a fare il primo accesso senza conoscere la password da scrivere.</p>

<p class="callout info">**Nota.** Un utente creato da poco nel gestionale non esiste ancora nell'Accesso: compare dopo un nuovo allineamento, che fa chi amministra.</p>

<p class="callout info">**Per chi sviluppa.**  
• Il blocco dopo cinque errori è una regola del realm, scritta dalla prima installazione.  
• Le azioni passano da SIGEAnext al Ponte col COBOL e finiscono nei loro registri con il marcatore `[UTENTI-PASSWORD]`.  
• Le pagine «Primo accesso» e «Password dimenticata» sono in `frontend/sbh-web/src/session/pages`. </p>

<p class="callout info">**Per approfondire.**  
• Utenti e password: `docs/guide/amministrazione/utenti-e-password/README.md`</p>