AutoGineer summary
Written by AutoGineer from the skill’s own files, not by the author
This skill acts as a central router for configuring AWS WAF to secure web applications and APIs. It provides structured procedures for creating web ACLs, managing rule sets, implementing bot and fraud control, and configuring logging. The skill emphasizes a secure-by-design approach, requiring logging to be enabled before tuning and enforcing strict header-stripping to prevent spoofing. It covers the full lifecycle of WAF management, from initial setup and association with resources like CloudFront and ALB to advanced mitigation strategies for volumetric abuse and credential stuffing.
What it does
- Creates and associates web ACLs with CloudFront, ALB, API Gateway, and AppSync.
- Configures AWS Managed Rules, rate-based rules, and custom IP or geographic match rules.
- Implements Bot Control and Fraud Control to prevent account takeover and fake-account creation.
- Provides workflows for logging, request sampling, and tuning rules in Count mode.
- Enforces security best practices like header stripping and least-privilege IAM.
- Routes users to specific, self-contained procedures for complex WAF tasks.
When to use it
- When you need to protect a web application or API from layer 7 exploits and HTTP floods.
- When implementing bot detection or fraud prevention for login and signup endpoints.
- When you need to tune managed rules to reduce false positives without blocking legitimate traffic.
- When you need to recover the real client IP or secure forwarded headers behind a CDN.
- When you need to manage AI and LLM crawler traffic.
Advantages
- Reduces risk of misconfiguration by enforcing a logical, step-by-step tuning workflow.
- Prevents accidental blocking of legitimate traffic through mandatory Count-mode tuning.
- Ensures security consistency by mandating header-stripping when forwarding signals.
- Provides clear guidance on WCU budget management and rule group selection.
- Centralizes complex WAF procedures into a single, reliable reference source.
Usage examples
- “How do I set up AWS WAF to block HTTP floods on my Application Load Balancer?”
- The agent will guide you through creating a regional web ACL, associating it with your ALB, and configuring a rate-based rule to throttle requests based on IP or session token.
- “I am seeing false positives from the Core Rule Set. How do I fix this?”
- The agent will instruct you to check your WAF logs to identify the specific rule ID triggering the block, then use the RuleActionOverrides feature to set that specific rule to Count mode.
- “How can I protect my login page from credential stuffing?”
- The agent will guide you through enabling Fraud Control (Account Takeover Prevention) and configuring the necessary logging and signal-forwarding rules.
- “I need to allow traffic only from specific countries. What is the procedure?”
- The agent will provide the steps to create a geographic match rule and configure the web ACL's default action to block traffic outside of your allowed list.
Install
Download the skill as a ZIP:
https://autogineer.com/agent-skills/aws/waf/downloadUnzip it into the cross-client skills folder of your project:
mkdir -p .agents/skills && unzip waf.zip -d .agents/skills
Documentation by AWS
AWS WAF
Overview
Domain expertise for configuring AWS WAF, the web application firewall that filters HTTP and HTTPS traffic to CloudFront distributions, Application Load Balancers, API Gateway REST APIs, and AppSync GraphQL APIs. Covers web ACL creation and association, AWS Managed Rules, rate-based rules, match rules (IP set and geographic), Bot Control and the signal-forwarding workflows built on top of it, Fraud Control for logins and signups, AI and LLM crawler management, and the logging that every tuning workflow depends on.
This skill is a router. Each customer task maps to a procedure file under references/. Read the
matching reference in full before acting, then follow its constraints and steps. The reference
files are self-contained: each carries its own decision tables, constraints, procedure, and
troubleshooting.
Execute commands using the AWS MCP server when connected (sandboxed execution, audit logging,
observability). Fall back to the AWS CLI otherwise. A web ACL's scope is fixed at creation: a
CloudFront web ACL must be created in us-east-1 with CLOUDFRONT scope, while a regional web ACL
(Application Load Balancer, API Gateway, AppSync) is created in the resource's Region with
REGIONAL scope.
Which WAF task do you need?
Routing notes
Logging comes before tuning. Every Count-mode tuning workflow assumes logging and request sampling are on. If the customer has not set up logging, run that reference first; otherwise Count-mode tuning has nothing to read.
Web ACL scope is fixed at creation. A CloudFront web ACL is
CLOUDFRONTscope inus-east-1; a regional resource needs aREGIONALweb ACL in its own Region. Scope cannot be changed later, so the creating reference settles it before anything is built.Bot Control is a chain, not one task. Protecting against bots is the on-ramp (turn on, choose Common vs Targeted, observe). Turning labels into a confidence signal, forwarding that signal, and deciding what the application does with it are three separate references that build on it in that order. The header-stripping reference is the mandatory safety companion whenever a signal is forwarded to the origin.
Common vs Targeted is not a soft choice. Common only catches self-identifying bots and known-bad IPs. For login, checkout, or any high-value endpoint facing evasive bots, Targeted with the application integration SDK is required. The bots reference pushes Targeted for real bot threats rather than presenting it as optional.
Rate limiting vs Fraud Control. Rate-based rules blunt volumetric HTTP floods. Credential stuffing and fake-account creation are account-based abuse that rate limiting misses; those go to the Fraud Control reference (ATP and ACFP), not the rate-based reference.
Forwarded headers need the strip rule. Any time the customer forwards a signal or the client IP to the origin in
x-amzn-waf-*headers, the inbound-header-stripping reference is required to prevent spoofing. The confidence-signal, interpolation, and client-IP references all point at it.What lives in other skills. L3/L4 DDoS protection and Shield cost-protection credits are the shieldadvanced skill. Multi-account WAF rollout is the firewallmanager skill. CloudFront and Application Load Balancer configuration are their own skills. This skill builds the WAF rules; it does not configure the resources it protects.
Security Considerations
AWS WAF is itself a security control, so misconfiguration directly weakens an application's defenses. Apply these across every reference:
Least-privilege IAM. You MUST grant only the specific
wafv2:actions a task needs (for examplewafv2:CreateWebACL,wafv2:GetWebACL,wafv2:UpdateWebACL,wafv2:AssociateWebACL,wafv2:PutLoggingConfiguration) rather thanwafv2:*or theAWSWAFFullAccessmanaged policy.Ephemeral credentials. You MUST use IAM roles with temporary credentials (such as an EC2 instance profile, SSO session, or
aws sts assume-role) rather than long-lived IAM user access keys when running these WAF CLI commands.Monitor configuration changes. You SHOULD enable AWS CloudTrail on
wafv2management events and set CloudWatch alarms on critical web ACL configuration changes (such asDeleteWebACLandUpdateWebACLrule removals) and on the web ACL'sBlockedRequestsandCountedRequestsmetrics, so rule changes and sudden spikes in blocked or counted traffic are detected.Misconfiguration opens access. A web ACL that is created but never associated, or one whose default action is left at
Allowwith no enforcing rules, filters nothing. You MUST confirm the web ACL is associated and that its posture matches the intended default (block vs allow) before reporting setup complete.Protect log destinations. Logs can capture credentials and session data. You MUST redact sensitive fields (such as the
authorizationheader andcookie) and MUST enable encryption at rest on the log destination (CloudWatch Logs, Amazon S3, or Amazon Data Firehose).Header-spoofing risk. Any
x-amzn-waf-*signal forwarded to the origin can be forged inbound. You MUST add the inbound-header-stripping rule whenever a signal or client IP is forwarded (see stripping-inbound-waf-headers-before-trusting-them).
Additional Resources
Files
- ATTRIBUTION.mdAdded by AutoGineer917 B
- LICENSELicence file added by AutoGineer9.9 KiB
- NOTICELicence file added by AutoGineer67 B
- SKILL.md8.6 KiB
- references/adaptive-mitigation-playbook-for-forwarded-signals.md8.9 KiB
- references/adding-managed-rules-and-tuning-with-count-mode.md10.1 KiB
- references/adding-rate-based-rules.md10.5 KiB
- references/creating-a-web-acl-and-associating-it-with-a-resource.md9.3 KiB
- references/forwarding-signals-with-dynamic-label-interpolation.md9.5 KiB
- references/protecting-against-bots-with-bot-control.md9.9 KiB
- references/protecting-logins-and-signups-with-fraud-control.md9.2 KiB
- references/recovering-the-real-client-ip-behind-a-cdn.md9.4 KiB
- references/seeing-and-managing-ai-crawler-traffic.md7.3 KiB
- references/setting-up-logging-and-request-sampling.md9.2 KiB
- references/stripping-inbound-waf-headers-before-trusting-them.md7.5 KiB
- references/turning-bot-control-labels-into-a-confidence-signal.md11.0 KiB
- references/using-ip-sets-and-geographic-match-rules.md8.5 KiB
references/protecting-logins-and-signups-with-fraud-control.md
Protecting Logins and Signups with Fraud Control
Overview
Domain expertise for AWS WAF Fraud Control: the Account Takeover Prevention (ATP) managed rule group for login protection and the Account Creation Fraud Prevention (ACFP) managed rule group for signup protection. Covers why rate limiting misses this abuse, the mandatory application integration SDK, the CloudFront-only limitation on response inspection and its workaround, and the Count-first tuning path.
Does not cover generic rate limiting (the rate-based reference) or bot detection (the bot references). Those are separate.
Execute commands using the AWS MCP server when connected (sandboxed execution, audit logging, observability). Fall back to the AWS CLI otherwise.
Table of Contents
Overview
Workflow
Decision: ATP, ACFP, or both
The SDK is mandatory
Response inspection is CloudFront only
Count mode first
Troubleshooting
Procedure
Security Considerations
Additional Resources
Workflow
To protect logins and signups end to end, follow the procedure exactly. See the Procedure section below.
The procedure covers:
Adding ATP for login protection, ACFP for signup protection, or both
Integrating the application integration SDK
Configuring request inspection (and response inspection where supported)
Running in Count mode, then mapping labels to actions
Decision: ATP, ACFP, or both
| Threat | Rule group |
|---|---|
| Credential stuffing against a login page | Account Takeover Prevention (ATP) |
| Fake-account creation against a signup page | Account Creation Fraud Prevention (ACFP) |
| Both | Add both rule groups |
Constraints:
You MUST reach for ATP and ACFP for account-based abuse rather than rate-based rules; the abuse is distributed and low-rate per source, so rate limiting misses it
You SHOULD configure the login path for ATP and both the registration page and creation paths for ACFP
The SDK is mandatory
Both rule groups rely on session tokens that the application integration SDK issues. Without it the protection is weak.
Constraints:
You MUST treat the application integration SDK as mandatory for ATP and ACFP, not optional
You SHOULD confirm the SDK is integrated before relying on these rule groups
Response inspection is CloudFront only
Response inspection (tracking login success and failure) is available only on web ACLs protecting CloudFront distributions.
Constraints:
You MUST tell the customer that on an Application Load Balancer the response-based rules such as
VolumetricIpFailedLoginResponseHighandVolumetricSessionFailedLoginResponseHighwill not fireYou SHOULD offer the workaround of putting CloudFront in front of the Application Load Balancer when response inspection is needed
Count mode first
Turning these rule groups straight to Block risks locking out real users on a busy login page.
Constraints:
You MUST run ATP and ACFP in Count mode first, review the labeled traffic, then map labels to actions before enforcing
Troubleshooting
Credential stuffing gets through despite a rate limit
Rate limiting misses distributed, low-rate account abuse. Add ATP (Decision: ATP, ACFP, or both).
Response-based rules never fire on an ALB
Response inspection is CloudFront only. Put CloudFront in front of the ALB (Response inspection is CloudFront only).
Protection is weak even with ATP enabled
The SDK is not integrated. Integrate it (The SDK is mandatory).
Procedure
Overview
This procedure adds ATP, ACFP, or both with the SDK, configures inspection, runs in Count, then maps labels to actions, and surfaces the console link.
Parameters
web_acl_name, web_acl_id, scope (required): Identify the web ACL.
rule_groups (required):
ATP,ACFP, or both.login_path (required for ATP): The login endpoint path.
registration_path and creation_path (required for ACFP): The signup paths.
Constraints for parameter acquisition:
You MUST ask for all required parameters upfront in a single prompt
You MUST confirm the application integration SDK is integrated and logging is on
Steps
1. Verify dependencies
Constraints:
You MUST confirm credentials with
aws sts get-caller-identityYou MUST confirm the SDK is integrated and logging and sampling are on
You SHOULD confirm whether the resource is CloudFront (response inspection) or an ALB (request inspection only)
2. Add the rule groups in Count mode
Constraints:
You MUST add ATP with the login path, and ACFP with both the registration and creation paths, configuring request inspection for the username, password, and (ACFP) email fields
You MUST configure response inspection only on a CloudFront web ACL
You MUST fetch the current
LockTokenbeforeupdate-web-acland pass the full rule setYou MUST preserve the web ACL's existing
DefaultActionfrom theget-web-aclresponse and pass it back as{default_action}; do not assumeAllow={}, since that would silently open all unmatched traffic on a web ACL whose default action isBlock. For example, adding ATP with request inspection on the login path:aws wafv2 get-web-acl --name {web_acl_name} --scope {scope} --id {web_acl_id} --region {region} aws wafv2 update-web-acl --name {web_acl_name} --scope {scope} --id {web_acl_id} \ --lock-token {lock_token} --default-action {default_action} \ --rules '[{"Name":"AWS-ATP","Priority":1,"Statement":{"ManagedRuleGroupStatement":{"VendorName":"AWS","Name":"AWSManagedRulesATPRuleSet","ManagedRuleGroupConfigs":[{"AWSManagedRulesATPRuleSet":{"LoginPath":"{login_path}","RequestInspection":{"PayloadType":"JSON","UsernameField":{"Identifier":"/username"},"PasswordField":{"Identifier":"/password"}}}}]}},"OverrideAction":{"Count":{}},"VisibilityConfig":{"SampledRequestsEnabled":true,"CloudWatchMetricsEnabled":true,"MetricName":"AWS-ATP"}}]' \ --visibility-config SampledRequestsEnabled=true,CloudWatchMetricsEnabled=true,MetricName={web_acl_name} \ --region {region}ACFP uses
AWSManagedRulesACFPRuleSetwithRegistrationPagePath,CreationPath, and its ownRequestInspection(including the email field); add aResponseInspectionblock only on a CloudFront web ACL
3. Review and map labels to actions
Constraints:
You MUST review the Count-mode labels (such as the compromised-credential label) before enforcing
You MUST map labels to actions and switch to enforcement once validated
4. Surface the console link
Constraints:
You MUST present the web ACL console link and tell the customer to confirm the Fraud Control rules and their actions:
https://us-east-1.console.aws.amazon.com/wafv2/homev2/web-acls?region={region}
Example
Example input
{
"web_acl_name": "example-cf-webacl",
"web_acl_id": "abc",
"scope": "CLOUDFRONT",
"rule_groups": ["ATP"],
"login_path": "/api/login"
}Example output
Confirmed the SDK is integrated and the resource is CloudFront, so response inspection is available.
Added ATP on /api/login with request and response inspection, in Count.
Reviewed labels, mapped the compromised-credential label to Block, then enforced.
Open the web ACL and confirm the Fraud Control rules:
https://us-east-1.console.aws.amazon.com/wafv2/homev2/web-acls?region=us-east-1Troubleshooting
Credential stuffing gets through
Rate limiting misses it. Add ATP (Step 2).
Response rules never fire on an ALB
Response inspection is CloudFront only. Front the ALB with CloudFront (Step 1).
Security Considerations
This procedure modifies a security control, so misconfiguration directly weakens the application's defenses.
Least-privilege IAM. You MUST grant only the specific
wafv2:actions a task needs (for examplewafv2:GetWebACLandwafv2:UpdateWebACL) rather thanwafv2:*or theAWSWAFFullAccessmanaged policy.Ephemeral credentials. You MUST use IAM roles with temporary credentials (such as an EC2 instance profile, SSO session, or
aws sts assume-role) rather than long-lived IAM user access keys when running these WAF CLI commands.Monitor configuration changes. You SHOULD enable AWS CloudTrail on
wafv2management events and set CloudWatch alarms on critical web ACL configuration changes (such asDeleteWebACLandUpdateWebACLrule removals) and on the web ACL'sBlockedRequestsandCountedRequestsmetrics, so rule changes and sudden spikes in blocked or counted traffic are detected.
Additional Resources
AWS WAF Fraud Control account takeover prevention (ATP) rule group (AWS WAF Developer Guide)
AWS WAF Fraud Control account creation fraud prevention (ACFP) rule group (AWS WAF Developer Guide)
ATP example: Response inspection configuration (AWS WAF Developer Guide)
Testing and tuning your AWS WAF protections (AWS WAF Developer Guide)
Requirements and compatibility
Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta
“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.
Needs: Needs an MCP server
Security
No issues found by our static scan· No issues found
A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.
Attribution and licence
- Published by
- AWS
- Publisher
- AWS (Official)
- Source
- aws/agent-toolkit-for-aws · skills/specialized-skills/networking-and-content-delivery-skills/waf · commit 0a218f8
- Licence
- Apache License 2.0 (redistribution allowed)
- LICENSE (added by AutoGineer from LICENSE)
- NOTICE (added by AutoGineer from NOTICE)
- ATTRIBUTION.md (written by AutoGineer)
- Synced
AutoGineer is not affiliated with or endorsed by AWS or AWS.
Download ZIP
The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download waf.zip