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 quelques 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 la manière dont les données d’intégration deviennent des signaux.

​
Ce dont Living Security a besoin

Portées : aucune à configurer — les jetons de l’API Reporting de KnowBe4 sont en lecture seule par conception et ne sont associés à aucune portée. Le jeton donne un accès en lecture aux utilisateurs, aux inscriptions aux formations et aux résultats des tests de sécurité par hameçonnage, soit 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 Reporting et générer des jetons.

​
Partie A — Dans KnowBe4

Votre administrateur KnowBe4 effectue ces étapes.
1

Activer l'API Reporting et générer un jeton

  1. Connectez-vous à votre console KnowBe4.
  2. Cliquez sur le nom de votre compte en haut à droite, puis sélectionnez Account Settings.
  3. Dans la navigation de gauche, sélectionnez API.
  4. Activez la Reporting API si ce n’est pas déjà fait, puis générez un nouveau jeton d’API.
Donnez au jeton une finalité descriptive (par exemple, Living Security Platform) si votre console vous le demande.
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é (par exemple, un coffre-fort de mots de passe ou un gestionnaire de secrets). Si vous quittez la page sans la copier, vous devrez générer un nouveau jeton.
L’API Reporting 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 le calcul des scores 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 permet de restreindre l’accès à l’API Reporting à 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 quatre mêmes 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 traduit généralement par 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 quelconque à cette liste, vous devez également y ajouter les plages de Living Security, faute de quoi 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 restent rares. Si les synchronisations de données se mettent à échouer alors qu’elles fonctionnaient auparavant, consultez Configuration des adresses IP de sortie des intégrations et vérifiez que la liste Allowed IP Addresses correspond.
3

Identifier la région de votre serveur KnowBe4

KnowBe4 fournit l’API Reporting à partir d’un hôte propre à chaque région. Vous sélectionnez votre région dans la boîte de dialogue de connexion au lieu 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 contactez votre administrateur KnowBe4.
Ces cinq régions sont celles que Living Security peut atteindre. Si votre compte KnowBe4 se trouve sur un autre serveur (par exemple une instance US Government), contactez l’assistance 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 désormais connecté à KnowBe4.

​
Dépannage

Le jeton d’API est invalide ou a 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 accès à l’API Reporting, soit l’adresse IP de la requête ne figure pas dans la liste Allowed IP Addresses. Vérifiez que l’API Reporting est activée et que les quatre adresses IP de sortie de Living Security figurent dans la liste d’autorisation.
L’API Reporting 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.