Ruoli e permessi
Un accesso (grant) collega un utente a una risorsa — un gruppo o un impianto — assegnandogli un ruolo. Il sistema espande il ruolo in un insieme di permessi che determinano cosa l’utente può vedere e fare su quella risorsa e su tutto ciò che le sta sotto nella gerarchia.
Nel portale, i nomi dei ruoli nel selettore compaiono sempre in inglese, indipendentemente dalla lingua dell’interfaccia. La tabella seguente riporta sia il nome italiano descrittivo usato in questa guida sia l’etichetta esatta che si vede nel portale.
I ruoli
Ogni ruolo include tutti i permessi del ruolo precedente (gerarchia crescente): Visualizzatore ⊂ Utente finale ⊂ Responsabile impianto ⊂ Responsabile gruppo ⊂ Amministratore.
| Ruolo | Etichetta nel portale | Descrizione |
|---|---|---|
| Visualizzatore | Viewer | Legge circuiti, sensori e allarmi. Non può modificare nulla né accedere ai dispositivi o ai dati avanzati. |
| Utente finale | End user | Visualizzatore + comanda i circuiti: modalità, setpoint e parametri dei circuiti non riservati ai parametri avanzati. Non modifica sensori, allarmi e dispositivi e non tacita gli allarmi. |
| Responsabile impianto | Plant owner | Utente finale + gestione completa dell’impianto: dispositivi, struttura (circuiti, sensori, allarmi), parametri avanzati, notifiche e accessi all’impianto. Non può creare, rinominare o eliminare impianti. |
| Responsabile gruppo | Tenant owner | Responsabile impianto + crea, rinomina ed elimina impianti, gestisce il gruppo stesso, i suoi accessi e i canali di notifica, e aggiorna il firmware dei dispositivi. È il ruolo più alto assegnabile tramite un accesso, e si assegna solo su un gruppo, non su un singolo impianto. |
| Amministratore | (non assegnabile da un accesso) | Accesso completo a tutto il sistema, incluse funzioni riservate a Enumera (gestione utenti, dispositivi, firmware, broker). Ruolo globale: si assegna solo a livello di account utente, mai tramite un accesso a un gruppo o impianto specifico, e non compare tra le opzioni del selettore dei ruoli. |
Alcuni permessi puntuali (ad esempio la lettura dei parametri avanzati) possono essere concessi individualmente anche a un Visualizzatore o Utente finale, ma questo è possibile solo tramite l’API della piattaforma, non dal portale: l’interfaccia web assegna sempre e solo uno dei ruoli della tabella.
Ereditarietà e accessi aggiuntivi
Gli accessi sono gerarchici e additivi: un accesso concesso su un gruppo si applica automaticamente a tutti i sottogruppi e a tutti gli impianti sotto di esso. L’accesso effettivo di un utente su una risorsa è sempre l’unione di tutti gli accessi ricevuti risalendo la gerarchia fino alla radice — non esiste un meccanismo per “togliere” o ridurre un accesso ereditato da un livello più in basso.
Questo ha una conseguenza pratica importante: è possibile concedere a un utente un ruolo più alto su un gruppo figlio (o su un singolo impianto) rispetto a quello che ha sul gruppo padre. Ad esempio, un tecnico con ruolo Visualizzatore su tutto il gruppo /acme può ricevere un accesso aggiuntivo come Responsabile impianto solo sul gruppo /acme/europa o su un impianto specifico: in quel ramo della gerarchia avrà pieni poteri di gestione, mentre altrove resterà in sola lettura.
Non è invece possibile il contrario: concedere su un discendente un ruolo più basso di uno già ereditato da un antenato non ha alcun effetto, perché l’accesso più alto ereditato continua comunque ad applicarsi. Il portale lo evidenzia nel selettore dei ruoli: le opzioni già coperte da un accesso ereditato sono disabilitate con l’etichetta “Già concesso”. L’accesso può comunque essere salvato (ad esempio per documentare esplicitamente un’intenzione), ma resta senza effetto pratico.
Simmetricamente, se si innalza un accesso su un gruppo padre e questo rende ridondante un accesso già esistente su un discendente, il portale mostra un avviso dopo il salvataggio (es. “Questo utente ha già un grant Plant owner sul gruppo /acme/europa che è ora ridondante — non ha alcun effetto e può essere rimosso manualmente”). L’accesso ridondante non viene rimosso automaticamente: va eliminato manualmente sulla risorsa dove è definito, se lo si desidera.
Infine, un utente può concedere solo i ruoli che possiede lui stesso su quella risorsa: un Responsabile impianto non può assegnare ad altri il ruolo Responsabile gruppo, anche se lo desiderasse.
L’editor degli accessi
La sezione Accesso è disponibile negli editor del gruppo e dell’impianto ed è visibile solo agli utenti con il permesso readGrant. Ogni riga rappresenta un utente e mostra nome, email e ruolo; un utente il cui unico accesso su quella risorsa è ereditato (nessun accesso diretto) compare con il nome in grigio, seguito dall’indicazione “Ereditato da” e dal percorso del gruppo antenato in cui l’accesso è definito — e non espone alcuna azione di modifica: va gestito alla risorsa d’origine.
Per aggiungere o modificare accessi è necessario il permesso writeGrant, incluso nel ruolo Responsabile impianto e superiori:
- Aprire Aggiungi membro e digitare l’indirizzo email: il portale verifica in tempo reale se corrisponde a un account esistente, a un invito già in sospeso, oppure a nessun account (in tal caso, al salvataggio verrà inviato automaticamente un nuovo invito — vedi Utenti)
- Selezionare il Ruolo dal menu a tendina, tra quelli posseduti dall’utente che sta effettuando l’operazione
- Confermare per creare l’accesso
Un utente può avere un solo accesso diretto per risorsa: se ne ha già uno su quel gruppo o impianto, il portale segnala di usare Modifica anziché crearne uno nuovo.
Cambiare il ruolo di un membro
- Nella sezione Accesso, selezionare l’icona di modifica sulla riga del membro: si apre Modifica membro, con il nome e l’email dell’utente
- Scegliere il nuovo Ruolo; come nella creazione, i ruoli già coperti da un accesso ereditato compaiono con Già concesso
- Confermare con Salva: il portale mostra “Accesso aggiornato” e, se il nuovo ruolo rende ridondante un accesso su un gruppo o impianto discendente, lo segnala con un avviso
Rimuovere un membro
- Nella sezione Accesso, selezionare l’icona di eliminazione sulla riga del membro
- Confermare in Rimuovi membro. Se l’utente è ancora In attesa, la conferma avvisa che “La rimozione di questo accesso annullerà l’invito in sospeso”
- Il portale mostra “Membro rimosso”
Le righe degli accessi ereditati non hanno queste icone: si modificano sul gruppo in cui l’accesso è definito. Cosa succede all’account dopo la rimozione è descritto in Utenti.