Les clés Fleet (FleetDM) API vous permettent d’interagir directement avec votre instance Fleet, par exemple pour exécuter des scripts, interroger les données de l’appareil ou intégrer d’autres outils.
Vous pouvez créer des clés Fleet API directement depuis Primo ou via le tableau de bord Fleet.
Générer une clé Fleet API à partir de Primo
- Accédez à Paramètres > Développeurs > Clés Fleet API.
- Cliquez sur Créer une clé API.
- Donnez un nom à la clé et configurez les autorisations.
- Cliquez sur Créer.
- Copiez le jeton immédiatement : il ne sera plus affiché.
Gardez votre jeton Fleet API secret et ne le partagez pas. Il dispose des autorisations que vous avez configurées lors de la création.
Générer une clé Fleet API à partir du tableau de bord Fleet
- Ouvrez votre tableau de bord Fleet (accessible depuis le cockpit du Primo via Paramètres > MDM > Ouvrir Fleet).
- Cliquez sur votre avatar dans le coin supérieur droit et accédez à Mon compte.
- Faites défiler jusqu’à Jeton API.
- Cliquez sur Obtenir le jeton API.
- Copiez le jeton : il est lié à votre compte utilisateur Fleet.
Votre jeton Fleet API dispose des mêmes autorisations que votre compte utilisateur Fleet. Gardez-le secret et ne le partagez pas.
Générer une clé Fleet API à partir de CLI
Vous pouvez également créer des clés Fleet API par programme à l’aide de la CLI Fleet :
fleetctl login --email your-email@example.com --url https://<your-fleet-instance>
fleetctl get api-token
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"
Utilisez la clé Fleet API
Passez le token dans l’en-tête Authorization :
curl https://<your-fleet-instance>/api/v1/fleet/hosts \
-H "Authorization: Bearer YOUR_FLEET_API_TOKEN"
Régénérer ou révoquer un jeton
Les jetons Fleet API n’expirent pas automatiquement. Pour révoquer l’accès, accédez à Mon compte dans Fleet et cliquez sur Régénérer le jeton API. Cela invalide immédiatement le jeton précédent. 
