メインコンテンツまでスキップ

シークレットローテーションランブック

シークレット一覧​

シークレットファイル種類ローテーション間隔
pg_urisecrets/pg_uriPostgreSQL パスワード四半期ごと
session_keysecrets/session_keyHMAC キー(32 バイトの 16 進数)四半期ごと
cache_hmacsecrets/cache_hmacキャッシュ HMAC キー(32 バイトの 16 進数)四半期ごと
kms_local_keysecrets/kms_local_keyEd25519 秘密鍵(32 バイトの生データ)半年ごと
vendor_public_keypkg/license/zz_keys.goEd25519 公開鍵(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 パスワード​

  1. データベースにログインします: docker compose exec postgres psql -U yabanin
  2. 新しいパスワードを作成します: ALTER USER yabanin WITH PASSWORD 'newpassword';
  3. 新しいパスワードで secrets/pg_uri を更新します
  4. すべてのサービスを再起動します: 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)に埋め込まれています。ローテーションする手順は次のとおりです。

  1. ベンダーから新しい Ed25519 公開鍵を入手します
  2. zz_keys.go の const VendorPublicKey = "<64-char hex>" を更新します
  3. 必要に応じて go generate ./pkg/license/... を実行して再生成します
  4. コミットして再デプロイします

緊急ローテーション​

シークレットが侵害された疑いがある場合:

  1. 上記の手順で、影響を受けたシークレットを直ちにローテーションします
  2. 影響を受けたサービスをすべて再起動します: docker compose restart
  3. session_key または pg_uri の場合は、サービスの中断をユーザーに通知します
  4. 不正アクセスがないかログを監査します: docker compose logs gateway | grep -i "unauthorized\|forbidden"