HandleHttpRequest 2025.10.2.19

Pacote

org.apache.nifi | nifi-standard-nar

Descrição

Inicia um servidor HTTP e detecta solicitações HTTP. Para cada solicitação, cria um FlowFile e o transfere para “success”. Este processador foi projetado para ser usado em conjunto com o processador HandleHttpResponse para criar um serviço Web. No caso de uma solicitação em várias partes, um FlowFile será gerado para cada parte.

Tags

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

Requisito de entrada

FORBIDDEN

Oferece suporte a propriedades dinâmicas confidenciais

falso

Propriedades

Propriedade

Descrição

Métodos HTTP adicionais

Uma lista separada por vírgulas de métodos HTTP não padrão que devem ser permitidos

Permitir DELETE

Permitir o método HTTP DELETE

Permitir GET

Permitir o método HTTP GET

Permitir HEAD

Permitir o método HTTP HEAD

Permitir OPTIONS

Permitir o método HTTP OPTIONS

Permitir POST

Permitir o método HTTP POST

Permitir PUT

Permitir o método HTTP PUT

Caminhos permitidos

Uma expressão regular que especifica os caminhos HTTP válidos que são permitidos nas solicitações de URL recebidas. Se esse valor for especificado e o caminho das solicitações HTTP não corresponder a essa expressão regular, o processador responderá com 404: NotFound

Autenticação do cliente

Especifica se o processador deve ou não autenticar os clientes. Esse valor será ignorado se a propriedade <SSL Context Service> não for especificada ou se o SSL Context fornecido usar apenas um KeyStore e não um TrustStore.

Conjunto de caracteres do URL padrão

O conjunto de caracteres a ser usado para decodificar os parâmetros de URL se a solicitação HTTP não fornecer um

Mapa de contexto HTTP

O Controller Service do mapa de contexto HTTP a ser usado para armazenar em cache as informações da solicitação HTTP

Protocolos HTTP

Protocolos HTTP compatíveis para negociação de protocolo de camada de aplicativo com TLS

Nome de host

O nome do host ao qual se vincular. Se não for especificado, será vinculado a todos os hosts

Porta de escuta

A porta para escutar as solicitações HTTP de entrada

Máximo de threads

O número máximo de threads que o servidor HTTP incorporado usará para processar solicitações.

Tamanho máximo do cabeçalho da solicitação

O tamanho máximo compatível dos cabeçalhos HTTP nas solicitações enviadas a esse processador

Serviço de contexto SSL

O serviço de contexto SSL a ser usado para proteger o servidor. Se especificado, o servidor aceitará apenas solicitações HTTPS; caso contrário, o servidor aceitará apenas solicitações HTTP

container-queue-size

O tamanho da fila de contêineres de solicitação HTTP

multipart-read-buffer-size

O tamanho limite, no qual o conteúdo de um arquivo de entrada seria gravado no disco. Aplica-se somente a solicitações com Content-Type: multipart/form-data. Ele é usado para evitar ataques do tipo negação de serviço, para evitar o preenchimento do heap ou do espaço em disco.

multipart-request-max-size

O tamanho máximo da solicitação. Aplica-se somente a solicitações com Content-Type: multipart/form-data e é usado para evitar ataques do tipo negação de serviço, para evitar o preenchimento da pilha ou do espaço em disco

parameters-to-attributes

Uma lista de parâmetros HTTP ou dados de formulário separados por vírgula a serem emitidos como atributos

Relações

Nome

Descrição

success

Todo o conteúdo recebido é encaminhado para a relação “success”

Grava atributos

Nome

Descrição

http.context.identifier

Um identificador que permite que o HandleHttpRequest e HandleHttpResponse coordenem qual FlowFile pertence a qual solicitação/resposta HTTP.

mime.type

O tipo MIME dos dados, de acordo com o “Content-Type” do cabeçalho HTTP

http.servlet.path

A parte do URL de solicitação que é considerada o caminho do Servlet

http.context.path

A parte do URL de solicitação que é considerada o caminho do contexto

http.method

O método HTTP que foi usado para a solicitação, como GET ou POST

http.local.name

Endereço IP/nome de host do servidor

http.server.port

Porta de escuta do servidor

http.query.string

A parte da cadeia de caracteres de consulta do URL de solicitação

http.remote.host

O nome de host do solicitante

http.remote.addr

A combinação de nome de host:port do solicitante

http.remote.user

O nome de usuário do solicitante

http.protocol

O protocolo usado para se comunicar

http.request.uri

O URL de solicitação completo

http.auth.type

O tipo de autorização HTTP usado

http.principal.name

O nome do usuário autenticado que está fazendo a solicitação

http.query.param.XXX

Cada um dos parâmetros de consulta na solicitação será adicionado como um atributo, com o prefixo “http.query.param”

http.param.XXX

Os parâmetros de formulário na solicitação que são configurados por “Parameters to Attributes List” serão adicionados como um atributo, com o prefixo “http.param.”. Não é recomendável colocar parâmetros de formulário de tamanho grande.

http.subject.dn

O nome distinto do solicitante. Esse valor não será preenchido, a menos que o processador esteja configurado para usar um serviço SSLContext

http.issuer.dn

O nome distinto da entidade que emitiu o certificado do assunto. Esse valor não será preenchido, a menos que o processador esteja configurado para usar um serviço SSLContext

http.certificate.sans.N.name

Valor de Subject Alternative Name do certificado de cliente X.509 na autenticação TLS mútua. O nome do atributo tem um índice baseado em zero ordenado de acordo com o conteúdo do certificado de cliente

http.certificate.sans.N.nameType

Tipo do Subject Alternative Name do certificado de cliente X.509 na autenticação TLS mútua. O nome do atributo tem um índice baseado em zero ordenado de acordo com o conteúdo do certificado de cliente. O valor do atributo é um dos nomes gerais da RFC 3280, seção 4.1.2.7

http.headers.XXX

Cada um dos cabeçalhos HTTP recebidos na solicitação será adicionado como um atributo, com o prefixo “http.headers” Por exemplo, se a solicitação contiver um cabeçalho HTTP chamado “x-my-header”, o valor será adicionado a um atributo chamado “http.headers.x-my-header”

http.headers.multipart.XXX

Cada um dos cabeçalhos HTTP recebidos na solicitação multipart será adicionado como um atributo, com o prefixo “http.headers.multipart” Por exemplo, se a solicitação multipart contiver um cabeçalho HTTP chamado “content-disposition”, o valor será adicionado a um atributo chamado “http.headers.multipart.content-disposition”

http.multipart.size

Para solicitações com Content-Type “multipart/form-data”, o tamanho do conteúdo da parte é registrado nesse atributo

http.multipart.content.type

Para solicitações com Content-Type “multipart/form-data”, o tipo de conteúdo da parte é registrado nesse atributo

http.multipart.name

Para solicitações com Content-Type “multipart/form-data”, o nome da parte é registrado nesse atributo

http.multipart.filename

Para solicitações com Content-Type “multipart/form-data”, quando a parte contém um arquivo carregado, o nome do arquivo é registrado nesse atributo. Os arquivos são armazenados temporariamente no diretório padrão de arquivos temporários especificado no Java Docs “java.io.File”)

http.multipart.fragments.sequence.number

Para solicitações com Content-Type “multipart/form-data”, o índice da parte é registrado nesse atributo. O índice começa com 1.

http.multipart.fragments.total.number

Para solicitações com Content-Type “multipart/form-data”, a contagem de todas as partes é registrada nesse atributo.

Consulte também