Eventos de Audit
Los eventos de auditoría son generados automáticamente por Vonage cuando el usuario interactúa con una API de Vonage o con el panel de Vonage. Cada objeto de evento de auditoría tiene un tipo y metadatos asociados.
Tipos de eventos de Audit
En la siguiente tabla se enumeran los tipos de eventos de Audit compatibles actualmente:
| Tipo de evento de Audit | Descripción |
|---|---|
| ACCOUNT_UPDATE_SETTINGS | Se han actualizado los ajustes de la cuenta |
| ACCOUNT_UPDATE_SETTINGS_API | Configuración de Account actualizada mediante API |
| ACCOUNT_SECRET_CREATE | Operación «Rotación secreta» |
| ACCOUNT_SECRET_DELETE | Operación «Rotación secreta» |
| APP_CREATE | Aplicación creada |
| APP_DELETE | Aplicación eliminada |
| APP_DISABLE | Aplicación desactivada |
| APP_ENABLE | Aplicación habilitada |
| APP_UPDATE | Aplicación actualizada |
| AUTORELOAD_DISABLE | Recarga automática desactivada |
| AUTORELOAD_ENABLE | Recarga automática activada |
| AUTORELOAD_UPDATE | Se han actualizado los ajustes de recarga automática |
| NUMBER_ASSIGN | Numbers assigned |
| NUMBER_USER_CANCELED | El usuario ha cancelado el número de Numbers |
| NUMBER_UPDATED | Número actualizado |
| NUMBER_LINKED | Número vinculado a la aplicación de Vonage |
| NUMBER_UNLINKED | Número desvinculado de la aplicación de Vonage |
| USER_API_KEYS_UPDATE | Se han actualizado las cuentas de usuario |
| USER_BILLING_UPDATE | Se ha actualizado la facturación de los usuarios |
| USER_CREATE | Usuario creado |
| USER_LOGIN | Inicio de sesión de usuario (Sólo asistencia Premium) |
| USER_LOGOUT | Cerrar sesión de usuario (Sólo asistencia Premium) |
| USER_PRODUCT_SEARCH | Se refiere a la búsqueda de CDR o registros en el Panel de control |
| USER_STATUS | Estado del usuario actualizado |
| USER_UPDATE | El usuario ha actualizado la información |
| IP_WHITELIST_CREATE | Lista blanca IP añadida |
| IP_WHITELIST_CREATE | Se ha eliminado la dirección IP de la lista blanca |
NOTA: La lista de tipos de eventos admitidos cambia de vez en cuando. Por este motivo, la OPTIONS para devolver tipos de eventos. Puede ver cómo devolver la lista definitiva de tipos de eventos en la página Obtener tipos de eventos fragmento de código
Audit objetos de eventos
Cuando recuperes objetos «Audit Events» a través de la API, cada uno de ellos tendrá un event_type campo, donde el event_type será una entrada de la tabla anterior. Además, el objeto «Evento de Audit» contiene otros metadatos en función del tipo.
Por ejemplo, para un NUMBER_UPDATED el objeto de evento se parecería a lo siguiente:
{
"_links": {
"self": {
"href": "http://api.nexmo.com/beta/audit/events/aaaaaaaa-bbbb-cccc-dddd-0123456789ab"
}
},
"id": "aaaaaaaa-bbbb-cccc-dddd-0123456789ab",
"event_type": "NUMBER_UPDATED",
"event_type_description": "Number updated",
"created_at": "2018-05-16T16:34:22",
"user_email": "yourname@example.com",
"user_id": 1234567,
"account_id": "VONAGE_API_KEY",
"source": "CD",
"source_ip": "1.2.3.4",
"source_description": "Customer dashboard",
"source_country": "GB",
"context": {
"country": "GB",
"msisdn": "447700900000",
"http": "http://example.com:9000/webhooks/inbound-sms",
"voice-type": "app",
"voice-value": "VONAGE_APP_ID"
}
}