HTTP 전송 채널 사용자 정의 특성
HTTP 전송 채널을 사용하는 경우, 이 채널에 대한 구성 설정값에 다음의 사용자 정의 특성을 추가할 수 있습니다.
- WCInboundAdmin
- WCInboundAdminSecure
- WCInboundDefault
- WCInboundDefaultSecure
애플리케이션 서버 또는 프록시 서버는 WCInboundAdmin 또는 WCInboundAdminSecure 전송 체인에 지정된 사용자 정의 특성 값을 상속합니다. 이러한 체인 중 하나가 일반적으로 애플리케이션 서버가 초기화될 때 활성화되는 첫 번째 체인이기 때문입니다. 따라서 웹 컨테이너 전송 체인의 사용자 정의 특성을 지정하기 전에 WCInboundAdmin 및 WCInboundAdminSecure 전송 체인을 사용 불가능하게 해야 합니다.
- 관리 콘솔에서
- . 웹 컨테이너 설정 아래에서 chain_name 을 클릭하십시오.
- . HTTP 프록시 서버 설정 아래에서 을 클릭하십시오. 그런 다음 또는 을 선택한 후 을 선택하십시오.
을
클릭한 후 작성하려는 체인의 유형에 따라 다음 옵션 중 하나를 선택하십시오. - 일반 특성 아래의 이름 필드에 사용자 정의 특성의 이름을 지정하고 값 필드에 이 특성에 대한 값을 지정하십시오. 또한 설명 필드에 이 특성의 설명을 지정할 수도 있습니다.
- 적용 또는 확인을 클릭하십시오.
- 저장을 클릭하여 구성 변경사항을 저장하십시오.
- 서버를 다시 시작하십시오.
- accessLogFormat
- CookiesConfigureNoCache
- DoNotAllowDuplicateSetCookies
- EnableBuildBackupList
- HonorTransferEncoding
- limitFieldSize
- limitNumHeaders
- localLogFilenamePrefix
- loggingDisable
- QuoteAddedNoCacheValue
- RemoveCLHeaderInTempStatusRespRFC7230compat
- RemoveServerHeader
- ServerHeaderValue
- UseCaseSensitiveKeyMatcher
- v0CookieDateRFC1123compat
- WaitForEndOfMessage
accessLogFormat
accessLogFormat 특성을 사용하여 HTTP 전송 채널의 NCSA 액세스 로그에 포함될 정보 및 이러한 정보의 형식을 지정할 수 있습니다. 이 특성의 값은 공백으로 구분된 옵션 목록입니다. 옵션 지정 순서는 로그에 있는 이 정보의 형식에 따라 결정됩니다.
각 옵션은 따옴표로 묶을 수 있지만 반드시 따옴표로 묶을 필요는 없습니다. 별다른 언급이 없는 한, 옵션에 대한 정보를 얻을 수 없는 경우 해당 옵션에 대해 - 값이 인쇄됩니다.
- %a
- 원격 IP 주소
- %A
- 로컬 IP 주소
- %b
- 헤더를 제외한 응답 크기(바이트)
- %B
- 헤더를 제외한 응답 크기(바이트)
값을 찾을 수 없는 경우 - 대신 0이 인쇄됩니다.
- %{CookieName}C 또는 %C
- 괄호 안에 요청 쿠키를 지정합니다. 대괄호가 포함되지 않은 경우 요청 쿠키가 모두 인쇄됩니다.
- %D
- 요청 경과 시간(정확도: 밀리초, 정밀도: 마이크로초)
- %h
- 원격 호스트
- %i 또는 %{HeaderName}i
- 요청의 HeaderName 헤더 값
- %m
- 요청 메소드
- %o 또는 %{HeaderName}o
- 응답의 HeaderName 헤더 값
- %q
- 비밀번호가 이스케이프 처리된 조회 문자열을 출력합니다.
- %r
- 요청의 첫 번째 행
- %s
- 응답의 상태 코드
- %t
- NCSA 형식의 요청 시작 시간
- %(t)W
- 액세스 로그에 대한 메시지를 일반 NCSA 형식으로 로깅하기 위해 큐에 대기하는 현재 시간입니다.
- %u
- WebSphere Application Server 특정 $WSRU 헤더에 따른 원격 사용자
- %U
- 조회 문자열을 제외한 URL 경로
- %{X}W
- XCT(Cross Component Tracing) 컨텍스트 ID
예를 들어 다음 지시문을 이 특성의 값으로 지정할 수 있습니다.
%h %i %u %t "%r" %s %b
- 원격 호스트
- 요청의 HeaderName 헤더 값
- WebSphere 특정 $WSRU 헤더에 따른 원격 사용자
- NCSA 형식의 요청 시작 시간
- 요청의 첫 번째 행
- 응답의 상태 코드
- 헤더를 제외한 응답 크기(바이트)
CookiesConfigureNoCache
HTTP 응답 메시지에 Set-Cookie 헤더를 나타냄으로써 헤더와 연관된 여러 캐시의 추가를 트리거할 것인지 여부를 CookiesConfigureNoCache 특성을 사용하여 지정하십시오. 이 특성을 true로 설정하면 아주 오래된 날짜의 Expires 헤더와, 클라이언트에게 Set-Cookie 헤더를 캐시하지 않도록 명시적으로 지시하는 Cache-Control 헤더가 자동으로 추가됩니다. 이 특성이 false로 설정되면 이러한 헤더가 자동으로 추가되지 않습니다.
이 특성은 제품의 이전 버전에서 사용 가능했던 com.ibm.websphere.cookies.no.header 특성과 기능적으로 같습니다.
정보 | 값 |
---|---|
데이터 유형 | 부울 |
기본값 | True |
DoNotAllowDuplicateSetCookies
HTTP 채널에서 이름이 동일한 여러 Set-Cookie 헤더를 전송하지 못하게 하려면 DoNotAllowDuplicateSetCookies 특성을 사용하십시오. 기본값은 false입니다.
정보 | 값 |
---|---|
기본값 | False |
EnableBuildBackupList
액세스 및 오류 로그 디렉토리에서 히스토리 파일을 검색하고 이 파일을 작성된 최신 로그 파일과 롤오버하기 위해 HTTP 채널을 활성화하려면 EnableBuildBackupList 특성을 사용하십시오.
이 특성을 true로 설정한 경우 HTTP 채널이 액세스 및 오류 로그 디렉토리에서 히스토리 파일을 검색하고 이 파일을 작성된 최신 로그 파일과 롤오버합니다.
- HTTP 오류 로그 및 NCSA 액세스 로그를 구성한 후 로깅을 수행할 HTTP 채널에 대해 NCSA 액세스 로깅 사용 가능 필드가 선택되어 있는지 확인하십시오. HTTP 채널에 대해 이 필드가 선택되어 있는지 확인하려면 서버 > 서버 유형 > 애플리케이션 서버 > server > 웹 컨테이너 전송 체인 > HTTP 인바운드 채널을 클릭하십시오. 이 사용자 정의 특성을 true로 설정하여 HTTP 채널 기능에 영향을 미치기 전에 이 설정을 사용 가능하게 해야 합니다.
- 이 사용자 정의 특성을 사용하는 경우 Use chain-specific logging 옵션도 NCSA 액세스 로깅 구성 설정의 일부로 선택해야 합니다. 기본적으로 NCSA 액세스 로깅에는 글로벌 로깅 서비스 사용 옵션이 선택됩니다.
정보 | 값 |
---|---|
데이터 유형 | 부울 |
기본값 | False |
HonorTransferEncoding
청크가 하나만 있을 경우 HTTP 전송 채널이 청크된 메시지를 컨텐츠 길이의 구분된 메시지로 변환해야 하는지 여부를 표시하려면 HonorTransferEncoding 특성을 사용하십시오.
이 특성을 true로 설정하면 메시지가 하나의 청크로만 구성된 경우에도 HTTP 전송 채널이 컨텐츠 길이 메시지로 전환하는 대신 청크를 작성합니다. HTTP 전송 채널이 단일 청크 메시지마다 두 번의 쓰기를 수행하기 때문에 이 설정에 대한 성능 영향이 있습니다. 첫 번째 쓰기는 메시지용이고, 두 번째 쓰기는 메시지 끝을 표시하는 0바이트 청크용입니다.
이 특성을 false로 설정할 경우 청크가 하나만 있을 때 HTTP 전송 채널은 청크된 메시지를 컨텐츠 길이의 구분된 메시지로 변환합니다. 이 설정은 컨텐츠 길이의 메시지로 변환되는 단일 청크 메시지마다 채널이 한 번의 쓰기만 수행하기 때문에 채널 성능이 개선됩니다.
정보 | 값 |
---|---|
데이터 유형 | 부울 |
기본값 | False |
limitFieldSize
limitFieldSize 특성을 사용하여 여러 HTTP 필드(예: 요청 URL)나 개별 헤더 이름 또는 값의 크기 제한을 강제 실행하십시오. 이러한 필드의 크기 제한을 강제 실행하면 서비스 거부 문제점을 방지할 수 있습니다. 필드에 허용된 크기를 초과하면 원격 클라이언트에 오류가 리턴됩니다.
정보 | 값 |
---|---|
데이터 유형 | 정수 |
기본값 | 32768 |
범위 | 50-32768 |
limitNumHeaders
limitNumHeaders 특성을 사용하여 수신 메시지에 나타낼 수 있는 HTTP 헤더의 수를 제한하십시오. 이 제한이 초과되면 클라이언트에 오류가 리턴됩니다.
정보 | 값 |
---|---|
데이터 유형 | 정수 |
기본값 | 500 |
범위 | 50 - 4000 |
localLogFilenamePrefix
localLogFilenamePrefix 특성을 사용하여 네트워크 로그 파일의 파일 이름에 접두부를 지정하십시오. 일반적으로, 인프로세스 최적화가 사용 가능한 경우에 인프로세스 경로를 통한 요청은 웹 컨테이너의 네트워크 채널 체인에 대해 설정된 로깅 속성을 기반으로 로깅됩니다. 이 특성을 사용하여 네트워크 로그 파일의 파일 이름에 접두부를 추가할 수 있습니다. 새 파일 이름은 인프로세스 요청에 대한 로그 파일의 파일 이름으로 사용됩니다. 인프로세스 경로를 통해 전송된 요청은 네트워크 로그 파일 대신에 이 파일에 로그됩니다. 예를 들어, 로그 파일 이름이 네트워크 전송 체인의 경우 .../httpaccess.log이고 이 특성이 해당 체인의 HTTP 채널에서 로컬로 설정되면 해당 체인과 연관된 호스트에 대한 처리 중인 요청에 대해 로그 파일의 파일 이름은 …/localhttpaccess.log입니다.
정보 | 값 |
---|---|
데이터 유형 | String |
loggingDisable
지정된 체인의 NCSA, FRCA 및 오류 로깅을 사용하지 않으려면 이 사용자 정의 특성을 사용하십시오.
정보 | 값 |
---|---|
데이터 유형 | 부울 |
기본값 | False |
QuoteAddedNoCacheValue
아직 속성이 없는 Cache-Control 응답 헤더에 따옴표로 묶인 no-cache 속성을 추가하려면 이 사용자 정의 특성을 사용하십시오.
HTTP 채널이 따옴표로 묶인 no-cache 속성을 헤더에 올바르게 추가합니다. 다음 예에서는 응답에서 제공되는 이 헤더에 no-cache 속성이 추가됩니다. Cache-Control: public, max-age=604800, no-cache="set-cookie".
정보 | 값 |
---|---|
기본값 | False |
RemoveCLHeaderInTempStatusRespRFC7230compat
HTTP 채널이 응답 메시지에서 정보 상태가 1xx 또는 204인 Content-Length 헤더를 전송하지 못하게 하려면 RemoveCLHeaderInTempStatusRespRFC7230compat 특성을 사용하십시오.
정보 | 값 |
---|---|
기본값 | False |
RemoveServerHeader
RemoveServerHeader 특성을 사용하여 애플리케이션 서버가 전송하는 HTTP 응답으로부터 서버 헤더를 제거하여 서버 프로그램의 ID를 숨기도록 강제 실행하십시오.
정보 | 값 |
---|---|
데이터 유형 | 부울 |
기본값 | False |
ServerHeaderValue
ServerHeaderValue 특성을 사용하여 서버 헤더가 존재하지 않는 경우 서버로 모든 전송 HTTP 응답에 추가되는 서버 헤더 기본값을 대체하십시오. 서버 헤더의 기본값은 WebSphere Application Server v/x.x이며 여기서 x.x는 시스템에서 실행 중인 WebSphere Application Server의 버전입니다.
버전 8.5.0.2 이전에 서버 헤더가 이 특성 값으로 지정한 기본 서버 헤더 또는 헤더에 존재하지 않는 경우 서버에서 보내는 모든 HTTP 응답에 추가됩니다.
버전 8.5.0.2로 시작하면 서버 헤더는 서버 헤더가 존재하지 않는 경우 더 이상 모든 전송 HTTP 응답을 자동으로 추가할 수 없습니다. 이 특성을 값과 함께 추가하는 경우, 해당 값이 응답에 나타나는 서버 헤더에 포함됩니다. 값 DefaultServerValue을 지정하면 WebSphere Application Server v/x.x 는 서버 헤더 값으로 사용됩니다.
정보 | 값 |
---|---|
데이터 유형 | String |
SustainedHighVolumeLogging
SustainedHighVolumeLogging 특성을 사용하여 로깅 코드를 통해 항목의 백로그를 추적할 수 있습니다. 이 특성은 관리 콘솔
에서 설정합니다.UseCaseSensitiveKeyMatcher
UseCaseSensitiveKeyMatcher는 accessLogFormat과 관련하여 사용됩니다.
이 특성을 true로 설정하면 accessLogFormat에서 사용되는 Key Matcher가 대소문자를 구분할 수 있습니다. 이로써 소문자로 된 지시문과 대문자로 된 지시문(즉, %u 및 %U)이 모두 있는 경우 이 상황을 해결할 수 있습니다.
정보 | 값 |
---|---|
기본값 | False |
v0CookieDateRFC1123compat
v0CookieDateRFC1123compat 특성을 사용하여 V0 Set-Cookie header Expires 속성 값을 두 자리 연도 형식이 아닌 네 자리 연도 형식으로 지정하도록 표시할 수 있습니다.
기본적으로 V0 Set-Cookie header Expires 속성 값은 두 자리 연도 형식으로 지정됩니다. V0 Set-Cookie Expires 속성 값을 네 자리 연도 형식으로 지정하는 기존의 RFC1123을 사용하려면 v0CookieDateRFC1123compat 특성을 true로 설정하십시오.
정보 | 값 |
---|---|
데이터 유형 | 부울 |
기본값 | False |
WaitForEndOfMessage
채널이 메시지가 끝까지 읽혀질 때까지 기다린 후 응답을 처리하도록 하려면 이 사용자 정의 특성을 사용하십시오.
정보 | 값 |
---|---|
기본값 | False |