PluginBench
Skill
Pass
Audit score 90

shieldadvanced

aws/agent-toolkit-for-aws

Configure AWS Shield Advanced for enhanced DDoS protection, automatic layer 7 mitigation, and expert support.

What is shieldadvanced?

AWS Shield Advanced is the paid tier that adds enhanced Distributed Denial of Service (DDoS) protection, automatic application layer mitigation through AWS WAF, Shield Response Team (SRT) access, and cost protection on top of always-on AWS Shield Standard. Use this skill when you need stronger DDoS defense for internet-facing resources like CloudFront, load balancers, Elastic IPs, or Route 53 hosted zones, want expert help during an attack, or need to recover attack-driven scaling charges.

  • Subscribe accounts to Shield Advanced and add resources to protection
  • Enable automatic application layer (layer 7) mitigation through AWS WAF integration
  • Configure health-based detection using Route 53 health checks for faster response
  • Set up Shield Response Team (SRT) access and proactive engagement during attacks
  • Review DDoS events and request cost protection credits for attack-driven scaling charges
  • Aggregate related resources into protection groups for unified detection

How to install shieldadvanced

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill shieldadvanced
Prerequisites
  • AWS account with internet-facing resources (CloudFront, ALB, NLB, Elastic IP, Global Accelerator, or Route 53 hosted zone)
  • AWS CLI or AWS MCP server access with permissions to call Shield Advanced APIs
  • Understanding of whether Shield Standard + AWS WAF is sufficient or if Shield Advanced is needed
Claude Code
Cursor
Windsurf
Cline

How to use shieldadvanced

  1. 1.Decide whether Shield Advanced is needed by comparing it to Shield Standard plus AWS WAF (route to deciding reference first)
  2. 2.Subscribe the account to Shield Advanced and add specific resources to protection
  3. 3.Enable automatic application layer mitigation by configuring AWS WAF integration for layer 7 flood response
  4. 4.Configure health-based detection with Route 53 health checks to feed resource health into Shield Advanced's detection
  5. 5.Set up Shield Response Team (SRT) access and proactive engagement if expert support during attacks is required
  6. 6.Review DDoS events in the console and request cost protection credits for attack-driven scaling charges
  7. 7.Aggregate related resources into protection groups to tune detection across multiple resources

Use cases

Good for
  • Protect a CloudFront distribution or Application Load Balancer from DDoS attacks with automatic WAF rule deployment
  • Enable SRT proactive engagement so AWS experts reach out and assist during an active attack
  • Recover AWS charges incurred from auto-scaling triggered by a DDoS attack
  • Configure health-based detection to feed Route 53 health checks into Shield Advanced's detection logic
  • Group multiple related resources (e.g., multiple ALBs serving the same application) for coordinated DDoS detection
Who it's for
  • AWS account owners managing internet-facing resources requiring strong DDoS protection
  • Operations teams needing expert support and visibility during DDoS events
  • Security teams implementing defense-in-depth with Shield Advanced and AWS WAF
  • Organizations with one-year Shield Advanced subscription commitments

shieldadvanced FAQ

What is the difference between AWS Shield Standard and Shield Advanced?

Shield Standard is always-on, free DDoS protection for all AWS customers. Shield Advanced is a paid subscription (one-year commitment) that adds enhanced DDoS protection, automatic layer 7 mitigation through AWS WAF, Shield Response Team expert support, attack visibility, and cost protection for scaling charges. Use Shield Standard plus AWS WAF rate-based rules for many layer 7 cases at lower cost.

Do I need to create AWS WAF rules separately?

Yes. Shield Advanced does not create AWS WAF rules automatically. You should author AWS WAF rules and deploy them on protected resources (CloudFront and ALBs) as defense in depth. The waf skill handles AWS WAF rule authoring; this skill wires Shield Advanced to those rules.

What is the Shield Response Team (SRT) and when do they help?

The SRT is AWS's expert DDoS response team available to Shield Advanced subscribers. They can assist during active attacks, provide recommendations, and reach out proactively if you configure proactive engagement with a Route 53 health check. SRT access requires an IAM role with appropriate permissions.

Can I use Shield Advanced across multiple AWS accounts?

Shield Advanced is per-account. To roll it out organization-wide, use the firewallmanager skill to deploy it via AWS Firewall Manager, which centralizes policy and protection across accounts.

What are protection groups and when should I use them?

Protection groups aggregate related resources (e.g., multiple ALBs) into a single detection unit so Shield Advanced detects DDoS patterns across the group rather than per-resource. Use them for detection tuning, not mitigation. Automatic mitigation still works per-resource.

Full instructions (SKILL.md)

Source of truth, from aws/agent-toolkit-for-aws.


name: shieldadvanced description: >- 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). version: 1

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