Vault (4/5): Rekey, rotate khóa storage và rotate Transit key

Series Vault — Bài 4/5.

Tóm tắt

Trong Vault, rekey, rotate khóa storage và rotate Transit key là ba thao tác khác nhau. Chạy nhầm lệnh có thể thay sai lớp khóa mà không xử lý mục tiêu vận hành. Bài này tách phạm vi từng thao tác và trình tự kiểm tra; ví dụ chỉ dùng trên cụm lab.

Từ khóa: rekey; storage encryption key; Transit key; Shamir; recovery keys.

1. Giới thiệu

Vault quản lý nhiều lớp khóa với phạm vi tác động khác nhau. Thay người giữ unseal share, đổi khóa mã hóa storage và đổi key mã hóa dữ liệu ứng dụng không dùng chung một quy trình.

Bài viết phân loại các thao tác rekey/rotate và trình bày quy trình vận hành tham khảo, gồm điều kiện thực hiện, xác minh và kiểm tra sau thay đổi.

2. Cơ sở kỹ thuật: Các lớp khóa trong Vault

  • Thay người giữ share hoặc đổi threshold: dùng vault operator rekey; với auto-unseal, rekey recovery keys bằng target tương ứng.
  • Đổi khóa Vault dùng cho các lần ghi storage tiếp theo: dùng vault operator rotate.
  • Đổi phiên bản key mã hóa dữ liệu ứng dụng: gọi transit/keys/orders/rotate.
  • Đưa ciphertext ứng dụng cũ sang phiên bản mới: gọi transit/rewrap/orders rồi cập nhật nơi lưu ciphertext.

Root token là credential quản trị API, không phải unseal key hay Transit key. Rotate khóa storage không đổi mật khẩu database hoặc các giá trị đang lưu trong KV.

3. Quy trình quản lý khóa

3.1. Rekey với Shamir

Rekey phục vụ việc đổi bộ share và cách phân chia quyền kiểm soát khóa. Ví dụ, khi thay người giữ share hoặc đổi threshold, quy trình này cấp bộ share mới. Nó không thay thế thao tác đổi Transit key đang dùng để mã hóa trường dữ liệu của ứng dụng.

Rekey thay bộ unseal shares theo số share và threshold mới. Cần đủ số share theo threshold hiện tại để hoàn thành phần xác nhận bằng khóa cũ. Ví dụ đổi sang ba share, threshold hai; số share cũ cần nộp vẫn phụ thuộc cấu hình hiện tại, không mặc định là hai. [Operator rekey]

Trước khi chạy: xác nhận cơ chế seal, có đủ người giữ share, xác minh public PGP key của từng người và chuẩn bị cách lưu giữ share mới. Các tên tệp PGP dưới đây là ví dụ; phải thay bằng public key đã kiểm tra fingerprint. Không ghi share trực tiếp vào câu lệnh hay tài liệu.

CLI — Khởi tạo rekey, mã hóa share mới bằng PGP

vault operator rekey -status

vault operator rekey \
  -init \
  -key-shares=3 \
  -key-threshold=2 \
  -verify \
  -pgp-keys='operator-a.asc,operator-b.asc,operator-c.asc'

Ghi nhận nonce của lần rekey. Mỗi người giữ share cũ tự chạy lệnh sau và nhập share ở prompt ẩn. REKEY_NONCE là nonce vừa nhận, không phải key share.

CLI — Mỗi người giữ share cũ thực hiện

read -r -p 'Rekey nonce: ' REKEY_NONCE
vault operator rekey -nonce="$REKEY_NONCE"

Khi đủ threshold cũ, phân phối từng share mới đã được mã hóa PGP đúng người nhận. Mỗi người giải mã share của mình trong môi trường được kiểm soát. Do đã dùng -verify, tiếp tục bước xác minh với share mới và verification nonce; không coi rekey hoàn tất chỉ vì đã có output chứa share.

CLI — Xác minh bằng share mới

read -r -p 'Verification nonce: ' VERIFY_NONCE
vault operator rekey -verify -nonce="$VERIFY_NONCE"
vault operator rekey -status

Các người giữ share mới thực hiện đủ threshold của bước verification. Chỉ cập nhật hồ sơ quản lý khóa sau khi Vault xác nhận quy trình hoàn tất. Bài không đưa share hoặc output chứa share lên trang.

3.2. Rekey recovery shares khi dùng auto-unseal

Với auto-unseal, thêm -target=recovery để rekey bộ recovery shares. Recovery shares phục vụ các thao tác quản trị cần threshold; không thay thế KMS/HSM đang bảo vệ cơ chế auto-unseal. [Seal/Unseal]

CLI — Khởi tạo rekey recovery shares

vault operator rekey \
  -target=recovery \
  -init \
  -key-shares=3 \
  -key-threshold=2 \
  -verify \
  -pgp-keys='operator-a.asc,operator-b.asc,operator-c.asc'

