JB4.1 - Attivare il login unico
In una frase. L'accesso unico si accende una volta per installazione, con una procedura guidata che copia utenti e ruoli dal gestionale.
Non devi creare gli utenti a mano né configurare l'Accesso voce per voce. La procedura fa tutto in sei passi, legge soltanto dal gestionale e si può rilanciare senza creare doppioni.
Prepara l'installazione. Chi installa scrive nel file d'ambiente che l'accesso è acceso, il codice dell'installazione e l'indirizzo dell'Accesso. Poi riavvia i servizi.
Apri l'applicazione. Finché l'installazione non è fatta, qualunque indirizzo apre Prima installazione del login unico. Nessuno entra, ma tutti vedono perché.
Sblocca. La procedura chiede un codice usa e getta, valido 60 minuti. Lo trova solo chi ha accesso al server: così un visitatore qualunque non può fare l'installazione al posto tuo.
Passo 1 della procedura: il codice di sblocco, da leggere sul server
Conferma i dati e scegli cosa attivare. Il nome dell'azienda, gli utenti che saranno amministratori, e quali applicazioni usano l'accesso unico, per esempio l'ERP e le pagine storiche.
Passo 3: quali applicazioni entrano con l'accesso unico
Collega l'Accesso e avvia. Servono utente e password di un amministratore dell'Accesso: non vengono salvati. Verifica mostra quanti utenti e ruoli arriveranno. Avvia li importa.
Passo 5: l'importazione, con quante cose sono state create o aggiornate. Indirizzi coperti
Vai al login. Da qui ogni utente fa il suo primo accesso e sceglie la password.
L'importazione crea lo spazio dell'installazione, i quattro livelli, tutti i ruoli e tutti gli utenti del gestionale. Gli utenti arrivano senza password: quelle del gestionale non vengono lette né copiate.
Nota. Per tornare indietro basta spegnere l'accesso nel file d'ambiente e riavviare: tutto torna com'era e quello che è stato importato resta dov'è.
Attenzione. Un utente creato nel gestionale dopo l'importazione non entra finché non si riallinea. Per portare un'installazione già fatta allo stato di oggi c'è Assesta l'installazione, nella stessa voce di menu di Ruoli e permessi.
Per chi sviluppa.
• Variabili: AUTH_ENABLED=true, SIGEA_INSTALLAZIONE, KEYCLOAK_BASE_URL, KEYCLOAK_INTERNAL_URL, SIGEA_SETUP_KEY, SSO_REDIRECT_ORIGINS; per le pagine storiche SBH_SSO_MODE=on. Registro: docs/devops/ENVIRONMENT.md.
• Il codice di sblocco è nel log di SIGEAnext. L'esito finisce nel file cifrato installazione.enc.
• Una installazione per cliente: docs/devops/auth/SSO-PER-INSTALLAZIONE.md.
Per approfondire.
• Login unico con Keycloak: docs/guide/amministrazione/login-unico-keycloak/README.md