Ứng dụng gửi dữ liệu tới Vault Transit để mã hóa, lưu ciphertext trong database và gọi Vault khi cần giải mã.

Vault (3/5): Mã hóa dữ liệu ứng dụng bằng Transit

Series Vault — Bài 3/5.

Tóm tắt

Lab này dùng Vault Transit để mã hóa dữ liệu lab-order-001, lưu ciphertext ở phía ứng dụng và giải mã lại. Quản trị viên tạo key/policy; ứng dụng chỉ có quyền encrypt/decrypt trên key orders.

Từ khóa: Vault Transit; encrypt; decrypt; policy; Base64; ciphertext.

1. Giới thiệu

Ứng dụng có thể cần mã hóa một số trường dữ liệu nhưng vẫn lưu chúng trong database hiện có. Vault Transit cung cấp API mật mã và quản lý key; ứng dụng giữ trách nhiệm lưu ciphertext, xác thực và kiểm soát dữ liệu nhận về.

Bài viết trình bày phương pháp tích hợp qua một lab encrypt/decrypt, tách quyền quản trị key khỏi quyền sử dụng của ứng dụng. Các bước đối chiếu plaintext và kiểm tra quyền được dùng làm tiêu chí kiểm chứng cho lab.

2. Cơ sở kỹ thuật: Vault Transit

Ứng dụng gửi dữ liệu tới Vault Transit để mã hóa, lưu ciphertext trong database và gọi Vault khi cần giải mã.
Hình 1. Vault thực hiện mật mã; ứng dụng lưu ciphertext trong database. Nguồn: HashiCorp.

Transit giữ key và metadata của key; không lưu hộ dữ liệu nghiệp vụ gửi vào API. Ứng dụng gửi plaintext để encrypt, nhận ciphertext và tự lưu kết quả. Khi decrypt, ứng dụng gửi ciphertext tới Vault và nhận lại plaintext. TLS bảo vệ đường truyền; Base64 chỉ là cách biểu diễn dữ liệu trong payload. [Transit API]

3. Phương pháp triển khai

3.1. Điều kiện và môi trường lab

  • Vault đã init, unsealed và truy cập được qua HTTPS; Transit cần được bật bằng tài khoản có quyền quản trị mount.
  • Máy lab có Vault CLI, Bash, jq, Python 3 và lệnh base64.
  • Hai phiên làm việc riêng: phiên quản trị tạo key/policy/token; phiên ứng dụng chạy encrypt/decrypt.
  • Lab dùng mount transit/ và key orders. Nếu đã có key trùng tên, chọn tên lab khác và sửa đồng bộ các path.

Các lệnh là hướng dẫn lab, chưa có kết quả chạy thử trên hạ tầng thực tế. Output được mô tả bằng điều kiện kiểm tra; không sao chép token, key share hoặc ciphertext có sẵn.

CLI — Thiết lập endpoint ở cả hai phiên

export VAULT_ADDR='https://vault.example.com:8200'
export VAULT_CACERT='/etc/vault/tls/vault-ca.pem'

Thay endpoint và CA bằng giá trị lab. Xác thực phiên quản trị bằng phương thức đã triển khai; không tắt kiểm tra chứng thư để xử lý lỗi TLS.

3.2. Khởi tạo Transit và key

Bật Transit tạo một nhóm API mật mã tại mount path. Tạo key orders sau đó cung cấp một định danh để ứng dụng gọi encrypt/decrypt. Ứng dụng truyền tên key trong API path; không cần nhận hoặc lưu khóa mã hóa gốc của Transit.

CLI — Phiên quản trị

vault secrets list
# Chỉ chạy enable nếu chưa có mount transit/.
vault secrets enable -path=transit transit
vault write transit/keys/orders type=aes256-gcm96

Chỉ tạo key mới trong lab. Với mount hoặc key có sẵn, đọc cấu hình trước khi thay đổi. Key không được export theo cấu hình mặc định của lab. [Transit]

3.3. Cấp policy và token ứng dụng

Policy giới hạn phạm vi sử dụng key; token mang quyền của phiên ứng dụng. Trong lab, token được cấp quyền encrypt/decrypt trên orders, không được rotate hay quản trị key. Tách hai vai trò này giúp ứng dụng dùng mật mã mà không phải giữ credential quản trị.

Quản trị viên bật secrets engine, tạo key và policy; ứng dụng xác thực với Vault để nhận token gắn policy.
Hình 2. Tách thao tác quản trị engine/key/policy khỏi quyền sử dụng của ứng dụng. Nguồn: HashiCorp.

CLI — Tạo tệp policy

cat > app-orders.hcl <<'HCL'
path "transit/encrypt/orders" {
  capabilities = ["update"]
}
path "transit/decrypt/orders" {
  capabilities = ["update"]
}
HCL

vault policy write app-orders app-orders.hcl

CLI — Cấp token lab vào tệp, không in token ra màn hình

umask 077
vault token create \
  -policy=app-orders \
  -ttl=20m \
  -explicit-max-ttl=1h \
  -format=json > app-token.json

