- Erste Schritte
- Benachrichtigungen
- Lizenzierung
- Fehlersuche und ‑behebung
- Codierungs-Agents
- Connector Builder
- Über Connector Builder
- Erstellen Ihres ersten Connectors
- Erstellen Ihres Connectors aus einer API-Definition
- Konfigurieren der Authentifizierung
- Verwenden von Variablen im Connector-Generator
- Aktivitätsdesigner
- Arbeiten mit Dateien
- Erstellen eines Triggers
- Skript
- Verketten von Anforderungen mit der nächsten Ressource
- Checkliste für den Connector Builder
- Erste Schritte
- Beispiel A: Erstellen Sie einen Connector aus einer leeren Canvas mit Authentifizierung mit persönlichem Zugriffstoken
- Beispiel B: Erstellen Sie einen Connector aus einer leeren Canvas mit API-Schlüsselauthentifizierung
- Beispiel C: Erstellen eines Connectors aus einer API-Spezifikation mit OAuth 2.0 Client-Anmeldeinformationenauthentifizierung
- Act! 365
- ActiveCampaign
- Active Directory – Vorschau
- Adobe Acrobat Sign
- Adobe PDF Services
- Agent 2 Agent – Vorschau
- Amazon Bedrock
- Amazon Connect
- Amazon Polly
- Amazon SES
- Amazon Transcribe
- Amazon Web Services
- Anthropic Claude
- Asana
- AWeber
- Azure AI Document Intelligence
- Azure Defender for Cloud
- Azure Maps
- BambooHR
- Box
- Brevo
- Calendly
- Campaign Monitor
- Cisco Webex Teams
- Citrix Hypervisor
- Citrix ShareFile
- Clearbit
- Confluence Cloud
- Constant Contact
- Coupa
- Team AI – Vorschau
- Customer.io
- Database Hub
- Databricks – Vorschau
- Databricks-Agent
- Datadog
- DeepSeek
- Deputy
- Discord – Vorschau
- DocuSign
- Drop
- Dropbox
- Dropbox Business
- Egnyte
- Epic FHIR – Vorschau
- Eventbrite
- Wechselkurse
- Exchange Server – Vorschau
- Expensify
- Facebook
- Freshbooks
- Freshdesk
- Freshsales
- Freshservice
- GetResponse
- GitHub
- Gmail
- Google Cloud Platform
- Google Docs
- Google Drive
- Google Formulare – Vorschau
- Google Maps
- Google Tabellen
- Google Sprache-zu-Text
- Google Text-to-Speech
- Google Tasks – Vorschau
- Google Vertex
- Google Vision
- Google Workspace
- GoToWebinar
- Greenhouse
- Hootsuite
- http
- HTTP-Webhook
- Über den HTTP Webhook-Connector
- HTTP Webhook-Authentifizierung
- HTTP Webhook-Ereignisse
- Verwenden des Webhook-Connectors
- Überwachung
- Hubspot CRM
- HubSpot Marketing
- HyperV – Vorschau
- Icertis
- iContact
- Insightly CRM
- Intercom
- Jina.ai
- Jira
- Keap
- Klaviyo
- LinkedIn
- E-Mail (Mail)
- Mailchimp
- Mailgun
- Mailjet
- MailerLite
- Marketo
- MCP
- Microsoft 365
- Microsoft Azure
- Microsoft Azure Active Directory
- Microsoft Azure AI Foundry
- Microsoft Azure OpenAI
- Microsoft Azure Sentinel
- Microsoft Dynamics 365 CRM
- Microsoft OneDrive und SharePoint
- Microsoft Outlook 365
- Microsoft Power Automate
- Microsoft Sentiment
- Microsoft Sentinel-Threat Intelligence
- Microsoft Teams
- Microsoft Translator
- Microsoft Vision
- Miro
- NetIQ eDirectory
- NVIDIA NIM
- Okta
- OpenAI
- OpenAI V1-konformes LLM
- Oracle Eloqua
- Oracle NetSuite
- PagerDuty
- Paypal
- PDFMonkey
- Perplexity
- Pinecone
- Pipedrive
- QuickBooksOnline
- Quip
- Salesforce
- Salesforce Agentforce & Flows
- Salesforce Marketing Cloud
- SAP BAPI
- SAP Cloud for Customer
- SAP Concur
- SAP OData
- SendGrid
- ServiceNow
- Shopify
- Slack
- SmartRecruiters
- Smartsheet
- Snowflake
- Snowflake Cortex
- Stripe
- Sugar Enterprise
- Sugar Professional
- Sugar Sell
- Sugar Serve
- System Center – Vorschau
- TangoCard
- Todoist
- Trello
- Twilio
- TypeSafe – Vorschau
- UiPath Apps - Preview
- UiPath Data Fabric
- UiPath Test Manager
- UiPath GenAI-Aktivitäten
- UiPath Orchestrator
- X (früher Twitter)
- Xero
- wassonx.ai zu senden
- WhatsApp Business
- WooCommerce
- Durchführbar
- Workday
- Workday REST
- VMware ESXi vSphere
- YouTube
- Zendesk
- Zoho Campaigns
- Zoho-Desktop
- Zoho Mail
- Zoom
- ZoomInfo
HTTP Webhook-Authentifizierung
Connect UiPath to your webhook provider and configure webhook challenge verification, header-based authentication, or JWT authentication.
Voraussetzungen
Ihr Webhook-Anbieter erfordert möglicherweise einen Handshake. Weitere Informationen zur Konfiguration der Herausforderungsverifizierung finden Sie im Abschnitt Verifizierung der Webhook-Herausforderung .
Je nachdem, wo Sie den Trigger erstellen, wird die generierte Webhook-URL entweder in der Aktivität HTTP Webhook Trigger oder auf der Seite Triggererstellung angezeigt, jedoch erst, nachdem die Verbindung erfolgreich erstellt wurde. Um Fehler zu vermeiden, fügen Sie die Webhook-URL in Ihre Anwendung ein , nachdem Sie Ihren Workflow veröffentlicht haben oder der Trigger erfolgreich im UiPath Orchestrator erstellt wurde.
Erstellen einer HTTP Webhook-Verbindung
-
Wählen Sie Orchestrator im Produktstartprogramm aus.
-
Wählen Sie einen Ordner aus und navigieren Sie dann zur Registerkarte Verbindungen .
-
Wählen Sie Verbindung hinzufügen aus.
-
Um die Seite zur Erstellung der Verbindung zu öffnen, wählen Sie den Konnektor in der Liste aus. Sie können die Suchleiste verwenden, um den Connector zu finden.
-
Geben Sie im Feld Für welche Anwendung ist dieser Webhook ein beschreibender Name für die Webhook-Anwendung ein, um leicht zu identifizieren, welchen Anbieter oder welche Integration diese Verbindung repräsentiert. Dieser Wert wird zum Verbindungsbezeichner.
-
(Optional) Configure authentication.
If you want UiPath to validate every incoming webhook request, select a method from the Authentication Type dropdown.
For Header Based Authentication, specify:
- Header-Schlüssel – Der HTTP-Header, den der Anbieter zum Senden der Anmeldeinformationen verwendet (z. B.
X-API-KeyoderX-API-Secret). - Header-Wert – der geheime Wert, den der Anbieter in diesem Header sendet (z. B.
a1b2c3d4e5f6789...). Dieses Feld ist maskiert und sicher gespeichert. Sie können für dieses Feld auch ein Anmeldeinformations-Asset verwenden.
Konfigurieren Sie denselben Headerschlüssel und -wert in den Webhook-Einstellungen des Anbieters. Wenn die Werte zur Laufzeit nicht übereinstimmen, weist UiPath die Anforderung mit HTTP 401 zurück.
Weitere Informationen finden Sie unter Webhook-Header-Authentifizierung.
For JWT Authentication, specify:
- Key type — select Passphrase to verify tokens with a shared secret, or PEM Key to verify them with a public key.
- JWT secret (for Passphrase) — the shared secret that the sender uses to sign the token.
- JWT public key (for PEM Key) — the PEM-encoded public key that verifies the token signature, including the
BEGINandENDlines. - JWT algorithm — the algorithm that the sender uses to sign the token. The default is
HS256for Passphrase andRS256for PEM Key.
The sender must send a signed JWT in the
Authorization: Bearer <your-access-token>header of every request. If the token is missing, not valid, or expired, UiPath rejects the request with HTTP 401.For more information, see Webhook JWT authentication.
- Header-Schlüssel – Der HTTP-Header, den der Anbieter zum Senden der Anmeldeinformationen verwendet (z. B.
-
Konfigurieren Sie den Herausforderungsort
Wählen Sie aus, wie der Anbieter das Herausforderungstoken sendet, damit UiPath richtig reagieren kann:- Keine Herausforderung – der Anbieter erfordert keinen Handshake und Sie können mit der Verbindung fortfahren.
- Abfrageparameter (z. B.
?challenge=...) - JSON-Text (POST mit
{ "challenge": "..." }) - Kopfzeile (z. B.
X-Hub-Challenge)
-
Konfigurieren Sie die Herausforderungsverifizierung und stellen Sie eine Verbindung her
Wenn der Anbieter einen Handshake erfordert, geben Sie die Herausforderungsverifizierung ein, die dem Muster des Anbieters entspricht ( welches Feld/jeder Header/ welche Abfrage gelesen werden soll und wie der Echo/validiert werden soll). Wenn die Konfiguration abgeschlossen ist, wählen Sie Verbinden aus.Wenn verfügbar, wählen Sie das Menü neben einem Feld und dann Anmeldeinformations-Asset verwenden oder Orchestrator-Asset verwenden aus , um auf ein Orchestrator-Asset zu verweisen, anstatt den Wert direkt einzugeben. Weitere Informationen finden Sie unter Verwenden von Anmeldeinformationsassets für Verbindungen.
- Verwenden Sie einen Namen, der den Anbieter und die Umgebung enthält (z. B. Stripe-prod oder Slack-staging), um Verwechslungen zu vermeiden.
- Wenn Sie nicht sicher sind, welches Herausforderungsmuster der Anbieter verwendet, überprüfen Sie seine Webhook-Dokumentation oder führen Sie eine Testregistrierung durch, um die Handshake-Anforderung zu überprüfen.
Überprüfung der Webhook-Herausforderung
Einige Anbieter erfordern, dass Webhook-URLs validiert werden, bevor sie mit dem Senden tatsächlicher Ereignisse beginnen. Dies geschieht mithilfe eines Herausforderungs-Antwort-Mechanismus. Wenn Sie einen Webhook registrieren, sendet der Anbieter eine spezielle Herausforderungsanforderung und der Endpunkt muss genau wie erwartet reagieren.
Der HTTP-Webhook-Connector unterstützt diese Verifizierungsabläufe über das Webhook-Herausforderungs-Framework, sodass Sie konfigurieren können, wie UiPath die Herausforderungen von Anbietern lesen und darauf reagieren soll.
Unterstützung der Herausforderungsverifizierung
UiPath unterstützt beide Arten von Webhook-Verhalten des Anbieters:
- Anbieter, die keine Herausforderungsverifizierung verwenden
- Anbieter, die vor der Aktivierung des Webhooks einen Herausforderungs-Handshake erfordern
Dies gewährleistet die Kompatibilität mit einfachen Webhook-Anbietern sowie mit Anbietern mit erweiterten Sicherheitsanforderungen.
Wenn Anbieter keine Herausforderungsverifizierung verwenden
Viele Anwendungen akzeptieren einfach eine Webhook-URL und beginnen sofort mit der Bereitstellung von Ereignissen.
Für diese Anbieter:
- Benutzer müssen lediglich eine Verbindung erstellen oder auswählen.
- Kopieren Sie die Webhook-URL.
- Fügen Sie ihn in die Webhook-Konfiguration des Anbieters ein.
Es sind keine zusätzlichen Schritte erforderlich. Der Webhook wird aktiv, sobald der Anbieter mit dem Senden von Ereignissen beginnt.
Das ist das häufigste und einfachste Szenario, das von UiPath nahtlos behandelt wird.
Wenn Anbieter eine Herausforderungsverifizierung erfordern
Einige Anbieter senden eine Herausforderungsanforderung , um die Webhook-URL zu überprüfen, bevor sie aktiviert werden.
In diesen Fällen:
- Benutzer müssen die Herausforderungsantwort in der HTTP Webhook-Verbindung konfigurieren .
- UiPath wartet auf die Herausforderungsanforderung des Anbieters.
- UiPath gibt basierend auf der Konfiguration automatisch den richtigen Herausforderungswert zurück.
- Sobald der Anbieter die Antwort validiert hat, beginnen normale Ereignisse zu fließen.
Da sich die Anbieter darin unterscheiden, wie sie die Herausforderung senden (Abfrageparameter, JSON-Text, Header usw.), ermöglicht die Konfiguration von UiPath den Benutzern, jedes dieser Muster zu verarbeiten.
Dies gewährleistet die Kompatibilität mit Webhook-Anbietern, die Sicherheits-Handshakes erzwingen, z. B. Slack, Meta (Facebook/Instagram), Stripe und anderen.
Konfigurieren der Herausforderungsverifizierung
Sie konfigurieren das Herausforderungsverhalten mit vier Parametern:
-
Herausforderungsschlüssel
Feld/Schlüssel mit dem Herausforderungswert. Wird zum Erkennen von Herausforderungsanforderungen verwendet ( darf nicht NULL sein). -
Herausforderungsort
Wo der Schlüssel angezeigt wird:- Text
- Abfrageparameter
- Kopfzeile
-
Inhaltstyp der Herausforderungsantwort
Format der Antwort, die an den Anbieter zurückgegeben wird:- Text/Nur
- application/json
-
Antwortformat der Herausforderung
Definiert, welcher Wert zurückgegeben wird (in der Regel der Herausforderungsschlüssel selbst).
UiPath extrahiert den Wert aus der eingehenden Herausforderung und reagiert entsprechend.
Beispiele für die Herausforderungskonfiguration
Allgemeines Beispiel
Eingehende Anforderung
{
"challenge": "ABC123"
}
{
"challenge": "ABC123"
}
Konfiguration
- Herausforderungsschlüssel:
challenge != null - Herausforderungsort: Textkörper
- Antworttyp:
text/plain - Antwortformat:
challenge
Antwort
ABC123
Beispiel für die WhatsApp-Herausforderungsverifizierung
WhatsApp verwendet die abfrageparameterbasierte Herausforderungsmethode mit Hub.herausforderung.
Konfiguration
| Parameter | Wert |
|---|---|
| Herausforderungsschlüssel | hub.challenge != null |
| Herausforderungsort | Abfrageparameter |
| Inhaltstyp der Herausforderungsantwort | text/plain |
| Antwortformat der Herausforderung | hub.challenge |
Anbieteranfrage
GET https://your-webhook-url?hub.challenge=1234567890
Erwartete UiPath-Antwort
HTTP/1.1 200 OK
Content-Type: text/plain
1234567890
HTTP/1.1 200 OK
Content-Type: text/plain
1234567890
Dadurch wird der Besitz bestätigt und WhatsApp beginnt anschließend, echte Webhook-Ereignisse zu senden.
Zusammenfassung – Generisch im Vergleich zu WhatsApp
| Schritt | Allgemeines Beispiel | WhatsApp-Beispiel |
|---|---|---|
| Herausforderungsort | Textkörper/Abfrage/Header | Abfrage |
| Tastenformat | Einfacher Schlüssel (z. B. challenge) | Schlüssel mit Punkt (hub.challenge ) |
| ResponseType | text/nur oder application/json | Text/Nur |
| Antwortwert | Wert des Schlüssels | Wert von „ hub.challenge “ |
| Method | POST oder GET | Nur GET |
Beispiele nach Anbietermuster
Beispiel 1: Einfache Textabfrage mit Textantwort
Anbieter sendet
{"challenge":"abc123","type":"url_verification"}
| Feld | Wert |
|---|---|
| Herausforderungsort | Body |
| Herausforderungsschlüssel | challenge |
| Inhaltstyp der Herausforderungsantwort | text |
| Antwortformat der Herausforderung | challenge |
Antwort: abc123 (Text/Nur, 200)
Beispiel 2: Parameter-Herausforderung mit Textantwort
Anbieter sendet
GET /webhook?challenge=CHALLENGE_STRING
| Feld | Wert |
|---|---|
| Herausforderungsort | Query Parameter |
| Herausforderungsschlüssel | challenge |
| Inhaltstyp der Herausforderungsantwort | text |
| Antwortformat der Herausforderung | challenge |
Antwort: CHALLENGE_STRING (Text/Nur, 200)
Beispiel 3: Textabfrage mit JSON-Antwort
Anbieter sendet
{"challenge":"abc123"}
| Feld | Wert |
|---|---|
| Herausforderungsort | Body |
| Herausforderungsschlüssel | challenge |
| Inhaltstyp der Herausforderungsantwort | json |
| Antwortformat der Herausforderung | { "challenge": "challenge" } |
Antwort: {"challenge":"abc123"} (application/json, 200)
Beispiel 4: Verschachtelter Textpfad (z. B. verification.token) mit Textantwort
Anbieter sendet
{"verification":{"token":"abc123"}}
| Feld | Wert |
|---|---|
| Herausforderungsort | Body |
| Herausforderungsschlüssel | verification.token |
| Inhaltstyp der Herausforderungsantwort | text |
| Antwortformat der Herausforderung | verification.token |
Antwort: abc123 (Text/Nur, 200)
Beispiel 5: Tief geschachtelter Pfad mit JSON-Antwort
Anbieter sendet
{"event":{"challenge":"abc123","type":"verify"}}
| Feld | Wert |
|---|---|
| Herausforderungsort | Body |
| Herausforderungsschlüssel | event.challenge |
| Inhaltstyp der Herausforderungsantwort | json |
| Antwortformat der Herausforderung | { "result": "event.challenge" } |
Antwort: {"result":"abc123"} (application/json, 200)
Beispiel 6: Headerbasierte Herausforderung (Header-Name mit Bindestrich) mit Textantwort
Anbieter sendet
POST /webhook x-webhook-challenge: abc123
| Feld | Wert |
|---|---|
| Herausforderungsort | Header |
| Herausforderungsschlüssel | "x-webhook-challenge" |
| Inhaltstyp der Herausforderungsantwort | text |
| Antwortformat der Herausforderung | "x-webhook-challenge" |
Antwort: abc123 (Text/Nur, 200)
Der Header-Name enthält Bindestriche, die in Analyse-Kontexten als Operatoren falsch interpretiert werden können. Das Einschließen des Bezeichners in doppelte Anführungszeichen (z. B. "x-webhook-challenge") stellt sicher, dass er als literale Schlüsselname behandelt wird. Verwenden Sie immer doppelte Anführungszeichen um einen Bezeichner, der Bindestriche, Punkte oder andere Sonderzeichen enthält.
Beispiel 7: Boolesche Erkennung mit unterschiedlichem Antwortschlüssel
Anbieter sendet
{"type":"url_verification","challenge":"abc","token":"legacytoken"}
Möchten Sie nach Feld type erkennen, antworten aber mit dem Wert challenge .
| Feld | Wert |
|---|---|
| Herausforderungsort | body |
| Herausforderungsschlüssel | type == url_verification` |
| Inhaltstyp der Herausforderungsantwort | json |
| Antwortformat der Herausforderung | { "challenge": "challenge" } |
Antwort: {"challenge":"abc"} (application/json, 200)
Webhook-Header-Authentifizierung
Mit der Header-basierten Authentifizierung validiert UiPath jede eingehende Webhook-Anforderung anhand eines gemeinsamen Geheimnisses, das Sie bei der Verbindungserstellung konfiguriert haben. Dies verhindert, dass unbefugte Anrufer Ihre Workflows auslösen, indem sie an Ihre Webhook-URL posten.
Wie es funktioniert
Wenn die Header-basierte Authentifizierung für eine Verbindung aktiviert ist, führt Integration Service Folgendes aus:
- Prüft jede eingehende Anforderung auf den konfigurierten Header-Schlüssel.
- Akzeptiert das Ereignis, wenn der Header vorhanden ist und sein Wert mit dem gespeicherten Geheimnis übereinstimmt.
- Gibt HTTP 401 Nicht autorisiert zurück und löst keinen Workflow aus, wenn der Header fehlt oder sein Wert nicht übereinstimmt.
Beispielanforderung, die UiPath akzeptiert:
POST /webhook HTTP/1.1
Host: <your-uipath-webhook-url>
X-API-Key: a1b2c3d4e5f6789...
Content-Type: application/json
{ "event": "..." }
POST /webhook HTTP/1.1
Host: <your-uipath-webhook-url>
X-API-Key: a1b2c3d4e5f6789...
Content-Type: application/json
{ "event": "..." }
Beispielanforderung, die UiPath abgelehnt (Header fehlt oder falscher Wert):
HTTP/1.1 401 Unauthorized
HTTP/1.1 401 Unauthorized
Konfigurationsfelder
In der folgenden Tabelle werden die Felder beschrieben, mit denen Sie die Webhook-Header-Authentifizierung auf dem Bildschirm zur Verbindungserstellung konfigurieren können.
| Feld | Beschreibung | Beispiel |
|---|---|---|
| Authentifizierungstyp | Aktiviert oder deaktiviert die Header-Validierung für diese Verbindung. | Header Based Authentication / None |
| Header-Schlüssel | Name des HTTP-Headers, den der Anbieter sendet. | X-API-Key, X-API-Secret |
| Header-Wert | Geheimer Wert, den der Anbieter in diesem Header sendet. Im Ruhezustand maskiert. | a1b2c3d4e5f6789... |
Kompatibilität des Anbieters
Die Header-basierte Authentifizierung funktioniert nur mit Anbietern, bei denen Sie einen benutzerdefinierten HTTP-Header für ausgehende Webhook-Bereitstellungen konfigurieren können.
Wenn Sie nicht sicher sind, ob Ihr Anbieter ausgehende benutzerdefinierte Header unterstützt, überprüfen Sie die Webhook-Dokumentation des Anbieters.
Aktualisieren oder Rotieren des Geheimnisses
Wenn Sie die Verbindung bearbeiten und den Headerwert ändern, wird der neue Wert sofort für alle Trigger wirksam, die diese Verbindung verwenden. Die Konfiguration des Anbieters muss gleichzeitig mit dem neuen Wert aktualisiert werden, andernfalls schlagen die Bereitstellungen des Anbieters mit HTTP 401 fehl, bis Sie dies tun.
Verhalten, wenn die Authentifizierung fehlschlägt
Eine Anforderung wird mit HTTP 401 Nicht autorisiert abgelehnt, wenn:
- Der erwartete Header fehlt in der Anforderung.
- Der Header ist vorhanden, aber sein Wert stimmt nicht mit dem gespeicherten Geheimnis überein.
Fehlgeschlagene Anforderungen werden von UiPath nicht wiederholt und es wird kein Triggerereignis ausgelöst. Es gilt das eigene Wiederholungsverhalten des Anbieters (falls vorhanden).
Ablaufverfolgungen von Authentifizierungsfehlern können im Abschnitt Ablaufverfolgungen angezeigt werden. Um unsere Systeme vor DoS-Angriffen zu schützen, sind die Traces von Authentifizierungsfehlern auf 5 pro Stunde begrenzt.
Wichtige Hinweise
- Die Header-basierte Authentifizierung ist verbindungsbezogenen. Alle Trigger, die für dieselbe Verbindung erstellt wurden, haben denselben Header-Schlüssel und -Wert – die Aktualisierung des Verbindungsgeheimnisses wirkt sich auf jeden Trigger aus, der sie verwendet.
- Die Header-basierte Authentifizierung ist unabhängig von der Herausforderungsüberprüfung. Entweder, beides oder keines kann für eine Verbindung aktiviert werden.
- Der Header-Wert wird verschlüsselt gespeichert und sollte mit der gleichen Vorsicht wie alle anderen Anmeldeinformationen behandelt werden.
- Bei Header-Namen wird gemäß der HTTP-Spezifikation die Groß-/Kleinschreibung nicht berücksichtigt (
X-API-Keyundx-api-keysind gleichwertig).
Webhook JWT authentication
JWT authentication, query parameter filters, and the query parameter outputs are available only in Automation Cloud.
JWT authentication lets UiPath validate every incoming webhook request with a signed JSON Web Token (JWT). The sender signs a token with a secret or a private key and sends it in the Authorization header. UiPath verifies the token with the key that you configured on the connection. Unlike a static header value, a token expires, so a leaked token stops working after its expiration time.
How JWT authentication works
When JWT authentication is enabled on a connection, Integration Service does these checks on every incoming request, including challenge requests:
- Reads the token from the
Authorization: Bearer <your-access-token>header. - Verifies the token signature with the key and the algorithm configured on the connection.
- Checks that the token has an
exp(expiration time) claim and that the token has not expired. If the token has annbf(not before) claim, UiPath accepts the token only after that time. - Accepts the event if all the checks pass. If a check fails, UiPath returns HTTP 401 Unauthorized and does not trigger any workflow.
Example request that UiPath accepts
POST /<organization>/<tenant-id>/elements_/v1/webhooks/events/<webhook-id> HTTP/1.1
Host: cloud.uipath.com
Authorization: Bearer <your-access-token>
Content-Type: application/json
{ "event": "..." }
POST /<organization>/<tenant-id>/elements_/v1/webhooks/events/<webhook-id> HTTP/1.1
Host: cloud.uipath.com
Authorization: Bearer <your-access-token>
Content-Type: application/json
{ "event": "..." }
JWT configuration fields
The following table describes the fields that let you configure webhook JWT authentication on the connection creation screen.
| Feld | Beschreibung | Beispiel |
|---|---|---|
| Authentifizierungstyp | Select JWT Authentication to validate a JWT on every request for this connection. | JWT Authentication |
| Tastentyp | How UiPath verifies the token signature. Passphrase uses a shared secret. PEM Key uses a public key. | Passphrase / PEM Key |
| JWT secret | Shown when Key type is Passphrase. The shared secret that the sender uses to sign the token. | A random value of 32 or more characters |
| JWT public key | Shown when Key type is PEM Key. The PEM-encoded RSA or EC public key that verifies the signature, including the BEGIN and END lines. | -----BEGIN PUBLIC KEY----- ... -----END PUBLIC KEY----- |
| JWT algorithm | The algorithm that the sender uses to sign the token. It must match the key type. | HS256 (default for Passphrase), RS256 (default for PEM Key) |
Supported algorithms
| Tastentyp | Schlüssel | Algorithms |
|---|---|---|
| Passphrase | Shared secret | HS256, HS384, HS512 |
| PEM Key | RSA public key | RS256, RS384, RS512, PS256, PS384, PS512 |
| PEM Key | EC public key | ES256 (P-256), ES384 (P-384), ES512 (P-521) |
UiPath uses only the algorithm configured on the connection. The alg value in the token header must match it. UiPath always rejects unsigned tokens (alg: none).
For Passphrase, use a random secret of at least 32 characters for HS256, 48 characters for HS384, or 64 characters for HS512.
For PEM Key, keep the private key with the sender and paste only the public key into the connection. If the JWT public key field contains a private key, every request fails authentication.
Token requirements
The sender must:
- Send the token in the
Authorizationheader with theBearerscheme. UiPath does not read tokens from query parameters or from other headers. - Sign the token with the configured key and algorithm.
- Include an
expclaim in the token. UiPath rejects tokens that do not have anexpclaim.
UiPath does not check other claims, such as iss, aud, or sub. There is no grace period for the exp and nbf claims, so make sure that the clock of the sender is accurate.
Vendor compatibility for JWT authentication
JWT authentication works only with senders that can create a signed JWT and send it in the Authorization header of each webhook request. For example, your own service or an integration platform that you control. If you are not sure, check the webhook documentation of the sender.
JWT authentication failures
UiPath rejects a request with HTTP 401 Unauthorized if:
- The
Authorizationheader is absent, or it does not use theBearerscheme. - The token signature does not match the configured key, or the token uses a different algorithm.
- The token does not have an
expclaim, has expired, or is used before itsnbftime. - The JWT settings of the connection are not valid. For example, the algorithm does not match the key type, or the JWT public key field does not contain a PEM-encoded public key.
UiPath does not check the JWT settings when you create the connection. An incorrect setting shows only when requests start to fail.
The response contains one of these messages:
| Ursache | Meldung |
|---|---|
| No bearer token in the request | Authentication failed. The request did not include a bearer token in the Authorization header. |
| All other failures | Authentication failed. The bearer token in the Authorization header is invalid or expired. |
Failed requests are not retried by UiPath, and no trigger event is dispatched. Authentication failure traces work the same way as for header-based authentication. For details, see Behavior when authentication fails.
The token in the trigger output
After UiPath verifies a token, it masks the token in the event. In the output of the HTTP Webhook trigger and of the Get Trigger Event Output activity, the Authorization header keeps only the first five characters of the token, for example Bearer eyJhb*****. This prevents a person who can read the event from using the token again.
JWT important notes
- JWT authentication is connection-scoped. All triggers created against the same connection use the same key — updating the connection's key affects every trigger using it.
- When you change the key on the connection, update the sender at the same time. Tokens signed with the old key fail authentication.
- UiPath checks the token on every request, including challenge requests. If your vendor sends a challenge request, the challenge request must also contain a valid token.
- Store the JWT secret with the same care as any other credential.
- Voraussetzungen
- Erstellen einer HTTP Webhook-Verbindung
- Überprüfung der Webhook-Herausforderung
- Unterstützung der Herausforderungsverifizierung
- Konfigurieren der Herausforderungsverifizierung
- Beispiele für die Herausforderungskonfiguration
- Beispiele nach Anbietermuster
- Webhook-Header-Authentifizierung
- Wie es funktioniert
- Konfigurationsfelder
- Kompatibilität des Anbieters
- Aktualisieren oder Rotieren des Geheimnisses
- Verhalten, wenn die Authentifizierung fehlschlägt
- Wichtige Hinweise
- Webhook JWT authentication
- How JWT authentication works
- JWT configuration fields
- Supported algorithms
- Token requirements
- Vendor compatibility for JWT authentication
- JWT authentication failures
- The token in the trigger output
- JWT important notes