Cloud Connector-Erweiterung – Übersicht

Last update: Fri Dec 12 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Themen:

Erstellt für:

Entwickler

Mit der Cloud Connector-Ereignisweiterleitungserweiterung können Sie benutzerdefinierte HTTP-Anfragen erstellen, um Daten an ein Ziel zu senden oder Daten von einem Ziel abzurufen. Die Cloud Connector-Erweiterung ist wie Postman für das Adobe Experience Platform Edge Network und kann verwendet werden, um Daten an einen Endpunkt zu senden, der noch keine dedizierte Erweiterung hat.

Verwenden Sie diese Referenz, um Informationen zu den verfügbaren Optionen beim Erstellen einer Regel mithilfe dieser Erweiterung zu erhalten.

Aktionstyp der Cloud Connector-Erweiterung

In diesem Abschnitt wird der Aktionstyp „Daten senden“ beschrieben, der in der Adobe Experience Platform Cloud Connector-Erweiterung verfügbar ist.

Anfragetyp

Zur Auswahl des für den Endpunkt erforderlichen Anfragetyps wählen Sie den entsprechenden Typ in der Dropdown-Liste Request Type aus.

Methode

Beschreibung

GET

Fordert eine Darstellung der angegebenen Ressource an. GET-Anforderungen sollten Daten nur abrufen.

POST

Sendet eine Entität an die angegebene Ressource, was häufig zu Zustandsänderungen oder Nebeneffekten auf dem Server führt.

PUT

Ersetzt alle aktuellen Darstellungen der Zielressource durch die Anforderungsnutzdaten.

PATCH

Nimmt partielle Änderungen an einer Ressource vor.

DELETE

Löscht die angegebene Ressource.

Endpunkt-URL

Geben Sie in das Textfeld neben dem Dropdown-Menü „Anfragetyp“ die URL für den Endpunkt ein, an den Sie Daten senden möchten.

Konfiguration der Abfrageparameter, Header und Nachrichtenkörper

Verwenden Sie die einzelnen Registerkarten (Abfrageparameter, Header und Nachrichtenkörper-Datenelemente), um zu steuern, welche Daten an einen bestimmten Endpunkt gesendet werden.

Abfrageparameter

Definieren Sie einen Schlüssel und einen Wert für jedes Schlüssel-Wert-Paar, das Sie als Abfragezeichenfolge-Parameter senden möchten. Um ein Datenelement manuell einzugeben, verwenden Sie die Datenelement-Tokenisierung für die Ereignisweiterleitung mit geschweiften Klammern. Um den Wert eines Datenelements mit dem Namen „siteSection“ als Schlüssel oder Wert zu referenzieren, geben Sie {{siteSection}} ein. Sie können auch das zuvor erstellte Datenelement wählen, indem Sie es im Dropdown-Menü auswählen.

Um weitere Abfrageparameter hinzuzufügen, wählen Sie Add Another aus.

Definieren Sie einen Schlüssel und einen Wert für jedes Schlüssel-Wert-Paar, das Sie als Header senden möchten. Um ein Datenelement manuell einzugeben, verwenden Sie die Datenelement-Tokenisierung für die Ereignisweiterleitung mit geschweiften Klammern. Um den Wert eines Datenelements mit dem Namen „pageName“ als Schlüssel oder Wert zu referenzieren, geben Sie {{pageName}} ein. Sie können auch das zuvor erstellte Datenelement wählen, indem Sie es im Dropdown-Menü auswählen.

Um weitere Header hinzuzufügen, wählen Sie Add Another aus.

In der folgenden Tabelle sind die vordefinierten Header aufgeführt. Sie sind nicht auf diese Header beschränkt und können bei Bedarf eigene benutzerdefinierte Header hinzufügen. Diese stehen jedoch als Unterstützung zur Verfügung.

NOTE

Weitere Informationen zu diesen Headern finden Sie unter https://developer.mozilla.org/de/docs/Web/HTTP/Headers.

Header

Beschreibung

Wird von einem Benutzeragenten zur Angabe übertragen, dass er auf einen früheren Zustand einer Originalressource zugreifen möchte. Zu diesem Zweck wird der Accept-Datetime-Header in einer HTTP-Anfrage an ein TimeGate für eine ursprüngliche Ressource übermittelt. Der Wert gibt den Zeitpunkt des gewünschten früheren Zustands der Originalressource an.

Access-Control-Request-Headers

Wird von Browsern bei einer Preflight-Anfrage verwendet, um dem Server mitzuteilen, welche HTTP-Header der Client bei der eigentlichen Anfrage senden könnte.

Access-Control-Request-Method

Wird von Browsern bei einer Preflight-Anfrage verwendet, um dem Server mitzuteilen, welche HTTP-Methode bei der eigentlichen Anfrage verwendet wird. Dieser Header ist erforderlich, da die Preflight-Anfrage immer eine OPTION ist und nicht dieselbe Methode wie die eigentliche Anfrage verwendet.

