[WebtoB 가이드] 웹 서버 에러 페이지 설정 방법

이번 포스트에서는 WebtoB 웹 서버에서 에러 페이지를 어떻게 설정하는지에 대해 알아보겠습니다. 웹 서버에서 발생하는 다양한 에러 상황에 대비하여, 사용자에게 보여줄 에러 페이지를 미리 설정해 두는 것은 중요합니다. 이를 통해 사용자는 웹사이트에서 문제가 발생했을 때 명확한 안내를 받을 수 있고, 웹사이트 운영자는 사용자로부터의 신뢰를 유지할 수 있습니다. 이 글에서는 WebtoB의 에러 페이지 설정 방법을 단계별로 설명하겠습니다.

WebtoB 웹 서버: 에러 페이지 설정 가이드

웹 서버에서 에러 페이지를 설정하는 것은 웹 서비스 운영에 있어 중요한 요소입니다. 예를 들어, 웹 서비스에서 사용자가 요청한 정적 콘텐츠가 설정된 Docroot에 없을 경우, '404 Not Found'와 같은 에러 응답이 발생합니다. 이런 상황에서는 웹 서버 설정을 통해 에러 응답 코드(HTTP Status Code)를 받았을 때 사용자를 특정 페이지로 이동시키는 설정이 필요합니다. 이렇게 하면, 사용자는 현재 서버 상황에 대해 명확하게 알 수 있게 되고, 웹사이트 운영자는 사용자로부터의 신뢰를 유지할 수 있습니다.

WebtoB에서는 ERRORDOCUMENT 절을 통해 이러한 에러 페이지를 설정할 수 있습니다.

*NODE
hyodev1        WebtobDir    = "$WEBTOBDIR",
               ShmKey       = 54000,
               DocRoot      = "$WEBTOBDIR/docs/",                 
               Port         = "80",
               Hth          = 1,
               JsvPort      = 9900,
               Logging      = "access_log",
               ErrorLog     = "error_log",
               SysLog       = "system_log",
               ServiceOrder = "ext,uri",
               # HTTP 에러 페이지를 사용자가 지정한 페이지로 설정한다.
               ErrorDocument = "403, 404"
               
*ERRORDOCUMENT
403            Status = 403,  Url = "/403.html"
404            Status = 404,  Url = "https://localhost:9443/err/404.html"

위 설정 예제에서 볼 수 있듯이, 에러 코드에 따라 지정된 페이지로 에러 메시지를 출력할 수 있습니다. 페이지 지정은 내부 Docroot 기준으로 경로 및 파일명을 설정하거나, 전체 URL 정보를 활용하여 외부 서비스를 호출할 수도 있습니다.

또한, 에러 페이지를 설정할 때는 사용자 친화적인 메시지를 제공하는 것이 좋습니다. 예를 들어, '404 Not Found' 대신 '요청하신 페이지를 찾을 수 없습니다. 메인 페이지로 돌아가기'와 같은 메시지를 제공하면, 사용자는 에러 상황을 더 쉽게 이해할 수 있습니다.

반응형

VHOST를 이용한 서비스 별 에러 페이지 설정

WebtoB에서는 VHOST를 사용하여 서비스 별로 에러 페이지를 설정할 수 있습니다. VHOST는 'Virtual Host'의 약자로, 하나의 웹 서버에서 여러 개의 웹사이트를 운영하는 기술입니다. 이를 통해 각 웹사이트마다 다른 에러 페이지를 설정할 수 있습니다. 이는 웹사이트마다 다른 사용자 경험을 제공하고, 각 웹사이트의 특성에 맞는 에러 메시지를 제공하는 데 유용합니다.

아래는 VHOST를 사용하여 에러 페이지를 설정하는 예제입니다.

*VHOST
smart_web      HostName     = "www.smart.com",
               Docroot      = "/appdata/smartWeb",
               Port         = "80",
               IndexName    = "index.html",
               Logging      = "smart_access_log",
               ErrorLog     = "smart_error_log",
               # HTTP 에러 페이지를 사용자가 지정한 페이지로 설정한다.
               ErrorDocument = "smart403, smart404"
               
*ERRORDOCUMENT
smart403       Status = 403,  Url = "smart/403.html"
smart404       Status = 404,  Url = "smart/404.html"

위의 설정 예제에서는 'www.smart.com' 도메인의 웹사이트에 대해 403 에러와 404 에러 페이지를 설정하고 있습니다. 'smart403'와 'smart404'는 각각 403 에러와 404 에러를 나타내는 코드이며, 이에 대응하는 에러 페이지의 URL을 지정하고 있습니다.

이렇게 설정하면, 사용자가 'www.smart.com' 웹사이트에서 403 에러나 404 에러를 만났을 때, 지정된 에러 페이지로 이동하게 됩니다. 이를 통해 사용자는 웹사이트에서 문제가 발생했을 때 명확한 안내를 받을 수 있습니다.

참고로, HTTP Status Code 401을 제외한 모든 에러 코드에 대해 이러한 설정을 할 수 있습니다. 이는 401 에러는 인증이 필요한 페이지에 대한 접근을 시도했을 때 발생하는 에러로, 이 경우에는 웹 서버가 자동으로 인증 요청 페이지를 제공하기 때문입니다.

 

※ WEBTOB 환경 설정 파일 컴파일과 재기동: http.m 파일의 이해와 활용

WEBTOB 환경 설정 파일 컴파일과 재기동: http.m 파일의 이해와 활용