Auditlogs

Overzicht

Auditlogs bieden een chronologisch overzicht van administratieve acties die binnen je workspace worden uitgevoerd, ter ondersteuning van beveiligingsmonitoring, compliancerapportage en incidentonderzoek. De dekking omvat meer dan 100 endpoints voor gebruikersprovisioning, authenticatie, beheer van API-sleutels en andere administratieve onderdelen.

Logs worden uitgegeven in het schema OCSF v1.6.0 met de profielen datetime en host toegepast, zodat de meeste vermeldingen met minimale normalisatie in een SIEM kunnen worden opgenomen.

Toegangsvereisten

Twee onafhankelijke controles bepalen of logs kunnen worden opgehaald:

Requests authenticeren met een API-sleutel van de workspace. De gebruiker of het serviceaccount dat aan de sleutel is gekoppeld, moet de machtiging audit_log_read hebben.

Logs ophalen

Auditlogs worden geretourneerd door GET /v1/workspace/audit-logs. Bekijk de API-referentie voor de volledige lijst met queryparameters en details over 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)

Ratelimieten

Requests zijn beperkt tot 30 per minuut per gebruiker. In combinatie met de maximale limit van 100 zijn hiermee maximaal 3.000 vermeldingen per minuut mogelijk.

Schema

Auditlogs volgen de specificatie OCSF v1.6.0. Veldspecifieke velden voor eventklassen vullen een gemeenschappelijke basis aan; bekijk de API-referentie voor het responseschema per veld.

Eventklassen

De volgende OCSF-klassen worden momenteel uitgegeven:

Naleving van OCSF gebeurt naar beste vermogen. Wanneer er een canoniek OCSF-veld bestaat, gebruiken auditvermeldingen dit; het veld unmapped bevat eventuele ElevenLabs-specifieke kenmerken die niet binnen de standaard passen.

Redactie

Gevoelig materiaal dat anders in URL-paden of queryparameters zou verschijnen, wordt geredigeerd voordat auditvermeldingen worden geschreven. Tokens voor wachtwoordherstel zijn een voorbeeld; vergelijkbare redactie geldt voor elk auditrelevant request waarvan de URL-structuur geheimen bevat.