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

# Configuració de la integració amb NINJIO

> Connecteu NINJIO a la Living Security Platform per importar els resultats de la formació de conscienciació sobre seguretat i els resultats de les simulacions de phishing de la vostra plantilla.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Recursos relacionats</h2>
    <ul>
      <li>
        <a href="/ca/signals/data-sources">Descobriu com les dades d'integració es converteixen en Signals de Human Risk Management</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Exploreu les Integrations de Living Security</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Obriu la Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Sol·liciteu una demostració de Living Security</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Introduïu les credencials a la Living Security Platform">
    <p>
      Ho ha de dur a terme qui tingui accés a Living Security: el responsable del programa o
      l'administrador del sistema, si ha estat convidat (configuració delegada).
    </p>
    <ol>
      <li>
        Aneu a <strong>Settings → Integrations → Catalog</strong>, cerqueu la icona de{' '}
        <strong>{tile}</strong> i feu clic a <strong>Connect</strong>.
      </li>
      <li>
        Ompliu els camps següents i, a continuació, feu clic a <strong>Connect</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Aquesta guia és per a l'administrador o administradora de {system}.</strong> Explica com crear
      credencials d'API dins de {system}, cosa que requereix accés d'administració a {system}, no
      a la Living Security Platform.
    </p>
    <p>
      Si sou el <strong>responsable del programa</strong> de Living Security i no administreu {system},
      envieu aquesta pàgina a la persona que ho faci. Aquesta persona completarà la Part A i us lliurarà les credencials
      (o les introduirà directament si l'heu convidada a la plataforma).
      {recommendDelegated && <>
          {' '}Com que la configuració genera material de claus sensible, recomanem seguir el procés de{' '}
          <strong>configuració delegada</strong>, de manera que el secret no se us enviï mai.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="NINJIO" />

## Què aporta aquesta integració

NINJIO pot aportar resultats de Workforce, de Training i de Phishing simulation. Alguns exemples revisats:

* `training.assigned` — té assignada formació sobre seguretat
* `training.completed` — completa la formació sobre seguretat
* `training.passed` — supera les avaluacions de la formació sobre seguretat
* `phishing.simulation.clicked` — ha fet clic en una simulació sense notificar-ho
* `phishing.simulation.reported` — notifica simulacions de phishing

Aquests exemples mostren els tipus d'activitat normalitzada que Living Security pot utilitzar. Consulteu [com es converteixen les dades de la integració en Signals](/ca/signals/data-sources).

## Què necessita Living Security

| Credencial | Descripció |
| - | - |
| **API key** | Una clau d'API de NINJIO amb accés de lectura als punts d'accés d'empleats, formació i phishing. Living Security l'envia en cada sol·licitud. |

**Àmbits:** NINJIO defineix els àmbits de cada clau d'API per *punt d'accés*, amb permisos de lectura i d'escriptura independents. Living Security necessita **lectura** en tres: empleats, formació i phishing. No cal accés d'escriptura i no s'ha de concedir.

**Rol necessari:** un **Administrator** del vostre compte de NINJIO. Només els administradors poden accedir a l'àrea Integration, on es creen les claus.

<Warning>
  **NINJIO mostra una clau nova només una vegada, en el moment de crear-la.** Copieu-la directament a la Living Security Platform, o a un gestor de contrasenyes, abans de sortir de la pàgina. Una clau que no hàgiu copiat no es pot recuperar: caldrà generar-ne una de substitució.
</Warning>

### Què recupera Living Security

| Dades | Detall |
| - | - |
| **Learners** | El directori d'empleats de NINJIO: nom, correu electrònic, departament, càrrec, responsable, país, sucursal i estat d'activitat. |
| **Training** | A qui s'ha assignat cada formació i qui l'ha completada, amb la data de finalització, la puntuació de l'examen i la puntuació de participació. |
| **Phishing** | Qui ha interactuat amb un correu de phishing simulat i qui l'ha notificat, amb l'hora en què va passar. |

<Note>
  **No s'emmagatzemen els números de telèfon dels Learners.** NINJIO retorna un número de telèfon en el registre de l'empleat. Living Security el descarta abans d'emmagatzemar res, perquè cap funcionalitat de Living Security l'utilitza.
</Note>

### Requisits previs

* Un compte de NINJIO amb accés a l'API.
* Accés d'administrador a [admin.goninjio.com](https://admin.goninjio.com/).
* Adreces de correu electrònic dels Learners a NINJIO que coincideixin amb les adreces que utilitzen els vostres altres sistemes connectats. Living Security fa servir el correu electrònic per associar un Learner de NINJIO amb una persona.

***

## Part A — A NINJIO

*L'administrador de NINJIO duu a terme aquests passos.*

<Steps>
  <Step title="Obriu l'àrea Integration">
    1. Inicieu la sessió a [admin.goninjio.com](https://admin.goninjio.com/) com a administrador.
    2. Seleccioneu **Integration** a la part superior dreta de la pantalla.
  </Step>

  <Step title="Creeu la clau d'API">
    1. Seleccioneu **New API Key**.
    2. Assigneu a la clau un nom que reconegueu més endavant, per exemple `Living Security`.
    3. Concediu accés de **lectura** als punts d'accés **employee**, **training** i **phishing**.
    4. Deixeu l'accés d'escriptura sense seleccionar. Living Security només llegeix de NINJIO.
    5. Seleccioneu **Generate Key**.

    <Warning>
      Copieu la clau ara. NINJIO la mostra una sola vegada i no la pot tornar a mostrar.
    </Warning>
  </Step>
</Steps>

***

## Part B — A la Living Security Platform

*El responsable del programa duu a terme aquest pas, o l'administrador del sistema si s'utilitza la configuració delegada.*

<Steps>
  <ConnectInPlatform tile="NINJIO">
    | Field | Value |
    | - | - |
    | **API key** | La clau que heu generat a la Part A |
  </ConnectInPlatform>
</Steps>

Ara ja esteu connectats a NINJIO.

***

## Freqüència de recuperació de les dades

| Dades | Programació |
| - | - |
| Learners | Diàriament |
| Resultats de Training | Cada 6 hores |
| Resultats de Phishing | Cada 6 hores |

En la primera connexió, Living Security recupera les finalitzacions de formació dels últims 12 mesos i, després, es manté al dia de manera incremental. Les simulacions de phishing es llegeixen una sola vegada i es tornen a comprovar durant dues setmanes després de finalitzar, de manera que també es registren els clics i les notificacions tardans.

<Note>
  La primera connexió en un compte de NINJIO gran pot requerir diverses execucions programades per acabar de llegir totes les dades. Cada execució llegeix tot el que pot i la següent continua des d'on s'havia aturat; per això els recomptes van augmentant durant el primer dia o els dos primers dies, en lloc d'aparèixer de cop.
</Note>

***

## Resolució de problemes

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    La clau d'API és incorrecta o incompleta. La causa més habitual és una clau copiada parcialment: NINJIO només la mostra una vegada, de manera que és fàcil enganxar-la truncada i impossible detectar-ho després. Genereu una clau nova a NINJIO i torneu-vos a connectar amb aquesta.
  </Accordion>

  <Accordion title="403 Forbidden">
    Això **no** és un problema de credencials. La clau s'ha autenticat, però a un dels punts d'accés que necessita no se li va concedir permís de lectura.

    Tornar a enganxar la mateixa clau no servirà de res. A NINJIO, creeu una clau amb accés de **lectura** als tres punts d'accés (employee, training i phishing) i torneu-vos a connectar amb aquesta.
  </Accordion>

  <Accordion title="Connexió correcta, però sense dades de Training">
    Comproveu a NINJIO que almenys una campanya de formació estigui **activa** i tingui una simulació associada. Una campanya sense simulació continua inactiva i no genera res, de manera que no hi ha resultats per recuperar.

    Si les campanyes són actives, confirmeu que els Learners que hi participen tinguin adreça de correu electrònic als seus registres de NINJIO. Un Learner sense adreça de correu electrònic no es pot associar amb cap persona i s'omet.
  </Accordion>

  <Accordion title="La formació apareix com a assignada però mai com a completada">
    Aquesta és la visualització esperada quan un Learner no ha acabat una formació. Living Security registra l'assignació quan s'inicia la simulació de NINJIO i registra la finalització per separat quan NINJIO informa d'una data de finalització.
  </Accordion>

  <Accordion title="Falten alguns Learners">
    Living Security associa un Learner de NINJIO amb una persona mitjançant l'**adreça de correu electrònic**. Un Learner el correu electrònic del qual a NINJIO difereix de l'adreça que conté el vostre directori (una adreça personal, un domini antic o un error tipogràfic) no coincidirà.

    Corregiu l'adreça a NINJIO i coincidirà en la propera recuperació programada.
  </Accordion>

  <Accordion title="Falten resultats de Phishing d'una simulació antiga">
    Living Security torna a comprovar una simulació de phishing durant dues setmanes després que finalitzi i, després, deixa de fer-ho. Els resultats que NINJIO registri passat aquest termini no es recullen. Poseu-vos en contacte amb el servei d'assistència si necessiteu que es torni a llegir una simulació antiga.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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