Generated banner for Shieldadvanced
Generated logo for Shieldadvanced

Shieldadvanced

AWSOfficialPublished by AWS

  • Skill
  • Tool integration
  • Cloud and DevOps
  • Apache-2.0
  • No issues found

From the author

Configures AWS Shield Advanced for enhanced Distributed Denial of Service (DDoS) protection: subscribing accounts and adding resource protections, enabling automatic application layer (layer 7) mitigation through AWS WAF, configuring health-based detection with Route 53 health checks, setting up Shield Response Team (SRT) access and proactive engagement, reviewing DDoS events and requesting cost protection credits, and aggregating resources into protection groups. Applicable when the user wants stronger DDoS protection for internet-facing resources (CloudFront, Application or Network Load Balancers, Elastic IP addresses, Global Accelerator, or Route 53 hosted zones), wants expert help during an attack, or wants to recover attack-driven scaling charges. Routes to the right per-task procedure in references. Not applicable for authoring AWS WAF rules (waf skill), creating Route 53 health checks (route53 skill), or org-wide Shield Advanced rollout with Firewall Manager (firewallmanager skill).
— the description by AWS

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

  1. Download the skill as a ZIP:

    https://autogineer.com/agent-skills/aws/shieldadvanced/download
  2. Unzip 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?

GoalReference
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 protectionsubscribing to Shield Advanced and protecting resources
Respond to layer 7 floods automatically through AWS WAFenabling automatic application layer mitigation
Feed resource health into detection with a Route 53 health checkconfiguring health-based detection
Get the Shield Response Team to act or reach out during an attacksetting up SRT support and proactive engagement
Review a DDoS event and recover attack-driven scaling chargesreviewing DDoS events and requesting cost protection
Treat related resources as one unit for detectionaggregating 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 DDoSDetected and DDoSAttackBitsPerSecond) 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.com assumes to act in the account. Scope its trust policy with an aws:SourceAccount condition equal to the account ID to prevent confused-deputy assumption, grant it only the actions it needs, and revoke it with disassociate-drt-role when 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

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 typeNotes
CloudFront distributionProtect here for web applications; also the place to protect an Application Load Balancer that sits behind CloudFront
Application Load BalancerProtect at the load balancer when it is not behind CloudFront
Network Load BalancerProtect through an attached Elastic IP address, not the load balancer directly
Elastic IP addressProtects the attached EC2 instance or Network Load Balancer
Global Accelerator standard acceleratorProtect the accelerator directly
Route 53 hosted zoneProtect 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-subscription individually, even though only one fee is charged

  • You 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-identity

  • You 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 access

  • You SHOULD confirm AWS CloudTrail is enabled and logging shield:* calls so every Shield Advanced configuration change leaves an audit trail

  • You 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-1
  • You 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-1
  • You MUST capture the ProtectionId from each response

  • You 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

Constraints:

  • You MUST list protections to confirm coverage:

    aws shield list-protections --region us-east-1
  • You 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#/protections
Troubleshooting
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