Fehlerseiten anpassen

IBM Cloud® Internet Services ( CIS ) enthält eine Vielzahl von Fehlercodes, anhand derer wir bestimmte Probleme unterscheiden können. Standardmäßig wird auf diesen Fehlerseiten Cloudflare erwähnt; Sie können diese Fehlerseiten jedoch anpassen und kennzeichnen. Benutzerdefinierte Fehlerseiten helfen Ihnen, Ihren Benutzern eine konsistente Erfahrung zu bieten, auch wenn ein Fehler beim Laden von Seiten auftritt.

Anpassbare Fehlerseiten werden in zwei Gruppen zusammengefasst:

Challenges (Abfragen)

  • Grundlegende Sicherheit
  • Web Application Firewall
  • IP-Firewall (Blockieren des Landes, Abfragen des Landes, Blockieren der IP (des IP-Bereichs))

CIS-Fehler

  • Fehler 502, 504 und CF 52X
  • 10XX-Fehler
  • Fehler, die im Zusammenhang stehen mit Serve Stale Content

Die Antworten 500, 501, 503 und 505 lösen keine angepassten Fehlerseiten aus, damit vermieden wird, dass die Verbindung zu bestimmten API-Endpunkten und anderen Webanwendungen unterbrochen wird. Verwenden Sie benutzerdefinierte Fehlerseiten nur in Fällen, in denen der Ursprungsserver keine Antwort auf die Anfrage zurückgeben kann (Fehler 520–526).

Angepasste Fehlervorlage

Das folgende Beispiel zeigt eine grundlegende angepasste Fehlervorlage. Wenn Sie Ihre benutzerdefinierten Fehlervorlagen erstellen, beträgt die maximale Seitengröße 1.5 MB, und die Seite darf nicht leer sein. Zudem werden alle externen Ressourcen mit der Kodierung Base64 eingebettet, wodurch sie bei der Veröffentlichung etwa 50 % größer sind.

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

Verfügbare angepasste Fehlertoken

Einige Typen angepasster Fehlerseiten müssen an einer beliebigen Stelle im HTML-Code der angepassten Fehlerseite eines der unten angegebenen Token enthalten. Pro Fehlerseite darf nur ein seitenbezogenes Token vorhanden sein. Wenn Sie also jeden Fehler individuell anpassen möchten, müssen Sie für jeden Fehler eine eigene Fehlerseite erstellen, die das jeweilige Token enthält.

Seitentypen und ihre Token
Seitentyp Token
Alle Seiten ::CLIENT_IP::
Alle Seiten ::RAY_ID::
Grundlegende Sicherheit (CAPTCHA-Abfrage) ::CAPTCHA_BOX::
WAF (CAPTCHA-Abfrage) ::CAPTCHA_BOX::
Länderabfrage (CAPTCHA-Abfrage) ::CAPTCHA_BOX::
Verteidigungsmodus (Interstitial-Seite) ::IM_UNDER_ATTACK_BOX::
5XX-Fehler ::CLOUDFLARE_ERROR_500S_BOX::
1XXX-Fehler ::CLOUDFLARE_ERROR_1000S_BOX::
Nicht aktuelle Inhalte bereitstellen ::ALWAYS_ONLINE_NO_COPY_BOX::

Stilfehlercodes

Jeder Tag verfügt über eine eindeutige Klasse, die Sie für den Stil der einzelnen Fehlercodes verwenden können. Da Tags in den Bereichen DIV, SPAN und SECTION alle Klassen-IDs haben, können Sie für ihren Stil CSS (Cascading Style Sheets) verwenden.

Jede Seite (Abfrage, 5xx-Fehler) hat eine andere ID; verwenden Sie deshalb die Option für die Vorschau, um die richtige ID zu erhalten.

Fehlerseiten veröffentlichen

Nachdem Sie die Anpassung Ihrer Fehlerseiten abgeschlossen haben, ist es an der Zeit, diese am Edge zu veröffentlichen. Die Veröffentlichung erfolgt über die Befehlszeilenschnittstelle für angepasste Seiten.

Bei der Veröffentlichung wird die benutzerdefinierte Fehlerseite einmal abgerufen und anschließend am Rand der Cloud zwischengespeichert.

Fehlerseiten aktualisieren

Sie können eine Fehlerseite aktualisieren, indem Sie sie erneut veröffentlichen.

Wenn CIS Ihre Website nicht laden kann oder Sie die USA in der Firewall unter CIS blockiert haben, funktioniert das Veröffentlichen und Anzeigen der Fehlerseite nicht.

Fehlerbehebung für Fehlerseiten

  • Wenn bei dem Versuch der Vorschau oder der Veröffentlichung von angepassten Fehlerseiten Fehler auftreten, führen Sie für Ihre angepasste Fehlerseite ein HTML-Prüfprogramm aus, um sicherzustellen, dass die Seite fehlerfrei ist.
  • Stellen Sie sicher, dass die minimale Seitengröße größer als 0 ist. Sie müssen Ihrer Seite Inhalt hinzufügen.
  • Stellen Sie sicher, dass die angepasste Fehlerseite mit dem Statuscode 200 bereitgestellt wird.
  • Wenn die Website nicht geladen werden kann oder Sie die USA in der IP-Firewall blockiert haben, funktioniert das Veröffentlichen und Anzeigen der Fehlerseite nicht.