> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# 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](https://schema.ocsf.io/1.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:

| Vereiste              | Details          |
| --------------------- | ---------------- |
| Workspace-tier        | Enterprise       |
| API-sleutelmachtiging | `audit_log_read` |

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`](/docs/nl/api-reference/workspace/audit-logs/list). Bekijk de API-referentie voor de volledige lijst met queryparameters en details over paginering.

#### Python

```python
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)
```

#### TypeScript

```typescript
import 'dotenv/config';
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient({ apiKey: process.env.ELEVENLABS_API_KEY });

const page = await elevenlabs.workspace.auditLogs.list({ limit: 50 });
for (const entry of page.entries) {
  console.log(entry.timeDt, entry.className, entry.activityName);
}
```

### 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](https://schema.ocsf.io/1.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:

| Klasse                       | UID    | Voorbeelden                                                                           |
| ---------------------------- | ------ | ------------------------------------------------------------------------------------- |
| Accountwijziging             | `3001` | Gebruiker gemaakt, wachtwoord gewijzigd, MFA-factor ingeschakeld.                     |
| Authenticatie                | `3002` | Inloggen, uitloggen, account wisselen.                                                |
| Entiteitsbeheer              | `3004` | Resource gemaakt, bijgewerkt, verwijderd of verplaatst.                               |
| Beheer van gebruikerstoegang | `3005` | Rechten toegewezen of ingetrokken.                                                    |
| Groepsbeheer                 | `3006` | Groep gemaakt, gebruiker toegevoegd of verwijderd, subgroep toegevoegd of verwijderd. |

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.