Claude Platform Docs
管理加密金鑰(CMEK)

客戶管理的加密金鑰

使用您所控制的金鑰加密 Claude 工作區的靜態資料。

Claude Code

向 Claude Code 詢問此功能

/claude-api 告訴我關於客戶管理的加密金鑰的資訊

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

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

運作方式

只有組織管理員(在 Claude Platform 上;在 Claude Platform on AWS 上為 Admin 角色)或擁有者和主要擁有者(在 Claude Enterprise 上)可以設定 CMEK。在 Claude Platform 上,CMEK 的範圍以工作區為單位,並在 Claude Console 中或透過 Admin API 進行設定(在 Claude Platform on AWS 上,則在 Claude Console 中或透過經 IAM 授權的外部金鑰和工作區端點進行設定)。在 Claude Enterprise 上,CMEK 的範圍以組織為單位,並在 claude.ai > Organization settings > Data and privacy 中設定。在任一產品上,CMEK 都會保護您的金鑰生效後寫入的資料。既有資料(先前的聊天、檔案和工作階段)仍以 Anthropic 管理的金鑰加密,不會以您的金鑰重新加密。

在 Claude Platform 上,Anthropic 建議您在向新工作區傳送任何請求之前,先將金鑰附加到該工作區。如果您將金鑰附加到已在接收請求的工作區,您的金鑰最多可能需要一天才會生效。在此之前寫入的資料與既有資料一樣,會以 Anthropic 管理的金鑰加密,且不會重新加密。

CMEK 設定事件會出現在 Compliance API 活動摘要中。Anthropic 對您的金鑰執行的金鑰操作(例如包裝與解除包裝資料金鑰)不會出現在 Compliance API 中;它們會出現在您雲端供應商的稽核日誌中。

Anthropic 會從其標準公開 IP 範圍呼叫您的金鑰管理服務。如果您以 IP 限制對金鑰管理服務的存取,請允許 IP 位址中列出的位址。在 Claude Platform on AWS 上,請勿依賴以 IP 為基礎的限制來保護您的金鑰;請改用 AWS KMS 指南中所述的金鑰政策來限定存取範圍。

先決條件

  • 在將託管加密金鑰的帳戶、專案或訂用帳戶中,具備建立加密金鑰與管理金鑰存取權的權限。
  • 在 Claude Platform 上具備 Claude Console 中的組織管理員角色(在 Claude Platform on AWS 上為 Admin 角色),或在 Claude Enterprise 上具備擁有者或主要擁有者角色。
  • 資料保留設定:Claude Platform 與 Claude Enterprise 皆允許 CMEK 搭配零資料保留(ZDR)使用。

可用性與區域

除了 Claude Platform on AWS(於本節末尾說明)之外,CMEK 目前僅在美國區域提供,且所有加密操作皆在美國區域處理。為了將「latency」(延遲)降到最低,請選擇靠近 Anthropic 美國基礎設施的區域:

供應商建議區域
AWSus-east-2
Google Cloudus-central1, us-east5
Azurenorthcentralus, eastus2

在 Claude Platform on AWS 上,CMEK 僅支援 AWS KMS 金鑰;無法註冊 Google Cloud KMS 與 Azure Key Vault 金鑰。上述區域建議不適用於該處:金鑰必須是與其所附加工作區位於相同 AWS 帳戶與區域的單一區域 KMS 金鑰,且其金鑰政策必須將存取權授予 AWS 服務主體,而非 Anthropic 的 IAM 角色;請參閱在 Claude Platform on AWS 上設定 CMEK。請在 Claude Console 中註冊並附加金鑰;外部金鑰端點在 Claude Platform on AWS 上同樣可用,並透過 IAM 動作授權。沒有獨立的驗證步驟:當您將金鑰附加到工作區時,金鑰會被隱含驗證(附加呼叫會執行一輪加密/解密),因此金鑰政策問題會在附加時而非註冊時浮現。

CMEK 保護的內容

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

以 CMEK 金鑰加密

