[AUD Server] 보안 요건에 따라 접근 제한 페이지나 예외 페이지를 설정할 수 있습니다.

page no.     79405926

1. 기능 설명
   1. 보안 요건에 따라 접근 제한 페이지나 예외 페이지를 설정할 수 있습니다.
         
2. 사용 방법
   1. 아래 파일 경로에서servcie_api.properties파일을 엽니다.
      1. 기본 위치 - Context Path > WEB-INF > classes > framework > service > servcie_api.properties
      2. 해당 파일의 matrix.prop.location=true인 경우 matrix.prop.location.path= 위치의 servcie_api.properties 를 확인합니다.
      3. 7.0.500.20240627-11 핫픽스 이후 버전에서는 Admin > 시스템 정보 조회 > service_api.properties Path 항목에서 위치를 확인합니다.
         
         

   2. 해당 파일에 아래 항목을 추가합니다.

      Example code

      # 웹에서 접근을 제한 하는 파일 경로 (/webquery 폴더와 /reports 경로 폴더는 필수 접근 제어 항목)
      web.deny.all.pattern=/.git/**
      # 웹에서 접근을 제한 하는 파일 경로 중에서 예외 처리 해야 될 파일
      # /webquery/export.jsp,/webquery/un_drm.jsp,/webquery/crypt_webservice.jsp,/webquery/fileToHash.jsp,/webquery/sqlchk.jsp 는 webquery 폴더에서 필수 허용 항목
      web.deny.all.ignoring.pattern=/reports/WEB_IMAGES/*.png

      1. web.deny.all.pattern - 웹에서 접근을 제한하는 파일 경로를 설정합니다.
         • Default 값으로 /webquery 폴더와 /reports 폴더 아래에 있는 항목들은 웹에서 접근 불가하도록 처리되어 있습니다.
      2. web.deny.all.ignoring.pattern - 웹에서 접근을 제한 하는 파일 경로 중에서 예외로 처리해야 될 항목을 설정합니다.
         • web.deny.all.ignoring.pattern옵션을 설정할 경우, 해당 경로는 웹에서 url로 직접 접근이 가능하기 때문에 보안 위배 여부를 확인하고 사전 승인 및 점검 후에 사용하길 권합니다.
         

   3. 해당 파일 변경 시 서버 재기동이 필요합니다.

   4. 별도 error-page 설정이 존재하지 않아 AUD 플랫폼에서 제공하는 기본 error-page 사용 시 web.xml 에 아래 코드를 추가합니다.

      Example code

        <!-- Error page can be changed and used -->
        <error-page>
           <error-code>404</error-code>
           <location>/api/auth/notfound</location>
        </error-page>
      
        <error-page>
           <error-code>403</error-code>
           <location>/api/auth/forbidden</location>
        </error-page>
      
        <error-page>
           <error-code>401</error-code>
           <location>/api/auth/unauthorized</location>
        </error-page>