4 Token API
Panoramica
Questa sezione consente di creare e gestire i token API.
È possibile filtrare i token API per nome, utenti a cui i token sono assegnati, data di scadenza, utenti che hanno creato i token oppure stato (abilitato/disabilitato). Fare clic sullo stato del token nell'elenco per abilitare/disabilitare rapidamente un token. È inoltre possibile abilitare/disabilitare più token contemporaneamente selezionandoli nell'elenco e facendo quindi clic sui pulsanti Enable/Disable sotto l'elenco.
Per creare un nuovo token, premere il pulsante Create API token nell'angolo superiore destro, quindi compilare i campi richiesti nella schermata di configurazione del token:
| Parameter | Description |
|---|---|
| Name | Nome visibile del token. |
| User | Utente a cui il token deve essere assegnato. Per selezionare rapidamente un utente, iniziare a digitare il nome utente, il nome o il cognome, quindi selezionare l'utente richiesto dall'elenco di completamento automatico. In alternativa, è possibile premere il pulsante Select e selezionare un utente dall'elenco completo degli utenti. Un token può essere assegnato a un solo utente. |
| Description | Descrizione facoltativa del token. |
| Set expiration date and time | Deselezionare questa casella se un token non deve avere una data di scadenza. |
| Expiry date | Fare clic sull'icona del calendario per selezionare la data di scadenza del token oppure inserire manualmente la data nel formato YYYY-MM-DD hh:mm:ss |
| Enabled | Deselezionare questa casella se è necessario creare un token in stato disabilitato. |
Premere Add per creare un token.
Copiare il valore di Auth token e salvarlo in un luogo sicuro prima di chiudere la pagina, quindi premere Close. Il token apparirà nell'elenco.
Il valore di Auth token non può essere visualizzato di nuovo in seguito. È disponibile solo immediatamente dopo la creazione di un token. Se si perde un token salvato, sarà necessario rigenerarlo e così facendo verrà creata una nuova stringa di autorizzazione.
Fare clic sul nome del token per modificare il nome, la descrizione, le impostazioni della data di scadenza o lo stato del token. Si noti che non è possibile modificare l'utente a cui il token è assegnato. Premere il pulsante Update per salvare le modifiche. Se un token è stato perso o esposto, è possibile premere il pulsante Regenerate per generare un nuovo valore del token. Verrà visualizzata una finestra di dialogo di conferma che chiederà di confermare questa operazione, poiché dopo aver proceduto il token generato in precedenza diventerà non valido.
Gli utenti senza accesso alla sezione del menu Administration possono vedere e modificare i dettagli dei token assegnati a loro nella sola sezione User profile → API tokens se Manage API tokens è consentito nelle autorizzazioni del loro user role.