UiPath Documentation
integration-service
latest
false
Guide de l'utilisateur d'Integration Service
Important :
Ce contenu a été traduit à l'aide d'une traduction automatique. Les packages de connecteurs disponibles dans Integration Service sont traduits à l'aide d'un moteur de traduction. La localisation du contenu nouvellement publié peut prendre 1 à 2 semaines avant d’être disponible.

À propos du connecteur HTTP Webhook

Configurez le connecteur HTTP Webhook dans Integration Service pour recevoir des rappels en temps réel et générés par événements de la part d’applications externes sans interrogation.

Les Webhooks permettent aux applications d'informer les systèmes externes en temps réel, ce qui réduit la nécessité d'effectuer des sondages fréquents et de minimiser les appels d'API. Au lieu de vérifier périodiquement les mises à jour, le système reçoit des rappels basés sur les événements uniquement lorsque des changements pertinents se produisent.

Le connecteur UiPath HTTP Webhook vous permet de déclencher des workflows directement à partir des applications des fournisseurs. Vous pouvez créer des déclencheurs instantanés pour les événements de toute application tierce qui prend en charge les notifications de Webhook sortant, même si elle ne fait pas partie du catalogue de connecteurs.

Vous pouvez également appliquer des filtres de données d'événement pour spécifier les conditions exactes dans lesquelles un événement Webhook doit déclencher un workflow.

Mode de fonctionnement​

Le déclencheur HTTP Webhook génère une URL de rappel publique dynamique. Copiez et configurez cette URL dans les paramètres du webhook de l’application fournisseur uniquement après la création de votre déclencheur dans Orchestrator.

Lorsqu’un événement se produit dans le système du fournisseur :

  1. Le fournisseur envoie la charge utile de l'événement à l'URL configurée.
  2. Integration Service reçoit la charge utile et l’évalue par rapport à vos filtres de données d’événement configurés.
  3. Si une correspondance est trouvée, Integration Service déclenche l'exécution du workflow via Orchestrator.

Webhook payloads are processed the same way as any other trigger events. The connector also supports optional header-based authentication and JWT authentication, which let the vendor authenticate itself to UiPath on every webhook delivery, with a configured header value or with a signed token.

Pour de plus amples informations, consultez la section Utiliser le connecteur Webhook.

Pour de plus amples informations sur la façon de créer une connexion et de configurer la vérification des défis, si le fournisseur l'exige, consultez la section Authentification HTTP Webhook.

Sécurité​

The HTTP Webhook connector offers the following security mechanisms, all configured at connection-creation time. Header-based authentication and JWT authentication are alternatives: a connection uses one of them, or neither.

MécanismeCe qu’il faitQuand l'utiliser
Vérification des défisPermet au fournisseur de confirmer que votre URL de Webhook UiPath est valide avant d’envoyer des événements.Lorsque le fournisseur nécessite un processus d'établissement de liaison (Slack, Meta, etc.).
Authentification basée sur l’en-têteValide chaque demande de Webhook entrant à l’aide d’une clé secrète partagée portée dans un en-tête HTTP (par exemple, X-API-Key). Les requêtes qui ne comportent pas la valeur d'en-tête configurée sont rejetées avec HTTP 401.Lorsque vous souhaitez empêcher les appelants non autorisés de publier sur votre URL Webhook, et que votre fournisseur vous permet de configurer un en-tête personnalisé sur les livraisons Webhook sortantes.
JWT authenticationValidates every incoming webhook request using a signed JWT in the Authorization: Bearer header with a shared secret or public key. Requests with a missing, invalid, or expired token are rejected with HTTP 401.When the sender can sign a JWT for each request, and you want credentials that expire instead of a static header value.

Pour plus de détails sur la configuration, consultez Authentification HTTP Webhook.

Limites de débit​

Les événements déclenchés par Webhook sont soumis aux limites suivantes :

  • 500 événements par minute et par locataire
  • 100 événements par minute et par connexion

Limitations​

  • Le débogage du déclencheur de phase de conception n’est pas disponible actuellement.
  • Seules les requêtes au format JSON sont prises en charge.
  • La taille maximale de charge utile du webhook prise en charge est de 14 Mo. Les demandes dépassant cette limite sont rejetées et aucun événement déclencheur n’est envoyé.

Questions fréquemment posées​

J'ai collé l'URL du Webhook dans l'interface utilisateur du fournisseur. Pourquoi la vérification ne passe-t-elle pas ?​

