エラー・ページのカスタマイズ
IBM Cloud® Internet Services ( ）には、特定の問題を区別するための幅広いエラーコードがある。 CIS デフォルトでは、これらのエラー・ページに Cloudflare という記載がありますが、これらのエラー・ページをカスタマイズしてブランド設定することができます。 カスタム・エラー・ページは、ページ・ロード・エラーが発生した場合でも、ユーザーに一貫性のあるエクスペリエンスを提供するのに役立ちます。
カスタマイズ可能なエラー・ページには、以下の 2 つのグループがあります。
チャレンジ
- 基本セキュリティー
- Web アプリケーション・ファイアウォール
- IP ファイアウォール (国ブロック、国チャレンジ、IP (範囲) ブロック)
CIS エラー
- 502、504、および CF 52X エラー
- 10XX エラー
- に関連するエラー
Serve Stale Content
応答 500、501、503、および 505 は、特定の API エンドポイントおよび他の Web アプリケーションの中断を回避するために、カスタム・エラー・ページをトリガーしません。 オリジン・サーバーがリクエストに対するレスポンスを返せない場合（520-526エラー）のために、カスタム・エラー・ページを予約する。
カスタム・エラー・テンプレート
以下の例は、基本的なカスタム・エラー・テンプレートです。 カスタムエラーテンプレートを作成する場合、最大ページサイズは 1.5 MBで、ページを空白にすることはできません。 さらに、すべての外部リソースは、 Base64 エンコーディングでインライン化され、公開時に約 50% のサイズになります。
<html>
<head></head>
<body>
::[REPLACE WITH TOKEN NAME]::
</body>
</html>
使用可能なカスタム・エラー・トークン
カスタム・エラー・ページのタイプによっては、カスタム・エラー・ページの HTML 内の任意の場所にいずれかのトークンを含める必要があります。 ページ固有のトークンはエラーページごとに1つしか存在できないので、すべてのエラーをカスタマイズしたい場合は、それぞれのトークンを含むエラーごとにカスタムエラーページを1つ作成する必要があります。
| ページ・タイプ | トークン |
|---|---|
| すべてのページ | ::CLIENT_IP:: |
| すべてのページ | ::RAY_ID:: |
| 基本セキュリティー (CAPTCHA チャレンジ) | ::CAPTCHA_BOX:: |
| WAF (CAPTCHA チャレンジ) | ::CAPTCHA_BOX:: |
| 国チャレンジ (CAPTCHA チャレンジ) | ::CAPTCHA_BOX:: |
| 防御モード (インタースティシャル・ページ) | ::IM_UNDER_ATTACK_BOX:: |
| 5XX エラー | ::CLOUDFLARE_ERROR_500S_BOX:: |
| 1XXX エラー | ::CLOUDFLARE_ERROR_1000S_BOX:: |
| 不整合コンテンツの提供 | ::ALWAYS_ONLINE_NO_COPY_BOX:: |
エラー・コードのスタイル設定
それぞれのタグには、個々のエラー・コードのスタイルを設定するために使用できる固有のクラスがあります。 div/span/section 内のタグはすべてクラス ID を持つため、CSS を使用してタグのスタイルを設定することができます。
ページ (チャレンジ、5xx エラー) の ID はそれぞれ異なるため、プレビュー・オプションを使用して適切な ID を取得してください。
エラー・ページの公開
エラー・ページのカスタマイズが完了したら、それらをエッジに公開します。 公開は、 カスタム・ページ CLI を使用して行います。
公開すると、カスタム・エラー・ページが IBM の側から 1 回要求され、クラウドのエッジにキャッシュされます。
エラー・ページの更新
エラーページは、再公開することで更新することができます。
CIS があなたのサイトを読み込めない場合、または CIS のファイアウォールでUSをブロックしている場合、エラーページの公開とプレビューは機能しません。
エラー・ページのトラブルシューティング
- カスタム・エラー・ページをプレビューまたは公開しようとしてエラーが発生した場合は、それを HTML バリデーターを使用して実行し、エラー・フリーであることを確認します。
- 最小ページ・サイズが 0 より大きいことを確認してください。 ページにコンテンツを追加する必要があります。
- 提供しているカスタム・エラー・ページの状況コードが 200 であることを確認します。
- お客様のサイトをロードできない場合、またはIPファイアウォールで米国をブロックしている場合、エラーページの公開とプレビューは機能しません。