HTTP v2-Verbindung

Einführung

Eine HTTP v2-Verbindung, die mit dem HTTP v2-Connector erstellt wurde, richtet über das HTTP- oder HTTPS-Protokoll den Zugriff auf einen Dienst wie eine REST API, eine GraphQL API oder ein Webformular ein. Sobald eine Verbindung konfiguriert ist, können Sie Instanzen von HTTP v2-Aktivitäten erstellen, die mit dieser Verbindung verknüpft sind und entweder als Quellen (zum Bereitstellen von Daten in einer Operation) oder als Ziele (zum Verbrauchen von Daten in einer Operation) verwendet werden können.

Erstellen oder Bearbeiten einer HTTP v2-Verbindung

Eine neue HTTP v2-Verbindung wird mithilfe des HTTP v2-Connectors von einem dieser Standorte aus erstellt:

• Die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).
• Die Seite Globale Verbindungen (siehe Einen globalen Endpoint erstellen in Globale Verbindungen).

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

• Die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).
• Die Tab Komponenten des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).
• Die Seite Globale Verbindungen (siehe Einen globalen Endpoint bearbeiten in Globale Verbindungen).

Konfigurieren einer HTTP v2-Verbindung

Jedes Benutzeroberflächenelement des HTTP v2-Verbindungskonfigurationsbildschirms wird unten beschrieben.

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

• Basis URL: Geben Sie die Basis URL ein. Die Basis URL wird zum Testen der Verbindung verwendet. Ob dieses Feld zur Laufzeit verwendet wird, hängt davon ab, ob das Feld HTTP-Aktivitäts URL einer HTTP v2-Aktivität ausgefüllt ist:

  • Wenn im Feld HTTP-Aktivitäts URL eine teilweise oder URL URL ist, wird die zur Laufzeit verwendete URL aus der Basis URL und der HTTP-Aktivitäts-URL zusammengesetzt.

  • Wenn im Feld HTTP-Aktivitäts URL eine vollständige URL angegeben ist, wird die Basis URL zur Laufzeit nicht verwendet.

• Autorisierung: Verwenden Sie das Menü, um den Authentifizierungstyp auszuwählen, der unten zusammengefasst ist. Die Konfiguration jedes Authentifizierungstyps wird in HTTP v2-Verbindungsauthentifizierungstypen beschrieben.

  • API Schlüssel: Geben Sie ein API Key-Value Paar an, das in Headern oder Abfrage gesendet werden soll.

  • AWS-Signatur: Geben Sie eine AWS-Zugriffsschlüssel-ID, einen geheimen Zugriffsschlüssel, eine Region, einen Dienst und ein Sitzungstoken an, die mit Amazon Web Services (AWS) Signature Version 2 in Headern oder Abfrage gesendet werden sollen.

  • Basisauthentifizierung: Geben Sie einen Benutzernamen und ein Passwort an, die in Headern gesendet werden sollen.

  • Bearer Token: Geben Sie ein Trägertoken an, das in Headern gesendet werden soll.

  • Digest Auth: Geben Sie einen Benutzernamen, ein Passwort, einen Realm, einen Nonce, einen Algorithmus, QOP, eine Nonce-Anzahl, einen Client-Nonce und Opaque an, um Header zu senden.

  • Hawk-Authentifizierung: Geben Sie eine Hawk-Authentifizierungs-ID, einen Authentifizierungsschlüssel, anwendungsspezifische Informationen, eine App-ID und DLG an, die in Headern gesendet werden sollen.

  • Keine Authentifizierung: Wählen Sie diese Option aus, um anonym und ohne Autorisierung auf den Dienst zuzugreifen.

  • OAuth 2.0: Geben Sie den Berechtigungstyp an und stellen Sie den OAuth-Token-Endpoint, die Client-ID, das Client-Geheimnis und den Bereich bereit, um Header oder den Anforderungstext zu senden.

• Wiederholen: Funktioniert nur bei Verwendung einer Umfeld, die einer privaten Agentengruppe zugeordnet ist. Diese Einstellung wird verwendet, um eine Anforderung zu wiederholen, wenn ein HTTP v2 Endpoint einen dieser Statuscodes zurückgibt: 500, 502, 503, oder 504.

  Diese Einstellung wird wirksam, wenn sie mit privaten Agenten der Version 10.34 oder höher verwendet wird.

  Aktivieren Sie das Kontrollkästchen Wiederholen, um zusätzliche Konfigurationsoptionen zu erweitern:

  

  • Wiederholungsintervall (Sekunden): Geben Sie die Anzahl der Sekunden (maximal 5 Sekunden) ein, die zwischen dem erneuten Senden einer Anforderung an den HTTP v2- Endpoint gewartet werden soll.

  • Maximale Wiederholungen: Geben Sie die maximale Anzahl von Wiederholungen (maximal 5 Wiederholungen) ein, mit der eine Anfrage erneut an den HTTP v2- Endpoint gesendet wird. Wenn die Anfrage nach der maximalen Anzahl von Wiederholungen immer noch fehlschlägt, wird eine Ausnahme mit einer Fehlermeldung im Operation zurückgegeben. Darüber hinaus protokolliert der private Agent jeden Wiederholungsversuch im jitterbit.log Protokolldatei.

    Jeder Wiederholungsversuch wird als Teil desselben Operation behandelt, wobei nur ein einziger Datensatz im Operation erscheint. Alle Operation, die zum Ausführen nachlegende Operationen konfiguriert sind, werden basierend auf dem Endstatus der Operation nach der Wiederholung bis zur maximalen Anzahl von Wiederholungsversuchen ausgelöst.

