Configuration d’Adobe I/O pour les Triggers Adobe Experience Cloud configuring-adobe-io

CAUTION
Si vous utilisez une ancienne version de l’intégration Triggers par le biais de l’authentification OAuth, vous devez migrer vers Adobe I/O comme décrit ci-dessous.
Notez que lors de ce déplacement vers Adobe I/O, certains triggers entrants peuvent être perdus.
L’ancien mode d’authentification OAuth avec Campaign a été abandonné le 20 octobre 2021. Les environnements hébergés bénéficient dʼune extension jusquʼau 25 mai 2022. En tant que client on-premise ou hybride, contactez lʼassistance clientèle dʼAdobe pour étendre lʼassistance jusquʼen mai 2022. Vous devez fournir l’AppID de l’application OAuth à Adobe.

Conditions préalables adobe-io-prerequisites

Cette intégration ne s’applique qu’à partir des versions Campaign Classic 20.2.4 et ultérieures, 19.1.8 et Gold Standard 11.

Avant de commencer cette implémentation, vérifiez que vous disposez des éléments suivants :

  • un identifiant d’organisation valide : l’identifiant de l’organisation est l’identifiant unique dans Adobe Experience Cloud. Il est utilisé, entre autres, pour le service VisitorID et l’authentification unique (SSO) de l’IMS. En savoir plus
  • Un accès développeur à votre organisation. L’administrateur système de l’organisation doit suivre la procédure Ajouter des développeurs à un profil de produit unique présentée dans cette page pour fournir aux développeurs l’accès au profil du produit Analytics - {tenantID} Adobe Analytics associé aux Triggers.

Étape 1 : créer/mettre à jour un projet Adobe I/O creating-adobe-io-project

AVAILABILITY
Les informations d’identification de compte de service (JWT) étant abandonnées par Adobe, les intégrations de Campaign aux solutions et aux applications Adobe doivent désormais utiliser des informations d’identification OAuth serveur à serveur.
  • Si vous avez implémenté des intégrations entrantes pour Campaign, vous devez migrer votre compte technique comme décrit dans cette documentation. Les informations d’identification de compte de service (JWT) existantes continueront de fonctionner jusqu’au 27 janvier 2025. De plus, la création d’informations d’identification de compte de service (JWT) dans Developer Console n’est plus possible à compter du 3 juin 2024. Il n’est plus possible de créer ou d’ajouter à un projet de nouvelles informations d’identification de compte de service (JWT) après cette date.

  • Si vous avez implémenté des intégrations sortantes, telles qu’une intégration Campaign-Analytics ou une intégration Experience Cloud Triggers, celles-ci continueront de fonctionner jusqu’au 27 janvier 2025. Toutefois, avant cette date, vous devez mettre à niveau votre environnement Campaign vers la version 7.4.1 et migrer votre compte technique vers oAuth. Étant donné que la création d’informations d’identification de compte de service (JWT) dans Developer Console n’est plus possible à compter du 3 juin 2024, vous ne pourrez pas créer une nouvelle intégration sortante utilisant JWT après cette date.

  1. Accédez à Adobe I/O et connectez-vous avec l’accès de développement de votre organisation. Assurez-vous d’être connecté au portail d’organisation approprié.

  2. Extrayez l'identifiant client d'intégration existant du fichier de configuration de l'instance ims/authIMSTAClientId. Un attribut non existant ou vide indique que l'identifiant du client n'est pas configuré.

    note note
    NOTE
    Si l’identifiant du client est vide, vous pouvez directement créer un nouveau projet dans Adobe I/O.
  3. Identifiez le projet existant à l’aide de l’identifiant du client extrait. Recherchez des projets existants avec le même identifiant du client que celui extrait à l'étape précédente.

  4. Sélectionnez + Ajouter au projet et choisissez API.

  5. Dans la fenêtre Ajouter une API, sélectionnez Adobe Analytics.

  6. Sélectionnez Compte de service (JWT) comme type d’authentification.

  7. Si l’identifiant du client était vide, sélectionnez Générer une paire de clés pour créer une paire de clés publique et privée.

    Les clés seront alors automatiquement téléchargées avec une date d’expiration par défaut de 365 jours. Une fois la date d’expiration atteinte, vous devez générer une nouvelle paire de clés et mettre à jour l’intégration dans le fichier de configuration. L’option 2 vous permet de créer et de télécharger manuellement votre clé publique avec une date d’expiration plus longue.

    Pour un guide détaillé sur le remplacement des paires de clé de certificat arrivant à expiration, consultez cette page.

    note caution
    CAUTION
    Vous devez enregistrer le fichier config.zip lorsque l'invite de téléchargement s'affiche, car vous ne pourrez plus le télécharger.

  8. Cliquez sur Suivant.

  9. Sélectionnez un profil de produit existant ou créez-en un si nécessaire. Aucune autorisation n’est requise pour ce profil de produit. Pour plus d’informations sur les profils de produit Analytics, consultez la documentation Adobe Analytics.

    Cliquez ensuite sur Enregistrer l’API configurée.

  10. Dans votre projet, sélectionnez Adobe Analytics et copiez les informations suivantes sous Compte Service (JWT)  :

    • Identifiant du client
    • Secret du client
    • Identifiant du du compte technique
    • Identifiant de l'organisation

CAUTION
Le certificat Adobe I/O expire après 12 mois. Vous devez générer une nouvelle paire de clés chaque année.

Étape 2 : ajouter les informations d'identification du projet dans Adobe Campaign add-credentials-campaign

NOTE
Cette étape n'est pas requise si l'identifiant du client n'était pas vide à l'étape 1 : créer/mettre à jour un projet Adobe I/O.

La clé privée doit être encodée au format UTF-8 base64. Pour ce faire :

  1. Utilisez la clé privée générée dans la section Étape 1 : créer/mettre à jour un projet Adobe I/O. La clé privée doit être la même que celle utilisée pour créer l'intégration.

  2. Encodez la clé privée à l’aide de la commande suivante : base64 ./private.key > private.key.base64. Le contenu base64 sera ainsi enregistré dans un nouveau fichier private.key.base64.

    note note
    NOTE
    Des lignes supplémentaires peuvent parfois être automatiquement ajoutées lors du copier/coller de la clé privée. Pensez à les supprimer avant d’encoder votre clé privée.
  3. Copiez le contenu du fichier private.key.base64.

  4. Connectez-vous via SSH à chaque conteneur où l'instance Adobe Campaign est installée et ajoutez les informations d'identification du projet dans Adobe Campaign en exécutant la commande suivante en tant qu'utilisateur neolane. Les informations d'identification du compte technique seront alors insérées dans le fichier de configuration de l'instance.

    code language-none
    nlserver config -instance:<instance name> -setimsjwtauth:Organization_Id/Client_Id/Technical_Account_ID/<Client_Secret>/<Base64_encoded_Private_Key>
    

Étape 3 : mettre à jour la balise en pipeline update-pipelined-tag

NOTE
Cette étape n'est pas requise si l'identifiant du client n'était pas vide à l'étape 1 : Créer/mettre à jour un projet Adobe I/O.

Pour mettre à jour la balise pipelined, vous devez mettre à jour le type d’authentification du projet Adobe I/O dans le fichier de configuration config-< nom-instance >.xml comme suit :

<pipelined ... authType="imsJwtToken"  ... />

Ensuite, exécutez config -reload et redémarrez pipelined pour que les modifications soient prises en compte.

recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1