4 Token API
Panoramica
Questa sezione consente di creare e gestire i token API.
I token API vengono usati per l'autenticazione nelle API di Zabbix.
A ogni token API viene assegnato un singolo utente e ne eredita i permessi.
Le richieste autenticate con un token API vengono autorizzate in base al ruolo e ai permessi dell'utente associato.
È 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 abilitarlo/disabilitarlo rapidamente. È inoltre possibile abilitare/disabilitare più token in blocco selezionandoli nell'elenco e facendo clic sui pulsanti Abilita/Disabilita sotto l'elenco.
Per creare un nuovo token, fare clic sul pulsante Crea token API nell'angolo in alto a destra, 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 fare clic sul pulsante Seleziona e scegliere 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 il 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 immettere manualmente la data nel formato YYYY-MM-DD hh:mm:ss |
| Enabled | Deselezionare questa casella se è necessario creare un token in stato disabilitato. |
Fare clic su Aggiungi per creare un token.
Copiare il valore Auth token e salvarlo in un luogo sicuro prima di chiudere la pagina, quindi fare clic su Chiudi. Il token apparirà nell'elenco.
Il valore 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 ciò creerà 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. Fare clic sul pulsante Aggiorna per salvare le modifiche. Se un token è stato perso o esposto, è possibile fare clic sul pulsante Rigenera per generare un nuovo valore del token. Verrà visualizzata una finestra di dialogo di conferma che chiederà di confermare l'operazione, poiché dopo aver proceduto il token generato in precedenza diventerà non valido.
Gli utenti senza accesso alla sezione del menu Amministrazione possono visualizzare e modificare i dettagli dei token assegnati a loro solo nella sezione Profilo utente → Token API sezione se Gestisci token API è consentito nei permessi del loro ruolo utente.