Retour

Créer des clés API pour Fleet

Une clé API Fleet te permet de communiquer directement avec ton instance Fleet. Utilises-en une pour exécuter des scripts, récupérer des données sur les appareils ou connecter Fleet à d'autres outils.


 

Fonctionnement

Aperçu

Les clés API Fleet (FleetDM) authentifient les requêtes envoyées directement à ton instance Fleet. Tu peux les créer de trois façons :

  • Depuis Factorial IT, sous la forme d'une clé en lecture seule.
  • Depuis le tableau de bord Fleet, sous la forme d'un jeton lié à ton compte utilisateur Fleet.
  • Depuis la ligne de commande, avec la CLI Fleet ou l'API Fleet.

Les jetons API Fleet n'expirent jamais d'eux-mêmes.


 

Créer une clé depuis Factorial IT

  1. Va dans Paramètres > Développeurs et fais défiler jusqu'à la section Clé API FleetDM.
  2. Saisis un Nom de clé, par exemple le nom de l'outil qui utilisera la clé.
  3. Clique sur Générer la clé.
  4. Copie le jeton affiché dans la fenêtre Clé API FleetDM créée. Il reste ensuite disponible dans le tableau des clés.

Les clés créées depuis Factorial IT sont en lecture seule. Elles peuvent consulter chaque appareil et ses données, mais ne peuvent ni modifier les paramètres ni exécuter d'actions sur les appareils. Elles conviennent aux intégrations externes qui ont seulement besoin de lire ton instance Fleet.

Pour révoquer une clé, ouvre le menu ⋯ sur sa ligne dans le tableau Clé API FleetDM et clique sur Révoquer. Toute intégration qui l'utilise cesse immédiatement de fonctionner.

Garde le jeton secret. Toute personne qui le possède peut lire ton inventaire d'appareils.


 

Créer une clé depuis le tableau de bord Fleet

  1. Ouvre ton tableau de bord Fleet depuis la console via Paramètres > MDM > Ouvrir Fleet.
  2. Clique sur ton avatar en haut à droite et sélectionne Mon compte.
  3. Fais défiler jusqu'à Jeton API.
  4. Clique sur Obtenir le jeton API.
  5. Copie le jeton. Il appartient à ton compte utilisateur Fleet.

Ce jeton a les mêmes autorisations que ton compte utilisateur Fleet. Garde-le secret.


 

Créer une clé depuis la ligne de commande

Avec la CLI Fleet :

fleetctl login --email ton-adresse@exemple.com --url https://[ton-instance-fleet]
fleetctl get api-token

Ou directement via l'API Fleet :

curl -X POST https://[ton-instance-fleet]/api/v1/fleet/users/[id-utilisateur]/api_token \
  -H "Authorization: Bearer TON_JETON_EXISTANT" \
  -H "Content-Type: application/json"

 

Utiliser la clé

Envoie le jeton dans l'en-tête Authorization :

curl https://[ton-instance-fleet]/api/v1/fleet/hosts \
  -H "Authorization: Bearer TON_JETON_API_FLEET"

 

Régénérer ou révoquer un jeton

  • Clé créée depuis Factorial IT : va dans Paramètres > Développeurs > Clé API FleetDM, ouvre le menu ⋯ sur sa ligne et clique sur Révoquer.
  • Jeton lié à ton compte utilisateur Fleet : dans Fleet, va dans Mon compte et clique sur Régénérer le jeton API. L'ancien jeton cesse immédiatement de fonctionner.

 

Conseils et bonnes pratiques

  • Crée une clé par intégration. Donne-lui le nom de l'outil pour savoir ce qui cesse de fonctionner quand tu la révoques.
  • Privilégie les clés de Factorial IT pour les intégrations en lecture seule. Elles ne peuvent ni modifier les paramètres ni agir sur les appareils.
  • Prévois ta propre rotation. Les jetons n'expirent jamais : révoque-les ou régénère-les selon un calendrier.
  • Ne partage jamais un jeton. Toute personne qui le détient peut lire ton inventaire d'appareils, voire davantage avec un jeton utilisateur.

 

Résolution des problèmes et FAQ

Résolution des problèmes

  • Une intégration a cessé de fonctionner. Sa clé a peut-être été révoquée, ou le jeton utilisateur régénéré. Crée une nouvelle clé et mets à jour l'intégration.
  • Une requête de modification des paramètres ou d'exécution d'une action échoue. Les clés créées depuis Factorial IT sont en lecture seule. Utilise un jeton lié à un compte utilisateur Fleet disposant des bonnes autorisations.
  • Tu as perdu le jeton. Pour une clé créée depuis Factorial IT, retrouve-la dans le tableau des clés. Pour un jeton utilisateur, régénère-le dans Mon compte dans Fleet.

 

FAQ

  1. Les jetons API Fleet expirent-ils ?
    Non. Ils restent valides jusqu'à ce que tu les révoques ou les régénères.
     
  2. Que peut faire une clé créée depuis Factorial IT ?
    Lire chaque appareil et ses données. Elle ne peut ni modifier les paramètres ni exécuter d'actions sur les appareils.
     
  3. Quelles autorisations a un jeton du tableau de bord Fleet ?
    Les mêmes que ton compte utilisateur Fleet.
     
  4. Que se passe-t-il quand je révoque une clé ?
    Toute intégration qui l'utilise cesse immédiatement de fonctionner.

Cet article vous a-t-il aidé ?

Give feedback about this article

Vous ne trouvez pas ce que vous cherchez ?

Notre équipe de service client est là pour vous.

Nous contacter

Knowledge Base Software powered by Helpjuice