dos.xml Reference

Python 2.7/3 |Java 8/11 |PHP 5/7 |Ruby |Go 1.11 / 1.12+ |Node.js

Warning: This feature is deprecated and replaced with the App Engine firewall. App Engine firewall provides more reliable protection as well as improved features. You can manage your firewall with the Cloud Console, gcloud command-line tool, and Admin API.

Important: This page provides a reference for the XML format of the DoS configuration file that is used by tooling based on the App Engine SDK for Java; for example the appcfg tool. If you are using Cloud SDK-based tooling, such as the gcloud command line, or Cloud SDK-based Maven, Gradle, Eclipse, or IntelliJ plugins, refer to the reference in YAML format.

The dos.xml file provides the controls to denylist IP addresses or subnets to protect your app from Denial of Service (DOS) attacks or similar forms of abuse. For more information, see Configuring DoS protection.

By default, App Engine serves a generic error page to denylisted addresses. You can configure your app to serve a custom response instead. For details, see the appengine-web.xml reference on static error handlers.

Example

Syntax

A dos.xml file at any location in your application source code configures DoS Protection Service denylists for your application. The syntax of dos.yaml is the YAML format. For more information about this syntax, see the YAML website.

Element	Description
description	An optional description for the denylist entry.
subnet	Required. The subnet value is any valid IPv4 or IPv6 subnet in CIDR notation.

Deploying the DoS configuration file

The dos.xml file can reside anywhere in your source code directory.

To deploy the DoS configuration file without otherwise altering the currently serving version, use one of the following commands in the directory containing your dispatch file, depending on your environment:

gcloud

gcloud app deploy dos.yaml

Maven

mvn appengine:deployDos dos.yaml

Gradle

gradle appengineDeployDos dos.yaml

IDE

If you use IntelliJ or Eclipse, you select the individual configuration files to be deployed using the deployment form.

Deleting all DoS configuration

To delete all DoS configuration:

1. Edit the contents of the dos.yaml file to:

   blacklist:

2. Deploy the dos.yaml file to App Engine.

Limits

You can define a maximum of 100 denylist entries in your configuration file. Uploading a configuration file with more than 100 entries will fail.