IBM Cloud Docs
Personalización de páginas de error

Personalización de páginas de error

IBM Cloud® Internet Services ( CIS ) dispone de una amplia gama de códigos de error que permiten diferenciar problemas específicos. De forma predeterminada, estas páginas de error citan a Cloudflare; sin embargo, puede personalizar y poner su marca en estas páginas de error. Las páginas de error personalizadas le ayudan a proporcionar una experiencia coherente a los usuarios, incluso si se produce un error de carga de página.

Las páginas de error personalizables vienen en dos grupos:

Preguntas de contraseña

  • Seguridad básica
  • Cortafuegos de aplicaciones web (WAF)
  • Cortafuegos de IP (Bloqueo de país, desafío de país, bloqueo de IP (rango))

Errores de CIS

  • errores 502, 504 y CF 52X
  • errores 10XX
  • Errores relacionados con Serve Stale Content

Las respuestas 500, 501, 503 y 505 no desencadenan páginas de error personalizadas para evitar interrumpir puntos finales de API específicos y otras aplicaciones web. Reserve páginas de error personalizadas para los casos en los que el servidor de origen no pueda devolver una respuesta para la solicitud (errores 520-526).

Plantilla de error personalizada

El ejemplo siguiente es una plantilla de error personalizada básica. Al crear sus plantillas de error personalizadas, el tamaño máximo de página es 1.5 MB, y la página no puede estar en blanco. Además, todos los recursos externos se incorporan con codificación Base64, lo que los hace aproximadamente un 50% más grandes cuando se publican.

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

Señales de error personalizadas disponibles

Algunos tipos de páginas de error personalizadas deben incluir una de estas señales en cualquier lugar dentro del HTML de la página de error personalizada. Sólo puede haber un token específico por página de error, por lo que si desea personalizar cada error, debe crear una página de error personalizada para cada error que contenga el token correspondiente.

Tipos de página y sus fichas
Tipo de página Señal
Todas las páginas ::CLIENT_IP::
Todas las páginas ::RAY_ID::
Seguridad básica (desafío CAPTCHA) ::CAPTCHA_BOX::
WAF (desafío CAPTCHA) ::CAPTCHA_BOX::
Desafío de país (desafío CAPTCHA) ::CAPTCHA_BOX::
Modalidad de defensa (página intercalada) ::IM_UNDER_ATTACK_BOX::
Errores 5XX ::CLOUDFLARE_ERROR_500S_BOX::
Errores 1XXX ::CLOUDFLARE_ERROR_1000S_BOX::
Proporcionar contenido obsoleto ::ALWAYS_ONLINE_NO_COPY_BOX::

Códigos de error de estilo

Cada código tiene una clase exclusiva que se puede utilizar para configurar el estilo de los códigos de error de forma individual. Se puede utilizar CSS para configurar el estilo de los códigos en la sección div/span/, ya que todos ellos tienen ID de clase.

Cada página (desafío, errores 5xx) tiene un ID diferente, puede utilizar la opción de vista previa para obtener el ID correcto.

Publicación de páginas de errores

Cuando termine de personalizar las páginas de error, ya puede publicarlas en nuestros límites. La publicación se realiza a través de la CLI de página personalizada.

Al publicar, le solicitamos una vez la página de error personalizada y después se guarda en la memoria caché en la nube.

Actualización de páginas de errores

Puede actualizar una página de error volviéndola a publicar.

Si CIS no puede cargar su sitio, o ha bloqueado los EE.UU. en el cortafuegos CIS, la publicación y previsualización de la página de error no funciona.

Resolución de problemas de páginas de error

  • Si encuentra errores al intentar obtener una vista previa o publicar una página de error personalizada, ejecute la página a través de un validador de HTML y asegúrese de que no tiene errores.
  • Asegúrese de que el tamaño de página mínimo sea mayor que 0. Debe añadir contenido a la página.
  • Asegúrese de que envía la página de error personalizada con el código de estado 200.
  • Si no podemos cargar su sitio, o usted ha bloqueado los EE.UU. en el firewall IP, la publicación y previsualización de la página de error no funciona.