Personalizzazione delle pagine di errore
IBM Cloud® Internet Services ( CIS ) offre un'ampia gamma di codici di errore che ci consentono di individuare problemi specifici. Per impostazione predefinita, queste pagine di errore citano Cloudflare; tuttavia, puoi personalizzare queste pagine di errore. Le pagine di errore personalizzate ti aiutano a fornire un'esperienza coerente per i tuoi utenti, anche se si verifica un errore di caricamento della pagina.
Le pagine di errore personalizzabili sono disponibili in due gruppi:
Verifiche
- Sicurezza di base
- WAF (Web Application Firewall)
- Firewall IP (blocco paese, verifica paese, blocco (intervallo) IP)
Errori CIS
- Errori 502, 504 e CF 52X
- Errori 10XX
- Errori relativi a
Serve Stale Content
Le risposte 500, 501, 503 e 505 non attivano pagine di errore personalizzate per evitare di interrompere endpoint API specifici e altre applicazioni web. Prevedere pagine di errore personalizzate per i casi in cui il server di origine non sia in grado di restituire una risposta alla richiesta (errori 520-526).
Modello di errore personalizzato
Il seguente esempio costituisce un template di errore personalizzato di base. Quando si creano i modelli di errore personalizzati, la dimensione massima della pagina è di 1.5 MB e la pagina non può essere vuota. Inoltre, tutte le risorse esterne vengono incorporate con codific Base64, il che ne aumenta le dimensioni di circa il 50% una volta pubblicate.
<html>
<head></head>
<body>
::[REPLACE WITH TOKEN NAME]::
</body>
</html>
Token di errore personalizzati disponibili
Alcuni tipi di pagine di errore personalizzate devono includere uno di questi token in qualsiasi punto del codice HTML della pagina stessa. Per ogni pagina di errore può essere presente un solo token specifico per quella pagina; pertanto, se si desidera personalizzare ogni errore, è necessario creare una pagina di errore personalizzata per ciascun errore, contenente il rispettivo token.
| Tipo di pagina | Token |
|---|---|
| Tutte le pagine | ::CLIENT_IP:: |
| Tutte le pagine | ::RAY_ID:: |
| Sicurezza di base (Verifica CAPTCHA) | ::CAPTCHA_BOX:: |
| WAF (Verifica CAPTCHA) | ::CAPTCHA_BOX:: |
| Verifica paese (Verifica CAPTCHA) | ::CAPTCHA_BOX:: |
| Defense Mode (Pagina interstiziale) | ::IM_UNDER_ATTACK_BOX:: |
| Errori 5XX | ::CLOUDFLARE_ERROR_500S_BOX:: |
| Errori 1XXX | ::CLOUDFLARE_ERROR_1000S_BOX:: |
| Serve Stale Content | ::ALWAYS_ONLINE_NO_COPY_BOX:: |
Codici di errore di styling
Ogni tag ha una classe univoca che puoi utilizzare per applicare uno stile ai singoli codici di errore. Puoi utilizzare CSS per applicare lo stile alle tag in div/span/section poiché hanno tutte un ID classe.
Ogni pagina (verifica, errori 5xx) ha un ID diverso, quindi utilizza l'opzione di anteprima per ottenere l'ID corretto.
Pubblicazione delle pagine di errore
Una volta terminata la personalizzazione delle pagine di errore, è il momento di pubblicarle sull'edge. La pubblicazione viene eseguita tramite la CLI Pagina personalizzata.
Quando si pubblica, la pagina di errore personalizzata viene richiesta una sola volta, quindi memorizzata nella cache sul perimetro del cloud.
Aggiornamento delle pagine di errore
È possibile aggiornare una pagina di errore ripubblicandola.
Se CIS non riesce a caricare il tuo sito, oppure se hai bloccato gli Stati Uniti nel firewall di CIS, la pubblicazione e l'anteprima della pagina di errore non funzionano.
Risoluzione delle pagine di errore
- Se riscontri errori mentre tenti di eseguire l'anteprima o la pubblicazione della tua pagina di errore personalizzata, eseguila utilizzando un validatore HTML e assicurati che non ci siano errori.
- Assicurarsi che la dimensione della pagina minima sia maggiore di 0. È necessario aggiungere il contenuto alla propria pagina.
- Assicurati che tu stia utilizzando la pagina di errore personalizzata con un codice di stato 200.
- Se il sito non può essere caricato, oppure se hai bloccato gli Stati Uniti nel firewall IP, la pubblicazione e l'anteprima della pagina di errore non funzionano.