Copy & Run

GCP Cloud KMS 키 만들고 암호화·복호화 확인하기

us-central1에 키링과 대칭 키를 만들고 기본 회전 주기 90일과 폐기 대기 30일 설정을 확인합니다. Cloud Shell에서 짧은 문장을 암호화하고 복호화해 원문과 같은지 비교합니다. 키 버전 1을 폐기 예약하면 30일 뒤 파기된다고 표시되고, 그 사이 키 상태는 Not available이 됩니다. 콘솔이 안내하는 삭제 순서는 버전, 키, 키링입니다. 이 글에서는 최종 삭제를 하지 않았고, 버전 1이 파기 예약된 상태에서 키와 키링을 그대로 두었습니다.

실습 노트 · 2026-11-10 발행 · 2026-11-12 수정 · 8분 · 2026-11 확인

Cloud KMS는 데이터를 암호화하고 복호화하는 데 쓰는 키를 콘솔에서 관리하는 기능입니다. 콘솔의 설명에 따르면 키는 데이터를 암호화하고 복호화하거나 디지털 서명을 만들고 검증하는 자원이고, 키 하나에 여러 버전이 있을 수 있습니다. 키를 묶어 두는 상자는 키링입니다. 콘솔 안내는 "Key rings group keys together to keep them organized."입니다.

이 글에서는 키링 cr-lab-ring과 대칭 키 cr-lab-key를 us-central1에 만들고, Cloud Shell에서 짧은 문장을 암호화했다가 복호화합니다. 그다음 키 버전 1을 폐기 예약합니다. 삭제 기능은 이 글에서 끝까지 실행하지 않았습니다. 콘솔이 안내하는 삭제 순서와 조건을 화면에서 읽는 데까지 진행했습니다.

한 문장 답

Security > Key Management에서 키링(cr-lab-ring, us-central1)과 대칭 키(cr-lab-key)를 만들면 기본값은 Software 보호 수준, 용도 "Symmetric encrypt/decrypt", 회전 90일, 폐기 대기 30일입니다. Cloud Shell의 gcloud kms encrypt와 decrypt로 19바이트 문장을 암호화하자 100바이트 파일이 생겼고, 복호화하자 원문과 같은 문장이 나왔습니다. 키 버전 1을 폐기 예약하자 파기 예정일이 30일 뒤로 표시되었고, 키 상태는 Not available이 되었습니다. 이 글에서는 최종 삭제를 실행하지 않았습니다.

준비물

항목 내용
프로젝트 copyandrun-net-lab. Cloud KMS API가 사용 설정되어 있었습니다
화면 Security > Key Management (console.cloud.google.com/security/kms/keyrings), Cloud Shell
키링 cr-lab-ring, Location type Region, us-central1 (Iowa)
키 cr-lab-key, Protection Level Software, Purpose Symmetric encrypt/decrypt, Algorithm Google symmetric key
시험 문장 copyandrun kms test (19 bytes)
남은 리소스 키링 cr-lab-ring, 키 cr-lab-key, 버전 1(폐기 예약). 자동 회전은 Never로 바꿔 두었습니다
콘솔 예상 금액 콘솔에 표시가 없었습니다

입력할 값

화면 항목 입력하거나 고른 값
Key ring name cr-lab-ring
Location type Region. 기본값 Multi-region에서 바꿨습니다
Region us-central1 (Iowa)
Key name cr-lab-key
Protection Level Software (기본값 그대로)
Rotation period 90 days (기본값 그대로. 나중에 Never로 바꿨습니다)
Duration of 'scheduled destruction' state 30 days (기본값 그대로)

