웹 미리보기 서버 구성
웹 미리보기 서버 및 proxy-config.xml 파일을 구성할 수 있습니다.
시작하기 전에
중요사항: 이 주제에서는 WebSphere® Application Server traditional,Liberty 또는 Liberty Core에 적용되지 않습니다. 이는 Web Preview
Server에만 적용됩니다.
프로시저
- 서버 보기에서 웹 미리보기 서버를 두 번 클릭하여 서버 편집기를 여십시오. 개요 및 보안 페이지를 사용하여 웹 미리보기 서버를 구성할 수 있습니다.
- 개요 페이지의 일반 정보 섹션에서 서버 이름, 호스트 이름 및 런타임 환경을 편집하십시오.
- 통신 설정 섹션에서 웹 미리보기 서버에 사용할
기본 포트 번호를 지정하십시오. 참고: 기본 포트 번호가 이미 사용 중이면 웹 미리보기 서버는 사용 가능한 다른 포트 번호를 자동으로 지정합니다.
- 공개 섹션에서 다음 설정 중 하나를
선택하십시오.
옵션 설명 자동 공개 수행 안함 워크벤치는 서버에 대한 파일 공개를 수행하지 않습니다. 자원 변경 시 자동 공개 서버와 연관되는 파일에 대한 변경이 저장되고 공개 간격 설정에서 풀타임 간격이 지나면 워크벤치가 공개합니다. 이는 기본 설정입니다. 빌드 이벤트 후 자동 공개 워크벤치는 서버와 연관되고 빌드가 필요한 파일에 대한 변경이 저장되며 공개 간격 설정에서 풀타임 간격이 지나면 공개합니다. 공개 간격(초) 서버에서 워크벤치가 파일을 공개하기 전까지의 시간(초)입니다. 그러나 이 시간 간격이 완료되기 전에 파일이 다시 변경되는 경우에는 타이머가 재설정되기 때문에 공개가 지연됩니다. 워크벤치는 풀타임 간격이 지난 후에만 서버에 공개합니다. 공개 간격을 0초로 설정하면 파일 변경사항이 저장되자마자 파일이 공개됩니다. - 제한시간 섹션에서 요청을 완료하는 시간의 양을 설정하십시오.
- Ajax 프록시 섹션에는 액세스 URL과 그에 상응하는 분석된 대상 URL을 표시하는
테이블이 있습니다. Ajax 프록시 섹션에는
액세스 URL 열(proxy/http/*)에 나열되는
와일드카드에 대한 기본 프록시 규칙이 있으며 사용자는 이를 임의의 URL에 프록시하는 데 사용할 수 있습니다. 예를 들어, 웹 브라우저에서 이 http://localhost:8080/proxy/http/google.com URL을 사용하여
Google 웹 페이지를 로드할 수 있습니다. 프록시를 통해 맵핑되는
이 요청은 http://www.google.com에 직접 요청을 발행할 때와 동일한
결과를 얻습니다. 팁: Ajax 프록시 URL 테이블의 행에서 마우스 오른쪽 단추를 클릭하고 액세스 URL(예: proxy/us/en)을 복사하여 JavaScript 코드에 붙여넣을 수 있습니다.
- 프록시 URL 구성 링크를 클릭하여 proxy-config.xml을 편집하십시오.
- Ajax 프록시 구성 편집기에서 원격 도메인에 맵핑하기 위한 프록시 규칙을 추가하십시오. 프록시 규칙 노드를 선택하고 추가를 클릭하십시오.
- 항목 추가 창에서 다음 항목 중
하나를 선택하고 편집기에서 해당 속성을 편집하십시오.
옵션 설명 맵핑 수신 요청을 해당 컨텍스트 경로에 따라 대상 URL로 맵핑하십시오. 컨텍스트 경로 속성과 선택적 URL 속성을 지정하십시오. 예를 들어, /ibmproducts의 컨텍스트 경로를 URL http://www.ibm.com/products로 설정할 수 있습니다.
수신 프록시 URL이 http://mywebsite.com/ibmproducts/us/en인 경우 프록시는 이 요청을 http://www.ibm.com/products/us/en에 전달합니다. 일치하는 액세스 정책을 적용하기 전에 프록시는 컨텍스트 경로 맵핑을 분석합니다. 빠른 프로토타입 작성을 위해 두 개의 기본 프록시 맵핑인 http/* 및 us/en이 제공됩니다.
메타데이터 프록시의 일반 구성 특성(예: HTTP 관련 매개변수)을 지정합니다. 프록시 편집기는 기본 이름과 값 쌍이 포함된 일부 공통 메타데이터 옵션을 제공합니다. - forward-http-errors
- 기본적으로 Ajax 프록시는 200 이상 400 미만의 HTTP 상태 코드만 전달합니다. 범위를 벗어난 상태 코드는 자동으로 404 파일을 찾을 수 없음 오류로 변경됩니다. 메시지를 포함하는 400 이상의 HTTP 코드는 forward-http-errors 매개변수를 true로 설정하여 전달할 수 있습니다.
- unsigned_ssl_certificate_support
- 서명 없는 인증서는 보호 REST 서비스에서 주로 사용됩니다. unsigned_ssl_certificate_support가 사용 가능한 경우 Ajax 프록시는 SSL 인증을 승인합니다. 이 옵션은 테스트 및 디버깅에 유용합니다. 프로덕션 환경에서는 이 옵션을 사용하지 마십시오.
- basic-auth-support
- 대상 서비스가 기본 인증을 사용하는 경우 이 옵션을 true로 설정하십시오. basic-auth-support 속성이 해당 특정 요청에 대해 사용으로 설정되지 않는 한 401(권한 없음)의 HTTP 상태 코드는 결과적으로 403: 금지됨 HTTP 코드가 됩니다.
- maxconnectionsperhost
- maxconnectionperhost는 호스트 또는 포트 조합에 대해 살아 있는 상태인 최대 연결 수를 지정하는 글로벌 값입니다. 기본적으로 이 값은 2로 설정되지만 사용자의 애플리케이션이 컨텐츠를 얻기 위해 셋 이상의 사이트에 액세스하는 경우 이 값을 늘리십시오.
- maxtotalconnections
- maxtotalconnections는 프록시에서 지원되는 연결의 최대 총계입니다. 기본값은 5입니다. 사용자가 선택하는 값은 수신할 가능성이 있는 동시 연결 수를 지원하기에 충분히 높아야 합니다. 실제로 웹 컨테이너가 구성되는 방식과 컨테이너가 지원하는 동시 연결 수를 고려하십시오.
- socket-timeout
- socket-timeout은 연결이 설정된 후에 데이터 대기를 위한 기본 소켓 제한시간을 밀리초로 정의합니다. 기본 제한시간 값은 0이며 이 값은 무한 제한시간으로 해석됩니다.
- 재시도 횟수
- 재시도 횟수 매개변수는 Ajax 프록시가 연결 설정을 포기하기 전까지 수행하는 소켓 재시도 횟수를 정의합니다. 기본값은 2입니다.
- connection-timeout
- connection-timeout은 연결이 설정되기 전까지의 시간을 밀리초로 정의합니다. 지정된 값이 없으면 기본값으로 60000이 사용됩니다. 0이 사용되는 경우 이 값은 제한시간이 사용되지 않음을 의미하는 것으로 해석됩니다.
정책 제공된 URL 패턴에 대한 액세스 정책을 정의합니다. - ACF 필드에서 활성 컨텐츠 필터링을 켜거나 끄십시오. 활성 컨텐츠 필터링은 브라우저에 표시되는 애플리케이션 컨텐츠에서 잠재적으로 악성인 활성 컨텐츠를 제거합니다.
- URL 속성 필드에 패턴을 지정하십시오. 각 수신 요청에 대해 프록시는 최상의 URL 일치를 포함하는 정책을 적용합니다. 일치하는 정책이 없는 경우 프록시가 요청을 거부합니다. 정책을 찾으면 요청 승인 여부를 확인하기 위해 정책 요소의 하위 요소가 적용됩니다.
- 기본 인증 확인 지원을 켜거나 끄십시오.
다음 정책 하위 요소를 편집할 수 있습니다.- 조치 메소드
- 최소 한 개 이상의 지원되는 HTTP 메소드를 지정합니다. Ajax 프록시는 GET, POST, PUT, HEAD 또는 DELETE 요청을 지원합니다.
- 쿠키
- 프록시가 대상 도메인에 전달하도록 하려는 쿠키를 식별하는 쿠키 이름의 목록을 정의합니다. 쿠키를 전달하기 위해 프록시는 정의된 쿠키 이름에 따라 쿠키 헤더의 값을 필터링합니다.
- HTTP 헤더
- 프록시가 대상 도메인에 전달하도록 하려는 헤더 이름의 목록을 정의합니다. 헤더 이름은 와일드카드 문자를 포함할 수 있습니다.
- Mime-types
- 승인되는 MIME 유형의 목록을 지정합니다. MIME 유형은 대상 서버로부터 프록시가 수신하는 응답을 나타냅니다. 최소 한 개 이상의 MIME 유형이 지정되면 프록시는 지정된 MIME 유형 중 하나에 일치하는 Content-Type 응답 헤더를 포함하는 응답만 승인합니다. MIME 유형이 지정되지 않으면 프록시는 모든 응답을 승인합니다.
- 사용자
- 사용자 또는 사용자 그룹의 목록을 지정합니다. 예를 들어, AllAuthenticatedUsers를 지정하면 프록시가 이 요청이 인증된 사용자에 의해 전송되었는지 확인합니다.
- Ajax 프록시 키 저장소 섹션은 키 저장소 경로 및 유형과 같이
Ajax 프록시에서 사용되는 키 저장소에 대한 정보를
표시합니다. 키 저장소에서 SSL 인증서를 추가하거나 제거하여
대상 서버가 신뢰할 수 없는 SSL 인증서를 사용하는 URL에서 정보를 검색하는 데
Ajax 프록시를 사용할 수 있습니다. 신뢰할 수 없는 인증서가 포함된
서버를 가리키는 URL의 SSL 인증서를 가져온 후에
Ajax 프록시를 사용하여 오류 메시지 없이 이 URL에
액세스할 수 있습니다.
- 옵션: 키 저장소의 비밀번호가 다른 공급업체로부터 확보한 소프트웨어 사용을 통해 변경된 경우 키 저장소 비밀번호 필드에서 비밀번호를 업데이트하십시오.
- 키 저장소 경로 필드에 지정되는
키 저장소의 SSL 서버 인증서를 추가하거나 제거하십시오.
- 키 저장소 항목을 클릭하십시오. 키 저장소 관리 창이 열리고 각각 별명으로 식별되는 현재 키 저장소의 항목 목록을 표시합니다.
- 키 저장소 항목을 제거하려면 키 저장소 항목의 목록에서 해당 항목을 선택한 다음 항목 제거를 클릭하십시오.
- 키 저장소 항목을 추가하려면 항목 추가를 클릭하십시오. 인증서 가져오기 창이 열립니다.
- 항목 별명 필드에서 새 키 저장소 항목의 별명을 지정하십시오.
- 서버 또는 로컬 시스템에서 SSL 인증서를 가져올지 여부를
지정하십시오.
- 서버에서 키 저장소로 인증서를 가져오십시오.
- SSL 인증서를 가져올 서버의 URL을 입력하십시오.
- 키 저장소에 로컬 인증서를 가져오십시오.
- 인증서 찾아보기를 클릭하여 로컬 시스템에서 가져올 SSL 인증서를 찾으십시오.
- 확인을 클릭하여 변경사항을 저장하고 인증서 가져오기 창을 닫으십시오. 키 저장소 관리 창에서 확인을 클릭하여 모든 변경사항을 키 지정소에 저장하십시오.
- 보안 페이지에서
다음과 같은 설정을 구성하십시오.
섹션 설명 일반사항 웹 애플리케이션을 위한 보안을 사용 또는 사용 안함 설정하고 웹 미리보기 서버에 배치되는 현재 프로젝트를 검토하십시오. 참고: 웹 미리보기 서버에 배치되는 웹 애플리케이션에 대해 보안을 사용으로 설정해야 됩니다. 서버에 배치할 웹 프로젝트에 포함되어 있는 WebContent/WEB-INF/web.xml 파일에서 보안을 구성할 수 있습니다.사용자 및 그룹 웹 미리보기 서버에 등록된 사용자 및 그룹을 관리합니다. - 서버에 새 사용자를 등록합니다.
- 서버에서 사용자를 제거합니다.
- 서버에 새 그룹을 등록합니다.
- 등록된 그룹에서 사용자를 추가하거나 제거합니다.
- 서버에서 그룹을 제거합니다.
보안 역할 웹 미리보기 서버에 등록된 보안 역할을 관리합니다. - 서버에 보안 역할을 등록합니다.
- 서버에서 보안 역할을 제거합니다.
- 사용자에게 보안 역할을 맵핑합니다.
- 사용자의 보안 역할을 제거합니다.
- 그룹에 보안 역할을 맵핑합니다.
- 그룹에서 보안 역할을 제거합니다.
- 변경사항을 저장하십시오.
상위 주제: 웹 미리보기 서버에서 테스트
상위 주제: 테스트 및 공개용 서버 구성