
# Gestisci il team della dashboard

Il team della dashboard è composto dalle persone che lavorano nel tuo account KeenAuth: configurano gli ambienti, si occupano degli utenti finali e gestiscono la fatturazione. I membri del team sono separati dai tuoi utenti finali e dagli amministratori delle organizzazioni dei tuoi clienti. Apri **Team** nella dashboard per vedere i membri, gli inviti aperti e, con Enterprise, i ruoli personalizzati.

Una persona può appartenere a più account KeenAuth con lo stesso accesso. Il selettore dell'account nella barra superiore ti permette di passare dall'uno all'altro. Quando l'account a cui passi richiede un accesso diverso, la dashboard ti chiede di accedere di nuovo per quell'account.

## Ruoli predefiniti

Ogni membro ha una o più assegnazioni di ruolo. Un ruolo assegnato per l'intero account si applica a ogni progetto e ambiente dell'account.

| Ruolo | Cosa può fare |
|---|---|
| `owner` | Tutto, inclusa la chiusura dell'account, il trasferimento della proprietà, la creazione di ambienti `production`, l'eliminazione di ambienti, la modifica della modalità dell'issuer e le modifiche al piano e alla fatturazione. |
| `admin` | Tutto ciò che può fare un owner, eccetto le azioni riservate agli owner indicate sopra e la fatturazione. Gestisce il team e i ruoli personalizzati, ma non può invitare, assegnare, revocare o rimuovere un owner. |
| `developer` | Legge e scrive la configurazione dell'ambiente (applicazioni, connessioni, branding, hook e simili). Crea chiavi API di gestione e client di gestione solo negli ambienti `development` e `staging`. Vede i dati personali degli utenti finali mascherati e non può agire sugli utenti finali. |
| `support` | Legge configurazione, log ed eventi di audit, e agisce sugli utenti finali: blocco, chiusura delle sessioni, reimpostazione delle credenziali, eliminazione degli utenti. Vede per intero i dati personali degli utenti finali. Non può modificare la configurazione. |
| `billing` | Vede utilizzo, piano e fatture, e modifica il piano. Non ha accesso alla configurazione degli ambienti né agli utenti finali. |
| `viewer` | Legge configurazione, log, eventi di audit e utilizzo. Vede i dati personali degli utenti finali mascherati. |

Ogni ruolo può vedere l'elenco del team. Le impostazioni di sicurezza, le chiavi di firma, i domini personalizzati, l'esportazione e l'importazione in blocco e le concessioni di accesso al supporto della piattaforma sono riservate a `owner` e `admin`.

### Azioni che richiedono un accesso recente

Alcune azioni sono accettate solo se hai effettuato l'accesso negli ultimi 5 minuti. Altrimenti la dashboard ti chiede di accedere di nuovo e poi prosegue:

- invitare membri, assegnare e revocare ruoli, rimuovere membri
- creare, modificare ed eliminare ruoli personalizzati
- trasferire la proprietà e chiudere l'account
- creare ambienti `production`, eliminare ambienti e modificare la modalità dell'issuer
- modifiche al piano e alla fatturazione
- concedere l'accesso al supporto della piattaforma e modificare le impostazioni di sicurezza della dashboard

## Invita un membro

Solo un `owner` o un `admin` può invitare. Un `admin` non può invitare qualcuno come `owner`.

1. Apri **Team**, quindi scegli **Invita un membro**.
2. Inserisci l'indirizzo email, il ruolo e l'ambito. Il ruolo `owner` può essere assegnato solo per l'intero account. Gli ambiti per progetto e per ambiente richiedono il piano Enterprise; vedi "Ruoli personalizzati e assegnazioni con ambito" più avanti.
3. Scegli **Crea invito**.

La dashboard mostra il link di invito una sola volta. Copialo subito: non potrà essere mostrato di nuovo. La dashboard ti indica anche se è stata inviata un'email di invito al destinatario. L'email è scritta nella lingua della tua dashboard o in inglese. Se non è stata inviata alcuna email, invia il link al destinatario tramite un canale di cui ti fidi.

Limiti:

- Un invito scade 7 giorni dopo la sua creazione.
- Un account può creare al massimo 50 inviti in 24 ore e può avere al massimo 100 inviti aperti.
- Un indirizzo può avere un solo invito aperto alla volta in un account.

Per ritirare un invito, apri **Inviti** e scegli **Revoca invito**. Il link smette di funzionare immediatamente.

### Accetta un invito

Il destinatario apre il link e accede alla dashboard. L'invito può essere accettato solo da un utente della dashboard il cui indirizzo email principale verificato è l'indirizzo invitato; accedere con un altro indirizzo non funziona. Dopo l'accettazione il membro è attivo con il ruolo invitato.