Token lab có policy ứng dụng và policy default nếu hệ thống giữ cấu hình mặc định. TTL thực tế có thể bị giới hạn bởi cấu hình token hoặc mount. Cách cấp token trực tiếp này phục vụ lab; workload production cần dùng auth method phù hợp với nền tảng. [Token create]

CLI — Phiên ứng dụng trên cùng máy lab

export VAULT_TOKEN="$(jq -er '.auth.client_token' app-token.json)"
vault token capabilities transit/encrypt/orders
vault token capabilities transit/decrypt/orders
vault token capabilities transit/keys/orders/rotate

Hai path encrypt/decrypt cần có update; path rotate phải là deny. Không tiếp tục bằng token quản trị nếu kiểm tra này thất bại. Tệp chứa token phải được giữ kín và loại bỏ sau phiên lab theo quy trình quản lý credential. [Capabilities]

3.4. Encrypt dữ liệu

CLI — Phiên ứng dụng, Bash

set -euo pipefail
B64="$(printf '%s' 'lab-order-001' | base64 | tr -d '\n')"
CIPHERTEXT="$(vault write -field=ciphertext \
  transit/encrypt/orders plaintext="$B64")"

case "$CIPHERTEXT" in
  vault:v*:*) printf '%s\n' 'Ciphertext format: OK' ;;
  *) printf '%s\n' 'Unexpected ciphertext' >&2; exit 1 ;;
esac

Giá trị CIPHERTEXT có dạng vault:vN:..., trong đó N là phiên bản key dùng để encrypt. Không đối chiếu toàn bộ chuỗi ciphertext giữa hai lần chạy: với kiểu mã hóa mặc định của lab, cùng plaintext có thể cho ciphertext khác nhau. [Encrypt API]

3.5. Decrypt và đối chiếu plaintext

Decrypt khôi phục dữ liệu gốc từ ciphertext. Vault đọc version nằm trong prefix để chọn phiên bản key tương ứng và kiểm tra quyền của client. Kết quả API được biểu diễn bằng Base64; bước decode phía client mới trả lại các byte dữ liệu ban đầu.

CLI — Phiên ứng dụng, giữ nguyên shell ở bước trước

DECODED="$(vault write -field=plaintext \
  transit/decrypt/orders ciphertext="$CIPHERTEXT" | \
  python3 -c 'import base64,sys; data=base64.b64decode(sys.stdin.read()); sys.stdout.buffer.write(data)')"

test "$DECODED" = 'lab-order-001'
printf '%s\n' 'Round-trip: OK'

Chỉ có dòng xác nhận khi plaintext sau decrypt khớp dữ liệu gốc. Script dùng Python để decode Base64, tránh khác biệt cờ CLI giữa macOS và Linux. Biến đang giữ plaintext chỉ chứa dữ liệu giả của lab.

3.6. Kiểm tra phân quyền và kết thúc lab

CLI — Xác nhận ứng dụng không được rotate key

vault token capabilities transit/keys/orders/rotate
# Kết quả yêu cầu: deny

Không thử lệnh rotate bằng token có quyền rộng chỉ để kiểm tra lỗi. Kiểm tra quyền thực tế bằng token ứng dụng; nếu cần kiểm thử API trả 403, thực hiện trên key lab với token đã xác nhận không có quyền.

CLI — Phiên ứng dụng sau khi hoàn tất

vault token revoke -self
unset VAULT_TOKEN B64 CIPHERTEXT DECODED

Lệnh revoke-self ở đây dựa vào policy default tiêu chuẩn. Nếu tổ chức đã sửa policy này, quản trị viên thực hiện thu hồi token lab theo quyền được cấp.

4. Thảo luận: Phạm vi xử lý và dữ liệu lớn

Không gửi file lớn tùy ý vào encrypt API. Với envelope encryption, ứng dụng dùng data key để mã hóa cục bộ và giữ bản data key đã được bảo vệ bởi Transit. Khi nhận plaintext data key, ứng dụng phải bảo vệ nó trong bộ nhớ; không lưu plaintext data key cạnh ciphertext. Đây là luồng riêng, không dùng thay trực tiếp các lệnh lab ở trên. [Envelope encryption]

5. Kết luận

Luồng tích hợp Transit gồm cấp quyền trên named key, gọi encrypt, lưu ciphertext và gọi decrypt khi cần. Policy ứng dụng không cần quyền quản trị key. Trước khi áp dụng, cần kiểm tra round-trip dữ liệu, trường hợp bị từ chối quyền và vòng đời token; luồng envelope encryption cần được thiết kế riêng khi mã hóa cục bộ dữ liệu lớn.

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 (3/5): Mã hóa dữ liệu ứng dụng bằng Transit”

  1. […] Vault (3/5): Mã hóa dữ liệu ứng dụng bằng Transit […]

    Like

  2. […] Vault (3/5): Mã hóa dữ liệu ứng dụng bằng Transit […]

    Like

  3. […] Vault (3/5): Mã hóa dữ liệu ứng dụng bằng Transit […]

    Like

Leave a Reply