La función de interfaz de programación de aplicaciones (API, por sus siglas en inglés) de informes de KnowBe4 es exclusiva para los clientes Platino y Diamante, y le permite extraer datos de la consola de KSAT para realizar informes. En este momento, esta función solo permite solicitudes de datos de phishing, capacitaciones, usuarios y grupos. Cuando utilice esta API, deberá autenticarse en ella con una clave específica de la cuenta.
Para conocer todos los detalles de la API de informes y ver solicitudes de ejemplo, visite nuestra documentación para desarrolladores API de informes. La API de KnowBe4 es una API REST. Al utilizar la API de KnowBe4, usted acepta nuestros Términos de uso.
Cómo crear un token de API de informes
Para crear un token de API de informes, siga estos pasos:
- En su consola de KSAT, haga clic en su dirección de correo electrónico, que se encuentra en la esquina superior derecha de la página, y seleccione Configuración de la cuenta.
- Vaya a Integraciones de la cuenta > API.
- En API de informes, seleccione el botón Habilitar acceso a la API de informes.
- Haga clic en API de informes. Se abrirá la subpestaña API de informes.
- En la esquina superior derecha de la subpestaña API de informes, haga clic en + Crear token de API nuevo.
- Complete los campos de la página Crear token de API nuevo. Para obtener más información, consulte la captura de pantalla y la lista que aparecen a continuación:
- Nombre: En este campo, ingrese un nombre que describa este token de API.
- Estado: Para activar o desactivar el token de API.
- Haga clic en Crear token. Se abrirá la ventana emergente Token de API de informes.
- Haga clic en el token de API de informes para copiar el token. Asegúrese de guardar el token de API que copió en algún lugar al que pueda acceder fácilmente. Después de cerrar esta ventana, no podrá volver a ver este token.
- Haga clic en Aceptar.
Una vez copiado, puede usar el token de API para extraer datos de la consola de KSAT a fin de generar informes.
Cómo administrar los tokens de la API de informes
Una vez que haya creado un token de API de informes, puede administrar el token en la subpestaña API de informes. Puede acceder a esta subpestaña desde la sección Integraciones de la cuenta de la página Configuración de la cuenta.
Para obtener más información sobre las opciones disponibles en esta subpestaña, consulte a continuación:
- Clave: En esta columna, se muestra un identificador único utilizado para autenticar una solicitud de API asociada con su consola de KSAT.
- Nombre: En esta columna, se muestra el nombre personalizado que le asignó al token de API cuando lo creó.
- Generado por: En esta columna, se muestra la dirección de correo electrónico asociada con el usuario que generó el token de API.
- Generado el: En esta columna, se muestra la fecha en que se generó el token de API de informes.
- Estado: En esta columna, se muestra el estado del token de API. El estado se puede habilitar o deshabilitar.
-
Acciones: Haga clic en la flecha desplegable en la columna del extremo derecho para ver las acciones disponibles para un token de API de informes. Estas acciones incluyen las siguientes:
- Editar: Haga clic en Editar para abrir la página Editar token de API de informes, que es similar a la página Crear token de API nuevo. Edite las opciones según sea necesario y luego haga clic en Actualizar token para guardar los cambios.
- Eliminar: Haga clic en Eliminar para borrar permanentemente un token de API de informes.