CMEK를 위한 Azure Key Vault 구성

claude "/claude-api help me configure a customer-managed encryption key with Azure Key Vault"

이 가이드는 Azure Key Vault 키를 Anthropic 조직의 고객 관리 암호화 키(customer-managed encryption key, CMEK)로 구성하는 과정을 안내합니다.

사전 요구 사항

• RBAC 인증이 활성화되고(enableRbacAuthorization: true) 공용 네트워크 액세스가 허용된 Azure Key Vault. Anthropic은 공용 데이터 플레인 엔드포인트를 통해 볼트를 호출하며, 프라이빗 엔드포인트는 지원되지 않습니다.
• 볼트에 제거 방지가 활성화됨(enablePurgeProtection: true). 이것이 없으면 삭제된 키가 소프트 삭제 보존 기간 동안 영구적으로 제거될 수 있어 CMEK로 보호된 데이터가 돌이킬 수 없이 손실됩니다. 제거 방지는 한 번 활성화하면 비활성화할 수 없습니다.
• 볼트에서 키를 생성하고 RBAC 역할을 할당할 수 있는 권한.
• Entra 테넌트에서 서비스 주체를 생성할 수 있는 권한(Application Administrator, Cloud Application Administrator 또는 이에 상응하는 사용자 지정 역할).
• 조직의 Anthropic Admin API 키.
• 설치 및 인증된 az CLI.
• AuditEvent 로그 범주를 Log Analytics, 스토리지 계정 또는 이벤트 허브로 라우팅하도록 볼트에 구성된 진단 설정. Azure Key Vault는 기본적으로 데이터 플레인 감사 로그(예: KeyWrap, KeyUnwrap, KeyGet)를 내보내지 않으므로, 이것이 없으면 Anthropic의 키 작업에 대한 감사 추적을 얻을 수 없습니다.

Anthropic 앱 정보

Anthropic이 암호화 키를 사용하도록 하려면 Anthropic 멀티테넌트 애플리케이션 ID와 표시 이름을 구성해야 합니다. 해당 값은 다음과 같습니다:

암호화 키 설정

1. 1

   Anthropic 멀티테넌트 애플리케이션에 동의

   이렇게 하면 Anthropic의 CMEK 클라이언트 애플리케이션을 위한 서비스 주체가 Entra 테넌트에 생성됩니다. 이 애플리케이션은 Microsoft Graph 권한을 요청하지 않으며, Key Vault 데이터 플레인 액세스를 위한 페더레이션 대상으로만 존재합니다.

   az ad sp create --id 8635ae1a-3e5d-44e8-a4ed-e0f614466f87

   

   출력에서 id 필드를 캡처하세요. 이것은 테넌트에 있는 서비스 주체의 객체 ID이며, RBAC 역할을 할당할 때 사용합니다.

   {
     "appId": "8635ae1a-3e5d-44e8-a4ed-e0f614466f87",
     "displayName": "anthropic-cmek-client-us",
     "id": "<sp-object-id>"
   }

   

   서비스 주체가 이미 테넌트에 존재하는 경우(이전 시도 또는 다른 통합에서), az ad sp create는 "already exists" 오류와 함께 종료됩니다. 대신 해당 객체 ID를 가져오세요:

   az ad sp show --id 8635ae1a-3e5d-44e8-a4ed-e0f614466f87 --query id -o tsv

   

   이 단계에는 포털에 해당하는 기능이 없습니다. Azure CLI가 로컬에 설치되어 있지 않은 경우, 포털의 상단 탐색 모음에서 Cloud Shell을 여세요. 명령이 성공한 후, 기본 애플리케이션 유형 필터를 지우고 anthropic-cmek-client-us를 검색하여 Microsoft Entra ID > Enterprise applications에서 서비스 주체의 객체 ID를 찾을 수 있습니다.

   

