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"
        }
      }