客戶管理的加密金鑰

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 客戶團隊。



運作方式

只有管理員可以設定 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 位址中列出的位址。



先決條件

• 在將託管加密金鑰的帳戶、專案或訂閱中具有 Cloud Admin 存取權。
• 在您的 Anthropic 組織中具有管理員角色：在 Claude Platform 上的 Claude Console 中具有 Organization Admin 角色，或在 Claude Enterprise 上具有 Owner 或 Primary Owner 角色。
• 您的產品所需的資料保留設定：
  • Claude Platform： 您的組織已關閉零資料保留（ZDR）。具有 ZDR 安排的組織可以改為至少為一個工作區開啟 30 天資料保留；請參閱特定模型的資料保留要求。您只能將金鑰附加到已啟用資料保留的工作區。
  • Claude Enterprise： 您的組織已關閉 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 代理程式。

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



已停用或已修改

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

Claude Platform

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

Claude Enterprise

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



未加密

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

Claude Platform

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

Claude Enterprise

• Claude Code Desktop、網頁版 Claude Code 和 Claude for 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 僅保護金鑰啟用後寫入的資料。
• 延遲： 包裝或解包裝資料金鑰的操作會往返您的金鑰管理服務，這可能會為讀取或寫入靜態資料的動作增加少量延遲。
• 撤銷延遲： 金鑰撤銷可能需要長達一小時（快取 TTL）。在該時間範圍內已在進行中的請求可能會繼續成功。
• KMS 成本： CMEK 需要第三方金鑰管理服務（AWS KMS、Google Cloud KMS 或 Azure Key Vault）中的金鑰，這可能會產生由您的 KMS 供應商另行收取的費用。



設定您的供應商

請依照您使用的金鑰管理服務的指南進行操作。