AWS::WAFv2::WebACL AllowAction

Specifies that AWS WAF should allow the request and optionally defines additional custom handling for the request.

This is used in the context of other settings, for example to specify values for a rule action or a web ACL default action.

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{
  "CustomRequestHandling" : CustomRequestHandling
}

YAML

  CustomRequestHandling: 
    CustomRequestHandling

Properties

CustomRequestHandling

Defines custom handling for the web request.

For information about customizing web requests and responses, see Customizing web requests and responses in AWS WAF in the AWS WAF Developer Guide.

Required: No

Type: CustomRequestHandling

Update requires: No interruption

Examples

Set an allow action

The following shows an example allow action specification.

YAML

Action:
  Allow: {}
         

JSON

"Action": {
  "Allow": {}
} 

Set an allow action with a custom request setting

The following shows an example allow action specification with custom request handling.

YAML

Allow:
  CustomRequestHandling:
    InsertHeaders:
      - Name: AllowActionHeader1Name
        Value: AllowActionHeader1Value
      - Name: AllowActionHeader2Name
        Value: AllowActionHeader2Value
         

JSON

"Allow": {
   "CustomRequestHandling": {
     "InsertHeaders": [
       {
         "Name": "AllowActionHeader1Name",
         "Value": "AllowActionHeader1Value"
       },
       {
         "Name": "AllowActionHeader2Name",
         "Value": "AllowActionHeader2Value"
       }
     ]
   }
}