Audit-Ereignisse
Audit-Ereignisse werden von Vonage automatisch generiert, wenn der Benutzer entweder mit einer Vonage API oder dem Vonage Dashboard interagiert. Jedes Audit-Ereignis-Objekt hat einen Typ und zugehörige Metadaten.
Audit Ereignisarten
In der folgenden Tabelle sind die derzeit unterstützten Audit-Ereignistypen aufgeführt:
| Audit-Ereignis-Typ | Beschreibung |
|---|---|
| ACCOUNT_UPDATE_SETTINGS | Account-Einstellungen aktualisiert |
| ACCOUNT_UPDATE_SETTINGS_API | Account-Einstellungen über API aktualisiert |
| ACCOUNT_SECRET_CREATE | Geheime Rotationsoperation |
| ACCOUNT_SECRET_DELETE | Geheime Rotationsoperation |
| APP_CREATE | App erstellt |
| APP_DELETE | App gelöscht |
| APP_DISABLE | App deaktiviert |
| APP_ENABLE | App aktiviert |
| APP_UPDATE | App aktualisiert |
| AUTORELOAD_DISABLE | Automatisches Nachladen deaktiviert |
| AUTORELOAD_ENABLE | Automatisches Nachladen aktiviert |
| AUTORELOAD_UPDATE | Einstellungen zum automatischen Nachladen aktualisiert |
| NUMBER_ASSIGN | Zugewiesene Numbers |
| NUMBER_USER_CANCELED | Numbers wurde vom Benutzer storniert |
| NUMBER_UPDATED | Numbers aktualisiert |
| NUMBER_LINKED | Mit der Vonage-Anwendung verknüpfte Numbers |
| NUMBER_UNLINKED | Von der Vonage-Anwendung entkoppelte Numbers |
| USER_API_KEYS_UPDATE | Unterkonten für Benutzer aktualisiert |
| USER_BILLING_UPDATE | Benutzerabrechnung aktualisiert |
| USER_CREATE | Benutzer erstellt |
| USER_LOGIN | Benutzeranmeldung (nur Premium Support) |
| USER_LOGOUT | Benutzerabmeldung (nur Premium Support) |
| USER_PRODUCT_SEARCH | Bezieht sich auf die Suche nach CDRs oder Protokolle im Dashboard |
| USER_STATUS | Benutzerstatus aktualisiert |
| USER_UPDATE | Benutzer aktualisiert |
| IP_WHITELIST_CREATE | Whitelist IP hinzugefügt |
| IP_WHITELIST_CREATE | Whitelist IP gelöscht |
HINWEIS: Die Liste der unterstützten Ereignistypen ändert sich von Zeit zu Zeit. Aus diesem Grund wird die OPTIONS Methode ist vorgesehen, um Ereignistypen zurückzugeben. Wie Sie die endgültige Liste der Ereignistypen zurückgeben können, sehen Sie in der Codeschnipsel Ereignistypen abrufen
Audit-Ereignisobjekte
Wenn Sie Audit-Ereignisobjekte über die API abrufen, haben sie jeweils eine event_type Feld, in dem die event_type wird ein Eintrag aus der obigen Tabelle sein. Darüber hinaus enthält das Audit-Ereignisobjekt je nach Typ weitere Metadaten.
Zum Beispiel, für eine NUMBER_UPDATED Ereignistyps würde das Ereignisobjekt folgendermaßen aussehen:
{
"_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"
}
}