Un invito ha l'autorità del membro che lo ha inviato. Se quel membro non è più un membro attivo quando il link viene usato, oppure non può più assegnare il ruolo invitato, l'invito non funziona più. Un link scaduto, già usato, revocato o sconosciuto, e un link aperto con l'indirizzo sbagliato, mostrano tutti lo stesso messaggio: chiedi alla persona che ti ha invitato un nuovo link.

## Cambia ruoli e rimuovi membri

Dal menu del membro in **Membri**:

- **Assegna ruolo** aggiunge un'assegnazione. Un membro può avere più assegnazioni; lo stesso ruolo con lo stesso ambito non può essere assegnato due volte.
- **Revoca** rimuove un'assegnazione.
- **Rimuovi membro** rimuove tutte le assegnazioni del membro e termina la sua appartenenza. Il membro perde subito l'accesso all'account.

Un `admin` non può revocare il ruolo `owner` a un owner né rimuovere un owner. L'ultimo `owner` attivo di un account non può essere rimosso né perdere il ruolo `owner`, così un account ha sempre un owner.

Quando un ruolo viene revocato o un membro viene rimosso, anche le sessioni della dashboard di quella persona e il suo accesso all'account vengono revocati. Vedi [Sicurezza dell'accesso alla dashboard](/docs/security/dashboard-access).

## Trasferisci la proprietà

Solo un `owner` può trasferire la proprietà. Il nuovo owner deve essere un altro membro attivo che non sia già owner e che abbia effettuato almeno una volta l'accesso alla dashboard con l'autenticazione a più fattori.

Scegli **Trasferisci proprietà** nel menu del membro e digita l'ID del membro per confermare. In un unico passaggio il membro diventa `owner` e il tuo ruolo `owner` diventa `admin`. Solo un owner può di nuovo renderti owner.

## Ruoli personalizzati e assegnazioni con ambito

I ruoli personalizzati e le assegnazioni con ambito per progetto o per ambiente sono disponibili con il piano Enterprise. Con gli altri piani la dashboard mostra la scheda **Ruoli personalizzati** con un avviso sul piano, e l'assegnazione di un ruolo personalizzato o con ambito viene rifiutata.

### Crea un ruolo personalizzato

I membri `owner` e `admin` gestiscono i ruoli personalizzati in **Team** > **Ruoli personalizzati**.

- **Chiave del ruolo**: da 3 a 40 caratteri, lettere minuscole, cifre e trattini bassi, che inizi con una lettera. Non può essere il nome di un ruolo predefinito e non può essere modificata in seguito.
- **Nome**: da 1 a 100 caratteri.
- **Autorizzazioni**: autorizzazioni dell'API di gestione valide negli ambienti in cui il ruolo è assegnato, al massimo 200.
- **Azioni della dashboard**: azioni su account, progetto, ambiente e fatturazione nella dashboard.

Un ruolo richiede almeno un'autorizzazione o un'azione della dashboard. Si applicano questi limiti:

- Le azioni riservate agli owner (chiusura dell'account, trasferimento della proprietà, creazione di ambienti `production`, eliminazione di ambienti, modifica della modalità dell'issuer) non possono far parte di un ruolo personalizzato.
- Puoi concedere solo le autorizzazioni e le azioni che il tuo ruolo possiede in un ambiente `production`. La dashboard offre solo quelle.
- Per modificare un ruolo devi possedere tutto ciò che è presente sia nel contenuto attuale sia in quello nuovo. Se un ruolo concede più di quanto concede il tuo, chiedi a un owner dell'account di modificarlo.
- Un ruolo ancora assegnato o citato da un invito aperto non può essere eliminato. Revoca prima quelle assegnazioni. L'eliminazione è possibile anche dopo che l'account ha lasciato il piano Enterprise.

Invitare membri, assegnare ruoli e gestire i ruoli personalizzati richiede sempre il ruolo predefinito `owner` o `admin` per l'intero account; un ruolo personalizzato non concede queste azioni sul team.

### Assegnazioni con ambito

Un ruolo può essere assegnato per l'intero account, per un progetto (ogni ambiente di quel progetto) o per un singolo ambiente. Il progetto o l'ambiente deve appartenere all'account. Un membro con solo assegnazioni con ambito vede solo i progetti e gli ambienti coperti da tali assegnazioni, e ottiene l'accesso alla dashboard solo a quegli ambienti. Quando più assegnazioni coprono lo stesso ambiente, il membro ha lì le autorizzazioni di tutte.

Il ruolo `owner` non può avere un ambito.

## Pagine correlate

- [Sicurezza dell'accesso alla dashboard](/docs/security/dashboard-access)
- [Isolamento dei dati tra ambienti](/docs/security/tenant-isolation)
