AWS cli medium security documentation change
Summary
Added documentation for new monetization features in AWS WAF including the 'Monetize' action and 'MonetizationConfig' parameter. This enables returning HTTP 402 responses requiring payment for access, with configuration options for cryptocurrency payments and pricing.
Security assessment
The change introduces a new security control mechanism where WAF can block requests that don't complete payment, acting as a terminating action. This provides explicit security documentation about payment-gated access control, blockchain payment configurations, and request blocking - all security-relevant features. The 'terminating action' nature and blocking capability constitute concrete security functionality.
Diff
diff --git a/cli/latest/reference/wafv2/update-web-acl.md b/cli/latest/reference/wafv2/update-web-acl.md index 77f01c797..1ff2e87ac 100644 --- a//cli/latest/reference/wafv2/update-web-acl.md +++ b//cli/latest/reference/wafv2/update-web-acl.md @@ -15 +15 @@ - * [AWS CLI 2.35.3 Command Reference](../../index.html) » + * [AWS CLI 2.35.5 Command Reference](../../index.html) » @@ -110,0 +111 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/wafv2- + [--monetization-config <value>] @@ -3562,0 +3564,16 @@ JSON Syntax: +>>>>>>> +>>>>>>> Monetize -> (structure) +>>>>>>> +>>>>>>>> Instructs WAF to return an HTTP 402 Payment Required response with a price manifest. The requesting client can complete payment and resubmit the request to gain access. This is a terminating action-requests that do not complete payment are blocked. This action is available only for web ACLs associated with Amazon CloudFront distributions and requires a `MonetizationConfig` on the web ACL. +>>>>>>>> +>>>>>>>> PriceMultiplier -> (string) +>>>>>>>> +>>>>>>>>> An integer multiplier applied to the base price defined in the web ACL’s `MonetizationConfig` . The effective price for the request is the base price multiplied by this value. Specify as a string. Valid values: 1 to 100. +>>>>>>>>> +>>>>>>>>> Constraints: +>>>>>>>>> +>>>>>>>>> * min: `1` +>>>>>>>>> * max: `3` +>>>>>>>>> * pattern: `^([1-9][0-9]?|100)$` +>>>>>>>>> + @@ -7523,0 +7541,16 @@ JSON Syntax: +>>>>>>>>> +>>>>>>>>> Monetize -> (structure) +>>>>>>>>> +>>>>>>>>>> Instructs WAF to return an HTTP 402 Payment Required response with a price manifest. The requesting client can complete payment and resubmit the request to gain access. This is a terminating action-requests that do not complete payment are blocked. This action is available only for web ACLs associated with Amazon CloudFront distributions and requires a `MonetizationConfig` on the web ACL. +>>>>>>>>>> +>>>>>>>>>> PriceMultiplier -> (string) +>>>>>>>>>> +>>>>>>>>>>> An integer multiplier applied to the base price defined in the web ACL’s `MonetizationConfig` . The effective price for the request is the base price multiplied by this value. Specify as a string. Valid values: 1 to 100. +>>>>>>>>>>> +>>>>>>>>>>> Constraints: +>>>>>>>>>>> +>>>>>>>>>>> * min: `1` +>>>>>>>>>>> * max: `3` +>>>>>>>>>>> * pattern: `^([1-9][0-9]?|100)$` +>>>>>>>>>>> + @@ -10260,0 +10294,16 @@ JSON Syntax: +>>>>>>>>> +>>>>>>>>> Monetize -> (structure) +>>>>>>>>> +>>>>>>>>>> Instructs WAF to return an HTTP 402 Payment Required response with a price manifest. The requesting client can complete payment and resubmit the request to gain access. This is a terminating action-requests that do not complete payment are blocked. This action is available only for web ACLs associated with Amazon CloudFront distributions and requires a `MonetizationConfig` on the web ACL. +>>>>>>>>>> +>>>>>>>>>> PriceMultiplier -> (string) +>>>>>>>>>> +>>>>>>>>>>> An integer multiplier applied to the base price defined in the web ACL’s `MonetizationConfig` . The effective price for the request is the base price multiplied by this value. Specify as a string. Valid values: 1 to 100. +>>>>>>>>>>> +>>>>>>>>>>> Constraints: +>>>>>>>>>>> +>>>>>>>>>>> * min: `1` +>>>>>>>>>>> * max: `3` +>>>>>>>>>>> * pattern: `^([1-9][0-9]?|100)$` +>>>>>>>>>>> + @@ -14629,0 +14679,16 @@ JSON Syntax: +>>>>>>>>>> +>>>>>>>>>> Monetize -> (structure) +>>>>>>>>>> +>>>>>>>>>>> Instructs WAF to return an HTTP 402 Payment Required response with a price manifest. The requesting client can complete payment and resubmit the request to gain access. This is a terminating action-requests that do not complete payment are blocked. This action is available only for web ACLs associated with Amazon CloudFront distributions and requires a `MonetizationConfig` on the web ACL. +>>>>>>>>>>> +>>>>>>>>>>> PriceMultiplier -> (string) +>>>>>>>>>>> +>>>>>>>>>>>> An integer multiplier applied to the base price defined in the web ACL’s `MonetizationConfig` . The effective price for the request is the base price multiplied by this value. Specify as a string. Valid values: 1 to 100. +>>>>>>>>>>>> +>>>>>>>>>>>> Constraints: +>>>>>>>>>>>> +>>>>>>>>>>>> * min: `1` +>>>>>>>>>>>> * max: `3` +>>>>>>>>>>>> * pattern: `^([1-9][0-9]?|100)$` +>>>>>>>>>>>> + @@ -17366,0 +17432,16 @@ JSON Syntax: +>>>>>>>>>> +>>>>>>>>>> Monetize -> (structure) +>>>>>>>>>> +>>>>>>>>>>> Instructs WAF to return an HTTP 402 Payment Required response with a price manifest. The requesting client can complete payment and resubmit the request to gain access. This is a terminating action-requests that do not complete payment are blocked. This action is available only for web ACLs associated with Amazon CloudFront distributions and requires a `MonetizationConfig` on the web ACL. +>>>>>>>>>>> +>>>>>>>>>>> PriceMultiplier -> (string) +>>>>>>>>>>> +>>>>>>>>>>>> An integer multiplier applied to the base price defined in the web ACL’s `MonetizationConfig` . The effective price for the request is the base price multiplied by this value. Specify as a string. Valid values: 1 to 100. +>>>>>>>>>>>> +>>>>>>>>>>>> Constraints: +>>>>>>>>>>>> +>>>>>>>>>>>> * min: `1` +>>>>>>>>>>>> * max: `3` +>>>>>>>>>>>> * pattern: `^([1-9][0-9]?|100)$` +>>>>>>>>>>>> + @@ -21257,0 +21339,16 @@ JSON Syntax: +>>>>>>>>>> +>>>>>>>>>> Monetize -> (structure) +>>>>>>>>>> +>>>>>>>>>>> Instructs WAF to return an HTTP 402 Payment Required response with a price manifest. The requesting client can complete payment and resubmit the request to gain access. This is a terminating action-requests that do not complete payment are blocked. This action is available only for web ACLs associated with Amazon CloudFront distributions and requires a `MonetizationConfig` on the web ACL. +>>>>>>>>>>> +>>>>>>>>>>> PriceMultiplier -> (string) +>>>>>>>>>>> +>>>>>>>>>>>> An integer multiplier applied to the base price defined in the web ACL’s `MonetizationConfig` . The effective price for the request is the base price multiplied by this value. Specify as a string. Valid values: 1 to 100. +>>>>>>>>>>>> +>>>>>>>>>>>> Constraints: +>>>>>>>>>>>> +>>>>>>>>>>>> * min: `1` +>>>>>>>>>>>> * max: `3` +>>>>>>>>>>>> * pattern: `^([1-9][0-9]?|100)$` +>>>>>>>>>>>> + @@ -23994,0 +24092,16 @@ JSON Syntax: +>>>>>>>>>> +>>>>>>>>>> Monetize -> (structure) +>>>>>>>>>> +>>>>>>>>>>> Instructs WAF to return an HTTP 402 Payment Required response with a price manifest. The requesting client can complete payment and resubmit the request to gain access. This is a terminating action-requests that do not complete payment are blocked. This action is available only for web ACLs associated with Amazon CloudFront distributions and requires a `MonetizationConfig` on the web ACL. +>>>>>>>>>>> +>>>>>>>>>>> PriceMultiplier -> (string) +>>>>>>>>>>> +>>>>>>>>>>>> An integer multiplier applied to the base price defined in the web ACL’s `MonetizationConfig` . The effective price for the request is the base price multiplied by this value. Specify as a string. Valid values: 1 to 100. +>>>>>>>>>>>> +>>>>>>>>>>>> Constraints: +>>>>>>>>>>>> +>>>>>>>>>>>> * min: `1` +>>>>>>>>>>>> * max: `3` +>>>>>>>>>>>> * pattern: `^([1-9][0-9]?|100)$` +>>>>>>>>>>>> + @@ -27879,0 +27993,16 @@ JSON Syntax: +>>>>>>>>> +>>>>>>>>> Monetize -> (structure) +>>>>>>>>> +>>>>>>>>>> Instructs WAF to return an HTTP 402 Payment Required response with a price manifest. The requesting client can complete payment and resubmit the request to gain access. This is a terminating action-requests that do not complete payment are blocked. This action is available only for web ACLs associated with Amazon CloudFront distributions and requires a `MonetizationConfig` on the web ACL. +>>>>>>>>>> +>>>>>>>>>> PriceMultiplier -> (string) +>>>>>>>>>> +>>>>>>>>>>> An integer multiplier applied to the base price defined in the web ACL’s `MonetizationConfig` . The effective price for the request is the base price multiplied by this value. Specify as a string. Valid values: 1 to 100. +>>>>>>>>>>> +>>>>>>>>>>> Constraints: +>>>>>>>>>>> +>>>>>>>>>>> * min: `1` +>>>>>>>>>>> * max: `3` +>>>>>>>>>>> * pattern: `^([1-9][0-9]?|100)$` +>>>>>>>>>>> + @@ -30616,0 +30746,16 @@ JSON Syntax: +>>>>>>>>> +>>>>>>>>> Monetize -> (structure) +>>>>>>>>> +>>>>>>>>>> Instructs WAF to return an HTTP 402 Payment Required response with a price manifest. The requesting client can complete payment and resubmit the request to gain access. This is a terminating action-requests that do not complete payment are blocked. This action is available only for web ACLs associated with Amazon CloudFront distributions and requires a `MonetizationConfig` on the web ACL. +>>>>>>>>>> +>>>>>>>>>> PriceMultiplier -> (string) +>>>>>>>>>> +>>>>>>>>>>> An integer multiplier applied to the base price defined in the web ACL’s `MonetizationConfig` . The effective price for the request is the base price multiplied by this value. Specify as a string. Valid values: 1 to 100. +>>>>>>>>>>> +>>>>>>>>>>> Constraints: +>>>>>>>>>>> +>>>>>>>>>>> * min: `1` +>>>>>>>>>>> * max: `3` +>>>>>>>>>>> * pattern: `^([1-9][0-9]?|100)$` +>>>>>>>>>>> + @@ -34577,0 +34723,16 @@ JSON Syntax: +>>>>>>>>> +>>>>>>>>> Monetize -> (structure) +>>>>>>>>> +>>>>>>>>>> Instructs WAF to return an HTTP 402 Payment Required response with a price manifest. The requesting client can complete payment and resubmit the request to gain access. This is a terminating action-requests that do not complete payment are blocked. This action is available only for web ACLs associated with Amazon CloudFront distributions and requires a `MonetizationConfig` on the web ACL. +>>>>>>>>>> +>>>>>>>>>> PriceMultiplier -> (string) +>>>>>>>>>> +>>>>>>>>>>> An integer multiplier applied to the base price defined in the web ACL’s `MonetizationConfig` . The effective price for the request is the base price multiplied by this value. Specify as a string. Valid values: 1 to 100. +>>>>>>>>>>> +>>>>>>>>>>> Constraints: +>>>>>>>>>>> +>>>>>>>>>>> * min: `1` +>>>>>>>>>>> * max: `3` +>>>>>>>>>>> * pattern: `^([1-9][0-9]?|100)$` +>>>>>>>>>>> + @@ -37314,0 +37476,16 @@ JSON Syntax: +>>>>>>>>> +>>>>>>>>> Monetize -> (structure) +>>>>>>>>> +>>>>>>>>>> Instructs WAF to return an HTTP 402 Payment Required response with a price manifest. The requesting client can complete payment and resubmit the request to gain access. This is a terminating action-requests that do not complete payment are blocked. This action is available only for web ACLs associated with Amazon CloudFront distributions and requires a `MonetizationConfig` on the web ACL. +>>>>>>>>>> +>>>>>>>>>> PriceMultiplier -> (string) +>>>>>>>>>> +>>>>>>>>>>> An integer multiplier applied to the base price defined in the web ACL’s `MonetizationConfig` . The effective price for the request is the base price multiplied by this value. Specify as a string. Valid values: 1 to 100. +>>>>>>>>>>> +>>>>>>>>>>> Constraints: +>>>>>>>>>>> +>>>>>>>>>>> * min: `1` +>>>>>>>>>>> * max: `3` +>>>>>>>>>>> * pattern: `^([1-9][0-9]?|100)$` +>>>>>>>>>>> + @@ -39387,0 +39565,16 @@ JSON Syntax: +>>>>>>> +>>>>>>> Monetize -> (structure) +>>>>>>>