Configuration d’Adobe I/O pour les Triggers Adobe Experience Cloud

ATTENTION

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.

Le mode d’authentification OAuth hérité avec Campaign a été retiré le septembre 2021. Les environnements hébergés bénéficient d’une extension jusqu’au 23 février 2022. En tant que client on-premise ou hybride, contactez l’assistance clientèle d’Adobe pour étendre l’assistance jusqu’en février 2022. Vous devez fournir l’AppID de l’application OAuth à Adobe.

Conditions préalables requises

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

Avant de commencer cette mise en œuvre, vérifiez que vous disposez des éléments suivants :

  • Un identifiant d'organisation valide : l'identifiant de l'organisation Identity Management System (IMS) est l’identifiant unique dans Adobe Experience Cloud, utilisé par exemple pour le service VisitorID et l’authentification unique (SSO) IMS. En savoir plus
  • Un accès développeur à votre organisation. L'administrateur système de l'organisation IMS 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 Analytics - {tenantID}profil du produit Adobe Analytics associé aux Triggers.

Étape 1 : créer/mettre à jour un projet Adobe I/O

  1. Accédez à Adobe I/O et connectez-vous avec l'accès développeur de l'organisation IMS.

    REMARQUE

    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é.

    REMARQUE

    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.

    ATTENTION

    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

ATTENTION

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

REMARQUE

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.

    REMARQUE

    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.

    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

REMARQUE

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.

Sur cette page