httpEndpoint - HTTP 엔드포인트 (httpEndpoint)

HTTP 엔드포인트의 구성 특성입니다.

NameTypeDefaultDescription
id문자열고유 구성 ID입니다.
onError
  • IGNORE
  • WARN
  • FAIL
WARN엔드포인트 시작에 실패한 후 수행하는 조치입니다.
IGNORE
구성 오류가 발생한 경우 서버가 경고 및 오류 메시지를 발행하지 않습니다.
WARN
구성 오류가 발생한 경우 서버는 경고 및 오류 메시지를 발행합니다.
FAIL
첫 번째 오류가 발생한 경우 서버는 경고 또는 오류 메시지를 발행하고 서버를 중지시킵니다.
enabledbooleantrue엔드포인트의 가용성을 토글하십시오. True일 때는 이 엔드포인트가 디스패처에 의해 활성화되어 HTTP 요청을 처리합니다.
hoststringlocalhost클라이언트가 자원을 요청하는 데 사용하는 IP 주소, 도메인 이름 접미부를 갖는 도메인 이름 서버(DNS) 호스트 이름 또는 DNS 호스트 이름만입니다. 모든 사용 가능한 네트워크 인터페이스에 대해서는 '*'를 사용하십시오.
httpPortint
Min: -1

Max: 65535
클라이언트 HTTP 요청에 사용되는 포트입니다. 이 포트를 사용 안 하려면 -1을 사용하십시오.
httpsPortint
Min: -1

Max: 65535
SSL(https)로 보안되는 클라이언트 HTTP 요청에 사용되는 포트입니다. 이 포트를 사용 안 하려면 -1을 사용하십시오.
httpOptionsRef최상위 레벨 httpOptions 요소에 대한 참조입니다(문자열).defaultHttpOptions엔드포인트에 대한 HTTP 프로토콜 옵션입니다.
sslOptionsRef최상위 레벨 sslOptions 요소에 대한 참조입니다(문자열).엔드포인트에 대한 SSL 프로토콜 옵션입니다.
tcpOptionsRef최상위 레벨 tcpOptions 요소에 대한 참조입니다(문자열).defaultTCPOptions엔드포인트에 대한 TCP 프로토콜 옵션입니다.
accessLoggingRef최상위 레벨 httpAccessLogging 요소에 대한 참조입니다(문자열).엔드포인트에 대한 HTTP 액세스 로깅 구성입니다.

httpOptions

엔드포인트에 대한 HTTP 프로토콜 옵션입니다.

NameTypeDefaultDescription
keepAliveEnabledbooleantrue지속적 연결을 사용합니다(HTTP KeepAlive). True인 경우 연결은 다중 순차 요청 및 응답이 재사용하도록 유지됩니다. False인 경우 연결은 응답이 전송된 후에 닫힙니다.
maxKeepAliveRequestsint
Min: -1
100지속적 연결이 사용 가능한 경우 단일 HTTP 연결에서 허용되는 최대 지속적 요청 수입니다. -1의 값은 무제한을 의미합니다.
persistTimeout초 정밀도를 사용하는 기간30s소켓이 요청 사이에 유휴 상태로 남도록 허용되는 시간입니다. 이 설정은 지속적 연결이 사용 가능한 경우에만 적용됩니다. 시간 단위가 뒤따르는 양수를 지정하십시오. 이는 시간(h), 분(m) 또는 초(s)일 수 있습니다. 예를 들어, 30초를 30s로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1m30s는 90초와 동등합니다.
readTimeout초 정밀도를 사용하는 기간60s읽기 요청이 첫 번째 읽기가 발생한 후 소켓에서 완료하기를 대기하는 시간입니다. 시간 단위가 뒤따르는 양수를 지정하십시오. 이는 시간(h), 분(m) 또는 초(s)일 수 있습니다. 예를 들어, 30초를 30s로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1m30s는 90초와 동등합니다.
writeTimeout초 정밀도를 사용하는 기간60s응답 데이터의 각 부분이 전송되기를 소켓에서 대기하는 시간입니다. 시간 단위가 뒤따르는 양수를 지정하십시오. 이는 시간(h), 분(m) 또는 초(s)일 수 있습니다. 예를 들어, 30초를 30s로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1m30s는 90초와 동등합니다.
removeServerHeaderbooleanfalseHTTP 헤더에서 서버 구현 정보를 제거하고 기본 Liberty 프로파일 환영 페이지도 사용하지 않도록 설정하십시오.
NoCacheCookiesControlbooleantrue사용자가 쿠키 설정 헤더의 존재가 캐시 없음 값이 일치하는 캐시 제어 헤더를 업데이트해야 하는지 여부를 제어할 수 있도록 허용합니다. 이는 또한 만기 헤더를 추가합니다.
AutoDecompressionbooleantrueHTTP 채널이 수신 요청 본문 데이터를 자동으로 압축 해제하는지 여부를 지정합니다.

