Shieldadvanced
AWSOfficialPublished by AWS
- Skill
- Tool integration
- Cloud and DevOps
- Apache-2.0
- No issues found
AutoGineer summary
Written by AutoGineer from the skill’s own files, not by the author
This skill provides domain expertise and procedural guidance for managing AWS Shield Advanced, the premium tier for DDoS protection on AWS. It acts as a central router to specific, self-contained reference procedures for subscribing accounts, protecting resources, enabling automatic application-layer mitigation, configuring health-based detection, managing Shield Response Team (SRT) support, reviewing DDoS events, and creating protection groups. The skill emphasizes the importance of defense-in-depth by integrating with AWS WAF and Route 53, while providing necessary security considerations for IAM roles and log management.
What it does
- Routes users to specific procedures for Shield Advanced configuration tasks.
- Guides the subscription process and addition of resources to Shield Advanced protection.
- Facilitates the setup of automatic layer 7 mitigation via AWS WAF integration.
- Configures health-based detection using Route 53 health checks to improve attack detection accuracy.
- Manages Shield Response Team (SRT) access and proactive engagement settings.
- Assists in reviewing DDoS events and requesting cost protection credits.
When to use it
- When you need to implement enhanced DDoS protection for internet-facing resources like CloudFront or ALBs.
- When you require expert assistance from the Shield Response Team during an active attack.
- When you need to recover costs associated with attack-driven scaling.
- When you want to tune detection sensitivity by grouping related resources.
- When you need to integrate health-based detection to reduce false positives.
Advantages
- Provides a structured, task-based approach to complex security configurations.
- Ensures security best practices by mandating audit logging and least-privilege access.
- Clarifies the distinction between detection-only features and active mitigation controls.
- Reduces configuration errors by providing specific constraints for each task.
- Centralizes guidance for both operational setup and post-event analysis.
Usage examples
- “How do I subscribe my AWS account to Shield Advanced?”
- The agent will route you to the specific reference procedure for subscribing and protecting resources, ensuring you follow the correct sequence of operations.
- “I want the Shield Response Team to help me during an attack.”
- The agent will guide you through setting up SRT support and proactive engagement, including the prerequisite of configuring a valid Route 53 health check.
- “How can I group my load balancers for better DDoS detection?”
- The agent will provide the procedure for creating a protection group and help you decide between sum, mean, or max aggregation based on your traffic topology.
- “Can I use Shield Advanced to automatically block layer 7 floods?”
- The agent will direct you to the procedure for enabling automatic application layer mitigation, which involves configuring AWS WAF rules to respond to detected threats.
Install
Download the skill as a ZIP:
https://autogineer.com/agent-skills/aws/shieldadvanced/downloadUnzip it into the cross-client skills folder of your project:
mkdir -p .agents/skills && unzip shieldadvanced.zip -d .agents/skills
Documentation by AWS
AWS Shield Advanced
Overview
Domain expertise for configuring AWS Shield Advanced, the paid tier that adds enhanced Distributed Denial of Service (DDoS) protection, automatic application layer mitigation, attack visibility, expert support, and cost protection on top of the always-on AWS Shield Standard. Covers subscribing and protecting resources, automatic application layer mitigation, health-based detection, Shield Response Team (SRT) access and proactive engagement, event review and cost protection credits, and protection groups.
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. Shield Advanced is a global service: its
control-plane API calls run in us-east-1, so pass --region us-east-1 on every aws shield
command.
Which Shield Advanced task do you need?
| Goal | Reference |
|---|---|
| Decide whether Shield Advanced is needed at all (vs Shield Standard + AWS WAF) | deciding between Shield Standard and Advanced |
| Subscribe an account and add resources to protection | subscribing to Shield Advanced and protecting resources |
| Respond to layer 7 floods automatically through AWS WAF | enabling automatic application layer mitigation |
| Feed resource health into detection with a Route 53 health check | configuring health-based detection |
| Get the Shield Response Team to act or reach out during an attack | setting up SRT support and proactive engagement |
| Review a DDoS event and recover attack-driven scaling charges | reviewing DDoS events and requesting cost protection |
| Treat related resources as one unit for detection | aggregating resources into protection groups |
Routing notes
Decide before you subscribe. Shield Advanced is a paid subscription that auto-renews on a one-year commitment. Before subscribing, confirm the customer actually needs it: Shield Standard (free, always on) plus AWS WAF rate-based rules and the AWS WAF Anti-DDoS managed rule group (
AWSManagedRulesAntiDDoSRuleSet) covers many layer 7 cases at lower cost. Route to the deciding reference first when the customer has not made that call; route to the waf skill for the WAF rules themselves.Subscribe and protect comes first. A subscription protects nothing on its own; resources have to be added explicitly. Every other task here assumes the resource is already subscribed and protected. Run the subscribing reference before any of the others if the customer is starting from scratch.
Automatic mitigation vs health-based detection. These are different controls and customers conflate them. Automatic application layer mitigation deploys AWS WAF rules during a layer 7 attack. Health-based detection feeds a Route 53 health check into Shield Advanced's detection so it reacts sooner. A customer can run either, both, or neither. Pick the reference that matches what they actually want.
Health check is also an SRT prerequisite. Proactive engagement (SRT reaching out) requires a Route 53 health check on the protected resource. If the customer wants proactive engagement, configuring health-based detection is the groundwork. The SRT reference points back to the health-based detection reference for that step.
Protection groups are detection-only. A protection group changes how Shield Advanced detects across a set of resources. It does not apply shared mitigation; automatic mitigation still works per resource. Use the protection-groups reference for detection tuning, not as a mitigation control.
WAF rules, health checks, and org rollout live elsewhere. Authoring the AWS WAF rules, the rate-based rule, or the web ACL is the waf skill. Creating the Route 53 health check is the route53 skill. Rolling Shield Advanced across an organization with Firewall Manager is the firewallmanager skill. This skill wires Shield Advanced to those pieces; it does not build them. AWS WAF is not optional alongside Shield Advanced: you SHOULD recommend an AWS WAF web ACL on every internet-facing protected resource (CloudFront distributions and Application Load Balancers) as defense in depth — Shield Advanced and AWS WAF are complementary layer 3/4 and layer 7 controls, and the rate-based rule that AWS WAF provides is also what cost protection requires.
Logging and monitoring
Visibility into both configuration changes and attack activity matters for every task here.
You SHOULD recommend enabling AWS CloudTrail so all Shield Advanced API calls (subscription, protection, SRT, and protection-group changes) are logged for audit purposes.
You SHOULD recommend enabling SSE-KMS encryption on the CloudTrail log bucket and CloudWatch Logs log group, since CloudTrail records sensitive API metadata (caller identities, resource ARNs, parameters) that must be encrypted at rest.
You SHOULD recommend CloudWatch alarms on Shield Advanced metrics (for example
DDoSDetectedandDDoSAttackBitsPerSecond) so operations staff are alerted when an event is detected.You SHOULD recommend encrypting any SNS topics used for those alarms with SSE-KMS, since the notifications carry sensitive event data.
You SHOULD recommend confirming that all SNS topic subscribers for Shield Advanced alarms are authorized personnel approved to receive sensitive DDoS event notifications.
Security considerations
Shield Advanced setup creates IAM trust relationships and exposes log data, so call out the risks and the controls that contain them.
SRT role is a third-party principal. Granting SRT access creates an IAM role that
drt.shield.amazonaws.comassumes to act in the account. Scope its trust policy with anaws:SourceAccountcondition equal to the account ID to prevent confused-deputy assumption, grant it only the actions it needs, and revoke it withdisassociate-drt-rolewhen no longer required.Log buckets shared with the SRT can leak data. AWS WAF and access logs capture request URIs, headers, and client IPs. Confirm those buckets have server-side encryption and carry no clear-text PII or secrets before sharing them with the SRT.
Least privilege for the operator. Scope the caller's IAM permissions to the minimum each procedure needs rather than broad Shield or administrator access.
Audit trail. Keep AWS CloudTrail enabled and logging
shield:*calls so every configuration change leaves a record.
Additional Resources
Files
- ATTRIBUTION.mdAdded by AutoGineer939 B
- LICENSELicence file added by AutoGineer9.9 KiB
- NOTICELicence file added by AutoGineer67 B
- SKILL.md8.6 KiB
- references/aggregating-resources-into-protection-groups.md11.9 KiB
- references/configuring-health-based-detection.md12.8 KiB
- references/deciding-between-shield-standard-and-advanced.md11.7 KiB
- references/enabling-automatic-application-layer-mitigation.md12.6 KiB
- references/reviewing-ddos-events-and-requesting-cost-protection.md12.2 KiB
- references/setting-up-srt-support-and-proactive-engagement.md13.1 KiB
- references/subscribing-to-shield-advanced-and-protecting-resources.md11.7 KiB
references/subscribing-to-shield-advanced-and-protecting-resources.md
Subscribing to Shield Advanced and Protecting Resources
Overview
Domain expertise for starting with AWS Shield Advanced: subscribing an account and then explicitly adding resources to protection. Covers the per-account subscription model, the consolidated billing rules customers most often ask about, the load-bearing fact that subscribing protects nothing on its own, and the auto-renewal and unsubscribe behavior that surprises customers later.
Does not cover automatic application layer mitigation, health-based detection, SRT setup, event review, or protection groups; those are separate references. Authoring AWS WAF rules is the waf skill. Rolling Shield Advanced out across an organization with Firewall Manager is the firewallmanager skill.
Execute commands using the AWS MCP server when connected (sandboxed execution, audit logging,
observability). Fall back to the AWS CLI otherwise. Shield Advanced control-plane calls run in
us-east-1; pass --region us-east-1 on every command.
Table of Contents
Overview
Workflow
Decision: which resource type to protect
Subscribing protects nothing on its own
Billing model
Auto-renewal and unsubscribe
Troubleshooting
Security considerations
Procedure
Additional Resources
Workflow
To subscribe and protect resources end to end, follow the procedure exactly. See the Procedure section below.
The procedure covers:
Subscribing the account that owns the resources to protect
Confirming the subscription is active
Adding each resource to protection by its ARN
Surfacing the console link to verify protected resources
Decision: which resource type to protect
| Resource type | Notes |
|---|---|
| CloudFront distribution | Protect here for web applications; also the place to protect an Application Load Balancer that sits behind CloudFront |
| Application Load Balancer | Protect at the load balancer when it is not behind CloudFront |
| Network Load Balancer | Protect through an attached Elastic IP address, not the load balancer directly |
| Elastic IP address | Protects the attached EC2 instance or Network Load Balancer |
| Global Accelerator standard accelerator | Protect the accelerator directly |
| Route 53 hosted zone | Protect the hosted zone directly; note it does not support health-based detection |
Constraints:
You MUST protect a Network Load Balancer or EC2 instance through an Elastic IP address where the resource model requires it, rather than expecting to protect the instance directly
You SHOULD protect at the CloudFront distribution when an Application Load Balancer sits behind CloudFront, since that is where edge mitigation applies
Subscribing protects nothing on its own
A subscription enables Shield Advanced for the account, but no resource is protected until it is added explicitly. Customers assume subscribing covers everything in the account and discover during or after an attack that nothing was protected.
Constraints:
You MUST treat adding resources as a required second step right after subscribing, not an optional follow-up
You MUST confirm at least one resource is protected before telling the customer they are covered
Billing model
The billing model is the most common Shield Advanced question and customers regularly overpay or hold back out of confusion about it.
Constraints:
You MUST explain that one subscription fee covers all subscribed accounts in the same AWS Organizations consolidated billing family, charged once to the payer account
You MUST tell the customer each account that owns protected resources still calls
create-subscriptionindividually, even though only one fee is chargedYou SHOULD note the payer account itself does not need to be subscribed, since billing routes to the payer regardless
You SHOULD state that the subscription includes standard AWS WAF costs (web ACL, rules, and request inspection up to 1,500 web ACL capacity units) for Shield-protected resources, while Bot Control, CAPTCHA, and usage above 1,500 web ACL capacity units are not included
You MUST NOT invent a dollar figure for the subscription fee; point the customer at the current Shield pricing page
Auto-renewal and unsubscribe
The subscription is a commitment that auto-renews, and there is no self-service unsubscribe. A customer who does not know this is surprised at renewal.
Constraints:
You MUST state before the customer subscribes that the subscription auto-renews by default and that fully unsubscribing requires contacting AWS Support
You SHOULD note auto-renewal can be disabled, but that disabling renewal is not the same as cancelling the current term
Troubleshooting
Subscribed but a resource is still unprotected
Subscribing does not protect anything. Add the resource with create-protection for its ARN
(Procedure).
create-protection fails with an invalid parameter
The resource may already be protected, or the ARN format is wrong (an Elastic IP address uses the
allocation-id ARN form). Confirm with list-protections and correct the ARN.
Customer fears duplicate monthly fees across accounts
One fee covers the whole consolidated billing family, charged to the payer. Each account still subscribes individually (Billing model).
A Network Load Balancer cannot be protected directly
Protect it through an attached Elastic IP address (Decision: which resource type to protect).
Security considerations
Subscribing and protecting resources commits the account to a billing term and changes account-wide protection, so call out the risks and the controls that contain them.
Least privilege for the operator. Scope the caller's IAM permissions to the minimum this procedure needs (
shield:CreateSubscription,shield:GetSubscriptionState,shield:CreateProtection,shield:ListProtections) rather than broad Shield or administrator access.Audit trail. Keep AWS CloudTrail enabled and logging
shield:*calls so every subscription and protection change leaves a record, and confirm the CloudTrail trail uses SSE-KMS encryption on its S3 log bucket and CloudWatch Logs log group, since CloudTrail records contain sensitive API metadata (caller identities, resource ARNs, parameters).The subscription auto-renews. The subscription auto-renews by default and fully unsubscribing requires contacting AWS Support; review the subscription's necessity periodically so the account is not committed beyond what it needs.
Role-based access control. Limit who can subscribe accounts and add protections to authorized personnel through role-based access control rather than granting it broadly.
Procedure
Overview
This procedure subscribes an account to Shield Advanced and adds one or more resources to protection, then surfaces the console link to verify coverage.
Parameters
account (required): The AWS account that owns the resources to protect. Each owning account must be subscribed.
resource_arns (required): The ARNs of the resources to protect (CloudFront distribution, Application Load Balancer, Network Load Balancer via Elastic IP, Elastic IP address, Global Accelerator accelerator, or Route 53 hosted zone).
protection_names (required): A descriptive name for each protection.
Constraints for parameter acquisition:
You MUST ask for all required parameters upfront in a single prompt
You MUST confirm each resource ARN exists and is owned by a subscribed account before protecting
Steps
1. Verify dependencies
Constraints:
You MUST confirm credentials with
aws sts get-caller-identityYou SHOULD use temporary credentials from an assumed IAM role (for example via IAM Identity Center or an instance profile) rather than long-lived IAM user access keys for these security-sensitive Shield Advanced operations
You MUST confirm the account owning the resources is the one being subscribed
You SHOULD scope the caller's IAM permissions to the minimum this procedure needs (
shield:CreateSubscription,shield:GetSubscriptionState,shield:CreateProtection,shield:ListProtections) rather than broad Shield or administrator accessYou SHOULD confirm AWS CloudTrail is enabled and logging
shield:*calls so every Shield Advanced configuration change leaves an audit trailYou SHOULD confirm the CloudTrail trail is configured with SSE-KMS encryption on its S3 log bucket and CloudWatch Logs log group, since CloudTrail records contain sensitive API metadata (caller identities, resource ARNs, parameters)
2. Subscribe the account
Constraints:
You MUST tell the customer the subscription auto-renews and that unsubscribing requires AWS Support before they commit
You MUST subscribe the account before adding any protection:
aws shield create-subscription --region us-east-1You MUST confirm the subscription is active:
aws shield get-subscription-state --region us-east-1
3. Add each resource to protection
Constraints:
You MUST create a protection for each resource ARN:
aws shield create-protection --name {protection_name} --resource-arn {resource_arn} --region us-east-1You MUST capture the
ProtectionIdfrom each responseYou MUST NOT consider the account protected until at least one protection exists
You SHOULD recommend associating an AWS WAF web ACL with every internet-facing protected resource (CloudFront distributions and Application Load Balancers) as defense in depth — Shield Advanced (layer 3/4) and AWS WAF (layer 7) are complementary, and a rate-based AWS WAF rule is also what cost protection eligibility later requires — and point to the waf skill to set it up
4. Confirm and surface the console link
Constraints:
You MUST list protections to confirm coverage:
aws shield list-protections --region us-east-1You MUST present the Shield protected-resources console link and tell the customer to open it and confirm the resources are listed as protected:
https://us-east-1.console.aws.amazon.com/wafv2/shieldv2#/protections
Example
Example input
{
"account": "111122223333",
"resource_arns": ["arn:aws:cloudfront::111122223333:distribution/EDFDVBD6EXAMPLE"],
"protection_names": ["my-app-distribution"]
}Example output
Subscribed account 111122223333 to Shield Advanced (auto-renews; unsubscribe via AWS Support).
Protected: my-app-distribution -> arn:aws:cloudfront::111122223333:distribution/EDFDVBD6EXAMPLE
Open the Shield console and confirm the resource is listed as protected:
https://us-east-1.console.aws.amazon.com/wafv2/shieldv2#/protectionsTroubleshooting
Subscribed but the resource is still unprotected
Subscribing does not protect anything. Add the resource with create-protection (Step 3).
create-protection fails with an invalid parameter
The resource may already be protected, or the ARN format is wrong. Confirm with list-protections
and correct the ARN.
A Network Load Balancer cannot be protected directly
Protect it through an attached Elastic IP address (Decision: which resource type to protect).
Additional Resources
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/shieldadvanced · 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 shieldadvanced.zip