客戶管理的加密金鑰

claude "/claude-api tell me about customer-managed encryption keys"

「Customer-managed encryption key」（客戶管理的加密金鑰），即 CMEK，讓您可以在自己的 AWS KMS、Google Cloud KMS 或 Azure Key Vault 中佈建加密金鑰，並讓 Anthropic 使用它來加密特定的靜態工作區資料。您保有對金鑰的完全控制權，包括輪替、稽核和撤銷，而 Anthropic 對您的金鑰執行的金鑰操作會記錄在您雲端供應商的稽核日誌中。

CMEK 的使用是選擇性的。符合資格的組織可以選擇加入使用客戶管理的加密金鑰，而非 Anthropic 提供的預設加密。若要啟用 CMEK，請聯繫您的 Anthropic 客戶團隊。



運作方式

只有 Organization Admin（在 Claude Platform 上）或 Owner 和 Primary Owner（在 Claude Enterprise 上）可以設定 CMEK。在 Claude Platform 上，CMEK 的範圍是每個工作區，並透過 Admin API 設定。在 Claude Enterprise 上，CMEK 的範圍是每個組織，並在 claude.ai > Organization settings > Data and privacy 中設定。在任一產品上，CMEK 保護在金鑰啟用後寫入的資料。現有資料（先前的聊天、檔案和工作階段）仍以 Anthropic 管理的金鑰加密，不會以您的金鑰重新加密。

CMEK 設定事件會出現在 Compliance API Activity Feed 中。Anthropic 對您的金鑰執行的金鑰操作（例如包裝和解包裝資料金鑰）不會出現在 Compliance API 中；它們會出現在您雲端供應商的稽核日誌中。

Anthropic 會從其標準公用 IP 範圍呼叫您的金鑰管理服務。如果您透過 IP 限制對金鑰管理服務的存取，請允許 IP 位址中列出的位址。



先決條件

• 在將託管加密金鑰的帳戶、專案或訂閱中建立加密金鑰和管理金鑰存取權的權限。
• 在 Claude Platform 上具有 Claude Console 的 Organization Admin 角色，或在 Claude Enterprise 上具有 Owner 或 Primary Owner 角色。
• 資料保留設定：對於 Claude Platform 和 Claude Enterprise，CMEK 都允許搭配零資料保留（ZDR）使用。



可用性與區域

CMEK 目前僅在美國區域提供，且所有加密操作都在美國區域處理。

在 Claude Platform on AWS 上，CMEK 僅可搭配 AWS KMS 金鑰使用；無法註冊 Google Cloud KMS 和 Azure Key Vault 金鑰。請在 Claude Console 中建立、驗證和附加金鑰；external_keys API 端點目前在 Claude Platform on AWS 上不可用。金鑰必須與其附加的工作區位於相同的 AWS 區域。

為了將延遲降至最低，請選擇靠近 Anthropic 美國基礎設施的區域：



CMEK 保護的內容

CMEK 涵蓋的範圍取決於您使用的產品。



已加密

Claude Platform

• 訊息內容、檔案和附件（包括隨請求傳送的內嵌附件和 Files API 上傳），以及 MCP 和工具設定。

Claude Enterprise

• 聊天內容，包括技能、外掛程式和 artifacts。
• 聊天附件和專案附件。
• CLI 上的 Claude Code，包括訊息內容。
• Claude Desktop 中的 Cowork。
• Office 代理。
• Claude in Chrome。

在這兩種產品上，備份和快照都會繼承該金鑰。



已停用或已修改

啟用 CMEK 時，某些功能會被關閉或大幅修改。此清單並非詳盡無遺；請在啟用 CMEK 之前與您的團隊一起檢閱。

Claude Platform

• Claude Console 中的 Workbench 已停用。
• Compliance API 中回傳原始內容（例如提示、回應和檔案）的部分已停用。
• Beta 和研究預覽功能可能不在 CMEK 的涵蓋範圍內。這包括 Claude Managed Agents，這是一項整體停用的 beta 功能，包括代理記憶和代理夢境。

Claude Enterprise

