取得 Compliance API 存取權限

Compliance API 使用兩種金鑰類型，您應建立哪一種取決於您的組織使用哪個 Claude 產品。主要擁有者在 claude.ai 中建立 Compliance Access Key；這些金鑰可解鎖完整的 Compliance API。組織管理員在 Claude Console 中建立 Admin API 金鑰；這些金鑰僅能解鎖 Activity Feed。

您需要哪種金鑰？

Claude Enterprise 租戶擁有一個父組織，為其下的每個工作負載組織集中管理身分識別、SSO 和 SCIM。這些工作負載組織即為父組織的連結組織。

申請 Compliance API 存取權限

請聯絡您的 Anthropic 代表以申請存取權限。啟用作業在父組織層級進行，並會向下套用至每個連結組織，包括 claude.ai 和 Claude Console。啟用後的變化取決於您的組織使用哪個 Claude 產品。

啟用後：claude.ai 組織

Anthropic 為您的父組織啟用 Compliance API 後，主要擁有者即可從 claude.ai > Organization settings > API 的 Keys 區段建立 Compliance Access Key。

啟用後：Claude Console 組織

Anthropic 為您的父組織啟用 Compliance API 後，此後建立的 Admin API 金鑰將帶有 read:compliance_activities 範圍。啟用前建立的 Admin API 金鑰仍可繼續用於 Admin API，但使用這些金鑰呼叫 Activity Feed 會傳回 403 Forbidden；請建立新的 Admin API 金鑰以取得該範圍。

建立 Compliance Access Key

建立 Admin API 金鑰

只有在建立金鑰之前已為組織啟用 Compliance API 的情況下，Admin API 金鑰才會帶有 read:compliance_activities 範圍；請參閱啟用後：Claude Console 組織。這些金鑰無法被授予任何其他 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 欄位。
• 錯誤回應。 超出金鑰範圍的呼叫會傳回 403，並附帶格式為 Missing required scopes. Got: [<scopes the key carries>] Needed: [<scopes the endpoint requires>] 的訊息。完整的錯誤目錄請參閱處理 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。從 Claude Console > Settings > Admin keys 刪除 Admin API 金鑰。

刪除金鑰會在下一次請求時生效：沒有寬限期。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 與遭洩漏金鑰相符的活動；actor 結構描述請參閱了解 Activity 物件。

後續步驟