Como configurar o serviço de proteção contra DoS para Java 8

O serviço de proteção contra negação de serviço (DoS, na sigla em inglês) do App Engine permite evitar o esgotamento da cota de aplicativos que sofrem ataques de negação de serviço ou formas de abuso semelhantes. Adicione endereços ou sub-redes IP à lista negra para que as solicitações encaminhadas a partir deles sejam descartadas antes de chamar o código do seu aplicativo. No caso de tais solicitações, nenhuma alocação de recursos será consumida, seja ela faturada ou não.

Por padrão, o App Engine envia uma página de erro genérica para os endereços na lista negra. Se quiser, configure seu app para enviar uma resposta personalizada.

Antes de começar

Crie um arquivo dos.xml no diretório WEB-INF do aplicativo. É nesse arquivo que você especificará os endereços IP e redes que entrarão na lista negra.

Como bloquear solicitações com listas de proibições de DoS

Você pode colocar em lista negra os endereços IP e as sub-redes IP que serão bloqueados de acessar o aplicativo.

O arquivo dos.xml está limitado a 100 entradas. Portanto, talvez seja necessário bloquear sub-redes inteiras em caso de ataque de DoS. Essa também será uma maneira eficiente de se proteger se você descobrir que vários endereços IP da mesma rede fazem parte de um ataque de DoS contra o app.

Como criar entradas na lista negra de endereços IP

Para impedir que um ou mais endereços IP acessem seu aplicativo, defina esses endereços IPv4 ou IPv6 no arquivo dos.xml. Por exemplo:

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

Em um ataque distribuído de negação de serviço (DDoS, na sigla em inglês), provavelmente será necessário bloquear sub-redes inteiras, em vez de endereços IP individuais.

Por exemplo, consulte a referência de dos.xml.

Após criar o dos.xml, faça upload dele para o aplicativo.

Como criar entradas da lista negra para sub-redes IP

Para impedir que uma sub-rede IP acesse seu aplicativo, defina-a no formato CIDR. Você pode usar a ferramenta IP to CIDR para ajudar na criação de regras que usam a notação CIDR.

<?xml version="1.0" encoding="UTF-8"?>
<blacklistentries>
  <blacklist>
    <subnet>abcd::123:4567/48</subnet>
    <description>an IPv6 subnet</description>
  </blacklist
  <blacklist>
    <subnet>abcd::123:4567/48</subnet>
    <description>an IPv6 subnet</description>
  </blacklist
</blacklistentries>

Por exemplo, consulte a referência de dos.xml.

Após criar o dos.xml, faça upload dele para o aplicativo.

Como criar mensagens de erro personalizadas para solicitações na lista negra

Por padrão, é enviada uma página de erro genérica para as solicitações bloqueadas pelo serviço de proteção contra DoS. Os ataques distribuídos de negação de serviço podem envolver uma máquina infectada de um usuário legítimo. Essa página fornece uma explicação a esse usuário sobre o porquê do acesso negado.

  1. Crie um arquivo estático no diretório do aplicativo que será enviado às solicitações bloqueadas pelo serviço de proteção contra DoS.

  2. No arquivo appengine-web.xml, especifique um gerenciador de erros para as respostas de DoS fornecendo o caminho para o arquivo estático e adicionando o tipo <static-error-handlers> de dos_api_denial:

    <static-error-handlers>
      <handler error-code="dos_api_denial" file="dos-response.html" />
    </static-error-handlers>
    

Como excluir todas as entradas da lista de proibições

Para excluir todas as entradas na lista negra:

  1. Edite o arquivo dos.xml para que contenha apenas:

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

    A exclusão de dos.xml não remove as listas de proibições.

  2. Implante o dos.xml novamente para que as alterações entrem em vigor.

Como ver os erros de negação DoS no Console

Veja um gráfico com o número de solicitações que estão sendo negadas:

  1. Vá para o painel do App Engine no Console do Google Cloud Platform:

    Abrir o gráfico de detalhes de erros do App Engine

  2. Ajuste o período do gráfico conforme necessário para ver os resultados.

Fazer upload da lista negra de DoS

É possível usar appcfg.sh para fazer upload das configurações de DoS. Quando você faz upload do aplicativo para o App Engine usando appcfg.sh update, o serviço de proteção contra DoS é atualizado com o conteúdo do arquivo de configuração dos.xml.

Para atualizar apenas o arquivo de configuração de DoS sem fazer upload do restante do aplicativo, use o seguinte comando:

appcfg.sh update_dos [PATH_TO_CONFIG_FILE]/dos.xml

A seguir

  • Configure o Stackdriver Monitoring para identificar problemas rapidamente e receber alertas.
  • Leia a experiência de um cliente (em inglês) sobre como ele respondeu a um ataque distribuído de negação de serviço (DDoS, na sigla em inglês), publicada em janeiro de 2013.
Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Ambiente padrão do App Engine para Java 8