エラー・ページのカスタマイズ
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 を使用して行います。
公開すると、カスタムエラーページが1回リクエストされ、その後クラウドのエッジにキャッシュされます。
エラー・ページの更新
エラーページは、再公開することで更新できます。
CIS がサイトを読み込めない場合、または CIS のファイアウォールで米国からのアクセスをブロックしている場合、エラーページの公開やプレビューは機能しません。
エラー・ページのトラブルシューティング
- カスタム・エラー・ページをプレビューまたは公開しようとしてエラーが発生した場合は、それを HTML バリデーターを使用して実行し、エラー・フリーであることを確認します。
- 最小ページ・サイズが 0 より大きいことを確認してください。 ページにコンテンツを追加する必要があります。
- 提供しているカスタム・エラー・ページの状況コードが 200 であることを確認します。
- サイトが読み込めない場合、またはIPファイアウォールで米国からのアクセスをブロックしている場合、エラーページの公開やプレビューは機能しません。