Skip to main content

Ce que cette intégration apporte

Adaptive Security peut fournir des données sur l’effectif, la formation et les résultats de simulations multicanales. Voici des exemples examinés :
  • phishing.simulation.clicked : a cliqué sur un e-mail simulé sans le signaler
  • phishing.simulation.credential.submitted : a saisi ses identifiants sur une fausse page de connexion simulée
  • phishing.simulation.attachment.opened : a ouvert une pièce jointe d’un e-mail simulé
  • phishing.simulation.reported : a signalé un e-mail simulé
  • smishing.simulation.replied : a répondu à un SMS simulé
  • vishing.simulation.succeeded : a obtempéré face à un appelant simulé
  • training.assigned : s’est vu attribuer une formation à la sécurité
  • training.completed : a terminé une formation à la sécurité
  • training.past.due : a manqué l’échéance d’une formation
Ces exemples illustrent les types d’activité normalisée que Living Security peut exploiter. Consultez comment les données d’intégration deviennent des signaux.
Adaptive simule sur trois canaux, et Living Security évalue chacun séparément. Les résultats des e-mails sont évalués comme du phishing, ceux des SMS comme du smishing et ceux des appels vocaux comme du vishing. Une personne qui clique sur un e-mail simulé et une personne qui répond à un SMS simulé ne sont pas mesurées comme ayant eu le même comportement, car le jugement porté dans chaque cas est différent.

Ce dont Living Security a besoin

Rôle requis : un administrateur de votre compte Adaptive Security ayant accès à Settings → API. Adaptive régit l’accès à l’API par des autorisations basées sur les rôles ; le jeton doit donc appartenir à un rôle autorisé à lire les utilisateurs, le phishing et la formation. Accès : lecture seule. Living Security se contente de lire les données d’Adaptive Security et ne crée, ne modifie ni ne supprime jamais rien dans votre compte.

Ce que Living Security récupère

Les numéros de téléphone ne sont pas conservés. Adaptive renvoie les numéros de bureau et de mobile dans la fiche utilisateur. Living Security supprime les deux avant tout stockage, car aucune fonctionnalité de Living Security ne les utilise.
Le score de risque propre à Adaptive est enregistré, mais jamais utilisé dans le calcul. Adaptive calcule un current_risk_score par personne. Living Security le conserve afin que vous puissiez comparer les deux systèmes côte à côte, mais l’Indice de risque humain est toujours calculé à partir des comportements observés, selon le modèle publié de Living Security, et jamais à partir du score composite d’un autre éditeur.

Prérequis

  • Un compte Adaptive Security avec l’API activée.
  • Un accès administrateur à admin.adaptivesecurity.com.
  • Des adresses e-mail d’utilisateurs dans Adaptive qui correspondent à celles utilisées par vos autres systèmes connectés. Living Security s’appuie sur l’adresse e-mail pour associer un utilisateur Adaptive à une personne.

Partie A — Dans Adaptive Security

L’administrateur d’Adaptive Security réalise ces étapes.
1

Ouvrir les paramètres de l'API

  1. Connectez-vous à admin.adaptivesecurity.com en tant qu’administrateur.
  2. Accédez à Settings → API.
2

Générer le jeton d'API

  1. Générez un nouveau jeton d’API.
  2. Donnez-lui un nom que vous reconnaîtrez par la suite, par exemple Living Security.
  3. Vérifiez que le rôle du jeton permet de lire les utilisateurs, les campagnes de phishing et les campagnes de formation.
  4. Copiez le jeton.
Copiez le jeton avant de quitter la page. Si votre compte Adaptive définit une date d’expiration pour le jeton, notez-la : Living Security ne peut plus récupérer de données une fois le jeton expiré, et la connexion doit alors être mise à jour avec un nouveau jeton.

Partie B — Dans Living Security Platform

Le responsable du programme réalise cette étape, ou l’administrateur système si la configuration est déléguée.
Vous êtes à présent connecté à Adaptive Security.

Fréquence de récupération des données

L’API de reporting d’Adaptive ne propose pas de filtre « modifié depuis », si bien que Living Security lit chaque campagne de simulation et de formation tant qu’elle produit encore des résultats, puis cesse de la lire deux semaines après sa clôture. Les clics et signalements tardifs sont ainsi toujours pris en compte, et les campagnes terminées ne sont pas relues indéfiniment.
La première connexion d’un compte Adaptive de grande taille 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 compteurs augmentent donc progressivement au cours du premier ou des deux premiers jours, au lieu d’apparaître d’un seul coup.

Dépannage

Le jeton d’API est incorrect, expiré ou a été révoqué. Adaptive renvoie un corps de réponse vide pour cette erreur ; il n’y a donc aucun détail supplémentaire à consulter. Générez un nouveau jeton dans Settings → API, puis reconnectez-vous avec celui-ci. Un jeton copié partiellement produit la même erreur, et c’est la cause la plus fréquente.
Le jeton a été authentifié, mais son rôle ne permet pas de lire les données demandées. Coller de nouveau le même jeton n’y changera rien. Dans Adaptive, vérifiez que le rôle du jeton dispose d’un accès en lecture aux utilisateurs, au phishing et à la formation, ou émettez un jeton à partir d’un rôle qui en dispose.
Adaptive a limité le débit de la connexion. Living Security interrompt l’exécution en cours et la reprend au même endroit lors de la prochaine exécution planifiée ; aucune donnée n’est donc perdue, les compteurs mettent simplement plus de temps à augmenter. Si le problème persiste pendant plusieurs jours, contactez le support d’Adaptive Security pour vous renseigner sur la limite de débit applicable à votre compte.
Vérifiez que les campagnes attendues ont bien été exécutées. Adaptive ne communique les inscriptions que pour les simulations qui ont été envoyées ; une campagne encore au statut Brouillon ou Planifié n’apporte donc rien tant qu’elle n’a pas été envoyée. Living Security choisit délibérément de ne pas les lire, afin de consacrer son quota de requêtes aux campagnes qui produisent de vrais résultats.
Living Security détermine le canal de chaque résultat à partir du scénario qui lui est associé. Si un scénario a été supprimé dans Adaptive après l’exécution de sa simulation, ses résultats sont enregistrés sur le canal e-mail, car le canal ne peut plus être lu. Conserver dans Adaptive les scénarios retirés plutôt que de les supprimer permet d’éviter ce problème.