Hoppa till navigering

Granskningsloggar

Hämta en strukturerad logg över administrativa åtgärder i din arbetsyta.

Översikt

Granskningsloggar ger en kronologisk logg över administrativa åtgärder som utförs i din arbetsyta och stöder säkerhetsövervakning, efterlevnadsrapportering och incidentutredningar. De täcker över 100 endpoints inom användarprovisionering, autentisering, hantering av API-nycklar och andra administrativa områden.

Loggar skickas i schemat OCSF v1.6.0 med profilerna datetime och host tillämpade, så de flesta poster kan läsas in i ett SIEM med minimal normalisering.

Åtkomstkrav

Två oberoende kontroller styr hämtningen:

KravInformation
ArbetsytenivåEnterprise
API-nyckelbehörighetaudit_log_read

Begäranden autentiseras med en API-nyckel för arbetsytan. Användaren eller tjänstkontot som är kopplat till nyckeln måste ha behörigheten audit_log_read.

Hämta loggar

Granskningsloggar returneras av GET /v1/workspace/audit-logs. Se API-referensen för den fullständiga listan över frågeparametrar och information om paginering.

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)

Hastighetsbegränsningar

Begäranden är begränsade till 30 per minut och användare. Tillsammans med det högsta limit-värdet på 100 tillåter detta upp till 3 000 poster per minut.

Schema

Granskningsloggar följer specifikationen OCSF v1.6.0. Fält som är specifika för händelseklassen kompletterar en gemensam grund; se API-referensen för svarsschemat för varje fält.

Händelseklasser

Följande OCSF-klasser skickas i dag:

KlassUIDExempel
Kontoändring3001Användare skapad, lösenord ändrat, MFA-faktor aktiverad.
Autentisering3002Inloggning, utloggning, kontobyte.
Entitetshantering3004Resurs skapad, uppdaterad, borttagen eller flyttad.
Hantering av användaråtkomst3005Behörigheter tilldelade eller återkallade.
Grupphantering3006Grupp skapad, användare tillagd eller borttagen, undergrupp tillagd eller borttagen.

OCSF-efterlevnad sker efter bästa förmåga. När ett kanoniskt OCSF-fält finns används det i granskningsposterna; fältet unmapped innehåller eventuella ElevenLabs-specifika attribut som inte passar standarden.

Aktivitetsnamn

Varje posts activity_name beskriver den specifika åtgärd som granskades, till exempel API Key Creation. Den fullständiga listan över aktivitetsnamn publiceras som enumen AuditActivityName i vår OpenAPI-specifikation; se filtret activity_name på GET /v1/workspace/audit-logs.

Maskning

Känsligt material som annars skulle visas i URL-sökvägar eller frågeparametrar maskas innan granskningsposter skrivs. Återställningstoken för lösenord är ett sådant fall; motsvarande maskning tillämpas på alla granskningsrelevanta begäranden vars URL-struktur innehåller hemligheter.