Mit dem HTTP Request Connector können Sie Befehle in einer Kette verwenden, um Hypertext Transfer Protocol (HTTP) GET, POST, PUT und DELETE Anfragen an eine bestimmte URL durchzuführen. Sie können diesen Konnektor zum Beispiel in einer Kette verwenden, um andere Lösungen über ihre jeweiligen Konnektoren zu verbinden und zu automatisieren.
Um zu sehen, wie eine HTTP-Anfrage aufgebaut ist, sehen Sie sich unsere HTTP Connector Beispielliste an.
Hinweis: Obwohl dies als HTTP-Anfrage gekennzeichnet ist, wird HTTPS (Secure HTTP) unterstützt (und empfohlen).
Anforderungen
- Obwohl die Verbindung keine OData-spezifischen Funktionen hat, können Sie alle notwendigen Komponenten der Anfrage über die Parameter Headers oder Query string hinzufügen.
- Um den Connector für die Verwendung in den Ketten Ihrer Organisation verfügbar zu machen, muss ein Sicherheitsadministrator von org ihn zunächst aktivieren.
Einrichten des HTTP-Request-Connectors
- Klicken Sie unter Chain Builder auf Verbindungen , und dann Erstellen oben rechts.
- Unter Connector Connection, wählen Sie HTTP Request und den Standard CloudRunner.
- Geben Sie unter Basisinformationen einen eindeutigen Namen und eine Beschreibung ein, um den Konnektor zu identifizieren.
- Wählen Sie die Umgebungen aus, die die Verbindung verwenden sollen, und klicken Sie auf Speichern.
- Um die Verbindung zu testen, erstellen Sie und führen Sie eine Kette mit dem Befehl GET des Konnektors aus, und überprüfen Sie, ob eine gültige Ausgabe zurückgegeben wird.
Verwalten von Anmeldeinformationen für sichere HTTP-Anfragen
Um die HTTP-Anfragen des Konnektors zu sichern, können Sie seine Befehle mit einrichten:
- Grundlegende Authentifizierung mit Benutzernamen und Passwort
-
Privacy-Enhanced Mail (PEM)-kodierte Zertifikate, z.B. für die gegenseitige Transport Layer Security (mTLS)-Authentifizierung
Hinweis: Workiva generiert nicht Zertifikate für HTTP-Anfragen. Um PEM-kodierte Zertifikate zu verwenden, geben Sie das Paar aus öffentlichem und privatem Schlüssel an, das mit den Anfragen gesendet werden soll, sowie optional ein Zertifikat der Zertifizierungsstelle (CA).
Um einen Befehl mit Anmeldeinformationen einzurichten:
- In Chain Builder, laden Sie die Zertifikate als Arbeitsbereichsressourcen hoch.
- Wenn Sie den Befehl für den Konnektor einrichten, wählen Sie die Zertifikate als Eigenschaften aus:
- Für die Basisauthentifizierung geben Sie die Anmeldedaten unter Benutzername und Passwort ein oder wählen sie aus.
- Wählen Sie für das Paar öffentlicher/privater Schlüssel die entsprechenden Ressourcen unter Zertifikat und Zertifikat privater Schlüssel aus.
- Für ein optionales CA-Zertifikat wählen Sie dessen Ressource unter CA-Zertifikat aus.
Fehlersuche
- Wenn ein Fehler zurückgegeben wird, überprüfen Sie Ihre Quell-URL und die Struktur Ihrer Anfrage. In unserem Artikel HTTP-Connector-Beispiele wird jede erforderliche Komponente ausführlich beschrieben.
- Prüfen Sie, ob Ihre Abfragezeichenfolge kodiert ist.