Guida per gli amministratori

Questa guida è destinata agli amministratori dell’organizzazione, ossia le persone responsabili di chi può accedere, di quali Team esistono e di come l’organizzazione collabora con i partner.

L’amministrazione si svolge su due interfacce:

DICE — l’applicazione vera e propria, in cui si svolge il lavoro quotidiano e gli amministratori dei Team gestiscono le Connessioni e la condivisione.
Il portale DUST Account — il sito per la gestione degli account in cui si trovano l’appartenenza all’organizzazione, i Team, gli inviti e le chiavi API. Aprilo da DICE tramite il menu utente (in alto a destra) → Gestione account.

Invitare gli utenti

Gli account utente e l’appartenenza all’organizzazione vengono gestiti nel portale DUST Account, non in DICE. I nuovi membri si uniscono tramite invito:

Apri il portale degli account (menu utente → Gestione account) e vai alla sezione Inviti della tua organizzazione.
Fai clic su Invita utente. Nella finestra di dialogo Crea invito, inserisci l’indirizzo email dell’invitato, scegli il suo ruolo nell’organizzazione (Membro o Amministratore) e, facoltativamente, assegnalo subito a un Team.
Fai clic su Invia invito. L’invitato riceve un’email contenente un collegamento Accetta invito.
L’invitato segue il collegamento, accede (o crea il proprio account DUST) e accetta. A quel punto compare nell’elenco dei membri della tua organizzazione.

Tieni presente quanto segue:

Gli inviti scadono dopo 48 ore. Dall’elenco degli inviti puoi reinviare un invito, aggiornandone la scadenza, oppure annullarne uno in sospeso.
Gli amministratori dell’organizzazione non possono creare autonomamente nuove organizzazioni: le organizzazioni vengono predisposte da DUST Identity.
I membri esistenti vengono gestiti dalla sezione Utenti dell’organizzazione: puoi modificare il ruolo di un membro o rimuoverlo dall’organizzazione.

Cosa vede un utente appena registrato

Un utente che accede a DICE prima di appartenere a un’organizzazione e a un Team arriva alla schermata di selezione del contesto. La schermata indica che il suo account non fa ancora parte di un’organizzazione o di un Team e mostra l’indirizzo email con cui ha effettuato l’accesso. Le azioni successive dipendono dal fatto che tu lo abbia già invitato o meno:

Lo hai invitato. L’invito compare in quella schermata sotto Inviti in sospeso, insieme all’organizzazione, al ruolo con cui entrerebbe e alla persona che lo ha inviato. L’utente fa clic su Accetta e DICE acquisisce automaticamente il nuovo accesso; Aggiorna serve a coprire i pochi secondi che la propagazione può richiedere. Invita le persone ad accettare l’invito visualizzato: non è necessario disconnettersi, accedere di nuovo o aprire una richiesta di assistenza.
L’invito è scaduto. Viene visualizzato come Scaduto · richiedi un nuovo invito. L’utente può usare Richiedi un nuovo invito per inviare una richiesta agli amministratori; tu puoi selezionare Reinvia invito nell’elenco degli inviti del portale degli account, rinnovandolo affinché possa essere accettato immediatamente.
Non lo hai invitato. La schermata invita l’utente a rivolgersi all’amministratore della propria organizzazione e offre l’opzione Contatta l’assistenza. Questo è l’unico caso in cui «contatta un amministratore» è il primo passo corretto.

È utile chiarire subito due aspetti ai nuovi utenti: gli inviti sono associati a un unico indirizzo email esatto, quindi devono accedere con l’indirizzo che hai invitato; inoltre, una volta che appartengono a un’organizzazione, gli eventuali inviti successivi compaiono sotto Inviti nel menu utente di DICE anziché in questa schermata.

Consulta anche le domande frequenti.

Team

Tutto ciò che un utente fa in DICE avviene nel contesto di un’organizzazione e di un Team: schede, cartelle, spedizioni e altri dati appartengono a un Team e gli utenti cambiano contesto dall’intestazione. Per usare DICE, un utente deve appartenere ad almeno un Team.

Anche la gestione dei Team si trova nel portale degli account, nella sezione Team della tua organizzazione:

