Dzienniki audytu

Omówienie

Dzienniki audytu zawierają chronologiczny zapis działań administracyjnych wykonanych w obszarze roboczym. Wspierają monitorowanie zabezpieczeń, raportowanie zgodności i badanie incydentów. Obejmują ponad 100 endpointów związanych z udostępnianiem użytkowników, uwierzytelnianiem, zarządzaniem kluczami API i innymi obszarami administracyjnymi.

Dzienniki są generowane w schemacie OCSF v1.6.0 z zastosowaniem profili datetime i host, więc większość wpisów można dodać do systemu SIEM przy minimalnej normalizacji.

Wymagania dostępu

Pobieranie wymaga spełnienia dwóch niezależnych warunków:

Żądania są uwierzytelniane kluczem API obszaru roboczego. Użytkownik lub konto usługi powiązane z kluczem musi mieć uprawnienie audit_log_read.

Pobieranie dzienników

Dzienniki audytu są zwracane przez GET /v1/workspace/audit-logs. Pełną listę parametrów zapytania i informacje o paginacji znajdziesz w dokumentacji API.

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)

Limity szybkości

Liczba żądań jest ograniczona do 30 na minutę na użytkownika. W połączeniu z maksymalną wartością limit wynoszącą 100 pozwala to pobrać do 3000 wpisów na minutę.

Schemat

Dzienniki audytu są zgodne ze specyfikacją OCSF v1.6.0. Pola specyficzne dla klasy zdarzenia uzupełniają wspólną bazę; schemat odpowiedzi dla poszczególnych pól znajdziesz w dokumentacji API.

Klasy zdarzeń

Obecnie generowane są następujące klasy OCSF:

Zgodność z OCSF jest zapewniana w miarę możliwości. Gdy istnieje kanoniczne pole OCSF, wpisy audytu go używają; pole unmapped zawiera atrybuty specyficzne dla ElevenLabs, które nie pasują do standardu.

Nazwy aktywności

Pole activity_name każdego wpisu opisuje konkretne działanie objęte audytem, na przykład API Key Creation. Pełna lista nazw aktywności jest opublikowana jako enum AuditActivityName w naszej specyfikacji OpenAPI; zobacz filtr activity_name w GET /v1/workspace/audit-logs.

Redakcja danych

Wrażliwe dane, które w innym przypadku pojawiłyby się w ścieżkach URL lub parametrach zapytania, są maskowane przed zapisaniem wpisów audytu. Przykładem są tokeny resetowania hasła; takie samo maskowanie dotyczy każdego żądania istotnego dla audytu, którego struktura URL zawiera sekrety.