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.
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.