Skip to content

fastdoctor-manager-db5 の SSL 強制(rds.force_ssl = 1) ​

FDsys 本番のリードレプリカ fastdoctor-manager-db5 で、SSL を使わない接続を受け付けないようにする手順。

  • Issue:fastdoctor-jp/mental-online-karte#24932
  • 関連:fastdoctor-jp/fastdoctor-manager#8982(L2 の接続先が db5)・#18087(fdsys staging で force_ssl の不一致により非 SSL の接続が全部断たれた件)
  • PG16 移行の記録:db-upgrade/rds-pg16/services/fastdoctor-manager.md §C-a-8(db5 を 0 にした理由)

0. 前提 ​

0-1. 対象 ​

項目値
AWS アカウントfdsys 環境 913831226605(プロファイル fdsys-admin)
リージョンus-east-1
インスタンスfastdoctor-manager-db5(db1 のリードレプリカ・PostgreSQL 16)
パラメータグループpostgres16-fastdoctor-manager-replica(db5 専用。db1・db3・db6 はそれぞれ別のグループ)
Terraform管理外(PG16 のパラメータグループと db3・db5・db6 は Terraform にない)。この手順は AWS CLI で変える
今の値rds.force_ssl = 0(Source user)・ssl = 1

db1(プライマリ)・db3・db6 は rds.force_ssl = 1。0 は db5 だけ。 PG16 の Blue/Green(2026-10-30)で、blue(PG12、既定値 0)と挙動を揃えるために 0 にしたもので、特定のクライアントのためではない。

0-2. 変えると何が起きるか ​

  • rds.force_ssl は dynamic(再起動なしで反映)。#18087 の staging で、再起動なしで効くことを確認済み。
  • 反映した時点から、SSL を使わない新しい接続は断られる(no pg_hba.conf entry for host ..., no encryption)。今つながっている接続は切れない。
  • 戻すときは 0 に戻すだけ(再起動なし)。

0-3. db5 につないでいるもの(2026-11-18 時点) ​