1. 키링 만들기

  1. Key management 화면을 엽니다. 탭은 Overview, Key rings, Key inventory입니다. 화면 위에는 Create key ring, Tags, KMS Infrastructure, KMS Controls, Refresh가 있습니다. 키링이 하나도 없을 때는 "Create your first key ring"이 나옵니다.

  2. Create key ring을 누릅니다. 화면에는 "Key rings group keys together to keep them organized. In the next step, you'll create keys that are in this key ring."이라는 설명이 있습니다. Project name은 copyandrun-net-lab입니다. Key ring name에 cr-lab-ring을 넣습니다.

    Location type의 기본값은 Multi-region이고, 값은 global (Global)이었습니다. 이 위치에서는 "EKM and Single Tenant HSM are not available in this location"이라는 안내가 나옵니다. 이 글에서는 Region으로 바꿨습니다. Region 선택 창의 Filter에 us-central1을 넣고 us-central1 (Iowa)(Low CO2)를 고른 뒤 OK를 눌렀습니다. 항목을 클릭하는 것만으로는 선택 창이 닫히지 않았고, OK를 눌러야 값이 들어갔습니다.

    Create를 누르면 "Key ring cr-lab-ring has been created" 알림이 뜨고, 바로 Create key 화면으로 넘어갑니다.

    키링 위치를 기본값 Multi-region에서 Region us-central1로 바꾼 것을 확인합니다.
    키링 위치를 기본값 Multi-region에서 Region us-central1로 바꾼 것을 확인합니다.

2. 키 만들고 기본값 읽기

  1. Create key 화면에서 Key name에 cr-lab-key를 넣습니다. Protection Level의 기본값은 Software입니다. 선택지는 HSM, Single-tenant HSM, External입니다. 각 선택지의 설명은 다음과 같습니다. Software는 "Cryptographic operations are performed on software"입니다. HSM은 "...on a Hardware Security Module (HSM)"입니다. Single-tenant HSM은 "...on an isolated Hardware Security Module (HSM) cluster"입니다. External은 "...using a key stored in an external key manager."입니다.

    화면 요약에는 Key material Generated, Purpose Symmetric encrypt/decrypt, Algorithm Google symmetric key가 있습니다. Versions 항목에는 Key rotation period 90 days와 Starting on 2/8/27이 있습니다. Additional settings의 Duration of 'scheduled destruction' state는 30 days (default)입니다. 오른쪽 Key creation details에는 Project name, Location us-central1, Key ring cr-lab-ring이 나옵니다.

    기본값 90일과 30일은 콘솔이 정한 값입니다. 이 글에서는 이 두 값을 바꾸지 않았습니다.

    새 키의 기본 회전 주기 90일과 폐기 대기 기간 30일을 확인합니다.
    새 키의 기본 회전 주기 90일과 폐기 대기 기간 30일을 확인합니다.

  2. Create를 누르면 "Key cr-lab-key has been created" 알림이 뜹니다. 키링 상세 화면에는 Create key, Create import job, Delete key ring(비활성) 버튼이 있습니다. 위에는 "Introducing KMS resource deletion (New)"라는 배너가 있습니다. 배너 본문은 "You can now permanently delete keys, key versions, and key rings you no longer need."입니다.

    키 표에는 cr-lab-key, Status Available, Protection level Software, Purpose Symmetric encrypt/decrypt, Next rotation Feb 8, 2027이 나옵니다. 키 행의 ⋮ 메뉴에는 Disable all key versions, Destroy all key version material, Edit rotation period, Copy resource name, Delete key가 있습니다.

  3. 키 상세 화면을 엽니다. 버튼은 Rotate key, Edit Rotation Period, Import key version, Delete key(비활성)입니다. Status는 Available, Location은 us-central1, Protection level은 Software, Rotation은 Every 90 days입니다. 탭은 Overview, Versions, Usage tracking, Permissions입니다.

    Versions 탭에는 버전 1이 있습니다. Status는 Enabled & primary이고, 종류는 Google symmetric key입니다. 생성 시각은 11/10/26 9:58 PM이고, Created from은 Generated입니다. 버전 행의 ⋮ 메뉴에는 Disable, Destroy, Delete, Copy resource name이 있습니다.

