ラベル一致ルールステートメント - AWS WAF、 AWS Firewall Manager、および AWS Shield Advanced

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

ラベル一致ルールステートメント

ラベル一致ステートメントは、ウェブリクエストにあるラベルを文字列指定に照らして検査します。検査用のルールで使用できるラベルは、同じウェブ ACL 評価内の他のルールによってウェブリクエストに既に追加されているラベルです。

ラベルはウェブ ACL CloudWatch 評価以外では保持されませんが、ラベルメトリックスにアクセスしたり、任意のウェブ ACL のラベル情報の概要をコンソールで確認したりできます。 AWS WAF 詳細については、ラベルメトリクスとディメンションおよびモニタリングとチューニングを参照してください。ログにはラベルも表示されます。詳細については、ログフィールド を参照してください。

注記

ラベル一致ステートメントは、ウェブ ACL で以前に評価されたルールのラベルのみを表示できます。ウェブ ACL AWS WAF 内のルールとルールグループを評価する方法については、を参照してください。ウェブ ACL でのルールおよびルールグループの処理順序

ラベルの追加と一致の詳細については、「AWS WAF ウェブリクエストの ラベル」を参照してください。

ネスト可能 - このステートメントタイプはネスト可能です。

WCU - 1 つの WCU

このステートメントには、次の設定を使用します。

  • [Match scope] (一致範囲) – これを [Label] (ラベル) に設定して、ラベル名と、ならびにオプションで、先行する名前空間およびプレフィックスと照合します。これを [Namespace] (名前空間) に設定して、名前空間の指定の一部または全部、およびオプションで、先行するプレフィックスと照合します。

  • [Key] (キー) – 照合する文字列。名前空間一致の範囲を指定する場合、これは、名前空間と、オプションでプレフィックスのみを指定する必要があり、末尾にコロンを付けます。ラベル一致の範囲を指定する場合、これはラベル名を含む必要があり、オプションで前述の名前空間とプレフィックスを含めることができます。

これらの設定の詳細については、「AWS WAF ラベルに一致する ルール」および「AWS WAF ラベル一致の例」を参照してください。

このルールステートメントの場所
  • コンソールのルールビルダー - [Request option] (リクエストオプション) で [Has label] (ラベルあり) を選択します。

  • API — LabelMatchStatement