Fleet (FleetDM) Le chiavi API ti consentono di interagire direttamente con l’istanza Fleet, ad esempio per eseguire script, interrogare i dati del dispositivo o integrarsi con altri strumenti.
È possibile creare chiavi Fleet API direttamente da Primo o tramite il dashboard Fleet.
Genera una chiave Fleet API da Primo
- Vai a Impostazioni > Sviluppatori > Chiavi Fleet API.
- Fare clic su Crea chiave API.
- Assegna un nome alla chiave e configura le autorizzazioni.
- Fare clic su Crea.
- Copia immediatamente il token: non verrà più mostrato.
Mantieni segreto il tuo token Fleet API e non condividerlo. Ha le autorizzazioni configurate durante la creazione.
Genera una chiave Fleet API dal dashboard Fleet
- Apri il dashboard Fleet (accessibile dal pannello di controllo Primo tramite Impostazioni > MDM > Apri Fleet).
- Fai clic sul tuo avatar nell’angolo in alto a destra e vai su Il mio account.
- Scorri fino a Token API.
- Fai clic su Ottieni token API.
- Copia il token: è legato al tuo account utente Fleet.
Il tuo token Fleet API ha le stesse autorizzazioni del tuo account utente Fleet. Mantienilo segreto e non condividerlo.
Genera una chiave Fleet API dalla CLI
È inoltre possibile creare chiavi Fleet API a livello di programmazione utilizzando la CLI Fleet:
fleetctl login --email your-email@example.com --url https://<your-fleet-instance>
fleetctl get api-token
Oppure crea una chiave API direttamente tramite Fleet API:
curl -X POST https://<your-fleet-instance>/api/v1/fleet/users/<user-id>/api_token \
-H "Authorization: Bearer YOUR_EXISTING_TOKEN" \
-H "Content-Type: application/json"
Utilizzare la chiave Fleet API
Passa il token nell’intestazione Authorization:
curl https://<your-fleet-instance>/api/v1/fleet/hosts \
-H "Authorization: Bearer YOUR_FLEET_API_TOKEN"
Rigenera o revoca un token
Fleet I token API non scadono automaticamente. Per revocare l’accesso, vai su Il mio account in Fleet e fai clic su Rigenera token API. Ciò invalida immediatamente il token precedente.