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 백업을 생성했습니다.

절차

  1. 다음 명령을 입력하여 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 > 형식으로 정규화된 풀 사양을 구성합니다.

  2. 다음 명령을 입력하여 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 인증 정보로 바꿉니다.

  3. 선택 사항: Vault 서버에서 사용자 정의 TLS 인증 기관을 사용하는 경우 다음 명령을 입력하여 CA 번들로 openshift-config 네임스페이스에 구성 맵을 생성합니다.

    $ oc create configmap vault-ca-bundle \
      --from-file=ca-bundle.crt=<path_to_ca_bundle> \
      -n openshift-config
  4. 다음 명령을 입력하여 APIServer 사용자 정의 리소스를 편집합니다.

    $ oc edit apiserver cluster
  5. spec.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 네임스페이스의 시크릿 이름을 지정합니다.
  6. 저장 및 종료합니다.

    kube-apiserver,openshift-apiserver 및 인증 Operator는 구성의 유효성을 검사하고 새 버전을 롤아웃합니다.

검증

  1. 다음 명령을 입력하여 암호화 유형을 확인합니다.

    $ oc get apiserver cluster -o jsonpath='{.spec.encryption.type}'

    출력에는 KMS 가 표시됩니다.

  2. 다음 명령을 입력하여 KMS 플러그인 상태 및 구성 검증을 확인합니다.

    $ oc get kubeapiserver cluster -ojsonpath='{.status.encryptionStatus}' | jq .

    preflight.result.status 에 Succeeded 가 표시되고 healthReports 의 모든 노드에 Healthy 가 표시되는지 확인합니다.

  3. 다음 명령을 입력하여 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 7

    PROGRESSING 에 False 가 표시되면 롤아웃이 완료됩니다.

  4. 다음 명령을 입력하여 암호화 마이그레이션 상태를 확인합니다.

    $ 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 를 표시할 이유가 있는지 확인합니다.

  5. etcd에서 보안이 암호화되었는지 확인합니다.

    주의

    암호화를 확인하기 전에 kube-apiserver 롤아웃이 모든 컨트롤 플레인 노드에서 완료될 때까지 기다립니다. 이전 버전을 실행하는 동안 노드가 생성된 보안은 KMS로 암호화되지 않습니다.

    1. 다음 명령을 입력하여 테스트 시크릿을 생성합니다.

      $ oc create secret generic test-secret --from-literal=key=value -n default
    2. 다음 명령을 입력하여 etcd pod 이름을 가져옵니다.

      $ oc get pods -n openshift-etcd -l app=etcd -o name | head -1
    3. 다음 명령을 입력하여 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로 시작한 다음 암호화된 바이너리 데이터로 시작합니다.

    4. 다음 명령을 입력하여 테스트 시크릿을 삭제합니다.

      $ oc delete secret test-secret -n default
Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 문서 정보

Legal Notice

Theme

© 2026 Red Hat
맨 위로 이동