Creare e gestire i token di accesso Diligent One

È possibile creare o gestire i token di accesso personali Diligent One nella pagina Gestisci i token API, disponibile tramite la pagina profilo di Launchpad.

Cos'è un token di accesso?

Un token di accesso è una stringa che identifica un utente e autentica l'accesso ad altre applicazioni.

Il token di accesso che si richiede dipende da cosa si deve fare:

• Importare i dati di Progetti Diligent One su Analytics: token API Analytics o HighBond
• Importare i dati di Risultati Diligent One su Analytics: token API Analytics o HighBond
• Esportare i dati di Risultati Diligent One su Analytics: token API Analytics o HighBond
• Ottienere l'accesso programmatico a Diligent One: token API HighBond
• Ottenere l'accesso programmatico a Log di attività Launchpad: token API Log di attività

  Nota

  L'accesso ai log di attività Launchpad è disponibile solamente agli Amministratori di sistema.

Token Analytics

Il token Analytics è generato automaticamente ogni volta che attivi Analytics e viene conservato nel registro.

• Se stai utilizzando Analytics 14 o una versione inferiore, e crei manualmente un Token di accesso ACLGRC, il token viene categorizzato su Launchpad come un tipo di token Analytics.
• Se si sta utilizzando Analytics 14.1 e si crea manualmente un Token di accesso Diligent One, il token viene categorizzato su Launchpad come tipo di token Analytics.

Come funziona

In Launchpad, la pagina Gestisci i token API visualizza tutti i token di accesso che hai generato.

Puoi utilizzare la pagina Gestisci i token API per:

• copiare i tuoi token
• fornire un'etichetta per descrivere o identificare i token di accesso
• bloccare i token di accesso per impedire che vengano modificati o eliminati
• eliminare i token di accesso

Autorizzazioni

Ogni utente può creare un token Analytics. Occorre essere Amministratore di sistema in almeno un'istanza Diligent One per creare un token API HighBond o API Log di attività.

Tutti gli utenti possono gestire i loro token di accesso.

Creare token di accesso.

1. Apri Launchpad.

Nota

Se l'azienda utilizza più di un'istanza su Diligent One, assicurarsi che quella appropriata sia attiva.

2. Selezionare > Profilo.
3. Vicino a Token di applicazione, fare clic su Gestisci. Si apre la pagina Gestisci token API.
4. Fare clic su + Aggiungi token e selezionare l'opzione appropriata dall'elenco a discesa (ad esempio, HighBond API, Analytics o API Log attività). Appare un pannello laterale Nuovo token.
5. Compila i campi nel pannello laterale per creare un token.

   Nota

   Sono richiesti tutti i campi per creare un token incluso quello Descrizione. L'unica eccezione è se sta scegliendo di non includere una scadenza del token. In quel caso, non occorre compilare il numero dei giorni dopo cui un token deve scadere, visto che sarebbe predefinito su Mai.

   1. Inserisci una descrizione.

      Consiglio

      Nella descrizione, includere tutti i luoghi dove verrà utilizzato questo token e il suo proposito. Il motivo per fare ciò è che i token devono essere sostituiti quando scadono e aggiungere una descrizione dettagliata risparmia tempo e sforzo una volta che deve essere sostituito.

   2. Facoltativo. Abilitare o disabilitare la scadenza del token.

      Nota

      La capacità di impostare una scadenza del token deve essere abilitata (attivata) per impostazione predefinita. Se è disabilitata, il token non scadrà mai.

   3. Inserisci il numero di giorni dopo cui il token deve scadere fino a un massimo di un anno (365 giorni) dalla data della sua creazione-
   4. Inserire la password dell'account Diligent One per verificare l'identità.
6. Fare clic su Genera token. Il pannello laterale si aggiorna con un messaggio che conferma che il tuo token si è generato correttamente e include l'ID del token, la data di scadenza (la data e l'ora in cui il token scadrà) e la Descrizione.
7. Fare clic su Copia. Un messaggio Copiato negli appunti conferma che il token è stato copiato correttamente.

   Attenzione

   Salvare il token prima di chiudere il pannello laterale. Per motivi di sicurezza, sarà l'unica occasione per averne accesso. Se non si salva il token e lo si dimentica, occorrerà crearne uno nuovo.
8. Fare clic su Chiudi. Si chiude il pannello laterale Nuovo token.
9. Copia il token in un'applicazione o uno script.

   Nota

   Trattare il token come una password e non condividerlo con altre persone.

Gestire i token API

Dalla pagina Gestisci i token API, è possibile trovare token esistenti, modificare le descrizioni dei token, bloccare i token così che non possano essere modificati o eliminati ed eliminare i token.

1. Apri Launchpad.

Nota

Se l'azienda utilizza più di un'istanza su Diligent One, assicurarsi che quella appropriata sia attiva.

2. Selezionare  > Profilo.
3. Vicino a Token di applicazione, fare clic su Gestisci. Si apre la pagina Gestisci token API.
4. Complete una qualsiasi delle seguenti azioni.

Revisionare i token di accesso

Per localizzare i token, è possibile cercare, ordinare e filtrare per trovare token specifici. Eseguire una delle seguenti operazioni:

