Add the Bot Control managed rule group to your web ACL Rules array: set VendorName to AWS, Name to AWSManagedRulesBotControlRuleSet, and Priority to a number evaluated after your allow-list rules but before other managed groups.
In ManagedRuleGroupStatement, include a ManagedRuleGroupConfigs entry with AWSManagedRulesBotControlRuleSet configuration: set InspectionLevel to COMMON (lower cost, detects self-identifying bots) or TARGETED (higher cost, includes ML-based detection of sophisticated bots).
The TARGETED inspection level includes rules prefixed TGT_ML_ that use machine learning to detect distributed coordinated bot activity; machine learning is enabled by default but can be disabled by setting EnableMachineLearning to false in the config.
Bot Control adds labels to matched requests (for example awswaf:managed:aws:bot-control:bot:category:scraper); you can match these labels in downstream rules using LabelMatchStatement to apply custom actions to specific bot categories without changing the Bot Control rule group's default actions.
Start by overriding all Bot Control rule actions to Count using RuleActionOverrides on each rule name; review the sampled requests and labels in the AWS WAF console for at least one week before switching rules to Block.
Enable the web ACL's VisibilityConfig with SampledRequestsEnabled=true and publish metrics to CloudWatch; create alarms on the CountedRequests metric filtered to Bot Control rule labels to track bot volume trends.
Known gotchas
Bot Control TARGETED inspection incurs additional per-request charges beyond standard AWS WAF pricing; review AWS pricing documentation before enabling TARGETED on high-traffic endpoints to estimate costs.
AWS WAF Bot Control Bot Management supports Web Bot Authentication (WBA) for identifying legitimate AI agents and crawlers cryptographically, available in AWSManagedRulesBotControlRuleSet version 4.0 and later; enable this if you want verified AI agents to bypass bot challenges without being blocked.
The Bot Control rule group must be placed in the web ACL before any rules that might block requests based on IP reputation alone; Bot Control labels are applied during evaluation and consumed by later rules, so order matters.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp