dos.xml リファレンス

Python 2.7/3.7 | Java 8 |PHP 5.5/7.2 |Go 1.9/1.11 |Node.js

警告: この機能は非推奨になり、App Engine ファイアウォールに置き換えられました。App Engine ファイアウォールは、より信頼性の高い保護機能と改善された機能を提供します。このファイアウォールは、GCP Console、gcloud コマンドライン ツール、Admin API で管理できます。

重要: このページでは、appcfg ツールなどの App Engine SDK for Java をベースとするツールで使用される、XML 形式の DoS 構成ファイルに関するリファレンスを提供します。gcloud コマンドラインなどの Cloud SDK ベースのツールや、Maven、Gradle、Eclipse、IntelliJ の Cloud SDK ベースのプラグインを使用する場合は YAML 形式のリファレンスをご覧ください。

dos.xml ファイルを使用すると、IP アドレスまたはサブネットをブラックリストに登録して、サービス拒否（DoS）攻撃や類似した不正使用からアプリを保護できます。詳細については、DoS 防止の設定をご覧ください。

App Engine では、デフォルトで、ブラックリストに登録されたアドレスに汎用エラーページが表示されます。カスタム レスポンスを表示するようにアプリケーションを構成することもできます。詳細については、appengine-web.xml リファレンスで静的エラーハンドラに関する説明をご覧ください。

例

dos.xml ファイルの例を次に示します。

<?xml version="1.0" encoding="UTF-8"?>
<blacklistentries>
  <blacklist>
    <subnet>1.2.3.4</subnet>
    <description>a single IP address</description>
  </blacklist>
  <blacklist>
    <subnet>1.2.3.4/24</subnet>
    <description>an IPv4 subnet</description>
  </blacklist>
  <blacklist>
    <subnet>abcd::123:4567</subnet>
    <description>an IPv6 address</description>
  </blacklist>
  <blacklist>
    <subnet>abcd::123:4567/48</subnet>
    <description>an IPv6 subnet</description>
  </blacklist>
</blacklistentries>

構文

アプリケーションの WEB-INF ディレクトリにある dos.xml ファイルで、アプリケーションの DoS 防止サービスのブラックリストを設定します。

要素	説明
<description>	ブラックリスト エントリの説明（省略可）。
<subnet>	必須。有効な IPv4 または IPv6 サブネットの値を CIDR 表記で指定します。

このフォーマットを記述する XSD については、SDK のファイル docs/dos.xsd をご覧ください。

DoS 構成ファイルのデプロイ

現在使用中のバージョンを変更せずにディスパッチ構成ファイルをデプロイするには、次のコマンドを使用します。

appcfg.sh update_dos <application directory>

<application directory> を、アプリケーションのメイン ディレクトリのパスに置き換えます。

すべての DoS 設定の削除

すべての DoS 設定を削除するには:

1. dos.xml ファイルの内容を、次のように編集します。

   <?xml version="1.0" encoding="UTF-8"?>
   <blacklistentries/>
   

2. dos.xml ファイルを App Engine にデプロイします。

制限

構成ファイルに定義できるブラックリスト エントリは 100 個までです。エントリ数が 100 を超える構成ファイルをアップロードすると、エラーが発生します。