고객 관리 암호화 키 사용

기본적으로 Cloud Scheduler는 저장된 고객 콘텐츠를 암호화합니다. Cloud Scheduler는 사용자의 추가 작업 없이 자동으로 암호화를 처리합니다. 이 옵션을 Google 기본 암호화라고 합니다.

암호화 키를 제어하려면 Cloud Scheduler를 포함한 CMEK 통합 서비스와 함께 Cloud KMS에서 고객 관리 암호화 키(CMEK)를 사용하면 됩니다. Cloud KMS 키를 사용하면 보호 수준, 위치, 순환 일정, 사용 및 액세스 권한, 암호화 경계를 관리할 수 있습니다. Cloud KMS를 사용하면 감사 로그를 보고 키 수명 주기를 제어할 수도 있습니다. Google에서 데이터를 보호하는 대칭 키 암호화 키(KEK)를 소유하고 관리하는 대신 사용자가 Cloud KMS에서 이러한 키를 제어하고 관리할 수 있습니다.

CMEK로 리소스를 설정한 후 Cloud Scheduler 리소스에 액세스하는 환경은 Google 기본 암호화를 사용하는 것과 유사합니다. 암호화 옵션에 대한 자세한 내용은 고객 관리 암호화 키(CMEK)를 참조하세요.

CMEK로 보호되는 대상

Google Cloud 프로젝트 및 지원되는 Cloud Scheduler 리전별로 Cloud KMS 키를 지정할 수 있습니다. 이 키는 해당 프로젝트 및 리전에서 다음 데이터를 보호하는 데 사용됩니다.

  • HTTP 또는 HTTPS 엔드포인트 대상이 있는 작업: HTTP 요청 본문 및 고객 헤더
  • Pub/Sub 주제 대상이 있는 작업: Pub/Sub 메시지 페이로드 및 속성

시작하기 전에

Cloud Scheduler에서 CMEK를 사용하기 전에 다음 기본 요건 단계를 완료합니다.

  1. 환경을 설정합니다.

  2. gcloud 구성요소를 업데이트합니다.

    gcloud components update

  3. 계정을 사용하여 로그인합니다.

    gcloud auth login

  4. 암호화 키를 저장하는 프로젝트에 Cloud KMS API를 사용 설정합니다.

    gcloud services enable cloudkms.googleapis.com \
        --project=KMS_PROJECT_ID

    KMS_PROJECT_ID를 Cloud KMS 키를 저장하는 프로젝트의 ID로 바꿉니다. 이는 Cloud Scheduler 작업과 동일한 프로젝트 또는 별도의 프로젝트일 수 있습니다.

  5. Cloud KMS는 키를 사용 설정, 사용 중지 또는 Cloud Scheduler 리소스에서 데이터를 암호화 및 복호화할 때 Cloud 감사 로그를 생성합니다.

    프로젝트의 Cloud KMS API에 로깅이 사용 설정되어 있고, 사용 사례에 적용할 로깅별 권한 및 역할이 결정되었는지 확인합니다. 자세한 내용은 Cloud KMS 감사 로깅을 참조하세요.

필요한 역할

Cloud Scheduler에 CMEK를 구성하는 데 필요한 권한을 얻으려면 관리자에게 다음 IAM 역할을 부여해 달라고 요청하세요.

  • 서비스 에이전트에 키에 대한 액세스 권한 부여: Cloud KMS 키가 포함된 키, 키링 또는 프로젝트에 대한 Cloud KMS 관리자(roles/cloudkms.admin)
  • CMEK 사용 설정 또는 사용 중지: Cloud Scheduler 프로젝트에 대한 Cloud Scheduler 관리자(roles/cloudscheduler.admin)
  • CMEK 구성 또는 작업 상태를 확인합니다.

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이러한 사전 정의된 역할에는 Cloud Scheduler에 CMEK를 구성하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

Cloud Scheduler에 CMEK를 구성하려면 다음 권한이 필요합니다.

  • Cloud KMS 키가 포함된 키, 키링 또는 프로젝트에서 서비스 에이전트에 키에 대한 액세스 권한(cloudkms.cryptoKeys.setIamPolicy)을 부여합니다.
  • Cloud Scheduler 프로젝트에서 CMEK 사용 설정 또는 사용 중지: cloudscheduler.cmekConfig.update
  • CMEK 구성 또는 작업 상태를 확인합니다.
    • Cloud Scheduler 프로젝트에 대한 cloudscheduler.cmekConfig.get 권한
    • Cloud Scheduler 프로젝트에 대한 cloudscheduler.operations.get 권한

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

