You're viewing **Apigee Edge** documentation.  
[Go to the
**Apigee X** documentation](http://cloud.google.com/apigee/docs/api-platform/system-administration/preventing-dos). info

Distributed denial-of-service (DDoS) attacks are becoming larger and more common. Recent
attacks have seen record-setting levels of traffic and predictions are it will continue to get
worse. The sheer size of these attacks have caused everyone to re-evaluate their defenses. By
using compromised IoT devices, DDoS attacks are now much larger than previously possible.

The goal of DDoS defenses for Apigee is to protect customer APIs in each customer's data
center. Apigee Edge Cloud is built to accept large volumes of traffic and be the filter that
keeps real requests flowing through to a customer data center and their API interfaces while at
the same time dropping malicious traffic, watching for spikes, managing rate limiting, and
keeping our customers online through the attack.

Apigee can detect spikes in traffic volume, but we cannot determine if that spike is an
attack, a successful campaign, or a new application released to end users. Apigee does not
actively look inside of the API calls to determine which calls are legitimate and which are
probably attacks. It is possible to look at API calls, but doing so isn't part of Apigee's normal
operations. We do not review customer payloads, because that would be a privacy invasion for most
traffic, customers, and end users. Apigee doesn't know if a particular spike on Tuesday afternoon
is due to an attack or a sudden successful adoption of the customers app and services. Apigee can
see the spike, but without additional details and context that are obvious to customers but is
not available to Apigee, we would not know how to respond. A worst-case scenario would be if
Apigee blocked an attack only to discover it was a major marketing success that Apigee had just
killed by blocking the app during its hot period.

## How does Apigee approach DDoS defense?

Apigee Edge is a tool in the security toolbox. The tool is available for the customer to
configure as needed to block malicious traffic, limit valid but excessive traffic, or process
loads faster than the customer's backend can respond and prevent the customer's data center from
being overwhelmed. Apigee Edge provides capabilities that allow our customers to create very
specific security policies to defend the actual API services behind Apigee. Edge is a defensive
layer that can scale as needed to absorb large traffic spikes (such as a DDoS attack) while
limiting the impact to the backend (customers' data centers).

Since Apigee does not manage and interrogate the payload of every call for every customer, the
ability to identify an attack rests with the customer. But the response to an attack should be
coordinated with both the customer and Apigee. Apigee can even involve the cloud provider (GCP or
AWS) if needed.

Apigee, GCP, and AWS will not blackhole traffic destined to a customer. If Apigee does
determine that the traffic is malicious, we will communicate with the customer and offer to
assist. However, because of the scale of Apigee Edge, the simple volume of traffic is not a
trigger to block traffic.

Customers can use Edge to create policies that protect against attacks (included DDoS). These
policies do not come prebuilt out of the box. That would imply that there is nothing unique about
each customer's APIs or data or services. Apigee cannot enable these policies without input from
the customer. That would mean Apigee is reviewing the customer's data and making decisions about
what is valid and what is not.

Edge is a tool to be used, and it can be used to do the things customers need to defend their
APIs. But API defense takes some work by the customer.

The goal is to protect customer API services. That is one of the features and capabilities of
Edge Cloud.

Really it's a matter of blocking different types of DDoS traffic as far away from the actual
APIs as possible:

- Block malformed network packets at the network of the Cloud
- Absorb a flood of properly formed but incomplete packets at the Edge platform layer
- Drop malformed API calls at the Edge layer
- Block properly formed but unauthorized calls within Edge
- Block properly formed and authorized but excessive calls within Edge
- Use Sense to detect properly formed, valid keys, valid API requests which are outside of your expected or allowed access
- Pass only the valid, authorized, acceptable, and within approved limits api calls on to the customer datacenter

## Other common questions

**Can Apigee do denylisting of (ip\|country\|url)?**

Yes, if the policy is created, configured, and enabled in Edge within the customer's Edge
organization.

**Can Apigee detect bots or similar malicious activities?**

Apigee offers a bot detection service called Sense.

**Will Apigee blackhole traffic for me?**

Apigee will not blackhole traffic destined to a customer. If Apigee can determine that the
traffic is malicious, we will communicate with the customer and offer to assist. However, because
of the scale of Apigee Edge and our cloud providers (GCP and AWS), the sheer volume of traffic is
not a trigger to block traffic.

**Does a DoS or DDoS attack count as processed API calls in Edge?**

Apigee Edge is a solution that helps prevent abuse of customer backend systems. So in the event
of an attack, Edge will enforce quota/spike arrest/threat protection etc. to absorb the abuse at
the Apigee Cloud layer, based on configuration. Someone with valid API key and under the quota limit
can still continue to access that API. For any API call that is processed at our layer will count
as a processed call. Apigee Edge is a tool in the security toolbox for customers defense against
DDoS and other types of attacks.

## Detailed DDoS defense information

1. GCP and AWS offer DDoS assistance at the network level as/when needed (a very large attack).
   - Apigee maintains security contacts at GCP and AWS for escalations and response if GCP or AWS assistance is needed to respond to an attack.
2. Apigee Edge can be used for implementing policies that protect customer APIs from attack.
   - Rate limiting.
   - Spike arrests.
   - XML payload attack detection.
   - Other policies can be written to defend against specific attacks.
3. Edge uses auto-scaling as a capability in our defense.
4. Apigee and the customer (and GCP or AWS) need to work together during a DDoS attack. Open communications are important, and Apigee has security resources on call to our support team at all times.

The first response to a DDoS is to use Apigee Edge to help in the attack: enabling spike
arrest, rate limiting, and even denylisting source IP addresses. There are many tools available
within Edge to defend against a DDoS attack.

If the attack is of large enough volume, Apigee can work with the customer to escalate to the
appropriate cloud provider for "upstream assistance." Since each DDoS attack is unique, the
response will be determined during the attack. However, best practices and details needed to help
in the escalation are documented in [Denial of
Service Attack Mitigation on AWS](https://aws.amazon.com/answers/networking/aws-ddos-attack-mitigation/).

Remember that the key is:

**Create a plan for attacks.** Don't forget, we are in this together.
Customers who suspect they are under attack should open a ticket and request the assistance
of Apigee.

## GCP

Apigee uses defenses provided by GCP as stated in the [Best Practices
for DDoS Protection and Mitigation](https://cloud.google.com/files/GCPDDoSprotection-04122016.pdf), such as:

- Virtual networks
- Firewall rules
- Load balancing

## AWS

AWS publishes their [Best
practices for DDoS resiliency](https://d0.awsstatic.com/whitepapers/Security/DDoS_White_Paper.pdf) and [How to prepare for DDoS attacks by reducing your attack surface](https://aws.amazon.com/blogs/security/how-to-help-prepare-for-ddos-attacks-by-reducing-your-attack-surface/). Apigee uses
several of these that are applicable to our environment:

- VPC
- Security groups
- ACLs
- Route53
- Load balancing