이 주제에서는 Cloud Key Management Service 대칭 키를 사용하여 데이터를 다시 암호화하는 방법을 보여줍니다. 비대칭 키에 이러한 예를 적용할 수 있습니다. 키의 무단 사용이 의심되는 경우 해당 키로 보호되는 데이터를 다시 암호화한 다음 이전 키 버전을 사용 중지하거나 폐기 예약해야 합니다.
시작하기 전에
이 시나리오에는 다음 조건이 필요합니다.
Cloud KMS를 사용하여 이미 데이터를 암호화한 상태입니다.
암호화에 사용되는 키 버전이 사용 중지됨, 폐기 예약됨 또는 폐기됨 상태가 아닙니다. 이 키 버전을 사용하여 암호화된 데이터를 복호화합니다.
이미 키 순환을 완료한 상태입니다. 키 순환은 새로운 기본 키 버전을 만듭니다. 새로운 기본 키 버전을 사용하여 데이터를 다시 암호화합니다.
비대칭 키를 사용하여 데이터 재암호화
이 주제의 예는 대칭 키를 사용하여 데이터를 다시 암호화하는 방법을 보여줍니다. 대칭 키를 사용하면 Cloud KMS가 자동으로 복호화에 사용할 키 버전을 추론합니다. 비대칭 키를 사용할 때는 키 버전을 지정해야 합니다.
- 다음 안내에 따라 Google Cloud CLI를 사용하는 경우 항상
--version플래그를 포함합니다. - 다음 안내에 따라 API를 사용하는 경우
CryptoKeys대신CryptoKeyVersions을 사용하세요. 비대칭 키로 데이터를 암호화 및 복호화하는 방법에 대해 자세히 알아보세요.
비대칭 키로 데이터를 다시 암호화하는 워크플로는 이 주제에 설명된 것과 유사합니다.
데이터 워크플로 다시 암호화
데이터를 다시 암호화하고 원래 암호화에 사용된 키 버전을 사용 중지하거나 폐기 예약하려면 다음 단계를 따르세요.
이전 키 버전을 사용하여 데이터 복호화
키 버전이 '사용 중지됨', '폐기 예약됨' 또는 '폐기됨' 상태가 아닌 한 Cloud KMS에서 자동으로 올바른 키 버전을 사용하여 데이터를 복호화합니다. 다음 예는 데이터를 복호화하는 방법을 보여줍니다. 이 코드는 암호화 및 복호화에 사용된 것과 동일한 복호화 코드입니다.
gcloud
명령줄에서 Cloud KMS를 사용하려면 먼저 최신 버전의 Google Cloud CLI로 설치 또는 업그레이드하세요.
gcloud kms decrypt \
--key KEY_NAME \
--keyring KEY_RING \
--location LOCATION \
--ciphertext-file FILE_TO_DECRYPT \
--plaintext-file DECRYPTED_OUTPUT
다음을 바꿉니다.
KEY_NAME: 복호화에 사용할 키의 이름입니다.KEY_RING: 키가 포함된 키링의 이름입니다.LOCATION: 키링이 포함된 Cloud KMS 위치입니다.FILE_TO_DECRYPT: 복호화하려는 파일의 경로입니다.DECRYPTED_OUTPUT: 복호화된 출력을 저장할 경로입니다.
모든 플래그 및 가능한 값에 대한 정보를 보려면 --help 플래그와 함께 명령어를 실행하세요.
C#
이 코드를 실행하려면 먼저 C# 개발 환경을 설정하고 Cloud KMS C# SDK를 설치합니다.
Go
이 코드를 실행하려면 먼저 Go 개발 환경을 설정하고 Cloud KMS Go SDK를 설치합니다.
Java
이 코드를 실행하려면 먼저 자바 개발 환경을 설정하고 Cloud KMS 자바 SDK를 설치합니다.
Node.js
이 코드를 실행하려면 먼저 Node.js 개발 환경을 설정하고 Cloud KMS Node.js SDK를 설치합니다.
PHP
이 코드를 실행하려면 먼저 Google Cloud에서 PHP 사용에 관해 알아보고 Cloud KMS PHP SDK를 설치하세요.
Python
이 코드를 실행하려면 먼저 Python 개발 환경을 설정하고 Cloud KMS Python SDK를 설치합니다.
Ruby
이 코드를 실행하려면 먼저 Ruby 개발 환경을 설정하고 Cloud KMS Ruby SDK를 설치합니다.
API
이 예시에서는 curl을 HTTP 클라이언트로 사용하여 API 사용을 보여줍니다. 액세스 제어에 대한 자세한 내용은 Cloud KMS API 액세스를 참조하세요.
Cloud KMS에서 JSON으로 반환된 복호화된 텍스트는 base64로 인코딩됩니다.
암호화된 데이터를 복호화하려면 POST 요청을 보내고 적절한 프로젝트와 키 정보를 제공하며 요청 본문의 ciphertext 필드에 복호화할 암호화된 텍스트(암호문이라고도 함)를 지정합니다.
curl "https://cloudkms.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY_NAME:decrypt" \
--request "POST" \
--header "authorization: Bearer TOKEN" \
--header "content-type: application/json" \
--data "{\"ciphertext\": \"ENCRYPTED_DATA\"}"
다음을 바꿉니다.
PROJECT_ID: 복호화에 사용할 키링과 키가 포함된 프로젝트의 ID입니다.LOCATION: 키링이 포함된 Cloud KMS 위치입니다.KEY_RING: 복호화에 사용할 키가 포함된 키링입니다.KEY_NAME: 복호화에 사용할 키의 이름입니다.ENCRYPTED_DATA: 복호화하려는 암호화된 데이터입니다.
다음은 base64로 인코딩된 데이터가 포함된 페이로드의 예시입니다.
{ "ciphertext": "CiQAhMwwBo61cHas7dDgifrUFs5zNzBJ2uZtVFq4ZPEl6fUVT4kSmQ...", }
새로운 기본 키 버전을 사용하여 데이터 다시 암호화
Cloud KMS는 자동으로 새로운 기본 키 버전을 사용하여 데이터를 암호화합니다. 다음 예는 데이터를 암호화하는 방법을 보여줍니다. 이 코드는 암호화 및 복호화에 사용된 것과 동일한 암호화 코드입니다.
gcloud
명령줄에서 Cloud KMS를 사용하려면 먼저 최신 버전의 Google Cloud CLI로 설치 또는 업그레이드하세요.
gcloud kms encrypt \
--key KEY_NAME \
--keyring KEY_RING \
--location LOCATION \
--plaintext-file FILE_TO_ENCRYPT \
--ciphertext-file ENCRYPTED_OUTPUT
다음을 바꿉니다.
KEY_NAME: 암호화에 사용할 키의 이름입니다.KEY_RING: 키가 포함된 키링의 이름입니다.LOCATION: 키링이 포함된 Cloud KMS 위치입니다.FILE_TO_ENCRYPT: 암호화하려는 파일의 경로입니다.ENCRYPTED_OUTPUT: 암호화된 출력을 저장할 경로입니다.
모든 플래그 및 가능한 값에 대한 정보를 보려면 --help 플래그와 함께 명령어를 실행하세요.
C#
이 코드를 실행하려면 먼저 C# 개발 환경을 설정하고 Cloud KMS C# SDK를 설치합니다.
Go
이 코드를 실행하려면 먼저 Go 개발 환경을 설정하고 Cloud KMS Go SDK를 설치합니다.
Java
이 코드를 실행하려면 먼저 자바 개발 환경을 설정하고 Cloud KMS 자바 SDK를 설치합니다.
Node.js
이 코드를 실행하려면 먼저 Node.js 개발 환경을 설정하고 Cloud KMS Node.js SDK를 설치합니다.
PHP
이 코드를 실행하려면 먼저 Google Cloud에서 PHP 사용에 관해 알아보고 Cloud KMS PHP SDK를 설치하세요.
Python
이 코드를 실행하려면 먼저 Python 개발 환경을 설정하고 Cloud KMS Python SDK를 설치합니다.