Personalización de páginas de error
IBM Cloud® Internet Services ( CIS ) cuenta con una amplia gama de códigos de error que nos 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. Reserva las páginas de error personalizadas para los casos en los que el servidor de origen no pueda devolver una respuesta a 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 la página es de 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 hace que ocupen aproximadamente un 50 % más de espacio una vez publicados.
<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. Solo puede haber un token específico de página por cada 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.
| 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
Una vez que hayas terminado de personalizar tus páginas de error, es el momento de publicarlas en el borde. La publicación se realiza a través de la CLI de página personalizada.
Al publicar, la página de error personalizada se solicita una vez y, a continuación, se almacena en caché en el perímetro de la nube.
Actualización de páginas de errores
Puedes actualizar una página de error volviéndola a publicar.
Si CIS no puede cargar tu sitio web, o si has bloqueado EE. UU. en el cortafuegos de CIS, la publicación y la vista previa de la página de error no funcionarán.
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 se puede cargar la página web o si has bloqueado las direcciones IP de EE. UU. en el cortafuegos, la publicación y la vista previa de la página de error no funcionarán.