Événements relatifs à l'audit
Les événements d'audit sont générés automatiquement par Vonage lorsque l'utilisateur interagit avec une API de Vonage ou le tableau de bord de Vonage. Chaque objet d'événement d'audit a un type et des métadonnées associées.
Types d'événements d'audit
Le tableau suivant répertorie les types d'événements d'audit actuellement pris en charge :
| Type d'événement d'audit | Description |
|---|---|
| ACCOUNT_UPDATE_SETTINGS | Mise à jour des paramètres du compte |
| ACCOUNT_UPDATE_SETTINGS_API | Mise à jour des paramètres du compte via l'API |
| ACCOUNT_SECRET_CREATE | Opération de rotation secrète |
| ACCOUNT_SECRET_DELETE | Opération de rotation secrète |
| APP_CREATE | Application créée |
| APP_DELETE | Application supprimée |
| APP_DISABLE | Application désactivée |
| APP_ENABLE | Application activée |
| APP_UPDATE | Application mise à jour |
| AUTORELOAD_DISABLE | Recharge automatique désactivée |
| AUTORELOAD_ENABLE | Recharge automatique activée |
| AUTORELOAD_UPDATE | Mise à jour des paramètres de recharge automatique |
| NUMBER_ASSIGN | Numéro attribué |
| NUMBER_USER_CANCELED | Le numéro a été annulé par l'utilisateur |
| NUMBER_UPDATED | Nombre mis à jour |
| NUMBER_LINKED | Numéro lié à l'application Vonage |
| NUMBER_UNLINKED | Numéro dissocié de l'application Vonage |
| USER_API_KEYS_UPDATE | Sous-comptes pour l'utilisateur mis à jour |
| USER_BILLING_UPDATE | Mise à jour de la facturation des utilisateurs |
| USER_CREATE | Utilisateur créé |
| USER_LOGIN | Connexion de l'utilisateur (Support Premium uniquement) |
| USER_LOGOUT | Déconnexion de l'utilisateur (Support Premium uniquement) |
| USER_PRODUCT_SEARCH | Concerne la recherche de PCEM ou les journaux dans le tableau de bord |
| USER_STATUS | Mise à jour du statut de l'utilisateur |
| USER_UPDATE | Mise à jour de l'utilisateur |
| IP_WHITELIST_CREATE | Liste blanche IP ajoutée |
| IP_WHITELIST_CREATE | Liste blanche IP supprimée |
NOTE : La liste des types d'événements pris en charge change de temps à autre. C'est la raison pour laquelle l'outil OPTIONS est fournie pour renvoyer les types d'événements. Vous pouvez voir comment retourner la liste définitive des types d'événements à partir de la page Exemple de code pour l'obtention des types d'événements
Objets de l'événement d'audit
Lorsque vous récupérez des objets d'événements d'audit par l'intermédiaire de l'API, chacun d'entre eux est doté d'un élément event_type où le champ event_type sera une entrée du tableau ci-dessus. En outre, l'objet "événement d'audit" contient d'autres métadonnées en fonction du type.
Par exemple, pour un NUMBER_UPDATED l'objet de l'événement ressemblerait à ce qui suit :
{
"_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"
}
}