受付制限・Slack通知の反映チェックリスト

今回の改修を稼働済みの自前版へ反映するときは、APIコード、APIの環境設定、NGINX設定、フロント、Slack監視を更新する。APIのコード差し替えだけでは、入口のIP別制限とSlack通知は有効にならない。本書は今回の更新箇所と作業順をまとめたもので、個別のコマンドはリンク先の手順に従う。

更新する場所

作業場所 更新先 今回の作業
アプリサーバー /opt/tectas-contact/ backend/contact-form/src/、package.json、package-lock.jsonを同じコミットの内容へ更新し、依存関係を用意する
アプリサーバー /etc/tectas-contact/contact.env IP別上限と信頼するNGINXの接続元IPを追加する
NGINXサーバー 現在のNGINX設定ファイル http内の共有領域・ログ形式と、/api/contactの頻度制限・同時処理制限・実IP転送・専用ログを追加する
ビルド端末・CI → 静的サイト配信先 フロントのビルド成果物 HTML形式の429応答でも制限を案内する修正を再ビルド・配置する
API・NGINXの各サーバー /opt/tectas-contact-monitor/ monitor.mjsとmonitor-run.mjsを新規配置する
API・NGINXの各サーバー /etc/tectas-contact-monitor/ monitor.envと、非公開のWebhookファイルslack-webhookを新規作成する
API・NGINXの各サーバー /etc/systemd/system/ tectas-contact-monitor.service・.timerを新規配置し、定期実行を有効にする
NGINXサーバー ログの権限・既存logrotate設定 専用ログを監視から読み取れるようにし、30日保持とローテーションを設定する
Slack 通知先チャンネル・Incoming Webhook 管理者向け通知先を用意し、接続テストを実施する

試験環境の例ではAPIが192.168.15.19、NGINXが192.168.15.20である。実環境のIPと配置先を確認して置き換える。同一ホスト構成では、Slack監視をbothモードで1つだけ配置する。別ホスト構成では、API側にapp、NGINX側にproxyを配置する。NGINX側にもNode.js 24系が必要になる。

追加・確認する設定

APIのcontact.envには次を追加する。ファイル全体を設定例で上書きせず、現在のSMTP宛先、Origin、DBパスなどを維持する。

IP_HOURLY_LIMIT=3
IP_DAILY_LIMIT=10
TRUSTED_PROXY_IPS=192.168.15.20

TRUSTED_PROXY_IPSは、APIから見たNGINXの接続元IPを指定する。同一ホストなら通常は127.0.0.1,::1である。IP別上限は設定を省略しても3件/時・10件/日で有効になるため、NGINXが実IPを上書きする変更と合わせて反映する。信頼先を設定しないままプロキシ経由で使うと、全利用者がNGINXのIPとして集計される。

全体上限のHOURLY_LIMIT・DAILY_LIMITは今回のコード更新では変更しない。設定例は10件/時・30件/日であり、IP別制限を追加しても複数IPから全体枠を消費される可能性は残る。通常の集中投稿数とSMTPの許容量を基に、実環境の値を確認する。

NGINXは設定例を使い、次を反映する。

既存環境での編集箇所とコマンドは稼働済みNGINXの差分更新にまとめる。サイトの公開ファイルはCI/CDで置き換え、ここでは設定だけを更新する。httpはHTTP通信専用ではなく、HTTPS用serverも含む設定ブロックを指す。

  • http内:limit_req_zone、limit_conn_zone、log_format contact_safeを一度だけ定義する。
  • /api/contact内:平均6要求/分・バースト2、同時処理1件/IP、超過時429を設定する。
  • 転送ヘッダー:proxy_set_header X-Real-IP $remote_addr;で利用者が指定した値を上書きする。
  • 専用ログ:contact_safe形式のアクセスログと、エラーログの設定を反映する。

設定例全体をserver内へ貼り付けない。APIのTCP 3001番はNGINXからだけ接続を許可する。CDNを挟む場合は、信頼する接続元だけからNGINXの実IPを復元する設定も確認する。

Slack監視のmonitor.envは、別ホスト構成なら次のように分ける。Webhook URLはこのファイルに含めず、/etc/tectas-contact-monitor/slack-webhookへ1行で記入する。

配置先 MONITOR_MODE MONITOR_LABELの例
API側 app production-app
NGINX側 proxy production-proxy
同一ホスト both production

反映する順序

  1. 対象版とバックアップを準備する。 コミットSHAを記録し、SQLiteと環境設定・秘密情報、既存NGINX設定をバックアップする。API手動更新手順の第1〜3節に従って新版を準備する。
  2. フロントを反映する。 今回の429応答への対応を含む成果物をCI/CD手順で配置する。保護タグのパイプラインはフロントを自動配置するため、API用の対象版を確定する際にも配置内容を確認する。
  3. メンテナンス中にAPI・NGINXを更新する。 APIを停止し、APIコードとcontact.envを更新する。NGINX設定を追加してnginx -tに成功したらreloadし、APIを起動する。コードの切り替えはAPI手動更新手順の第4〜5節、設定は受付制限の反映手順に従う。
  4. 問い合わせの疎通を確認する。 Origin・実IP転送を確認し、検証用SMTP・宛先で正規送信、IP別制限、別IPからの受付継続、同じ受付IDの結果確認を試す。
  5. Slack監視を新規配置する。 Slack通知のセットアップに従い、監視コード・Webhook・環境設定・systemd unitを配置する。NGINX側ではログの読み取り権限とローテーションも設定する。
  6. 通知を確認する。 Slackの接続テスト、timerの稼働、サービス停止や上限超過の検出を検証環境で確認し、結果を記録する。実サーバーでのsystemd・NGINXの検査とSlack送信試験は、ローカルの自動テストとは別に必要になる。

Slack監視を先に配置済みの場合は、メンテナンス中だけtimerを停止し、APIとNGINXの作業後に再開する。

保持するデータと今回の対象外

SQLiteの既存データとSMTP・Turnstileの秘密情報は維持する。DBスキーマの移行やDBの作り直しは不要である。HMACの秘密鍵を変えると既存の重複判定とIP別カウンターを引き継げないため、今回の更新では変更しない。APIの既存systemd serviceは、配置パスや実行環境を変えない限り差し替え不要である。

AWS版を使用していなければ、AWSへの作業は不要である。AWS版を使用している場合は、LambdaコードとSAMテンプレートを更新し、IP別上限・全体上限超過通知・4xx通知を反映する。自前版のSlack監視はAWSへ配置しない。AWSのWAF導入とAPI構成変更は今回の実装に含まれていない。

当初の指摘「2」に対応する静的サイトのCSP・HSTS等は、セキュリティヘッダーの反映手順で扱う。NGINX設定例とCSPに対応したフロント修正を用意しており、サーバー設定の反映とCI/CDによるフロント配置が必要になる。

完了確認

  • [ ] APIコードと追加環境設定を反映し、tectas-contactが起動する。
  • [ ] NGINXの構文検査が成功し、頻度・同時処理の超過で429が返る。
  • [ ] 制限中でも別IPから正規の問い合わせを受け付けられる。
  • [ ] フロントはHTML形式の429を案内し、結果不明の問い合わせは同じIDで確認できる。
  • [ ] API側・NGINX側の必要な監視timerが有効になっている。
  • [ ] Slackへの接続テストと異常通知を確認した。
  • [ ] 個人情報・生のIP・Webhook URLが通知や監視ログへ出ていない。
  • [ ] 対象コミット、設定変更、確認結果、切り戻し先を作業記録へ残した。