# JB3.4 - Il ruolo di prova

**In una frase.** Negli ambienti di prova, dove l'Accesso è spento, un selettore ti fa vedere l'applicazione come la vedrebbe chi ha un certo ruolo.

Serve a chi configura i permessi e a chi sviluppa. Prima di dare un ruolo a venti persone, controlli in un minuto cosa vedranno: quali pulsanti sono accesi, quali pagine si aprono, cosa viene rifiutato. Senza creare utenti finti.

1. **Guarda la barra in alto.** Con l'Accesso spento c'è il selettore **Ruolo di prova**. Parte da **Tutti i permessi (sviluppo)**: puoi fare tutto.
2. **Scegli un ruolo.** L'elenco contiene i ruoli di tutti i servizi. Accanto a ognuno c'è scritto quali servizi lo conoscono.
    
    ![Il selettore Ruolo di prova aperto: i quattro livelli e, per ciascuno, i servizi che lo conoscono. Ambiente di sviluppo](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/il-selettore-ruolo-di-prova-aperto-i-quattro-livelli-e-per-ciascuno-i-servizi-che-lo-conoscono-ambiente-di-sviluppo.png)
    
    *Il selettore Ruolo di prova aperto: i quattro livelli e, per ciascuno, i servizi che lo conoscono. Ambiente di sviluppo*
3. **Prova.** La pagina si ricarica. Da quel momento ogni servizio si comporta come per un utente con quel ruolo. Apri una stampa, un cruscotto, la pagina Ruoli e permessi: vedi cosa cambia.
4. **Torna indietro.** Scegli di nuovo **Tutti i permessi (sviluppo)**.

**Dal cliente non c'è.** Con l'Accesso acceso il selettore non compare e il Gateway scarta qualunque richiesta che provi a usarlo. Nessuno può fingersi un altro ruolo: valgono solo i ruoli veri, quelli che arrivano con l'accesso.

<p class="callout info">**Nota.** Per provare un ruolo che non è ancora agganciato, prima aggiungilo in **Ruoli e permessi** con il livello che vuoi dare. Poi lo trovi nel selettore.</p>

<p class="callout info">**Per chi sviluppa.**  
• La scelta viaggia nell'intestazione `X-Dev-Roles`. Il Gateway la lascia passare solo con `AUTH_ENABLED=false`.  
• Con l'Accesso spento e nessun ruolo scelto, i servizi danno il livello Staff.  
• Selettore: `frontend/shell/src/layout/components/ruolo-prova-select.ts`. Elenco dei servizi: `SERVIZI_CON_RUOLI` in `frontend/shell/src/shared/auth/ruolo-prova.ts`. </p>

<p class="callout info">**Per approfondire.**  
• Ruoli e permessi: `docs/guide/amministrazione/ruoli-e-permessi/README.md`</p>