L’interface de programmation d’application (API) de rapports de KnowBe4, réservée aux clients Platine et Diamant, permet d’extraire des données de la console KSAT pour la création de rapports. Pour le moment, cette fonctionnalité est limitée aux demandes de données sur l’hameçonnage, la formation, les utilisateurs et les groupes. Lors de l’utilisation de l’API, vous devez vous authentifier auprès de celle-ci à l’aide d’une clé spécifique au compte.

Pour de plus amples détails sur l’API de rapports, ainsi que pour obtenir des exemples, consultez notre documentation l’API de rapports pour les développeurs. L’API de KnowBe4 est une API REST. En utilisant l’API de KnowBe4, vous acceptez nos Conditions d’utilisation.

Créer un jeton d’API de rapports

Pour créer un jeton d’API de rapports, suivez les étapes suivantes :

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. Sous API de rapport, activez l’option Activer l’accès à l’API de rapport.
4. Cliquez sur API de rapports. Le sous-onglet API de rapports s’ouvrira.
5. Dans le coin supérieur droit du sous-onglet API de rapports, cliquez sur + Créer un nouveau jeton API.
6. 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. Nom : Dans ce champ, saisissez un nom descriptif pour ce jeton d’API.
   2. Statut : Activez ou désactivez le jeton d’API.
   
7. Cliquez sur Créer le jeton. La fenêtre contextuelle Jeton d’API de rapports s’ouvrira.
8. Cliquez sur le jeton d’API de rapports pour le copier. Assurez-vous d’enregistrer le jeton copié à un endroit facilement accessible. Lorsque vous aurez fermé la fenêtre, vous ne pourrez plus accéder à ce jeton.
9. Cliquez sur OK.

Une fois le jeton copié, vous pouvez l’utiliser pour extraire des données de la console KSAT à des fins de production de rapports.

Gérer les jetons d’API de rapports

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

Pour en savoir plus sur les options disponibles dans ce sous-onglet, veuillez poursuivre votre lecture :

1. Clé : Cette colonne affiche un identifiant unique utilisé pour authentifier la requête 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. Généré par : Cette colonne affiche l’adresse courriel associée à l’utilisateur ayant généré le jeton d’API.
4. Généré le : Cette colonne affiche la date à laquelle le jeton d’API de rapports a été généré.
5. Statut : Cette colonne indique le statut du jeton d’API. Le statut peut être actif ou inactif.
6. Actions : Cliquez sur la flèche déroulante dans la colonne de droite pour afficher les actions disponibles pour un jeton d’API de rapports. Ces actions comprennent :
   • Modifier : Cliquez sur Modifier pour ouvrir la page Modifier le jeton d’API de rapports, qui est semblable à la page Créer un nouveau jeton d’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 d’API de rapports.