> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration de l'intégration Adaptive Security

> Connectez Adaptive Security à Living Security Platform afin d'importer les résultats des simulations de phishing, de smishing et de vishing, ainsi que les résultats de la formation de sensibilisation à la sécurité de votre effectif.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Ressources associées</h2>
    <ul>
      <li>
        <a href="/fr/signals/data-sources">Découvrez comment les données d'intégration deviennent des signaux de Human Risk Management</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Découvrir les intégrations de Living Security</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Ouvrir la Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Demander une démonstration de Living Security</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Saisissez les identifiants dans la Living Security Platform">
    <p>
      À effectuer par la personne disposant d'un accès à Living Security : le responsable du programme, ou
      l'administrateur système s'il a été invité (configuration déléguée).
    </p>
    <ol>
      <li>
        Accédez à <strong>Paramètres → Intégrations → Catalogue</strong>, repérez la vignette{' '}
        <strong>{tile}</strong>, puis cliquez sur <strong>Connecter</strong>.
      </li>
      <li>
        Renseignez les champs ci-dessous, puis cliquez sur <strong>Connecter</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Ce guide s'adresse à votre administrateur {system}.</strong> Il explique comment créer des
      identifiants d'API dans {system}, ce qui nécessite un accès administrateur à {system} — et non à la
      Living Security Platform.
    </p>
    <p>
      Si vous êtes le <strong>responsable du programme</strong> Living Security et que vous n'administrez pas {system},
      transmettez cette page à la personne qui en est chargée. Celle-ci réalise la partie A et vous remet les identifiants
      (ou les saisit directement si vous l'avez invitée sur la plateforme).
      {recommendDelegated && <>
          {' '}Comme la configuration génère des clés sensibles, nous recommandons de privilégier la{' '}
          <strong>configuration déléguée</strong>, afin que le secret ne vous soit jamais transmis.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="Adaptive Security" />

## 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](/fr/signals/data-sources).

<Note>
  **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.
</Note>

## Ce dont Living Security a besoin

| Identifiant | Description |
| - | - |
| **Jeton d'API** | Un jeton d'API Adaptive Security. Living Security l'envoie comme jeton porteur (bearer token) à chaque requête. |

**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

| Données | Détail |
| - | - |
| **Personnes** | Votre annuaire d'utilisateurs Adaptive : nom, adresse e-mail, service, intitulé de poste, nom et adresse e-mail du responsable, localisation, division, statut d'emploi et date de début. |
| **Simulations par e-mail** | Par personne et par simulation : le moment où le message a été remis, ouvert, cliqué, où il a reçu une réponse, où sa pièce jointe a été ouverte, où son code QR a été scanné, où des identifiants ont été saisis, ou encore où il a été signalé. |
| **Simulations par SMS** | Par personne et par simulation : remis, ouvert, cliqué, ayant reçu une réponse, identifiants saisis ou signalé. |
| **Simulations vocales** | Par personne et par simulation : le leurre remis, le numéro appelé, si la personne a obtempéré face à l'appelant et si elle l'a signalé. |
| **Formation** | Par personne et par campagne : la date d'inscription, l'échéance, la date de début, la date de fin et si la personne a pris connaissance de la politique de la campagne. |

<Note>
  **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.
</Note>

<Note>
  **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.
</Note>

### Prérequis

* Un compte Adaptive Security avec l'API activée.
* Un accès administrateur à [admin.adaptivesecurity.com](https://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.*

<Steps>
  <Step title="Ouvrir les paramètres de l'API">
    1. Connectez-vous à [admin.adaptivesecurity.com](https://admin.adaptivesecurity.com) en tant qu'administrateur.
    2. Accédez à **Settings → API**.
  </Step>

  <Step title="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.

    <Warning>
      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.
    </Warning>
  </Step>
</Steps>

***

## 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.*

<Steps>
  <ConnectInPlatform tile="Adaptive Security">
    | Champ | Valeur |
    | - | - |
    | **Jeton d'API** | Le jeton que vous avez généré dans la partie A |
  </ConnectInPlatform>
</Steps>

Vous êtes à présent connecté à Adaptive Security.

***

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

| Données | Planification |
| - | - |
| Personnes | Toutes les 6 heures |
| Résultats des simulations (e-mail, SMS, voix) | Toutes les 6 heures |
| Résultats de la formation | Toutes les 6 heures |

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.

<Note>
  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.
</Note>

***

## Dépannage

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    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.
  </Accordion>

  <Accordion title="403 Forbidden">
    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.
  </Accordion>

  <Accordion title="429 Too Many Requests">
    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.
  </Accordion>

  <Accordion title="Des personnes apparaissent, mais aucun résultat de simulation">
    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.
  </Accordion>

  <Accordion title="Des simulations vocales ou par SMS sont manquantes">
    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.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.