Skip to content

FDサービス系WAF 運用設計書 ​

文書情報 ​

項目内容
作成日2026-05-25
対象システムFDサービス系 ALB + WAF(*.fstdr.jp)
対象環境production
関連ドキュメントFDサービス系 移行設計書, WAF 運用設計書(LP向け), CloudFront WAF アーキテクチャ設計書
関連Issuemental-online-karte#11672

本ドキュメントの位置づけ ​

FDサービス系WAF(*.fstdr.jp)固有の運用差分を記載する。 運用体制・定常運用フロー・インシデント対応・変更管理等の共通事項は WAF 運用設計書(LP向け) に従う。


1. 対象範囲 ​

項目LP向けWAF(既存)FDサービス系WAF(本ドキュメント)
対象ドメインfastdoctor.jp, test.fastdoctor.jp*.fstdr.jp(11サービス)
AWSアカウントfd-sys(913831226605)fd-prod(967691968827)
WAFスコープCLOUDFRONTREGIONAL(ALB に直接アタッチ。API Gateway は HTTP API のため WAF 非サポート、別途検討)
共有リソースwaf-shared-sets(IP/UA Blacklist、CLOUDFRONT スコープ)REGIONAL スコープで別途作成(IP リストの内容は Terraform 変数で共通化)
Datadog Pipelinesource:waf(共通)同一Pipelineを利用(waf_host タグでドメイン区別)

