Journaux d'audit

Vue d’ensemble

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

Les journaux sont produits selon le schéma OCSF v1.6.0, avec les profils datetime et host appliqués. La plupart des entrées peuvent ainsi être ingérées dans un SIEM avec une normalisation minimale.

Conditions d’accès

Deux contrôles indépendants régissent la récupération :

Les requêtes sont authentifiées à l’aide d’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. Consultez le Guide de l’API pour accéder à la liste complète des paramètres de requête et aux détails de la pagination.

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)

Limites de débit

Les requêtes sont limitées à 30 par minute et par utilisateur. Associée à la valeur limit maximale de 100, cette limite permet de récupérer jusqu’à 3 000 entrées par minute.

Schéma

Les journaux d’audit suivent la spécification OCSF v1.6.0. Des champs spécifiques à chaque classe d’événements complètent une base commune. Consultez le Guide de l’API pour le schéma de réponse de chaque champ.

Classes d’événements

Les classes OCSF suivantes sont actuellement produites :

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

Noms d’activité

Le champ activity_name de chaque entrée décrit l’action spécifique auditée, par exemple API Key Creation. La liste exhaustive des noms d’activité est publiée sous forme d’énumération AuditActivityName dans notre spécification OpenAPI. Consultez le filtre activity_name de GET /v1/workspace/audit-logs.

Masquage

Les données sensibles qui apparaîtraient autrement dans les chemins d’URL ou les paramètres de requête sont masquées 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.