Crea, modifica e assegna ruoli

I ruoli in GSI2 forniscono un sistema centralizzato per gestire i diritti di accesso e le autorizzazioni degli utenti attraverso il controllo degli accessi basato sui ruoli (RBAC). Questa guida descrive come creare nuovi ruoli, modificare quelli esistenti e assegnarli agli utenti.

Concetti Fondamentali

• Ruolo: Collezione predefinita di permessi che può essere assegnata a più utenti
• Permessi: Autorizzazioni specifiche per accedere e operare sui moduli del sistema
• Ereditarietà: Gli utenti ereditano automaticamente tutti i permessi dai ruoli assegnati
• Cumulatività: Un utente può avere più ruoli; i permessi si sommano

Legenda Colori Checkbox Permessi

Nel pannello di configurazione permessi, le checkbox utilizzano colori diversi per indicare l'origine dei permessi:

• Arancione: Permessi derivati dal ruolo assegnato (non possono essere modificati a livello individuale)
• Giallo: Permessi derivati automaticamente da altri permessi (dipendenze)
• Blu: Assegnazioni singole/individuali impostate direttamente

Parte 1: Creare un Nuovo Ruolo

Accesso alla Gestione Ruoli

1. Dal menu principale, navigare su Tabelle Generali
2. Selezionare Ruoli
3. Si aprirà la tabella con i ruoli esistenti

Creazione del Ruolo

1. Cliccare sul pulsante "+" in alto a destra
2. Nel modulo di creazione, inserire:
   • Nome: Nome descrittivo del ruolo (es. "Responsabile HR", "Operatore CRM", "Supervisore Presenze")
   • Azienda: Selezionare l'azienda per cui il ruolo è valido
3. Cliccare SALVA per creare il ruolo base

Configurazione Permessi del Ruolo

1. Trovare il ruolo appena creato nella tabella
2. Cliccare sull'icona lucchetto nella colonna Azioni
3. Si aprirà il pannello di configurazione permessi

Assegnazione Permessi al Ruolo

Nel pannello permessi, configurare le autorizzazioni per sezione:

Permessi di Sistema

• Company Admin: ⚠️ Concede TUTTI i permessi - usare con cautela
• Login to Other Companies: Permette accesso ad altre aziende del live client
• Set Permissions: ⚠️ Permette di gestire permessi di altri utenti

Permessi per Modulo

Per ogni modulo, configurare operazioni CRUD:

• All: Checkbox sotto il titolo della sezione - selezionandola vengono automaticamente selezionati tutti i permessi della sezione
• Visualizzazione (R): Visualizzare dati
• Creare (C): Creare nuovi record
• Aggiornamento (U): Modificare record esistenti
• Eliminare (D): Eliminare record

Esempi di Configurazione Ruolo

Ruolo "Operatore HR Base":

• Dipendenti: Visualizzazione ✓, Creare ✓
• Staff: Visualizzazione ✓
• Documenti: Visualizzazione ✓
• Altri moduli: nessun permesso

Ruolo "Supervisore Presenze":

• Staff: All ✓
• Dipendenti: Visualizzazione ✓, Aggiornamento ✓
• Approver Rights ✓
• Notifiche: All ✓

Parte 2: Modificare un Ruolo Esistente

Modificare Nome del Ruolo

1. Dalla tabella Ruoli, cliccare l'icona matita del ruolo
2. Modificare il nome nel campo di testo
3. Salvare le modifiche

Aggiornare Permessi del Ruolo

1. Cliccare l'icona lucchetto del ruolo
2. Nel pannello permessi:
   • Selezionare nuove checkbox per aggiungere permessi
   • Deselezionare checkbox per rimuovere permessi
   • Notare i permessi evidenziati in giallo (dipendenze automatiche da altri permessi)
   • I permessi in arancione derivano dal ruolo stesso e non possono essere modificati individualmente
3. Cliccare SALVA per applicare le modifiche

⚠️ Importante: Le modifiche ai ruoli si applicano immediatamente a tutti gli utenti che hanno quel ruolo assegnato.

Parte 3: Assegnare Ruoli agli Utenti

Metodo 1: Durante la Creazione Utente

1. Navigare su Organizzazione > Dipendenti
2. Cliccare Aggiungi Dipendente con Wizard
3. Step 1: Inserire dati essenziali
4. Step 2: Nella sezione ruoli, selezionare uno o più ruoli dal menu dropdown
5. Completare la creazione

Metodo 2: Su Utente Esistente

1. Dalla tabella Dipendenti, individuare l'utente
2. Cliccare l'icona lucchetto nella colonna Azioni
3. Nel pannello permessi:
   • Sezione Ruoli in alto
   • Selezionare ruoli dal dropdown
   • Per assegnazioni multiple, selezionare più ruoli
4. Salvare per applicare i ruoli

Verifica Ruoli Assegnati

1. Aprire i permessi dell'utente (icona lucchetto)
2. I ruoli attivi sono mostrati nella sezione superiore
3. I permessi derivati dai ruoli sono visualizzati con checkbox arancioni
4. Permessi individuali aggiuntivi hanno checkbox blu
5. Dipendenze automatiche appaiono in giallo

Gestione Avanzata

Combinazione di Ruoli Multipli

Quando un utente ha più ruoli:

• I permessi si sommano (unione di tutti i permessi)
• Non ci sono conflitti: se anche un solo ruolo concede un permesso, l'utente lo possiede
• Esempio: Ruolo A (Visualizzazione Documenti) + Ruolo B (Creare Documenti) = Utente può Visualizzare + Creare

Override con Permessi Individuali

Oltre ai ruoli, è possibile:

1. Aggiungere permessi individuali specifici non inclusi nei ruoli
2. Questi permessi si sommano a quelli dei ruoli
3. Non è possibile "togliere" un permesso concesso da un ruolo

Rimuovere un Ruolo da Utente

1. Aprire pannello permessi utente
2. Nella sezione ruoli, deselezionare il ruolo da rimuovere
3. Salvare le modifiche
4. L'utente perderà immediatamente i permessi di quel ruolo

Best Practices

Progettazione Ruoli

• Principio del privilegio minimo: Concedere solo i permessi necessari
• Nomenclatura chiara: Usare nomi descrittivi (es. "Contabile_SolaLettura" vs "Ruolo1")
• Ruoli granulari: Meglio più ruoli specifici che pochi ruoli troppo ampi
• Documentazione: Mantenere un registro dei ruoli e loro scopo

Sicurezza

• Limitare al massimo i ruoli con "Company Admin" o "Set Permissions"
• Rivedere periodicamente le assegnazioni ruoli (audit trimestrale)
• Rimuovere ruoli quando cambiano le mansioni dell'utente
• Non creare ruoli "catch-all" con troppi permessi