> ## 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 NINJIO

> Connectez NINJIO à la Living Security Platform pour importer les résultats des formations de sensibilisation à la sécurité et des simulations d'hameçonnage 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="NINJIO" />

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

## Ce dont Living Security a besoin

| Identifiant | Description |
| - | - |
| **Clé API** | Une clé API NINJIO disposant d'un accès en lecture aux points d'accès des employés, des formations et de l'hameçonnage. Living Security l'envoie à chaque requête. |

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

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

### Ce que Living Security récupère

| Données | Détail |
| - | - |
| **Apprenants** | Votre annuaire des employés NINJIO : nom, adresse e-mail, service, fonction, responsable, pays, site et statut actif. |
| **Formation** | Les personnes auxquelles chaque formation a été attribuée et celles qui l'ont terminée, avec la date de fin, le score à l'examen et le score d'engagement. |
| **Hameçonnage** | Les personnes qui ont interagi avec un e-mail d'hameçonnage simulé et celles qui l'ont signalé, avec l'horodatage de l'événement. |

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

### Prérequis

* Un compte NINJIO avec accès à l'API.
* Un accès administrateur à [admin.goninjio.com](https://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.*

<Steps>
  <Step title="Ouvrir la zone Intégration">
    1. Connectez-vous à [admin.goninjio.com](https://admin.goninjio.com/) en tant qu'administrateur.
    2. Sélectionnez **Integration** en haut à droite de l'écran.
  </Step>

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

    <Warning>
      Copiez la clé maintenant. NINJIO ne l'affiche qu'une fois et ne pourra plus la montrer.
    </Warning>
  </Step>
</Steps>

***

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

<Steps>
  <ConnectInPlatform tile="NINJIO">
    | Champ | Valeur |
    | - | - |
    | **Clé API** | La clé que vous avez générée à la partie A |
  </ConnectInPlatform>
</Steps>

Vous êtes maintenant connecté à NINJIO.

***

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

| Données | Planification |
| - | - |
| Apprenants | Quotidienne |
| Résultats des formations | Toutes les 6 heures |
| Résultats d'hameçonnage | Toutes les 6 heures |

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.

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

***

## Dépannage

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

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

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

  <Accordion title="Une formation apparaît comme attribué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'attribution au démarrage de la simulation NINJIO, puis enregistre l'achèvement séparément lorsque NINJIO communique une date de fin.
  </Accordion>

  <Accordion title="Certains apprenants sont absents">
    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.
  </Accordion>

  <Accordion title="Les résultats d'hameçonnage d'une ancienne simulation sont absents">
    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.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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