# JB3.3 - Assegnare un ruolo

**In una frase.** Per dare un livello a un gruppo di persone, agganci un loro ruolo del gestionale a uno dei quattro livelli.

Non si lavora utente per utente. Dici una volta sola «chi ha il ruolo amministrazione è Utente base nelle stampe», e vale per tutti quelli che hanno quel ruolo, anche per chi arriverà dopo.

1. **Apri Ruoli e permessi.** Dal modulo **EE0 Gestione Servizi**, **Impostazioni**, **Utenti e accessi**, **Ruoli e permessi**. Oppure dal menu utente, in alto a destra.
2. **Scegli la scheda del servizio.** Una scheda per servizio. I ruoli della scheda di ADEnext valgono anche per SIGEAnext, con lo stesso livello.
3. **Premi Nuovo ruolo.** Con **Scegli fra i ruoli di Keycloak** cerchi fra i ruoli che esistono davvero, compresi quelli arrivati dal gestionale: il nome si scrive da solo, senza errori di battitura. Puoi anche scriverlo a mano.
4. **Scegli il livello e premi Salva.**
    
    ![Il riquadro Nuovo ruolo: il nome del ruolo e il livello da dare. Schermata di una versione precedente: oggi c'è anche il pulsante per scegliere il ruolo da un elenco](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/il-riquadro-nuovo-ruolo-il-nome-del-ruolo-e-il-livello-da-dare-schermata-di-una-versione-precedente-oggi-ce-anche-il-pulsante-p)
    
    *Il riquadro Nuovo ruolo: il nome del ruolo e il livello da dare. Schermata di una versione precedente: oggi c'è anche il pulsante per scegliere il ruolo da un elenco*
5. **Controlla.** La riga compare nell'elenco. Chi ha quel ruolo ha il livello nuovo dalla richiesta successiva: non serve uscire e rientrare.

Per cambiare un aggancio premi la matita sulla riga. Il cestino lo toglie, dopo una conferma.

**Chi può farlo.** Serve il livello Utente avanzato nel servizio. Solo lo Staff può concedere il livello Staff e toccare i quattro ruoli già pronti. Utente base e Lettore vedono l'elenco senza poterlo cambiare.

<p class="callout info">**Nota.** Lo stesso ruolo può dare livelli diversi in servizi diversi: per esempio Utente avanzato nelle analisi e Lettore nelle stampe.</p>

<p class="callout warning">**Attenzione.** Se l'elenco dei ruoli non si apre, al posto del pulsante compare un avviso con il motivo e **Riprova**. Intanto puoi scegliere fra i ruoli del gestionale o scrivere il nome a mano.</p>

<p class="callout info">**Per chi sviluppa.**  
• Pagina: `frontend/shell/src/pages/ruoli`, indirizzo `/pages/ruoli`.  
• Ogni servizio tiene i suoi agganci in una tabella `ruoli`; SIGEAnext legge quelli di ADEnext.  
• Nome del ruolo: lettere, cifre, `_`, `.`, `-`, al massimo 64 caratteri. Maiuscole e minuscole non contano. </p>

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