HTTP 전송 채널 사용자 정의 특성

HTTP 전송 채널을 사용하는 경우, 이 채널에 대한 구성 설정값에 다음의 사용자 정의 특성을 추가할 수 있습니다.

유의: 다음과 같은 네 가지 웹 컨테이너 전송 체인이 있습니다.
  • WCInboundAdmin
  • WCInboundAdminSecure
  • WCInboundDefault
  • WCInboundDefaultSecure

애플리케이션 서버 또는 프록시 서버는 WCInboundAdmin 또는 WCInboundAdminSecure 전송 체인에 지정된 사용자 정의 특성 값을 상속합니다. 이러한 체인 중 하나가 일반적으로 애플리케이션 서버가 초기화될 때 활성화되는 첫 번째 체인이기 때문입니다. 따라서 웹 컨테이너 전송 체인의 사용자 정의 특성을 지정하기 전에 WCInboundAdmin 및 WCInboundAdminSecure 전송 체인을 사용 불가능하게 해야 합니다.

사용자 정의 특성을 추가하려면 다음을 수행하십시오.
  1. 관리 콘솔에서 서버 > 서버 유형을 클릭한 후 작성하려는 체인의 유형에 따라 다음 옵션 중 하나를 선택하십시오.
    • 애플리케이션 서버 > > server_name. 웹 컨테이너 설정 아래에서 웹 컨테이너 전송 체인 >chain_name> HTTP 인바운드 채널 > 사용자 정의 특성 > 새로 작성을 클릭하십시오.
    • WebSphere 프록시 서버 > server_name. HTTP 프록시 서버 설정 아래에서 프록시 서버 전송을 클릭하십시오. 그런 다음 HTTPS_PROXY_CHAIN 또는 HTTP_PROXY_CHAIN을 선택한 후 > HTTP 인바운드 채널 > 사용자 정의 특성 > 새로 작성을 선택하십시오.
  2. 일반 특성 아래의 이름 필드에 사용자 정의 특성의 이름을 지정하고 값 필드에 이 특성에 대한 값을 지정하십시오. 또한 설명 필드에 이 특성의 설명을 지정할 수도 있습니다.
  3. 적용 또는 확인을 클릭하십시오.
  4. 저장을 클릭하여 구성 변경사항을 저장하십시오.
  5. 서버를 다시 시작하십시오.
다음은 제품과 함께 제공되는 HTTP 전송 채널 사용자 정의 특성에 대한 설명입니다. 이러한 특성은 HTTP 전송 채널의 설정 페이지에 표시되지 않습니다.사용자 정의 특성 페이지를 사용하여 다음 특성을 정의할 수 있습니다.

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
이 설정에 따라 각 요청에 대한 다음 정보가 지정된 순서로 NCSA 액세스 로그에 포함됩니다.
  • 원격 호스트
  • 요청의 HeaderName 헤더 값
  • WebSphere 특정 $WSRU 헤더에 따른 원격 사용자
  • NCSA 형식의 요청 시작 시간
  • 요청의 첫 번째 행
  • 응답의 상태 코드
  • 헤더를 제외한 응답 크기(바이트)
참고: 이 사용자 정의 특성을 사용하는 경우 체인별 로깅 사용 옵션이 NCSA 액세스 로깅에 대한 구성 설정의 일부로 선택되는지 확인하십시오. 기본적으로 글로벌 로깅 사용 서비스 옵션이 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입니다.

유의: localLogFilenamePrefix 사용자 정의 특성에 값을 지정하려면 accessLogFileName HTTP 채널 사용자 정의 특성을 프로세스 요청에 사용할 로그 파일의 완전한 이름으로 설정해야 합니다. 이 사용자 정의 특성의 값으로 $(SERVER_LOG_ROOT)와 같은 변수는 지정할 수 없습니다.
정보
데이터 유형 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 특성을 사용하여 로깅 코드를 통해 항목의 백로그를 추적할 수 있습니다. 이 특성은 관리 콘솔 Application Server > 서버 이름 > 웹 컨테이너 전송 체인 > 체인 이름 > HTTP 채널 이름 > 사용자 정의 특성에서 설정합니다.

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

주제 유형을 표시하는 아이콘 참조 주제



시간소인 아이콘 마지막 업데이트 날짜: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rrun_chain_httpcustom
파일 이름:rrun_chain_httpcustom.html