HandleHttpRequest 2025.5.31.15¶

번들¶

org.apache.nifi | nifi-standard-nar

설명¶

HTTP 서버를 시작하고 HTTP 요청을 수신 대기합니다. 각 요청에 대해 FlowFile 을 생성하고 ‘성공’으로 전송합니다. 이 프로세서는 웹 서비스를 생성하기 위해 HandleHttpResponse 프로세서와 함께 사용하도록 설계되었습니다. 여러 부분으로 요청하는 경우 각 부분마다 FlowFile 이 1개씩 생성됩니다.

태그¶

http, https, ingress, listen, request, web service

입력 요구 사항¶

FORBIDDEN

민감한 동적 속성 지원¶

false

속성¶

속성	설명
추가 HTTP 메서드	쉼표로 구분된 비표준 HTTP 허용해야 하는 메소드 목록
DELETE 허용	HTTP DELETE 메서드 허용
GET 허용	HTTP GET 메서드 허용
HEAD 허용	HTTP HEAD 메서드 허용
OPTIONS 허용	HTTP OPTIONS 메서드 허용
POST 허용	HTTP POST 메서드 허용
PUT 허용	HTTP PUT 메서드 허용
허용된 경로	수신 URL 요청에 허용되는 유효한 HTTP 경로를 지정하는 정규식입니다. 이 값을 지정하고 HTTP 요청의 경로가 이 정규식과 일치하지 않으면 프로세서는 404: NotFound 로 응답합니다.
클라이언트 인증	프로세서가 클라이언트를 인증할지 여부를 지정합니다. <SSL Context Service> 속성이 지정되지 않았거나 제공된 SSL Context가 KeyStore 만 사용하고 TrustStore 는 사용하지 않는 경우 이 값은 무시됩니다.
기본 URL 문자 세트	HTTP 요청에 URL 매개 변수를 제공하지 않는 경우 디코딩에 사용할 문자 세트입니다
HTTP 컨텍스트 매핑	HTTP 요청 정보를 캐시하는 데 사용할 HTTP 컨텍스트 맵 컨트롤러 서비스
HTTP 프로토콜	TLS 와의 애플리케이션 계층 프로토콜 협상을 위해 지원되는 HTTP 프로토콜
호스트 이름	바인딩할 호스트 이름입니다. 지정하지 않으면 모든 호스트에 바인딩됩니다
수신 대기 포트	수신HTTP요청을 수신 대기할 포트입니다
최대 스레드	임베디드 HTTP 서버가 요청을 처리하는 데 사용할 최대 스레드 수입니다.
요청 헤더 최대 크기	이 프로세서로 전송되는 요청에서 지원되는 HTTP 헤더의 최대 크기입니다
SSL 컨텍스트 서비스	서버 보안을 위해 사용할 SSL 컨텍스트 서비스입니다. 지정하면 서버는 HTTPS 요청만 수락하고, 그렇지 않으면 HTTP 요청만 수락합니다
container-queue-size	Http 요청 컨테이너에 대한 큐 크기
multipart-read-buffer-size	수신 파일의 내용이 디스크에 기록되는 임계값 크기입니다. Content-Type: multipart/form-data인 요청에만 적용됩니다. 서비스 거부 유형의 공격을 방지하고 힙 또는 디스크 공간을 채우는 것을 방지하는 데 사용됩니다.
multipart-request-max-size	요청의 최대 크기입니다. 내용 타입이 multipart/form-data인 요청에만 적용되며, 서비스 거부 유형의 공격을 방지하고 힙 또는 디스크 공간을 채우는 것을 방지하기 위해 사용됩니다
parameters-to-attributes	특성으로 출력할 HTTP 매개 변수 또는 양식 데이터의 쉼표로 구분된 목록입니다

관계¶

이름	설명
성공	수신된 모든 내용은 ‘성공’ 관계로 라우팅됩니다

Writes 특성¶

