---
id: "aws-shield"
type: "component"
kind: "ddos-protection"
provider: "aws"
category: "security"
docs: "https://docs.aws.amazon.com/waf/latest/developerguide/shield-chapter.html"
url: "https://localhost:3000/catalogue/components/aws-shield"
---

# AWS Shield

DDoS protection for AWS resources: always-on network-layer defence in Standard, application-layer mitigation and response in Advanced.

| | |
|---|---|
| Provider | [aws](https://localhost:3000/catalogue?provider=aws) |
| Kind | [DDoS protection plan](https://localhost:3000/catalogue/kinds/ddos-protection) |
| Category | Security |
| Official docs | [https://docs.aws.amazon.com/waf/latest/developerguide/shield-chapter.html](https://docs.aws.amazon.com/waf/latest/developerguide/shield-chapter.html) |

## Properties

| property | type | values | required | kind default | this component |
|---|---|---|---|---|---|
| `adaptiveThresholds` | boolean | — | no | — | inherited |
| `alwaysOn` | boolean | — | no | — | **true** |
| `automaticApplicationLayerMitigation` | boolean | — | no | false | inherited |
| `automaticMitigationAction` | enum | `count`, `block` | no | — | inherited |
| `healthBasedDetection` | boolean | — | no | false | inherited |
| `managed` | boolean | — | no | false | **true** |
| `proactiveEngagement` | boolean | — | no | false | inherited |
| `protectedResourceCount` | integer | — | no | — | inherited |
| `scope` | enum | `network`, `application`, `both` | no | — | **"network"** |
| `telemetry` | boolean | — | no | — | **false** |
| `tier` | enum | `standard`, `advanced` | no | "standard" | inherited |

Bold values are the ones this component pins.

## Rules that apply · 0

No rule selects this kind or its category.

## Other products of the same kind · 10

- [Anti-DDoS Origin](https://localhost:3000/catalogue/components/alibaba-anti-ddos-origin.md) `alibaba-anti-ddos-origin` — alibabacloud
- [Anti-DDoS Pro](https://localhost:3000/catalogue/components/alibaba-anti-ddos-pro.md) `alibaba-anti-ddos-pro` — alibabacloud
- [Game Shield](https://localhost:3000/catalogue/components/alibaba-game-shield.md) `alibaba-game-shield` — alibabacloud
- [Azure DDoS Protection](https://localhost:3000/catalogue/components/azure-ddos-protection.md) `azure-ddos-protection` — azure
- [Cloudflare DDoS Protection](https://localhost:3000/catalogue/components/cloudflare-ddos-protection.md) `cloudflare-ddos-protection` — cloudflare
- [Cloudflare Magic Transit](https://localhost:3000/catalogue/components/cloudflare-magic-transit.md) `cloudflare-magic-transit` — cloudflare
- [Generic DDoS protection plan](https://localhost:3000/catalogue/components/ddos-protection.md) `ddos-protection` — default
- [NETSCOUT Arbor DDoS](https://localhost:3000/catalogue/components/netscout-arbor.md) `netscout-arbor` — default
- [Radware DefensePro](https://localhost:3000/catalogue/components/radware-defensepro.md) `radware-defensepro` — default
- [DigitalOcean DDoS Protection](https://localhost:3000/catalogue/components/digitalocean-ddos-protection.md) `digitalocean-ddos-protection` — digitalocean

## Use it in a design

```yaml
nodes:
  - { id: "aws-shield", component: "aws-shield" }
```

## Source (`component` YAML, verbatim)

```yaml
# yaml-language-server: $schema=../../schema/component.schema.json
# AWS Shield: DDoS protection for AWS resources. Shield Standard applies automatically at no extra
# cost against common volumetric layer 3 and 4 attack vectors such as UDP reflection and TCP SYN
# floods ("AWS Shield"). Shield Advanced is a paid subscription that adds layer 7 protection through
# AWS WAF, health-based detection, protection groups, real-time event metrics, Shield Response Team
# access and cost protection; automatic application layer mitigation is configured, not on by
# default, and adds a 150-WCU rule group ("AWS Shield Advanced capabilities and options").
schemaVersion: "1"
type: "component"
id: "aws-shield"
kind: "ddos-protection"
provider: "aws"
docs: "https://docs.aws.amazon.com/waf/latest/developerguide/shield-chapter.html"
defaults:
  managed: true
  scope: "network"
  alwaysOn: true
  telemetry: false
properties:
  tier:
    type: "enum"
    values: ["standard", "advanced"]
    default: "standard"
  automaticApplicationLayerMitigation:
    type: "boolean"
    default: false
  automaticMitigationAction:
    type: "enum"
    values: ["count", "block"]
  healthBasedDetection:
    type: "boolean"
    default: false
  proactiveEngagement:
    type: "boolean"
    default: false
```

Human page: https://localhost:3000/catalogue/components/aws-shield