6.2. Kubernetes KMS v2 구성
etcd의 외부 KMS 암호화를 구성하여 키 관리를 중앙 집중화하고 규정 준수 요구 사항을 충족할 수 있습니다.
Kubernetes KMS v2는 기술 프리뷰 기능 전용입니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.
Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.
6.2.1. KMS 암호화 활성화 링크 복사링크가 클립보드에 복사되었습니다!
etcd 데이터에 대해 KMS(Key Management Service) 암호화를 활성화하여 키 관리를 중앙 집중화하고 규정 준수 요구 사항을 충족할 수 있습니다.
사전 요구 사항
-
cluster-admin역할의 사용자로 클러스터에 액세스할 수 있어야 합니다. -
KMSEncryption기능 게이트를 활성화하는TechPreviewNoUpgrade기능 세트를 활성화했습니다. - 외부에서 호스팅되고 클러스터에서 액세스할 수 있는 HashiCorp Vault Enterprise 인스턴스가 있습니다. Vault Enterprise는 클러스터 서비스 네트워크 내에서 호스팅해서는 안 됩니다. Vault Community Edition은 지원되지 않습니다.
다음을 사용하여 Vault 인스턴스를 구성했습니다.
-
기본
전송/ 경로와 같은 마운트 경로에서 사용 가능한 전송보안 엔진 -
aes256-gcm96유형으로 생성된 암호화 키( FIPS 140-3 준수의 경우 권장) - KMS 플러그인이 키 정보를 암호화, 암호 해독 및 읽을 수 있도록 하는 Vault 정책
-
연결된 정책으로 구성된
AppRole과 같은 인증 방법
-
기본
- KMS 플러그인 이미지에 대해 SHA256 다이제스트가 있는 정규화된 OCI 이미지 가져오기 사양이 있어야 합니다. Red Hat Ecosystem Catalog 또는 Docker Hub에서 이미지를 가져올 수 있습니다. 자세한 내용은 "HashiCorp Vault 플러그인 컨테이너 이미지" 및 "Red Hat Ecosystem Catalog"를 참조하십시오. 연결이 끊긴 환경에서는 이미지가 액세스 가능한 레지스트리에 미러링됩니다.
-
skopeo및jq툴이 설치되어 있습니다. 다음 기능을 사용하여 Vault 정책을 구성했습니다.
path "transit/encrypt/kms-key" { capabilities = ["update"] } path "transit/decrypt/kms-key" { capabilities = ["update"] } path "transit/keys/kms-key" { capabilities = ["read"] } path "sys/license/status" { capabilities = ["read"] }Transit 마운트 경로 및
kms-key로transit을 Vault Transit 키 이름으로 바꿉니다.- etcd 백업을 생성했습니다.
절차
다음 명령을 입력하여 KMS 플러그인 이미지에 대한 SHA256 다이제스트를 가져옵니다.
$ skopeo inspect docker://quay.io/redhat-isv-containers/698df066f8d1ddf179c15ef9:<version> | jq -r '.Digest'&
lt;version>을0.1.0-beta-ubi와 같이 클러스터와 호환되는 플러그인 버전으로 바꿉니다.결과 다이제스트를 사용하여
quay.io/redhat-isv-containers/698df066f8d1ddf179c15ef9@sha256:<digest> 형식으로 정규화된 풀 사양을 구성합니다.다음 명령을 입력하여 Vault 인증 인증 정보를 사용하여
openshift-config네임스페이스에 보안을 생성합니다.$ oc create secret generic vault-approle-secret \ --from-literal=role-id=<your_role_id> \ --from-literal=secret-id=<your_secret_id> \ -n openshift-config<
your_role_id> 및 <your_secret_id>를 Vault AppRole 인증 정보로 바꿉니다.선택 사항: Vault 서버에서 사용자 정의 TLS 인증 기관을 사용하는 경우 다음 명령을 입력하여 CA 번들로
openshift-config네임스페이스에 구성 맵을 생성합니다.$ oc create configmap vault-ca-bundle \ --from-file=ca-bundle.crt=<path_to_ca_bundle> \ -n openshift-config다음 명령을 입력하여
APIServer사용자 정의 리소스를 편집합니다.$ oc edit apiserver clusterspec.encryption섹션에 KMS 구성을 추가합니다.apiVersion: config.openshift.io/v1 kind: APIServer metadata: name: cluster spec: encryption: type: KMS kms: type: Vault vault: kmsPluginImage: <registry>/<repository>@sha256:<digest> vaultAddress: https://vault.example.com:8200 vaultNamespace: my-namespace vaultAuthNamespace: my-auth-namespace vaultKeyPath: transit/keys/kms-key tls: caBundle: name: vault-ca-bundle serverName: vault.example.com authentication: type: AppRole appRole: secret: name: vault-approle-secret다음과 같습니다.
kmsPluginImage- KMS 플러그인 컨테이너 이미지를 SHA256 다이제스트로 정규화된 OCI 가져오기 사양으로 지정합니다. 이미지 태그 및 짧은 이름은 허용되지 않습니다. 연결이 끊긴 환경에서는 미러링된 위치를 사용합니다.
vaultAddress- Vault 서버의 HTTPS URL을 지정합니다. 경로, 쿼리 매개변수 및 조각은 허용되지 않습니다.
vaultNamespace- Vault 네임스페이스를 지정합니다. 이 값은 선택 사항입니다.
vaultAuthNamespace-
Transit 네임스페이스와 다른 경우 인증에 사용할 Vault 네임스페이스를 지정합니다. 기본값은
vaultNamespace값입니다. 이 값은 선택 사항입니다. vaultKeyPath-
<
mount>/keys/<key_name> 형식으로 Transit 암호화 키 경로를 지정합니다. tls.caBundle.name-
CA 번들을 포함하는
openshift-config네임스페이스의 구성 맵을 지정합니다. Vault에서 사용자 정의 CA를 사용하는 경우에만 필요합니다. tls.serverName- 인증서 확인을 위해 TLS 서버 이름을 지정합니다. 이 값은 선택 사항입니다.
authentication.appRole.secret.name-
AppRole 인증 정보를 포함하는
openshift-config네임스페이스의 시크릿 이름을 지정합니다.
저장 및 종료합니다.
kube-apiserver,openshift-apiserver및인증Operator는 구성의 유효성을 검사하고 새 버전을 롤아웃합니다.
검증
다음 명령을 입력하여 암호화 유형을 확인합니다.
$ oc get apiserver cluster -o jsonpath='{.spec.encryption.type}'출력에는
KMS가 표시됩니다.다음 명령을 입력하여 KMS 플러그인 상태 및 구성 검증을 확인합니다.
$ oc get kubeapiserver cluster -ojsonpath='{.status.encryptionStatus}' | jq .preflight.result.status에Succeeded가 표시되고healthReports의 모든 노드에Healthy가 표시되는지 확인합니다.다음 명령을 입력하여
kube-apiserver롤아웃 진행 상황을 모니터링합니다.$ oc get co kube-apiserver롤아웃 중 출력 예
NAME VERSION AVAILABLE PROGRESSING DEGRADED SINCE MESSAGE kube-apiserver 5.0.0-rc.4 True True False 35m NodeInstallerProgressing: 2 nodes are at revision 6; 1 node is at revision 7PROGRESSING에False가 표시되면 롤아웃이 완료됩니다.다음 명령을 입력하여 암호화 마이그레이션 상태를 확인합니다.
$ oc get kubeapiserver cluster -o jsonpath='{.status.conditions[?(@.type=="Encrypted")]}' | jq .완료 시 출력 예
{ "lastTransitionTime": "2026-09-24T16:41:48Z", "message": "All resources encrypted: secrets, configmaps", "reason": "EncryptionCompleted", "status": "True", "type": "Encrypted" }etcd에서 암호화를 확인하기 전에
EncryptionCompleted를 표시할이유가있는지 확인합니다.etcd에서 보안이 암호화되었는지 확인합니다.
주의암호화를 확인하기 전에
kube-apiserver롤아웃이 모든 컨트롤 플레인 노드에서 완료될 때까지 기다립니다. 이전 버전을 실행하는 동안 노드가 생성된 보안은 KMS로 암호화되지 않습니다.다음 명령을 입력하여 테스트 시크릿을 생성합니다.
$ oc create secret generic test-secret --from-literal=key=value -n default다음 명령을 입력하여 etcd pod 이름을 가져옵니다.
$ oc get pods -n openshift-etcd -l app=etcd -o name | head -1다음 명령을 입력하여 etcd의 시크릿 데이터를 확인합니다.
$ oc exec -n openshift-etcd <etcd_pod_name> -- etcdctl get /kubernetes.io/secrets/default/test-secret --print-value-only | hexdump -C | head -1출력 예
00000000 6b 38 73 3a 65 6e 63 3a 6b 6d 73 3a 76 32 3a 31 |k8s:enc:kms:v2:1|출력은
k8s:enc:kms:v2로 시작한다음 암호화된 바이너리 데이터로 시작합니다.다음 명령을 입력하여 테스트 시크릿을 삭제합니다.
$ oc delete secret test-secret -n default