Cloud KMS 키링 및 키 만들기

새 키링을 만들거나 기존 키링을 사용할 수 있습니다. 키링 내에서 새 키를 추가하거나 기존 키를 사용할 수 있습니다. 애플리케이션, 서비스 또는 환경마다 다른 키를 사용하는 것이 좋습니다.

  1. 키링을 만듭니다.

  2. 키 만들기 키는 대칭 암호화 알고리즘을 사용해야 합니다.

Cloud Scheduler 서비스 에이전트에 키에 대한 액세스 권한 부여

Cloud KMS 키에 액세스할 수 있도록 Cloud Scheduler 서비스 에이전트에 Cloud KMS CryptoKey 암호화/복호화 Identity and Access Management(IAM) 역할을 부여해야 합니다. 최근에 프로젝트에서 Cloud Scheduler API를 사용 설정했고 아직 작업을 만들지 않은 경우 먼저 gcloud beta services identity create --service=cloudscheduler.googleapis.com --project=PROJECT_ID를 실행하여 서비스 에이전트를 만들어야 할 수 있습니다.

gcloud kms keys add-iam-policy-binding KEY_NAME \
    --keyring=KEY_RING \
    --location=LOCATION \
    --project=KMS_PROJECT_ID \
    --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-cloudscheduler.iam.gserviceaccount.com \
    --role=roles/cloudkms.cryptoKeyEncrypterDecrypter

다음을 바꿉니다.

  • KEY_NAME: 키의 이름(예: my-key)
  • KEY_RING: 키링의 이름입니다(예: my-keyring).
  • LOCATION: 키의 위치입니다(예: us-central1).
  • KMS_PROJECT_ID: Cloud KMS 키가 있는 프로젝트의 ID입니다.
  • PROJECT_NUMBER: Cloud Scheduler Google Cloud 프로젝트의 프로젝트 번호입니다. Google Cloud 콘솔의 시작 페이지에서 또는 다음 명령어를 실행하여 프로젝트 번호를 찾을 수 있습니다.

    export PROJECT=$(gcloud info --format='value(config.project)')
    gcloud projects describe ${PROJECT} --format="value(projectNumber)"

서비스 에이전트에 roles/cloudkms.cryptoKeyEncrypterDecrypter 역할이 있는 경우 프로젝트의 작업은 CMEK 키를 사용하여 데이터를 암호화하고 복호화할 수 있습니다. 이 역할을 취소하거나 CMEK 키를 사용 중지하거나 폐기하면 해당 데이터에 액세스할 수 없습니다. 이 문서에서 Cloud KMS 삭제를 참조하세요.

Cloud Scheduler 리전에 CMEK 사용 설정

gcloud scheduler cmek-config update 명령어를 사용하여 Cloud Scheduler 리전에서 데이터 암호화에 사용할 Cloud KMS 키를 지정합니다.

gcloud scheduler cmek-config update \
    --location=LOCATION \
    --kms-key-name=KEY_NAME \
    --kms-keyring=KEY_RING \
    --kms-project=KMS_PROJECT_ID

다음을 바꿉니다.

  • LOCATION: 지원되는 Cloud Scheduler 리전입니다.
  • KEY_NAME: 키의 이름(예: my-key)
  • KEY_RING: 키링의 이름입니다(예: my-keyring).
  • KMS_PROJECT_ID: 사용하려는 Cloud KMS 키가 있는 프로젝트의 ID입니다.

다음에 유의하세요.

  • Cloud Scheduler에서 CMEK 키를 사용 설정, 변경 또는 사용 중지하면 비동기식으로 실행되고 장기 실행 작업(projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID)이 반환됩니다. gcloud scheduler operations describe 명령어를 실행하여 업데이트가 완료되었는지 확인할 수 있습니다.
  • Cloud Scheduler는 사용 설정된 키를 사용하여 보호된 프로젝트 및 리전의 신규 및 업데이트된 작업을 암호화합니다. 이전에 이전 키로 암호화된 기존 작업은 새 키로 다시 암호화됩니다.
  • 보호되지 않는 기존 작업이 암호화됩니다.
  • Cloud KMS에서 키를 순환해도 기존 작업이 자동으로 다시 암호화되거나 리전의 새 작업이 새 기본 키 버전으로 전환되지 않습니다. 자세한 내용은 CMEK 키 순환을 참조하세요.
  • 리전에 CMEK를 사용 중지하면 기존 작업은 Google 기본 암호화를 사용하여 암호화되고 후속 작업은 CMEK 암호화 없이 생성됩니다. 이 문서에서 Cloud Scheduler 리전에 CMEK 사용 중지를 참조하세요.

