Utenti e ruoli
Sezione visibile nella sidebar Amministrazione agli amministratori del tenant e al ruolo Super Admin. Gli operatori non vi accedono.
La sezione Utenti e ruoli consente di gestire gli account che accedono al tenant e i permessi ad essi associati.
Prerequisiti
- Ruolo di amministratore o Super Admin sul tenant.
- Per assegnare un ruolo personalizzato, il ruolo deve già esistere (vedi Ruoli personalizzati).
I ruoli di sistema
Askme AI definisce tre ruoli di sistema, non eliminabili e con permessi minimi non modificabili:
| Ruolo | Descrizione |
|---|---|
| Super Admin (amministratore di piattaforma) | Accesso completo, incluse le funzioni cross-tenant: creazione e gestione dei tenant, gestione delle licenze, impostazioni di sistema e importi in valuta nel monitoraggio. È un ruolo di piattaforma, previsto nell'ambito di un accordo Enterprise (vedi Super Admin e piano Enterprise). |
| Amministratore | Pieno controllo del proprio tenant — utenti, agenti, knowledge base, API key, monitoraggio — esclusa la gestione di tenant, piani, costi e impostazioni di sistema |
| Operatore | Gestione di agenti, knowledge base, conversazioni e canale vocale — nessun accesso a utenti, API key o impostazioni |
Ruoli personalizzati
Oltre ai ruoli di sistema, è possibile definire ruoli personalizzati per tenant tramite un editor a matrice dei permessi, organizzato per dominio funzionale (agenti, knowledge base, conversazioni, analisi, monitoraggio, utenti, ruoli, API key, feature flag, modelli LLM, webhook, audit, tenant).
Per ciascun ruolo personalizzato si definisce inoltre quali feature flag il ruolo può utilizzare, indipendentemente dai flag attivi sul tenant.
Un utente non può assegnare a un ruolo permessi che lui stesso non possiede. Questo evita che un amministratore crei un ruolo con privilegi superiori ai propri.
Creare un ruolo personalizzato
- Aprire Amministrazione → Utenti e ruoli → Ruoli e selezionare Nuovo ruolo.
- Assegnare un codice univoco e un'etichetta.
- Selezionare i permessi dalla matrice per dominio.
- Indicare quali feature flag il ruolo può utilizzare.
- Salvare.
Creare un utente
- Selezionare Nuovo utente.
- Compilare nome completo, email (identificativo di accesso) e ruolo.
- Salvare: il sistema genera una password temporanea e crea automaticamente l'account anche su Keycloak.
Le credenziali generate vengono mostrate una sola volta alla creazione. È necessario comunicarle subito all'utente in modo sicuro: dopo la chiusura del dialogo non sono più recuperabili e l'utente dovrà utilizzare la procedura di reset password.
Gestire un utente
Le azioni disponibili sulla riga di un utente permettono di:
- Modificare nome, ruolo e stato.
- Reimpostare la password — genera una nuova password temporanea.
- Disattivare — impedisce l'accesso finché l'account non viene riattivato.
- Eliminare — rimuove definitivamente l'utente (operazione irreversibile).
Profilo personale
Ogni utente gestisce autonomamente, dal proprio profilo, la lingua dell'interfaccia, il fuso orario e le preferenze di notifica, incluso l'eventuale opt-out personale dalle email di soglia quota (vedi Avvisi email sulle quote).
Risultato atteso
Il nuovo utente compare nell'elenco con lo stato Attivo e può accedere con le credenziali ricevute; il ruolo assegnato determina le voci di sidebar e le operazioni consentite.
Problemi comuni
| Problema | Causa probabile | Soluzione |
|---|---|---|
| L'utente non vede alcune voci di menu | Il ruolo assegnato non include i permessi corrispondenti | Verificare la matrice permessi del ruolo o assegnarne uno diverso |
| Impossibile assegnare un permesso a un nuovo ruolo | Blocco anti-escalation: l'utente che crea il ruolo non possiede quel permesso | Far creare il ruolo da un utente con ruolo Super Admin o estendere prima i permessi dell'utente |
| L'utente creato non riesce ad accedere | Le credenziali temporanee sono state perse dopo la chiusura del dialogo | Usare Reimposta password per generarne di nuove |