이름	설명
http.context.identifier	HandleHttpRequest 및 HandleHttpResponse 가 어떤 FlowFile 가 어떤 HTTP 요청/응답에 속하는지 조정할 수 있도록 하는 식별자.
mime.type	HTTP 헤더 “내용 타입”에 따른 MIME 데이터 타입
http.servlet.path	서블릿 경로로 간주되는 URL 요청의 일부입니다
http.context.path	컨텍스트 경로로 간주되는 URL 요청의 일부입니다
http.method	요청에 사용되는 HTTP 메서드(예: GET 또는 POST)
http.local.name	IP 서버의 주소/호스트 이름
http.server.port	서버의 수신 포트
http.query.string	요청 URL 의 쿼리 문자열 부분
http.remote.host	요청자의 호스트 이름
http.remote.addr	The hostname:port combination of the requestor
http.remote.user	요청자의 사용자 이름
http.protocol	통신에 사용되는 프로토콜
http.request.uri	전체 요청 URL
http.auth.type	사용되는 HTTP 승인 유형
http.principal.name	요청을 하는 인증된 사용자의 이름
http.query.param.XXX	요청의 각 쿼리 매개 변수는 “http.query.param”이라는 접두사가 붙은 특성으로 추가됩니다
http.param.XXX	“매개 변수를 속성에 추가할 속성 목록”으로 구성된 요청의 양식 매개 변수는 “http.param.”이라는 접두사가 붙은 특성으로 추가됩니다. 크기가 큰 양식 매개 변수를 넣는 것은 권장하지 않습니다.
http.subject.dn	요청자의 고유 이름입니다. 프로세서가 SSLContext 서비스를 사용하도록 구성되지 않은 경우 이 값은 채워지지 않습니다
http.issuer.dn	주체의 인증서를 발급한 엔터티의 고유 이름입니다. 프로세서가 SSLContext 서비스를 사용하도록 구성되지 않은 경우 이 값은 채워지지 않습니다
http.certificate.sans.N.name	상호 TLS 인증의 X.509 클라이언트 인증서 주체 대체 이름 값입니다. 특성 이름은 클라이언트 인증서 내용에 따라 0부터 시작하는 인덱스가 정렬됩니다
http.certificate.sans.N.nameType	상호 TLS 인증의 X.509 클라이언트 인증서 주체 대체 이름 유형입니다. 특성 이름에는 클라이언트 인증서의 내용에 따라 정렬된 0부터 시작하는 인덱스가 있습니다. 특성 값은 RFC 3280 섹션 4.1.2.7의 일반 이름 중 하나입니다.
http.headers.XXX	요청에서 수신되는 각 HTTP 헤더는 “http.headers”라는 접두사가 붙은 특성으로 추가됩니다 예를 들어, 요청에 “x-my-header”라는 HTTP 헤더가 포함된 경우 “http.headers.x-my-header”라는 특성에 값이 추가됩니다
http.headers.multipart.XXX	멀티파트 요청에서 수신되는 각 HTTP 헤더는 “http.headers.multipart”라는 접두사가 붙은 특성으로 추가됩니다 예를 들어, 멀티파트 요청에 “content-disposition”이라는 HTTP 헤더가 포함된 경우 “http.headers.multipart.content-disposition”이라는 특성에 값이 추가됩니다
http.multipart.size	내용 타입이 “multipart/form-data”인 요청의 경우 해당 부분의 내용 크기가 이 특성에 기록됩니다.
http.multipart.content.type	내용 타입이 “multipart/form-data”인 요청의 경우 해당 부분의 내용 유형이 이 특성에 기록됩니다.
http.multipart.name	내용 타입이 “multipart/form-data”인 요청의 경우 해당 부분의 이름이 이 특성에 기록됩니다.
http.multipart.filename	내용 타입이 “multipart/form-data”인 요청의 경우 해당 부분에 업로드된 파일이 포함되어 있으면 파일 이름이 이 특성에 기록됩니다. 파일은 “java.io.File” Java Docs에 지정된 기본 임시 파일 디렉터리에 임시로 저장됩니다)
http.multipart.fragments.sequence.number	내용 타입이 “multipart/form-data”인 요청의 경우 해당 부분의 인덱스가 이 특성에 기록됩니다. 인덱스는 1로 시작합니다.
http.multipart.fragments.total.number	내용 타입이 “multipart/form-data”인 요청의 경우, 모든 부분의 개수가 이 특성에 기록됩니다.

참고 항목¶

org.apache.nifi.processors.standard.HandleHttpResponse