2. 2

   볼트에 RSA 키 생성

   Azure Key Vault는 대칭 키 래핑을 지원하지 않으므로, 키는 허용된 작업에 wrapKey와 unwrapKey가 포함된 RSA(3072비트 이상)여야 합니다.

   --tags 옵션은 조직 태그 anthropic-org-<ORGANIZATION_UUID>를 값 true와 함께 추가하며, 여기서 <ORGANIZATION_UUID>는 소문자로 된 Anthropic 조직 ID입니다. 이 태그는 Anthropic이 키를 검증하는 데 필요합니다.

   az keyvault key create \
     --vault-name <VAULT_NAME> \
     --name <KEY_NAME> \
     --kty RSA --size 3072 \
     --ops wrapKey unwrapKey \
     --tags anthropic-org-<ORGANIZATION_UUID>=true

   

   HSM 기반 키의 경우 --kty RSA-HSM을 사용하세요(Premium-SKU 볼트 필요). 소프트웨어로 보호되는 RSA 키는 이 통합에 사용할 수 있습니다.

   포털에서 Key Vault를 열고 Keys를 선택한 다음 Generate/Import를 선택하세요. 키 유형을 RSA로, 크기를 3072 이상으로 설정하세요. 키를 래핑 및 언래핑으로만 제한하려면 키 버전을 열고 Permitted operations로 스크롤한 다음 Wrap Key와 Unwrap Key를 제외한 모든 항목의 선택을 해제하세요.

   Create a key 페이지에서 Tags 아래에 조직 태그도 추가하세요.

   

   

   여러 Anthropic 조직 간에 하나의 키를 공유하려면 각 조직에 대해 이러한 태그를 하나씩 추가하세요. 키 버전은 자체 태그를 포함하여 최대 15개의 태그를 가질 수 있습니다.

3. 3

   Anthropic 서비스 주체에 키 액세스 권한 부여

   첫 번째 단계의 서비스 주체에 Key Vault Crypto User 역할을 할당하되, 전체 볼트가 아닌 개별 키로 범위를 지정하세요.

   VAULT_ID=$(az keyvault show --name <your-vault-name> --query id -o tsv)
   
   az role assignment create \
     --role "Key Vault Crypto User" \
     --assignee-object-id <sp-object-id> \
     --assignee-principal-type ServicePrincipal \
     --scope "${VAULT_ID}/keys/<your-key-name>"

   

   기본 제공 Key Vault Crypto User 역할은 할당된 범위에서 키 암호화 작업(암호화, 복호화, 래핑, 언래핑, 서명, 검증)과 키 읽기 권한을 부여합니다. 이전 단계에서 키에 설정한 --ops wrapKey unwrapKey 제한은 이 키에 대해 성공할 수 있는 작업을 더욱 좁히므로, 실제로 Anthropic은 래핑과 언래핑만 수행할 수 있습니다.

   포털에서 (볼트가 아닌) 키를 열고 Access control (IAM) 탭을 선택한 다음 Add > Add role assignment를 클릭하고 Key Vault Crypto User를 선택한 후 anthropic-cmek-client-us 서비스 주체에 할당하세요.

   

4. 4

   볼트 구성 확인

   az keyvault show --name <your-vault-name> \
     --query "{rbac:properties.enableRbacAuthorization, purge:properties.enablePurgeProtection, pub:properties.publicNetworkAccess, net:properties.networkAcls.defaultAction, ipRules:properties.networkAcls.ipRules, uri:properties.vaultUri, tenantId:properties.tenantId}"

   

   다음을 확인하세요:

   • rbac가 true입니다.
   • purge가 true입니다. false 또는 null인 경우 진행하기 전에 볼트에서 제거 방지를 활성화하세요. 이것이 없으면 소프트 삭제된 키가 보존 기간 동안 영구적으로 제거될 수 있어 CMEK로 보호된 데이터를 복구할 수 없게 됩니다.
   • pub가 "Enabled"입니다. "Disabled"인 경우 Anthropic은 공용 데이터 플레인 엔드포인트를 통해 볼트에 접근할 수 없으며 검증이 실패합니다.
   • net이 "Allow"이거나, "Deny"인 경우 ipRules에 Anthropic의 송신 범위가 포함되어 있습니다(현재 목록은 Anthropic에 문의하세요).
   • uri가 키를 등록할 때 사용하는 볼트 URI입니다.
   • tenantId가 볼트를 관리하는 테넌트입니다. 키를 등록할 때 현재 활성 구독의 테넌트가 아닌 이 값을 tenant_id로 사용하세요(교차 테넌트 설정에서는 두 값이 다를 수 있습니다).

Anthropic에 키 등록

키를 등록하는 방법은 사용하는 제품에 따라 다릅니다.

Terraform

코드형 인프라(infrastructure-as-code) 배포의 경우, 동일한 단계가 azurerm 및 azuread 공급자에 매핑됩니다.