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 secret suivants sont actuellement pris en charge :
Ce guide fournit une présentation générale de la configuration des secrets pour 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 Transfert d’événement dans la navigation de gauche, puis ouvrez la propriété de transfert d’événement sous laquelle vous souhaitez ajouter le secret. Ensuite, sélectionnez Secrets dans le volet de navigation de gauche, puis Créer un 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 Environnement cible, sélectionnez dans le menu déroulant lʼenvironnement auquel vous souhaitez affecter le secret. Sous Nom du secret, 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 Ajouter un environnement pour ajouter une autre ligne à la liste.
Pour chaque environnement ajouté, vous devez attribuer un nouveau nom unique pour le secret associé. Lorsque tous les environnements disponibles ont été sélectionnés, le bouton Ajouter un environnement devient indisponible.
À 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 :
Jeton token
Pour créer un secret de jeton, sélectionnez Jeton dans la liste déroulante Type. Dans le champ Jeton qui s’affiche, indiquez la chaîne d’identification reconnue par le système auquel vous vous authentifiez. Sélectionnez Créer un secret pour enregistrer le secret.
HTTP http
Pour créer un secret HTTP, sélectionnez HTTP simple 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 Créer un 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 en-dessous, fournissez votre Identifiant client et votre Secret client, ainsi que votre URL du jeton pour votre intégration OAuth. Le champ URL du jeton dans l’interface utilisateur est une concaténation entre l’hôte du serveur d’autorisation et le chemin du jeton.
Sous Options d’identification, vous pouvez fournir d’autres options d’identification telles que scope et audience sous la forme de paires clé-valeur. Pour ajouter des paires clé-valeur supplémentaires, sélectionnez Ajouter une autre.
Enfin, vous pouvez configurer la valeur Actualiser le décalage 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 Créer un 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 Emetteur, Objet, Audience, Demandes personnalisées, TTL, puis sélectionnez l’ algorithme dans la liste déroulante. Ensuite, saisissez l’ ID de clé privée , ainsi que votre URL de jeton pour votre intégration OAuth. Le champ URL du jeton 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 Actualiser le décalage. Si aucune valeur n’est fournie, le secret envoyé au bord est le JWT. Le JWT sera actualisé conformément aux valeurs TTL et Actualiser le décalage .
Sous Credential Options, vous pouvez fournir d’autres options d’identification telles que jwt_param sous la forme de paires clé-valeur. Pour ajouter des paires clé-valeur supplémentaires, sélectionnez Ajouter une autre.
Enfin, vous pouvez configurer la valeur Actualiser le décalage 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 1800 (30 minutes) et que le jeton d’accès a une valeur expires_in de 3600 (une heure), le système actualise automatiquement le secret dans une heure.
1800 (30 minutes) et que le jeton d’accès a un expires_in de 2700 (45 minutes), l’exchange échoue en raison de la différence qui en résulte : moins de 30 minutes.Lorsque vous avez terminé, sélectionnez Créer un secret pour enregistrer le secret.
Google OAuth 2 google-oauth2
Pour créer un secret Google OAuth 2, sélectionnez Google OAuth 2 dans la liste déroulante Type. Sous Portées, 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 Créer un secret.
Une fenêtre contextuelle s’affiche pour vous informer que le secret doit être autorisé manuellement via Google. Sélectionnez Créer et autoriser 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 LinkedIn OAuth 2, sélectionnez LinkedInOAuth 2 dans la liste déroulante Type. Sélectionnez ensuite Créer un secret.
Une fenêtre contextuelle s’affiche pour vous informer que le secret doit être autorisé manuellement via LinkedIn. Sélectionnez Créer et autoriser le secret avecLinkedIn 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 le secret que vous venez de créer. Vous pouvez y voir 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 ne réautorisez pas votre secret dans les délais impartis, il ne sera pas actualisé et les demandes de conversion LinkedIn échoueront.
Trois mois avant la réautorisation du secret, une fenêtre contextuelle s’affiche lorsque vous naviguez sur une page de la propriété. Sélectionnez Cliquez ici pour accéder à vos secrets.
Vous êtes redirigé vers l’onglet Secrets . Les secrets répertoriés sur cette page sont filtrés pour n’afficher que 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, vous invitant à saisir vos informations d’identification LinkedIn. Suivez les invites pour réautoriser votre secret.
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 Supprimer.
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 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 Développement, Évaluation 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.