고객 관리형 암호화 키

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 계정 팀에 문의하세요.



작동 방식

조직 관리자(Claude Platform) 또는 소유자와 기본 소유자(Claude Enterprise)만 CMEK를 구성할 수 있습니다. Claude Platform에서 CMEK는 워크스페이스 단위로 적용되며 Admin API로 구성됩니다. Claude Enterprise에서 CMEK는 조직 단위로 적용되며 claude.ai > 조직 설정 > 데이터 및 개인정보에서 구성됩니다. 두 제품 모두에서 CMEK는 키가 활성화된 이후에 기록된 데이터를 보호합니다. 기존 데이터(이전 채팅, 파일, 세션)는 Anthropic 관리형 키로 암호화된 상태로 유지되며 사용자의 키로 다시 암호화되지 않습니다.

CMEK 구성 이벤트는 Compliance API Activity Feed에 표시됩니다. Anthropic이 키에 대해 수행하는 키 작업(데이터 키 래핑 및 언래핑 등)은 Compliance API에 표시되지 않으며, 클라우드 제공업체의 감사 로그에 표시됩니다.

Anthropic은 표준 공용 IP 범위에서 키 관리 서비스를 호출합니다. IP로 키 관리 서비스에 대한 접근을 제한하는 경우, IP 주소에 나열된 주소를 허용하세요.



사전 요구 사항

• 암호화 키를 호스팅할 계정, 프로젝트 또는 구독에서 암호화 키를 생성하고 키 접근을 관리할 수 있는 권한.
• Claude Platform의 Claude Console에서 조직 관리자 역할, 또는 Claude Enterprise에서 소유자 또는 기본 소유자 역할.
• 데이터 보존 구성: CMEK는 Claude Platform과 Claude Enterprise 모두에서 Zero data retention (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 리전에 있어야 합니다.

"latency"(지연 시간)를 최소화하려면 Anthropic의 미국 인프라에 가까운 리전을 선택하세요:



CMEK가 보호하는 항목

CMEK가 적용되는 범위는 사용하는 제품에 따라 다릅니다.



암호화됨

Claude Platform

• 메시지 콘텐츠, 파일 및 첨부 파일(요청과 함께 전송되는 인라인 첨부 파일과 Files API 업로드 모두), MCP 및 도구 구성.

Claude Enterprise

• 스킬, 플러그인, 아티팩트를 포함한 채팅 콘텐츠.
• 채팅 첨부 파일 및 프로젝트 첨부 파일.
• 메시지 콘텐츠를 포함한 CLI의 Claude Code.
• Claude Desktop의 Cowork.
• Office 에이전트.
• Claude in Chrome.

두 제품 모두에서 백업과 스냅샷은 키를 상속합니다.



비활성화 또는 수정됨

CMEK가 활성화되면 일부 기능이 꺼지거나 상당히 수정됩니다. 이 목록은 전체 목록이 아니므로, CMEK를 활성화하기 전에 팀과 함께 검토하세요.

Claude Platform

• Claude Console의 Workbench가 비활성화됩니다.
• 프롬프트, 응답, 파일과 같은 원시 콘텐츠를 반환하는 Compliance API의 일부가 비활성화됩니다.
• 베타 및 연구 프리뷰 기능은 CMEK의 적용을 받지 않을 수 있습니다. 여기에는 에이전트 메모리와 에이전트 드리밍을 포함하여 전체가 비활성화되는 베타 기능인 Claude Managed Agents가 포함됩니다.

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 in Slack. Anthropic은 사용 사례에 적합하지 않은 항목을 관리자 콘솔에서 비활성화할 것을 권장합니다.
• 베타 및 연구 프리뷰 기능은 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: 데이터 키를 래핑하거나 언래핑하는 작업은 키 관리 서비스로의 왕복을 수행하므로, 저장 중인 데이터를 읽거나 쓰는 작업에 약간의 latency가 추가될 수 있습니다.
• 폐기 지연: 키 폐기는 최대 1시간(캐시 TTL)이 걸릴 수 있습니다. 해당 기간 동안 이미 진행 중인 요청은 계속 성공할 수 있습니다.
• KMS 비용: CMEK는 타사 키 관리 서비스(AWS KMS, Google Cloud KMS 또는 Azure Key Vault)의 키가 필요하며, KMS 제공업체가 별도로 청구하는 요금이 발생할 수 있습니다.



제공업체 구성

사용하는 키 관리 서비스에 대한 가이드를 따르세요.