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

> Conecte KnowBe4 a Living Security Platform para importar usuarios, inscripciones a capacitaciones y resultados de pruebas de seguridad de phishing.

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 EgressIpSafelist = ({system}) => <Note>
    <strong>Agregue las cuatro direcciones IP de salida de sincronización de Living Security</strong> a la lista de permitidos de{' '}
    {system}. Introduzca cada una como un único host con <code>/32</code> si {system} espera notación CIDR:
    <br />
    <code>52.34.139.153/32</code>, <code>54.69.127.183/32</code>, <code>44.247.133.183/32</code>,{' '}
    <code>52.26.211.56/32</code>
    <br />
    <br />
    El tráfico puede salir desde cualquiera de las cuatro, por lo que permitir solo algunas provoca fallos de
    sincronización intermitentes. Estas cuatro son las mismas en todas las regiones de Living Security. Consulte{' '}
    <a href="/es/integrations/managing/egress-ip-addresses">
      Configuración de las direcciones IP de salida de las Integraciones
    </a>{' '}
    para obtener la lista completa, la política de cambios y la resolución de problemas.
  </Note>;

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="KnowBe4" />

## Qué aporta esta integración

KnowBe4 puede aportar resultados de la fuerza laboral, de capacitación y de simulaciones de phishing. Algunos ejemplos revisados son:

* `training.completed`: completa la capacitación en seguridad
* `training.past.due`: tiene capacitación vencida
* `phishing.simulation.clicked`: hizo clic en una simulación sin reportarla

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

## Qué necesita Living Security

| Credencial | Descripción |
| - | - |
| **Clave de API** | Un token de portador de la Reporting API generado en **Account Settings → API**. Se envía en cada solicitud en el encabezado `Authorization: Bearer`. |
| **Región del servidor de la Reporting API** | La región en la que está aprovisionada su cuenta de KnowBe4, seleccionada de una lista (EE. UU., UE, Canadá, Reino Unido, Alemania). |

**Alcances:** No hay nada que configurar: los tokens de la Reporting API de KnowBe4 son de solo lectura por diseño y no tienen alcances. El token concede acceso de lectura a los usuarios, las inscripciones a capacitaciones y los resultados de las pruebas de seguridad de phishing, que es exactamente lo que lee la sincronización.

**Rol requerido:** **Account Admin** en KnowBe4 (solo los administradores de la cuenta pueden acceder a **Account Settings → API**)

### Requisitos previos

* Debe haber iniciado sesión en su consola de KnowBe4 con el rol **Account Admin**. Solo los administradores de la cuenta pueden acceder a **Account Settings → API** para habilitar la Reporting API y generar tokens.

***

## Parte A: En KnowBe4

*El administrador de KnowBe4 completa estos pasos.*

