L’API de suivi des événements utilisateur vous permet d’importer les événements liés à la sécurité ou les activités de formation de vos utilisateurs à partir de sources externes et de les pousser dans votre console KSAT. Une fois importés, vos événements personnalisés apparaîtront dans la chronologie de l’utilisateur des utilisateurs affectés et pourront affecter leur note de risque personnelle.
Pour de plus amples informations sur l’API de suivi des événements utilisateur, ou pour obtenir des exemples de requêtes, consultez notre documentation pour les développeurs API de suivi des événements utilisateur pour les développeurs API de suivi des événements utilisateur pour les développeurs (s’ouvre dans une nouvelle fenêtre). Si vous décidez d’utiliser l’API de suivi des événements utilisateur de KnowBe4, consultez les sections ci-dessous pour apprendre comment gérer votre utilisation de l’API et savoir comment les événements personnalisés peuvent appuyer votre formation sur la sensibilisation à la sécurité.
Console de gestion de l’API d’événement d’utilisateur
La console de gestion de l’API d’événement d’utilisateur est un espace central d’où vous pouvez créer des clés API d’événement d’utilisateur, puis surveiller et suivre leur utilisation. Vous pouvez accéder à la console de gestion à partir de la section Intégrations du compte des Paramètres du compte, dans votre console KSAT. La console de gestion est répartie sur trois principaux onglets : Historique des appels, Stats et Clé API. Pour plus d’informations au sujet de chaque onglet, voir le tableau ci-dessous.
L’onglet Historique des appels, présente un tableau de tous les appels API traités par votre console KSAT.
| ID du statut | Clé API | Événements créés | Erreurs | Date de traitement |
|---|---|---|---|---|
| Un identifiant unique généré pour chaque appel API. | Le nom de la clé API utilisée pour faire l’appel API. | Le nombre d’événements utilisateur créés à la suite de l’appel API. | Toutes les erreurs reçues au cours de l’appel API. | La date et l’heure auxquelles la requête API a été traitée. Format : mm/jj/aaaa, h:mm a |
Accédez à l’onglet Stats pour surveiller votre utilisation mensuelle et annuelle de l’API.
- Quota mensuel : Ce graphique circulaire de progression illustre votre utilisation mensuelle de l’API. Le graphique représente le pourcentage des appels API réalisés par rapport au nombre d’appels autorisés. Vous avez droit à 10 appels par poste et par jour, chaque mois.
- Quota annuel : Ce graphique à barres illustre votre utilisation annuelle de l’API. Les données sont ventilées selon votre quota mensuel de chaque mois sur une période de 12 mois.
Utilisez l’onglet Clé API pour créer une ou plusieurs clés API. Votre clé API sera utilisée pour authentifier votre console KSAT lors d’un appel ou d’une requête API. Pour créer une clé API, suivez les instructions ci-dessous.
- Dans le champ Nom, saisissez un nom unique pour votre clé API. Si vous avez l’intention de créer plusieurs clés API, nous vous recommandons d’utiliser un nom significatif qui reflète l’utilisation prévue de la clé.
- Cliquez sur le bouton Créer la clé API. La fenêtre contextuelle Jeton API d’événements de l’utilisateur s’ouvrira.
- Cliquez sur le jeton API d’événements de l’utilisateur 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.
- Cliquez sur OK.
Répétez les étapes ci-dessus pour créer autant de clés API que vous le souhaitez. Une fois créées, toutes vos clés seront répertoriées dans un tableau sous l’onglet Clé API.
| Clé | Nom | Actions |
|---|---|---|
| Un identifiant unique utilisé pour authentifier une requête API associée à votre console KSAT. | Le nom personnalisé que vous avez attribué à votre clé API lors de sa création. |
Vous avez la possibilité de supprimer définitivement une clé API. Pour supprimer une clé, cliquez sur l’icône de la poubelle.
Remarque :Après la suppression d’une clé API, l’historique d’utilisation de la clé restera disponible sous l’onglet Historique des appels. |
Cas d’utilisation de l’API d’événement de l’utilisateur
Voici quelques exemples de l’utilisation d’événements personnalisés en appui à votre formation sur la sensibilisation à la sécurité. Pour créer un groupe intelligent incluant des événements personnalisés, consultez la section « Critères basés sur les événements personnalisés » de notre Aperçu des groupes intelligents.
| Type d’événement | Exemples d’événements | Cas d’utilisation |
|---|---|---|
| Sécurité physique |
|
Inscrivez des utilisateurs à une campagne de formation spécifique à un événement. Par exemple, vous pouvez assigner un module de formation à la sécurité physique du ModStore à tous les utilisateurs impliqués dans un événement lié à la sécurité physique. |
| Piratage psychologique |
|
Inscrivez des utilisateurs à une campagne d’hameçonnage personnalisée en fonction des renseignements personnels des employés. Par exemple, vous pouvez envoyer un modèle de courriel incluant un coupon de réduction pour un restaurant local à tous les utilisateurs qui fêtent leur anniversaire dans le mois. |
| Sécurité impliquant une tierce partie |
|
Suivez l’implication d’un utilisateur dans un incident de sécurité lié à une tierce partie. Vous pouvez ensuite utiliser cette information pour sélectionner du contenu de formation spécifique à l’événement dans le ModStore et y inscrire l’utilisateur. |
| Perfectionnement professionnel | Certifications et formations provenant d’un autre LMS | Suivez la formation effectuée à l’externe par un utilisateur et les réalisations qui contribuent à le sensibiliser à la sécurité. |