Skip to main content

Runbook putaran rahsia

Inventori rahsia​

RahsiaFileJenisKadens putaran
pg_urisecrets/pg_uriKata laluan PostgreSQLSuku tahunan
session_keysecrets/session_keyKunci HMAC (32 bait heks)Suku tahunan
cache_hmacsecrets/cache_hmacKunci HMAC cache (32 bait heks)Suku tahunan
kms_local_keysecrets/kms_local_keyKunci peribadi Ed25519 (32 bait mentah)Separuh tahunan
vendor_public_keypkg/license/zz_keys.goKunci 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​

  1. Log masuk ke pangkalan data: docker compose exec postgres psql -U yabanin
  2. Cipta kata laluan baharu: ALTER USER yabanin WITH PASSWORD 'newpassword';
  3. Kemas kini secrets/pg_uri dengan kata laluan baharu
  4. 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:

  1. Dapatkan kunci awam Ed25519 yang baharu daripada vendor
  2. Kemas kini const VendorPublicKey = "<64-char hex>" dalam zz_keys.go
  3. Jalankan go generate ./pkg/license/... untuk menjana semula jika perlu
  4. Komit dan laksanakan semula

Putaran kecemasan​

Jika sesuatu rahsia disyaki telah diceroboh:

  1. Serta-merta putarkan rahsia yang terjejas menggunakan prosedur di atas
  2. Mulakan semula semua perkhidmatan yang terjejas: docker compose restart
  3. Bagi session_key atau pg_uri — beritahu pengguna tentang gangguan perkhidmatan
  4. Audit log bagi akses tanpa kebenaran: docker compose logs gateway | grep -i "unauthorized\|forbidden"