Comment créer une clé API¶
Pour créer une nouvelle clé API :
- Connectez-vous à votre compte.
- Depuis le tableau de bord principal, naviguez vers
Paramètres > Clés d'application. - Cliquez sur + Ajouter une clé. Le formulaire Ajouter une clé d'application s'ouvre.
- Dans la zone de texte Nom de la clé, entrez le nom souhaité pour la clé.
-
Dans le menu déroulant Rôle, choisissez ce que la clé est autorisée à atteindre :
- User — l'option par défaut. Accès en lecture à la plateforme, ainsi que les actions d'écriture qu'un utilisateur peut effectuer.
- Viewer — accès en lecture seule à la plateforme. Choisissez cette option pour une clé qui ne fait qu'interroger des données, comme un client de reporting ou le serveur MCP.
- Endpoint — enregistre les appareils auprès de la protection des postes de travail et n'accorde aucun autre accès, y compris aucun accès en lecture à la plateforme. Offert uniquement sur les comptes où la protection des postes de travail est activée. La page Installation de la protection des postes de travail est un raccourci pour en créer une : les jetons de déploiement qu'elle crée sont des clés Endpoint.
Les clés avec le rôle Data Upload sont créées et gérées par Boost Security pour des intégrations telles que l'Orchestration Zero Touch, et ne peuvent pas être créées depuis ce formulaire.
Le rôle d'une clé détermine ce qu'elle peut atteindre, choisissez donc le rôle le plus restreint qui couvre l'usage prévu de la clé. Consultez Rôles des clés API pour savoir ce que chaque rôle peut et ne peut pas faire.
-
Dans le menu déroulant Groupe d'actifs, associez la clé à Tous les actifs, l'option par défaut, qui donne à la clé accès à tous les actifs, ou à l'un de vos groupes d'actifs. Une clé associée à un groupe d'actifs ne peut accéder qu'aux données des actifs de ce groupe.
-
Dans le menu déroulant Expiration, choisissez la durée de validité de la clé : Jamais, 30 jours, 60 jours, 90 jours ou 1 an. Une durée est comptée à partir du moment où la clé est créée. La valeur par défaut, Jamais, crée une clé qui n'expire pas.
- Cliquez sur Enregistrer.
Une fois la clé créée, une nouvelle entrée s'affiche avec le nom de la clé sélectionné et l'icône du presse-papiers. Le presse-papiers permet de copier la valeur de la clé API afin que vous puissiez configurer votre scanner ou le client API GraphQL.
Note
C'est la seule fois où vous pouvez copier la valeur de la clé API. Lors de votre prochaine visite sur la vue Clés d'application, vous verrez le nom de la clé d'application, son expiration et sa date de création, mais vous ne pourrez pas récupérer la valeur de la clé.
L'expiration d'une clé peut être modifiée après la création de la clé, y compris pour une clé créée sans expiration. Voir Gestion de l'expiration des clés API.