Authorization

Enthält die Anmeldedaten zum Authentifizieren eines Benutzeragenten bei einem Server.

Cache-Control

Anweisungen für Caching-Mechanismen sowohl in Anfragen als auch in Antworten.

Verbindung

Steuert, ob die Netzwerkverbindung nach Abschluss der aktuellen Transaktion geöffnet bleibt.

Content-Length

Die Größe der Ressource in Bytes als Dezimalzahl.

Content-Type

Gibt den Medientyp der Ressource an.

Enthält gespeicherte HTTP-Cookies, die zuvor vom Server mit dem Set-Cookie-Header gesendet wurden.

Datum

Der allgemeine HTTP-Header enthält das Datum und die Uhrzeit, wann die Nachricht ursprünglich gesendet wurde.

DNT

Gibt die Tracking-Präferenz des Benutzers an.

Expect

Gibt Erwartungen an, die vom Server erfüllt werden müssen, um die Anfrage ordnungsgemäß zu verarbeiten.

Forwarded

Enthält Informationen von den Reverse-Proxy-Servern, die verändert werden oder verloren gehen, wenn ein Proxy am Pfad der Anfrage beteiligt ist.

Aus

Enthält eine Internet-E-Mail-Adresse für einen menschlichen Benutzer, der den anfragenden Benutzeragenten steuert.

Host

Gibt den Host und die Port-Nummer des Servers an, an den die Anfrage gesendet wird.

If-Match

If-Modified-Since

Implementierungsspezifischer Header, der an jeder Stelle der Anfrage-Antwort-Kette verschiedene Effekte haben kann. Wird für Abwärtskompatibilität mit HTTP/1.0-Caches verwendet, bei denen der Cache-Control-Header noch nicht vorhanden ist.

Proxy-Authorization

Bereich

Gibt den Teil eines Dokuments an, der vom Server zurückgegeben werden soll.

Referrer

Die Adresse der vorherigen Web-Seite, von der einem Link zur aktuell angeforderten Seite gefolgt wurde.

Gibt die Übertragungskodierungen an, die der Benutzeragent akzeptiert. (Sie könnten es informell Accept-Transfer-Encoding nennen, was intuitiver wäre).

Upgrade

Das relevante RFC-Dokument für das Upgrade-Header-Feld ist RFC 7230, Abschnitt 6.7. Der Standard legt Regeln für die Aktualisierung oder den Wechsel zu einem anderen Protokoll in der aktuellen Client-, Server- und Transportprotokollverbindung fest. Dieser Header-Standard ermöglicht es beispielsweise einem Client, von HTTP 1.1 zu HTTP 2.0 zu wechseln, vorausgesetzt, der Server entscheidet, das Upgrade-Header-Feld zu bestätigen und zu implementieren. Keine der Parteien muss die im Upgrade-Header-Feld angegebenen Bedingungen akzeptieren. Es kann sowohl in Client- als auch in Server-Headern verwendet werden. Wenn das Upgrade-Header-Feld angegeben ist, MUSS der Absender auch das Connection-Header-Feld mit der upgrade-Option senden.

User-Agent

Enthält eine charakteristische Zeichenfolge, die es den Netzwerkprotokoll-Peers ermöglicht, den Programmtyp, das Betriebssystem, den Software-Hersteller oder die Software-Version des anfragenden Software-Benutzeragenten zu identifizieren.

Via

Wird von Proxies hinzugefügt, sowohl von Forward- als auch von Reverse-Proxies, und kann in den Anfrage-Headern und in den Antwort-Headern vorhanden sein.

Warnung

Allgemeine Warnhinweise zu möglichen Problemen.

X-CSRF-Token

X-Requested-With

Nachrichtenkörper als JSON

Definieren Sie einen Schlüssel und einen Wert für jedes Schlüssel-Wert-Paar, das Sie im Nachrichtenkörper der Anfrage senden möchten. Um ein Datenelement manuell einzugeben, verwenden Sie die Datenelement-Tokenisierung für die Ereignisweiterleitung mit geschweiften Klammern. Um den Wert eines Datenelements mit dem Namen „appSection“ als Schlüssel oder Wert zu referenzieren, geben Sie {{appSection}} ein. Sie können auch das zuvor erstellte Datenelement wählen, indem Sie es im Dropdown-Menü auswählen.

Um weitere Schlüssel-Wert-Paare hinzuzufügen, wählen Sie Add Another aus.

Nachrichtenkörper als Rohtext

Erweitert