Crea un Team — riservato agli amministratori dell’organizzazione («Solo gli amministratori dell’organizzazione possono creare Team»). Un Team richiede soltanto un nome.
Aggiungi membri — selezionali tra i membri esistenti dell’organizzazione cercando per nome o indirizzo email. Invita prima le persone nell’organizzazione, quindi aggiungile ai Team.
Ruoli del Team — ogni membro del Team è un Membro («Accesso standard al Team») oppure un Amministratore («Gestisci i membri del Team»). Gli amministratori dei Team possono gestire l’appartenenza al proprio Team senza disporre dei diritti di amministratore dell’organizzazione.
Editore — un’autorizzazione aggiuntiva relativa all’appartenenza a un Team, concessa da un amministratore del Team. Non costituisce un terzo livello gerarchico superiore a Membro: un membro può avere o non avere questa autorizzazione, mentre gli amministratori dei Team la possiedono sempre. Il ruolo di Editore controlla la possibilità di rendere pubblici i dati del Team: ogni modifica nel modulo Pagine pubbliche — creazione e pubblicazione dei design, pubblicazione o rimozione dalla pubblicazione di una pagina, distribuzione di una versione, esecuzione o annullamento di una pubblicazione in blocco — lo richiede. I membri che ne sono privi possono comunque aprire il modulo e consultare i design, la cronologia delle versioni, le pagine pubblicate e l’attività delle pagine. Anche gli account di servizio possono ricevere questa autorizzazione, consentendo a un’integrazione di pubblicare senza l’intervento diretto di una persona.
Rinomina o rimuovi — dalle impostazioni del Team.

Gli amministratori dei Team dispongono inoltre di funzionalità aggiuntive all’interno di DICE: la sezione di amministrazione del Team nella barra laterale, ad esempio Connessioni, compare soltanto per gli amministratori del Team attivo.

Configurare la collaborazione tra organizzazioni

La collaborazione con un’altra organizzazione inizia con una Connessione tra uno dei tuoi Team e uno dei suoi. Stabilire una connessione è un’attività amministrativa: la procedura di conferma viene eseguita dagli amministratori dei Team di entrambe le parti. Consulta Connessioni per il flusso completo, inclusa la direzione della connessione, che determina chi può inviare e chi può ricevere.

Dopo la conferma di una connessione:

I Team possono condividere schede e cartelle con il Team partner; consulta Condivisione e accesso.
I Team possono inviare Spedizioni per trasferire schede all’organizzazione partner, quando la direzione della connessione lo consente.

Disponibilità dei moduli

DICE è modulare. Funzionalità quali Spedizioni, Certificati, Vlink, Suddivisione, Pagine pubbliche, Connessioni e Condivisione vengono abilitate per ciascuna organizzazione da DUST Identity: non sono opzioni che un amministratore dell’organizzazione può attivare o disattivare nel prodotto.

Quando un modulo è disabilitato per la tua organizzazione, le relative voci di navigazione sono completamente nascoste; gli utenti non vedranno alcuna voce bloccata o disattivata. Se il tuo team chiede «dov’è la funzionalità X?», verifica che il modulo sia abilitato prima di proseguire con la risoluzione dei problemi.

Per modificare i moduli abilitati per la tua organizzazione, contatta support@dustidentity.com.

Accesso API

L’accesso programmatico alla piattaforma DUST utilizza gli account di servizio, ossia identità macchina di proprietà della tua organizzazione, gestiti nel portale degli account (pagina dell’organizzazione → scheda Account di servizio). Un account di servizio appartiene esattamente a un’organizzazione, può ricevere l’accesso ai Team come un membro e ogni azione che esegue gli viene attribuita nella cronologia delle attività. La creazione e la gestione degli account di servizio richiedono entrambe le condizioni seguenti:

Sei un amministratore dell’organizzazione e
Gli account di servizio sono abilitati per tale organizzazione da DUST Identity. Se non lo sono, la scheda mostra un messaggio che invita a contattare support@dustidentity.com per richiedere l’accesso.

Ogni account di servizio può disporre di chiavi API e/o di un client OAuth per client_credentials. I segreti delle credenziali vengono mostrati una sola volta al momento della creazione: copiali immediatamente. Più credenziali possono essere attive contemporaneamente, quindi la rotazione non richiede tempi di inattività; nel portale è visibile l’ora dell’ultimo utilizzo di ciascuna credenziale. La disabilitazione di un account di servizio gli impedisce immediatamente di ottenere nuovi token.

Ai fini della tracciabilità, i criteri di attribuzione dell’operatore di un account di servizio possono essere impostati come obbligatori, imponendo alle operazioni di scrittura eseguite tramite API di dichiarare quale persona ha avviato ogni azione, ad esempio mediante l’identificativo di un badge del reparto di produzione; consulta Autenticazione API.

Consulta Autenticazione API per sapere come autenticare le richieste API e Ambienti per gli URL degli ambienti.

Riferimento rapido

Attività	Dove
Invitare un utente, gestire membri e ruoli	Portale DUST Account → organizzazione → Utenti / Inviti
Creare Team e gestire l’appartenenza ai Team	Portale DUST Account → organizzazione → Team
Connettersi con un’organizzazione partner	DICE → Connessioni (amministratori dei Team; consulta Connessioni)
Condividere schede o cartelle tra Team	DICE (consulta Condivisione e accesso)
Abilitare o disabilitare i moduli	Contatta support@dustidentity.com
Account di servizio e credenziali API	Portale DUST Account → organizzazione → Account di servizio (consulta Autenticazione API)

Segnala un problema nella documentazione