> ## 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 con Adaptive Security

> Conecte Adaptive Security a Living Security Platform para importar los resultados de simulaciones de phishing, smishing y vishing, así como los resultados de la capacitación en concienciación sobre seguridad 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="Adaptive Security" />

## Qué aporta esta integración

Adaptive Security puede aportar resultados de fuerza laboral, capacitación y simulaciones multicanal. Algunos ejemplos revisados son:

* `phishing.simulation.clicked` — hizo clic en un correo electrónico simulado sin reportarlo
* `phishing.simulation.credential.submitted` — introdujo credenciales en una página de inicio de sesión simulada
* `phishing.simulation.attachment.opened` — abrió un archivo adjunto de un correo electrónico simulado
* `phishing.simulation.reported` — reportó un correo electrónico simulado
* `smishing.simulation.replied` — respondió a un mensaje de texto simulado
* `vishing.simulation.succeeded` — cedió ante una persona que llamó por teléfono en una simulación de voz
* `training.assigned` — se le asignó una capacitación en seguridad
* `training.completed` — completó la capacitación en seguridad
* `training.past.due` — no cumplió el plazo de una capacitación

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

<Note>
  **Adaptive simula a través de tres canales, y Living Security puntúa cada uno por separado.**
  Los resultados de correo electrónico se puntúan como phishing, los de mensajes de texto como smishing y los de llamadas de voz como vishing. Una persona que hace clic en un correo electrónico simulado y otra que responde a un mensaje de texto simulado no se miden como el mismo comportamiento, porque el criterio que aplicó cada una es distinto.
</Note>

## Qué necesita Living Security

| Credencial | Descripción |
| - | - |
| **API token** | Un token de API de Adaptive Security. Living Security lo envía como token de portador (bearer) en cada solicitud. |

**Rol requerido:** Un administrador de su cuenta de Adaptive Security con acceso a **Settings → API**. Adaptive controla el acceso a la API mediante permisos basados en roles, por lo que el token debe pertenecer a un rol que pueda leer usuarios, phishing y capacitación.

**Acceso:** Solo lectura. Living Security únicamente lee datos de Adaptive Security y nunca crea, modifica ni elimina nada en su cuenta.

### Qué datos obtiene Living Security

| Datos | Detalle |
| - | - |
| **Personas** | Su directorio de usuarios de Adaptive: nombre, correo electrónico, departamento, cargo, nombre y correo electrónico del gerente, ubicación, división, situación laboral y fecha de inicio. |
| **Simulaciones de correo electrónico** | Por persona y por simulación: cuándo se entregó el mensaje, se abrió, se hizo clic, se respondió, se abrió su archivo adjunto, se escaneó su código QR, se introdujeron credenciales o se reportó. |
| **Simulaciones de texto** | Por persona y por simulación: entregado, abierto, clic realizado, respondido, credenciales introducidas o reportado. |
| **Simulaciones de voz** | Por persona y por simulación: el señuelo entregado, el número al que se llamó, si la persona cedió ante quien llamaba y si lo reportó. |
| **Capacitación** | Por persona y por campaña: cuándo se inscribió, cuál era la fecha límite, cuándo la inició, cuándo la completó y si aceptó la política de la campaña. |

<Note>
  **Los números de teléfono no se almacenan.** Adaptive devuelve los números de oficina y de móvil en el registro del usuario. Living Security descarta ambos antes de almacenar cualquier dato, porque ninguna función de Living Security los utiliza.
</Note>

<Note>
  **La puntuación de riesgo propia de Adaptive se registra, pero nunca se utiliza para puntuar.** Adaptive calcula un `current_risk_score` por persona. Living Security lo conserva para que pueda comparar ambos sistemas, pero el Índice de riesgo humano siempre se calcula a partir del comportamiento observado, con el modelo publicado de Living Security, y nunca a partir de la puntuación compuesta de otro proveedor.
</Note>

### Requisitos previos

