Utilisation d’API

Partager
Dernière mise à jour :

Présentation de l’API de produit

Dans votre console KSAT, vous pouvez créer des jetons d’API pour d’autres produits KnowBe4. Ces jetons d’API vous permettent de connecter KSAT à vos autres outils ou plateformes, tels que PhishER. Par exemple, en connectant KSAT et PhishER, vous pouvez authentifier votre compte KnowBe4 pour chaque requête API. Si vous êtes un partenaire ou une organisation titulaire de plusieurs comptes, vous devez vous connecter au compte administrateur pour créer le jeton d’API de produit.

Créer un jeton d’API de produit

Pour créer un jeton d’API de produit, procédez comme suit :

Important : nous vous recommandons de créer uniquement les jetons d’API dont vous avez besoin. Les jetons inutilisés et non surveillés représentent un risque de sécurité s’ils sont consultés par une personne non autorisée.
  1. Dans votre console KSAT, cliquez sur votre adresse e-mail dans l’angle supérieur droit de la page, puis 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’ouvre alors.

  4. Dans l’angle supérieur droit du sous-onglet API de produit, cliquez sur + Créer un nouveau jeton d’API.

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

    1. Nom : saisissez dans ce champ un nom descriptif pour ce jeton d’API.
    2. Produits : sélectionnez le produit que vous souhaitez utiliser pour ce jeton d’API.
    3. Portées : ce champ ne s’affiche que si vous sélectionnez KSAT ou SecurityCoach. Indiquez si vos utilisateurs doivent avoir un accès en Lecture seule ou des droits de modification Lecture/Écriture.
    4. Date d’expiration : sélectionnez la date à laquelle le jeton d’API doit expirer. Au-delà de cette date, 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 d’API.
    5. Utilisateur : dans ce menu déroulant, sélectionnez l’utilisateur responsable de la gestion de ce jeton d’API. Vous pouvez, par exemple, sélectionner un utilisateur disposant d’un accès administrateur au produit.
    6. Statut : activez ou désactivez le jeton d’API.
  6. Cliquez sur Créer un jeton. La fenêtre contextuelle Jeton d’API de produit s’ouvre alors.

  7. Cliquez sur le jeton d’API de produit pour le copier. Assurez-vous de copier votre jeton d’API à un endroit auquel vous pourrez accéder facilement. Une fois la fenêtre fermée, vous ne pourrez plus accéder à 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 en savoir plus, consultez les articles ci-dessous :

Gérer les jetons d’API de produit

Une fois que vous avez créé un jeton d’API de produit, vous pouvez le gérer depuis le sous-onglet API de produit. Ce sous-onglet est accessible depuis la section Intégrations du compte de la page Paramètres du compte.

Remarque : vous pouvez uniquement afficher les 10 derniers chiffres de vos jetons d’API de produit une fois qu’ils ont été créés. Si vous perdez un jeton, vous devrez en créer un nouveau.

Pour en savoir plus sur les options disponibles dans ce sous-onglet, consultez la capture d’écran et la liste ci-dessous :

  1. Clé : cette colonne affiche un identifiant unique utilisé pour authentifier une demande d’API associée à votre console KSAT.
  2. Nom : cette colonne affiche le nom personnalisé que vous avez attribué à votre jeton d’API lors de sa création.
  3. Produit : cette colonne indique quel produit peut être connecté à la console KSAT à l’aide de votre jeton d’API.
  4. Utilisateur : cette colonne indique quel utilisateur gère ce jeton d’API.
  5. Date d’expiration : cette colonne indique la date d’expiration de votre jeton d’API. Au-delà de cette date, 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 d’API.
  6. Dernière utilisation : cette colonne indique la dernière date à laquelle le jeton d’API a été utilisé.
  7. Statut : cette colonne affiche le statut du jeton d’API  (Activé ou Désactivé).
  8. Actions : cliquez sur la flèche du menu déroulant située dans la colonne la plus à droite pour consulter les actions disponibles pour un jeton d’API de produit. Parmi les actions proposées :
    • Modifier : cliquez sur Modifier pour ouvrir la page Modifier le jeton d’API de produit, qui ressemble beaucoup à la page Créer un nouveau jeton d’API. Modifiez les options selon vos besoins, puis cliquez sur Mettre à jour le jeton pour enregistrer vos modifications.
    • Supprimer : cliquez sur Supprimer pour supprimer définitivement un jeton d’API de produit.

Avez-vous trouvé cet article utile ?

Utilisateurs qui ont trouvé cela utile : 6 sur 7