Skip to main content

​
Ce que cette intégration apporte

KnowBe4 peut fournir des résultats relatifs à l’effectif, à la formation et aux simulations d’hameçonnage. Voici des exemples examinés :
  • training.completed — termine une formation en sécurité
  • training.past.due — a une formation en retard
  • phishing.simulation.clicked — a cliqué sur une simulation sans la signaler
Ces exemples illustrent les types d’activité normalisée que Living Security peut utiliser. Consultez comment les données d’intégration deviennent des signaux.

​
Ce dont Living Security a besoin

Portées : Aucune à configurer — les jetons de l’API de rapports de KnowBe4 sont en lecture seule par conception et n’ont pas de portée. Le jeton accorde un accès en lecture aux utilisateurs, aux inscriptions aux formations et aux résultats des tests de sécurité par hameçonnage, ce qui correspond exactement à ce que lit la synchronisation. Rôle requis : Account Admin dans KnowBe4 (seuls les administrateurs de compte peuvent accéder à Account Settings → API)

​
Prérequis

  • Vous devez être connecté à votre console KnowBe4 avec le rôle Account Admin. Seuls les administrateurs de compte peuvent accéder à Account Settings → API pour activer l’API de rapports et générer des jetons.

​
Partie A — Dans KnowBe4

Votre administrateur KnowBe4 effectue ces étapes.
1

Activer l'API de rapports et générer un jeton

  1. Connectez-vous à votre console KnowBe4.
  2. Cliquez sur le nom de votre compte dans le coin supérieur droit, puis sélectionnez Account Settings.
  3. Dans la navigation de gauche, sélectionnez API.
  4. Activez la Reporting API si elle ne l’est pas déjà, puis générez un nouveau jeton d’API.
Donnez au jeton un objet descriptif (p. ex. Living Security Platform) si votre console vous en demande un.
KnowBe4 affiche la valeur du jeton d’API une seule fois, au moment de sa génération. Copiez-la immédiatement et conservez-la dans un emplacement sécurisé (p. ex. un coffre-fort de mots de passe ou un gestionnaire de secrets). Si vous quittez la page sans l’avoir copiée, vous devrez générer un nouveau jeton.
L’API de rapports est en lecture seule. Elle expose les utilisateurs, les inscriptions aux formations et les résultats des tests de sécurité par hameçonnage — les données que Living Security ingère pour la notation et la production de rapports. Aucun accès en écriture n’est requis.
2

Ajouter les adresses IP de sortie de Living Security à la liste Allowed IP Addresses

KnowBe4 vous permet de restreindre l’accès à l’API de rapports à un ensemble précis d’adresses IP sources. Ce paramètre se trouve au même endroit que le jeton :
  1. Dans votre console KnowBe4, accédez à Account Settings → API → Allowed IP Addresses.
  2. Ajoutez chaque adresse IP de sortie de Living Security à la liste d’autorisation. Les mêmes quatre adresses s’appliquent dans toutes les régions.
Si la liste Allowed IP Addresses est configurée, elle est appliquée au niveau du réseau. La boîte de dialogue de connexion réussira au moment de l’authentification, mais les synchronisations de données échoueront (bloquées au niveau du réseau, ce qui se manifeste généralement par un 403) tant que les adresses IP de sortie de Living Security n’auront pas été ajoutées à la liste d’autorisation. Si vous ajoutez une adresse à cette liste, vous devez également y ajouter les plages de Living Security; sinon, nos requêtes seront rejetées même si votre jeton est valide.
Les adresses IP de sortie de Living Security peuvent changer lors de mises à jour de l’infrastructure, bien que ces changements demeurent rares. Si les synchronisations de données se mettent à échouer après avoir fonctionné, consultez Configuration des adresses IP de sortie des intégrations et vérifiez que la liste Allowed IP Addresses correspond.
3

Identifier votre région de serveur KnowBe4

KnowBe4 fournit l’API de rapports à partir d’un hôte propre à chaque région. Vous sélectionnez votre région dans la boîte de dialogue de connexion plutôt que de saisir un nom d’hôte :Si vous ne savez pas quelle région votre compte utilise, vérifiez le domaine de l’URL de votre console KnowBe4 ou communiquez avec votre administrateur KnowBe4.
Ces cinq régions sont celles que Living Security peut joindre. Si votre compte KnowBe4 se trouve sur un autre serveur (par exemple une instance US Government), communiquez avec le soutien de Living Security avant de commencer la connexion.

​
Partie B — Dans la Living Security Platform

Le responsable du programme effectue cette étape, ou l’administrateur système en cas de configuration déléguée.
Vous êtes maintenant connecté à KnowBe4.

​
Dépannage

Le jeton d’API est invalide ou expiré. Vérifiez que le jeton est correct et qu’il n’a pas été régénéré sous Account Settings → API.
Soit le jeton n’a pas d’accès à l’API de rapports, soit l’adresse IP de la requête ne figure pas dans la liste Allowed IP Addresses. Vérifiez que l’API de rapports est activée et que les quatre adresses IP de sortie de Living Security figurent dans la liste d’autorisation.
L’API de rapports n’a peut-être pas encore de données à renvoyer, ou le compte associé au jeton n’a pas de visibilité sur les utilisateurs et les campagnes que Living Security ingère. Vérifiez que le jeton a été généré par un Account Admin.