接続元接続SSL強制の前にやること
Troccoあり(2026-11-17 に確認・fdadmin)2026-11-17 時点はなし → 有効化済み済み(2026-11-18 に転送元の接続情報で SSL を有効にし、Trocco のテスト接続が成功)
Redashありあり(データソースの SSL はもともと有効だった)不要(2026-11-18 に確認)
Airflow(MWAA online-karte-etl の Connection fd-system-replica)あり(load_lake 06:15・03:00、realtime-examination-status 毎時 00 分・30 分)あり済み(2026-11-18 に Extra を {"sslmode": "require"}。次の実行の成功を確認)
  • 2026-11-18 14:09 の §1-3 の洗い出しで、trocco.io が TLSv1.3、fd-platform 東京の NAT からの接続(Redash か Airflow。同じ NAT なので IP では区別できない)が TLSv1.2 で、SSL を使わない接続は rdsadmin(local)以外 0 件だった。 Trocco のテスト接続は rds.force_ssl = 0 の今なら SSL なしでも通るので、SSL の証拠はこの洗い出しの方。
  • Trocco は CA 証明書の欄に rds-ca-rsa2048-g1 の証明書だけを入れている(Trocco のフォームの文字数の上限のため。#24932)。db5 の CA を変えるときは §6 を見る。
  • Retool(SaaS・debt-manager の Retool)は db3 につないでいて、db5 にはつないでいない(2026-11-18 に確認)。db5 の SG にある Retool の許可は、db5 を作ったときに db4 から写したもので、外すのは別の課題(§5)。
  • L2(物流システム)はこれから db5 につなぐ。コードで SSL と証明書の検証を必ず使う(fastdoctor-manager#8982)。

接続元の IP は SG(fastdoctor-manager-db5-sg)の説明で確認する。この手順書には書かない。


1. 事前の確認(読み取りのみ) ​

1-1. 環境の変数 ​

ターミナルに貼って使う前提(exit は書かない。アカウント違いのときにターミナルごと閉じるため)。

bash
export AWS_PAGER=""
FDSYS=(aws --profile fdsys-admin --region us-east-1)
DB=fastdoctor-manager-db5
PG=postgres16-fastdoctor-manager-replica
"${FDSYS[@]}" sts get-caller-identity --query Account --output text
# → 913831226605 でなければ、以降のコマンドを流さない(プロファイルを確かめる)

1-2. パラメータグループが db5 専用で、今の値が 0 であること ​

bash
# このグループを使っているインスタンスが db5 だけであること
"${FDSYS[@]}" rds describe-db-instances \
  --query "DBInstances[?DBParameterGroups[?DBParameterGroupName=='$PG']].DBInstanceIdentifier" --output text
# rds.force_ssl と ssl の今の値
"${FDSYS[@]}" rds describe-db-parameters --db-parameter-group-name "$PG" \
  --query "Parameters[?ParameterName=='rds.force_ssl' || ParameterName=='ssl'].[ParameterName,ParameterValue,ApplyType,Source]" --output text

期待値:インスタンスは fastdoctor-manager-db5 だけ。rds.force_ssl の値が 0、ssl の値が 1。

1-3. SSL を使っていない接続が 0 件であること ​

db5 に読み取り専用でつなぎ、pg_stat_activity と pg_stat_ssl を突き合わせる。 つなぎ方(踏み台・secret)は db-upgrade/rds-pg16/services/fastdoctor-manager.md と同じ(describe・secret=fdsys-admin、トンネル=production-admin の東京の踏み台)。 fdm_system の secret のユーザーは pg_read_all_stats を持っているので、他のアカウントの接続も全部見える。

sql
SET default_transaction_read_only = on;
SELECT s.ssl, a.usename, coalesce(nullif(a.application_name,''),'(空)') AS app,
       coalesce(host(a.client_addr),'(local)') AS client, count(*)
FROM pg_stat_activity a JOIN pg_stat_ssl s USING (pid)
WHERE a.backend_type = 'client backend' AND a.pid <> pg_backend_pid()
GROUP BY 1,2,3,4 ORDER BY s.ssl, count(*) DESC;
  • ssl = f の行が rdsadmin(local。RDS の内部の接続で rds.force_ssl の対象外)以外に無いこと。
  • バッチは決まった時刻にしかつながないので、03:00 頃・06:15 頃・07:00 頃(JST)と、日中の何回かで見る。

取りこぼしをなくすなら:db5 は log_connections が既定値(オフ)で、接続がログに残らない。$PG で一時的に log_connections = 1(dynamic)にすると、1〜2 日分の接続元・SSL の有無が CloudWatch Logs(/aws/rds/instance/fastdoctor-manager-db5/postgresql)に残る。本番の変更なので、実施するかは別に決める。

1-4. 実施の時間 ​

  • 日中の、バッチの時刻(03:00・06:15・07:00 前後、毎時 00 分・30 分)を避けた時間。
  • Trocco・Redash の担当が、反映後すぐに動作を確かめられる時間。

2. 変更 ​

変更した時刻を控えておく(§3 のログの確認の開始時刻に使う。Issue にも書いておく)。

bash
CHANGED_AT=$(date +%s); date -r "$CHANGED_AT" '+%F %T %Z'
"${FDSYS[@]}" rds modify-db-parameter-group --db-parameter-group-name "$PG" \
  --parameters "ParameterName=rds.force_ssl,ParameterValue=1,ApplyMethod=immediate" \
  --query DBParameterGroupName --output text

反映を確認する(数十秒〜数分)。

bash
# パラメータの値
"${FDSYS[@]}" rds describe-db-parameters --db-parameter-group-name "$PG" \
  --query "Parameters[?ParameterName=='rds.force_ssl'].[ParameterName,ParameterValue]" --output text
# db5 への反映の状態:in-sync になること(pending-reboot にならない)
"${FDSYS[@]}" rds describe-db-instances --db-instance-identifier "$DB" \
  --query 'DBInstances[0].[DBInstanceStatus,DBParameterGroups[0].ParameterApplyStatus]' --output text

期待値:rds.force_ssl 1・available in-sync。

DB 側でも確かめる(§1-3 と同じつなぎ方)。

sql
SHOW rds.force_ssl;   -- on

SSL を使わない接続が断られることを確かめる(sslmode=disable で試す。断られれば成功)。

bash
psql "host=127.0.0.1 port=<トンネルのポート> user=<user> dbname=<db> sslmode=disable" -c 'select 1'
# 期待:FATAL:  no pg_hba.conf entry for host "...", user "...", database "...", no encryption

3. 事後の確認 ​

実施の前に、翌朝の確認の担当者を決めておく(03:00・06:15・07:00 のバッチが失敗しても、見ていなければ気づかない)。

  • [ ] RDS のログに、SSL を使わない接続が断られた記録が出ていないか見る(出ていれば、その接続元は §0-3 で見落としたもの。接続元の IP もログに出る)。 開始時刻は変更した時刻(CHANGED_AT)にする。「直近 1 時間」にすると、朝に見たときに 03:00・06:15 の失敗を見逃す。

    bash
    # 別のシェルで見るときは、§2 で控えた時刻から作る(macOS の例)
    # CHANGED_AT=$(date -j -f '%Y-%m-%d %H:%M' '2026-11-xx 14:00' +%s)
    "${FDSYS[@]}" logs filter-log-events --log-group-name /aws/rds/instance/fastdoctor-manager-db5/postgresql \
      --start-time $(( CHANGED_AT * 1000 )) --filter-pattern '"no encryption"' \
      --query 'events[].message' --output text | cut -c1-200 | head
  • [ ] Trocco:db5 を読む転送の次の実行が成功する

  • [ ] Redash:db5 のデータソースのクエリが実行できる

  • [ ] Airflow:realtime-examination-status.notify(毎時 00 分・30 分)と、翌朝の fd-system の load_lake(06:15)が成功する

  • [ ] 翌朝の 03:00・06:15・07:00 を越えたあと、もう一度上のログを見る(開始時刻は CHANGED_AT のまま)

  • [ ] §1-3 の SQL で、ssl = f が rdsadmin 以外に無い

断られた接続が出ても、RDS の監視(CloudWatch アラーム・Datadog)は鳴らない(DB のログに出るだけ)。監視の一時停止は要らない。


4. 戻し ​

断られたクライアントがあり、すぐに直せないとき。

bash
"${FDSYS[@]}" rds modify-db-parameter-group --db-parameter-group-name "$PG" \
  --parameters "ParameterName=rds.force_ssl,ParameterValue=0,ApplyMethod=immediate"

再起動なしで戻る。戻した場合は、そのクライアントの SSL の設定を直してから §2 をやり直す。


5. 後片付け ​

  • [ ] db-upgrade/rds-pg16/services/fastdoctor-manager.md の、db5 の rds.force_ssl = 0 の記述を直す。§6(Trocco の CA)もそこから参照する
  • [ ] fastdoctor-manager#8982 の spec.md・接続案内の「db5 は SSL を強制していない」を直してもらう
  • [ ] mental-online-karte の projects/online-airflow/dags/fd-system/README.md・AGENTS.md の fd-system-replica の記述を実態に合わせる(Login は fdadmin、Extra は {"sslmode": "require"}。再登録のスクリプトの URI に ?sslmode=require を付ける)
  • [ ] 新設予定の db7(Trocco 用)は、作るときから rds.force_ssl = 1 にする
  • [ ] PG16 のパラメータグループを Terraform に取り込む:fastdoctor-jp/mental-online-karte#25118(取り込むときは db5 も rds.force_ssl = 1)
  • [ ] db5 の SG から、使っていない Retool の許可を外す:fastdoctor-jp/mental-online-karte#25119

6. db5 の CA を変えるとき(Trocco) ​

Trocco は db5 への接続に CA 証明書を設定していて、その欄には rds-ca-rsa2048-g1 の証明書だけを入れている(Trocco のフォームの文字数の上限で、全部入りの global-bundle.pem は入らないため。#24932)。

  • db5 の CA(CACertificateIdentifier)を別の種類(rds-ca-rsa4096-g1 など)に変えるときは、同時に Trocco の接続情報の CA 証明書の欄も、新しい CA の証明書に変える。変えないと、Trocco は証明書を検証できずに接続に失敗する。

  • 今の CA は次で確かめる。

    bash
    "${FDSYS[@]}" rds describe-db-instances --db-instance-identifier "$DB" \
      --query 'DBInstances[0].[CACertificateIdentifier,CertificateDetails.ValidTill]' --output text
  • 新設予定の db7 に Trocco を移すときも同じ(db7 の CA に合わせて Trocco の欄を設定する)。