오류 페이지 사용자 정의
IBM Cloud® Internet Services ( CIS )에는 구체적인 문제를 구분할 수 있게 해주는 다양한 오류 코드가 있습니다. 기본적으로 이러한 오류 페이지는 Cloudflare에 대해 언급하지만 이러한 오류 페이지를 사용자 정의하고 브랜드를 지정할 수 있습니다. 사용자 정의 오류 페이지는 페이지 로드 오류가 발생하는 경우에도 사용자에게 일관된 경험을 제공하는 데 도움이 됩니다.
사용자 정의할 수 있는 오류 페이지는 다음 두 그룹으로 구성됩니다.
인증 확인
- 기본 보안
- 웹 애플리케이션 방화벽
- IP 방화벽(국가 차단, 국가 인증 확인, IP(범위) 차단)
CIS 오류
- 502, 504 및 CF 52X 오류
- 10XX 오류
- 다음과 관련된 오류
Serve Stale Content
500, 501, 503 및 505 응답은 특정 API 엔드포인트 및 기타 웹 애플리케이션 중단을 방지하기 위해 사용자 정의 오류 페이지를 트리거하지 않습니다. 원본 서버가 요청에 대한 응답을 반환할 수 없는 경우(520-526 오류)를 위해 사용자 정의 오류 페이지를 미리 설정해 두십시오.
사용자 정의 오류 템플리트
다음은 기본 사용자 정의 오류 템플리트의 예입니다. 사용자 지정 오류 템플 1.5 MB를 초과할 수 없으며, 페이지는 비어 있을 수 없습니다. 또한, 모든 외부 리소스는 Base64 인코딩으로 인라인 처리되어 게시 시 크기가 약 50% 정도 커집니다.
<html>
<head></head>
<body>
::[REPLACE WITH TOKEN NAME]::
</body>
</html>
사용 가능한 사용자 정의 오류 토큰
일부 유형의 사용자 정의 오류 페이지는 사용자 정의 오류 페이지의 HTML 내 임의의 위치에 다음 토큰 중 하나를 포함해야 합니다. 오류 페이지당 페이지별 토큰은 하나만 포함될 수 있으므로, 모든 오류 메시지를 사용자 정의하려면 각 오류에 대해 해당 토큰이 포함된 사용자 정의 오류 페이지를 하나씩 만들어야 합니다.
| 페이지 유형 | 토큰 |
|---|---|
| 모든 페이지 | ::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:: |
| 시간이 경과된(stale) 컨텐츠 제공 | ::ALWAYS_ONLINE_NO_COPY_BOX:: |
오류 코드 스타일링
각 태그에는 개별 오류 코드를 스타일링하는 데 사용할 수 있는 고유 클래스가 있습니다. 모든 클래스에는 클래스 ID가 있으므로 div/span/section에 있는 태그를 스타일링하는 데 CSS를 사용할 수 있습니다.
각 페이지(인증 확인, 5xx 오류)에는 다른 ID가 있으므로 미리보기 옵션을 사용하여 올바른 ID를 가져오십시오.
오류 페이지 공개
오류 페이지 사용자 지정을 마친 후에는 이를 엣지에 배포해야 합니다. 공개는 사용자 정의 페이지 CLI 를 통해 수행됩니다.
게시하면 사용자 지정 오류 페이지가 한 번 요청된 후 클라우드 에지에 캐시됩니다.
오류 페이지 업데이트
오류 페이지는 다시 게시하여 업데이트할 수 있습니다.
CIS 에서 사이트를 불러올 수 없거나, CIS 방화벽에서 미국을 차단한 경우, 오류 페이지를 게시하거나 미리 보기 기능을 사용할 수 없습니다.
오류 페이지 문제점 해결
- 사용자 정의 오류 페이지를 미리보거나 공개하려고 시도하는 중에 오류가 발생하면 HTML 유효성 검증기를 통해 실행하고 오류가 없는지 확인하십시오.
- 최소 페이지 크기가 0보다 큰지 확인하십시오. 페이지에 컨텐츠를 추가해야 합니다.
- 200 상태 코드를 사용하여 사용자 정의 오류 페이지를 제공하는지 확인하십시오.
- 사이트가 로드되지 않거나 IP 방화벽에서 미국을 차단한 경우, 오류 페이지의 게시 및 미리 보기가 작동하지 않습니다.