Vai alla navigazione

Log di audit

Recupera un registro strutturato delle azioni amministrative nel tuo workspace.

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:

RequisitoDettaglio
Piano del workspaceEnterprise
Autorizzazione chiave APIaudit_log_read

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.

from dotenv import load_dotenv
import os
from elevenlabs import ElevenLabs
load_dotenv()
elevenlabs = ElevenLabs(api_key=os.getenv("ELEVENLABS_API_KEY"))
page = elevenlabs.workspace.audit_logs.list(limit=50)
for entry in page.entries:
print(entry.time_dt, entry.class_name, entry.activity_name)

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:

ClasseUIDEsempi
Modifica dell’account3001Utente creato, password modificata, fattore MFA abilitato.
Autenticazione3002Accesso, disconnessione, cambio di account.
Gestione delle entità3004Risorsa creata, aggiornata, eliminata o spostata.
Gestione accessi utenti3005Privilegi assegnati o revocati.
Gestione dei gruppi3006Gruppo creato, utente aggiunto o rimosso, sottogruppo aggiunto o rimosso.

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.