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

# 監査ログ

## 概要

監査ログは、ワークスペース内で行われた管理アクションを時系列で記録し、セキュリティ監視、コンプライアンスレポート、インシデント調査を支援します。ユーザープロビジョニング、認証、APIキー管理、その他の管理機能にわたる100以上のエンドポイントをカバーしています。

ログは`datetime`および`host`プロファイルを適用した[OCSF v1.6.0](https://schema.ocsf.io/1.6.0)スキーマで出力されるため、ほとんどのエントリーは最小限の正規化でSIEMに取り込めます。

## アクセス要件

取得には、以下の2つの独立した要件を満たす必要があります。

| 要件         | 詳細               |
| ---------- | ---------------- |
| ワークスペースティア | エンタープライズ         |
| APIキー権限    | `audit_log_read` |

リクエストはワークスペースAPIキーで認証されます。キーに関連付けられたユーザーまたはサービスアカウントには、`audit_log_read`権限が必要です。

## ログの取得

監査ログは[`GET /v1/workspace/audit-logs`](/docs/ja/api-reference/workspace/audit-logs/list)によって返されます。クエリパラメーターの完全な一覧とページネーションの詳細については、APIリファレンスを参照してください。

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

### レート制限

リクエストはユーザーごとに1分あたり30回までに制限されています。最大`limit`の100と組み合わせると、1分あたり最大3,000件のエントリーを取得できます。

## スキーマ

監査ログは[OCSF v1.6.0](https://schema.ocsf.io/1.6.0)仕様に従います。イベントクラス固有のフィールドが共通ベースを補完します。フィールドごとのレスポンススキーマについては、APIリファレンスを参照してください。

### イベントクラス

現在、次のOCSFクラスが出力されます。

| クラス        | UID    | 例                                   |
| ---------- | ------ | ----------------------------------- |
| アカウント変更    | `3001` | ユーザー作成、パスワード変更、MFA要素の有効化。           |
| 認証         | `3002` | ログオン、ログオフ、アカウント切り替え。                |
| エンティティ管理   | `3004` | リソースの作成、更新、削除、移動。                   |
| ユーザーアクセス管理 | `3005` | 権限の付与または取り消し。                       |
| グループ管理     | `3006` | グループ作成、ユーザーの追加または削除、サブグループの追加または削除。 |

OCSF準拠はベストエフォートです。標準のOCSFフィールドが存在する場合は監査エントリーで使用し、標準に適合しないElevenLabs固有の属性は`unmapped`フィールドに格納されます。

## マスキング

URLパスまたはクエリパラメーターに含まれる機密情報は、監査エントリーが書き込まれる前にマスキングされます。パスワードリセットトークンはその一例です。URL構造にシークレットを含む、監査対象のあらゆるリクエストに同様のマスキングが適用されます。