HandleHttpRequest 2025.5.31.15¶
Bundle¶
org.apache.nifi | nifi-standard-nar
Description¶
Démarre un serveur HTTP et écoute les requêtes HTTP. Pour chaque requête, crée un FlowFile et le transfère à « success ». Ce processeur est conçu pour être utilisé conjointement avec le processeur HandleHttpResponse afin de créer un service Web. Dans le cas d’une requête multipartite, un FlowFile est généré pour chaque partie.
Exigences en matière d’entrées¶
FORBIDDEN
Prend en charge les propriétés dynamiques sensibles¶
false
Propriétés¶
Propriété |
Description |
|---|---|
Méthodes HTTP supplémentaires |
Une liste des méthodes non standard HTTP qui doivent être autorisées, séparées par des virgules |
Autoriser DELETE |
Autoriser la méthode HTTP DELETE |
Autoriser GET |
Autoriser la méthode HTTP GET |
Autoriser HEAD |
Autoriser la méthode HTTP HEAD |
Autoriser OPTIONS |
Autoriser la méthode HTTP OPTIONS |
Autoriser POST |
Autoriser la méthode HTTP POST |
Autoriser PUT |
Autoriser la méthode HTTP PUT |
Chemins autorisés |
Une expression régulière qui spécifie les chemins HTTP valides qui sont autorisés dans les requêtes URL entrantes. Si cette valeur est spécifiée et que le chemin des requêtes HTTP ne correspond pas à cette expression régulière, le processeur répondra par un message 404 : NotFound |
Authentification du client |
Indique si le processeur doit ou non authentifier les clients. Cette valeur est ignorée si la propriété <SSL Context Service> n’est pas spécifiée ou si le SSL Context fourni n’utilise qu’un KeyStore et non un TrustStore. |
Jeu de caractères URL par défaut |
Le jeu de caractères à utiliser pour décoder les paramètres URL si la requête HTTP n’en fournit pas |
Mappage du contexte HTTP |
Le Controller Service de carte contextuelle HTTP à utiliser pour le mappage des informations de la requête HTTP |
Protocoles HTTP |
Protocoles HTTP pris en charge pour la négociation du protocole de la couche application avec TLS |
Nom d’hôte |
Le nom d’hôte auquel se rattacher. Si elle n’est pas spécifiée, la liaison se fera avec tous les hôtes |
Port d’écoute |
Le port sur lequel écouter les requêtes HTTP entrantes |
Maximum de threads |
Nombre maximal de threads que le serveur HTTP intégré utilisera pour traiter les requêtes. |
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 |
Service contextuel SSL |
Le service contextuel SSL à utiliser pour sécuriser le serveur. S’il est spécifié, le serveur n’acceptera que les requêtes HTTPS ; sinon, le serveur n’acceptera que les requêtes HTTP |
container-queue-size |
La taille de la file d’attente pour les conteneurs de requêtes Http |
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 |
parameters-to-attributes |
Une liste de paramètres HTTP ou de données de forme à sortir en tant qu’attributs, séparées par des virgules |
Relations¶
Nom |
Description |
|---|---|
success |
Tout le contenu reçu est routé vers la relation « success » |
Écrit les attributs¶
Nom |
Description |
|---|---|
http.context.identifier |
Un identificateur qui permet à HandleHttpRequest et HandleHttpResponse de coordonner quel FlowFile appartient à quelle Requête/Réponse HTTP. |
mime.type |
Le type de données MIME, conformément à l’en-tête HTTP « Content-Type » |
http.servlet.path |
La partie de la requête URL qui est considérée comme le chemin de la servlet |
http.context.path |
La partie de la requête URL qui est considérée comme le chemin contextuel |
http.method |
La méthode HTTP qui a été utilisée pour la requête, telle que GET ou POST |
http.local.name |
L’adresse IP/le nom d’hôte du serveur |
http.server.port |
Port d’écoute du serveur |
http.query.string |
La portion de la chaîne de requête de la requête URL |
http.remote.host |
Le nom d’hôte du demandeur |
http.remote.addr |
La combinaison nom d’hôte:port du demandeur |
http.remote.user |
Le nom d’utilisateur du demandeur |
http.protocol |
Le protocole utilisé pour communiquer |
http.request.uri |
URL de la requête complète |
http.auth.type |
Le type d’autorisation HTTP utilisé |
http.principal.name |
Le nom de l’utilisateur authentifié à l’origine de la requête |
http.query.param.XXX |
Chacun des paramètres de requête sera ajouté en tant qu’attribut, préfixé par « http.query.param » |
http.param.XXX |
Les paramètres de la forme dans la requête qui sont configurés par « Parameters to Attributes List » seront ajoutés en tant qu’attribut, préfixé par « http.param ». Il n’est pas recommandé de placer des paramètres de format de grande taille. |
http.subject.dn |
Le nom distinctif du demandeur. Cette valeur n’est renseignée que si le processeur est configuré pour utiliser un service SSLContext |
http.issuer.dn |
Nom distinctif de l’entité qui a délivré le certificat du sujet. Cette valeur n’est renseignée que si le processeur est configuré pour utiliser un service SSLContext |
http.certificat.sans.N.name |
Valeur du nom alternatif du sujet du certificat X.509 du client provenant de l’authentification mutuelle TLS. Le nom de l’attribut a un index basé sur zéro, ordonné en fonction du contenu du certificat du client |
http.certificat.sans.N.nameType |
Type de nom alternatif de sujet de certificat de client X.509 à partir de l’authentification mutuelle TLS. Le nom de l’attribut a un index basé sur zéro, ordonné en fonction du contenu du certificat du client. La valeur de l’attribut est l’un des noms généraux de RFC 3280 Section 4.1.2.7 |
http.headers.XXX |
Chacun des en-têtes HTTP reçus dans la requête sera ajouté en tant qu’attribut, préfixé par « http.headers ». Par exemple, si la requête contient un conteneur HTTP nommé « x-my-header », la valeur sera ajoutée à un attribut nommé « http.headers.x-my-header » |
http.headers.multipart.XXX |
Chacun des en-têtes HTTP reçus dans la requête multipart sera ajouté en tant qu’attribut, préfixé par « http.headers.multipart » Par exemple, si la requête multipart contient un conteneur HTTP nommé « content-disposition », la valeur sera ajoutée à un attribut nommé « http.headers.multipart.content-disposition » |
http.multipart.size |
Pour les requêtes avec Content-Type « multipart/form-data », la taille du contenu de la partie est enregistrée dans cet attribut |
http.multipart.content.type |
Pour les requêtes avec Content-Type « multipart/form-data », le type de contenu de la partie est enregistré dans cet attribut |
http.multipart.name |
Pour les requêtes avec Content-Type « multipart/form-data », le nom de la partie est enregistré dans cet attribut |
http.multipart.filename |
Pour les requêtes avec Content-Type « multipart/form-data », lorsque la partie contient un fichier téléchargé, le nom du fichier est enregistré dans cet attribut. Les fichiers sont stockés temporairement dans le répertoire temporaire par défaut spécifié dans « java.io.File » Java Docs) |
http.multipart.fragments.sequence.number |
Pour les requêtes avec Content-Type « multipart/form-data », l’index de la pièce est enregistré dans cet attribut. L’index commence par 1. |
http.multipart.fragments.total.number |
Pour les requêtes avec Content-Type « multipart/form-data », le nombre de toutes les parties est enregistré dans cet attribut. |