Salta ai contenuti
Italiano

Ruoli e permessi: come funzionano gli accessi

PerchéCapire il modello degli accessi prima di distribuire i login: da cosa nasce «ciò che un membro del team vede».
Per chiAl proprietario che assembla il team.
Cosa ottieniUno schema chiaro – «ruolo (insieme di permessi) + scope delle categorie = accesso» – e la capacità di leggere l’editor del ruolo.
LimitazioniIl modello vale nell’ambito di una sola struttura; la visibilità del denaro non si può restringere per categorie – entrambi i confini sono trattati nel testo.

Prima di creare i login per il team conviene sapere cosa ognuno vedrà dopo l’accesso. L’accesso si compone di due parti indipendenti: il gruppo di accesso risponde a «cosa si può fare», lo scope per categorie di camera a «cosa si vede». In questo articolo: entrambe le parti, i tre ruoli di sistema e l’editor dei permessi.

Tutti gli accessi si gestiscono nella sezione «Accessi (RBAC)» del gruppo «Sistema» del menu a sinistra. La pagina si chiama «Amministrazione RBAC», e la sua dicitura fissa subito la cornice: «Gestione dei gruppi di accesso, dei permessi e delle assegnazioni degli utenti nell’ambito dell’hotel corrente.» Gli accessi descrivono una struttura – non una rete di strutture, non l’azienda intera.

Dentro ci sono due tab: «Gruppi di accesso» e «Utenti». Sono loro a tenere le due parti dell’accesso:

  • Il gruppo di accesso è un insieme di permessi per modulo: cosa è consentito al membro del team. È questo che qui vuol dire «ruolo»; si configura nel tab «Gruppi di accesso».
  • Lo scope per categorie – quali categorie di camera vede il membro del team. Non vive nel ruolo ma nella scheda utente, nel tab «Utenti».

I ruoli sono raccolti in una tabella con le colonne ID · Codice · Nome · Permessi · Tipo · Azioni («Modifica») – a colpo d’occhio si vedono sia il numero di permessi sia se il gruppo è di sistema o tuo proprio.

Di serie il sistema porta tre ruoli:

  • «Proprietario» (owner) – tutti i 39 permessi;
  • «Gestore» (manager) – un insieme più stretto di quello del proprietario; il contenuto esatto si vede nell’editor;
  • «Visualizzatore» (viewer) – un ruolo di sola consultazione.

Nella scheda utente il gruppo appare con il nome e il codice – «Proprietario (owner)».

Il contenuto del ruolo si cambia nell’editor «Modifica del gruppo di accesso»: i campi «* Codice del ruolo», «* Nome», «Descrizione» e il blocco «Permessi di accesso». Un ruolo di sistema porta sopra i campi l’avviso: «Ruolo di sistema: il codice e il nome non si possono modificare; si può aggiornare solo l’insieme dei permessi.» Codice e nome sono grigi – si corregge solo l’insieme dei permessi. Il gruppo proprio ha tutti i campi modificabili.

Il gruppo proprio per il proprio team lo crea il pulsante «Nuovo gruppo» – per esempio «Reception»: i permessi per «Planner» e «Prenotazioni», senza «Finanze».

I permessi del gruppo sono raggruppati per 17 moduli: «Channel Manager», «Dashboard», «Finanze», «Dati degli ospiti», «Ospiti», «Messaggi», «Integrazioni», «Prenotazione online», «Pagamenti», «Planner», «Tariffe», «Prenotazioni», «Camere», «Servizi», «Imposte», «Modelli», «Utenti».

Il formato di ogni permesso è uno – «Modulo: azione – descrizione»: dalla riga si vede subito a quale modulo appartiene l’azione e che cosa esattamente consente.

Nella maggior parte dei moduli i permessi sono in coppia – visualizzazione e modifica. Alcuni moduli aggiungono azioni puntuali, e di tre conviene sapere in anticipo:

  • «Messaggi» – “invio” e “amministrazione”;
  • «Utenti» – “gestione”, cioè il permesso di configurare gli utenti e i loro accessi;
  • «Ospiti» – “Compilazione del modulo per l’ospite” e “Decifratura dei dati personali del modulo dell’ospite”: entrambi i permessi riguardano i dati del passaporto del modulo dell’ospite, conviene concederli miratamente.

Il blocco «Permessi di accesso» nell’editor è comodo: c’è la ricerca tra i permessi, per ogni modulo un contatore «N/N» e i pulsanti «Deseleziona tutti» / «Seleziona tutti».

Cercare la visibilità per categorie nell’editor del ruolo è inutile – lì non c’è. Il principio del modello: il ruolo governa le azioni, non «quali camere si vedono».

Il taglio per categorie si imposta nella scheda utente: tab «Utenti» → pulsante «Configura accessi» → schermata «Configurazione degli accessi dell’utente». Oltre al nome, al login, alla «Struttura» e ai «Gruppi di accesso», contiene il blocco «Scope per il modulo “Camere”» con il campo «Modalità scope»:

  • «Tutte le categorie» – sotto il campo il suggerimento: «L’utente vede tutte le categorie della struttura selezionata.»
  • «Solo l’elenco delle categorie» – si vedono solo le categorie scelte.

L’esempio classico è l’addetto alle pulizie: non serve un ruolo a parte «vede solo il suo piano». Basta un ruolo qualsiasi e la modalità «Solo l’elenco delle categorie» con le categorie del suo piano. Lo stesso meccanismo chiude l’accesso del proprietario dell’unità: l’unità degli appartamenti è una categoria, e uno scope di una sola categoria lascia al proprietario il suo appartamento.

La regola «l’utente vede solo il suo denaro» nel sistema non funziona – non costruire lo schema degli accessi su di essa. Le finanze si limitano solo col permesso: c’è il permesso del modulo «Finanze» – si vede tutto il movimento di denaro della struttura; il denaro non ha un taglio per categorie, e lo scope per categorie non lo tocca.

Quindi le coppie «l’addetto alle pulizie vede il denaro del suo piano» o «il proprietario dell’unità vede i pagamenti del solo suo appartamento» non si possono comporre: o il permesso di «Finanze» – e il quadro intero, o il permesso non c’è – e di denaro niente.

Chi ha cambiato cosa lo mostra il registro: «Log» → «Registro dell’applicazione» – «Consultazione delle azioni operative, degli eventi di sistema e degli errori con filtri per tempo, utente ed entità.»

Anche gli accessi non fanno eccezione: la creazione di un utente lascia l’evento USER_CREATED, il cambio dei suoi accessi – USER_ACCESS_UPDATED. La via rapida fino a essi è il chip di filtro «Accessi». Per il proprietario è la risposta pronta alla domanda «chi ha corretto i permessi di un membro del team, e quando».