• Optionale Einstellungen: Klicken Sie hier, um weitere optionale Einstellungen einzublenden:

  

  • Antwortinhalt in Base64-Zeichenfolge abrufen: Auswählen, um Base64-codiert zurückzugeben responseContent von HTTP v2-Aktivitäten.

  • Proxy-Einstellungen: Wählen Sie über das Menü die Proxy-Einstellungen aus, eine dieser Optionen:

    • Benutzerdefiniert: Proxy-Einstellungen werden mithilfe der in den zusätzlichen Feldern angegebenen Eingaben aktiviert, die verfügbar werden, wenn diese Option ausgewählt wird. Diese Option umgeht die private Agent-Proxy-Konfiguration, falls vorhanden.

      

      • Host: Geben Sie den Host des HTTP-Proxyservers ein.
      • Port: Geben Sie den Port des HTTP-Proxyservers ein.
      • Benutzer: Geben Sie den Benutzernamen für die HTTP-Proxyserver-Authentifizierung ein.
      • Passwort: Geben Sie das Passwort für die HTTP-Proxyserver-Authentifizierung ein.
      • NTLM-Domäne: Geben Sie die NTLM-Domäne für die HTTP-Proxyserver-Authentifizierung ein.
      • Verwendung nicht verifizierter Zertifikate durch Proxy zulassen: Wählen Sie diese Option aus, um die Verwendung nicht verifizierter Zertifikate durch den HTTP-Proxyserver zuzulassen.

    • Standard: Proxy-Einstellungen sind aktiviert, mithilfe der privaten Agent-Proxy-Konfiguration, falls vorhanden. Wenn in der Agentenkonfiguration keine Proxy-Einstellungen angegeben sind, hat die Einstellung Standard dasselbe Ergebnis wie die Einstellung Deaktivieren.

    • Deaktivieren: Proxy-Einstellungen werden deaktiviert und die private Agent-Proxy-Konfiguration wird umgangen, falls eines existiert.

  • Erweiterte HTTP-Eigenschaften: Legen Sie ggf. diese erweiterten Optionen fest:

    • Content-Type: Geben Sie den Content-Type der Anforderungsstruktur ein, die von der jeweiligen API erwartet wird. Beispiel: text/plain, application/json, application/x-www-form-urlencoded, usw. Wenn die verwendete Methode keine strukturierten Daten akzeptiert oder wenn die API keine Angabe des Inhaltstyps erfordert, lassen Sie dieses Feld leer. Dieses Feld wird von der Einstellung Anforderungsheader bei Aktivitätsausführung senden nicht beeinflusst.

      Alternativ kann der Inhaltstyp in anderen UI-Konfigurationsfeldern angegeben oder in der Transformation bereitgestellt werden. Wenn der Inhaltstyp an mehreren Stellen angegeben wird, gilt diese Rangfolge:

      1. EIN Content-Type Der in der Tabelle Zusätzliche Einstellungen einer HTTP v2-Aktivität angegebene Header überschreibt alle folgenden Felder.
      2. Die bodyContentType Das in einer Transformation angegebene Feld überschreibt die verbleibenden Felder unten.
      3. Ein Content-Type Header, der in der Transformation bereitgestellt wird headers Knoten überschreibt die verbleibenden Felder unten.
      4. A Content-Type Der im Feld Anforderungsheader einer HTTP v2-Aktivität angegebene Header überschreibt das verbleibende Feld unten.
      5. Ein Content-Type Der im Feld Anforderungsheader einer HTTP v2-Verbindung angegebene Header hat die niedrigste Priorität, wenn Anforderungsheader in Aktivitätsausführung senden aktiviert ist.

      Notiz

      Wenn ein Header an mehreren Stellen definiert ist, wird jede Instanz des Header der Anforderung einer Aktivität gemäß der oben genannten Rangfolge hinzugefügt. Diese Reihenfolge basiert darauf, wie Dienste normalerweise doppelte Header in einer Anforderung verarbeiten.

    • Inhaltskodierung aktivieren: Wählen Sie diese Option, um die Accept-Encoding Header mit Gzip Kodierung. Dieses Feld wird von der Einstellung Anforderungsheader bei Aktivitätsausführung senden nicht beeinflusst.

      Alternativ kann dieser Header in anderen UI-Konfigurationsfeldern definiert oder in der Transformation bereitgestellt werden. Wenn dieser Header an mehreren Stellen angegeben wird, gilt diese Rangfolge:

      1. Ein Accept-Encoding Header, der in der Transformation bereitgestellt wird headers Knoten überschreibt alle Felder darunter.
      2. Ein Accept-Encoding Der im Feld Anforderungsheader einer HTTP v2-Aktivität angegebene Header überschreibt das verbleibende Feld unten.
      3. Ein Accept-Encoding Der im Feld Anforderungsheader einer HTTP v2-Verbindung angegebene Header hat die niedrigste Priorität, wenn Anforderungsheader in Aktivitätsausführung senden aktiviert ist.

      Notiz

      Wenn ein Header an mehreren Stellen definiert ist, wird jede Instanz des Header gemäß der oben genannten Rangfolge zur Anforderung einer Aktivität hinzugefügt. Diese Reihenfolge basiert darauf, wie Dienste normalerweise doppelte Header in einer Anforderung verarbeiten.

    • Chunked Transfer Encoding aktivieren: Wählen Sie diese Option aus, um die Transfer-Encoding: chunked Header. Verwenden Sie diese Option, wenn Sie große Datensätze übertragen. Dieses Feld wird von der Einstellung Anforderungsheader bei Aktivitätsausführung senden nicht beeinflusst.

      Alternativ kann dieser Header in anderen UI-Konfigurationsfeldern definiert oder in der Transformation bereitgestellt werden. Wenn dieser Header an mehreren Stellen angegeben wird, gilt diese Rangfolge:

      1. EIN Transfer-Encoding Header, der in der Transformation bereitgestellt wird headers Knoten überschreibt alle Felder darunter.
      2. A Transfer-Encoding Der im Feld Anforderungsheader einer HTTP v2-Aktivität angegebene Header überschreibt das verbleibende Feld unten.
      3. Ein Transfer-Encoding Der im Feld Anforderungsheader einer HTTP v2-Verbindung angegebene Header hat die niedrigste Priorität, wenn Anforderungsheader in Aktivitätsausführung senden aktiviert ist.

      Notiz

      Wenn ein Header an mehreren Stellen definiert ist, wird jede Instanz des Header gemäß der oben genannten Rangfolge zur Anforderung einer Aktivität hinzugefügt. Diese Reihenfolge basiert darauf, wie Dienste normalerweise doppelte Header in einer Anforderung verarbeiten.

    • Schwache Chiffren zulassen: Diese Option ist derzeit nicht funktionsfähig.

    • Aktiv bleiben: Wählen Sie diese Option aus, um zuzulassen, dass eine einzelne TCP-Verbindung für mehrere HTTP-Anfragen und-Antworten offen bleibt.

    • SSL-Zertifikatsüberprüfung: Wählen Sie diese Option aus, um den Dienst durch Validieren des während des Handshake-Prozesses vorgelegten SSL-/TLS-Zertifikats zu überprüfen.

    • Anforderungs URL kodieren: Auswählen, um URL zu kodieren die Anforderungs URL.

    • Weiterleitungen folgen: Wählen Sie diese Option aus, um dem Connector zu erlauben, bei allen Weiterleitungen, die auf der Basis URL vorhanden sind, umzuleiten. Wenn die Basis URL umleitet und diese Einstellung nicht ausgewählt ist, tritt beim Testen der Verbindung und beim ersten Ausführen eines Operation ein Fehler auf. Wenn diese Option ausgewählt ist, wird das folgende Feld sichtbar:

      • Maximale Anzahl an Weiterleitungen: Geben Sie die Anzahl der Weiterleitungen ein, denen die Verbindung folgt, bevor ein Fehler zurückgegeben wird.

    • Gilt nur bei Verwendung von HTTPS: Verwenden Sie das Menü, um die Auswahl von Verhandeln (Standard) auf eine bestimmte TLS-Version zu ändern, wenn der Dienst dies erfordert. Wählen Sie dabei TLS 1.0, TLS 1.1, TLS 1.2 oder TLS 1.3.

    • Anforderungsheader: Definieren Sie HTTP-Header für die Verbindung. Klicken Sie auf das Symbol „Hinzufügen“ um der folgenden Tabelle eine Header hinzuzufügen und für jeden Anforderungsparameter ein Key-Value Paar einzugeben.

      Um die Zeile zu speichern, klicken Sie auf das Senden-Symbol in der Spalte ganz rechts.

      Um eine einzelne Zeile zu bearbeiten oder zu löschen, bewegen Sie den Mauszeiger über die Spalte ganz rechts und verwenden Sie das Bearbeitungssymbol oder Symbol „Löschen“ .

      Um alle Zeilen zu löschen, klicken Sie auf Alles löschen.

      Alternativ können Header in anderen UI-Konfigurationsfeldern definiert oder in der Transformation bereitgestellt werden. Header, die keinen gemeinsamen Schlüssel haben, werden kumulativ gesendet, unabhängig davon, wo sie angegeben sind.

      Wenn der gleiche Header Schlüssel an mehreren Stellen angegeben wird, gilt diese Rangfolge:

      1. Ein Header, der in der Transformation bereitgestellt wird headers Knoten überschreibt alle Felder darunter.
      2. Ein im Feld Anforderungsheader einer HTTP v2-Aktivität bereitgestellter Header überschreibt das verbleibende Feld unten.
      3. Ein Header, der im Feld Anforderungsheader einer HTTP v2-Verbindung (dieses Feld) bereitgestellt wird, hat die niedrigste Priorität, wenn Anforderungsheader bei der Aktivitätsausführung senden aktiviert ist.

      Notiz

      Wenn ein Header an mehreren Stellen definiert ist, wird jede Instanz des Header gemäß der oben genannten Rangfolge zur Anforderung einer Aktivität hinzugefügt. Diese Reihenfolge basiert darauf, wie Dienste normalerweise doppelte Header in einer Anforderung verarbeiten.

      Wichtig

      Felder in der Tabelle Anforderungsheader zeigen das variable Symbol nur im Bearbeitungsmodus. Damit die Variablenwerte dieser Felder zur Laufzeit ausgefüllt werden, muss die Agentenversion mindestens 10.75 / 11.13 sein.

    • Anforderungsheader bei Aktivitätsausführung senden: Wählen Sie diese Option aus, um in Anforderungsheadern definierte Header an HTTP v2-Aktivitäten zu übergeben. Beachten Sie die oben stehende Rangfolge, um zu bestimmen, wie in einer HTTP v2-Verbindung definierte Header mit an anderen Stellen definierten Headern interagieren.

