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

La siguiente tabla enumera los tipos de Eventos de Audit soportados actualmente:

Tipo de evento de Audit Descripción
ACCOUNT_UPDATE_SETTINGS Configuración de Account actualizada
ACCOUNT_UPDATE_SETTINGS_API Configuración de Account actualizada mediante API
ACCOUNT_SECRET_CREATE Operación de rotación secreta
ACCOUNT_SECRET_DELETE Operación de 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 Actualización de la configuración de recarga automática
NUMBER_ASSIGN Numbers assigned
NUMBER_USER_CANCELED Número cancelado por el usuario
NUMBER_UPDATED Numbers actualizados
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 Subcuentas de usuario actualizadas
USER_BILLING_UPDATE Facturación de usuarios actualizada
USER_CREATE Usuario creado
USER_LOGIN Inicio de sesión de usuario (Sólo asistencia Premium)
USER_LOGOUT Cierre de sesión de usuario (Sólo asistencia Premium)
USER_PRODUCT_SEARCH Se refiere a la búsqueda de CDRs o registros en el Cuadro de mandos
USER_STATUS Estado del usuario actualizado
USER_UPDATE Usuario actualizado
IP_WHITELIST_CREATE Lista blanca IP añadida
IP_WHITELIST_CREATE Lista blanca IP eliminada

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

Objetos de eventos de Audit

Cuando recupere objetos Audit Events a través de la API, cada uno de ellos tendrá un objeto event_type donde el campo event_type será una entrada de la tabla anterior. Además, el objeto Evento de auditoría 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"
        }
      }