Skip to main content

​
Ce que cette intégration apporte

NINJIO peut fournir des résultats relatifs à l’effectif, aux formations et aux simulations d’hameçonnage. Voici des exemples validés :
  • training.assigned — a reçu une formation de sécurité
  • training.completed — termine une formation de sécurité
  • training.passed — réussit les évaluations de formation de sécurité
  • phishing.simulation.clicked — a cliqué sur une simulation sans la signaler
  • phishing.simulation.reported — signale des simulations d’hameçonnage
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 : NINJIO définit les portées de chaque clé API par point d’accès, avec des autorisations distinctes de lecture et d’écriture. Living Security a besoin de la lecture sur trois points d’accès : employés, formations et hameçonnage. L’accès en écriture n’est pas nécessaire et ne doit pas être accordé. Rôle requis : un Administrateur sur votre compte NINJIO. Seuls les administrateurs peuvent accéder à la zone Intégration où les clés sont créées.
NINJIO n’affiche une nouvelle clé qu’une seule fois, au moment de sa création. Copiez-la immédiatement dans la Living Security Platform, ou dans un coffre-fort de mots de passe, avant de quitter la page. Une clé qui n’a pas été copiée ne peut pas être récupérée : vous devez en générer une nouvelle.

​
Ce que Living Security récupère

Les numéros de téléphone des apprenants ne sont pas stockés. NINJIO renvoie un numéro de téléphone dans la fiche d’un employé. Living Security le supprime avant tout stockage, 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 e-mail d’apprenants dans NINJIO qui correspondent à celles utilisées par vos autres systèmes connectés. Living Security se sert de l’adresse e-mail pour associer un apprenant NINJIO à une personne.

​
Partie A — Dans NINJIO

Votre administrateur NINJIO effectue ces étapes.
1

Ouvrir la zone Intégration

  1. Connectez-vous à admin.goninjio.com en tant qu’administrateur.
  2. Sélectionnez Integration en haut à droite de l’écran.
2

Créer la clé API

  1. Sélectionnez New API Key.
  2. Donnez à la clé un nom que vous reconnaîtrez par la suite, par exemple Living Security.
  3. Accordez l’accès en lecture aux points d’accès employee, training et phishing.
  4. Laissez l’accès en écriture non sélectionné. Living Security se contente de lire les données de NINJIO.
  5. Sélectionnez Generate Key.
Copiez la clé maintenant. NINJIO ne l’affiche qu’une fois et ne pourra plus la montrer.

​
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é à 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 de formations terminées, puis assure ensuite 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 que les clics et les signalements tardifs soient tout de même pris en compte.
La première connexion d’un compte NINJIO volumineux peut nécessiter plusieurs exécutions planifiées pour lire l’ensemble des données. 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 ou des deux premiers jours, au lieu d’apparaître en une seule fois.

​
Dépannage

La clé API est incorrecte ou incomplète. La cause la plus fréquente est une clé copiée partiellement : NINJIO ne l’affiche qu’une fois, si bien qu’un collage tronqué est facile à commettre et impossible à repérer après coup. Générez une nouvelle clé dans NINJIO et reconnectez-vous avec celle-ci.
Il ne s’agit pas d’un problème d’identifiants. La clé s’est authentifiée, mais l’un des points d’accès nécessaires ne dispose pas de l’autorisation de lecture.Coller à nouveau la même clé n’y changera rien. Dans NINJIO, créez une clé disposant d’un accès en lecture aux trois points d’accès (employee, training et phishing), puis reconnectez-vous avec cette clé.
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 produit rien ; il n’y a donc aucun résultat à récupérer.Si des campagnes sont actives, vérifiez que les apprenants concernés ont une adresse e-mail dans leur fiche NINJIO. Un apprenant sans adresse e-mail ne peut pas être associé à une personne et est ignoré.
C’est l’affichage attendu pour une formation qu’un apprenant n’a pas terminée. Living Security enregistre l’attribution au démarrage de la simulation NINJIO, puis enregistre l’achèvement séparément lorsque NINJIO communique une date de fin.
Living Security associe un apprenant NINJIO à une personne grâce à l’adresse e-mail. Un apprenant dont l’adresse dans NINJIO diffère de celle de votre annuaire (adresse personnelle, ancien domaine ou faute de frappe) ne sera pas associé.Corrigez l’adresse dans NINJIO : l’association se fera lors de la prochaine récupération planifiée.
Living Security revérifie une simulation d’hameçonnage pendant deux semaines après sa fin, puis cesse de le faire. Les résultats enregistrés par NINJIO après cette période ne sont pas pris en compte. Contactez le support si vous avez besoin qu’une ancienne simulation soit relue.