• Cerca token: inserirei i primi caratteri del token di accesso (fino a sette caratteri) nella barra di ricerca. Questo restituisce un elenco ridotto dei risultati.
• Ordina token: fai clic su una qualsiasi delle intestazioni della colonna per ordinare i token per la colonna scelta in ordine crescente o decrescente.
• Filtra token: per impostazione predefinita, si visualizzano tutti i token generati. Tuttavia, puoi filtrare l'elenco dei token a un sottoinsieme come se un token è bloccato o per tipo di token: Analytics, Log di attività o API HighBond. Seleziona i filtri desiderati dall'elenco a discesa disponibile per filtrarne l'elenco. Fai clic su Cancella per rimuovere tutti i filtri.

Modificare la descrizione di un token di accesso

1. Fai clic sulla matita . Il campo Descrizione diventa modificabile in linea.
2. Apporta aggiornamenti alla descrizione e fai clic sul segno di spunta per salvare le modifiche. La descrizione aggiornata appare nella tabella.

Bloccare o sbloccare i token di accesso

Se vuoi evitare che i token vengano eliminati e le descrizioni modificate, puoi bloccarli. In alternativa, puoi sbloccare i token per modificare le descrizioni e abilitare l'eliminazione.

• Fai clic sul lucchetto aperto vicino al token per disabilitare l'eliminazione dei token e la modifica delle descrizioni. Il lucchetto appare chiuso per indicare che il token non può essere modificato o eliminato. Scompaiono anche la matita e il cestino .
• Fai clic sul lucchetto chiuso per sbloccare il token per abilitare l'eliminazione dei token e la modifica delle descrizioni. Il lucchetto apparirà aperto per indicare che la modifica e l'eliminazione sono abilitate. Riappaiono anche la matita e il cestino .

Eliminare i token di accesso

Puoi eliminare token singoli, più token alla volta o tutti i token nell'elenco. Se non devi mantenere i token precedenti per referenza, puoi eliminarli per rimuovere disordine dall'elenco dei token. Tuttavia, qualunque decisione di eliminare i token dovrebbe essere affrontata con cautela e fatta solamente quando è stato confermato che il token non è più in uso da nessuna parte, in quanto l'eliminazione è definitiva e non può essere annullata.

Eliminare un singolo token

1. Fai clic sul cestino vicino al token. Appare una finestra di dialogo Eliminare # token? per confermare l'eliminazione.
2. Fare clic su Elimina token. Il token viene eliminato definitivamente e rimosso dall'elenco.

Attenzione

L'eliminazione di un token è definitiva e non può essere annullata. Qualora venga eliminato un token in uso, qualsiasi processo che lo utilizza non riuscirà. Se un token viene eliminato per errore, dovrà essere ricreato e introdotto nuovamente nell'applicazione o nello script interessato.

Eliminare più token

1. Fai clic sulle caselle di controllo vicine ai token che vuoi eliminare. Appare un pulsante rosso sopra l'elenco dei token che indica il numero di quelli da eliminare.
2. Fare clic su Elimina # token. Appare una finestra di dialogo Eliminare # token? per confermare l'eliminazione.
3. Fare clic su Elimina token. I token vengono eliminati definitivamente e rimossi dall'elenco.

Attenzione

L'eliminazione di un token è definitiva e non può essere annullata. Qualora venga eliminato un token in uso, qualsiasi processo che lo utilizza non riuscirà. Se un token viene eliminato per errore, dovrà essere ricreato e introdotto nuovamente nell'applicazione o nello script interessato.

Eliminare tutti i token

1. Seleziona la casella di controllo vicino all'icona informazioni . Questo seleziona automaticamente tutti i token dell'elenco e appare un pulsante rosso sopra l'elenco dei token che indica il numero di quelli da eliminare.
2. Fare clic su Elimina # token. Appare una finestra di dialogo Elimina # token? per confermare l'eliminazione.
3. Fare clic su Elimina # token. I token vengono eliminati definitivamente e rimossi dall'elenco.

Attenzione

L'eliminazione di un token è definitiva e non può essere annullata. Qualora venga eliminato un token in uso, qualsiasi processo che lo utilizza non riuscirà. Se un token viene eliminato per errore, dovrà essere ricreato e introdotto nuovamente nell'applicazione o nello script interessato.

Affrontare i token in scadenza

Verranno inviato diversi promemoria fino a quando il token viene eliminato o scade. I creatori di token riceveranno e-mail di notifica 30 giorni, 5 giorni e 1 giorno prima della data di scadenza di un token. Verrà inviata anche un'e-mail di notifica una volta che il token scade. Una volta che un token scade, tutti i processi che dipendono dal token non riusciranno, a meno che non si sostituisca con uno nuovo.

Sostituire un token in scadenza con uno nuovo

Per evitare la non riuscita dei processi, i token in scadenza e scaduti devono essere sostituiti da nuovi. Per aggiornare un token, dovrai crearne uno nuovo. Consultare Creare token di accesso. Una volta che un nuovo token viene creato, localizza tutte le istanze che utilizzano quello in scadenza e sostituiscilo con quello appena creato.

Eliminare un token in scadenza

Elimina un token in scadenza per smettere di ricevere notifiche in merito a una prossima scadenza e per rimuovere ogni token a cui non devi più fare riferimento. Consulta Eliminare i token di accesso.