<Steps>
  <Step title="Habilitar la Reporting API y generar un token">
    1. Inicie sesión en su consola de KnowBe4.
    2. Haga clic en el nombre de su cuenta, en la esquina superior derecha, y seleccione **Account Settings**.
    3. En la navegación izquierda, seleccione **API**.
    4. Habilite la **Reporting API** si aún no está habilitada y, a continuación, genere un nuevo token de API.

    Asigne al token una finalidad descriptiva (p. ej., `Living Security Platform`) si su consola se lo solicita.

    <Warning>
      KnowBe4 muestra el valor del token de API **una sola vez**, en el momento en que se genera. Cópielo de inmediato y guárdelo en un lugar seguro (p. ej., una bóveda de contraseñas o un administrador de secretos). Si sale de la página sin copiarlo, deberá generar un nuevo token.
    </Warning>

    <Note>
      La Reporting API es de solo lectura. Expone usuarios, inscripciones a capacitaciones y resultados de pruebas de seguridad de phishing, es decir, los datos que Living Security ingiere para la puntuación y la generación de informes. No se requiere acceso de escritura.
    </Note>
  </Step>

  <Step title="Agregar las IP de salida de Living Security a la lista de Allowed IP Addresses">
    KnowBe4 permite restringir el acceso a la Reporting API a un conjunto específico de direcciones IP de origen. Esta opción se encuentra en el mismo lugar que el token:

    1. En su consola de KnowBe4, vaya a **Account Settings → API → Allowed IP Addresses**.
    2. Agregue cada [dirección IP de salida de Living Security](/es/integrations/managing/egress-ip-addresses) a la lista de permitidos. Las mismas cuatro direcciones se aplican en todas las regiones.

    <EgressIpSafelist system="KnowBe4" />

    <Warning>
      **Si la lista de Allowed IP Addresses está configurada, se aplica en la capa de red.** El cuadro de diálogo de conexión se completará correctamente en el momento de la autenticación, pero las sincronizaciones de datos fallarán (bloqueadas en la capa de red, lo que suele manifestarse como `403`) hasta que se agreguen las IP de salida de Living Security a la lista de permitidos. Si agrega cualquier dirección a esta lista, también debe agregar los rangos de Living Security; de lo contrario, nuestras solicitudes serán rechazadas aunque su token sea válido.
    </Warning>

    <Note>
      Las direcciones IP de salida de Living Security pueden cambiar cuando se actualiza la infraestructura, aunque estos cambios son poco frecuentes. Si las sincronizaciones de datos empiezan a fallar después de haber funcionado correctamente, consulte [Configuración de las direcciones IP de salida de las integraciones](/es/integrations/managing/egress-ip-addresses) y verifique que la lista de Allowed IP Addresses coincida.
    </Note>
  </Step>

  <Step title="Identificar la región de su servidor de KnowBe4">
    KnowBe4 ofrece la Reporting API desde un host específico de cada región. Usted selecciona su región en el cuadro de diálogo de conexión en lugar de escribir un nombre de host:

    | Región | Host de la Reporting API |
    | - | - |
    | Estados Unidos | `us.api.knowbe4.com` |
    | Europa | `eu.api.knowbe4.com` |
    | Canadá | `ca.api.knowbe4.com` |
    | Reino Unido | `uk.api.knowbe4.com` |
    | Alemania | `de.api.knowbe4.com` |

    Si no sabe qué región utiliza su cuenta, revise el dominio de la URL de su consola de KnowBe4 o consulte con su administrador de KnowBe4.

    <Note>
      Estas cinco regiones son las que Living Security puede alcanzar. Si su cuenta de KnowBe4 está en otro servidor (por ejemplo, una instancia del Gobierno de EE. UU.), comuníquese con el soporte de Living Security antes de iniciar la conexión.
    </Note>
  </Step>
</Steps>

***

## Parte B: En Living Security Platform

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

<Steps>
  <ConnectInPlatform tile="KnowBe4">
    | Campo | Valor |
    | - | - |
    | **Clave de API** | El token de la Reporting API de la Parte A, paso 1 |
    | **Región del servidor de la Reporting API** | La región de la Parte A, paso 3 (p. ej., Estados Unidos) |
  </ConnectInPlatform>
</Steps>

Ya está conectado a KnowBe4.

***

## Solución de problemas

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    El token de API no es válido o ha caducado. Verifique que el token sea correcto y que no se haya regenerado en **Account Settings → API**.
  </Accordion>

  <Accordion title="403 Forbidden">
    O bien el token no tiene acceso a la Reporting API, o bien la IP de la solicitud no figura en la lista de Allowed IP Addresses. Verifique que la Reporting API esté habilitada y que las cuatro [direcciones IP de salida de Living Security](/es/integrations/managing/egress-ip-addresses) estén en la lista de permitidos.
  </Accordion>

  <Accordion title="Resultados vacíos (200 OK pero sin datos)">
    Es posible que la Reporting API aún no tenga datos que devolver o que la cuenta del token no tenga visibilidad de los usuarios y las campañas que Living Security ingiere. Verifique que el token haya sido generado por un Account Admin.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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