> ## 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ón de la integración de NINJIO

> Conecte NINJIO a Living Security Platform para importar los resultados de capacitación en concientización sobre seguridad y los resultados de simulaciones de phishing de su fuerza laboral.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Recursos relacionados</h2>
    <ul>
      <li>
        <a href="/es/signals/data-sources">Descubra cómo los datos de las integraciones se convierten en señales de Human Risk Management</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Explore las integraciones de Living Security</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Abra Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Solicite una demostración de Living Security</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Introduzca las credenciales en Living Security Platform">
    <p>
      Lo realiza la persona que tenga acceso a Living Security: el responsable del programa o el
      administrador del sistema, si se le ha invitado (configuración delegada).
    </p>
    <ol>
      <li>
        Vaya a <strong>Configuración → Integraciones → Catálogo</strong>, busque el icono de{' '}
        <strong>{tile}</strong> y haga clic en <strong>Conectar</strong>.
      </li>
      <li>
        Complete los campos que se indican a continuación y, a continuación, haga clic en <strong>Conectar</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Esta guía está dirigida al administrador de {system}.</strong> Describe cómo crear
      credenciales de API dentro de {system}, lo que requiere acceso de administrador a {system}, no a
      Living Security Platform.
    </p>
    <p>
      Si usted es el <strong>responsable del programa</strong> de Living Security y no administra {system},
      envíe esta página a la persona que lo haga. Dicha persona completará la Parte A y le entregará las credenciales
      (o las introducirá directamente si usted la ha invitado a la plataforma).
      {recommendDelegated && <>
          {' '}Dado que la configuración genera material de claves confidencial, recomendamos la vía de{' '}
          <strong>configuración delegada</strong>, de modo que el secreto nunca se le envíe a usted.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="NINJIO" />

## Qué aporta esta integración

NINJIO puede aportar resultados de fuerza laboral, capacitación y simulaciones de phishing. Entre los ejemplos revisados se incluyen:

* `training.assigned` — tiene asignada una capacitación en seguridad
* `training.completed` — completa una capacitación en seguridad
* `training.passed` — aprueba las evaluaciones de capacitación en seguridad
* `phishing.simulation.clicked` — hizo clic en una simulación sin reportarla
* `phishing.simulation.reported` — reporta simulaciones de phishing

Estos ejemplos muestran los tipos de actividad normalizada que Living Security puede utilizar. Consulte [cómo los datos de la integración se convierten en señales](/es/signals/data-sources).

## Qué necesita Living Security

| Credencial | Descripción |
| - | - |
| **Clave de API** | Una clave de API de NINJIO con acceso de lectura a los puntos de acceso de empleados, capacitación y phishing. Living Security la envía en cada solicitud. |

**Permisos:** NINJIO asigna los permisos de cada clave de API por *punto de acceso*, con permisos de lectura y escritura independientes. Living Security necesita **lectura** en tres de ellos: empleados, capacitación y phishing. No se necesita acceso de escritura y no debe concederse.

**Rol requerido:** Un **Administrador** de su cuenta de NINJIO. Solo los administradores pueden acceder al área de Integración donde se crean las claves.

<Warning>
  **NINJIO muestra una clave nueva una sola vez, en el momento en que se crea.** Cópiela directamente en Living Security Platform, o en un gestor de contraseñas, antes de salir de la página. Una clave que no haya copiado no se puede recuperar; deberá generar una nueva.
</Warning>

### Qué datos obtiene Living Security

| Datos | Detalle |
| - | - |
| **Alumnos** | El directorio de empleados de NINJIO: nombre, correo electrónico, departamento, puesto, gerente, país, sucursal y estado activo. |
| **Capacitación** | A quién se asignó cada capacitación y quién la completó, con la fecha de finalización, la puntuación del examen y la puntuación de participación. |
| **Phishing** | Quién interactuó con un correo de phishing simulado y quién lo reportó, con la hora en que ocurrió. |

<Note>
  **Los números de teléfono de los alumnos no se almacenan.** NINJIO devuelve un número de teléfono en el registro del empleado. Living Security lo descarta antes de almacenar cualquier dato, porque ninguna función de Living Security lo utiliza.
</Note>

### Requisitos previos

* Una cuenta de NINJIO con acceso a la API.
* Acceso de administrador a [admin.goninjio.com](https://admin.goninjio.com/).
* Direcciones de correo electrónico de los alumnos en NINJIO que coincidan con las que utilizan sus otros sistemas conectados. Living Security utiliza el correo electrónico para asociar a un alumno de NINJIO con una persona.

***

## Parte A — En NINJIO

*El administrador de NINJIO realiza estos pasos.*

<Steps>
  <Step title="Abra el área de Integración">
    1. Inicie sesión en [admin.goninjio.com](https://admin.goninjio.com/) como administrador.
    2. Seleccione **Integration** en la parte superior derecha de la pantalla.
  </Step>

  <Step title="Cree la clave de API">
    1. Seleccione **New API Key**.
    2. Asigne a la clave un nombre que pueda reconocer más adelante, por ejemplo `Living Security`.
    3. Conceda acceso de **lectura** a los puntos de acceso de **empleados**, **capacitación** y **phishing**.
    4. Deje sin seleccionar el acceso de escritura. Living Security solo lee datos de NINJIO.
    5. Seleccione **Generate Key**.

    <Warning>
      Copie la clave ahora. NINJIO la muestra una sola vez y no puede volver a mostrarla.
    </Warning>
  </Step>
</Steps>

***

## Parte B — En Living Security Platform

*El responsable del programa realiza este paso, o el administrador del sistema si se utiliza la configuración delegada.*

<Steps>
  <ConnectInPlatform tile="NINJIO">
    | Campo | Valor |
    | - | - |
    | **Clave de API** | La clave que generó en la Parte A |
  </ConnectInPlatform>
</Steps>

Ya está conectado a NINJIO.

***

## Frecuencia de obtención de los datos

| Datos | Programación |
| - | - |
| Alumnos | Diaria |
| Resultados de capacitación | Cada 6 horas |
| Resultados de phishing | Cada 6 horas |

En la primera conexión, Living Security obtiene los últimos 12 meses de capacitaciones completadas y después se mantiene al día de forma incremental. Las simulaciones de phishing se leen una sola vez y se vuelven a comprobar durante las dos semanas posteriores a su finalización, de modo que también se registren los clics y reportes tardíos.

<Note>
  La primera conexión en una cuenta grande de NINJIO puede requerir varias ejecuciones programadas para terminar de leer toda la información. Cada ejecución lee todo lo que puede y la siguiente continúa desde donde se detuvo, por lo que los recuentos aumentan durante el primer día o los dos primeros días en lugar de aparecer todos a la vez.
</Note>

***

## Solución de problemas

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    La clave de API es incorrecta o está incompleta. La causa más común es una clave copiada parcialmente: NINJIO la muestra una sola vez, por lo que es fácil pegarla truncada y resulta imposible detectarlo después. Genere una nueva clave en NINJIO y vuelva a conectar con ella.
  </Accordion>

  <Accordion title="403 Forbidden">
    Esto **no** es un problema de credenciales. La clave se autenticó, pero a uno de los puntos de acceso que necesita no se le concedió permiso de lectura.

    Volver a pegar la misma clave no servirá. En NINJIO, cree una clave con acceso de **lectura** a los tres puntos de acceso (empleados, capacitación y phishing) y vuelva a conectar con esa clave.
  </Accordion>

  <Accordion title="Conexión correcta, pero sin datos de capacitación">
    Compruebe en NINJIO que al menos una campaña de capacitación esté **activa** y tenga una simulación asociada. Una campaña sin simulación permanece inactiva y no entrega nada, por lo que no hay resultados que obtener.

    Si las campañas están activas, confirme que los alumnos incluidos en ellas tengan direcciones de correo electrónico en sus registros de NINJIO. Un alumno sin dirección de correo electrónico no puede asociarse con una persona y se omite.
  </Accordion>

  <Accordion title="La capacitación aparece como asignada, pero nunca como completada">
    Esa es la visualización esperada para una capacitación que el alumno no ha terminado. Living Security registra la asignación cuando se inicia la simulación de NINJIO y registra la finalización por separado cuando NINJIO informa una fecha de finalización.
  </Accordion>

  <Accordion title="Faltan algunos alumnos">
    Living Security asocia a un alumno de NINJIO con una persona mediante la **dirección de correo electrónico**. Un alumno cuyo correo en NINJIO difiera de la dirección que figura en su directorio (una dirección personal, un dominio anterior o un error tipográfico) no coincidirá.

    Corrija la dirección en NINJIO y coincidirá en la siguiente obtención programada.
  </Accordion>

  <Accordion title="Faltan resultados de phishing de una simulación anterior">
    Living Security vuelve a comprobar una simulación de phishing durante las dos semanas posteriores a su finalización y después deja de hacerlo. Los resultados que NINJIO registre después de ese periodo no se obtienen. Comuníquese con soporte si necesita que se vuelva a leer una simulación anterior.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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