diff --git a/articles/network/appgw-waf-body-file-size.md b/articles/network/appgw-waf-body-file-size.md new file mode 100644 index 0000000000..329a462e54 --- /dev/null +++ b/articles/network/appgw-waf-body-file-size.md @@ -0,0 +1,130 @@ +--- +title: Application Gateway WAF V2 CRS 3.2 以降で追加された要求本文の検査について +date: 2024-05-14 21:08 +tags: + - Network + - Application Gateway + - WAF +--- + +こんにちは、Azure テクニカル サポート チームの大塚です。 + +この記事では、先日新たに追加された Application Gateway WAF ポリシーのマネージド ルールにおいて CRS （コア ルール セット）3.2 以上を利用している際に要求本文(＝Request Body)のサイズ、ファイル アップロードのサイズ、および要求本文の検査をより細かく制御できる機能についてご紹介します。 + +--- + +### はじめに +この記事は、以下の 3 つのシナリオにすべてあてはまるお客様向けの内容となります。 + +* Application Gateway WAF V2 の SKU を利用している +* WAF ポリシーを利用している +* WAF ポリシーのマネージド ルールで指定している CRS バージョンが 3.2 以上である + +WAF によってチェックされる要求サイズへの制限につきましては[こちら](https://learn.microsoft.com/ja-jp/azure/web-application-firewall/ag/application-gateway-waf-request-size-limits)のドキュメントに記載がございますが、本ブログでは今回追加された新機能のみに焦点をおき、ご紹介いたします。 + +### 新しく追加された機能 +今回追加された機能を含め、現在 CRS 3.2 以上の WAFで利用できる機能は以下となります。 + +* ① 要求の本文に含まれる内容において、先頭から何 KB の範囲を WAF で評価させるかの検査の上限を指定することができる +* ② 要求の本文の検査するサイズの上限の指定とは独立して、要求本文の内容を検査する/しないを指定できる +* ③ 要求の本文に含まれる内容の検査とは独立して、要求本文のサイズの検査を無効にできる +* ④ 要求の本文の検査とは独立して、ファイル アップロードのサイズの検査を無効にできる +* ⑤ 要求本文のサイズの上限を指定できる `※ 8 KB から 2000 KB（2MB） の範囲` +* ⑥ ファイル アップロードのサイズの上限を指定できる `※ 1 MB から 4000 MB（4GB） の範囲` + +実際のポータルの設定画面と上記項番の該当箇所は以下のようになります。 +![](./appgw-waf-body-file-size/01.png) + +>[!NOTE] +>大きく追加された機能としては ① です。 +>②から④ は CRS 3.1 以下でも利用できましたが、それぞれの設定が独立して指定できるようになりました。 +>⑤から⑥ はこれまでと変わらず WAF 利用時のサイズの上限を指定する項目となります。 + + +### 上限値の整理 + +Application Gateway V2 の要求本文サイズやファイル アップロードサイズの「上限値」について整理しましょう。 +（※単位の違いにもご留意ください） + +| | 要求本文のサイズ上限 | ファイル アップロードのサイズ上限 | +| ------------ | ------------ | ------------ | +| Application Gateway V2 自体の上限値 （要求本文/ファイルアップロードの上限適用を無効にした場合はこの上限になります） | 4 GB | 4 GB | +| Application Gateway WAF V2/CRS 3.2 以降の上限値 | 2 MB | 4 GB | +| Application Gateway WAF V2/CRS 3.1 以前の上限値 | 128 KB | 750 MB | + + +### 実際の動作の確認 +それでは新しく追加された ① の機能について動作を詳しく確認してみましょう。 + +この検証では、クライアントが送信するリクエストの要求本文の先頭から 10 KB 目に WAF で検知される文字列を含ませて送信してみることにします。設定内容によって実際に WAF がどのように動作するかを検証してみました。 + + +### 「要求本文検査の上限 (KB)」が 128 (既定値)の場合 + +![](./appgw-waf-body-file-size/02.png) + +検査する要求本文の範囲は先頭から 128 KB までを指定しています。 +要求本文の先頭から 10 KB 目に WAF で検知される文字列が含まれているリクエストを送信しているので、この場合は該当文字列はWAF での評価がされます。アクセス ログより HTTP ステータス コード 403 が返され、ブロックされることが確認できました。 + +![](./appgw-waf-body-file-size/03.png) + + +### 「要求本文検査の上限 (KB)」が 8 の場合 + +![](./appgw-waf-body-file-size/04.png) + +検査する要求本文の範囲は先頭から 8 KB までを指定しています。 +要求本文の先頭から 10 KB 目に WAF で検知される文字列が含まれているリクエストを送信しているので、この場合は該当文字列は WAF での評価はされません。アクセス ログより HTTP ステータス コード 200 が返されたことが確認できました。 + +![](./appgw-waf-body-file-size/05.png) + + +### 「要求本文検査の上限 (KB)」を「要求本文最大サイズ (KB)」よりも大きくした場合 + +![](./appgw-waf-body-file-size/09.png) + +検査する要求本文の範囲は先頭から 15 KB までを指定していますが、要求本文のサイズ上限を 8 KB に指定しています。 +この場合「要求本文最大サイズ」の上限値まで要求本文の内容が検査されます。さらにサイズの上限に合致している場合は WAF でブロックされます。アクセス ログより HTTP ステータス コード 403 が返され、ブロックされたことが確認できました。 + +![](./appgw-waf-body-file-size/11.png) + +WAF 側のログでは要求本文の長さ (サイズ)が上限を超過したためブロックしたことを示すログが記録されていました。 + +![](./appgw-waf-body-file-size/10.png) + + +### 「要求本文の検査を適用する」を無効にする + +![](./appgw-waf-body-file-size/06.png) + +要求本文の検査を無効に指定しているので、要求本文に含まれる内容に対して WAF の評価はされません。アクセス ログより HTTP ステータス コード 200 が返されたことが確認できました。 + +![](./appgw-waf-body-file-size/07.png) + +> [!NOTE] +> 要求本文の検査を無効（②の項番）にしている状態でも、要求本文の最大サイズ指定（⑤の項番）を有効としている場合はその設定は有効です。つまり以下のように設定している場合、要求本文の内容は WAF で評価されませんが、要求本文のサイズが 8 KB より大きい場合は WAF で評価されブロックされます。 +>![](./appgw-waf-body-file-size/08.png) + + +### Application Gateway V2 側の制限値によってブロックされた場合の動作 +番外編として、Application Gateway V2 自体のサイズ上限値に合致した場合はどのような動作となるかも確認しました。 +設定値はすべて無効に指定します。 + +>![](./appgw-waf-body-file-size/13.png) + +要求本文のサイズを Application Gateway V2 の上限である 4 GB よりも大きくしてリクエストを送信したところ、アクセス ログより HTTP ステータス コード 413 が返されることが確認できました。この時 WAF 側のログには何も記録はありません。また、ファイル アップロードサイズでも同じ動作が確認できました。 + +>![](./appgw-waf-body-file-size/14.png) + +Application Gateway V2 の上限に合致した場合は HTTP ステータス コード 403 ではなく 413 となることが確認できました。 +本ブログ記事の内容が皆様のお役に少しでも立てましたら幸いです。 + + +### 参考情報 +- [Web Application Firewall の要求とファイル アップロードのサイズ制限](https://learn.microsoft.com/ja-jp/azure/web-application-firewall/ag/application-gateway-waf-request-size-limits) +- [Application Gateway の制限](https://learn.microsoft.com/ja-jp/azure/azure-resource-manager/management/azure-subscription-service-limits#application-gateway-limits) + + + + + diff --git a/articles/network/appgw-waf-body-file-size/01.png b/articles/network/appgw-waf-body-file-size/01.png new file mode 100644 index 0000000000..05d46a45c7 Binary files /dev/null and b/articles/network/appgw-waf-body-file-size/01.png differ diff --git a/articles/network/appgw-waf-body-file-size/02.png b/articles/network/appgw-waf-body-file-size/02.png new file mode 100644 index 0000000000..967c469a35 Binary files /dev/null and b/articles/network/appgw-waf-body-file-size/02.png differ diff --git a/articles/network/appgw-waf-body-file-size/03.png b/articles/network/appgw-waf-body-file-size/03.png new file mode 100644 index 0000000000..cd29647e28 Binary files /dev/null and b/articles/network/appgw-waf-body-file-size/03.png differ diff --git a/articles/network/appgw-waf-body-file-size/04.png b/articles/network/appgw-waf-body-file-size/04.png new file mode 100644 index 0000000000..c356abc9f9 Binary files /dev/null and b/articles/network/appgw-waf-body-file-size/04.png differ diff --git a/articles/network/appgw-waf-body-file-size/05.png b/articles/network/appgw-waf-body-file-size/05.png new file mode 100644 index 0000000000..81a2afb336 Binary files /dev/null and b/articles/network/appgw-waf-body-file-size/05.png differ diff --git a/articles/network/appgw-waf-body-file-size/06.png b/articles/network/appgw-waf-body-file-size/06.png new file mode 100644 index 0000000000..dbf402787e Binary files /dev/null and b/articles/network/appgw-waf-body-file-size/06.png differ diff --git a/articles/network/appgw-waf-body-file-size/07.png b/articles/network/appgw-waf-body-file-size/07.png new file mode 100644 index 0000000000..126b92022d Binary files /dev/null and b/articles/network/appgw-waf-body-file-size/07.png differ diff --git a/articles/network/appgw-waf-body-file-size/08.png b/articles/network/appgw-waf-body-file-size/08.png new file mode 100644 index 0000000000..76c74bddfc Binary files /dev/null and b/articles/network/appgw-waf-body-file-size/08.png differ diff --git a/articles/network/appgw-waf-body-file-size/09.png b/articles/network/appgw-waf-body-file-size/09.png new file mode 100644 index 0000000000..65ade76fb8 Binary files /dev/null and b/articles/network/appgw-waf-body-file-size/09.png differ diff --git a/articles/network/appgw-waf-body-file-size/10.png b/articles/network/appgw-waf-body-file-size/10.png new file mode 100644 index 0000000000..2a187802ae Binary files /dev/null and b/articles/network/appgw-waf-body-file-size/10.png differ diff --git a/articles/network/appgw-waf-body-file-size/11.png b/articles/network/appgw-waf-body-file-size/11.png new file mode 100644 index 0000000000..974334e23e Binary files /dev/null and b/articles/network/appgw-waf-body-file-size/11.png differ diff --git a/articles/network/appgw-waf-body-file-size/12.png b/articles/network/appgw-waf-body-file-size/12.png new file mode 100644 index 0000000000..89a050e4b6 Binary files /dev/null and b/articles/network/appgw-waf-body-file-size/12.png differ diff --git a/articles/network/appgw-waf-body-file-size/13.png b/articles/network/appgw-waf-body-file-size/13.png new file mode 100644 index 0000000000..c1bc21c727 Binary files /dev/null and b/articles/network/appgw-waf-body-file-size/13.png differ diff --git a/articles/network/appgw-waf-body-file-size/14.png b/articles/network/appgw-waf-body-file-size/14.png new file mode 100644 index 0000000000..1bd1c353ab Binary files /dev/null and b/articles/network/appgw-waf-body-file-size/14.png differ diff --git a/articles/network/appgw-waf-body-file-size/15.png b/articles/network/appgw-waf-body-file-size/15.png new file mode 100644 index 0000000000..7eae31d814 Binary files /dev/null and b/articles/network/appgw-waf-body-file-size/15.png differ