Edge Security Acceleration:Código de resposta personalizado

Casos de uso

Algumas solicitações não devem chegar ao servidor de origem. A borda pode servir diretamente avisos de bloqueio, páginas de manutenção e redirecionamentos temporários. Encaminhar essas solicitações à origem aumenta a latência e sobrecarrega o servidor. As regras de código de resposta personalizado permitem que o ESA retorne o código de status HTTP e a página de resposta desejados na borda, eliminando o ciclo de ida e volta.

Cenários típicos incluem:

• Páginas de erro amigáveis: Substitua códigos de status como 404 ou 500 por uma página personalizada que exiba uma mensagem de erro clara para o usuário.

• Janela de manutenção: Durante manutenções agendadas, retorne um código de status 503 com uma página de manutenção para caminhos específicos.

• Bloqueio de solicitações maliciosas: Identifique assinaturas de ataque e retorne um código de status 403 acompanhado de uma página de aviso.

Quando usar regras de código de resposta personalizado

Use uma regra de código de resposta personalizado para retornar um código de resposta fixo e uma página opcional diretamente na borda. Para outros requisitos, utilize o recurso apropriado do ESA:

Pré-requisitos

Antes de começar, verifique se você tem:

• Um nome de domínio adicionado e atendido pelo ESA

• (Opcional) Uma página de resposta personalizada, caso pretenda retornar o conteúdo da página junto com o código de status. Crie a página primeiro; depois, referencie-a em qualquer regra.

Criar uma regra de código de resposta personalizado

1. No console do ESA, selecione Websites e, na coluna Website, clique no site desejado.

2. No painel de navegação à esquerda, escolha Rules > Transform Rules.

3. Na página Transform Rules, selecione a aba Custom response code e clique em Add Rule.

4. Na caixa de diálogo Customize Response Code, configure os seguintes parâmetros e clique em OK:

   • Rule Name: Um nome personalizado para a regra, por exemplo, my-rule.

   • Apply to: Defina as condições de correspondência para a solicitação. Por exemplo, Hostname equals www.example.com.

     Alternativamente, edite a expressão diretamente. Por exemplo, (http.host eq "www.example.com") .

   • Custom Response Code:

     • Response Code: O código de status HTTP a ser retornado. Valores válidos: 200 a 599.

     • Response Page: Selecione entre suas páginas personalizadas existentes. O padrão é Unresponsive page, que retorna apenas o código de status sem nenhum corpo de página.

Verificar a regra

1. Envie uma solicitação que corresponda à regra usando curl -I https://<your-domain>/<matching-path> ou um navegador.

2. Confirme se o código de status HTTP retornado corresponde à sua configuração. Se você configurou uma página de resposta, o navegador exibirá o conteúdo da página personalizada correspondente.

Gerenciar regras de código de resposta personalizado

Você pode executar as seguintes operações em uma regra existente na lista de regras:

• Pesquisar: Insira o nome da regra na caixa de pesquisa no topo da lista para filtrar por nome.

• Reordenar: Arraste uma regra para alterar sua posição. A correspondência das regras segue a ordem de cima para baixo na lista.

• Ativar ou desativar: Alterne o status da regra. Uma regra desativada não entra em vigor, mas sua configuração é preservada.

• Editar: Modifique o nome da regra, as condições de correspondência, o código de resposta ou a página de resposta.

• Excluir: Remova uma regra que não seja mais necessária. A exclusão não pode ser desfeita, portanto, proceda com cautela.

Observações de uso

• O sistema avalia as regras de cima para baixo. A primeira regra correspondente retorna a resposta e nenhuma regra subsequente é avaliada. Organize suas regras adequadamente.

• Os códigos de status válidos variam de 200 a 599, abrangendo todos os códigos de status HTTP padrão. Escolha um código adequado ao seu caso de uso.

• As regras de código de resposta personalizado são independentes das regras de reescrita e das regras de segurança; os três tipos de regra entram em vigor separadamente.

• As alterações nas regras entram em vigor nos nós de borda em tempo real. Nenhuma atualização manual é necessária.