shieldadvanced — Claude Code skill: what it does, how to install

---
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?

| Goal | Reference |
| --- | --- |
| Decide whether Shield Advanced is needed at all (vs Shield Standard + AWS WAF) | [deciding between Shield Standard and Advanced](references/deciding-between-shield-standard-and-advanced.md) |
| Subscribe an account and add resources to protection | [subscribing to Shield Advanced and protecting resources](references/subscribing-to-shield-advanced-and-protecting-resources.md) |
| Respond to layer 7 floods automatically through AWS WAF | [enabling automatic application layer mitigation](references/enabling-automatic-application-layer-mitigation.md) |
| Feed resource health into detection with a Route 53 health check | [configuring health-based detection](references/configuring-health-based-detection.md) |
| Get the Shield Response Team to act or reach out during an attack | [setting up SRT support and proactive engagement](references/setting-up-srt-support-and-proactive-engagement.md) |
| Review a DDoS event and recover attack-driven scaling charges | [reviewing DDoS events and requesting cost protection](references/reviewing-ddos-events-and-requesting-cost-protection.md) |
| Treat related resources as one unit for detection | [aggregating resources into protection groups](references/aggregating-resources-into-protection-groups.md) |

## 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

- [AWS Shield Advanced overview (AWS WAF, AWS Firewall Manager, and AWS Shield Advanced Developer Guide)](https://docs.aws.amazon.com/waf/latest/developerguide/ddos-overview.html)
- [How AWS Shield works (AWS WAF, AWS Firewall Manager, and AWS Shield Advanced Developer Guide)](https://docs.aws.amazon.com/waf/latest/developerguide/ddos-how-shield-works.html)
- [AWS Shield Advanced pricing](https://aws.amazon.com/shield/pricing/)