• 對話歷史搜尋已停用。對話標題已加密，因此依標題或內容搜尋不會回傳任何結果。
• 跨大量檔案的搜尋速度較慢。
• Analytics API 和產品內分析功能會降級。某些使用量檢視和報告可能不完整。
• 稽核日誌匯出已停用。
• 用於臨時檔案交換的簽署 URL 已停用。這些 URL 支援 claude.ai 中的組織資料匯出，以及 Claude Code Remote 檔案流程（例如螢幕截圖更新）。
• 對於屬於受 CMEK 保護組織的使用者，個人偏好設定在同一母組織下的所有組織中都會停用。不屬於受 CMEK 保護組織的使用者仍可在所有組織中使用這些功能。



未加密

這些功能仍然可用，但其資料不會以您的金鑰加密。您可以在設定中停用任何不適合您使用情境的功能。

Claude Platform

• 非靜態的資料（例如快取）以及 TTL 短於 24 小時的資料。
• Activity Feed、稽核日誌和遙測網路流量（例如 OTEL），以便客戶即使在金鑰被撤銷時也能維持合規性。

Claude Enterprise

• Claude Code Desktop、網頁版 Claude Code 和 Claude in Slack。Anthropic 建議在管理主控台中停用任何不適合您使用情境的功能。
• Beta 和研究預覽功能可能不在 CMEK 的涵蓋範圍內，並且可能在 CMEK 組織中無法運作，例如 Claude Security 和 Claude Design。
• 設定 > 隱私權下的隨需資料匯出。

在這兩種產品上，您組織中使用者的帳戶資料（例如姓名、電子郵件地址和個人資料圖片）不會以您的金鑰加密。



功能支援

啟用 CMEK 時，以下 Claude Platform API 和工具會以您的金鑰儲存靜態資料：



您金鑰之外的有限保存

在三種狹窄的情況下，Anthropic 可能會以 Anthropic 管理的加密保存特定記錄：

• Anthropic 依法必須保留記錄的情況（例如，依據 18 U.S.C. § 2258A 向 NCMEC 回報的材料）。
• 嚴重傷害的緊急風險（例如，CBRNE 武器開發、攻擊性網路攻擊或迫在眉睫的暴力威脅）。
• 違反 Anthropic 商業服務條款第 D.4 節，或客戶與 Anthropic 之間其他適用協議中的同等條款。

除了 CSAM 篩查之外，保存需要人工審查者的明確決定，並遵循 Anthropic 的商業資料保留政策。對於每一次保存，都會產生相應的 Compliance API Activity Feed 事件，並附有傳達保存目的的原因代碼。詳情請參閱 CMEK 內容保存。安全篩查中繼資料（源自 Anthropic 自動安全掃描的記錄，例如模式識別碼和比對指標，而非對話內容）以 Anthropic 管理的加密保留，並在金鑰撤銷後仍可讀取。



限制

• 不可逆的操作： 一旦金鑰附加到工作區，就無法分離或更換。在 Claude Platform 上，附加金鑰也會鎖定工作區的資料保留設定：您無法關閉該工作區的 30 天資料保留，若要恢復零資料保留，則需要建立新的工作區並將您的流量移至該工作區。在同一金鑰內輪替金鑰材料（例如，AWS KMS 自動輪替、Cloud KMS 輪替排程或 Azure Key Vault 輪替政策）可透明地支援，且無需在 Anthropic 中進行任何變更。切換到不同的金鑰需要使用新金鑰建立新的工作區並遷移您的資料。撤銷或停用金鑰會使該工作區中所有受 CMEK 保護的資料永久無法存取，且沒有任何回復途徑。
• 無追溯加密： CMEK 僅保護在金鑰啟用後寫入的資料。
• 延遲： 包裝或解包裝資料金鑰的操作會往返您的金鑰管理服務，這可能會為讀取或寫入靜態資料的動作增加少量的「latency」（延遲）。
• 撤銷延遲： 金鑰撤銷最多可能需要 1 小時（快取 TTL）。在該時間範圍內已在進行中的請求可能會繼續成功。
• KMS 成本： CMEK 需要第三方金鑰管理服務（AWS KMS、Google Cloud KMS 或 Azure Key Vault）中的金鑰，這可能會產生由您的 KMS 供應商計費的額外費用。



設定您的供應商

請遵循您所使用的金鑰管理服務的指南。