Cloud KMS 구성 확인

gcloud scheduler cmek-config describe 명령어를 사용하여 Cloud Scheduler 리전의 CMEK 구성을 검색하여 CMEK가 사용 설정되었는지 확인합니다.

gcloud scheduler cmek-config describe \
    --location=LOCATION

출력은 다음과 비슷합니다.

kmsKeyName: projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY_NAME
name: projects/PROJECT_ID/locations/LOCATION/cmekConfig

kmsKeyName 값은 리전의 작업을 보호하는 데 사용되는 Cloud KMS 키의 리소스 ID입니다.

Cloud Scheduler 리전에 CMEK 사용 중지

Cloud Scheduler 리전에 대해 CMEK를 사용 중지하여 해당 리전에서 생성된 모든 작업이 CMEK 암호화 없이 생성되도록 할 수 있습니다.

gcloud scheduler cmek-config update \
    --location=LOCATION \
    --clear-kms-key

이렇게 하면 특정 리전에 대한 CMEK가 사용 중지되고 이후의 모든 작업이 CMEK 암호화 없이 생성됩니다. 기존 작업은 Google 기본 암호화를 사용하여 암호화됩니다.

Cloud KMS 삭제

작업에 대한 데이터 액세스 권한을 취소하려면 다음 방법 중 하나로 Cloud KMS를 삭제하면 됩니다.

  • 고객 관리 암호화 키의 적절한 키 버전을 사용 중지하거나 폐기합니다. 키 버전이 사용 중인지 확인할 수 있습니다. CMEK 키 버전을 사용 중지하면 키가 다시 사용 설정될 때까지 이 키 버전으로 보호되는 모든 데이터에 대한 액세스가 정지됩니다. 키 버전을 폐기하면 액세스가 영구적으로 차단되고 복구할 수 없는 데이터 손실이 발생할 수 있습니다. 둘 다 특정 키 버전과 연결된 작업에만 영향을 미칩니다.

    사용 중지되거나 폐기된 키 버전으로 보호되는 리소스를 볼 수 없습니다. 활성 작업 실행은 해당 오류 메시지와 함께 실패합니다.

  • Cloud Scheduler 서비스 에이전트에서 roles/cloudkms.cryptoKeyEncrypterDecrypter IAM 역할을 취소합니다. 그러면 CMEK를 사용한 암호화를 지원하는 특정Google Cloud 프로젝트 및 리전의 모든 작업에 영향을 줍니다. CMEK 통합 작업을 새로 만들거나 CMEK로 암호화된 작업을 보거나 나열할 수 없습니다(삭제는 가능). 활성 작업 실행은 해당 오류 메시지와 함께 실패합니다.

이러한 작업은 즉시 액세스 취소를 보장하지는 않지만 일반적으로 IAM 변경 사항은 더 빠르게 적용됩니다. 자세한 내용은 Cloud KMS 리소스 일관성 및 액세스 변경 전파를 참조하세요.

CMEK 조직 정책 제약 조건 정보

Cloud Scheduler는 조직 전체에서 CMEK 사용을 시행하는 데 도움이 되는 다음 조직 정책 제약 조건을 지원합니다.

  • constraints/gcp.restrictNonCmekServices: 이 제약조건을 사용하여 CMEK를 사용하여 조직, 폴더 또는 프로젝트의 모든 새 Cloud Scheduler 리소스를 보호하도록 요구합니다.

    이 조직 정책이 활성 상태이면 먼저 Cloud KMS 키를 사용 설정하지 않는 한 리소스를 만들거나 업데이트할 수 없습니다. Cloud Scheduler 리전에 대해 CMEK를 사용 중지할 수도 없습니다.

  • constraints/gcp.restrictCmekCryptoKeyProjects: 이 제약조건을 사용하여 CMEK로 보호되는 Cloud Scheduler 리소스가 승인된 프로젝트의 키를 사용하도록 합니다.

    예를 들어 'projects/my-company-data-project의 모든 Cloud Scheduler 리소스에 대해 이 프로젝트에서 사용되는 Cloud KMS 키는 projects/my-company-central-keys 또는 projects/team-specific-keys에서 가져와야 한다'와 같은 규칙을 지정할 수 있습니다.

