La API de acontecimientos de usuario le permite importar actividades de formación o acontecimientos relacionados con la seguridad de sus usuarios desde fuentes externas e insertarlos en su consola KSAT. Una vez importados, los acontecimientos personalizados aparecerán en la Cronología del usuario de las personas usuarias afectadas y podrán repercutir en la puntuación de riesgo personal de estos.
Para conocer más detalles sobre la API de acontecimientos de usuario, así como ejemplos de solicitudes, consulte la documentación para desarrolladores de la API de acontecimientos de usuario documentación para desarrolladores de la API de acontecimientos de usuario (el enlace se abre en una nueva ventana). Si decide usar la API de acontecimientos de usuario de KnowBe4, revise las siguientes secciones para saber cómo puede gestionar su uso y cómo los acontecimientos personalizados pueden mejorar su formación sobre concienciación en materia de seguridad.
Consola de gestión de la API de acontecimientos de usuario
La consola de gestión de la API de acontecimientos de usuario es una ubicación centralizada en la que podrá supervisar y crear claves de API de acontecimientos de usuario, así como hacer un seguimiento de su uso. Puede acceder a ella desde la sección Integraciones de cuenta de la página Configuración de la cuenta de KSAT. La consola de gestión está dividida en tres pestañas principales: Historial de llamadas, Estadísticas y Clave de API. Para obtener más información sobre cada pestaña, consulte la siguiente tabla.
En la pestaña Historial de llamadas se mostrará una tabla con todas las llamadas a la API que se hayan procesado mediante la consola KSAT.
| Id. de estado | Clave de API | Acontecimientos creados | Errores | Fecha de procesamiento |
|---|---|---|---|---|
| Un identificador único generado para cada llamada a la API. | El nombre de la clave de API utilizada para realizar la llamada a la API. | El número de acontecimientos de usuario creados como resultado de la llamada a la API. | Todos los errores recibidos durante la llamada a la API. | La fecha y hora en que se procesó la solicitud de la API. Formato: dd/mm/aaaa, h:mm |
Vaya a la pestaña Estadísticas para controlar el uso mensual y anual de la API.
- Cuota mensual: en este gráfico circular de progreso se muestra su uso mensual de la API. El gráfico muestra el porcentaje de llamadas a la API realizadas en relación con el número de llamadas a la API permitidas. Se le permite realizar 10 llamadas a la API por licencia al día, durante todo el mes.
- Cuota anual: en este gráfico de barras se muestra su uso anual de la API. Los datos se desglosan según su cuota mensual para cada mes a lo largo de un periodo de 12 meses.
Use la pestaña Clave de API para crear una o varias claves de API. Su clave de API se usará para autenticar su consola KSAT cuando realice una llamada o solicitud de API. Para crear una clave de API, siga los pasos que se indican a continuación:
- En el campo Nombre, escriba un nombre exclusivo para la clave de API. Si pretende crear varias claves de API, le recomendamos que utilice un nombre significativo para reflejar mejor su uso previsto.
- Haga clic en el botón Crear clave de API. Se abrirá la ventana emergente Token de API de acontecimientos de usuario.
- Haga clic en el token de API de acontecimientos de usuario para copiarlo. Asegúrese de guardar el token de API copiado en algún sitio al que pueda acceder fácilmente. Cuando cierre esta ventana, no podrá volver a ver ese token.
- Haga clic en Aceptar.
Repita los pasos anteriores para crear tantas claves de API como desee. Una vez creadas, todas sus claves de API aparecerán en una tabla bajo la pestaña Clave de API.
| Clave | Nombre | Acciones |
|---|---|---|
| Un identificador único que sirve para autentificar una solicitud de API asociada a su consola KSAT. | El nombre personalizado que asignó a la clave de API cuando se creó. |
Tiene la opción de eliminar permanentemente una clave de API. Para ello, haga clic en el icono de la papelera.
Nota:Si elimina una clave de API, seguirá apareciendo un registro de su uso en la pestaña Historial de llamadas. |
Casos prácticos de la API de acontecimientos de usuario
A continuación, encontrará ejemplos de cómo pueden usarse los acontecimientos personalizados para mejorar su formación sobre concienciación en materia de seguridad. Para crear un grupo inteligente con acontecimientos personalizados, consulte la sección Criterios de acontecimiento personalizado de nuestro Resumen de grupos inteligentes.
| Tipo de acontecimiento | Acontecimientos de muestra | Caso práctico |
|---|---|---|
| Seguridad física |
|
Inscriba a los usuarios en una campaña de formación específica para un acontecimiento. Por ejemplo, puede asignar un módulo de formación sobre seguridad física de ModStore a todos los usuarios implicados en un acontecimiento de seguridad física. |
| Ingeniería social |
|
Inscriba a los usuarios en una campaña de phishing personalizada basada en la información de los empleados. Por ejemplo, puede enviar una plantilla de correo electrónico con un cupón para un restaurante local a todos los usuarios que cumplan años en el mes en curso. |
| Seguridad de terceros |
|
Haga un seguimiento de la participación de un usuario en un incidente de seguridad de terceros. Utilice esta información para asignarle contenidos de formación específicos de ese acontecimiento desde ModStore. |
| Desarrollo profesional | Certificaciones y formación desde otro LMS | Haga un seguimiento de la formación externa de las personas usuarias y de los logros que contribuyen a su concienciación en materia de seguridad. |