审计日志

概述

审计日志按时间顺序记录工作区内执行的管理操作，支持安全监控、合规报告和事件调查。覆盖用户配置、身份验证、API 密钥管理及其他管理功能中超过 100 个端点。

日志采用 OCSF v1.6.0 架构输出，并应用 datetime 和 host 配置文件，因此大多数条目只需少量规范化处理即可导入 SIEM。

访问要求

获取日志需通过以下两项独立检查：

请求使用工作区 API 密钥进行身份验证。与该密钥关联的用户或服务账户必须拥有 audit_log_read 权限。

获取日志

审计日志通过 GET /v1/workspace/audit-logs 返回。完整的查询参数列表和分页详情请参阅 API 参考文档。

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)

速率限制

每位用户每分钟最多可发送 30 个请求。结合最大 limit 值 100，每分钟最多可获取 3,000 个条目。

架构

审计日志遵循 OCSF v1.6.0 规范。事件类别专用字段会补充通用基础字段；各字段的响应架构请参阅 API 参考文档。

事件类别

目前会输出以下 OCSF 类别：

OCSF 合规性尽力而为。如存在标准 OCSF 字段，审计条目会使用该字段；unmapped 字段则包含不符合该标准的 ElevenLabs 专属属性。

活动名称

每个条目的 activity_name 用于说明被审计的具体操作，例如 API Key Creation。完整的活动名称列表以 AuditActivityName 枚举形式发布在我们的 OpenAPI 规范中；请参阅 GET /v1/workspace/audit-logs 的 activity_name 过滤器。

脱敏

在写入审计条目前，URL 路径或查询参数中可能出现的敏感信息会被脱敏。密码重置令牌便是其中一例；对于 URL 结构中包含密钥的所有审计相关请求，同样会进行脱敏处理。