Microsoft.Network ApplicationGatewayWebApplicationFirewallPolicies 2019-08-01

[アーティクル]
12/20/2024

Bicep リソース定義

ApplicationGatewayWebApplicationFirewallPolicies リソースの種類は、次をターゲットとする操作と共にデプロイできます。

リソースグループの - リソースグループのデプロイコマンド参照

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies リソースを作成するには、次の Bicep をテンプレートに追加します。

resource symbolicname 'Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies@2019-08-01' = {
  etag: 'string'
  location: 'string'
  name: 'string'
  properties: {
    customRules: [
      {
        action: 'string'
        matchConditions: [
          {
            matchValues: [
              'string'
            ]
            matchVariables: [
              {
                selector: 'string'
                variableName: 'string'
              }
            ]
            negationConditon: bool
            operator: 'string'
            transforms: [
              'string'
            ]
          }
        ]
        name: 'string'
        priority: int
        ruleType: 'string'
      }
    ]
    managedRules: {
      exclusions: [
        {
          matchVariable: 'string'
          selector: 'string'
          selectorMatchOperator: 'string'
        }
      ]
      managedRuleSets: [
        {
          ruleGroupOverrides: [
            {
              ruleGroupName: 'string'
              rules: [
                {
                  ruleId: 'string'
                  state: 'string'
                }
              ]
            }
          ]
          ruleSetType: 'string'
          ruleSetVersion: 'string'
        }
      ]
    }
    policySettings: {
      fileUploadLimitInMb: int
      maxRequestBodySizeInKb: int
      mode: 'string'
      requestBodyCheck: bool
      state: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

プロパティ値

ManagedRuleGroupOverride

名前	形容	価値
ruleGroupName	オーバーライドするマネージドルールグループについて説明します。	string (必須)
準則	無効になるルールの一覧。何も指定しない場合、グループ内のすべてのルールが無効になります。	ManagedRuleOverride[]

ManagedRuleOverride

名前	形容	価値
ruleId	マネージドルールの識別子。	string (必須)
状態	マネージドルールの状態について説明します。指定しない場合、既定値は [無効] になります。	'Disabled'

ManagedRulesDefinition

名前	形容	価値
除外	ポリシーに適用される除外について説明します。	OwaspCrsExclusionEntry[]
managedRuleSets	ポリシーに関連付けられている ruleSet について説明します。	ManagedRuleSet[] (必須)

ManagedRuleSet

名前	形容	価値
ruleGroupOverrides	ルールセットに適用するルールグループのオーバーライドを定義します。	ManagedRuleGroupOverride[]
ruleSetType	使用するルールセットの種類を定義します。	string (必須)
ruleSetVersion	使用するルールセットのバージョンを定義します。	string (必須)

MatchCondition

名前	形容	価値
matchValues	一致する値。	string[] (必須)
matchVariables	一致変数の一覧。	MatchVariable[] (必須)
negationConditon	これが否定条件かどうかを説明します。	bool
演算子	照合する演算子について説明します。	'BeginsWith' 'Contains' 'EndsWith' 'Equal' 'GreaterThan' 'GreaterThanOrEqual' 'IPMatch' 'LessThan' 'LessThanOrEqual' 'Regex' (必須)
変換	変換の一覧。	次のいずれかを含む文字列配列: 'HtmlEntityDecode' '小文字' 'RemoveNulls' 'Trim' 'UrlDecode' 'UrlEncode'

MatchVariable

名前	形容	価値
セレクタ	matchVariable コレクションのフィールドについて説明します。	糸
variableName	変数に一致します。	'PostArgs' 'QueryString' 'RemoteAddr' 'RequestBody' 'RequestCookies' 'RequestHeaders' 'RequestMethod' 'RequestUri' (必須)

Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies

名前	形容	価値
etag	リソースが更新されるたびに変更される一意の読み取り専用文字列。	糸
場所	リソースの場所。	糸
名前	リソース名	糸制約：最大長 = (必須)
プロパティ	Web アプリケーションファイアウォールポリシーのプロパティ。	WebApplicationFirewallPolicyPropertiesFormat
タグ	リソースタグ	タグ名と値のディクショナリ。テンプレートのタグを参照してください

OwaspCrsExclusionEntry

名前	形容	価値
matchVariable	除外する変数。	'RequestArgNames' 'RequestCookieNames' 'RequestHeaderNames' (必須)
セレクタ	matchVariable がコレクションの場合、この除外が適用されるコレクション内の要素を指定するために使用される演算子。	string (必須)
selectorMatchOperator	matchVariable がコレクションの場合は、セレクターを操作して、この除外が適用されるコレクション内の要素を指定します。	'Contains' 'EndsWith' 'Equals' 'EqualsAny' 'StartsWith' (必須)

PolicySettings

名前	形容	価値
fileUploadLimitInMb	WAF の最大ファイルアップロードサイズ (MB)。	int 制約：最小値 = 0
maxRequestBodySizeInKb	WAF の要求本文の最大サイズ (Kb 単位)。	int 制約：最小値 = 8 最大値 = 128
モード	ポリシーレベルで検出モードか防止モードかについて説明します。	'Detection' '防止'
requestBodyCheck	WAF で要求本文の確認を許可するかどうかを指定します。	bool
状態	ポリシーが有効な状態か無効状態かについて説明します。	'Disabled' 'Enabled'

ResourceTags

名前	形容	価値

WebApplicationFirewallCustomRule

名前	形容	価値
アクション	アクションの種類。	'Allow' 'Block' 'Log' (必須)
matchConditions	一致条件の一覧。	MatchCondition[] (必須)
名前	ポリシー内で一意であるリソースの名前。この名前は、リソースへのアクセスに使用できます。	糸制約：最大長 =
優先権	ルールの優先順位について説明します。値が小さいルールは、値が大きいルールの前に評価されます。	int (必須)
ruleType	ルールの種類について説明します。	'Invalid' 'MatchRule' (必須)

WebApplicationFirewallPolicyPropertiesFormat

名前	形容	価値
customRules	ポリシー内のカスタム規則について説明します。	WebApplicationFirewallCustomRule[]
managedRules	managedRules 構造体について説明します	ManagedRulesDefinition の (必須)
policySettings	ポリシーの policySettings について説明します。	PolicySettings

クイックスタートのサンプル

次のクイックスタートサンプルでは、このリソースの種類をデプロイします。

Bicep ファイル	形容
NAT ゲートウェイと Application Gateway を使用して AKS クラスターをする	このサンプルでは、送信接続用の NAT ゲートウェイと受信接続用の Application Gateway を使用して AKS クラスターをデプロイする方法を示します。
Application Gateway イングレスコントローラーを使用して AKS クラスターをする	このサンプルでは、Application Gateway、Application Gateway イングレスコントローラー、Azure Container Registry、Log Analytics、Key Vault を使用して AKS クラスターをデプロイする方法を示します
WAF とファイアウォールポリシーを使用した Application Gateway の	このテンプレートは、ファイアウォールポリシーと共に WAF が構成された Application Gateway を作成します
Azure Application Gateway で Azure WAF v2 を作成する	このテンプレートでは、バックエンドプールに 2 つの Windows Server 2016 サーバーを含む Azure Application Gateway 上に Azure Web Application Firewall v2 を作成します
Front Door Standard/Premium と Application Gateway の配信元	このテンプレートは、Front Door Standard/Premium インスタンスと Application Gateway インスタンスを作成し、NSG と WAF ポリシーを使用して、トラフィックが Front Door の配信元を通過したことを検証します。
コンテナーインスタンスと Application Gateway を使用した Front Door の	このテンプレートは、コンテナーグループと Application Gateway を使用して Front Door Standard/Premium を作成します。

ARM テンプレートリソース定義

ApplicationGatewayWebApplicationFirewallPolicies リソースの種類は、次をターゲットとする操作と共にデプロイできます。

リソースグループの - リソースグループのデプロイコマンド参照

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies リソースを作成するには、次の JSON をテンプレートに追加します。

{
  "type": "Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies",
  "apiVersion": "2019-08-01",
  "name": "string",
  "etag": "string",
  "location": "string",
  "properties": {
    "customRules": [
      {
        "action": "string",
        "matchConditions": [
          {
            "matchValues": [ "string" ],
            "matchVariables": [
              {
                "selector": "string",
                "variableName": "string"
              }
            ],
            "negationConditon": "bool",
            "operator": "string",
            "transforms": [ "string" ]
          }
        ],
        "name": "string",
        "priority": "int",
        "ruleType": "string"
      }
    ],
    "managedRules": {
      "exclusions": [
        {
          "matchVariable": "string",
          "selector": "string",
          "selectorMatchOperator": "string"
        }
      ],
      "managedRuleSets": [
        {
          "ruleGroupOverrides": [
            {
              "ruleGroupName": "string",
              "rules": [
                {
                  "ruleId": "string",
                  "state": "string"
                }
              ]
            }
          ],
          "ruleSetType": "string",
          "ruleSetVersion": "string"
        }
      ]
    },
    "policySettings": {
      "fileUploadLimitInMb": "int",
      "maxRequestBodySizeInKb": "int",
      "mode": "string",
      "requestBodyCheck": "bool",
      "state": "string"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

プロパティ値

ManagedRuleGroupOverride

名前	形容	価値
ruleGroupName	オーバーライドするマネージドルールグループについて説明します。	string (必須)
準則	無効になるルールの一覧。何も指定しない場合、グループ内のすべてのルールが無効になります。	ManagedRuleOverride[]

ManagedRuleOverride

名前	形容	価値
ruleId	マネージドルールの識別子。	string (必須)
状態	マネージドルールの状態について説明します。指定しない場合、既定値は [無効] になります。	'Disabled'

ManagedRulesDefinition

名前	形容	価値
除外	ポリシーに適用される除外について説明します。	OwaspCrsExclusionEntry[]
managedRuleSets	ポリシーに関連付けられている ruleSet について説明します。	ManagedRuleSet[] (必須)

ManagedRuleSet

名前	形容	価値
ruleGroupOverrides	ルールセットに適用するルールグループのオーバーライドを定義します。	ManagedRuleGroupOverride[]
ruleSetType	使用するルールセットの種類を定義します。	string (必須)
ruleSetVersion	使用するルールセットのバージョンを定義します。	string (必須)

MatchCondition

名前	形容	価値
matchValues	一致する値。	string[] (必須)
matchVariables	一致変数の一覧。	MatchVariable[] (必須)
negationConditon	これが否定条件かどうかを説明します。	bool
演算子	照合する演算子について説明します。	'BeginsWith' 'Contains' 'EndsWith' 'Equal' 'GreaterThan' 'GreaterThanOrEqual' 'IPMatch' 'LessThan' 'LessThanOrEqual' 'Regex' (必須)
変換	変換の一覧。	次のいずれかを含む文字列配列: 'HtmlEntityDecode' '小文字' 'RemoveNulls' 'Trim' 'UrlDecode' 'UrlEncode'

MatchVariable

名前	形容	価値
セレクタ	matchVariable コレクションのフィールドについて説明します。	糸
variableName	変数に一致します。	'PostArgs' 'QueryString' 'RemoteAddr' 'RequestBody' 'RequestCookies' 'RequestHeaders' 'RequestMethod' 'RequestUri' (必須)

Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies

名前	形容	価値
apiVersion	API のバージョン	'2019-08-01'
etag	リソースが更新されるたびに変更される一意の読み取り専用文字列。	糸
場所	リソースの場所。	糸
名前	リソース名	糸制約：最大長 = (必須)
プロパティ	Web アプリケーションファイアウォールポリシーのプロパティ。	WebApplicationFirewallPolicyPropertiesFormat
タグ	リソースタグ	タグ名と値のディクショナリ。テンプレートのタグを参照してください
種類	リソースの種類	'Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies'

OwaspCrsExclusionEntry

名前	形容	価値
matchVariable	除外する変数。	'RequestArgNames' 'RequestCookieNames' 'RequestHeaderNames' (必須)
セレクタ	matchVariable がコレクションの場合、この除外が適用されるコレクション内の要素を指定するために使用される演算子。	string (必須)
selectorMatchOperator	matchVariable がコレクションの場合は、セレクターを操作して、この除外が適用されるコレクション内の要素を指定します。	'Contains' 'EndsWith' 'Equals' 'EqualsAny' 'StartsWith' (必須)

PolicySettings

名前	形容	価値
fileUploadLimitInMb	WAF の最大ファイルアップロードサイズ (MB)。	int 制約：最小値 = 0
maxRequestBodySizeInKb	WAF の要求本文の最大サイズ (Kb 単位)。	int 制約：最小値 = 8 最大値 = 128
モード	ポリシーレベルで検出モードか防止モードかについて説明します。	'Detection' '防止'
requestBodyCheck	WAF で要求本文の確認を許可するかどうかを指定します。	bool
状態	ポリシーが有効な状態か無効状態かについて説明します。	'Disabled' 'Enabled'

ResourceTags

名前	形容	価値

WebApplicationFirewallCustomRule

名前	形容	価値
アクション	アクションの種類。	'Allow' 'Block' 'Log' (必須)
matchConditions	一致条件の一覧。	MatchCondition[] (必須)
名前	ポリシー内で一意であるリソースの名前。この名前は、リソースへのアクセスに使用できます。	糸制約：最大長 =
優先権	ルールの優先順位について説明します。値が小さいルールは、値が大きいルールの前に評価されます。	int (必須)
ruleType	ルールの種類について説明します。	'Invalid' 'MatchRule' (必須)

WebApplicationFirewallPolicyPropertiesFormat

名前	形容	価値
customRules	ポリシー内のカスタム規則について説明します。	WebApplicationFirewallCustomRule[]
managedRules	managedRules 構造体について説明します	ManagedRulesDefinition の (必須)
policySettings	ポリシーの policySettings について説明します。	PolicySettings

クイックスタートテンプレート

次のクイックスタートテンプレートでは、このリソースの種類をデプロイします。

テンプレート	形容
NAT ゲートウェイと Application Gateway を使用して AKS クラスターをする Azure にデプロイする	このサンプルでは、送信接続用の NAT ゲートウェイと受信接続用の Application Gateway を使用して AKS クラスターをデプロイする方法を示します。
Application Gateway イングレスコントローラーを使用して AKS クラスターをする Azure にデプロイする	このサンプルでは、Application Gateway、Application Gateway イングレスコントローラー、Azure Container Registry、Log Analytics、Key Vault を使用して AKS クラスターをデプロイする方法を示します
WAF とファイアウォールポリシーを使用した Application Gateway の Azure にデプロイする	このテンプレートは、ファイアウォールポリシーと共に WAF が構成された Application Gateway を作成します
Azure Application Gateway で Azure WAF v2 を作成する Azure にデプロイする	このテンプレートでは、バックエンドプールに 2 つの Windows Server 2016 サーバーを含む Azure Application Gateway 上に Azure Web Application Firewall v2 を作成します
Front Door Standard/Premium と Application Gateway の配信元 Azure にデプロイする	このテンプレートは、Front Door Standard/Premium インスタンスと Application Gateway インスタンスを作成し、NSG と WAF ポリシーを使用して、トラフィックが Front Door の配信元を通過したことを検証します。
コンテナーインスタンスと Application Gateway を使用した Front Door の Azure にデプロイする	このテンプレートは、コンテナーグループと Application Gateway を使用して Front Door Standard/Premium を作成します。

Terraform (AzAPI プロバイダー) リソース定義

ApplicationGatewayWebApplicationFirewallPolicies リソースの種類は、次をターゲットとする操作と共にデプロイできます。

リソースグループの

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies リソースを作成するには、次の Terraform をテンプレートに追加します。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies@2019-08-01"
  name = "string"
  etag = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      customRules = [
        {
          action = "string"
          matchConditions = [
            {
              matchValues = [
                "string"
              ]
              matchVariables = [
                {
                  selector = "string"
                  variableName = "string"
                }
              ]
              negationConditon = bool
              operator = "string"
              transforms = [
                "string"
              ]
            }
          ]
          name = "string"
          priority = int
          ruleType = "string"
        }
      ]
      managedRules = {
        exclusions = [
          {
            matchVariable = "string"
            selector = "string"
            selectorMatchOperator = "string"
          }
        ]
        managedRuleSets = [
          {
            ruleGroupOverrides = [
              {
                ruleGroupName = "string"
                rules = [
                  {
                    ruleId = "string"
                    state = "string"
                  }
                ]
              }
            ]
            ruleSetType = "string"
            ruleSetVersion = "string"
          }
        ]
      }
      policySettings = {
        fileUploadLimitInMb = int
        maxRequestBodySizeInKb = int
        mode = "string"
        requestBodyCheck = bool
        state = "string"
      }
    }
  })
}

プロパティ値

ManagedRuleGroupOverride

名前	形容	価値
ruleGroupName	オーバーライドするマネージドルールグループについて説明します。	string (必須)
準則	無効になるルールの一覧。何も指定しない場合、グループ内のすべてのルールが無効になります。	ManagedRuleOverride[]

ManagedRuleOverride

名前	形容	価値
ruleId	マネージドルールの識別子。	string (必須)
状態	マネージドルールの状態について説明します。指定しない場合、既定値は [無効] になります。	'Disabled'

ManagedRulesDefinition

名前	形容	価値
除外	ポリシーに適用される除外について説明します。	OwaspCrsExclusionEntry[]
managedRuleSets	ポリシーに関連付けられている ruleSet について説明します。	ManagedRuleSet[] (必須)

ManagedRuleSet

名前	形容	価値
ruleGroupOverrides	ルールセットに適用するルールグループのオーバーライドを定義します。	ManagedRuleGroupOverride[]
ruleSetType	使用するルールセットの種類を定義します。	string (必須)
ruleSetVersion	使用するルールセットのバージョンを定義します。	string (必須)

MatchCondition

名前	形容	価値
matchValues	一致する値。	string[] (必須)
matchVariables	一致変数の一覧。	MatchVariable[] (必須)
negationConditon	これが否定条件かどうかを説明します。	bool
演算子	照合する演算子について説明します。	'BeginsWith' 'Contains' 'EndsWith' 'Equal' 'GreaterThan' 'GreaterThanOrEqual' 'IPMatch' 'LessThan' 'LessThanOrEqual' 'Regex' (必須)
変換	変換の一覧。	次のいずれかを含む文字列配列: 'HtmlEntityDecode' '小文字' 'RemoveNulls' 'Trim' 'UrlDecode' 'UrlEncode'

MatchVariable

名前	形容	価値
セレクタ	matchVariable コレクションのフィールドについて説明します。	糸
variableName	変数に一致します。	'PostArgs' 'QueryString' 'RemoteAddr' 'RequestBody' 'RequestCookies' 'RequestHeaders' 'RequestMethod' 'RequestUri' (必須)

Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies

名前	形容	価値
etag	リソースが更新されるたびに変更される一意の読み取り専用文字列。	糸
場所	リソースの場所。	糸
名前	リソース名	糸制約：最大長 = (必須)
プロパティ	Web アプリケーションファイアウォールポリシーのプロパティ。	WebApplicationFirewallPolicyPropertiesFormat
タグ	リソースタグ	タグ名と値のディクショナリ。
種類	リソースの種類	"Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies@2019-08-01"

OwaspCrsExclusionEntry

名前	形容	価値
matchVariable	除外する変数。	'RequestArgNames' 'RequestCookieNames' 'RequestHeaderNames' (必須)
セレクタ	matchVariable がコレクションの場合、この除外が適用されるコレクション内の要素を指定するために使用される演算子。	string (必須)
selectorMatchOperator	matchVariable がコレクションの場合は、セレクターを操作して、この除外が適用されるコレクション内の要素を指定します。	'Contains' 'EndsWith' 'Equals' 'EqualsAny' 'StartsWith' (必須)

PolicySettings

名前	形容	価値
fileUploadLimitInMb	WAF の最大ファイルアップロードサイズ (MB)。	int 制約：最小値 = 0
maxRequestBodySizeInKb	WAF の要求本文の最大サイズ (Kb 単位)。	int 制約：最小値 = 8 最大値 = 128
モード	ポリシーレベルで検出モードか防止モードかについて説明します。	'Detection' '防止'
requestBodyCheck	WAF で要求本文の確認を許可するかどうかを指定します。	bool
状態	ポリシーが有効な状態か無効状態かについて説明します。	'Disabled' 'Enabled'

ResourceTags

名前	形容	価値

WebApplicationFirewallCustomRule

名前	形容	価値
アクション	アクションの種類。	'Allow' 'Block' 'Log' (必須)
matchConditions	一致条件の一覧。	MatchCondition[] (必須)
名前	ポリシー内で一意であるリソースの名前。この名前は、リソースへのアクセスに使用できます。	糸制約：最大長 =
優先権	ルールの優先順位について説明します。値が小さいルールは、値が大きいルールの前に評価されます。	int (必須)
ruleType	ルールの種類について説明します。	'Invalid' 'MatchRule' (必須)

WebApplicationFirewallPolicyPropertiesFormat

名前	形容	価値
customRules	ポリシー内のカスタム規則について説明します。	WebApplicationFirewallCustomRule[]
managedRules	managedRules 構造体について説明します	ManagedRulesDefinition の (必須)
policySettings	ポリシーの policySettings について説明します。	PolicySettings

次の方法で共有

Microsoft.Network ApplicationGatewayWebApplicationFirewallPolicies 2019-08-01

Bicep リソース定義

リソースの形式

プロパティ値

ManagedRuleGroupOverride

ManagedRuleOverride

ManagedRulesDefinition

ManagedRuleSet

MatchCondition

MatchVariable

Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies

OwaspCrsExclusionEntry

PolicySettings

ResourceTags

WebApplicationFirewallCustomRule

WebApplicationFirewallPolicyPropertiesFormat

クイック スタートのサンプル

ARM テンプレート リソース定義

リソースの形式

プロパティ値

ManagedRuleGroupOverride

ManagedRuleOverride

ManagedRulesDefinition

ManagedRuleSet

MatchCondition

MatchVariable

Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies

OwaspCrsExclusionEntry

PolicySettings

ResourceTags

WebApplicationFirewallCustomRule

WebApplicationFirewallPolicyPropertiesFormat

クイック スタート テンプレート

Terraform (AzAPI プロバイダー) リソース定義

リソースの形式

プロパティ値

ManagedRuleGroupOverride

ManagedRuleOverride

ManagedRulesDefinition

ManagedRuleSet

MatchCondition

MatchVariable

Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies

OwaspCrsExclusionEntry

PolicySettings

ResourceTags

WebApplicationFirewallCustomRule

WebApplicationFirewallPolicyPropertiesFormat

フィードバック

その他のリソース

クイックスタートのサンプル

ARM テンプレートリソース定義

クイックスタートテンプレート