• Test: Klicken Sie hier, um die Verbindung zu überprüfen, indem Sie eine HTTP GET-Anforderung mit der konfigurierten Autorisierung senden. Ein Test gilt als erfolgreich, wenn ein beliebiger 2xx-HTTP-Statuscode zurückgegeben wird. Ein 405 Method Not Allowed Antwort wird ebenfalls als erfolgreich behandelt. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die der aktuellen Umfeld zugeordnet ist. Dieser Connector unterstützt das Anhalten des Downloads der neuesten Connector-Version mithilfe der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.

• Änderungen speichern: Klicken Sie hier, um die Verbindungskonfiguration zu speichern und zu schließen.

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen an einer neuen oder vorhandenen Konfiguration hier, um die Konfiguration ohne Speichern zu schließen. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

• Löschen: Klicken Sie nach dem Öffnen einer vorhandenen Verbindungskonfiguration hier, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschen und Entfernen). Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Verbindung löschen möchten.

Nächste Schritte

Nachdem eine HTTP v2-Verbindung hergestellt wurde, platzieren Sie einen Aktivitätstyp auf der Design-Canvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verbrauchen von Daten in einem Operation) verwendet werden können.

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.

Diese Aktivitätstypen sind verfügbar:

• PATCH: Wendet teilweise Änderungen auf eine vorhandene Ressource eines über das HTTP- oder HTTPS-Protokoll zugänglichen Dienstes an und kann als Quelle oder Ziel in einer Operation verwendet werden.

• KOPF: Ruft die Statuszeile und den Header Abschnitt einer Ressource eines über das HTTP- oder HTTPS-Protokoll zugänglichen Dienstes ab und kann in einer Operation als Quelle oder Ziel 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 Operation verwendet werden.

• ERHALTEN: Ruft Informationen zu einer Ressource eines Dienstes ab, auf den über das HTTP- oder HTTPS-Protokoll zugegriffen werden kann, und kann in einem Operation als Quelle oder Ziel verwendet werden.

• OPTIONEN: Ruft Informationen zu den Kommunikationsoptionen für eine Ressource auf einem über das HTTP- oder HTTPS-Protokoll zugänglichen Dienst ab und kann als Quelle oder Ziel in einem Operation verwendet werden.

• SCHÜTTGUT: Sendet mehrere Anfragen an einen über das HTTP- oder HTTPS-Protokoll zugänglichen Dienst und kann als Quelle oder Ziel in einer Operation verwendet werden.

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

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