HTTP 프록시 서버 사용자 정의 특성
HTTP 프록시 서버의 구성 설정값에 다음 사용자 정의 특성을 추가할 수 있습니다.
특정 HTTP 프록시 서버에 대한 사용자 정의 특성을 지정하려면, 사용자 정의 특성 페이지를 탐색한 후 사용자 정의 특성의 값을 지정하십시오.
- 관리 콘솔에서 확장하여 서버의 구성 탭을 엽니다.
(클러스터의 프록시 서버의 경우, 확장합니다).
- HTTP 프록시 서버 설정을 펼치고 을 클릭하십시오.
- 추가 속성 아래에서 클릭합니다.
- 설정 페이지에서 구성할 사용자 정의 속성을 입력합니다.
Name필드를 클릭하고 사용자 정의 속성 값을 입력합니다.Value필드. - 딸깍 하는 소리Apply 또는OK .
- 딸깍 하는 소리Save 콘솔 작업 표시줄에서 구성 변경 사항을 저장합니다.
- 서버를 다시 시작하십시오.
- 관리 콘솔에서 확장하여 서버의 구성 탭을 엽니다.
(정적 클러스터의 ODR 서버의 경우, 확장합니다).
- 확장 온 디맨드 라우터 설정, 온 디맨드 라우터 설정을 클릭합니다.
- 추가 속성 아래에서 클릭합니다.
- 설정 페이지 에서, 이름 필드 에 구성하려는 사용자 정의 속성을 입력하고, 값 필드 에 사용자 정의 속성의 값을 입력합니다.
- 적용 또는 확인을 클릭하십시오.
- 콘솔 작업 표시줄의 저장을 클릭하여 구성 변경사항을 저장하십시오.
- 서버를 다시 시작하십시오.
HTTP 프록시 또는 ODR 서버의 설정 페이지에는 이러한 속성이 표시되지 않지만, 사용자 지정 속성으로 설정됩니다.
일반적인 HTTP 프록시 설정
- cache.ignore.header.Authorization
- cache.ignore.header.Cookie
- cache.ignore.header.Proxy-Authorization
- cache.query.string
- http.auto.redirect.correction
- http.cache.nocache.headers
- http.clientInfoFromTrustedIntermediary
- http.connectRetryLimit
- http.connectionPoolUseForPOST
- http.disable.retry.on.503.uriprefix
- http.disableresponsebufferingurls
- http.ignore.compliance.via
- http.isDisable10ResponseCaching
- http.log.history
- http.log.history.backup.list
- http.maxCachedPayload
- http.odcUpdateTimeout
- http.pmiTimerInterval
- http.routing.sendReverseProxyNameInHost
- http.virtual.port.map
- HTTPProxyAdvisorMethodName
- HTTPProxyAdvisorStartupDelay
- HTTPProxyAdvisorURI
- HTTPProxyAdvisorUserAgent
- http.useHostHeaderPort
- LBIPAddr
- localOutboundTCPAddress
- normalize.redirect.URL
아웃바운드 연결 속성
cache.ignore.header.Authorization
사용자 정의 특성을 true로 설정하는 경우 프록시는 요청에 있는 Proxy-Authorization 헤더를 무시하도록 지정합니다. 응답도 캐싱 가능한 경우에는 프록시가 응답을 캐싱합니다.
| 정보 | 값 |
|---|---|
| 데이터 유형 | 부울 |
| 기본값 | 아니오 |
cache.ignore.header.Cookie
사용자 정의 특성을 true로 설정하는 경우 프록시는 요청에 있는 쿠키 헤더를 무시하도록 지정합니다. 응답도 캐싱 가능한 경우에는 프록시가 응답을 캐싱합니다.
| 정보 | 값 |
|---|---|
| 데이터 유형 | 부울 |
| 기본값 | 아니오 |
cache.ignore.header.Proxy-Authorization
사용자 정의 특성을 true로 설정하는 경우 프록시는 요청에 있는 Proxy-Authorization 헤더를 무시하도록 지정합니다. 응답도 캐싱 가능한 경우에는 프록시가 응답을 캐싱합니다.
| 정보 | 값 |
|---|---|
| 데이터 유형 | 부울 |
| 기본값 | 아니오 |
cache.query.string
기본 프록시가 캐시 키 생성기가 URL 경로 및 조회 문자열 정보 모두를 사용하여 캐시 키를 생성하는지 여부를 지정합니다. 이 기능을 사용으로 설정하려면 사용자 정의 특성을 true로 설정하십시오. 그렇지만 ESI(Edge Side Include) 캐싱을 프록시 서버에서 사용하는 경우 이 사용자 정의 특성은 사용되지 않습니다. 이 사용자 정의 특성을 설정하지 않으면 프록시 서버는 조회 문자열 정보 기본이 아니라 URL 경로만을 기반으로 캐시 키를 생성합니다.
ESI 캐싱에 대한 자세한 정보는 Edge Side Include 캐싱 구성을 참조하십시오.
| 정보 | 값 |
|---|---|
| 데이터 유형 | 문자열 |
http.auto.redirect.correction
일반 서버 클러스터에서 302 응답이 리턴될 때 프록시 서버가 위치 헤더에서 값 수정을 시도해야 하는지 여부를 지정합니다.
이 특성에 대해 none을 지정하는 경우, 프록시 서버는 302 응답이 리턴될 때 위치 헤더에서 값 수정을 시도하지 않습니다.
이 특성에 대해 gsc를 지정하는 경우, 프록시 서버는 302 응답이 일반 서버 클러스터에서 리턴될 때만 위치 헤더 값 수정을 시도합니다.
이 특성에 대해 managed를 지정하는 경우, 프록시 서버는 302 응답이 관리 서버에서 리턴될 때만 위치 헤더 값 수정을 시도합니다.
이 특성에 대해 all을 지정하는 경우, 프록시 서버는 302 응답이 리턴될 때 위치 헤더에서 값 수정을 시도합니다.
| 정보 | 값 |
|---|---|
| 데이터 유형 | 문자열 |
| 허용 가능한 값 | none, gsc, managed 또는 all |
| 기본값 | gsc |
http.cache.nocache.headers
프록시 서버가 응답을 수신할 때 캐싱하지 않으려는 set-cookie 헤더를 지정합니다. 기본적으로 프록시 서버는 set-cookie 헤더를 프록시 캐시에 저장합니다. Cache-Control 헤더 정보가 제대로 설정되지 않은 경우, 프록시 서버는 일부 세션 관련 사용자 개인 쿠키를 저장할 수도 있습니다. 이 사용자 정의 특성을 사용하여 프록시 캐시에 저장하지 않으려는 set-cookie 헤더를 지정할 수 있습니다.
| 정보 | 값 |
|---|---|
| 데이터 유형 | 쉼표로 구분되는 HTTP 헤더 이름 문자열 |
예를 들어, Set-Cookie,Set-Cookie2 값을
제공할 수 있습니다. 그 결과 프록시 서버는 Set-Cookie 및 Set-Cookie2 HTTP 헤더를
프록시 서버에 저장하지 않습니다.
http.clientInfoFromTrustedIntermediary
프록시가 IP 주소를 추출해야 하는지 여부를 지정합니다. WebSphere Application Server 요청의 개인 헤더. 플러그인이 프록시 앞에 배치되면 프록시 서버가 플러그인에서 전달된 개인 헤더 대신 채널에서 클라이언트 IP 주소를 추출합니다. 이 특성이 true로 설정되면 프록시 서버가 채널 대신 신뢰 플러그인에서 전송된 개인 HTTP 헤더에서 클라이언트 정보를 추출합니다.
| 정보 | 값 |
|---|---|
| 데이터 유형 | 문자열 |
| 기본값 | 아니오 |
http.connectionPoolUseForPOST
프록시 서버가 POST 요청에 대해 연결 풀링을 사용하는지 여부를 지정합니다. 기본적으로 POST 요청은 풀링되거나 지속적인 요청도 아닙니다. 따라서, 과도한 POST 요청이 프록시 서버를 통해 전송되면 포트 고갈이 발생하여 바인드 예외가 발생할 수 있습니다. 이 특성을 true로 설정하면, 연결 풀링은 POST 요청에 사용됩니다.
| 정보 | 값 |
|---|---|
| 데이터 유형 | boolean |
| 기본값 | 아니오 |
http.connectRetryLimit
WebSphere Proxy Server가 백엔드 서버가 중지된 것으로 표시되기 전까지 연결 설정을 시도해야 하는 횟수를 지정합니다.
이 사용자 정의 특성을 WebSphere Proxy Server 설정에 추가하지 않으면 WebSphere Proxy Server가 백엔드 서버와의 연결에 실패할 때마다 해당 서버는 중지된 것으로 표시되고 해당 서버로의 추가 요청은 다른 연결 시도가 성공하더라도 retryAfterValue 사용자 정의 특성에 지정된 횟수만큼 경과될 때까지 라우팅되지 않습니다. 예를 들어, 첫 번째 연결 시도는 수명이 짧은 포트가 너무 빨리 다시 사용되어 이전 연결이 여전히 TIME_WAIT 상태이기 때문에 실패할 수 있습니다.
| 정보 | 값 |
|---|---|
| 데이터 유형 | 정수 |
| 기본값 | 0 |
http.disable.retry.on.503.uriprefix
프록시 서버가 초기 요청을 전송하는 백엔드 서버에서 503 응답을 수신할 때 프록시 서버가 자동으로 다른 서버를 재시도하지 않도록 URI 접두부를 지정합니다.
일반적으로 프록시 서버가 503 응답을 백엔드 서버에서 수신하면 프록시 서버는 백엔드 서버가 중지된 것으로 표시하고 요청을 다른 서버로 전송 시도합니다. 특정 URI 접두부에 대해 프록시 서버가 백엔드 서버가 중지된 것으로 표시되지 않도록 하고 자동으로 다른 서버로 재시도하지 않도록 하려는 경우, 해당 접두부를 이 사용자 정의 값으로 지정할 수 있습니다. 이 특성에 대해 지정된 모든 URI 접두부에 대해 프록시 서버가 백엔드 서버에서 해당 요청에 대해 503 응답을 수신하면 프록시 서버는 요청을 재시도하지 않고 503 응답을 직접 클라이언트로 리턴합니다. 프록시 서버는 백엔드 서버가 중지된 것으로 표시하지도 않습니다.
| 정보 | 값 |
|---|---|
| 데이터 유형 | 쉼표로 구분된 URI 접두부를 구성하는 문자열입니다. |
| 기본값 | 기본값 없음 |
http.disableresponsebufferingurls
하트비트 애플리케이션에 대해 프록시 서버가 응답을 버퍼링하는 조건을 지정합니다.
특성 값은 쉼표로 구분되는 URL 패턴입니다(예:
/application_a/.*html;/application_b/.*html). 예를 들어, 프록시 서버가 사용자 정의 특성의 URI 패턴 중 하나에
일치하는 /application_a/heartbeat.html
요청을 수신하면 프록시 서버는 요청의 응답 본문을 버퍼링하지
않습니다. 이 예제에서 프록시 서버가 바이트를 리턴하는 경우 이는 버퍼링 없이 클라이언트 측으로 바이트를 전달합니다.
이 사용자 정의 특성을 사용하지 않으면 프록시 서버는 응답을 수신하고 부분 응답 본문 한계에 도달할 때까지 응답 본문을 버퍼링합니다.
http.ignore.compliance.via
사용자 정의 특성 http.compliance.via를 무시하는 방법을 지정합니다.
기본값은 true이고 프록시 서버는 사용자 정의 특성 http.compliance.via를 무시합니다. http.ignore.compliance.via를 false로 설정하는 경우 프록시 서버는 사용자 정의 특성 http.compliance.via 값을 사용합니다.
http.isDisable10ResponseCaching
프록시가 HTTP 1.0 클라이언트의 응답을 청크하지 않고 버퍼링하는지 여부를 지정합니다.
http.isDisable10ResponseCaching 특성이 true로 설정되는 경우, 프록시 서버는 컨텐츠 길이 헤더를 생성하지 않고 클라이언트 측 응답에 청크된 데이터를 포함하지 않습니다. 그 대신, 프록시 서버는 응답 본문의 끝 표시에서 연결을 닫습니다.
| 정보 | 값 |
|---|---|
| 데이터 유형 | boolean |
| 기본값 | 아니오 |
http.log.history
프록시 서버 로그 파일의 히스토리 파일 수를 늘릴 수 있습니다.
프록시 서버 로그 파일은 proxy.log, local.log, cache.log 파일입니다. 이 사용자 정의 특성이 없는 경우 프록시 서버 로그 파일에 대해 하나의 히스토리 파일이 있습니다.
| 정보 | 값 |
|---|---|
| 데이터 유형 | 부울 |
| 기본값 | 1 |
http.log.history.backup.list
프록시 서버 로그 디렉토리에서 히스토리 파일을 확인하고 파일이 있는 경우 이를 작성하는 새 로그 파일로 추가할 수 있도록 합니다.
http.log.history.backup.list 사용자 정의 특성을 1로 설정하는 경우 프록시 서버는 프록시 서버 로그 디렉토리에서 cache.log, local.log, proxy.log 파일의 히스토리 버전을 검색합니다. 히스토리 버전이 있는 경우, 해당 버전은 작성하는 임의의 신규 로그 파일에 추가됩니다.
이 사용자 정의 특성이 적용되려면 HTTP 프록시 서버에 대해 로깅이 사용 가능해야 합니다.
| 정보 | 값 |
|---|---|
| 데이터 유형 | 부울 |
| 기본값 | 0 |
http.maxCachedPayload
프록시 서버가 컨텐츠 길이 헤더를 생성할 청크된 응답의 최대 크기를 지정합니다.
프록시 서버가 HTTP 1.0 클라이언트에 대해 청크된 응답을 수신하는 경우 프록시 서버는 HTTP 1.0 클라이언트가 청크된 메시지를 처리할 수 없고 메시지 청크 해제와 응답 본문에 대한 컨텐츠 길이 계산을 시도합니다. 청크된 응답의 크기가 이 특성에 지정된 크기 한계 이하일 경우 프록시 서버는 응답에 대해 컨텐츠 길이 헤더를 생성합니다. 청크된 응답이 이 특성에 지정된 크기 한계를 초과하는 경우 프록시는 500 오류 메시지를 리턴합니다.
| 정보 | 값 |
|---|---|
| 데이터 유형 | 정수 |
| 기본값 | 10485760 바이트 |
http.odcUpdateTimeout
서버가 시작되는 동안 정보를 라우트하기 전에 HTTP 프록시 서버를 대기하는 시간(초)을 지정합니다. 프록시 서버는 포트를 바인딩하기 전에 지정된 시간(초) 동안 대기합니다.
이 사용자 정의 특성은 시작 시(HTTP/HTTPS 포트가 바인드되기 전) 라우팅 정보 전파에 허용되는 시간 동안 지연을 구성하기 위해 사용할 수 있습니다. 값을 300으로 설정하면 라우팅 정보를 프록시 서버로 전파하는 데 허용되는 300초 동안 프록시 서버가 대기합니다. 300초 전에 라우팅 정보가 프록시 서버로 전파되면 서버 시작이 재개됩니다.
| 정보 | 값 |
|---|---|
| 데이터 유형 | 문자열 |
| 기본값 | 150 |
http.pmiTimerInterval
PMI 통계가 프록시 서버에 기록되는 예상 시간 간격(밀리초)을 지정합니다.
| 정보 | 값 |
|---|---|
| 데이터 유형 | 정수 |
| 기본값 | 100 |
http.routing.sendReverseProxyNameInHost
호스트 헤더가 호스트 헤더에 없는 콘텐츠에 대해 다시 작성되는지 여부를 지정합니다. WebSphere Application Server 콘텐츠 서버.
이 특성에 대한 옵션은 true 또는 false이며 대소문자가 구분되지 않습니다. 이 속성의 값이 다음과 같은 경우false , 그러면 호스트 헤더가 대상 서버의 호스트로 다시 작성됩니다. 이 특성의 값이 true이면 호스트 헤더가 다시 작성되지 않습니다.
| 정보 | 값 |
|---|---|
| 데이터 유형 | 부울 |
| 기본값 | 아니오 |
http.virtual.port.map
백엔드 서버가 응답을 다시 올바른 외부 웹 사이트 포트로 전송하는 데 사용하는 서버 포트 맵핑 정보를 지정합니다.
포트 맵핑 정보가 프록시 서버 전면에 배치되는 로드 밸랜서에서 구성되는 경우, 프록시 서버는 올바른 외부 웹 사이트 포트 정보를 백엔드 서버로 전달하지 못할 수도 있는데 이는 외부 웹 사이트 포트 번호가 웹 서버 플러그인과 다르거나 프록시 서버 청취 포트와 다르기 때문일 수 있습니다. 이 사용자 정의 특성을 사용하여 프록시 서버가 백엔드 서버로 전달하기 전에 포트 정보를 정정할 수 있습니다.
Name: http.virtual.port.map Value: 20080:80;20443:443
| 정보 | 값 |
|---|---|
| 데이터 유형 | 세미콜론으로 구분되는 포트 맵핑 쌍의 문자열 값 |
| 기본값 | 없음 |
HTTPProxyAdvisorMethodName
HTTP 메소드 이름을 지정합니다(보통 사용되는 메소드에 대한 HEAD, GET). HTTP 메소드 이름은 프론트 엔드 로드 밸런서에 설정된 어드바이저 메소드이기도 합니다. 사용자 정의 특성은 프록시가 수신 요청을 일치시키고 로드 밸런서의 요청인지 여부를 판별하도록 합니다.
| 정보 | 값 |
|---|---|
| 데이터 유형 | 문자열 값(HTTP 메소드 이름(예: GET 또는 READ)) |
| 기본값 | 없음 |
HTTPProxyAdvisorStartupDelay
HTTP 어드바이저 시작 지연(초)을 지정합니다. 기본값은 0초입니다.
현재 프록시 시작 시간이 HTTPProxyAdvisorStartupDelay 사용자 정의 특성에 정의된 값보다 작은 경우 프록시/백엔드 서버가 HTTP 요청에 서비스를 제공할 준비가 되지 않았음을 로드 밸런서에 알리기 위해 프록시 서버에서 직접 HTTP 503 오류 코드가 리턴됩니다.
현재 프록시 시작 시간이 HTTPProxyAdvisorStartupDelay 사용자 정의 특성에 정의된 값보다 이후인 경우, 프록시는 어드바이저 요청을 백엔드로 전달하고 프론트엔드 로드 밸런서로 응답을 다시 리턴합니다. 백엔드 서버에서 리턴된 상태 코드를 기반으로 프론트 엔드 로드 밸런서는 프록시/백엔드 서버가 요청에 서비스를 제공할 준비가 되었는지 여부를 판별합니다.
프록시가 종료 중인 경우, 프록시 서버는 어드바이저 요청에 대해 503 오류 코드를 리턴합니다. 이 오류 코드는 프록시, 백엔드 서버가 추가 요청에 서비스를 제공할 수 없고 프론트 엔드 로드 밸런서가 이 프록시 서버에 전송하는 요청을 중지해야 함을 로드 밸런서에 알립니다.
| 정보 | 값 |
|---|---|
| 데이터 유형 | 정수(초) |
| 기본값 | 0 |
HTTPProxyAdvisorURI
완전한 URI 문자열을 지정합니다. 프론트 엔드 로드 밸런서에 설정된 어드바이저 URI이기도 합니다. 백엔드 서버의 애플리케이션은 이 요청 URI에 응답하도록 구성해야 합니다. 사용자 정의 특성은 프록시가 수신 요청을 일치시키고 로드 밸런서의 요청인지 여부를 판별하도록 합니다.
| 정보 | 값 |
|---|---|
| 데이터 유형 | 문자열 값(완전한 URI) |
| 기본값 | 없음 |
HTTPProxyAdvisorUserAgent
프론트 엔드 로드 밸런서 사용자 에이전트 이름을 지정합니다. 이 사용자 정의 특성은 프록시가 수신 요청을 일치시키고 로드 밸런서의 요청인지 여부를 판별하도록 합니다.
| 정보 | 값 |
|---|---|
| 데이터 유형 | 문자열 값(HTTP User-Agent 헤더 값) |
| 기본값 | 없음 |
http.useHostHeaderPort
특성이 true로 설정되면 프록시 서버는 $WSSP 개인용 헤더를 호스트 헤더에 지정한 포트로 지정합니다. 특성이 false로 설정되면 $WSSP 개인용 헤더는 HTTP 스키마를 기반으로 기본 포트로 설정됩니다.
| 정보 | 값 |
|---|---|
| 데이터 유형 | 부울 |
| 기본값 | 예 |
HTTPSustainedHighVolumeLogging
이 사용자 지정 속성은 패널에서 설정할 수 있습니다.
LBIPAddr
세미콜론으로 구분된 IP 주소 목록을 지정합니다. 이 사용자 정의 특성은 프록시가 수신 요청을 일치시키고 로드 밸런서의 요청인지 여부를 판별하도록 합니다.
| 정보 | 값 |
|---|---|
| 데이터 유형 | 문자열 값(세미콜론으로 구분되는 IP 주소) |
| 기본값 | 없음 |
localOutboundTCPAddress
HTTP 통신량 전용 호스트 인터페이스를 지정합니다. 이 특성은 HTTP 컨테이너에 아웃바운드 HTTP를 연결하는 데 사용되는 인터페이스를 판별합니다.
| 정보 | 값 |
|---|---|
| 데이터 유형 | 문자열 |
| 기본값 | * |
normalize.redirect.URL
true로 설정되면 프록시 서버 경로 재지정 라우트 규칙에 지정된 URI는 정규화되고 후미 슬래시('/')는 제거됩니다. 값이 false인 경우 URI는 변경되지 않습니다. 기본값은 true로 설정됩니다.
http.maxTargetReconnects
각 요청에 대해 동일한 대상 콘텐츠 서버에 재연결할 수 있는 최대 횟수를 지정합니다.
| 정보 | 값 |
|---|---|
| 데이터 유형 | 정수 |
| 기본값 | 5 |
http.maxTargetRetries
ODR이 각 요청에 대해 새로운 대상 콘텐츠 서버를 선택하려고 시도하는 최대 횟수를 지정합니다.
| 정보 | 값 |
|---|---|
| 데이터 유형 | 정수 |
| 기본값 | 5 |
http.routing.sendReverseProxyNameInHost (아웃바운드 연결 속성용)
ODR 이름이 WebSphere Application Server 콘텐츠 서버. 옵션은 true 또는 false이며 대소문자가 구분되지 않습니다.
| 정보 | 값 |
|---|---|
| 데이터 유형 | 부울 |
| 기본값 | 아니오 |
http.compliance.disable
V1.1 ODR 콘텐츠 서버 연결에 대해 ODR 콘텐츠 서버 연결 준수( HTTP )가 적용되는지 여부를 결정합니다. 옵션은 참 또는 거짓이며 대소문자를 구분하지 않습니다.
| 정보 | 값 |
|---|---|
| 데이터 유형 | 부울 |
| 기본값 | 아니오 |
http.compliance.via
HTTP 준수를 위해 요청과 응답에 추가되는 via 헤더의 값입니다. 값이 널이면 매개 헤더는 추가되지 않습니다. 값이 true이면 기본 매개 값이 추가됩니다. 그렇지 않으면, 지정된 문자열 매개 값이 추가됩니다. 기본값은 널입니다.
| 정보 | 값 |
|---|---|
| 데이터 유형 | 문자열 |
| 기본값 | 널 |