Utilisation des API

Partager
Dernière mise à jour :

Présentation de l’API de produit

Dans votre console KSAT, vous pouvez créer des jetons API de produit pour d’autres produits KnowBe4. Ces jetons API vous permettent de connecter KSAT à vos autres outils ou plateformes, comme PhishER. Par exemple, lorsque KSAT et PhishER sont connectés, vous pouvez authentifier votre compte KnowBe4 au moment où vous effectuez une requête API. Si vous êtes une organisation partenaire ou multicomptes, vous devez vous connecter avec le compte administrateur de gestion pour créer le jeton API de produit.

Créer un jeton API de produit

Pour créer un jeton API de produit, suivez les instructions suivantes :

Important :Nous vous recommandons de créer uniquement les jetons API dont vous avez besoin. Les jetons non utilisés ou non surveillés constituent un risque pour la sécurité en cas d’accès non autorisé.
  1. À partir de votre console KSAT, cliquez sur votre adresse courriel affichée dans le coin supérieur droit de la page et sélectionnez Paramètres du compte.
  2. Accédez à Intégrations du compte > API.

  3. Dans la section API de produit, cliquez sur API de produit. Le sous-onglet API de produit s’ouvrira.

  4. Dans le coin supérieur droit du sous-onglet API de produit, cliquez sur + Créer un nouveau jeton API.

  5. Remplissez les champs de la page Créer un nouveau jeton d’API. Pour plus d’informations, consultez la capture d’écran et la liste ci-dessous.

    1. Name (Nom) : Dans ce champ, saisissez un nom descriptif pour ce jeton API.
    2. Produits : Sélectionnez le produit avec lequel vous utiliser le jeton API.
    3. Étendues : Ce champ n’apparaîtra que si vous sélectionnez KSAT ou SecurityCoach. Sélectionnez les autorisations d’accès que vous souhaitez accorder à vos utilisateurs : Lecture seule, ou Lecture/écriture pour permettre les modifications.
    4. Date d’expiration : Sélectionnez la date à laquelle le jeton API doit expirer. Après son expiration, KSAT ne pourra plus envoyer de données au produit. Pour continuer à envoyer des données au produit, vous devrez créer un nouveau jeton API.
    5. Utilisateur : Dans ce menu déroulant, sélectionnez l’utilisateur responsable de la gestion de ce jeton API. Par exemple, vous pourriez sélectionner un utilisateur qui a un accès au produit en tant qu’administrateur.
    6. Statut : Activez ou désactivez le jeton API.
  6. Cliquez sur Créer le jeton. La fenêtre contextuelle Jeton API de produit s’ouvrira.

  7. Cliquez sur le jeton API de produit pour le copier. Assurez-vous d’enregistrer le jeton à un endroit facilement accessible. Lorsque vous aurez fermé la fenêtre, vous ne pourrez plus revoir ce jeton.

  8. Cliquez sur OK.

Une fois copié, vous pouvez utiliser le jeton API pour configurer une connexion dans vos autres produits KnowBe4. Pour plus d’informations, consultez les articles ci-dessous :

Gérer les jetons API de produit

Une fois le jeton API de produit créé, vous pourrez gérer le jeton dans le sous-onglet API de produit. Vous pouvez accéder à ce sous-onglet à partir de la section Intégrations du compte de la page Paramètres du compte.

Remarque :Après leur création, seuls les 10 derniers chiffres de vos jetons API de produit resteront visibles. Si vous perdez un jeton, vous devrez en créer un nouveau.

Pour en apprendre davantage sur les options de ce sous-onglet, veuillez vous reporter à la capture d’écran et à la liste ci-dessous :

  1. Clé : Cette colonne affiche un identifiant unique utilisé pour authentifier une requête API associée à votre console KSAT.
  2. Nom : Cette colonne affiche le nom personnalisé que vous avez attribué à votre jeton API lors de sa création.
  3. Produit : Cette colonne affiche le produit qui peut être connecté à la console KSAT avec votre jeton API.
  4. Utilisateur : Cette colonne affiche l’utilisateur responsable de la gestion de ce jeton API.
  5. Date d’expiration : Cette colonne affiche la date d’expiration de votre jeton API. Après son expiration, KSAT ne pourra plus envoyer de données au produit. Pour continuer à envoyer des données au produit, vous devrez créer un nouveau jeton API.
  6. Dernière utilisation : Cette colonne affiche la date à laquelle le jeton API a été utilisé la dernière fois.
  7. Statut : Cette colonne indique le statut du jeton API. Le statut peut être actif ou inactif.
  8. Actions : Cliquez sur la flèche déroulante dans la colonne de droite pour afficher les actions disponibles pour un jeton API de produit. Ces actions comprennent :
    • Modifier : Cliquez sur Modifier pour ouvrir la page Modifier le jeton API de produit, qui est semblable à la page Créer un nouveau jeton API. Modifiez les options à votre convenance, puis cliquez sur Mettre à jour le jeton pour enregistrer vos changements.
    • Supprimer : Cliquez sur Supprimer pour supprimer définitivement un jeton API de produit.

C’est article vous a-t-il été utile?

Utilisateurs qui ont trouvé cela utile : 6 sur 7