오류 페이지 사용자 정의

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 방화벽에서 미국을 차단한 경우 오류 페이지 게시 및 미리보기가 작동하지 않습니다.