Présentation de l’extension Cloud Connector
L’extension de transfert d’événement Cloud Connector vous permet de créer des requêtes HTTP personnalisées pour envoyer des données à une destination ou récupérer des données d’une destination. L’extension Cloud Connector est semblable à Postman sur Adobe Experience Platform Edge Network et peut être utilisée pour envoyer des données à un point d’entrée qui n’a pas encore d’extension dédiée.
Utilisez cette référence pour obtenir des informations sur les options disponibles lors de l’utilisation de cette extension pour créer une règle.
Type d’action d’extension Cloud Connector
Cette section décrit le type d’action Envoyer les données disponible dans l’extension Adobe Experience Platform Cloud Connector.
Type de requête
Pour sélectionner le type de requête requis par le point d’entrée, sélectionnez le type approprié dans la liste déroulante Request Type.
URL du point d’entrée
Dans le champ de texte en regard du menu déroulant Type de requête, saisissez l’URL du point d’entrée auquel vous envoyez des données.
Paramètres de requête, en-têtes et configuration du corps
Utilisez chacun de ces onglets (Paramètres de requête, En-têtes et Éléments de données de contenu) pour contrôler les données envoyées à un point d’entrée donné.
Paramètres de requête
Définissez une clé et une valeur pour chaque paire clé-valeur à envoyer en tant que paramètre de chaîne de requête. Pour entrer manuellement un élément de données, utilisez la segmentation en unités lexicales de l’élément de données pour le transfert d'événement. Pour référencer la valeur d’un élément de données nommé « siteSection » en tant que clé ou valeur, saisissez {{siteSection}}. Vous pouvez également sélectionner l’élément de données créé précédemment en le sélectionnant dans le menu déroulant.
Pour ajouter d’autres paramètres de requête, sélectionnez Add Another.
En-têtes
Définissez une clé et une valeur pour chaque paire clé-valeur que vous voulez envoyer en tant qu’en-tête. Pour entrer manuellement un élément de données, utilisez la segmentation en unités lexicales de l’élément de données pour le transfert d'événement. Pour référencer la valeur d’un élément de données nommé « pageName » en tant que clé ou valeur, saisissez {{pageName}}. Vous pouvez également sélectionner l’élément de données créé précédemment en le sélectionnant dans le menu déroulant.
Pour ajouter d’autres en-têtes, sélectionnez Add Another.
Le tableau suivant répertorie les en-têtes prédéfinis. Vous n’êtes pas limité à ces en-têtes et vous pouvez ajouter vos propres en-têtes personnalisés si nécessaire, mais ils sont mis à votre disposition pour votre commodité.
Accept-Datetime est transmis dans une requête HTTP émise par rapport à un TimeGate pour une ressource d’origine, et sa valeur indique la date et l’heure (datetime) de l’état passé recherché de la ressource d’origine.Set-Cookie.Accept-Transfer-Encoding, ce qui serait plus intuitif).Upgrade est RFC 7230, section 6.7. Le standard établit des règles pour la mise à niveau ou la modification d’un protocole différent sur la connexion actuelle du client, du serveur, du protocole de transport. Par exemple, ce standard pour l’en-tête permet à un client de passer de HTTP 1.1 à HTTP 2.0, en supposant que le serveur décide de reconnaître et d’implémenter le champ d’en-tête Upgrade. Aucune des parties n’est tenue d’accepter les termes spécifiés dans le champ d’en-tête Upgrade. Ce champ peut être utilisé dans les en-têtes client et serveur. Si le champ d’en-tête Upgrade est spécifié, l’expéditeur DOIT également envoyer le champ d’en-tête Connection en spécifiant l’option upgrade.Corps en tant que JSON
Définissez une clé et une valeur pour chaque paire clé-valeur que vous voulez envoyer dans le corps de la requête. Pour entrer manuellement un élément de données, utilisez la segmentation en unités lexicales de l’élément de données pour le transfert d'événement. Pour référencer la valeur d’un élément de données nommé « appSection » en tant que clé ou valeur, saisissez {{appSection}}. Vous pouvez également sélectionner l’élément de données créé précédemment en le sélectionnant dans le menu déroulant.
Pour ajouter des paires clé-valeur supplémentaires, sélectionnez Add Another.
Corps comme brut
Définissez une clé et une valeur pour chaque paire clé-valeur que vous voulez envoyer dans le corps de la requête. Pour entrer manuellement un élément de données, utilisez la segmentation en unités lexicales de l’élément de données pour le transfert d'événement. Pour référencer la valeur d’un élément de données nommé « appSection » en tant que clé ou valeur, saisissez {{appSection}}. Vous pouvez également sélectionner l’élément de données créé précédemment en le sélectionnant dans le menu déroulant. Vous pouvez ajouter un ou plusieurs éléments de données.
Advanced
Les actions dans les règles du transfert d’événement s’exécutent de manière séquentielle. Dans certaines situations, vous pourriez souhaiter récupérer des données provenant d’une source externe non présente sur l’événement entrant du client, puis prendre cette réponse et transformer ou envoyer ces données vers une destination finale lors d’une action ultérieure au sein d’une seule règle. L’option « Enregistrer la réponse à la requête » de la section avancée l’active.
Pour enregistrer le corps de la réponse à partir d’un point d’entrée, cochez la case Save the request response et définissez une clé de réponse dans le champ de texte.
Si vous avez défini la clé de réponse comme productDetails, référencez ces données dans un élément de données, puis référencez cet élément de données dans une action ultérieure au sein de la même règle. Pour créer un élément de données qui référence productDetail, créez un élément de données de type path et saisissez le chemin suivant :
arc.ruleStash.[EXTENSION-NAME-HERE].responses.[RESPONSE-KEY-HERE]
arc.ruleStash.adobe-cloud-connector.reponses.productDetails
Ajoutez une règle Mutual Transport Layer Security (mTLS) à votre bibliothèque de transfert d’événement mtls-rules
Le certificat mTLS est une information d’identification numérique qui prouve l’identité d’un serveur ou d’un client dans des communications sécurisées. Lorsque vous utilisez l’API mTLS Service, ces certificats vous aident à vérifier et à chiffrer vos interactions avec le transfert d’événement Adobe Experience Platform. Ce processus protège non seulement vos données, mais garantit également que chaque connexion provient d’un partenaire de confiance.
Installation de l’extension Adobe Cloud Connector install
Pour installer l’extension, créez une propriété de transfert d’événement ou sélectionnez une propriété existante à modifier à la place.
Sélectionnez Extensions dans le panneau de gauche. Dans l’onglet Catalog , sélectionnez la vignette Adobe Cloud Connector , puis Install.
Configurer une règle de transfert d’événement rule
Après avoir installé l’extension, vous pouvez créer une règle de transfert d’événement qui utilise mTLS et l’ajouter à votre bibliothèque.
Créez une règle de transfert d’événement dans votre propriété de transfert d’événement. Attribuez un nom à votre règle, puis, sous Actions, ajoutez une nouvelle action et définissez l’extension sur Adobe Cloud Connector. Sélectionnez ensuite Make Fetch Call pour le Action Type.
Une fois votre sélection effectuée, des commandes supplémentaires s’affichent pour configurer la méthode et la destination de la requête mTLS. Pour activer l’utilisation de certificats actifs dans les environnements, sélectionnez Enable in mTLS, puis Keep Changes pour enregistrer la règle.
Votre nouvelle règle est maintenant prête. Sélectionnez Save to Library, puis Build pour le déployer. La requête mTLS est maintenant active et disponible dans votre bibliothèque.
Étapes suivantes
Ce guide explique comment configurer des règles mTLS dans le transfert d’événement. Pour plus d’informations sur la configuration de mTLS pour un environnement, reportez-vous au guide Mutual Transport Layer Security (mTLS).
Pour plus d’informations sur les fonctionnalités de transfert d’événement d’Experience Platform, consultez la présentation du transfert d’événement.