Ở các bước nộp share, kiểm tra status và verification tiếp theo, tiếp tục truyền -target=recovery. Không trộn nonce hoặc shares giữa quy trình Shamir và recovery.

3.3. Rotate khóa mã hóa storage

Storage rotate thay khóa dùng cho các lần Vault ghi dữ liệu xuống backend tiếp theo. Phạm vi của thao tác là lớp lưu trữ bên trong Vault. Vì vậy, chạy lệnh này không làm các ciphertext trong MySQL chuyển từ vault:v1: sang vault:v2:.

CLI — Phiên quản trị có quyền tương ứng

vault operator key-status
vault operator rotate
vault operator key-status

Lệnh rotate thêm khóa mã hóa storage mới; các lần ghi tiếp theo dùng khóa mới. Vault giữ các khóa trước đó để đọc dữ liệu đã mã hóa. Lệnh này không tự re-encrypt toàn bộ dữ liệu ứng dụng trong MySQL và không rotate named key orders của Transit. [Operator rotate]

Đối chiếu key term trước/sau bằng key-status. Không dùng thay đổi prefix vault:vN: của dữ liệu ứng dụng để kiểm tra thao tác storage rotate: đó là version thuộc Transit. [Key-status]

CLI — Đọc và đặt chu kỳ auto-rotation storage trong lab

vault read sys/rotate/config
vault write sys/rotate/config interval=2160h
vault read sys/rotate/config

2160h là 90 ngày, chỉ là giá trị ví dụ. Đối chiếu enabled, interval và max_operations trước/sau; chính sách thực tế phụ thuộc yêu cầu vận hành. Endpoint này cấu hình khóa storage, không phải chu kỳ của Transit key. [Auto-rotation API]

3.4. Rotate Transit key

Transit rotate tạo version mới cho một named key. Ứng dụng vẫn gọi cùng path transit/encrypt/orders; request không chỉ định version sẽ dùng version mới nhất. Các bản ghi cũ cần được xử lý bằng rewrap nếu muốn chuyển sang version mới.

CLI — Đối chiếu version của key orders

vault read transit/keys/orders
vault write -f transit/keys/orders/rotate
vault read transit/keys/orders

Sau rotate, latest_version tăng. Request encrypt mặc định dùng version mới; ciphertext cũ vẫn mang version cũ và còn giải mã được nếu key/version còn tồn tại và chính sách cho phép. Rotate không tự sửa bản ghi đang lưu ở database.

CLI — Auto-rotation riêng cho Transit key, ví dụ lab

vault write transit/keys/orders/config auto_rotate_period=2160h

Đây là cấu hình trên named Transit key, khác sys/rotate/config. Kiểm tra khả năng hỗ trợ và cấu hình bằng đúng phiên bản Vault đang sử dụng. [Transit API]

4. Thảo luận và kiểm tra sau thay đổi

  • Rekey: xác nhận kết thúc verification, phân phối đúng người, cập nhật threshold và nơi giữ share; diễn tập unseal/recovery trong môi trường thử nghiệm.
  • Storage rotate: đối chiếu key term và thử đọc/ghi dữ liệu lab.
  • Transit rotate: thử decrypt ciphertext cũ, encrypt dữ liệu mới, rồi kiểm tra version của ciphertext mới.
  • Ứng dụng: kiểm tra token/policy không bị thay bằng root token để né lỗi quyền.

Không tăng min_decryption_version chỉ vì rotate đã thành công. Phải hoàn tất kế hoạch rewrap và kiểm tra cả bản sao lưu chứa ciphertext cũ; bài 5 xử lý phần này. Các lệnh trong bài là cấu hình/lab tham khảo, chưa được chạy thử trên hạ tầng thực tế.

5. Kết luận

Rekey thay bộ share kiểm soát khóa; storage rotate đổi khóa cho các lần ghi storage tiếp theo; Transit rotate tạo version mới cho named key. Kết quả kiểm tra phải gắn với đúng lớp khóa: trạng thái verification, key term hoặc Transit key version. Dữ liệu ứng dụng cũ cần kế hoạch rewrap riêng trước khi siết giới hạn giải mã.

Tài liệu tham khảo

Các bài trong series Vault

Bài viết thể hiện quan điểm cá nhân, không đại diện cho cơ quan hoặc tổ chức nào.

If you found this helpful, you can buy me a coffee and keep me going. Thank you!
https://buymeacoffee.com/vohongnhuy1996
Võ Hồng Như Ý – 16/11/2026

4 responses to “Vault (4/5): Rekey, rotate khóa storage và rotate Transit key”

  1. […] Vault (4/5): Rekey, rotate khóa storage và rotate Transit key […]

    Like

  2. […] Vault (4/5): Rekey, rotate khóa storage và rotate Transit key […]

    Like

  3. […] Vault (4/5): Rekey, rotate khóa storage và rotate Transit key […]

    Like

  4. […] Vault (4/5): Rekey, rotate khóa storage và rotate Transit key […]

    Like

Leave a Reply