sslOptions

엔드포인트에 대한 SSL 프로토콜 옵션입니다.

NameTypeDefaultDescription
sessionTimeout초 정밀도를 사용하는 기간1d소켓에서 읽기 또는 쓰기 요청이 완료되기를 기다리는 시간입니다. 이 값은 프로토콜별 제한시간으로 대체됩니다. 시간 단위가 뒤따르는 양수를 지정하십시오. 이는 시간(h), 분(m) 또는 초(s)일 수 있습니다. 예를 들어, 30초를 30s로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1m30s는 90초와 동등합니다.
suppressHandshakeErrorsbooleanfalseSSL 핸드쉐이크 오류 로깅을 사용하지 않습니다. 일반 조작 중에 SSL 핸드쉐이크 오류가 발생할 수 있습니다. 그러나 SSL이 예상치 못한 방식으로 작동할 때 이 메시지가 유용할 수 있습니다.
sslRef최상위 레벨 ssl 요소에 대한 참조입니다(문자열).기본 SSL 구성 레퍼토리입니다. 기본값은 defaultSSLSettings입니다.
sslSessionTimeout밀리초 정밀도를 사용하는 기간8640msSSL 채널을 통해 설정되는 SSL 세션의 제한시간 한계입니다. 시간 단위가 뒤따르는 양수를 지정하십시오. 이는 시간(h), 분(m), 초(s) 또는 밀리초(ms)일 수 있습니다. 예를 들어, 500밀리초를 500ms로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1s500ms는 1.5초와 동등합니다.

tcpOptions

엔드포인트에 대한 TCP 프로토콜 옵션입니다.

NameTypeDefaultDescription
inactivityTimeout밀리초 정밀도를 사용하는 기간60s소켓에서 읽기 또는 쓰기 요청이 완료되기를 기다리는 시간입니다. 이 값은 프로토콜별 제한시간으로 대체됩니다. 시간 단위가 뒤따르는 양수를 지정하십시오. 이는 시간(h), 분(m), 초(s) 또는 밀리초(ms)일 수 있습니다. 예를 들어, 500밀리초를 500ms로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1s500ms는 1.5초와 동등합니다.
soReuseAddrbooleantrue활성 리스너 없이 포트에 대한 즉각적 리바인드를 사용합니다.
addressIncludeListstring이 엔드포인트에서 인바운드 연결을 허용하는 쉼표로 구분된 주소 목록입니다. IPv4 또는 IPv6 주소를 지정할 수 있습니다. IPv4 또는 IPv6 주소의 모든 값은 숫자 또는 별표(*) 와일드카드 문자로 나타내야 합니다.
addressExcludeListstring이 엔드포인트에서 인바운드 연결을 허용하지 않는 쉼표로 구분된 주소 목록입니다. IPv4 또는 IPv6 주소를 지정할 수 있습니다. IPv4 또는 IPv6 주소의 모든 값은 숫자 또는 별표(*) 와일드카드 문자로 나타내야 합니다.
hostNameIncludeListstring이 엔드포인트에서 인바운드 연결을 허용하는 쉼표로 구분된 호스트 이름 목록입니다. 호스트 이름은 대소문자를 구분하지 않고 와일드카드 문자로 사용되는 별표(*)로 시작될 수 있습니다. 그러나 별표(*)는 호스트 이름의 다른 위치에 올 수 없습니다. 예를 들어, *.abc.com은 유효하지만 *.abc.*는 유효하지 않습니다.
hostNameExcludeListstring이 엔드포인트에서 인바운드 연결을 허용하지 않는 쉼표로 구분된 호스트 이름 목록입니다. 호스트 이름은 대소문자를 구분하지 않고 와일드카드 문자로 사용되는 별표(*)로 시작될 수 있습니다. 그러나 별표(*)는 호스트 이름의 다른 위치에 올 수 없습니다. 예를 들어, *.abc.com은 유효하지만 *.abc.*는 유효하지 않습니다.

accessLogging

엔드포인트에 대한 HTTP 액세스 로깅 구성입니다.

NameTypeDefaultDescription
enabledbooleantrue액세스 로깅을 사용합니다.
filePath파일에 대한 경로${server.output.dir}/logs/http_access.log액세스 로그 파일의 이름 및 디렉토리 경로입니다. 디렉토리 경로를 지정할 때 ${server.output.dir} 같은 표준 변수 대체를 사용할 수 있습니다.
logFormatstring%h %u %{t}W "%r" %s %b클라이언트 액세스 정보를 로깅할 때 사용하는 로그 형식을 지정합니다.
maxFileSizeint
Min: 0
20로그 파일이 롤오버되기 전에 MB 단위의 최대 크기입니다. 값 0은 무제한을 의미합니다.
maxFilesint
Min: 0
2가장 오래된 파일이 제거되기 전에 유지될 최대 로그 파일 수입니다. 값 0은 무제한을 의미합니다.