HTTP-Verbindung

Einführung

Eine HTTP-Verbindung, die mit dem HTTP-Connector erstellt wird, stellt den Zugriff über das HTTP- oder HTTPS-Protokoll auf einen Service wie eine REST-API, GraphQL-API oder ein Webformular her. Nach der Konfiguration einer Verbindung können Sie Instanzen von HTTP-Aktivitäten erstellen, die dieser Verbindung zugeordnet sind und entweder als Quellen (zur Bereitstellung von Daten in einem Vorgang) oder als Ziele (zur Verarbeitung von Daten in einem Vorgang) verwendet werden.

HTTP-Verbindung erstellen oder bearbeiten

Eine neue HTTP-Verbindung wird mit dem HTTP-Connector von einem dieser Orte aus erstellt:

• Die Registerkarte Projektendpunkte und Connectors der Design-Komponentenpalette (siehe Design-Komponentenpalette).
• Die Seite Globale Endpunkte (siehe Globalen Endpunkt erstellen in Globale Endpunkte).

Eine vorhandene HTTP-Verbindung kann von diesen Orten aus bearbeitet werden:

• Die Registerkarte Projektendpunkte und Connectors der Design-Komponentenpalette (siehe Design-Komponentenpalette).
• Die Registerkarte Komponenten des Projektbereichs (siehe Kontextmenü für Komponentenaktionen in Registerkarte „Komponenten" des Projektbereichs).
• Die Seite Globale Endpunkte (siehe Globalen Endpunkt bearbeiten in Globale Endpunkte).

HTTP-Verbindung konfigurieren

Im Folgenden wird jedes Element der Benutzeroberfläche des HTTP-Verbindungskonfigurationsbildschirms beschrieben.

• Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede HTTP-Verbindung eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten. Dieser Name wird auch verwendet, um den HTTP-Endpunkt zu identifizieren, der sich auf eine bestimmte Verbindung und ihre Aktivitäten bezieht.

• Basis-URL: Geben Sie eine gültige Basis-URL für die Verbindung ein. Um SSL-Verschlüsselung zu verwenden, verwenden Sie einfach https:// in der URL. Fügen Sie keine Abfrageparameter oder Pfade ein, es sei denn, diese werden für alle zugeordneten Aktivitäten verwendet (Sie können eindeutige Pfade und Parameter während der Aktivitätskonfiguration angeben.). Die endgültige URL wird aus der hier angegebenen Basis-URL zusammen mit allen während der Aktivitätskonfiguration angegebenen Pfaden zusammengesetzt.

• Benutzername und Passwort: Geben Sie ggf. einen Benutzernamen und ein Passwort ein, um Zugriff auf den HTTP-Server zu erhalten. Sie können diese Felder für die anonyme Authentifizierung leer lassen, wenn kein Benutzername oder Passwort erforderlich ist.

• Zertifikat: Wählen Sie über das Menü ein verfügbares Zertifikat aus, um sich beim HTTP-Server zu authentifizieren. Client-seitige SSL-Zertifikate können Sie in der Management Console unter Customizations > Client Certificates verwalten.

• Wiederholung: Diese Einstellung funktioniert nur bei Verwendung einer Umgebung, die einer privaten Agent-Gruppe zugeordnet ist. Sie wird verwendet, um eine Anfrage zu wiederholen, wenn ein HTTP-Endpunkt einen dieser Statuscodes zurückgibt: 500, 502, 503 oder 504.

  Diese Einstellung wird wirksam, wenn sie mit privaten Agents ab Version 10.22 verwendet wird.

  Hinweis

  Bei privaten Agents ab Version 10.30 bis 10.33 müssen die Einstellung RecoverableStatusCode und die Fehlercodeliste manuell zur Konfigurationsdatei des privaten Agents hinzugefügt werden.

  Aktivieren Sie das Kontrollkästchen Wiederholung, um zusätzliche Konfigurationsoptionen zu erweitern.

  • Wiederholungsintervall (Sekunden): Geben Sie die Anzahl der Sekunden (maximal 5 Sekunden) ein, die vor dem erneuten Senden einer Anfrage an den HTTP-Endpunkt gewartet werden soll.

  • Maximale Wiederholungen: Geben Sie die maximale Anzahl der Versuche (empfohlen nicht mehr als 5 Mal) ein, um eine Anfrage an den HTTP-Endpunkt erneut zu senden. Wenn die Anfrage nach der maximalen Anzahl von Wiederholungen immer noch fehlschlägt, wird eine Ausnahme mit einer Fehlermeldung im Operationsprotokoll zurückgegeben. Darüber hinaus protokolliert der private Agent jede Wiederholung in der Protokolldatei jitterbit.log.

    Jede Wiederholung wird als Teil desselben Operationslaufs behandelt, wobei nur ein einzelner Datensatz im Operationsprotokoll angezeigt wird. Alle Operationsaktionen, die für die Ausführung nachgelagerter Operationen konfiguriert sind, werden basierend auf dem Endstatus der Operation nach Wiederholungen bis zur maximalen Anzahl von Wiederholungen ausgelöst.

• Optionale Einstellungen: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern.

  • Sicherheitsoption: Wählen Sie ggf. Use Basic HTTP Authentication aus, um sich beim Host mit HTTP-Standardauthentifizierung ohne SSL-Verschlüsselung zu authentifizieren. Beachten Sie, dass das bereitgestellte Passwort im Klartext gesendet wird, wenn diese Option verwendet wird. (Falls nicht erforderlich, wird dies nicht empfohlen.)

    Wenn diese Option nicht verwendet wird, handelt Harmony standardmäßig mit dem Endpunkt aus, um zu bestimmen, welche Authentifizierungsmethoden unterstützt werden, und verwendet die bereitgestellten Anmeldedaten für eines der Protokolle. Neben HTTP Basic unterstützt Harmony diese HTTP-Authentifizierungsoptionen:

    • HTTP Digest

    • HTTP Digest mit Authentifizierung mit IE-Geschmack

  • Zeilen ignorieren: Wenn die Quelldaten Kopf- und/oder Fußzeilen enthalten, die ignoriert werden sollen, geben Sie die Anzahl der zu ignorierenden Zeilen in den Feldern First und Last ein.

    Hinweis

    Diese Einstellung wird nicht wirksam, wenn HTTP-Aktivitäten aus einem Skript mit den Funktionen ReadFile oder WriteFile referenziert werden.

  • Proxy-Einstellungen: Wenn Sie einen benutzerdefinierten Proxy angeben möchten, wählen Sie über das Dropdown-Menü eine dieser Optionen aus:

    • Standard: Proxy-Einstellungen sind aktiviert und verwenden die Proxy-Konfiguration des privaten Agents, falls vorhanden. Wenn Proxy-Einstellungen nicht in der Agent-Konfiguration angegeben sind, hat die Einstellung Standard das gleiche Ergebnis wie die Einstellung Deaktivieren.

    • Deaktivieren: Proxy-Einstellungen sind für diese spezifische Verbindung deaktiviert und umgehen die Proxy-Konfiguration des privaten Agents, falls vorhanden.

    • Benutzerdefiniert: Proxy-Einstellungen sind für diese spezifische Verbindung aktiviert und verwenden hier bereitgestellte benutzerdefinierte Informationen. Diese Option umgeht die Proxy-Konfiguration des privaten Agents, falls vorhanden, und verwendet stattdessen benutzerdefinierte Proxy-Informationen. Wenn Benutzerdefiniert ausgewählt ist, werden zusätzliche Felder verfügbar, um diese zu konfigurieren. Weitere Informationen zu diesen Feldern finden Sie unter Enabling proxy for private agents.

• Erweiterte HTTP-Eigenschaften: Legen Sie diese erweiterten Optionen fest, falls zutreffend:

  • Content-Type: Geben Sie den Content-Type der Anforderungsstruktur ein, die von der jeweiligen API erwartet wird. Wenn die verwendete Methode keine strukturierten Daten akzeptiert oder die API nicht erfordert, dass der Content-Type angegeben wird, können Sie dieses Feld leer lassen. Beispiele für Content-Types sind text/plain, application/json, application/x-www-form-urlencoded usw.

  • Content-Encoding aktivieren: Wenn diese Option aktiviert ist, wird der Header Accept-Encoding mit der von Harmony unterstützten Codierung gesendet. Derzeit wird Gzip unterstützt.

  • Chunked Transfer Encoding aktivieren: Wenn diese Option aktiviert ist, wird der Header Transfer-Encoding: chunked gesendet. Verwenden Sie diese Option, wenn Sie große Datenmengen übertragen.

  • Expect 100-continue senden: Wenn diese Option aktiviert ist, wird der Header Expect: 100-continue gesendet. Mit dieser Option werden keine Daten gesendet, bis der HTTP-Server die Header validiert hat. Verwenden Sie diese Option, wenn Sie große Datenmengen senden, aber kein Chunked Transfer Encoding verwenden möchten.

  • Schwache Cipher zulassen: Aktivieren Sie dieses Kontrollkästchen, um mit HTTP-Servern zu kommunizieren, die schwache Cipher verwenden (DES/3DES und RC4).

  • HTTP Accept Encoding Gzip: Diese Option ist standardmäßig aktiviert und teilt dem HTTP-Server mit, dass Harmony eine Gzip-komprimierte Antwort akzeptieren kann. Im Gegenzug befolgt Harmony den RFC-1952-Standard und dekomprimiert Gzip-HTTP-Antworten automatisch. Wenn der Server kein Gzip verwendet, erkennt Harmony, dass die Antwort nicht komprimiert ist, und verarbeitet sie wie gewohnt.

  • Nur anwendbar bei Verwendung von HTTPS: Verwenden Sie das Menü, um die Auswahl von Negotiate (Standard) auf eine bestimmte SSL- oder TLS-Version zu ändern, falls erforderlich. Wählen Sie aus SSLv3, TLSv1.0, TLSv1.1, TLSv1.2 oder TLSv1.X. Wählen Sie TLSv1.X, wenn TLS 1.3 erforderlich ist.

  • Request Headers (eine Zeile pro Header): Jeder Text, der in dieses Feld eingegeben wird, wird als HTTP-Header gesendet. Geben Sie jeden Header in einer Zeile an, es sei denn, der Header wird gemäß HTTP-Standard umgebrochen. Dieses Feld unterstützt auch die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen, indem Sie Variablen in eckigen Klammern [ ] durch ihre Werte ersetzen.

  Maskierung von Request Headers

  Sensitive Request Headers werden standardmäßig in Runtime-Logs maskiert. Um zusätzliche Request Headers bei Verwendung von privaten Agenten zu maskieren, fügen Sie diese zum Abschnitt [Masking] der Konfigurationsdatei des privaten Agenten hinzu.

• Test: Klicken Sie, um die Verbindung zu überprüfen, indem Sie eine HTTP-GET-Anfrage ohne Autorisierung senden.

• Speichern: Klicken Sie, um die Verbindungskonfiguration zu speichern und zu schließen.

• Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder vorhandenen Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

• Löschen: Nachdem Sie eine vorhandene Verbindungskonfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Verbindung löschen möchten.

Nächste Schritte

Nachdem eine HTTP-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Design-Canvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu verarbeiten) verwendet werden.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind über den Projektbereich und die Design-Komponentenpalette zugänglich. Weitere Informationen finden Sie unter Aktionsmenüs in Connector-Grundlagen.

• GET: Ruft Informationen über eine Ressource auf einem Dienst ab, auf den über das HTTP- oder HTTPS-Protokoll zugegriffen werden kann, und kann als Quelle oder Ziel in einem Vorgang verwendet werden.

• PUT: Ersetzt eine vorhandene Ressource auf einem Dienst, auf den über das HTTP- oder HTTPS-Protokoll zugegriffen werden kann, und kann als Quelle oder Ziel in einem Vorgang verwendet werden.

• POST: Erstellt eine neue Ressource auf einem Dienst, auf den über das HTTP- oder HTTPS-Protokoll zugegriffen werden kann, und kann als Quelle oder Ziel in einem Vorgang verwendet werden.

• DELETE: Löscht eine Ressource auf einem Dienst, auf den über das HTTP- oder HTTPS-Protokoll zugegriffen werden kann, und kann als Quelle oder Ziel in einem Vorgang verwendet werden.

• Custom: Führt eine angegebene HTTP-Methode auf einem Dienst aus, auf den über das HTTP- oder HTTPS-Protokoll zugegriffen werden kann, und kann als Quelle oder Ziel in einem Vorgang verwendet werden.