Log di audit
Panoramica
I log di audit forniscono un registro cronologico delle azioni amministrative eseguite nel tuo workspace, a supporto del monitoraggio della sicurezza, della reportistica di conformità normativa e delle indagini sugli incidenti. Coprono oltre 100 endpoint relativi al provisioning degli utenti, all’autenticazione, alla gestione delle chiavi API e ad altre aree amministrative.
I log vengono generati secondo lo schema OCSF v1.6.0, con l’applicazione dei profili datetime e host, pertanto la maggior parte delle voci può essere acquisita in un SIEM con una normalizzazione minima.
Requisiti di accesso
Il recupero è soggetto a due controlli indipendenti:
Le richieste vengono autenticate con una chiave API del workspace. L’utente o l’account di servizio associato alla chiave deve disporre dell’autorizzazione audit_log_read.
Recupero dei log
I log di audit vengono restituiti da GET /v1/workspace/audit-logs. Consulta il Riferimento API per l’elenco completo dei parametri query e i dettagli sulla paginazione.
Python
TypeScript
Limiti di frequenza
Le richieste sono limitate a 30 al minuto per utente. In combinazione con il valore massimo di limit pari a 100, ciò consente fino a 3.000 voci al minuto.
Schema
I log di audit seguono la specifica OCSF v1.6.0. I campi specifici della classe di evento integrano una base comune; consulta il Riferimento API per lo schema di risposta di ciascun campo.
Classi di eventi
Attualmente vengono generate le seguenti classi OCSF:
La conformità a OCSF viene garantita nei limiti del possibile. Quando esiste un campo OCSF canonico, le voci di audit lo utilizzano; il campo unmapped contiene eventuali attributi specifici di ElevenLabs che non rientrano nello standard.
Nomi delle attività
Il campo activity_name di ogni voce descrive l’azione specifica sottoposta ad audit, ad esempio API Key Creation. L’elenco completo dei nomi delle attività è pubblicato come enum AuditActivityName nella nostra specifica OpenAPI; consulta il filtro activity_name in GET /v1/workspace/audit-logs.
Oscuramento
I dati sensibili che altrimenti apparirebbero nei path degli URL o nei parametri query vengono oscurati prima della scrittura delle voci di audit. I token per la reimpostazione della password sono uno di questi casi; un oscuramento equivalente si applica a qualsiasi richiesta rilevante per l’audit la cui struttura URL contenga segreti.