Ce que cette intégration apporte
NINJIO peut fournir des résultats relatifs à l’effectif, à la formation et aux simulations d’hameçonnage. Voici des exemples examinés :training.assigned— a une formation en sécurité assignéetraining.completed— termine une formation en sécuritétraining.passed— réussit les évaluations de formation en sécuritéphishing.simulation.clicked— a cliqué sur une simulation sans la signalerphishing.simulation.reported— signale les simulations d’hameçonnage
Ce dont Living Security a besoin
Portées : NINJIO définit la portée de chaque clé API par point d’accès, avec des autorisations de lecture et d’écriture distinctes. Living Security a besoin de la lecture sur trois points d’accès : les employés, la formation et l’hameçonnage. L’accès en écriture n’est pas nécessaire et ne doit pas être accordé.
Rôle requis : Un administrateur de votre compte NINJIO. Seuls les administrateurs peuvent accéder à la zone Intégration où les clés sont créées.
Ce que Living Security récupère
Les numéros de téléphone des apprenants ne sont pas conservés. NINJIO renvoie un numéro de téléphone dans la fiche d’employé. Living Security le supprime avant de stocker quoi que ce soit, car aucune fonctionnalité de Living Security ne l’utilise.
Prérequis
- Un compte NINJIO avec accès à l’API.
- Un accès administrateur à admin.goninjio.com.
- Des adresses courriel d’apprenants dans NINJIO qui correspondent à celles utilisées par vos autres systèmes connectés. Living Security se sert du courriel pour associer un apprenant NINJIO à une personne.
Partie A — Dans NINJIO
Votre administrateur NINJIO effectue ces étapes.1
Ouvrir la zone Intégration
- Connectez-vous à admin.goninjio.com en tant qu’administrateur.
- Sélectionnez Integration en haut à droite de l’écran.
2
Créer la clé API
- Sélectionnez New API Key.
- Donnez à la clé un nom que vous reconnaîtrez plus tard — par exemple
Living Security. - Accordez l’accès en lecture aux points d’accès employee, training et phishing.
- Ne sélectionnez pas l’accès en écriture. Living Security ne fait que lire les données de NINJIO.
- Sélectionnez Generate Key.
Partie B — Dans la Living Security Platform
Le responsable du programme effectue cette étape, ou l’administrateur système si la configuration déléguée est utilisée. Vous êtes maintenant connecté à NINJIO.Fréquence de récupération des données
Lors de la première connexion, Living Security récupère les 12 derniers mois d’achèvements de formation, puis assure un suivi incrémentiel. Les simulations d’hameçonnage sont lues une seule fois, puis revérifiées pendant deux semaines après leur fin, afin de capturer également les clics et les signalements tardifs.
La première connexion à un grand compte NINJIO peut nécessiter plusieurs exécutions planifiées avant que toutes les données soient lues. Chaque exécution lit autant de données que possible et la suivante reprend là où la précédente s’est arrêtée; les totaux augmentent donc progressivement au cours du premier jour ou des deux premiers jours plutôt que d’apparaître d’un seul coup.
Dépannage
403 Forbidden
403 Forbidden
Il ne s’agit pas d’un problème d’identifiants. La clé a été authentifiée, mais l’autorisation de lecture n’a pas été accordée pour l’un des points d’accès nécessaires.Recoller la même clé n’y changera rien. Dans NINJIO, créez une clé avec accès en lecture aux trois points d’accès — employee, training et phishing — et reconnectez-vous avec celle-ci.
Connexion réussie, mais aucune donnée de formation
Connexion réussie, mais aucune donnée de formation
Vérifiez dans NINJIO qu’au moins une campagne de formation est active et qu’une simulation y est associée. Une campagne sans simulation reste inactive et ne diffuse rien; il n’y a donc aucun résultat à récupérer.Si des campagnes sont actives, confirmez que les apprenants concernés ont une adresse courriel dans leur fiche NINJIO. Un apprenant sans adresse courriel ne peut pas être associé à une personne et est ignoré.
La formation apparaît comme assignée, mais jamais terminée
La formation apparaît comme assignée, mais jamais terminée
C’est l’affichage attendu pour une formation qu’un apprenant n’a pas terminée. Living Security enregistre l’assignation au démarrage de la simulation NINJIO, puis enregistre l’achèvement séparément lorsque NINJIO signale une date d’achèvement.
Certains apprenants sont absents
Certains apprenants sont absents
Living Security associe un apprenant NINJIO à une personne au moyen de l’adresse courriel. Un apprenant dont le courriel dans NINJIO diffère de l’adresse figurant dans votre répertoire — adresse personnelle, ancien domaine ou faute de frappe — ne sera pas associé.Corrigez l’adresse dans NINJIO et l’association se fera lors de la prochaine récupération planifiée.
Les résultats d'hameçonnage sont absents pour une ancienne simulation
Les résultats d'hameçonnage sont absents pour une ancienne simulation
Living Security revérifie une simulation d’hameçonnage pendant deux semaines après sa fin, puis arrête. Les résultats que NINJIO enregistre après cette période ne sont pas récupérés. Communiquez avec le soutien si vous avez besoin qu’une ancienne simulation soit relue.

