암호화 키 관리
System Mode KMS의 Encryption Keys에서 볼륨·kubeconfig 등 내부·플랫폼 리소스를 암호화하는 키를 조회하고, 순환·보관·파기합니다.
System Mode 전용 — 시스템 관리자(SysAdmin) 권한이 필요합니다. 도메인 관리자용 KMS 앱은 제공하지 않으며, 사용자 리소스(VM 볼륨 등) 암호화 키도 암·복호화 주체가 인프라이므로 시스템 KMS에서 관리합니다.
KMS는 키를 발급하지 않습니다
KMS는 모든 보안 자산의 원천 발급 시스템이 아닙니다. 키의 최초 발급은 각 앱 또는 연동 시스템이 담당하고, KMS는 저장·조회·상태 통제를 맡는 관리 계층입니다. 키 주입은 백엔드 직접 주입(초기 세팅의 필수 경로)이 원칙이며, 시스템 KMS UI를 통한 직접 입력·자동 생성은 추가 검토 중입니다. 이 콘솔은 저장된 키의 조회·순환·수명주기 관리에 초점을 둡니다.
사전 조건
- Signum 엔지니어링 모드(시스템 관리자) 접근 권한
- 대상 키가 이미 플랫폼에 존재해야 합니다
1단계 — 키 목록 조회
KMS → Encryption Keys로 이동합니다. 좌측 사이드바(번호 1)에서 KMS의 네 화면으로 이동할 수 있고, 검색(번호 2)으로 키를 찾은 뒤 목록 테이블(번호 3)에서 상태·알고리즘·현재 버전·다음 순환일을 확인합니다.
각 행 오른쪽의 Action 메뉴에서 Rotate now / Archive / Restore / Destroy를 실행할 수 있습니다.
사이드바 (SNB)
좌측 사이드바에서 KMS의 네 화면(개요·암호화 키·시크릿·인증서)으로 이동한다.
| 번호 | 기능 | 항목 | 설명 |
|---|---|---|---|
| 1-1 | 개요 | Overview | · 키·인증서·시크릿 요약 대시보드. |
| 1-2 | 암호화 키 | Encryption Keys | · 암호화 키 목록·순환·보관·파기. |
| 1-3 | 시크릿 | Secrets | · Secret 값·버전·만료 관리. |
| 1-4 | 인증서 | Certificates | · TLS 인증서 조회·갱신·폐기. |
검색
키 이름·도메인·알고리즘 등 속성으로 키를 검색한다.
키 목록 테이블
등록된 암호화 키 목록. 키 이름을 클릭하면 상세로 이동한다.
| 번호 | 기능 | 항목 | 설명 |
|---|---|---|---|
| 3-1 | 목록 컬럼 | Status | 키 상태 — Active / Archived 등. |
| Key name | 키 이름(클릭 시 상세로 이동). | ||
| Domain | 키가 속한 도메인/키링. | ||
| Algorithm | 암호화 알고리즘(예: aes256-gcm96). | ||
| Key purpose | 키 용도(예: ENCRYPT_DECRYPT). | ||
| Current version | 현재 활성 버전 번호. | ||
| Created at | 생성 시각. | ||
| Next rotation at | 다음 자동 순환 예정일. | ||
| Action | 행 메뉴 — Rotate now / Archive / Restore / Destroy. |
2단계 — 키 상세 확인
목록에서 Key name을 클릭하면 상세로 이동합니다. 상단 요약 카드(번호 1)에서 도메인·상태·알고리즘·용도·현재 버전을 확인하고, Rotation 탭의 순환 설정(번호 2)과 순환 이력(번호 3)을 살펴봅니다. History 탭(번호 4)에서는 순환 이력과 달리 키의 생성·상태 전이 등 변경 이력을 조회합니다.
키 요약
선택한 키의 기본 정보(도메인·상태·알고리즘·용도·현재 버전·생성자·생성 시각).
| 번호 | 기능 | 항목 | 설명 |
|---|---|---|---|
| 1-1 | 도메인 | Domain | · 키가 속한 도메인/키링. |
| 1-2 | 상태 | Status | · 키 활성 상태. |
| 1-3 | 알고리즘 | Algorithm | · 암호화 알고리즘. |
| 1-4 | 용도 | Key purpose | · 키 용도(ENCRYPT_DECRYPT 등). |
| 1-5 | 현재 버전 | Current version | · 현재 활성 버전. |
순환 설정
자동 순환 여부와 주기를 확인하고, 즉시 순환하거나 설정을 수정한다.
| 번호 | 기능 | 항목 | 설명 |
|---|---|---|---|
| 2-1 | 설정 수정 | Edit | · 자동 순환·주기 설정을 수정하는 드로어를 연다. |
| 2-2 | 즉시 순환 | Rotate now | · 새 버전을 즉시 생성해 키를 순환한다. 이전 버전은 복호화용으로 유지. |
| 2-3 | 자동 순환 | Automatic rotation | · 자동 순환 On/Off. |
| 2-4 | 순환 주기 | Rotation period | · 자동 순환 주기(예: 90일)와 다음 순환일. |
순환 이력
버전별 순환 이력. 각 버전의 상태와 순환 시각을 확인한다.
| 번호 | 기능 | 항목 | 설명 |
|---|---|---|---|
| 3-1 | 이력 컬럼 | Status | 버전 상태 — Active / Deactivated. |
| Version | 키 버전 번호. | ||
| Rotated at | 해당 버전으로 순환된 시각. | ||
| Action | 버전별 행 메뉴. |
변경 이력 (History 탭)
History 탭에서 키에 대한 변경 이력을 조회한다. Rotation 탭의 순환 이력과 달리, 키의 생성·상태 전이 등 변경 이벤트를 기록한다.
| 번호 | 기능 | 항목 | 설명 |
|---|---|---|---|
| 4-1 | 변경 이력 | History | · 키 생성·상태 전이 등 변경 이벤트가 기록됩니다. 아직 이력이 없으면 비어 있습니다. |
3단계 — 순환 설정 수정
키 상세의 Rotation 탭에서 Edit(번호 1)를 클릭하면 순환 설정 드로어(번호 2)가 열립니다. Automatic rotation 토글로 자동 순환을 켜고, Rotation period(일)를 지정한 뒤 Save로 저장합니다. 저장하면 다음 순환일이 재계산됩니다.
즉시 순환이 필요하면 상세의 Rotate now를 사용합니다. 새 버전이 즉시 생성되고 이전 버전은 복호화용으로 유지됩니다.
수정 진입
키 상세의 Rotation 탭에서 Edit를 클릭한다.
순환 설정 수정 드로어
자동 순환 여부와 주기를 수정한다. 저장 시 다음 순환일이 재계산된다.
| 번호 | 기능 | 항목 | 설명 |
|---|---|---|---|
| 2-1 | 자동 순환 | Automatic rotation | · 자동 순환 켜기/끄기 토글. |
| 2-2 | 순환 주기 | Rotation period | · 자동 순환 주기(일) 입력. |
| 2-3 | 저장 / 취소 | Save / Cancel | · Save: 설정 저장. Cancel: 닫기. |
WARNING
Destroy는 키를 영구 파기합니다. 파기된 키로 암호화된 데이터는 복호화할 수 없습니다. 파기 전 키 사용 현황을 반드시 확인하세요.
키 상태 모델
암호화 키의 상태는 버전(Version) 단위로 독립 관리됩니다. 하나의 키(UUID) 안에서 Active 버전은 최대 1개이며, 순환하면 새 버전이 Active가 되고 기존 버전은 자동으로 Deactivated로 전환됩니다.
| 상태 | 암호화 | 복호화 | 설명 |
|---|---|---|---|
| Active | O | O | 현재 사용 중인 버전 |
| Deactivated | X | O | 순환으로 대체된 이전 버전. 기존 데이터 복호화를 위해 읽기 유지 |
| Archived | X | X | 보관(soft-delete). 암·복호화 모두 차단 |
| Destroyed | X | X | 영구 삭제. 물리적 제거 완료(복구 불가) |
행 Action 메뉴의 액션은 이 상태 전이에 대응합니다.
| 액션 | 전이 | 설명 |
|---|---|---|
| Rotate now | Active → Deactivated (+ 새 Active) | 새 버전을 생성해 순환 |
| Archive | Active/Deactivated → Archived | 보관. 침해가 의심되는 키는 Active에서 즉시 Archive해 암·복호화를 차단(긴급 대응) |
| Restore | Archived → Deactivated | 보관 해제. 재사용보다 신규 키 발급 권장 |
| Destroy | → Destroyed | 영구 파기 |
확인 절차
Archive·Restore·Destroy 등 상태 변경은 확인 절차와 사유(reason) 입력이 필요하며, 모든 전이는 감사 로그에 기록됩니다.
결과 확인
- 순환 설정 변경이 상세의 Rotation settings와 목록의 Next rotation at에 반영됩니다.
- 순환을 실행하면 Rotation history에 새 버전이 추가되고 Current version이 올라갑니다.