Claude Platform

  • 訊息內容、檔案與附件(包括隨請求傳送的內嵌附件與 Files API 上傳的檔案),以及 MCP 與工具設定。
  • Claude Managed Agents(beta 版)資料,包括代理設定、環境、webhook、工作階段及其事件、記憶儲存(beta 版)及其記憶和記憶版本,以及 dreams(研究預覽版)。
  • 由 Batch 和 Skills API,以及以下工具儲存的靜態資料:web search、web fetch、code execution、bash、text editor、MCP connector(beta 版)、structured outputs、advisor tool(beta 版)、computer use、browser use 和 context management。

Claude Enterprise

  • 聊天內容,包括技能與外掛程式。
  • 聊天附件與專案附件。
  • CLI 上的 Claude Code,包括訊息內容。
  • Claude Desktop 中的 Cowork。
  • 從使用者電腦上的工作階段擷取的 Compliance API 本機工作階段逐字稿。如果您的金鑰無法使用,messages 端點會傳回 503 Service Unavailable,而非逐字稿內容。工作階段中繼資料仍會列出。
  • Office 代理。
  • Claude in Chrome。
  • Claude Science,目前為 beta 版。

在兩項產品上,備份與快照皆會繼承該金鑰。

停用或修改

啟用 CMEK 後,部分功能會被關閉或大幅修改。此清單並非詳盡無遺;請在啟用 CMEK 之前與您的團隊一同檢視。

Claude Platform

  • Claude Console 中的 Playground 會被停用。
  • Compliance API 中回傳原始內容(例如提示、回應與檔案)的部分會被停用。
  • 在啟用 CMEK 的組織中,Claude Fable 或 Claude Mythos 模型無法使用 structured outputs。
  • 其他測試版與研究預覽功能可能不在 CMEK 涵蓋範圍內。

Claude Enterprise

  • 聊天搜尋會被停用,因為聊天標題與內容是以您的金鑰加密。成員無法搜尋過去的聊天,且 Search and reference chats 切換開關會保持關閉,因此 Claude 也無法搜尋這些聊天。
  • 專案知識搜尋(「retrieval-augmented generation」(檢索增強生成),即 RAG)會被停用。專案知識會直接載入每個對話的上下文中,而不是經過索引與搜尋。因此,與未啟用 CMEK 時相比,專案可使用的知識量會大幅減少。超出可載入範圍的知識將不會納入對話中。
  • 網頁版 Claude Code 和 Claude in Slack 無法使用:即使管理員開啟這些產品,也無法啟動新的工作階段,且 Claude in Slack 會拒絕請求。Claude Code Desktop 仍可用於本機工作階段,但除非管理員在 claude.ai > Organization settings > Claude Code 下開啟,否則預設為關閉。
  • Claude Code 無法發布 artifacts。不過,在對話或 Cowork 中建立的 artifacts 可以在您的組織內分享,但不能公開分享。
  • 無論管理員設定為何,某些分析功能都會被停用:Claude 智慧報告(beta 版,位於 claude.ai/analytics/insights 下)和來自 GitHub 的 Claude Code 貢獻指標(beta 版,位於 claude.ai/analytics/claude-code 下)。技能和連接器的管理員分析功能,無論是在 claude.ai 分析儀表板中還是透過 Claude Enterprise Analytics API,都不包含對話中的使用情況,並會隱藏自訂技能、外掛程式和連接器的名稱。
  • 組織資料匯出與稽核日誌匯出(兩者皆位於 claude.ai > Organization settings > Data and privacy)會被停用。
  • 回應評分(對 Claude 回應按讚與倒讚)會被停用。
  • 技能和外掛程式安全掃描 無法使用:此設定無法開啟,技能和外掛程式會在未經掃描的情況下安裝。
  • 無論管理員設定為何,以下 beta 版和研究預覽版功能在啟用 CMEK 的組織中皆無法使用:對話和Artifacts 分頁中的 Claude Design、Claude Slides 和 Claude Docs,以及 routines。

以 Anthropic 金鑰加密

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

