ListenHTTP 2025.5.31.15¶
Bundle¶
org.apache.nifi | nifi-standard-nar
Description¶
Démarre un serveur HTTP et écoute sur un chemin de base donné pour transformer les requêtes entrantes en FlowFiles. L’URI par défaut du service sera http://{hostname}:{port}/contentListener. Seules les requêtes HEAD et POST sont prises en charge. les messages GET, PUT, DELETE, OPTIONS et TRACE entraîneront une erreur et le code d’état HTTP 405 ; CONNECT entraînera également une erreur et le code d’état response HTTP 400. GET est pris en charge sur <service_URI>/healthcheck. Si le service est disponible, il renvoie « 200 OK » avec le contenu « OK ». La fonctionnalité de contrôle de santé peut être configurée pour être accessible via un autre port. Pour plus de détails, voir la documentation de la propriété « Listening Port for health check requests » (Port d’écoute pour les requêtes de bilan de santé). Une propriété « Record Reader » et « Record Writer » peut être activée sur le processeur pour traiter les requêtes entrantes sous forme d’enregistrements. Le traitement des enregistrements n’est pas autorisé pour les requêtes multipartites et les requêtes au format FlowFileV3 (minifi).
Exigences en matière d’entrées¶
FORBIDDEN
Prend en charge les propriétés dynamiques sensibles¶
false
Propriétés¶
Propriété |
Description |
|---|---|
Modèle DN autorisé |
Une expression régulière à appliquer au nom distinctif du sujet des connexions entrantes. Si le modèle ne correspond pas au sujet DN, le processeur répondra par un statut HTTP 403 Forbidden. |
Chemin de base |
Chemin de base pour les connexions entrantes |
En-têtes HTTP à recevoir comme attributs (Regex) |
Spécifie l’expression régulière qui détermine les noms des en-têtes HTTP qui doivent être transmis en tant qu’attributs FlowFile |
Protocoles HTTP |
Protocoles HTTP pris en charge pour la négociation du protocole de la couche application avec TLS |
Port d’écoute |
Le port sur lequel les connexions entrantes doivent être écoutées |
Durée maximale non confirmée du FlowFile |
Délai maximum d’attente pour la confirmation d’un FlowFile avant qu’il ne soit retiré du cache |
Taille maximale de l’en-tête de la requête |
Taille maximale prise en charge des en-têtes HTTP dans les requêtes envoyées à ce processeur |
Code de retour |
Le code de retour HTTP renvoyé après chaque appel HTTP |
Service contextuel SSL |
Le service contextuel SSL permet de prendre en charge HTTPS |
authorized-issuer-dn-pattern |
Une expression régulière à appliquer au nom distinctif de l’émetteur pour les connexions entrantes. Si le modèle ne correspond pas au DN émetteur, le processeur répondra par un statut HTTP 403 Forbidden. |
client-authentication |
Politique d’authentification du client pour les connexions TLS. Exigence requise lorsque SSL Context Service est configuré. |
health-check-port |
Le port sur lequel écouter les requêtes de bilan de santé entrantes. S’il est paramétré, il doit être différent du port d’écoute. Configurez ce port si le processeur est paramétré pour utiliser le SSL à double sens et si un équilibreur de charge ne prenant pas en charge l’authentification du client pour les requêtes de bilan de santé est utilisé. Seul le service /<base_path>/healthcheck est disponible via ce port et seules les requêtes GET et HEAD sont prises en charge. Si le processeur est paramétré pour ne pas utiliser SSL, SSL ne sera pas non plus utilisé sur ce port. Si le processeur est paramétré pour utiliser SSL à sens unique, SSL à sens unique sera utilisé sur ce port. Si le processeur est paramétré pour utiliser SSL à double sens, SSL à sens unique sera utilisé sur ce port (l’authentification du client n’est pas requise). |
max-thread-pool-size |
Nombre maximal de threads à utiliser par le serveur Jetty intégré. La valeur peut être paramétrée entre 8 et 1000. La valeur de cette propriété affecte les performances des flux et du système d’opération, c’est pourquoi la valeur par défaut ne doit être modifiée que dans des cas justifiés. Une valeur inférieure à la valeur par défaut peut convenir si seul un petit nombre de clients HTTP se connectent au serveur. Une valeur plus large peut convenir si un grand nombre de clients HTTP sont censés adresser simultanément des requêtes au serveur. |
multipart-read-buffer-size |
Seuil à partir duquel le contenu d’un fichier entrant sera écrit sur le disque. Ne s’applique qu’aux requêtes avec Content-Type : multipart/form-data. Il est utilisé pour prévenir les attaques par déni de service, afin d’éviter de remplir le Heap ou l’espace disque. |
multipart-request-max-size |
La taille maximale de la requête. Ne s’applique qu’aux requêtes avec Content-Type : multipart/form-data et est utilisée pour prévenir les attaques par déni de service, pour empêcher le remplissage du Heap ou de l’espace disque |
record-reader |
Le Record Reader à utiliser pour analyser le contenu de FlowFile en enregistrements |
record-writer |
Le Record Writer à utiliser pour sérialiser les enregistrements après qu’ils aient été transformés |
Relations¶
Nom |
Description |
|---|---|
success |
Relation pour la réception réussie de FlowFiles |
Cas d’utilisation¶
Décompressez le contenu de FlowFileV3 reçu dans un POST |
Cas d’utilisation impliquant d’autres composants¶
Limiter la date acceptée |