IBM Cloud Docs
Customizando páginas de erro

Customizando páginas de erro

IBM Cloud® Internet Services ( CIS ) tem uma ampla gama de códigos de erro que nos permitem diferenciar problemas específicos. Por padrão, essas páginas de erro mencionam o Cloudflare; no entanto, é possível customizar e marcar essas páginas de erro. As páginas de erro customizadas ajudam você a fornecer uma experiência consistente para seus usuários, mesmo que ocorra um erro de carga de página

Páginas de erro customizáveis vêm em dois grupos:

Desafios

  • Segurança básica
  • Web Application Firewall
  • Firewall de IP (Bloco de país, Desafio de país, bloco de IP (intervalo))

Erros do CIS

  • Erros 502, 504, e CF 52X
  • Erros de 10XX
  • Erros relacionados a Serve Stale Content

As respostas 500, 501, 503 e 505 não acionam páginas de erro customizadas para evitar a quebra de terminais de API específicos e de outros aplicativos da Web. Reserve páginas de erro personalizadas para os casos em que o servidor de origem não pode retornar uma resposta para a solicitação (erros 520-526).

Modelo de erro customizado

O exemplo a seguir é um modelo de erro customizado básico. Ao criar seus modelos de erro personalizados, o tamanho máximo da página é 1.5 MB, e a página não pode estar em branco. Além disso, todos os recursos externos são incorporados com a codificação Base64, tornando-os aproximadamente 50% maiores quando publicados.

<html>
<head></head>
<body>
::[REPLACE WITH TOKEN NAME]::
</body>
</html>

Tokens de erro customizados disponíveis

Alguns tipos de páginas de erro customizadas devem incluir um destes tokens em qualquer lugar dentro do HTML da página de erro customizada. Somente um token específico de página pode estar presente por página de erro, portanto, se você quiser personalizar cada erro, deverá criar uma página de erro personalizada para cada erro que contenha o respectivo token.

Tipos de página e seus tokens
Tipo de página Token
Todas as páginas ::CLIENT_IP::
Todas as páginas ::RAY_ID::
Segurança básica (Desafio de CAPTCHA) ::CAPTCHA_BOX::
WAF (Desafio de CAPTCHA) ::CAPTCHA_BOX::
Desafio do país (Desafio de CAPTCHA) ::CAPTCHA_BOX::
Modo de defesa (Página intersticial) ::IM_UNDER_ATTACK_BOX::
Erros 5XX ::CLOUDFLARE_ERROR_500S_BOX::
1XXX Erros ::CLOUDFLARE_ERROR_1000S_BOX::
Serve Stale Content ::ALWAYS_ONLINE_NO_COPY_BOX::

Estilizando códigos de erro

Cada tag tem uma classe exclusiva que pode ser usada para estilo de códigos de erro individuais. É possível usar o CSS para estilizar as tags no div/span/section já que todos eles têm IDs de classe.

Cada página (desafio, erros 5xx) tem um ID diferente. Portanto, use a opção de visualização para obter o ID adequado.

Publicando páginas de erro

Depois de ter feito a customização de suas páginas de erro, é hora de publicá-las em nossa borda. A publicação é feita por meio da CLI da Página Customizada

Quando você publica, a página de erro customizada é solicitada uma vez por nós e, em seguida, armazenada em cache na borda da nuvem.

Atualizando páginas de erro

Você pode atualizar uma página de erro republicando-a.

Se o CIS não conseguir carregar seu site ou se você tiver bloqueado os EUA no firewall CIS, a publicação e a visualização da página de erro não funcionarão.

Resolução de problemas de páginas de erro

  • Se você encontrar erros ao tentar visualizar ou publicar a sua página de erro customizada, execute-a por meio de um validador de HTML e assegure-se de que ele esteja livre de erros.
  • Certifique-se de que o tamanho mínimo da página seja maior que 0. Você deve adicionar conteúdo em sua página.
  • Certifique-se de que você esteja entregando a página de erro customizada com um código de status 200.
  • Se não conseguirmos carregar seu site ou se você tiver bloqueado os EUA no firewall de IP, a publicação e a visualização da página de erro não funcionarão.