Claude Platform

  • 非靜態資料(例如快取)以及 TTL 短於 24 小時的資料。
  • 活動摘要、稽核日誌,以及 OTEL 等遙測網路流量,讓客戶即使在金鑰被撤銷後仍能維持合規。
  • Claude Managed Agents 保存庫憑證值,例如 OAuth 權杖與用戶端密鑰。這些值以 Anthropic 管理的加密儲存,僅可寫入,且絕不會在 API 回應中回傳。
  • 使用者設定檔:name、external_id 與 metadata 欄位以 Anthropic 管理的加密儲存,而非您的金鑰。請勿在設定檔 metadata 中儲存敏感個人資料。
  • 成員透過 Claude Console 的意見回饋選項傳送的關於 Claude Console 的評分與意見。沒有任何設定可以關閉這些內容;成員只有在自行選擇時才會傳送。
  • OpenTelemetry 目的地請求標頭,例如您可觀測性後端的 API 金鑰標頭。這些標頭以 Anthropic 管理的加密方式儲存。其值僅可寫入,且絕不會在 API 回應中傳回。

Claude Enterprise

  • Beta 與研究預覽功能可能不在 CMEK 的涵蓋範圍內,且在 CMEK 組織中可能無法正常運作,例如 Claude Security 以及位於 claude.ai/design 的 Claude Design 應用程式。
  • 個人偏好設定 - Instructions for Claude 區段與 Cowork 全域指示。這些是在帳戶層級設定,並在使用者所屬的所有組織之間共用。

在兩項產品上,您組織中使用者的帳戶資料(例如姓名、電子郵件地址與個人資料圖片)不會以您的金鑰加密。

在您的金鑰之外的有限保存

在三種狹義情況下,Anthropic 可能會以 Anthropic 管理的加密保存特定記錄:

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

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

限制

  • 不可逆的動作:金鑰一旦附加到工作區,便無法卸離或更換。在 Claude Platform 上,附加金鑰也會鎖定該工作區的資料保留設定:您無法關閉該工作區的 30 天資料保留,而若要回到零資料保留,則需要建立新的工作區並將流量移轉過去。在同一金鑰內輪替金鑰材料(例如 AWS KMS 自動輪替、Cloud KMS 輪替排程,或 Azure Key Vault 輪替政策)可透明地支援,且無需在 Anthropic 端進行任何變更。切換到不同的金鑰則需要以新金鑰建立新的工作區並遷移您的資料。撤銷或停用金鑰會使該工作區中所有受 CMEK 保護的資料永久無法存取,且沒有任何回復途徑。
  • 無追溯加密:CMEK 僅保護您的金鑰生效後寫入的資料(請參閱運作方式)。
  • 延遲:包裝或解除包裝資料金鑰的操作會往返您的金鑰管理服務一次,這可能會為讀取或寫入靜態資料的動作增加少量延遲。
  • 撤銷延遲:金鑰撤銷最多可能需要 1 小時(快取 TTL)。在該時段內已在進行中的請求可能仍會成功。
  • KMS 費用:CMEK 需要第三方金鑰管理服務(AWS KMS、Google Cloud KMS 或 Azure Key Vault)中的金鑰,這可能會產生由您的 KMS 供應商另行計費的費用。
  • 閘道後方的 Claude Code 遙測:當 Claude Code 透過 LLM 閘道或代理伺服器(自訂的 ANTHROPIC_BASE_URL)連線時,CMEK 不適用於 Claude Code 的營運遙測。若要關閉此遙測,請將 DISABLE_TELEMETRY 環境變數設為 1,如 Claude Code 文件中遙測服務一節所述。

設定您的供應商

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

建立具有授予 Anthropic 存取權之金鑰政策的 AWS KMS 金鑰,然後註冊它。

建立 Cloud KMS 加密金鑰,授予 Anthropic 的服務帳戶存取權,然後註冊它。

建立 RSA 金鑰,授予 Anthropic 服務主體存取權,然後註冊並驗證它。

Was this page helpful?