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 は書かない。アカウント違いのときにターミナルごと閉じるため)。
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 であること
# このグループを使っているインスタンスが 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 を持っているので、他のアカウントの接続も全部見える。
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 にも書いておく)。
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反映を確認する(数十秒〜数分)。
# パラメータの値
"${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 と同じつなぎ方)。
SHOW rds.force_ssl; -- onSSL を使わない接続が断られることを確かめる(sslmode=disable で試す。断られれば成功)。
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 encryption3. 事後の確認
実施の前に、翌朝の確認の担当者を決めておく(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. 戻し
断られたクライアントがあり、すぐに直せないとき。
"${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 の欄を設定する)。