Aktionen innerhalb von Regeln in der Ereignisweiterleitung werden sequenziell ausgeführt. In bestimmten Szenarien möchten Sie aber womöglich Daten von einer externen Quelle abrufen, die nicht im vom Client eingehenden Ereignis vorhanden ist, um im Rahmen einer einzelnen Regel die in dieser Antwort enthaltenen Daten entweder umzuwandeln oder an ein in einer nachfolgenden Aktion enthaltenes endgültiges Ziel zu senden. Die Option „Speichern der Anfrageantwort“ im erweiterten Abschnitt aktiviert dies.

Um den von einem Endpunkt erhaltenen Antworttext zu speichern, aktivieren Sie das Kontrollkästchen Save the request response und legen Sie im Textfeld einen Antwortschlüssel fest.

Wenn Sie den Antwortschlüssel als productDetails festgelegt haben, verweisen Sie in einem Datenelement auf diese Daten sowie in einer nachfolgenden Aktion innerhalb derselben Regel auf dieses Datenelement. Um ein Datenelement zu erstellen, das auf productDetail verweist, erstellen Sie ein Datenelement vom Typ path und geben Sie den folgenden Pfad ein:

arc.ruleStash.[EXTENSION-NAME-HERE].responses.[RESPONSE-KEY-HERE]

arc.ruleStash.adobe-cloud-connector.reponses.productDetails

Fügen Sie Ihrer Ereignisweiterleitungsbibliothek eine Regel für die gegenseitige mTLS (Transport Layer Security) hinzu mtls-rules

Das mTLS-Zertifikat ist eine digitale Berechtigung, die die Identität eines Servers oder Clients in sicherer Kommunikation nachweist. Wenn Sie die mTLS Service-API verwenden, helfen Ihnen diese Zertifikate bei der Verifizierung und Verschlüsselung Ihrer Interaktionen mit der Adobe Experience Platform-Ereignisweiterleitung. Dieser Prozess schützt nicht nur Ihre Daten, sondern stellt auch sicher, dass jede Verbindung von einem vertrauenswürdigen Partner stammt.

Installieren der Adobe Cloud Connector-Erweiterung install

Um die Erweiterung zu installieren erstellen Sie eine Ereignisweiterleitungseigenschaft oder Sie stattdessen eine vorhandene Eigenschaft aus, die bearbeitet werden soll.

Wählen Sie Extensions im linken Bedienfeld aus. Klicken Sie auf der Registerkarte Catalog auf die Karte Adobe Cloud Connector und klicken Sie dann auf Install.

Der Erweiterungskatalog mit der Adobe Cloud Connector Erweiterungskarte, in der install hervorgehoben ist.

Konfigurieren einer Ereignisweiterleitungsregel rule

NOTE

Um eine Regel für die Verwendung von mTLS zu konfigurieren, muss Adobe Cloud Connector Version 1.2.4 oder höher installiert sein.

Nach der Installation der Erweiterung können Sie eine Ereignisweiterleitungsregel erstellen, die mTLS verwendet, und sie zu Ihrer Bibliothek hinzufügen.

Erstellen Sie eine neue (Regel in Ihrer Ereignisweiterleitungseigenschaft. Geben Sie einen Namen für Ihre Regel an und fügen Sie dann unter Actions eine neue Aktion hinzu und legen Sie die Erweiterung auf Adobe Cloud Connector fest. Wählen Sie als Nächstes Make Fetch Call für die Action Type aus.

Die Ansicht mit den Eigenschaftsregeln für die Ereignisweiterleitung mit den Feldern, die zum Hinzufügen einer Regelkonfiguration für die Ereignisweiterleitung erforderlich sind, ist hervorgehoben.

Nachdem Sie Ihre Auswahl getroffen haben, werden zusätzliche Steuerelemente angezeigt, um die Methode und das Ziel für die mTLS-Anfrage zu konfigurieren. Um die Verwendung aktiver Zertifikate in den Umgebungen zu aktivieren, klicken Sie auf Enable in mTLS und anschließend auf Keep Changes , um die Regel zu speichern.

Die Ansicht mit den Eigenschaftenregeln für die Ereignisweiterleitung mit den zusätzlichen Steuerelementfeldern und hervorgehobenen Änderungen.

Ihre neue Regel ist jetzt bereit. Wählen Sie Save to Library und dann Build aus, um sie bereitzustellen. Die mTLS Anfrage ist jetzt aktiv und in Ihrer Bibliothek verfügbar.

Die Ereignisweiterleitungsregel mit Hervorhebung von „In Bibliothek speichern“ und „Erstellen“.

Nächste Schritte

In diesem Handbuch wurde beschrieben, wie Sie MTLS-Regeln für die Ereignisweiterleitung einrichten. Weitere Informationen zum Einrichten von mTLS für eine Umgebung finden Sie im Handbuch zu Mutual Transport Layer Security (mTLS).

Weitere Informationen zu den Funktionen für die Ereignisweiterleitung in Experience Platform finden Sie unter Übersicht über die Ereignisweiterleitung.

recommendation-more-help

12b4e4a9-5028-4d88-8ce6-64a580811743