2. ログコスト最適化(#11672) ​

Geo制限は導入しない方針のため(海外勤務の医師・渡航中の患者向けサービスがあるため)、当初想定していた国外Blockログによるコスト圧迫リスクは低下した。 ただし Block/Count ログ量が想定を超える場合に備え、以下のコスト最適化手段を記載する。

2.1 Datadog Index Exclusion Filter ​

Datadog側で国外BlockログをIndexから除外し、インデックスコスト(保存・検索)を削減する。

  • 対象インデックス: main
  • Exclusion Filter 名: waf-geo-block-non-jp
  • 除外クエリ: source:waf @httpRequest.country:(-JP) @action:BLOCK
  • サンプリング率: 100%(全て除外)
  • 設定場所: Datadog Log Index Configuration
ログ種別Datadog IndexDatadog検索S3Athena検索
JP の Block/Count保存可能保存可能
国外(JP以外)の Block除外不可保存可能
国外(JP以外)の Count保存可能保存可能
ALLOW送信しない---

なぜDatadog側で除外するか:

  • WAF Logging Filterでは country フィールドで条件分岐できない(action条件のみ)
  • Firehose Lambda Data Transformation で除去する方法もあるが、Lambda の開発工数・メンテナンスコスト(コード管理、エラーハンドリング、バージョン管理等)がかかる
  • Datadog Index Exclusion Filter は設定のみで完結し、追加の開発・運用負荷がない
  • 除外されたログもLive Tail・Log-based Metricsでは利用可能

2.2 誤検知調査: S3 + Athena ​

Datadog Indexから除外された国外Blockログの誤検知調査は、Firehose S3バックアップに保管された全ログを Athena で SQL 検索する。

WAF → Firehose → Datadog(Index除外で国外Block非表示)
              └→ S3(AllData、全ログ保管)→ Athena(必要時にSQL検索)

S3 + Athena を採用した理由(Datadogカスタムメトリクス案との比較、#11672で検討):

既存の fastdoctor.jp, test.fastdoctor.jp のWAFログ(約5,215件/日)をベースに比較調査した結果、以下の通り。FDサービス系はこれよりログ量が大幅に多くなる見込みのため、コスト面でも S3 + Athena が有利。

観点S3 + AthenaDatadogカスタムメトリクス
誤検知調査全フィールド(URI, ヘッダー, ルールID等)をSQLで自由検索集計値のみ。「なぜブロックされたか」は不明
コスト月 $0.1〜0.5(実質無料)月 $2〜40(group by粒度次第。攻撃時にIP急増でコスト増リスク)
セキュリティ自社AWS内にログ保管。IAM/KMS/CloudTrailで制御Datadog SaaS委託

Datadogカスタムメトリクス(Generate Metrics)はDatadog社から提案されたが、 誤検知調査のユースケース(低頻度・全フィールド参照)にはS3+Athenaの方が適しており、見送り。 国内サービスのため国外トラフィックの傾向分析も不要。

S3 保管設計 ​

項目設定
バックアップモードAllData(Firehose Source record backup)
圧縮gzip(Firehose標準)
パーティションyear/month/day(動的パーティショニング)
ライフサイクルStandard → 30日後 Standard-IA → 90日後 Glacier Instant Retrieval
保持期間1年(監査要件)
暗号化SSE-S3 or SSE-KMS
パブリックアクセス全ブロック

Athena 関連設計 ​

Athenaのデータベース・テーブル定義、Workgroup設定、コストモニタリング、クエリの投げ方については別途設計する。

関連ドキュメント:

2.3 Ingestionコスト削減(必要に応じて追加検討) ​

上記でもDatadogのインジェストコストが予算を超える場合、Firehose Lambda Data Transformation で国外BlockログをDatadogに送信する前に除去する方法がある。1-2ヶ月運用してコストを確認してから判断。


3. 疎通検証期間のDatadogアカウント分離 ​

アクセス数が多いサービスのみ、疎通検証期間(約1週間)にインフラDatadogアカウントでログ量を計測する。

サービスDatadogアカウント
backend.fastdoctor.jp, p.fstdr.jpインフラで検証後に本番切替
その他(mental-reserve-patient 等)最初から本番
  • インフラアカウントは現状ログが無いため、WAFログの影響を正確に計測できる
  • 検証期間中もインフラDatadogアカウントでダッシュボードでモニタリングする
  • 疎通検証完了後、本番Datadogアカウントに切り替え。ダッシュボードもexport/importする

4. センシティブフィールドの保護(Data Protection) ​

4.1 背景 ​

WAF ログに x-api-key ヘッダーの値が平文で記録されるてしまう。 また redacted_fields はログのみに適用され、AWS コンソールのリクエストサンプリングでは値が閲覧可能な状態だった。

さらに、一部サービスでは GET リクエストのクエリパラメータに認証トークンを含めており、WAF ログ(S3 / Datadog)経由で PII・認証情報が漏洩するリスクが確認された(#21456)。

サービス漏洩パラメータ形式内容
online-videotoken?token=<JWT>署名付き JWT(患者認証トークン)
member-service-bffauthToken?query[authToken]=<token>認証トークン(Rails nested params 形式)

4.2 対策: Redacted Fields → Data Protection に移行 ​

AWS WAF の Data Protection 機能を採用し、センシティブフィールドの保護を一本化した。

項目旧(Redacted Fields)新(Data Protection)
適用範囲ログのみログ + リクエストサンプリング + Security Lake
設定箇所aws_wafv2_web_acl_logging_configurationaws_wafv2_web_acl
マスク方法値を xxx に置換値を REDACTED に置換(SUBSTITUTION)

4.3 保護対象フィールド ​

ヘッダー(SINGLE_HEADER) ​

ヘッダー用途保護理由
authorizationBearer トークン等の認証情報セッションハイジャック防止
cookieセッション Cookie同上
x-api-keyサーバー間通信の API Key不正利用防止

クエリパラメータ(SINGLE_QUERY_ARGUMENT) ​

パラメータ利用サービスWAF マスク備考
tokenonline-video✅?token=<JWT> — マスク可能
authtoken汎用✅?authtoken=<value> — マスク可能

注意: SINGLE_QUERY_ARGUMENT でマスクを設定すると、そのパラメータが WAF ルールの検査対象に含まれる場合、ログの RuleMatchDetails 内のクエリ文字列全体が REDACTED に置換される(デバッグ情報の可視性低下のトレードオフあり)。 当該パラメータを持たないリクエストへの影響は無い。

WAF Data Protection の制約 ​

パラメータ形式WAF マスク理由
?token=<value>✅SINGLE_QUERY_ARGUMENT でパラメータ名が完全一致
?authtoken=<value>✅同上
?query[authToken]=<value>❌WAF はパラメータ名を query[authToken] として認識し、authtoken とマッチしない

検証結果(2026-10-27、fd-app-bff/infra-dev): query[authToken] 形式は SINGLE_QUERY_ARGUMENT ではマスクできないことを確認。member-service-bff の実パラメータは query[authToken](Rails nested params)であるため、WAF Data Protection では保護不可。アプリ側での対応(#21954)が必須。

4.4 Terraform 実装 ​

alb-waf / cloudfront-waf 両モジュールの aws_wafv2_web_acl リソースに data_protection_config ブロックを追加。

hcl
# aws_wafv2_web_acl 内
data_protection_config {
  # ヘッダー保護
  data_protection {
    action = "SUBSTITUTION"
    field {
      field_type = "SINGLE_HEADER"
      field_keys = ["authorization", "cookie", "x-api-key"]
    }
  }
  # クエリパラメータ保護
  data_protection {
    action = "SUBSTITUTION"
    field {
      field_type = "SINGLE_QUERY_ARGUMENT"
      field_keys = ["token", "authtoken"]
    }
  }
}

member-service-bff について: pf-member-service-bff は cloudfront-waf モジュールを使用しており、query[authToken] 形式でのクエリパラメータ漏洩が確認されている(調査結果 Item #11)。しかし WAF の SINGLE_QUERY_ARGUMENT では query[authToken] 形式をマスクできないため(検証済み)、アプリ側での対応(#21954)が必須。cloudfront-waf にも token / authtoken の保護は追加するが、member-service-bff の実パラメータには効果がない。

4.5 検証結果(infra-dev) ​

fd-app-bff/infra-dev で検証。AWS サンプリング・Datadog ログの両方でマスクを確認。

ヘッダー保護(v1.2 で検証済み) ​

確認先authorizationcookiex-api-key
AWS サンプリングREDACTED ✅—REDACTED ✅
Datadog ログ(rate-limit-blanket)REDACTED ✅REDACTED ✅REDACTED ✅

クエリパラメータ保護(2026-10-27 検証) ​

パラメータ形式サンプリング URIマスク
?token=test-jwt-value/?token=REDACTED✅
?authtoken=test-auth-value/?authtoken=REDACTED✅
?query[authToken]=test-nested-value/?query%5BauthToken%5D=test-nested-value❌ 平文

query[authToken](Rails nested params)形式は WAF の SINGLE_QUERY_ARGUMENT ではマスクできない。

4.6 適用範囲 ​

モジュールヘッダー保護クエリパラメータ保護備考
alb-waf全サービスtoken / authtoken をマスクonline-video の ?token= は保護される
cloudfront-wafenable_data_protection = true のもの同上member-service-bff の ?query[authToken]= は WAF では保護不可(#21954で対応)

4.7 今後の運用 ​

  • 新たに保護すべきヘッダーが見つかった場合、SINGLE_HEADER の field_keys に追加するだけで対応可能
    • 特定サービスだけの認証ヘッダーは、alb-waf の data_protection_additional_header_keys でそのサービスにだけ追加する(既定は空で、ほかの Web ACL には差分が出ない)
  • 新たに保護すべきクエリパラメータが見つかった場合、SINGLE_QUERY_ARGUMENT の field_keys に追加する
  • data_protection_config は Web ACL の設定であり、追加コストは発生しない
  • GET パラメータに認証情報を含む設計は根本的な問題のため、サービス側での対応を推進する
    • online-video: フラグメント移行(#21953)
    • member-service-bff: query[authToken] の廃止(#21954)— WAF Data Protection では保護不可のため優先度高

変更履歴 ​

日付バージョン変更内容担当チーム担当者
2026-05-251.0初版作成(WAF運用設計書からFDサービス固有部分を分離)SRE大賀
2026-06-081.1WAFスコープを CLOUDFRONT → REGIONAL に変更。共有IPセットの管理方針を更新SRE大賀
2026-08-041.2センシティブヘッダー保護を追加(Redacted Fields → Data Protection 移行)SRE大賀
2026-10-271.3クエリパラメータ保護を追加(token/authtoken)。query[authToken] 形式は WAF では保護不可であることを検証・記載(#21878)SRE大賀
2026-11-101.4alb-waf にサービス固有のヘッダーを追加でマスクする data_protection_additional_header_keys を追加(#21129)SRE福本