Personnalisation des pages d'erreur
IBM Cloud® Internet Services ( CIS ) propose une large gamme de codes d'erreur qui nous permettent d'identifier des problèmes spécifiques. Par défaut, ces pages d'erreur mentionnent Cloudflare ; cependant, vous pouvez personnaliser et signaler ces pages d'erreur. Les pages d'erreur personnalisées vous aident à fournir une expérience cohérente à vos utilisateurs, même si une erreur de chargement de page se produit.
Les pages d'erreur personnalisables sont disponibles en deux groupes:
Questions secrètes
- Sécurité de base
- Pare-feu d'application Web
- Pare-feu IP (Blocage de pays, Epreuve pays, Blocage d'adresses IP (plage))
Erreurs CIS
- Erreurs 502, 504 et CF 52X
- Erreurs 10XX
- Erreurs liées à
Serve Stale Content
Les réponses 500, 501, 503 et 505 ne déclenchent pas de pages d'erreur personnalisées afin d'éviter d'interrompre des noeuds finaux d'API spécifiques et d'autres applications Web. Réservez les pages d'erreur personnalisées aux cas où le serveur d'origine ne peut pas renvoyer de réponse à la requête (erreurs 520 à 526).
Modèle d'erreur personnalisé
L'exemple suivant est un modèle d'erreur personnalisé de base. Lorsque vous créez vos modèles d'erreur personnalisés, la taille maximale d'une page est de 1.5 Mo, et la page ne peut pas être vide. De plus, toutes les ressources externes sont intégrées avec un encodage Base64, ce qui augmente leur taille d'environ 50 % une fois publiées.
<html>
<head></head>
<body>
::[REPLACE WITH TOKEN NAME]::
</body>
</html>
Jetons d'erreur personnalisés disponibles
Certains types de pages d'erreur personnalisées doivent inclure l'un de ces jetons n'importe où dans le code HTML de la page d'erreur personnalisée. Une seule balise spécifique à la page peut être présente par page d'erreur. Par conséquent, si vous souhaitez personnaliser chaque erreur, vous devez créer une page d'erreur personnalisée pour chaque erreur, contenant la balise correspondante.
| Type de page | Jeton |
|---|---|
| Toutes les pages | ::CLIENT_IP:: |
| Toutes les pages | ::RAY_ID:: |
| Sécurité de base (Authentification CAPTCHA) | ::CAPTCHA_BOX:: |
| WAF (Authentification CAPTCHA) | ::CAPTCHA_BOX:: |
| Epreuve pays (Authentification CAPTCHA) | ::CAPTCHA_BOX:: |
| Mode défense (page interstitielle) | ::IM_UNDER_ATTACK_BOX:: |
| Erreurs 5XX | ::CLOUDFLARE_ERROR_500S_BOX:: |
| Erreurs 1XXX | ::CLOUDFLARE_ERROR_1000S_BOX:: |
| Serve Stale Content | ::ALWAYS_ONLINE_NO_COPY_BOX:: |
Définition du style des codes d'erreur
Chaque balise possède une classe unique que vous pouvez utiliser pour définir le style de codes d'erreur individuels. Il est possible d'utiliser CSS pour styliser les balises dans div/span/section, puisqu'elles ont toutes des identifiants de classe.
Chaque page (authentification, erreurs 5xx) a un identifiant différent, utilisez donc l'option de prévisualisation pour obtenir l'identifiant approprié.
Publication des pages d'erreur
Une fois que vous avez fini de personnaliser vos pages d'erreur, il est temps de les publier sur la périphérie. La publication est effectuée via l'interface de ligne de commande de page personnalisée.
Lors de la publication, la page d'erreur personnalisée est sollicitée une seule fois, puis mise en cache à la périphérie du cloud.
Mise à jour des pages d'erreur
Vous pouvez mettre à jour une page d'erreur en la republiant.
Si CIS ne parvient pas à charger votre site, ou si vous avez bloqué les États-Unis dans le pare-feu CIS, la publication et la prévisualisation de la page d'erreur ne fonctionnent pas.
Traitement des incidents liés aux pages d'erreur
- Si vous rencontrez des erreurs lors de la tentative de prévisualisation ou de publication de votre page d'erreur personnalisée, exécutez celle-ci via un valideur HTML et assurez-vous qu'elle ne contient pas d'erreur.
- Vérifiez que la taille de page minimale est supérieure à 0. Vous devez ajouter du contenu à votre page.
- Assurez-vous que vous diffusez la page d'erreur personnalisée avec un code d'état 200.
- Si le site ne peut pas être chargé ou si vous avez bloqué les adresses IP américaines dans votre pare-feu, la publication et la prévisualisation de la page d'erreur ne fonctionnent pas.