Series Vault — Bài 5/5.
Tóm tắt
Rotate Transit key chỉ đổi version dùng cho dữ liệu mới. Bản ghi đã lưu trong MySQL vẫn giữ ciphertext cũ. Lab này gọi rewrap rồi cập nhật bản ghi bằng điều kiện so khớp ciphertext cũ, tránh ghi đè dữ liệu vừa bị ứng dụng thay đổi.
Từ khóa: Transit; rotate; rewrap; MySQL; ciphertext; optimistic concurrency.
1. Giới thiệu
Sau khi rotate Transit key, database có thể đồng thời chứa ciphertext thuộc nhiều version. Chuyển dữ liệu cũ sang version mới đòi hỏi gọi rewrap và cập nhật bản ghi, đồng thời xử lý các thay đổi do ứng dụng ghi trong lúc migration.
Bài viết trình bày phương pháp rewrap một bản ghi MySQL với UPDATE có điều kiện, sau đó phân tích cách mở rộng theo batch và điều kiện nâng giới hạn giải mã. Phạm vi triển khai là lab sử dụng dữ liệu giả.
2. Cơ sở kỹ thuật: Rotate, rewrap và lưu ciphertext

Ứng dụng lưu ciphertext dạng vault:vN:.... Rotate tạo version mới; rewrap nhận ciphertext cũ và trả ciphertext dùng version đích, không trả plaintext cho worker. Worker phải ghi ciphertext mới trở lại MySQL. [Transit API]
Prefix chỉ chứa version, không chứa tên Transit key. Lab dùng một key orders cho toàn bộ cột; hệ thống dùng nhiều key cần lưu thêm định danh key/mount để gọi đúng endpoint.
3. Phương pháp triển khai
3.1. Điều kiện và môi trường lab
- Đã có key
ordersvà policyapp-orderstừ bài 3; cấp lại token ngắn hạn nếu token lab đã hết hiệu lực. - MySQL lab dùng cú pháp MySQL 8.4, database
vault_labvà tài khoản lab có quyền tạo bảng, SELECT, INSERT, UPDATE trên database này. - Máy chạy có Bash, Vault CLI, jq, base64, MySQL client và mysql_config_editor. Endpoint và CA của Vault được cấu hình như bài 3.
- Giữ riêng phiên quản trị Vault, phiên ứng dụng và phiên migration. Không dùng root token cho ứng dụng hoặc worker.
- Không có ciphertext khác key trong bảng lab. Không xóa hay trim key version trong quá trình thực hiện.
Các lệnh chưa được chạy thử end-to-end trên hạ tầng thực tế. Lab dùng một bản ghi và dữ liệu giả; phần cuối nêu cách mở rộng worker, không cung cấp kết quả benchmark.
CLI — Cấu hình kết nối MySQL qua prompt mật khẩu
mysql_config_editor set \
--login-path=vault-lab \
--host=127.0.0.1 \
--user=vault_lab \
--password
Tài khoản và database do quản trị viên lab tạo trước. Login path giúp tránh đặt mật khẩu trong dòng lệnh; tệp login-path vẫn là credential cần bảo vệ, không phải kho bí mật thay cho Vault. [MySQL client]
CLI — Tạo bảng trong database lab mới
mysql --login-path=vault-lab vault_lab <<'SQL'
CREATE TABLE user_data (
id BIGINT PRIMARY KEY,
city_ciphertext VARCHAR(1024)
CHARACTER SET ascii COLLATE ascii_bin NOT NULL
) ENGINE=InnoDB;
SQL
Cột ciphertext dùng collation phân biệt hoa/thường vì phần Base64 có phân biệt hoa/thường. Không áp dụng lệnh tạo/sửa bảng lab này lên production.
3.2. Ghi dữ liệu bằng token ứng dụng
CLI — Phiên ứng dụng, đã có token app-orders
set -euo pipefail
B64="$(printf '%s' 'lab-city-001' | base64 | tr -d '\n')"
CIPHERTEXT="$(vault write -field=ciphertext \
transit/encrypt/orders plaintext="$B64")"
if ! [[ "$CIPHERTEXT" =~ ^vault:v[0-9]+:[A-Za-z0-9+/=]+$ ]]; then
printf '%s\n' 'Invalid lab ciphertext' >&2
exit 1
fi
mysql --login-path=vault-lab vault_lab -e \
"INSERT INTO user_data (id, city_ciphertext)
VALUES (1, '$CIPHERTEXT');"
Lab chỉ nội suy ciphertext sau khi giới hạn ký tự theo định dạng AES-GCM đang dùng. Trong mã ứng dụng, dùng parameterized queries của driver, không ghép chuỗi SQL cho dữ liệu tùy ý.
SQL — Thống kê version, chạy trong phiên MySQL vault_lab
SELECT SUBSTRING_INDEX(city_ciphertext, ':', 2) AS key_version,
COUNT(*) AS total
FROM user_data
GROUP BY key_version;
Không mặc định bản ghi đang ở v1: nếu đã chạy bài 4, key có thể có version cao hơn. Lưu version hiện tại để đối chiếu sau rotate.
3.3. Phân quyền cho worker rewrap
Worker rewrap chuyển phiên bản bảo vệ dữ liệu mà không nhận plaintext từ Vault. Worker đọc ciphertext trong database, gửi đến rewrap API và lưu ciphertext mới. Do đó, có thể cấp riêng quyền rewrap mà không cấp quyền decrypt.
Policy — rewrap-orders.hcl
path "transit/keys/orders" {
capabilities = ["read"]
}
path "transit/rewrap/orders" {
capabilities = ["update"]
}
Worker được đọc metadata và gọi rewrap; không cấp decrypt, rotate hay sửa key configuration. Quản trị viên lưu nội dung trên thành tệp, nạp policy rồi cấp token ngắn hạn.
CLI — Phiên quản trị
vault policy write rewrap-orders rewrap-orders.hcl
umask 077
vault token create \
-policy=rewrap-orders \
-ttl=20m \
-explicit-max-ttl=1h \
-format=json > rewrap-token.json
vault write -f transit/keys/orders/rotate
vault read -field=latest_version transit/keys/orders
Giữ các version cũ trong lúc migration. Không tăng giới hạn giải mã ở bước này. Token trực tiếp chỉ dùng trong lab; worker production cần auth method và cơ chế renew phù hợp.
3.4. Rewrap và cập nhật bản ghi có điều kiện
Điều kiện so khớp ciphertext cũ phát hiện bản ghi đã thay đổi trong lúc worker xử lý. Nếu ứng dụng vừa ghi dữ liệu mới, câu UPDATE sẽ không khớp và worker phải đọc lại. Chỉ dùng điều kiện id=1 sẽ có nguy cơ ghi đè dữ liệu mới bằng kết quả rewrap của dữ liệu cũ.
CLI — Phiên migration, Bash
set -euo pipefail
export VAULT_TOKEN="$(jq -er '.auth.client_token' rewrap-token.json)"
vault token capabilities transit/rewrap/orders
vault token capabilities transit/decrypt/orders
# Yêu cầu: update cho rewrap, deny cho decrypt.
TARGET_VERSION="$(vault read -field=latest_version transit/keys/orders)"
OLD_CIPHERTEXT="$(mysql --login-path=vault-lab \
--batch --skip-column-names vault_lab -e \
'SELECT city_ciphertext FROM user_data WHERE id=1;')"
NEW_CIPHERTEXT="$(vault write -field=ciphertext \
transit/rewrap/orders \
ciphertext="$OLD_CIPHERTEXT" \
key_version="$TARGET_VERSION")"
if ! [[ "$OLD_CIPHERTEXT" =~ ^vault:v[0-9]+:[A-Za-z0-9+/=]+$ ]] ||
! [[ "$NEW_CIPHERTEXT" =~ ^vault:v[0-9]+:[A-Za-z0-9+/=]+$ ]] ||
! [[ "$NEW_CIPHERTEXT" == "vault:v$TARGET_VERSION:"* ]]; then
printf '%s\n' 'Ciphertext validation failed' >&2
exit 1
fi
mysql --login-path=vault-lab vault_lab -e \
"UPDATE user_data
SET city_ciphertext='$NEW_CIPHERTEXT'
WHERE id=1 AND city_ciphertext='$OLD_CIPHERTEXT';
SELECT ROW_COUNT() AS updated_rows;"
Nếu updated_rows = 1, bản ghi đã được cập nhật. Nếu bằng 0, đọc lại bản ghi: nó có thể đã bị thay đổi hoặc xóa sau lần SELECT. Không bỏ điều kiện so khớp để ép UPDATE. Lab dùng InnoDB với autocommit cho từng câu UPDATE. [MySQL UPDATE]
Không giữ row lock trong lúc chờ network call tới Vault. Đọc ciphertext, gọi rewrap, rồi UPDATE với điều kiện ciphertext vẫn bằng giá trị đã đọc. Cách này tránh ghi đè giá trị mới do ứng dụng cập nhật.
3.5. Tiêu chí kiểm tra sau rewrap
- Chạy lại truy vấn thống kê version: bản ghi lab phải thuộc version đích.
- Đọc ciphertext từ MySQL và dùng token ứng dụng để decrypt theo bài 3; plaintext phải khớp
lab-city-001. Worker không cần quyền decrypt. - Chạy lại job trên dữ liệu đã đạt version đích phải bỏ qua bản ghi đó. Đoạn CLI ở trên minh họa một lần cập nhật; worker tự động phải bổ sung bước lọc version trước rewrap.
- Thử worker dừng sau khi rewrap nhưng trước UPDATE: database phải vẫn giữ ciphertext cũ và job có thể xử lý lại.
4. Thảo luận
4.1. Mở rộng worker theo batch
- Chốt version đích cho một đợt migration. Nếu key tiếp tục rotate, không tự thay target giữa các batch.
- Đọc theo khóa chính với checkpoint; chỉ chọn bản ghi có version thấp hơn target. Bỏ qua version bằng hoặc cao hơn target.
- Giới hạn số request song song và batch size; theo dõi latency, lỗi Vault và số UPDATE thành công/xung đột.
- Commit theo bản ghi hoặc batch ngắn. Lưu bản ghi lỗi/xung đột để quét lại; checkpoint không được làm mất chúng.
- Retry có giới hạn và backoff. Kiểm tra version trước rewrap để job có thể chạy lại mà không xử lý lặp dữ liệu đã đạt target.
- Ứng dụng tiếp tục ghi bằng version phù hợp; quét lại toàn bộ dữ liệu cũ trước khi kết thúc migration.
4.2. Giới hạn giải mã và khả năng khôi phục
min_decryption_version là giới hạn phiên bản được phép giải mã, không phải lịch rotate. Ví dụ, đặt bằng 2 sẽ từ chối giải mã ciphertext v1 theo chính sách đó; thao tác này không tự chuyển dữ liệu v1 sang v2. Vì vậy, phải kiểm tra dữ liệu còn tồn và khả năng restore trước khi nâng giới hạn.
Trước khi nâng giới hạn, kiểm tra database, queue, cache, file xuất và bản sao lưu còn chứa ciphertext version cũ. Backup cũ có thể không giải mã được dưới chính sách mới dù database hiện tại đã rewrap hết.
CLI — Phiên quản trị, sau khi xác nhận version đích
# Nhập version đã hoàn tất và kiểm tra migration.
# Không thay bằng latest_version mới hơn chưa được kiểm chứng.
read -r -p 'Verified target version: ' TARGET_VERSION
if ! [[ "$TARGET_VERSION" =~ ^[1-9][0-9]*$ ]]; then
printf '%s\n' 'Invalid target version' >&2
exit 1
fi
vault write transit/keys/orders/config \
min_decryption_version="$TARGET_VERSION"
vault read transit/keys/orders
Lệnh trên thay chính sách giải mã, không chứng minh dữ liệu cũ đã được di chuyển và không đồng nghĩa xóa key material. Không chạy trim hoặc xóa key để dọn lab. Kế hoạch restore phải tính đến cả chính sách version lẫn các version key còn được giữ. [Key configuration]
5. Kết luận
Rewrap chỉ hoàn thành một bản ghi khi ciphertext mới đã được lưu vào database. Điều kiện so khớp ciphertext cũ giúp tránh ghi đè cập nhật đồng thời; worker cần quản lý version đích, checkpoint và bản ghi lỗi khi mở rộng theo batch. Chỉ nâng giới hạn giải mã sau khi kiểm tra dữ liệu còn tồn và khả năng restore các bản sao lưu.
Tài liệu tham khảo
- HashiCorp — Transit API: rotate, rewrap và key configuration
- HashiCorp — Transit secrets engine
- HashiCorp — Transit Rewrap demo
- MySQL 8.4 — UPDATE
- MySQL 8.4 — mysql_config_editor
- MySQL 8.4 — Transaction và autocommit
Các bài trong series Vault
- Vault (1/5): Auth, Policy, Token và luồng xử lý request
- Vault (2/5): Dự phòng cho Vault với HAProxy
- Vault (3/5): Mã hóa dữ liệu ứng dụng bằng Transit
- Vault (4/5): Rekey, rotate khóa storage và rotate Transit key
- Vault (5/5): Rotate Transit key và rewrap dữ liệu MySQL
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

Leave a Reply