ListenHTTP 2025.5.31.15

Bundle

org.apache.nifi | nifi-standard-nar

Beschreibung

Startet einen HTTP-Server und lauscht auf einem bestimmten Basispfad, um eingehende Anfragen in FlowFiles umzuwandeln. Die Standard-URI des Dienstes lautet http://{hostname}:{port}/contentListener. Es werden nur HEAD- und POST-Anfragen unterstützt. GET, PUT, DELETE, OPTIONS und TRACE führen zu einem Fehler und dem HTTP-Antwortstatuscode 405; CONNECT führt ebenfalls zu einem Fehler und dem HTTP-Antwortstatuscode 400. GET wird für <service_URI>/healthcheck unterstützt. Wenn der Dienst verfügbar ist, wird „200 OK“ mit dem Inhalt „OK“ zurückgegeben. Die Health Check-Funktionalität kann so konfiguriert werden, dass sie über einen anderen Port zugänglich ist. Einzelheiten finden Sie in der Dokumentation der Eigenschaft „Listening Port for health check requests“. Die Eigenschaften Record Reader und Record Writer können auf dem Prozessor aktiviert werden, um eingehende Anfragen als Datensätze zu verarbeiten. Die Verarbeitung von Datensätzen ist für mehrteilige Anfragen und Anfragen im Format FlowFileV3 (minifi) nicht zulässig.

Tags

http, https, ingest, listen, rest

Eingabeanforderung

FORBIDDEN

Unterstützt sensible dynamische Eigenschaften

false

Eigenschaften

Eigenschaft

Beschreibung

Authorized DN Pattern

Ein regulärer Ausdruck, der auf den Distinguished Name des Subjekts eingehender Verbindungen angewendet wird. Wenn das Muster nicht mit dem Subject DN übereinstimmt, antwortet der Prozessor mit dem Status HTTP 403 Forbidden.

Base Path

Basispfad für eingehende Verbindungen

HTTP-Header, die als Attribute empfangen werden (Regex)

Gibt den regulären Ausdruck an, der die Namen der HTTP-Header bestimmt, die als FlowFile-Attribute weitergegeben werden sollen

HTTP Protocols

Unterstützte HTTP-Protokolle für Application Layer Protocol Negotiation mit TLS

Listening Port

Der Port, auf dem eingehende Verbindungen abgehört werden sollen

Max Unconfirmed Flowfile Time

Die maximale Zeitspanne, die gewartet wird, bis ein FlowFile bestätigt wird, bevor es aus dem Cache entfernt wird

Request Header Maximum Size

Die maximal unterstützte Größe der HTTP-Header in Anfragen, die an diesen Prozessor gesendet werden.

Rückgabecode

Der HTTP-Rückgabecode, der nach jedem HTTP-Aufruf zurückgegeben wird

SSL Context Service

SSL Context Service bietet Unterstützung für HTTPS

authorized-issuer-dn-pattern

Ein regulärer Ausdruck, der auf den Distinguished Name des Ausstellers eingehender Verbindungen angewendet wird. Wenn das Muster nicht mit dem Emittenten-DN übereinstimmt, antwortet der Prozessor mit dem Status HTTP 403 Forbidden.

client-authentication

Client-Authentifizierungsrichtlinie für TLS-Verbindungen. Erforderlich, wenn SSL Context Service konfiguriert ist.

health-check-port

Der Port, auf dem eingehende Health Check-Anfragen abgehört werden sollen. Wenn festgelegt, muss er sich vom Listening Port unterscheiden. Konfigurieren Sie diesen Port, wenn der Prozessor auf die Verwendung von Zwei-Wege-SSL eingestellt ist und ein Load Balancer verwendet wird, der keine Client-Authentifizierung für Health Check-Anfragen unterstützt. Über diesen Port ist nur der Dienst /<base_path>/healthcheck verfügbar und es werden nur die Anfragen GET und HEAD unterstützt. Wenn der Prozessor so eingestellt ist, dass er SSL nicht verwendet, wird SSL auch an diesem Port nicht verwendet. Wenn der Prozessor so eingestellt ist, dass er einseitig SSL verwendet, wird auf diesem Port einseitig SSL verwendet. Wenn der Prozessor auf die Verwendung von Zwei-Wege-SSL eingestellt ist, wird auf diesem Port SSL verwendet (Client-Authentifizierung nicht erforderlich).

max-thread-pool-size

Die maximale Anzahl von Threads, die vom eingebetteten Jetty-Server verwendet werden sollen. Der Wert kann zwischen 8 und 1000 festgelegt werden. Der Wert dieser Eigenschaft beeinflusst die Leistung der Datenflüsse und des Betriebssystems. Daher sollte der Standardwert nur in begründeten Fällen geändert werden. Ein Wert, der unter dem Standardwert liegt, kann geeignet sein, wenn sich nur eine kleine Anzahl von HTTP-Clients mit dem Server verbindet. Ein größerer Wert kann sinnvoll sein, wenn eine große Anzahl von HTTP-Clients gleichzeitig Anfragen an den Server stellen soll.

multipart-read-buffer-size

Die Schwellengröße, bei der der Inhalt einer eingehenden Datei auf die Festplatte geschrieben wird. Gilt nur für Anfragen mit Content-Type: multipart/form-data. Es wird verwendet, um Denial-of-Service-Angriffe zu verhindern und zu verhindern, dass der Heap oder der Speicherplatz auf der Festplatte voll wird.

multipart-request-max-size

Die maximale Größe der Anfrage. Gilt nur für Anfragen mit Content-Type: multipart/form-data und wird verwendet, um Denial-of-Service-Angriffe zu verhindern und eine Überfüllung des Heaps oder des Festplattenspeichers zu verhindern.

record-reader

Der Record Reader zum Parsen des eingehenden FlowFile in Datensätze.

record-writer

Der Record Writer, der für die Serialisierung von Datensätzen nach deren Transformation verwendet wird

Beziehungen

Name

Beschreibung

success

Beziehung für für erfolgreich empfangene FlowFiles

Anwendungsfälle

FlowFileV3 Inhalte, die Sie in einem POST entpacken

Anwendungsfälle mit anderen Komponenten

Begrenzt die zulässige Datenflussrate