3. Cloud Shell에서 암호화하고 복호화하기

  1. 콘솔 위의 Cloud Shell을 엽니다. Cloud Shell 권한 승인은 서비스 계정 글(7편)에서 이미 해 두었습니다. 터미널에서 다음 명령을 순서대로 실행했습니다.

    echo -n 'copyandrun kms test' > p.txt
    gcloud kms encrypt --location=us-central1 --keyring=cr-lab-ring --key=cr-lab-key --plaintext-file=p.txt --ciphertext-file=p.enc
    ls -l p.txt p.enc | awk '{print $5, $9}'; head -c 30 p.enc | base64
    gcloud kms decrypt --location=us-central1 --keyring=cr-lab-ring --key=cr-lab-key --ciphertext-file=p.enc --plaintext-file=p.dec
    cat p.dec; echo; diff p.txt p.dec && echo SAME
    
  2. 출력은 다음과 같습니다. ls 줄의 결과는 파일 크기와 이름입니다.

    100 p.enc
    19 p.txt
    

    head -c 30 p.enc | base64 명령은 암호문 앞부분을 base64로 찍습니다. 이 글에서 기록한 것은 앞부분 CiQAz/U3m으로 시작한다는 사실뿐입니다. 전체 줄은 옮기지 않았습니다. encrypt와 decrypt 명령은 자체 출력 없이 끝났습니다.

    복호화 뒤 cat p.dec 결과와 diff 결과는 다음과 같습니다.

    copyandrun kms test
    SAME
    

    암호화한 파일을 복호화한 결과가 원문과 같습니다. 마지막 줄의 SAME이 그 표시입니다.

    Cloud Shell에서 암호화한 파일을 복호화해 원문과 같다는 SAME 결과를 확인합니다.
    Cloud Shell에서 암호화한 파일을 복호화해 원문과 같다는 SAME 결과를 확인합니다.

  3. 같은 문장을 두 번 암호화했습니다. 첫 번째 시도는 화면을 정리하느라 다시 실행한 것입니다. 두 번 나온 암호문을 base64로 비교하니 앞 9글자 CiQAz/U3m까지는 같았고 그 뒤부터 달랐습니다. 같은 평문인데도 두 번의 암호문이 서로 다른 것을 관찰했습니다.

  4. 파일을 정리했습니다.

    rm -f p.txt p.enc p.dec; ls p.* 2>/dev/null | wc -l
    

    출력은 0이었습니다. 실습 파일이 남아 있지 않다는 뜻입니다.

4. 키 버전 폐기 예약하기

  1. Versions 표에서 버전 1의 ⋮ 메뉴를 열고 Destroy를 누릅니다. 대화상자 제목은 'Schedule key version 1 for destruction?'입니다. 경고 문구는 두 개입니다. "Do not make destruction decisions based on key usage information alone as this information may be delayed or incomplete."와 "You cannot recover key versions after they have been destroyed."입니다. 대화상자는 "There are steps to take before destroying key versions."라고도 안내합니다.

    예약하면 즉시 일어나는 일도 나열되어 있습니다. 버전은 비활성화되고, 이 버전으로 암호화한 데이터는 복호화할 수 없고, 이 버전으로 서명한 데이터는 검증할 수 없게 된다는 내용입니다. 파란 칸에는 "Per this key's settings, this version will be destroyed after 30 days."가 나옵니다.

    확인 칸에는 "Type the key name (cr-lab-key) to schedule version 1 for destruction:"이라는 안내가 있습니다. 키 이름 cr-lab-key를 넣고 Schedule destruction을 눌렀습니다.

    키 버전 폐기 예약 창에서 30일 뒤 파기된다는 안내를 확인합니다.
    키 버전 폐기 예약 창에서 30일 뒤 파기된다는 안내를 확인합니다.

  2. 알림 "Key version 1 has been scheduled for destruction"이 뜹니다. 버전 1의 State에는 "Will be destroyed on 12/10/26, 10:02 PM"이 표시됩니다. 키의 Status는 Not available이 되었습니다. 노란 배너에는 "To operate on data with this key, restore primary version or select a new primary version"이 나옵니다. 이 키에는 버전이 하나뿐이었고, 그 버전이 예약되자 키 상태가 바로 바뀌었습니다.

    폐기 예약 직후 키가 Not available로 바뀌고 파기 예정일이 표시되는 것을 확인합니다.
    폐기 예약 직후 키가 Not available로 바뀌고 파기 예정일이 표시되는 것을 확인합니다.

  3. 예약된 버전의 ⋮ 메뉴에는 Restore, Delete(비활성), Copy resource name이 있습니다. Delete에 마우스를 올리면 "Key versions with statuses other than destroyed, import failed, or generation failed cannot be deleted."라는 툴팁이 나옵니다. Restore는 누르지 않았습니다.

    파기가 끝나지 않은 키 버전은 Delete할 수 없다는 안내를 확인합니다.
    파기가 끝나지 않은 키 버전은 Delete할 수 없다는 안내를 확인합니다.

