> 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.

# Audit-Logs

## Übersicht

Audit-Logs liefern eine chronologische Aufzeichnung administrativer Aktionen in Ihrem Workspace und unterstützen Sicherheitsüberwachung, Compliance-Berichte und die Untersuchung von Vorfällen. Sie decken über 100 Endpoints für Nutzerbereitstellung, Authentifizierung, API-Schlüsselverwaltung und weitere administrative Bereiche ab.

Logs werden im Schema [OCSF v1.6.0](https://schema.ocsf.io/1.6.0) mit den Profilen `datetime` und `host` ausgegeben. Daher können die meisten Einträge mit minimaler Normalisierung in ein SIEM aufgenommen werden.

## Zugriffsanforderungen

Zwei unabhängige Prüfungen sind für den Abruf erforderlich:

| Anforderung               | Details          |
| ------------------------- | ---------------- |
| Workspace-Tarif           | Enterprise       |
| API-Schlüsselberechtigung | `audit_log_read` |

Anfragen werden mit einem Workspace-API-Schlüssel authentifiziert. Der mit dem Schlüssel verknüpfte Nutzer oder das Dienstkonto muss die Berechtigung `audit_log_read` besitzen.

## Logs abrufen

Audit-Logs werden über [`GET /v1/workspace/audit-logs`](/docs/de/api-reference/workspace/audit-logs/list) zurückgegeben. Die vollständige Liste der Abfrageparameter und Details zur Paginierung finden Sie in der API-Referenz.

#### 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);
}
```

### Ratenlimits

Anfragen sind auf 30 pro Minute und Nutzer begrenzt. In Verbindung mit dem maximalen `limit` von 100 sind damit bis zu 3.000 Einträge pro Minute möglich.

## Schema

Audit-Logs folgen der Spezifikation [OCSF v1.6.0](https://schema.ocsf.io/1.6.0). Ereignisklassenspezifische Felder ergänzen eine gemeinsame Basis; das Antwortschema für jedes Feld finden Sie in der API-Referenz.

### Ereignisklassen

Derzeit werden folgende OCSF-Klassen ausgegeben:

| Klasse                   | UID    | Beispiele                                                           |
| ------------------------ | ------ | ------------------------------------------------------------------- |
| Kontoänderung            | `3001` | Nutzer erstellt, Passwort geändert, MFA-Faktor aktiviert.           |
| Authentifizierung        | `3002` | Anmeldung, Abmeldung, Kontowechsel.                                 |
| Entitätsverwaltung       | `3004` | Ressource erstellt, aktualisiert, gelöscht oder verschoben.         |
| Nutzerzugriffsverwaltung | `3005` | Berechtigungen zugewiesen oder entzogen.                            |
| Gruppenverwaltung        | `3006` | Gruppe erstellt, Nutzer oder Untergruppe hinzugefügt oder entfernt. |

Die OCSF-Konformität erfolgt nach bestem Aufwand. Wenn ein kanonisches OCSF-Feld vorhanden ist, verwenden Audit-Einträge dieses; das Feld `unmapped` enthält ElevenLabs-spezifische Attribute, die nicht in den Standard passen.

## Schwärzung

Sensible Daten, die andernfalls in URL-Pfaden oder Abfrageparametern erscheinen würden, werden geschwärzt, bevor Audit-Einträge geschrieben werden. Tokens zum Zurücksetzen von Passwörtern sind ein Beispiel dafür; eine entsprechende Schwärzung gilt für jede auditrelevante Anfrage, deren URL-Struktur Geheimnisse enthält.