> ## 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 de formation de sensibilisation à la sécurité et les résultats des simulations d'hameçonnage de votre effectif.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Ressources connexes</h2>
    <ul>
      <li>
        <a href="/fr-CA/signals/data-sources">Découvrez comment les données d'intégration deviennent des signaux de gestion des risques humains</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Découvrez 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>
      Cette étape est réalisée par la personne qui détient 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 tuile{' '}
        <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 à l'administrateur ou à l'administratrice de {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 s'en charge. Cette personne effectue la partie A et vous remet les identifiants
      (ou les saisit directement si vous l'avez invitée dans la plateforme).
      {recommendDelegated && <>
          {' '}Comme la configuration produit du matériel de clés sensible, nous recommandons la procédure{' '}
          <strong>de configuration déléguée</strong>, afin que le secret ne vous soit jamais retransmis.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="NINJIO" />

## 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ée
* `training.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 signaler
* `phishing.simulation.reported` — signale les simulations d'hameçonnage

Ces exemples illustrent les types d'activité normalisée que Living Security peut utiliser. Consultez [comment les données d'intégration deviennent des signaux](/fr-CA/signals/data-sources).

## Ce dont Living Security a besoin

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

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

<Warning>
  **NINJIO n'affiche une nouvelle clé qu'une seule fois, au moment de sa création.** Copiez-la directement dans la Living Security Platform, ou dans un coffre-fort de mots de passe, avant de quitter la page. Une clé que vous n'avez pas 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 répertoire d'employés NINJIO : nom, courriel, service, titre du poste, gestionnaire, pays, succursale et statut actif. |
| **Formation** | Qui s'est vu assigner chaque formation et qui l'a terminée, avec la date d'achèvement, la note à l'examen et la note d'engagement. |
| **Hameçonnage** | Qui a interagi avec un courriel d'hameçonnage simulé et qui l'a signalé, avec l'heure de l'événement. |

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

### Prérequis

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

<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 plus tard — par exemple `Living Security`.
    3. Accordez l'accès en **lecture** aux points d'accès **employee**, **training** et **phishing**.
    4. Ne sélectionnez pas l'accès en écriture. Living Security ne fait que lire les données de NINJIO.
    5. Sélectionnez **Generate Key**.

    <Warning>
      Copiez la clé maintenant. NINJIO l'affiche une seule fois et ne peut plus la montrer par la suite.
    </Warning>
  </Step>
</Steps>

***

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

<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 | Calendrier |
| - | - |
| Apprenants | Quotidienne |
| Résultats de formation | 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 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.

<Note>
  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.
</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 seule fois, et il est facile de coller une clé tronquée sans pouvoir le constater par la suite. 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é 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.
  </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 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é.
  </Accordion>

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

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

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

<PublicIntegrationNextSteps />


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