シークレットローテーションランブック
シークレット一覧
| シークレット | ファイル | 種類 | ローテーション間隔 |
|---|---|---|---|
pg_uri | secrets/pg_uri | PostgreSQL パスワード | 四半期ごと |
session_key | secrets/session_key | HMAC キー(32 バイトの 16 進数) | 四半期ごと |
cache_hmac | secrets/cache_hmac | キャッシュ HMAC キー(32 バイトの 16 進数) | 四半期ごと |
kms_local_key | secrets/kms_local_key | Ed25519 秘密鍵(32 バイトの生データ) | 半年ごと |
vendor_public_key | pkg/license/zz_keys.go | Ed25519 公開鍵(64 文字の 16 進数) | ベンダーのローテーションごと |
ローテーション手順
セッションキー / キャッシュ HMAC
# 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
注: session_key をローテーションすると、すべてのアクティブセッションが無効になります。ユーザーに通知してください。
cache_hmac をローテーションすると、キャッシュされたデータが削除されます(自動的に再構築されます)。
PostgreSQL パスワード
- データベースにログインします:
docker compose exec postgres psql -U yabanin - 新しいパスワードを作成します:
ALTER USER yabanin WITH PASSWORD 'newpassword'; - 新しいパスワードで
secrets/pg_uriを更新します - すべてのサービスを再起動します:
docker compose restart
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
警告: kms_local_key をローテーションすると、以前に署名されたライセンスキーはすべて無効になります。このローテーションの後、ベンダーが署名したライセンスキーを再生成する必要があります。
ベンダー公開鍵(zz_keys.go)
ベンダー公開鍵は Go ソース(pkg/license/zz_keys.go)に埋め込まれています。ローテーションする手順は次のとおりです。
- ベンダーから新しい Ed25519 公開鍵を入手します
zz_keys.goのconst VendorPublicKey = "<64-char hex>"を更新します- 必要に応じて
go generate ./pkg/license/...を実行して再生成します - コミットして再デプロイします