HandleHttpRequest 2025.5.31.15

Pacote

org.apache.nifi | nifi-standard-nar

Descrição

Inicia um servidor HTTP e escuta as solicitações HTTP. Para cada solicitação, cria um FlowFile e transfere para “success”. Esse processador foi projetado para ser usado em conjunto com o processador HandleHttpResponse para criar um serviço Web. No caso de uma solicitação multipart, um FlowFile é 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