5. 자동 회전 끄고 삭제 조건 읽기

  1. 키 상세 화면의 Delete key 버튼은 비활성입니다. 마우스를 올리면 "Keys with scheduled rotation cannot be deleted. You need to remove automated rotation first."라는 툴팁이 나옵니다. 키를 지우려면 자동 회전을 먼저 끄라는 뜻입니다.

  2. Edit Rotation Period를 엽니다. 창 제목은 'Edit rotation period for "cr-lab-key"'입니다. 설명은 "After this time period, a new key version will be created and used to encrypt new data."입니다. 선택지는 30 days, 90 days, 180 days, 365 days, Never (manual rotation), Custom입니다. 기존 요약에는 "Rotation summary: every 90 days beginning February 8, 2027."이 적혀 있었습니다.

    창의 설명대로라면 회전 시점에 새 버전이 생기고 그 버전이 새 데이터를 암호화합니다. 그래서 값을 **Never (manual rotation)**으로 바꾸고 Save를 눌렀습니다. 알림 'Rotation period for "cr-lab-key" has been updated'가 떴습니다. Rotation은 "Never (manual rotation)"이 되었고, 키링 표의 Next rotation은 "Not scheduled"가 되었습니다.

  3. 회전을 끈 뒤 Delete key 툴팁을 다시 보았습니다. 이번에는 "Keys with versions cannot be deleted. You need to delete versions first."라는 안내가 나왔습니다. 회전 조건은 풀렸고, 이제 키 삭제를 막는 것은 남아 있는 버전입니다.

    회전을 끈 뒤에도 버전이 남아 있으면 키를 지울 수 없다는 안내를 확인합니다.
    회전을 끈 뒤에도 버전이 남아 있으면 키를 지울 수 없다는 안내를 확인합니다.

  4. 키링 상세 화면의 Delete key ring 버튼도 비활성입니다. 툴팁은 "Key rings with keys cannot be deleted. You must delete the keys first."입니다. 이 화면에도 "Introducing KMS resource deletion (New)" 배너가 있었습니다.

    키가 남아 있는 키링은 삭제 버튼이 막혀 있는 것을 확인합니다.
    키가 남아 있는 키링은 삭제 버튼이 막혀 있는 것을 확인합니다.

  5. 화면 안내를 정리하면 삭제 순서는 버전, 키, 키링입니다. 버전은 파기가 끝난 뒤에 Delete할 수 있습니다. 버전 1은 "Will be destroyed on 12/10/26, 10:02 PM"으로 표시되어 있습니다. 그 시점 이후에 버전, 키, 키링 순서로 지울 수 있는지는 이 글에서 확인하지 않았습니다.

자주 막히는 곳

증상 확인할 것
키링 위치가 Multi-region으로 잡힘 Multi-region(global)이 기본값입니다. Region을 고르고 Region 선택 창에서 OK를 눌러야 값이 들어갑니다
폐기 예약 뒤 키가 Not available이 됨 버전이 하나뿐인 이 키는 예약 직후 Status가 Not available이 되었습니다. 예약된 버전 메뉴에는 Restore가 있었습니다. Restore는 이 글에서 누르지 않았습니다
키를 지우는 버튼이 비활성임 툴팁이 조건을 알려 줍니다. 자동 회전이 켜져 있으면 회전을 Never로 바꿉니다. 버전이 남아 있으면 버전 파기가 끝난 뒤 그 버전을 먼저 지웁니다
삭제 순서가 헷갈림 콘솔이 안내하는 순서는 버전 파기, 버전 Delete, 키 Delete, 키링 Delete입니다. 파기 대기 30일 때문에 같은 날 끝나지 않습니다
encrypt와 decrypt가 감사 로그에 남는지 궁금함 Admin Activity 감사 로그에는 encrypt와 decrypt 호출이 없었습니다. 같은 프로젝트의 데이터 접근 감사 로그 설정은 Disabled였습니다. 켜면 기록되는지는 확인하지 않았습니다

