AWS waf documentation change
Summary
Updated terminology from 'protection pack or web ACL' to 'protection pack (web ACL)' throughout the document, consolidating references and clarifying that these terms refer to the same entity. Removed redundant explanations about console experiences and simplified resource protection statements.
Security assessment
The changes are purely terminological and structural, with no indication of addressing a specific security vulnerability or weakness. The updates clarify naming conventions and documentation flow but do not introduce new security features or address disclosed risks.
Diff
diff --git a/waf/latest/developerguide/web-acl.md b/waf/latest/developerguide/web-acl.md index 20b3e90e2..06c1934a3 100644 --- a//waf/latest/developerguide/web-acl.md +++ b//waf/latest/developerguide/web-acl.md @@ -11 +11 @@ You can now use the updated experience to access AWS WAF functionality anywhere -This page explains what protection packs and web access control lists (web ACLs) are and how they work. +This page explains what protection packs (web ACLs) are and how they work. @@ -13 +13 @@ This page explains what protection packs and web access control lists (web ACLs) -A protection pack or web ACL performs essentially the same function. Both give you fine-grained control over all of the HTTP(S) web requests that your protected resource responds to. You can protect Amazon CloudFront, Amazon API Gateway, Application Load Balancer, AWS AppSync, Amazon Cognito, AWS App Runner, AWS Amplify, and AWS Verified Access resources. You use protection packs in the new console experience, and web ACLs in the standard console. For more information about the new console experience, see [Working with the updated console experience](./working-with-console.html). +A protection pack (web ACL) gives you fine-grained control over all of the HTTP(S) web requests that your protected resource responds to. You can protect Amazon CloudFront, Amazon API Gateway, Application Load Balancer, AWS AppSync, Amazon Cognito, AWS App Runner, AWS Amplify, and AWS Verified Access resources. @@ -32 +32 @@ You can also test for any combination of these conditions. You can block or coun -You provide your matching criteria and the action to take on matches in AWS WAF rule statements. You can define rule statements directly inside your protection pack or web ACL and in reusable rule groups that you use in your protection pack or web ACL. For a full list of the options, see [Using rule statements in AWS WAF](./waf-rule-statements.html) and [Using rule actions in AWS WAF](./waf-rule-action.html). +You provide your matching criteria and the action to take on matches in AWS WAF rule statements. You can define rule statements directly inside your protection pack (web ACL) and in reusable rule groups that you use in your protection pack (web ACL). For a full list of the options, see [Using rule statements in AWS WAF](./waf-rule-statements.html) and [Using rule actions in AWS WAF](./waf-rule-action.html). @@ -34 +34 @@ You provide your matching criteria and the action to take on matches in AWS WAF -When you create a protection pack or web ACL, you specify the types of resources that you want to use it with. For information, see [Creating a protection pack or web ACL in AWS WAF](./web-acl-creating.html). After you define a protection pack or web ACL, you can associate it with your resources to begin providing protection for them. For more information, see [Associating or disassociating protection with an AWS resource](./web-acl-associating-aws-resource.html). +When you create a protection pack (web ACL), you specify the types of resources that you want to use it with. For information, see [Creating a protection pack (web ACL) in AWS WAF](./web-acl-creating.html). After you define a protection pack (web ACL), you can associate it with your resources to begin providing protection for them. For more information, see [Associating or disassociating protection with an AWS resource](./web-acl-associating-aws-resource.html). @@ -42 +42 @@ On some occasions, AWS WAF might encounter an internal error that delays the res -Before you deploy changes in your protection pack or web ACL for production traffic, test and tune them in a staging or testing environment until you are comfortable with the potential impact to your traffic. Then test and tune your updated rules in count mode with your production traffic before enabling them. For guidance, see [Testing and tuning your AWS WAF protections](./web-acl-testing.html). +Before you deploy changes in your protection pack (web ACL) for production traffic, test and tune them in a staging or testing environment until you are comfortable with the potential impact to your traffic. Then test and tune your updated rules in count mode with your production traffic before enabling them. For guidance, see [Testing and tuning your AWS WAF protections](./web-acl-testing.html). @@ -46 +46 @@ Before you deploy changes in your protection pack or web ACL for production traf -Using more than 1,500 WCUs in a protection pack or web ACL incurs costs beyond the basic protection pack or web ACL price. For more information, see [Web ACL capacity units (WCUs) in AWS WAF](./aws-waf-capacity-units.html) and [AWS WAF Pricing](https://aws.amazon.com/waf/pricing/). +Using more than 1,500 WCUs in a protection pack (web ACL) incurs costs beyond the basic protection pack (web ACL) price. For more information, see [Web ACL capacity units (WCUs) in AWS WAF](./aws-waf-capacity-units.html) and [AWS WAF Pricing](https://aws.amazon.com/waf/pricing/). @@ -50 +50 @@ Using more than 1,500 WCUs in a protection pack or web ACL incurs costs beyond t -When you create or change a protection pack or web ACL or other AWS WAF resources, the changes take a small amount of time to propagate to all areas where the resources are stored. The propagation time can be from a few seconds to a number of minutes. +When you create or change a protection pack (web ACL) or other AWS WAF resources, the changes take a small amount of time to propagate to all areas where the resources are stored. The propagation time can be from a few seconds to a number of minutes. @@ -54 +54 @@ The following are examples of the temporary inconsistencies that you might notic - * After you create a protection pack or web ACL, if you try to associate it with a resource, you might get an exception indicating that the protection pack or web ACL is unavailable. + * After you create a protection pack (web ACL), if you try to associate it with a resource, you might get an exception indicating that the protection pack (web ACL) is unavailable. @@ -56 +56 @@ The following are examples of the temporary inconsistencies that you might notic - * After you add a rule group to a protection pack or web ACL, the new rule group rules might be in effect in one area where the protection pack or web ACL is used and not in another. + * After you add a rule group to a protection pack (web ACL), the new rule group rules might be in effect in one area where the protection pack (web ACL) is used and not in another. @@ -67 +67 @@ The following are examples of the temporary inconsistencies that you might notic - * [Creating a protection pack or web ACL in AWS WAF](./web-acl-creating.html) + * [Creating a protection pack (web ACL) in AWS WAF](./web-acl-creating.html) @@ -69 +69 @@ The following are examples of the temporary inconsistencies that you might notic - * [Editing a protection pack or web ACL in AWS WAF](./web-acl-editing.html) + * [Editing a protection pack (web ACL) in AWS WAF](./web-acl-editing.html) @@ -75 +75 @@ The following are examples of the temporary inconsistencies that you might notic - * [Using protection pack or web ACLs with rules and rule groups in AWS WAF](./web-acl-processing.html) + * [Using protection packs (web ACLs) with rules and rule groups in AWS WAF](./web-acl-processing.html) @@ -77 +77 @@ The following are examples of the temporary inconsistencies that you might notic - * [Setting the protection pack or web ACL default action in AWS WAF](./web-acl-default-action.html) + * [Setting the protection pack (web ACL) default action in AWS WAF](./web-acl-default-action.html) @@ -85 +85 @@ The following are examples of the temporary inconsistencies that you might notic - * [Deleting a protection pack or web ACL](./web-acl-deleting.html) + * [Deleting a protection pack (web ACL)](./web-acl-deleting.html) @@ -98 +98 @@ Working with the updated console experience -Creating a protection pack or web ACL +Creating a protection pack (web ACL)