La vérification ne réussira qu'après la création du déclencheur dans Orchestrator et à condition que vous ayez configuré le défi correctement. Notez qu'UiPath n'effectue aucune vérification de défi de notre côté : la validation se fait entièrement du côté du fournisseur, afin d'établir une relation de confiance avec la destination.

J’ai configuré le défi de manière incorrecte. Pourquoi ma connexion est-elle toujours créée avec succès ?​

UiPath ne valide pas actuellement l'étape de défi/vérification du fournisseur. Cette validation est entièrement gérée par le fournisseur. Par conséquent, la connexion dans UiPath peut apparaître active même si la vérification des difficultés du fournisseur a réellement échoué de son côté.

Comment utiliser la réponse provenant d'un Webhook créé dans Orchestrator ?​

Utilisez l'activité Obtenir la sortie de l'événement du déclencheur dans votre workflow et transmettez UiPathEventObjectId (type de données=Texte) comme argument d'entrée. L'activité renvoie le corps et les en-têtes de la demande de Webhook, à l'exception des en-têtes supprimés par UiPath. Pour plus de détails, consultez Quels en-têtes un événement de Webhook inclut-il?.

Quels en-têtes un événement de Webhook inclut-il?​

Un événement de Webhook inclut les en-têtes que l’expéditeur a ajoutés à la requête. Les en-têtes utilisés par l’infrastructure réseau UiPath sont supprimés de l’événement, même lorsque l’expéditeur les ajoute. Les en-têtes suivants sont supprimés (la correspondance n'est pas sensible à la casse):

Saisie de texteEn-têtes supprimés
Noms exactshost, x-request-id, accountid, tenantid, ratelimit-limit, ratelimit-remaining, x-uipath-s2s-iprange, cf-ray, cf-visitor, cdn-loop, cf-connecting-ip, cf-ipcountry, true-client-ip
Préfixesx-forwarded- (y compris x-forwarded-for), x-envoy-, x-uipath-internal-

Les autres en-têtes qui commencent par cf-, tels que cf-access-client-id, sont conservés, de même que traceparent et tracestate.

Pour cette raison, un événement Webhook n’inclut pas l’adresse IP ou le pays de l’appelant. Si votre workflow en a besoin, demandez à l’expéditeur de les inclure dans le corps de la demande ou dans un en-tête avec un autre nom.

La réponse du webhook est une chaîne JSON. Comment dois-je utiliser certaines parties de celui-ci dans mon workflow ?​

Utilisez l’activité Désérialiser JSON pour convertir la chaîne en un JObject, après quoi vous pourrez facilement accéder aux champs individuels.

How do I read the query parameters of a webhook request?​

The HTTP Webhook trigger returns the query parameters in the Query parameter output. The Get Trigger Event Output activity returns them in the Event query parameter output. Both outputs are JSON strings of name-value pairs, for example {"source":"crm","page":"1"}. If the request has no query parameters, the output is {}.

All values are URL-decoded strings. If a parameter name appears more than once in the request, only the first value is kept. Use the Deserialize JSON activity to read individual values.

Triggers created before the Query parameter output was added return it after a trigger on the same connection is updated, for example when you edit the trigger or publish the project again.

Puis-je demander au fournisseur de s’authentifier lors de l’envoi d’événements de Webhook à UiPath?​

Yes. Enable Header-based authentication or JWT authentication when creating or editing the connection, then configure the matching header or token in the vendor's webhook settings. For setup instructions, see HTTP Webhook authentication.

Mon fournisseur utilise son propre schéma de signature (par exemple, X-Hub-Signature-256). Puis-je toujours utiliser l’authentification basée sur l’en-tête?​

Non. L’authentification basée sur l’en-tête utilise une valeur d’en-tête statique pré-partagée. Les fournisseurs basés sur les signatures calculent un nouveau HMAC sur chaque demande à l’aide de la charge utile et d’une clé secrète partagée - UiPath ne valide pas actuellement les signatures spécifiques aux fournisseurs. Pour ces fournisseurs, les mécanismes de sécurité disponibles sont la clé secrète de l'URL et l'établissement de la liaison de vérification des défis du fournisseur.

Cette page vous a-t-elle été utile ?

Connecter

Besoin d'aide ? Assistance(opens in new window)

Vous souhaitez apprendre ? UiPath Academy(opens in new window)

Vous avez des questions ? UiPath Forum(opens in new window)

Rester à jour