다음에 유의하세요.

  • CMEK 조직 정책을 적용한 후에도 Google 기본 암호화를 사용하는 기존 작업에 계속 액세스할 수 있습니다. 하지만 Cloud Scheduler 리전에 허용되는 Cloud KMS 키를 먼저 구성하지 않으면 업데이트할 수 없습니다.

  • App Engine 애플리케이션을 타겟팅하는 작업에는 CMEK 조직 정책이 적용되지 않습니다. 예를 들어 constraints/gcp.restrictNonCmekServices 제약조건을 설정해도 App Engine 애플리케이션을 타겟팅하는 작업을 만들거나 업데이트할 수 있습니다.

이러한 정책 구성에 대한 상세 설명은 CMEK 조직 정책을 참조하세요.

문제 해결

Cloud Scheduler에서 Cloud KMS를 사용할 때 오류가 발생할 수 있습니다. 다음 표는 다양한 문제와 해결 방법을 설명합니다.

문제 설명
cloudkms.cryptoKeyVersions.useToEncrypt 권한이 거부됨

제공된 Cloud KMS 키가 없거나 권한이 올바르게 구성되지 않았습니다.

솔루션:

키 버전이 사용 설정되지 않음

제공된 Cloud KMS 키가 사용 중지되었습니다.

솔루션: Cloud KMS 키 버전을 다시 사용 설정합니다.

키링 리전이 보호할 리소스와 일치하지 않음

제공된 Cloud KMS 키링 리전은 보호되는 Cloud Scheduler 리전과 다릅니다.

솔루션: Cloud Scheduler 리전과 동일한 리전의 Cloud KMS 키링을 사용합니다. 키링은 다른 프로젝트에 있을 수 있습니다. 자세한 내용은 Cloud KMS 위치 및 Cloud Scheduler 위치를 참조하세요.

프로젝트가 Cloud Scheduler의 CMEK와 호환되지 않음

CMEK를 사용 설정하면 FAILED_PRECONDITION 오류가 발생하고 Your project is currently not compatible with CMEK in Cloud Scheduler 메시지가 표시됩니다. 이 오류는 프로젝트의 기존 Cloud Scheduler 작업이 CMEK를 지원하도록 마이그레이션되지 않은 경우에 발생합니다. 예를 들어 서비스 에이전트 권한이 없거나 Pub/Sub 주제 이름이 잘못된 기존 작업으로 인해 마이그레이션이 차단될 수 있습니다.

솔루션:

  1. 프로젝트에서 권한 또는 작업 구성 문제를 검토하고 해결합니다.
    • Cloud Scheduler 서비스 에이전트에 프로젝트에 대한 Cloud Scheduler 서비스 에이전트(roles/cloudscheduler.serviceAgent) 역할이 있는지 확인합니다. 이 역할에는 프로젝트의 Pub/Sub 주제에 대한 pubsub.topics.publish 권한이 포함됩니다. 자세한 내용은 Cloud Scheduler 서비스 에이전트 역할 부여를 참조하세요.
    • 프로젝트에 roles/cloudscheduler.serviceAgent가 부여되지 않았거나 제한된 경우 서비스 에이전트에 각 대상 주제에 대한 Pub/Sub 게시자(roles/pubsub.publisher) 역할이 있는지 확인합니다.
    • 주제 이름이 잘못된 기존 Pub/Sub 대상 작업을 확인하고 업데이트하거나 삭제하세요. 주제 이름은 작업과 동일한 프로젝트에서 projects/PROJECT_ID/topics/TOPIC_ID 형식을 사용해야 합니다. 주제 이름 지정 규칙은 주제, 구독, 스키마, 스냅샷 이름 지정 가이드라인을 참조하세요.
  2. 권한 또는 작업 구성 문제를 해결한 후 Google Cloud 콘솔에서 지원 요청을 열어 마이그레이션을 완료하여 프로젝트에 CMEK를 사용 설정할 수 있습니다. 이전이 완료될 때까지 권한이나 작업 구성을 수정하는 것만으로는 오류가 해결되지 않습니다.