자주 묻는 질문

GCP Cloud KMS 키링은 어떤 위치로 만들어야 하나요?

기본값은 Multi-region이라서 Region을 고른 뒤 선택 창에서 OK를 눌러야 us-central1 (Iowa)이 들어갔습니다.

Cloud KMS로 암호화한 파일은 복호화하면 원문과 같나요?

네, 19바이트 문장을 Cloud Shell에서 암호화한 뒤 복호화하자 원문과 같은 문장이 나왔고 비교 결과도 같았습니다.

Cloud KMS 키 버전을 폐기 예약하면 바로 삭제되나요?

아니요, 폐기 예약 뒤 기본 30일이 지나야 파기되며, 그 사이 버전이 하나뿐인 키의 상태는 Not available로 바뀌었습니다.

확인 범위

  • 해 본 것:
    • 날짜는 2026-11-10이고 콘솔 언어는 English입니다.
    • 키링 cr-lab-ring을 us-central1 Region으로 만들었습니다.
    • 키 cr-lab-key를 기본값으로 만들고 기본 회전 주기와 폐기 대기 기간을 읽었습니다.
    • Cloud Shell에서 gcloud kms encrypt와 decrypt를 실행하고 원문과 비교했습니다.
    • 키 버전 1을 폐기 예약하고 상태와 파기 예정일을 확인했습니다.
    • 자동 회전을 Never로 바꿨습니다.
    • 키와 키링 삭제 버튼의 툴팁을 확인했습니다.
  • 해 보지 않은 것:
    • HSM 키와 External 키를 만들지 않았습니다.
    • 키 회전을 실행하지 않았습니다.
    • Restore를 누르지 않았습니다.
    • 버전 1을 Delete하지 않았습니다. 키와 키링도 지우지 않았습니다. 파기 예정일 이후에 그 삭제 단계가 실행되는지 확인하지 않았습니다.
    • 30일 대기 기간을 짧게 바꿀 수 있는지 확인하지 않았습니다. 이 설정은 키 생성 폼의 Additional settings에서만 확인했습니다.
    • IAM 권한을 부여하지 않았습니다.
    • CMEK 연결을 하지 않았습니다.
    • Usage tracking 탭의 내용을 보지 않았습니다.
    • 콘솔 예상 금액은 확인하지 않았습니다.
    • 데이터 접근 감사 로그를 켜지 않았습니다. 켰을 때 encrypt와 decrypt 호출이 기록되는지 확인하지 않았습니다.
  • 읽을 때 주의: 이 글의 키링, 키, 버전 1은 2026-11-10 기준으로 남아 있습니다. 파기 예정일 전후의 상태는 이 글에 없습니다. 파기 예정일은 12/10/26, 10:02 PM으로 화면에 표시된 그대로 적었습니다.
  • 참고: 화면 주소는 console.cloud.google.com/security/kms/keyrings입니다.

관련 글: 이전 글 GCP Secret Manager로 비밀값 저장하고 접근 권한 제한하기에서 Secret 생성 폼의 Cloud KMS key 선택지를 봤습니다. 이 글은 그 선택지와 이어지는 키를 만든 기록입니다. 다음 글 GCP Cloud Audit Logs 읽기: 관리자 활동 로그로 변경 이력 보기에서는 이 글의 키 생성, 폐기 예약, 회전 변경이 감사 로그에 어떻게 남았는지 확인합니다. Cloud Shell 사용법은 GCP Cloud Shell 사용법: 설치 없이 브라우저에서 gcloud 실행을 참고하십시오.

이 글의 다음 단계

클라우드 보안 실무 과정의 일부입니다

이 실습은 교육에서 참가자마다 독립된 환경으로 진행합니다. 원하는 일정을 고르면 문의 양식에 미리 채워집니다.

과정 보기

팀이나 교육 담당자에게 이 글 제안하기

교육 진행 순서와 자주 묻는 질문 보기

같은 카테고리의 글