Compliance APIのセットアップ

Compliance APIは2種類のキーを使用し、どちらを作成するかは組織が使用しているClaude製品によって異なります。プライマリオーナーと組織オーナーはclaude.aiでCompliance Access Keyを作成します。これらのキーはCompliance API全体へのアクセスを提供します。プライマリオーナーのキーは親組織配下のすべての組織をカバーでき、組織オーナーのキーは自身の組織のみをカバーします。組織管理者はClaude ConsoleでAdmin APIキーを作成します。これらのキーはActivity Feedのみへのアクセスを提供します。



どのキーが必要ですか？

Claude Enterpriseテナントには1つの親組織があり、その配下にあるすべてのワークロード組織のID、SSO、SCIMを一元管理します。これらのワークロード組織は親組織のリンクされた組織です。



Compliance APIのセットアップ

セットアップは1つのフローです。組織でCompliance APIを有効化し、その後claude.aiでCompliance Access Keyを作成します。Claude Console組織の場合は、有効化後に代わりにAdmin APIキーを作成します。Admin APIキーはActivity Feedのみにアクセスできます。



Admin APIキーの作成

Admin APIキーの作成の手順に従い、その後キーを環境変数として設定します。

export ANTHROPIC_ADMIN_KEY=sk-ant-admin01-...

この別個の変数名により、両方をプロビジョニングした場合にAdmin APIキーがCompliance Access Keyを上書きすることを防ぎます。このガイドのcURL例は$ANTHROPIC_COMPLIANCE_ACCESS_KEYからキーを読み取ります。Admin APIキーでActivity Feedを呼び出す場合は、$ANTHROPIC_ADMIN_KEYに置き換えてください。

Admin APIキーは、キーの作成時点で組織のCompliance APIが有効化されていた場合にのみread:compliance_activitiesスコープを持ちます。Compliance APIのセットアップを参照してください。他のCompliance APIスコープを付与することはできないため、Activity Feed以外のエンドポイントへの呼び出しは403 Forbiddenを返します。

同じキーがClaude Console組織の管理において果たす役割については、Admin APIを参照してください。



キーのスコープを確認する

すでにお持ちのキーのスコープを確認するには、次のいずれかの方法を使用してください。

• キーのプレフィックス。 sk-ant-admin01-はAdmin APIキーです（前のセクションで説明した有効化タイミングの条件に従い、read:compliance_activitiesのみを持ちます）。sk-ant-api01-はCompliance Access Keyで、そのスコープは作成時に選択したサブセットです。
• 設定UI。 claude.ai > Organization settings > APIのKeysセクション、またはClaude Console > Settings > Admin keysのAdmin keysセクションを開き、該当キーのScopes列を確認します。
• エラーレスポンス。 キーのスコープを超える呼び出しは、Missing required scopes. Got: [<scopes the key carries>] Needed: [<scopes the endpoint requires>]という形式のメッセージとともに403を返します。エラーの完全なカタログについては、Compliance APIエラーの処理を参照してください。

{
  "error": {
    "type": "permission_error",
    "message": "Missing required scopes. Got: ['read:compliance_activities'] Needed: ['read:compliance_user_data']"
  }
}



キーの管理とローテーション

Compliance Access Keyは、作成したのと同じKeysテーブルから削除します。claude.ai > Organization settings > APIに移動してください。Admin APIキーはClaude Console > Settings > Admin keysから削除します。

キーの削除は次のリクエストから有効になります。猶予期間はありません。Compliance Access Keyは自動的に期限切れになることはありません。

停止時間なしでキーをローテーションするには：

1. 同じスコープを持つ新しいキーを作成します。
2. 統合を更新して新しいキーを使用するようにします。
3. 新しいキーで統合が成功することを確認します。
4. 古いキーを削除します。

ローテーション前に保存されたページネーションカーソルは引き続き有効です。カーソルはキーではなく組織にスコープされています。

Compliance Access Keyが漏洩した場合は、直ちに削除し、Activity Feedで侵害されたキーによるcompliance_api_accessedアクティビティを監査し、漏洩したキーがアクセスできた下流の認証情報をすべてローテーションしてください。クエリを絞り込むにはactivity_types[]=compliance_api_accessedを渡し、クライアント側でactor.typeがapi_actorであり、かつactor.api_key_idが侵害されたキーと一致するアクティビティを抽出します。アクタースキーマについては、Activityオブジェクトを理解するを参照してください。



次のステップ