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

# Journaux d'audit

## Présentation

Les journaux d'audit fournissent un enregistrement chronologique des actions administratives effectuées dans votre Workspace. Ils facilitent la surveillance de la sécurité, les rapports de conformité et l'investigation des incidents. Ils couvrent plus de 100 points de terminaison relatifs à l'approvisionnement des utilisateurs, à l'authentification, à la gestion des clés API et à d'autres surfaces administratives.

Les journaux sont générés selon le schéma [OCSF v1.6.0](https://schema.ocsf.io/1.6.0), avec les profils `datetime` et `host` appliqués. La plupart des entrées peuvent donc être ingérées dans un SIEM avec une normalisation minimale.

## Conditions d'accès

Deux vérifications indépendantes régissent la récupération :

| Exigence                | Détail           |
| ----------------------- | ---------------- |
| Niveau du Workspace     | Enterprise       |
| Autorisation de clé API | `audit_log_read` |

Les requêtes s'authentifient avec une clé API du Workspace. L'utilisateur ou le compte de service associé à la clé doit disposer de l'autorisation `audit_log_read`.

## Récupérer les journaux

Les journaux d'audit sont renvoyés par [`GET /v1/workspace/audit-logs`](/docs/fr/api-reference/workspace/audit-logs/list). Consultez le guide de l'API pour obtenir la liste complète des paramètres de requête et les détails de pagination.

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

### Limites de débit

Les requêtes sont limitées à 30 par minute et par utilisateur. Associé à la valeur maximale de `limit` de 100, cela permet d'obtenir jusqu'à 3 000 entrées par minute.

## Schéma

Les journaux d'audit suivent la spécification [OCSF v1.6.0](https://schema.ocsf.io/1.6.0). Des champs propres à chaque classe d'événement complètent une base commune. Consultez le guide de l'API pour le schéma de réponse champ par champ.

### Classes d'événements

Les classes OCSF suivantes sont actuellement générées :

| Classe                        | UID    | Exemples                                                                     |
| ----------------------------- | ------ | ---------------------------------------------------------------------------- |
| Modification de compte        | `3001` | Utilisateur créé, mot de passe modifié, facteur MFA activé.                  |
| Authentification              | `3002` | Connexion, déconnexion, changement de compte.                                |
| Gestion des entités           | `3004` | Ressource créée, mise à jour, supprimée ou déplacée.                         |
| Gestion des accès utilisateur | `3005` | Privilèges attribués ou révoqués.                                            |
| Gestion des groupes           | `3006` | Groupe créé, utilisateur ajouté ou supprimé, sous-groupe ajouté ou supprimé. |

La conformité à OCSF est assurée dans la mesure du possible. Lorsqu'un champ OCSF canonique existe, les entrées d'audit l'utilisent. Le champ `unmapped` contient les attributs propres à ElevenLabs qui ne correspondent pas à la norme.

## Masquage

Les éléments sensibles qui apparaîtraient autrement dans les chemins d'URL ou les paramètres de requête sont masqués avant l'écriture des entrées d'audit. Les jetons de réinitialisation de mot de passe en sont un exemple. Un masquage équivalent s'applique à toute requête pertinente pour l'audit dont la structure d'URL contient des secrets.