Runbook putaran rahsia
Inventori rahsia
| Rahsia | File | Jenis | Kadens putaran |
|---|---|---|---|
pg_uri | secrets/pg_uri | Kata laluan PostgreSQL | Suku tahunan |
session_key | secrets/session_key | Kunci HMAC (32 bait heks) | Suku tahunan |
cache_hmac | secrets/cache_hmac | Kunci HMAC cache (32 bait heks) | Suku tahunan |
kms_local_key | secrets/kms_local_key | Kunci peribadi Ed25519 (32 bait mentah) | Separuh tahunan |
vendor_public_key | pkg/license/zz_keys.go | Kunci awam Ed25519 (64 aksara heks) | Setiap putaran vendor |
Prosedur putaran
Kunci sesi / HMAC cache
# Generate new 32-byte random keys
openssl rand -hex 32 > deploy/secrets/session_key
openssl rand -hex 32 > deploy/secrets/cache_hmac
# Restart services to pick up new secrets
docker compose restart gateway admin loggerd
Nota: Memutarkan session_key akan membatalkan semua sesi yang aktif. Beritahu pengguna.
Memutarkan cache_hmac akan mengosongkan data cache (dibina semula secara automatik).
Kata laluan PostgreSQL
- Log masuk ke pangkalan data:
docker compose exec postgres psql -U yabanin - Cipta kata laluan baharu:
ALTER USER yabanin WITH PASSWORD 'newpassword'; - Kemas kini
secrets/pg_uridengan kata laluan baharu - Mulakan semula semua perkhidmatan:
docker compose restart
Kunci tempatan KMS
# Generate new 32-byte raw key (Ed25519 private key)
head -c 32 /dev/urandom > deploy/secrets/kms_local_key
# Verify it's exactly 32 bytes
wc -c deploy/secrets/kms_local_key
# Expected: 32
# Restart services that use KMS
docker compose restart gateway loggerd kms-signer
Amaran: Memutarkan kms_local_key membatalkan semua kunci lesen yang ditandatangani sebelum ini. Kunci lesen bertandatangan vendor mesti dijana semula selepas putaran ini.
Kunci awam vendor (zz_keys.go)
Kunci awam vendor tertanam dalam sumber Go (pkg/license/zz_keys.go). Untuk memutarkannya:
- Dapatkan kunci awam Ed25519 yang baharu daripada vendor
- Kemas kini
const VendorPublicKey = "<64-char hex>"dalamzz_keys.go - Jalankan
go generate ./pkg/license/...untuk menjana semula jika perlu - Komit dan laksanakan semula
Putaran kecemasan
Jika sesuatu rahsia disyaki telah diceroboh:
- Serta-merta putarkan rahsia yang terjejas menggunakan prosedur di atas
- Mulakan semula semua perkhidmatan yang terjejas:
docker compose restart - Bagi session_key atau pg_uri — beritahu pengguna tentang gangguan perkhidmatan
- Audit log bagi akses tanpa kebenaran:
docker compose logs gateway | grep -i "unauthorized\|forbidden"