Configuration de secrets dans le transfert d’événements
Dans le transfert dʼévénement, un secret est une ressource qui représente des informations dʼidentification pour sʼauthentifier auprès dʼun autre système, ce qui permet lʼéchange sécurisé de données. Les secrets ne peuvent être créés que dans les propriétés de transfert dʼévénement.
Les types de secrets suivants sont actuellement pris en charge :
Ce guide fournit un aperçu général de la configuration des secrets d’une propriété de transfert d’événement (Edge) dans l’interface utilisateur d’Experience Platform ou l’interface utilisateur de la collecte de données.
Conditions préalables
Avant dʼutiliser ce guide, assurez-vous au préalable de savoir comment gérer les ressources pour les balises et le transfert dʼévénement dans lʼinterface utilisateur, y compris comment créer un élément de données et une règle de transfert dʼévénement. Si vous avez besoin dʼune présentation, consultez le guide sur la gestion des ressources.
Vous devez également posséder une compréhension pratique du flux de publication pour les balises et le transfert dʼévénement, y compris la manière dʼajouter des ressources à une bibliothèque et dʼinstaller une version de celle-ci sur votre site web à des fins de test. Pour plus dʼinformations, voir présentation de la publication.
Créer un secret create
Pour créer un secret, sélectionnez Event Forwarding dans le volet de navigation de gauche, puis ouvrez la propriété de transfert d’événement sous laquelle vous souhaitez ajouter le secret. Sélectionnez ensuite Secrets dans le volet de navigation de gauche, puis Create New Secret.
Lʼécran suivant vous permet de configurer les détails du secret. Pour être utilisé par le transfert dʼévénement, un secret doit dʼabord être affecté à un environnement existant. Si aucun environnement nʼest créé pour votre propriété de transfert dʼévénement, consultez le guide sur les environnements pour obtenir des conseils sur la façon de les configurer avant de poursuivre.
Sous Target Environment, utilisez le menu déroulant pour sélectionner l’environnement auquel vous souhaitez attribuer le secret. Sous Secret Name, attribuez un nom au secret dans le contexte de l’environnement. Chaque secret au sein de la propriété de transfert dʼévénement doit posséder un nom unique.
Un secret ne peut être attribué quʼà un environnement à la fois, mais vous pouvez attribuer les mêmes informations dʼidentification à plusieurs secrets au sein de différents environnements si vous le souhaitez. Sélectionnez Add Environment pour ajouter une autre ligne à la liste.
Pour chaque environnement ajouté, vous devez attribuer un nouveau nom unique pour le secret associé. Si vous avez épuisé tous les environnements disponibles, le bouton Add Environment n’est pas disponible.
À partir de là, les étapes de création du secret varient en fonction du type de secret que vous souhaitez créer. Consultez les sous-sections ci-dessous pour plus de détails :
Token token
Pour créer un secret de jeton, sélectionnez Token dans la liste déroulante Type . Dans le champ Token qui s’affiche, indiquez la chaîne d’identification reconnue par le système auquel vous vous authentifiez. Sélectionnez Create Secret pour enregistrer le secret.
HTTP http
Pour créer un secret HTTP, sélectionnez Simple HTTP dans la liste déroulante Type . Dans les champs qui s’affichent ci-dessous, indiquez un nom d’utilisateur et un mot de passe pour les informations d’identification avant de sélectionner Create Secret pour enregistrer le secret.
OAuth 2 oauth2
Pour créer un secret OAuth 2, sélectionnez OAuth 2 dans la liste déroulante Type . Dans les champs qui s’affichent ci-dessous, fournissez vos Client ID et Client Secret, ainsi que votre Token URL pour votre intégration OAuth. Le champ Token URL de l’interface utilisateur est une concaténation entre l’hôte du serveur d’autorisation et le chemin d’accès au jeton.
Sous Credential Options, vous pouvez fournir d’autres options d’identification telles que scope et audience sous la forme de paires clé-valeur. Pour ajouter d’autres paires clé-valeur, sélectionnez Add another.
Enfin, vous pouvez configurer la valeur Refresh Offset pour le secret. Cette valeur représente le nombre de secondes avant l’expiration du jeton pendant lesquelles le système effectue une actualisation automatique. L’équivalent en heures et minutes s’affiche à droite du champ et se met automatiquement à jour au fur et à mesure que vous tapez.
Par exemple, si le décalage d’actualisation est défini sur la valeur par défaut de 14400 (quatre heures) et le jeton d’accès comporte une valeur expires_in de 86400 (24 heures), le système actualisera automatiquement le secret dans 20 heures.
28800 (huit heures) et le jeton d’accès comporte un expires_in de 36000 (dix heures), l’échange échouerait, car la différence en résultant serait inférieure à quatre heures.Lorsque vous avez terminé, sélectionnez Create Secret pour enregistrer le secret.
OAuth 2 JWT oauth2jwt
Pour créer un secret JWT OAuth 2, sélectionnez OAuth 2 JWT dans la liste déroulante Type .
Dans les champs qui s’affichent ci-dessous, fournissez vos Issuer, Subject, Audience, Custom Claims et TTL, puis sélectionnez le Algorithm dans la liste déroulante. Saisissez ensuite le Private Key Id, ainsi que votre Token URL pour votre intégration OAuth. Le champ Token URL n’est pas obligatoire. Si une valeur est fournie, le jeton JWT est échangé avec un jeton d’accès. Le secret sera actualisé en fonction de l’attribut expires_in de la réponse et de la valeur Refresh Offset. Si aucune valeur n’est fournie, le secret transmis à Edge est le JWT. Le jeton JWT sera actualisé en fonction des valeurs TTL et Refresh Offset.
Sous Credential Options, vous pouvez fournir d’autres options d’identification telles que jwt_param sous la forme de paires clé-valeur. Pour ajouter d’autres paires clé-valeur, sélectionnez Add another.
Enfin, vous pouvez configurer la valeur Refresh Offset pour le secret. Cette valeur représente le nombre de secondes avant l’expiration du jeton pendant lesquelles le système effectue une actualisation automatique. L’équivalent en heures et minutes s’affiche à droite du champ et se met automatiquement à jour au fur et à mesure que vous tapez.
Par exemple, si le décalage d’actualisation est défini sur la valeur par défaut de 1800 (30 minutes) et que le jeton d’accès a une valeur expires_in de 3600 (une heure), le système actualisera automatiquement le secret dans une heure.
1800 (30 minutes) et que le jeton d’accès a une expires_in de 2700 (45 minutes), l’échange échouerait, car la différence en résultant serait inférieure à 30 minutes.Lorsque vous avez terminé, sélectionnez Create Secret pour enregistrer le secret.
Google OAuth 2 google-oauth2
Pour créer un secret OAuth 2 Google, sélectionnez Google OAuth 2 dans la liste déroulante Type . Sous Scopes, sélectionnez les API Google auxquelles vous souhaitez accorder l’accès à l’aide de ce secret. Les produits suivants sont actuellement pris en charge :
Lorsque vous avez terminé, sélectionnez Create Secret.
Une fenêtre contextuelle s’affiche pour vous informer que le secret doit être autorisé manuellement via Google. Sélectionnez Create & Authorize pour continuer.
Une boîte de dialogue s’affiche et vous permet de saisir les informations d’identification de votre compte Google. Suivez les invites pour accorder l’accès au transfert d’événement à vos données sous la portée sélectionnée. Une fois le processus d’autorisation terminé, le secret est créé.
LinkedIn OAuth 2 linkedin-oauth2
Pour créer un secret OAuth 2 LinkedIn, sélectionnez LinkedIn OAuth 2 dans la liste déroulante Type . Ensuite, sélectionnez Create Secret.
Une fenêtre contextuelle s’affiche pour vous informer que le secret doit être autorisé manuellement via LinkedIn. Sélectionnez Create & Authorize secret with LinkedIn pour continuer.
Une boîte de dialogue s’affiche vous invitant à saisir vos informations d’identification LinkedIn. Suivez les invites pour accorder l’accès au transfert d’événement à vos données.
Une fois le processus d’autorisation terminé, vous revenez à l’onglet Secrets , où vous pouvez voir votre secret nouvellement créé. Vous pouvez voir ici le statut du secret et la date d’expiration.
Réautoriser un secret LinkedIn OAuth 2
IMPORTANT
Vous devez réautoriser l’utilisation de vos informations d’identification LinkedIn tous les 365 jours. Si vous n’autorisez pas la réautorisation en temps voulu, votre secret n’est pas actualisé et les demandes de conversion LinkedIn échouent.
Trois mois avant le secret qui nécessite une réautorisation, une fenêtre contextuelle commence à s’afficher lorsque vous parcourez une page de la propriété. Sélectionnez Click here to go to your secrets.
Vous êtes redirigé vers l’onglet Secrets . Les secrets répertoriés sur cette page sont filtrés afin d’afficher uniquement les secrets qui doivent être réautorisés. Sélectionnez Auth Needed pour le secret que vous devez réautoriser.
Une boîte de dialogue s’affiche et vous invite à saisir vos informations d’identification LinkedIn. Suivez les invites pour réautoriser votre secret.
Amazon OAuth 2 amazon-oauth2
Pour créer un secret OAuth 2 Amazon, sélectionnez Amazon OAuth 2 dans la liste déroulante Type . Ensuite, sélectionnez Create Secret.
Une fenêtre contextuelle s’affiche pour vous informer que le secret doit être autorisé manuellement via Amazon. Sélectionnez Create & Authorize secret with Amazon pour continuer.
Fenêtre contextuelle d’autorisation
Une boîte de dialogue s’affiche vous invitant à saisir vos informations d’identification Amazon. Suivez les invites pour accorder l’accès au transfert d’événement à vos données.
Une fois le processus d’autorisation terminé, vous revenez à l’onglet Secrets , où vous pouvez voir votre secret nouvellement créé. Vous pouvez voir ici le statut du secret et la date d’expiration.
Modifier un secret
Une fois que vous avez créé des secrets pour une propriété, vous pouvez les trouver dans l’espace de travail Secrets. Pour modifier les détails d’un secret existant, sélectionnez son nom dans la liste.
L’écran suivant vous permet de modifier le nom et les informations d’identification du secret.
Réessayer un échange secret
Vous pouvez réessayer ou actualiser un échange secret depuis l’écran d’édition. Ce processus varie en fonction du type de secret en cours de modification :
Supprimer un secret
Pour supprimer un secret existant dans l’espace de travail Secrets, cochez la case en regard de son nom avant de sélectionner Delete.
Utilisation de secrets dans le transfert d’événements
Pour utiliser un secret dans le transfert d’événements, vous devez d’abord créer un élément de données qui fait référence au secret lui-même. Après avoir enregistré l’élément de données, vous pouvez l’inclure dans les règles du transfert d’événements et ajouter ces règles à une bibliothèque, qui peut à son tour être déployée sur les serveurs d’Adobe en tant que version.
Lors de la création de l’élément de données, sélectionnez l’extension de Core, puis sélectionnez Secret pour le type d’élément de données. Le panneau de droite met à jour et fournit des commandes déroulantes pour attribuer jusqu’à trois secrets à l’élément de données : un pour Development, Staging et Production, respectivement.
En attribuant plusieurs secrets à un élément de données unique et en l’incluant dans une règle, vous pouvez faire changer la valeur de l’élément de données en fonction de l’emplacement de la bibliothèque conteneur dans le flux de publication.
Étapes suivantes
Ce guide explique comment gérer les secrets dans l’interface utilisateur. Pour plus d’informations sur l’interaction avec les secrets à l’aide de l’API Reactor, voir le guide de points d’entrée des secrets.