* Una cuenta de Adaptive Security con la API habilitada.
* Acceso de administrador a [admin.adaptivesecurity.com](https://admin.adaptivesecurity.com).
* Direcciones de correo electrónico de usuario en Adaptive que coincidan con las que utilizan sus demás sistemas conectados. Living Security usa el correo electrónico para asociar un usuario de Adaptive con una persona.

***

## Parte A — En Adaptive Security

*El administrador de Adaptive Security realiza estos pasos.*

<Steps>
  <Step title="Abra la configuración de la API">
    1. Inicie sesión en [admin.adaptivesecurity.com](https://admin.adaptivesecurity.com) como administrador.
    2. Vaya a **Settings → API**.
  </Step>

  <Step title="Genere el token de API">
    1. Genere un nuevo token de API.
    2. Asígnele un nombre que pueda reconocer más adelante, por ejemplo `Living Security`.
    3. Confirme que el rol del token puede leer usuarios, campañas de phishing y campañas de capacitación.
    4. Copie el token.

    <Warning>
      Copie el token antes de salir de la página. Si su cuenta de Adaptive establece una fecha de caducidad para el token, anótela: Living Security no podrá obtener datos una vez que caduque, y será necesario actualizar la conexión con un token nuevo.
    </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="Adaptive Security">
    | Campo | Valor |
    | - | - |
    | **API token** | El token que generó en la Parte A |
  </ConnectInPlatform>
</Steps>

Ya está conectado a Adaptive Security.

***

## Frecuencia de obtención de los datos

| Datos | Programación |
| - | - |
| Personas | Cada 6 horas |
| Resultados de simulaciones (correo electrónico, texto, voz) | Cada 6 horas |
| Resultados de capacitación | Cada 6 horas |

La API de informes de Adaptive no ofrece un filtro de «qué ha cambiado desde», por lo que Living Security lee cada campaña de simulación y de capacitación mientras sigue generando resultados y deja de leerla cuando lleva dos semanas cerrada. De este modo, los clics y los reportes tardíos se siguen registrando, y las campañas finalizadas no se vuelven a leer indefinidamente.

<Note>
  La primera conexión de una cuenta de Adaptive grande puede requerir varias ejecuciones programadas para terminar de leer todos los datos. 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">
    El token de API es incorrecto, ha caducado o se ha revocado. Adaptive devuelve un cuerpo de respuesta vacío ante este error, por lo que no hay más detalles que consultar. Genere un token nuevo en **Settings → API** y vuelva a conectar con él. Un token copiado parcialmente produce el mismo error y es la causa más frecuente.
  </Accordion>

  <Accordion title="403 Forbidden">
    El token se autenticó, pero su rol no puede leer los datos solicitados. Volver a pegar el mismo token no servirá de nada. En Adaptive, confirme que el rol del token tiene acceso de lectura a usuarios, phishing y capacitación, o emita un token desde un rol que lo tenga.
  </Accordion>

  <Accordion title="429 Too Many Requests">
    Adaptive limitó la frecuencia de la conexión. Living Security detiene esa ejecución y la reanuda desde el mismo punto en la siguiente ejecución programada, por lo que no se pierde ningún dato; los recuentos simplemente tardan más en aumentar. Si esto persiste durante varios días, comuníquese con el soporte de Adaptive Security para consultar el límite de frecuencia que se aplica a su cuenta.
  </Accordion>

  <Accordion title="Aparecen personas, pero no resultados de simulaciones">
    Compruebe que las campañas que espera se hayan ejecutado realmente. Adaptive solo informa de las inscripciones de las simulaciones que se han enviado, por lo que una campaña que aún se encuentra en estado **Borrador** o **Programado** no aporta nada hasta que se envía. Living Security no las lee de forma deliberada, para dedicar su presupuesto de solicitudes a las campañas que tienen resultados reales.
  </Accordion>

  <Accordion title="Faltan simulaciones de voz o de texto">
    Living Security determina el canal de cada resultado a partir del escenario asociado. Si se eliminó un escenario en Adaptive después de ejecutarse su simulación, sus resultados se registran en el canal de correo electrónico, porque ya no es posible leer el canal. Conservar en Adaptive los escenarios retirados en lugar de eliminarlos evita este problema.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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