Skip to main content

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

​
Qué necesita Living Security

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

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

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 a la lista de permitidos. Las mismas cuatro direcciones se aplican en todas las regiones.
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.
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 y verifique que la lista de Allowed IP Addresses coincida.
3

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

​
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.
Ya está conectado a KnowBe4.

​
Solución de problemas

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.
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 estén en la lista de permitidos.
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.