の新しいコンソールエクスペリエンスの紹介 AWS WAF

更新されたエクスペリエンスを使用して、 コンソールの任意の場所で AWS WAF 機能にアクセスできるようになりました。詳細については、「コンソールの使用」を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

動的ラベル補間

動的ラベル補間を使用すると、${namespace:}構文を使用してカスタムリクエストヘッダー、カスタムレスポンスヘッダー、カスタムレスポンス本文にラベル値を直接埋め込むことができます。 は、評価時に各プレースホルダーをリクエストにアタッチされたラベルに対して AWS WAF 解決するため、ラベル値ごとに個別のルールを記述する必要はありません。

補間は既存の AWS WAF API 内で機能し、新しいフィールドや設定ステップはありません。プレースホルダー構文は、既存の文字列値で使用します。既存の静的ヘッダー値は引き続き変更されません。補間は、値に ${namespace:}句が含まれている場合にのみアクティブ化されます。

補間がサポートされている場所

補${namespace:}間は、次の場所で使用できます。

補間構文と解決

補間を使用するには、ヘッダー値またはカスタムレスポンス本文コンテンツに ${namespace:}句を含めます。末尾のコロンは重要です。1 つのラベルを文字通り一致させるのではなく、その名前空間内のすべてのラベルを解決 AWS WAF するように に指示します。

AWS WAF は、次のルールを使用して、評価時に各句を解決します。

合成ラベル

補間は合成ラベルもサポートしています。これらは、ラベルストアからではなくリクエストコンテキストから解決される AWS WAF 組み込み値です。合成ラベルを同じ値文字列内の名前空間ベースのラベルと組み合わせることができます。

動的ラベル補間の例

動的ヘッダーを使用したアプリケーションシグナリング

次のルールは、複数の Bot Control シグナル名前空間を個別のヘッダーとしてオリジンに転送します。1 つのルールは名前空間全体を対象とするため、マネージドルールグループが新しいラベルを追加するときにルールを更新する必要はありません。

{
  "Name": "forward-waf-signals",
  "Statement": {
    "LabelMatchStatement": {
      "Scope": "NAMESPACE",
      "Key": "awswaf:managed:aws:bot-control:bot:category:"
    }
  },
  "RuleAction": {
    "Count": {
      "CustomRequestHandling": {
        "InsertHeaders": [
          { "Name": "bot-category",
            "Value": "${awswaf:managed:aws:bot-control:bot:category:}" },
          { "Name": "bot-name",
            "Value": "${awswaf:managed:aws:bot-control:bot:name:}" },
          { "Name": "bot-signals",
            "Value": "${awswaf:managed:aws:bot-control:signal:}" },
          { "Name": "client-ip",
            "Value": "${awswaf:ip:}" }
        ]
      }
    }
  }
}

bot-signals ヘッダー (出力: x-amzn-waf-bot-signals) は、複数値の解決を示します。signal: 名前空間には、カンマ区切りリストに解決される などnon_browser_user_agent,automated_browser、複数のラベルを含めることができます。client-ip ヘッダー (出力: x-amzn-waf-client-ip) は合成ラベルを使用します。

デバッグ情報を含むカスタムブロックページ

合成ラベルを使用すると、リクエスト固有のコンテキストを含むブロックページを構築できます。クライアントの IP アドレスと AWS WAF リクエスト ID をレスポンス本文に直接埋め込み、ユーザーが誤検出をレポートしたときに共有する内容を提供します。

{
  "CustomResponseBodies": {
    "BlockPage": {
      "Content": "Your request was blocked.\n\nIP: ${awswaf:ip:}\nRequest ID: ${awswaf:request_id:}\n\nIf you believe this is an error, contact support with the Request ID above.",
      "ContentType": "TEXT_PLAIN"
    }
  }
}

カスタムラベル補間

補間は、独自のルールで定義したカスタムラベルなど、任意のラベル名前空間で機能します。次の例では、API キーでリクエストを分類し、階層値をオリジンに転送します。

ルール 1: API キーに基づいて階層を分類する

このルールは、リクエストをエンタープライズ API キーと照合し、カスタムラベルを適用します。

{
{
  "Name": "classify-tier",
  "Priority": 100,
  "Statement": {
    "ByteMatchStatement": {
      "SearchString": "pk_enterprise_",
      "FieldToMatch": { "SingleHeader": { "Name": "x-api-key" } },
      "PositionalConstraint": "STARTS_WITH",
      "TextTransformations": [{ "Priority": 0, "Type": "NONE" }]
    }
  },
  "RuleLabels": [{ "Name": "app:tier:enterprise" }],
  "Action": { "Count": {} }
}

}

ルール 2: 解決された階層値を転送

このルールは、app:tier名前空間内の任意のラベルに一致し、解決された値をヘッダーとして転送します。

{
{
  "Name": "forward-tier",
  "Priority": 200,
  "Statement": {
    "LabelMatchStatement": {
      "Scope": "NAMESPACE",
      "Key": "app:tier:"
    }
  },
  "Action": {
    "Count": {
      "CustomRequestHandling": {
        "InsertHeaders": [{
          "Name": "customer-tier",
          "Value": "${awswaf:ACCOUNT_ID:webacl:WEBACL_NAME:app:tier:}"
        }]
      }
    }
  }
}

最初のルールはラベル を適用しますapp:tier:enterprise。2 番目のルールは、app:tier名前空間内の任意のラベルに一致し、解決された値を customer-tierヘッダーとして転送します。出力ヘッダー名は ですx-amzn-waf-customer-tier。app:tier:standard や など、他の階層の分類ルールを追加できますapp:tier:trial。転送ルールは、変更なしでそれらを取得します。

これらのパターンをすべて示すデプロイ可能なサンプルについては、GitHub のAWS WAF 「動的ラベル補間サンプル」を参照してください。