AWS Security ChangesHomeSearch

AWS waf: Automatic WAF JavaScript SDK injection for CloudFront distributions

Service: waf · 2026-10-30 · Documentation medium

File: waf/latest/developerguide/cloudfront-waf-use-cases.md · Type: bot-protection

Summary

Adds a section explaining that CloudFront can automatically insert the AWS WAF JavaScript SDK into HTML responses for Bot Control targeted protection and Fraud Control managed rule groups, including multi-tenant distribution inheritance behavior.

Security assessment

Documents a security feature (automatic client-side SDK injection enabling Bot Control/Fraud Control signals) and its inheritance semantics for multi-tenant distributions. It is feature documentation, not a fix for a specific vulnerability.

Evidence

+The targeted protection level of Bot Control and the AWS WAF Fraud Control managed rule groups use client-side signals that the AWS WAF JavaScript SDK collects in the browser. Instead of adding the SDK script tag to your web pages, you can have CloudFront insert it into the HTML responses that your distributions return. This applies to the browser JavaScript SDK; mobile apps still require adding the mobile SDK to your app.

Diff

diff --git a/waf/latest/developerguide/cloudfront-waf-use-cases.md b/waf/latest/developerguide/cloudfront-waf-use-cases.md
index c319a5a..b1251c5 100644
--- a//waf/latest/developerguide/cloudfront-waf-use-cases.md
+++ b//waf/latest/developerguide/cloudfront-waf-use-cases.md
@@ -7 +7 @@
-Using AWS WAF with CloudFront custom error pagesUsing AWS WAF with CloudFront for applications running on your own HTTP serverChoosing the HTTP methods that CloudFront responds toLogging considerationsAdditional resources
+Automatic SDK integration for the AWS WAF JavaScript SDKUsing AWS WAF with CloudFront custom error pagesUsing AWS WAF with CloudFront for applications running on your own HTTP serverChoosing the HTTP methods that CloudFront responds toLogging considerationsAdditional resources
@@ -16,0 +17,8 @@ The following AWS WAF features work the same way for all CloudFront distribution
+## Automatic SDK integration for the AWS WAF JavaScript SDK
+
+The targeted protection level of Bot Control and the AWS WAF Fraud Control managed rule groups use client-side signals that the AWS WAF JavaScript SDK collects in the browser. Instead of adding the SDK script tag to your web pages, you can have CloudFront insert it into the HTML responses that your distributions return. This applies to the browser JavaScript SDK; mobile apps still require adding the mobile SDK to your app.
+
+For more information, see [Automatic SDK integration for CloudFront distributions](./waf-challenge-javascript-sdk-injection.html).
+
+For multi-tenant distributions, distribution tenants that inherit the multi-tenant distribution's protection pack (web ACL) also inherit its automatic SDK integration setting. Distribution tenants that have their own protection pack (web ACL) use the setting in that protection pack (web ACL) instead.
+