감사 로깅

Cloud KMS는 키가 사용 설정 또는 사용 중지되거나 Cloud Scheduler 리소스에서 사용하여 메시지를 암호화 및 복호화할 때 감사 로그를 생성합니다. 자세한 내용은 Cloud KMS 감사 로깅을 참조하세요.

Cloud EKM 오류

Cloud External Key Manager(Cloud EKM)를 통해 외부 관리 키를 사용할 때 발생할 수 있는 문제를 해결하려면 Cloud EKM 오류 참조를 참조하세요.

사용할 수 없는 키 상태

특정 이유로 Cloud KMS를 사용할 수 없는 경우 Cloud Scheduler가 Cloud KMS에서 키 상태를 검색하지 못할 수 있습니다.

작업이 실행되도록 예약되었을 때 Cloud KMS를 사용할 수 없는 경우 Cloud Scheduler는 작업 데이터를 복호화하거나 작업의 대상을 호출할 수 없습니다. 일시적인 Cloud KMS 오류(예: UNAVAILABLE, RESOURCE_EXHAUSTED 또는 연결할 수 없는 Cloud EKM 키)의 경우 Cloud Scheduler는 지수 백오프를 사용하여 내부적으로 복호화를 재시도하고 cloudscheduler.googleapis.com/cmek 아래의 Cloud Logging에 CmekRetryFailure 로그 항목을 로깅합니다. 권한 오류 또는 사용 중지되거나 폐기된 키와 같이 재시도할 수 없는 오류의 경우 대상을 호출하지 않고 복호화가 즉시 실패합니다.

Cloud KMS 할당량

Cloud Scheduler에서 CMEK를 사용할 때 프로젝트는 Cloud KMS 암호화 요청 할당량을 사용할 수 있습니다. 예를 들어 Cloud Scheduler는 작업을 실행하거나, 작업 관리 요청을 처리하거나, CMEK 구성을 업데이트할 때 이러한 할당량을 사용할 수 있습니다. Cloud Scheduler는 프로젝트 및 리전당 최대 5분 동안 캐시된 중간 키를 재사용하므로 빈번한 작업 실행으로 인해 할당량이 소모되지 않습니다. CMEK 키를 사용하는 암호화 및 복호화 작업은 하드웨어(Cloud HSM) 또는 외부(Cloud EKM) 키를 사용하는 경우에만 Cloud KMS 할당량에 영향을 미칩니다. 자세한 내용은 Cloud KMS 할당량을 참조하세요.

가격 책정

이 통합은 Google Cloud 프로젝트에 청구되는 Cloud KMS 키 작업 이외의 추가 비용을 발생시키지 않습니다.

키 권한 부여를 통해 키를 사용하는 기본 전송 리소스는 추가 Cloud KMS 작업을 수행할 수 있습니다. 직접 Cloud Scheduler 작업에 대한 Cloud KMS 사용량을 추정하려면 프로젝트 및 리전당 다음 암호화 작업 비율을 예상하세요.

  • 작업 실행: Cloud Scheduler는 프로젝트 및 리전당 최대 5분 동안 캐시된 중간 키를 재사용합니다. 5분마다 작업 실행이 1회 미만인 프로젝트는 실행당 약 1회의 Cloud KMS 복호화 작업을 수행합니다. 실행 빈도가 높은 프로젝트는 리전 전체에서 약 5분마다 한 번씩 복호화 작업을 수행합니다.
  • 작업 관리 작업: 보호된 데이터로 작업을 생성, 업데이트, 가져오기, 나열, 일시중지 또는 재개하는 요청은 프로젝트 및 리전당 최대 5분 동안 별도의 캐시된 중개 키를 사용합니다.
  • CMEK 구성 업데이트: cmek-config로 CMEK 키를 사용 설정하거나 변경하면 추가 Cloud KMS 키 작업을 수행하여 키를 검증하고 리전의 기존 보호된 작업을 다시 암호화합니다. CMEK를 사용 중지하면 기존 보호 작업이 Google 기본 암호화로 다시 복호화됩니다.

가격 책정 정보는 Cloud KMS 가격 책정을 참조하세요.