La API de eventos de usuario le permite importar los eventos relacionados con la seguridad o las actividades de capacitación de sus usuarios de fuentes externas e incluirlos en su consola de KSAT. Una vez importados, sus eventos personalizados aparecerán en la línea temporal del usuario de los usuarios afectados y puede influir en el puntaje de riesgo personal de los usuarios.
Para conocer todos los detalles sobre la API de eventos de usuario y ver solicitudes de ejemplo, consulte nuestra documentación para desarrolladores de API de eventos de usuario documentación para desarrolladores de API de eventos de usuario (el enlace se abre en otra ventana). Si elige usar la API de eventos de usuario de KnowBe4, consulte las siguientes secciones para ver cómo gestionar su uso de la API y cómo los eventos personalizados pueden fortalecer su capacitación en concientización sobre seguridad.
Consola de administración de la API de eventos de usuario
La consola de administración de la API de eventos de usuario es la ubicación central para que supervise, cree y dé seguimiento al uso de sus claves de API de eventos de usuario. Puede acceder a la consola de administración desde la sección Integraciones de la cuenta en su página de Configuración de la cuenta de KSAT. La consola de administración se divide 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 muestra una tabla de todas las llamadas API que se procesaron utilizando su consola de KSAT.
| Identificación de estado | Clave de API | Eventos creados | Errores | Fecha de procesamiento |
|---|---|---|---|---|
| Un identificador único generado para cada llamada API. | El nombre de la clave de API se utiliza para realizar la llamada API. | El número de eventos de usuario creados como resultado de la llamada API. | Todos los errores recibidos durante la llamada API. | Fecha y hora en que se procesó la solicitud de API. Formato: mm/dd/aaaa, h:mm a |
Consulte la pestaña Estadísticas para supervisar su uso mensual y anual de la API.
- Cuota mensual: en este círculo de progreso se muestra su uso mensual de la API. El gráfico exhibe un porcentaje de las llamadas API realizadas en relación con la cantidad de llamadas API permitidas. Se le permiten 10 llamadas por puesto por cada día de cada mes.
- Cuota anual: este gráfico de barras indica su uso anual de la API. Los datos se desglosan según su cuota mensual para cada mes durante un plazo de 12 meses.
Utilice la pestaña Clave de API para crear una o más claves de API. Su clave de API se utilizará para autenticar su consola de KSAT al realizar solicitudes o llamadas API. Para crear una clave de API, siga estos pasos:
- En el campo Nombre, ingrese un nombre único para su clave de API. Si tiene pensado crear varias claves de API, le recomendamos utilizar un nombre significativo que refleje el uso previsto para cada clave.
- Haga clic en el botón Crear clave de API. Se abrirá la ventana emergente Token de API de eventos de usuario.
- Haga clic en el token de API de eventos de usuario 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.
Repita estos pasos para crear todas las claves de API que desee. Una vez creadas, sus claves de API se mostrarán en una tabla en la pestaña Clave de API.
| Clave | Nombre | Actions |
|---|---|---|
| Un identificador único utilizado para autenticar una solicitud de API asociada con su consola de KSAT. | El nombre personalizado que le asignó a su clave de API cuando la creó. |
Puede eliminar la clave de API de manera permanente si así lo desea. Para eliminar una clave, haga clic en el ícono de papelera.
Nota: Si elimina una clave de API, seguirá estando disponible un registro del uso de la clave en la pestaña Historial de llamadas. |
Casos de uso de la API de eventos de usuario
A continuación se muestran ejemplos de cómo se pueden usar los eventos personalizados para fortalecer su capacitación en concientización sobre seguridad. Para crear un grupo inteligente con eventos personalizados, consulte la sección Criterios de evento personalizado de nuestra Descripción general de Grupos inteligentes.
| Tipo de evento | Eventos de ejemplo | Caso de uso |
|---|---|---|
| Seguridad física |
|
Inscriba a los usuarios en una campaña de capacitación específica a partir de un evento. Por ejemplo, puede asignar un módulo de capacitación de seguridad física desde ModStore para todos los usuarios que hayan estado involucrados en un evento de seguridad física. |
| Ingeniería social |
|
Inscriba a los usuarios en una campaña de phishing personalizada en función de la información sobre el personal. Por ejemplo, puede enviar una plantilla de correo electrónico con un cupón para usar en un restaurante local a todos los usuarios que cumplan años en el mes actual. |
| Seguridad de terceros |
|
Rastree la participación de los usuarios en incidentes de seguridad de terceros. Puede utilizar esta información para seleccionar contenido de capacitación específico para eventos desde ModStore para realizar inscripciones. |
| Desarrollo profesional | Certificaciones y capacitación de otro LMS | Haga un seguimiento de la capacitación externa de un usuario y sus logros que contribuyen con su concientización sobre seguridad. |