Este artículo describe cómo configurar y utilizar la Integración con Vanta para exportar automáticamente a Vanta los registros de auditoría de concienciación generados en SMARTFENSE.
Workshop: Integración con otros Productos
Objetivo de la integración
La Integración con Vanta permite enviar a Vanta registros de auditoría de SMARTFENSE relacionados con las acciones de concienciación realizadas por los usuarios, facilitando el cumplimiento y la evidencia de entrenamiento en marcos regulatorios.
API de Vanta utilizada
La integración utiliza la API de Vanta disponible en:
https://vanta-connectors.readme.io/docs
Configuración en SMARTFENSE
Para configurar la integración con Vanta en SMARTFENSE, dirígete a la sección Configuración > Integraciones > Vanta.
Para completar la configuración es necesario ingresar los siguientes datos:
OAuth client ID
OAuth client secret
Frameworks por defecto
Resource ID
Estos valores se obtienen siguiendo el instructivo de configuración correspondiente.
Registros de auditoría
Al guardar la configuración de la integración en SMARTFENSE, se genera automáticamente un registro de auditoría asociado a esta acción en la sección Auditoría > Administración.
Creación y edición de campañas
En la vista de creación o edición de cualquier tipo de campaña, al desplegar Más opciones, se muestra un subtítulo denominado Integración con Vanta.
Desde esta sección es posible:
Especificar un Framework particular para la campaña que se está creando o editando.
Utilizar, por defecto, el Framework configurado en Frameworks por defecto dentro de la sección de configuración de la integración.
Exportación de registros
La integración permite la exportación automática de registros de auditoría desde SMARTFENSE hacia Vanta.
La exportación se realiza una vez por día.
Los registros exportados están relacionados con el estado de cada usuario respecto a cada campaña en la que fue asignado.
Las campañas de prueba se excluyen de esta exportación.
API de Vanta impactada
UserSecurityTrainingStatus
Datos enviados a Vanta por usuario y campaña
A continuación se detallan los campos enviados a Vanta por cada usuario asignado a una campaña:
| Campo en Vanta | Type | Campo de SMARTFENSE |
|---|---|---|
| displayName | string | Nombre de la campaña si existe; de lo contrario, nombre del tópico/escenario |
| uniqueId | string | Id de la estadística de la campaña |
| externalUrl | string | URL de asignación |
| trainingId | String | URL del detalle de campaña |
| trainingName | String | Nombre del tópico/escenario de la campaña |
| frameworksFulfilled | List[Enum["SOC2","ISO27001","HIPAA","PCI","GDPR","CCPA"]] | Framework de la campaña |
| traineeFullName | String | Nombre del usuario |
| traineeAccountName | String | Nombre de usuario del usuario |
| traineeEmail | Email del usuario | |
| status | Enum["INCOMPLETE","COMPLETE"] | Estado del usuario en la campaña |
| trainingCreatedTimestamp | DateTime | Fecha de inicio de la campaña |
| trainingDueTimestamp | DateTime | Fecha de expiración de la campaña |
| trainingCompletedTimestamp | Optional[DateTime] | Fecha de la interacción que generó el estado COMPLETE |
Estado del usuario en la campaña
El estado enviado a Vanta se determina según el componente y la condición alcanzada:
| Campaña | Condición | Estado |
|---|---|---|
| Módulos interactivos | Abierto / Comenzado | INCOMPLETE |
| Módulos interactivos | Finalizado | COMPLETE |
| Videos | Abierto / Comenzado | INCOMPLETE |
| Videos | Finalizado | COMPLETE |
| Videojuegos | Abierto / Comenzado | INCOMPLETE |
| Videojuegos | Finalizado | COMPLETE |
| Encuestas | Abierto / Comenzado | INCOMPLETE |
| Encuestas | Finalizado | COMPLETE |
| Exámenes | Abierto | INCOMPLETE |
| Exámenes | Aprobado / Desaprobado | COMPLETE |
| Newsletters | Enviado | INCOMPLETE |
| Newsletters | Abierto | COMPLETE |
Registro de auditoría administrativa de la exportación
En la sección Auditoría > Administración es posible consultar el resultado de cada exportación diaria hacia Vanta.
La estructura del registro incluye:
Fecha
Usuario: Sistema
Acción: Exportación de registros de auditoría hacia Vanta
Descripción: Y registros exportados
-
Detalle extra:
Registros a exportar: X
Registros exportados con éxito: Y
Registros con error: Z
Detalle del error: [Detalle]
💡 Mejores prácticas
Define correctamente los Frameworks por defecto para asegurar una clasificación consistente en Vanta.
Revisa diariamente los registros en Auditoría > Administración para validar el resultado de las exportaciones.
Configura frameworks específicos a nivel campaña cuando existan requisitos regulatorios distintos.
Evita incluir campañas de prueba en análisis de cumplimiento.