DocumentationCampaignNotes techniques de Campaign

Migration des opérateurs et opératrices techniques Campaign vers Adobe Developer Console migrate-tech-users-to-ims

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Administration

Dans le cadre des efforts visant à renforcer le processus de sécurité et d’authentification, à partir de Campaign v8.5, le processus d’authentification à Campaign v8 est en cours d’amélioration. Les opérateurs et opératrices techniques peuvent à présent utiliser Adobe Identity Management System (IMS) pour se connecter à Campaign. Pour en savoir plus sur le nouveau processus d’authentification serveur à serveur, consultez la documentation d’Adobe Developer Console.

Un opérateur ou une opératrice technique est un profil utilisateur de Campaign qui a été explicitement créé pour l’intégration de l’API. Cet article décrit les étapes à suivre pour migrer un opérateur ou une opératrice technique vers un compte technique par le biais de l’Adobe Developer Console.

Cela vous concerne-t-il ? ims-impacts

Si vous effectuez des appels API depuis un système externe à Campaign vers l’instance de marketing Campaign Marketing ou l’instance de Message Center en temps réel, vous devez migrer les opérateurs ou opératrices techniques vers les comptes techniques par le biais de l’Adobe Developer Console, comme décrit ci-dessous.

Cette modification s’applique à partir de Campaign v8.5 et sera obligatoire à partir de Campaign v8.6.

Processus de migration ims-migration-procedure

Suivez les étapes ci-dessous pour créer des comptes techniques dans l’Adobe Developer Console, puis utilisez ces comptes nouvellement créés pour pouvoir modifier les méthodes d’authentification de tous vos systèmes externes qui effectuent des appels API dans Adobe Campaign.

Voici une vue d’ensemble des étapes :

  • Création d’un projet dans l’Adobe Developer Console
  • Affectation des API appropriées au projet nouvellement créé
  • Octroi des profils de produit Campaign nécessaires au projet
  • Mise à jour de vos API pour utiliser les informations d’identification du compte technique nouvellement créé
  • Supprimer les opérateurs et opératrices techniques hérités de votre instance Campaign

Prérequis pour la migration ims-migration-prerequisites

Pour les appels d’API dans les instances Message Center, un profil de produit doit avoir été créé lors de la mise à niveau vers Campaign v8.5 ou de l’approvisionnement de l’instance. Ce profil de produit est nommé :

campaign - <your campaign instance> - messagecenter

Si vous avez déjà utilisé l’authentification IMS pour l’accès des utilisateurs et utilisatrices à Campaign, les profils de produit requis pour les appels API doivent donc déjà exister dans l’Admin Console. Si vous utilisez un groupe d’opérateurs et d’opératrices personnalisé dans Campaign pour les appels API vers l’instance Marketing, vous devez créer ce profil de produit dans l’Admin Console.

Dans d’autres cas, vous devez contacter la personne chargée de la gestion de votre transition Adobe afin que les équipes techniques d’Adobe puissent migrer vos groupes d’opérateurs et d’opératrices existants et vos droits nommés vers les profils de produit dans l’Admin Console.

Étape 1 : créer votre projet Campaign dans l’Adobe Developer Console ims-migration-step-1

Les intégrations sont créées dans le cadre d’un Projet dans Adobe Developer Console. En savoir plus sur les projets dans la documentation d’Adobe Developer Console.

Vous pouvez utiliser n’importe quel projet précédemment créé par vous ou créer un nouveau projet. Les étapes de création d’un projet sont détaillées dans la documentation d’Adobe Developer Console. Vous trouverez ci-dessous les étapes clés.

Pour créer un projet, cliquez sur Créer un projet dans l’écran principal de l’Adobe Developer Console.

Vous pouvez utiliser le bouton Modifier le projet pour renommer ce projet.

Étape 2 : ajouter des API à votre projet ims-migration-step-2

Dans l’écran du projet nouvellement créé, ajoutez les API nécessaires pour pouvoir utiliser ce projet comme compte technique pour vos appels API à Adobe Campaign.

Pour ajouter des API à votre projet, procédez comme suit :

  1. Cliquez sur Ajouter une API pour sélectionner les API à ajouter à votre projet.
  2. Sélectionnez l’API Adobe Campaign et ajoutez-la à votre projet en cochant la case située dans le coin supérieur droit de la carte Adobe Campaign qui s’affiche lorsque vous pointez sur la carte.
  3. Cliquez sur Suivant au bas de l’écran.

Étape 3 : sélectionner le type d’authentification ims-migration-step-3

Dans l’écran Configurer l’API, sélectionnez le type d’authentification nécessaire. L’authentification OAuth serveur à serveur est requise pour ce projet. Assurez-vous qu’elle est sélectionnée, puis cliquez sur Suivant au bas de l’écran.

Étape 4 : sélectionner les profils de produit ims-migration-step-4

Comme décrit dans la section des conditions préalables, vous devez attribuer les profils de produit appropriés à utiliser par le projet. Dans cette étape, vous devez sélectionner le ou les profils de produit à utiliser par le compte technique en cours de création.

Si ce compte technique est utilisé pour effectuer des appels API vers l’instance Message Center, veillez à sélectionner le profil de produit de création Adobe qui se termine par messagecenter.

Pour les appels d’API aux instances marketing, sélectionnez le profil de produit correspondant à l’instance et au groupe d’opérateurs et d’opératrices.

Une fois les profils de produit nécessaires sélectionnés, cliquez sur Enregistrer l’API configurée au bas de l’écran.

Étape 5 : ajouter l’API de gestion I/O à votre projet ims-migration-step-5

Dans l’écran du projet, cliquez sur le bouton + Ajouter au projet et choisissez API dans le coin supérieur gauche de l’écran pour pouvoir ajouter l’API de gestion I/O à ce projet.

Dans l’écran Ajouter une API, faites défiler l’écran vers le bas pour trouver la carte API de gestion I/O. Sélectionnez-la en cochant la case qui s’affiche lorsque vous pointez sur la carte. Cliquez ensuite sur Suivant au bas de l’écran.

Dans l’écran Configurer l’API, l’authentification OAuth serveur à serveur existe déjà. Cliquez sur Enregistrer l’API configurée au bas de l’écran.

Vous revenez alors à l’écran Projet dans l’API de gestion I/O du projet nouvellement créé. Cliquez sur le nom du projet dans les barres de navigation en haut de l’écran pour revenir à la page principale Détails du projet.

Étape 6 : vérifier la configuration du projet ims-migration-step-6

Vérifiez votre projet pour vous assurer qu’il ressemble à ce qui suit, avec l’API de gestion I/O et l’API Adobe Campaign visibles dans la section Produits et services et OAuth serveur à serveur dans la section Informations d’identification.

Étape 7 : valider votre configuration ims-migration-step-7

Pour tester la connexion, procédez comme décrit dans le guide des informations d’identification de l’Adobe Developer Console pour générer un jeton d’accès et copier la commande Sample cURL fournie. Vous pouvez créer un appel SOAP à l’aide de ces informations d’identification pour vérifier que vous pouvez vous authentifier et vous connecter correctement aux instances Adobe Campaign. Nous vous recommandons d’effectuer cette validation avant d’apporter toutes les modifications aux intégrations d’API tierces.

Étape 8 : mettre à jour les intégrations d’API tierces ims-migration-step-8

Vous devez maintenant mettre à jour les intégrations d’API qui effectuent des appels dans Adobe Campaign pour utiliser le compte technique nouvellement créé.

Pour plus d’informations sur les étapes d’intégration des API, y compris un exemple de code pour une intégration fluide, consultez la documentation sur l’authentification de l’Adobe Developer Console.

Vous trouverez ci-dessous des exemples d’appels SOAP indiquant les appels avant et après la migration pour les systèmes tiers.

Lors de l’utilisation de l’authentification Adobe Identity Management System (IMS), pour générer un fichier WSDL, vous devez ajouter Authorization: Bearer <IMS_Technical_Token_Token> dans l’appel postman :

curl --location --request POST 'https://<instance_url>/nl/jsp/schemawsdl.jsp?schema=nms:rtEvent' \--header 'Authorization: Bearer <Technical account access token>'

Une fois le processus de migration réalisé et validé, les appels Soap sont mis à jour comme indiqué ci-dessous :

  • Avant la migration : le jeton d’accès au compte technique n’est pas pris en charge.

    code language-sql 
    POST /nl/jsp/soaprouter.jsp HTTP/1.1
Host: localhost:8080
Content-Type: application/soap+xml;
SOAPAction: "nms:rtEvent#PushEvent"
charset=utf-8

<?xml version="1.0" encoding="utf-8"?>  <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:nms:rtEvent">
<soapenv:Header/>
<soapenv:Body>
    <urn:PushEvent>
        <urn:sessiontoken>SESSION_TOKEN</urn:sessiontoken>
        <urn:domEvent>
            <!--You may enter ANY elements at this point-->
            <rtEvent type="type" email="name@domain.com"/>
        </urn:domEvent>
    </urn:PushEvent>
</soapenv:Body>
</soapenv:Envelope>

  • Après la migration : le jeton d’accès au compte technique est pris en charge. Le jeton d’accès doit être fourni dans l’en-tête Authorization comme jeton du porteur. L’utilisation du jeton de session doit être ignorée ici, comme illustré dans l’exemple d’appel SOAP ci-dessous.

    code language-sql 
    POST /nl/jsp/soaprouter.jsp HTTP/1.1
Host: localhost:8080
Content-Type: application/soap+xml;
SOAPAction: "nms:rtEvent#PushEvent"
charset=utf-8
Authorization: Bearer <IMS_Technical_Token_Token>

<?xml version="1.0" encoding="utf-8"?>  <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:nms:rtEvent">
<soapenv:Header/>
<soapenv:Body>
    <urn:PushEvent>
        <urn:sessiontoken></urn:sessiontoken>
        <urn:domEvent>
            <!--You may enter ANY elements at this point-->
            <rtEvent type="type" email="name@domain.com"/>
        </urn:domEvent>
    </urn:PushEvent>
</soapenv:Body>
</soapenv:Envelope>

Étape 9 : (facultatif) mettre à jour l’opérateur ou opératrice du compte technique dans la console cliente Campaign ims-migration-step-9

Cette étape est facultative et disponible uniquement dans la ou les instances marketing, et non dans une instance Message Center, et si des autorisations de dossiers spécifiques ou des droits nommés ont été définis pour l’opérateur ou l’opératrice technique, et non par le ou les groupes d’opérateurs et d’opératrices attribués. Vous devez maintenant mettre à jour l’utilisateur ou utilisatrice du compte technique nouvellement créé dans l’Admin Console pour accorder les autorisations de dossier ou les droits nommés requis.

Notez que l’utilisateur ou l’utilisatrice du compte technique n’existera PAS dans Adobe Campaign tant qu’au moins un appel API n’aura pas été effectué vers l’instance Campaign. À ce moment-là, IMS créera l’utilisateur ou l’utilisatrice dans Campaign. Si vous ne parvenez pas à localiser les utilisateurs et utilisatrices techniques dans Campaign, vérifiez que vous avez bien réussi à envoyer un appel API comme indiqué à l’étape 7.

  1. Pour appliquer les modifications nécessaires au nouvel utilisateur ou à la nouvelle utilisatrice du compte technique, procédez à sa localisation dans la console cliente Campaign avec son adresse e-mail. Cette adresse e-mail a été créée lors des étapes de création et d’authentification du projet ci-dessus.

    Vous pouvez localiser cette adresse e-mail en cliquant sur le titre OAuth serveur à serveur dans la section Informations d’identification du projet.

    Dans l’écran Informations d’identification, faites défiler l’écran vers le bas pour localiser l’adresse e-mail du compte technique, puis cliquez sur le bouton Copier.

  2. Vous devez maintenant mettre à jour l’opérateur technique nouvellement créé ou l’opératrice technique nouvellement créée dans la console cliente Adobe Campaign. Vous devez appliquer les autorisations de dossier des opérateurs et opératrices techniques existants au nouvel opérateur ou à la nouvelle opératrice technique.

    Pour mettre à jour cet opérateur ou cette opératrice, procédez comme suit :

    1. Dans l’explorateur de la console cliente Campaign, accédez à Administration > Gestion des accès > Opérateurs et opératrices.
    2. Accédez à l’opérateur ou opératrice technique existant(e) utilisé(e) pour les API.
    3. Accédez aux autorisations de dossier et vérifiez les droits.
    4. Appliquez les mêmes autorisations à l’opérateur ou opératrice technique nouvellement créé(e). L’adresse e-mail de cet opérateur ou de cette opératrice est la valeur de l’e-mail du compte technique copiée précédemment.
    5. Enregistrez vos modifications.
CAUTION
Le nouvel opérateur ou la nouvelle opératrice technique doit avoir effectué au moins un appel API à ajouter à la console cliente Campaign.

Étape 10 : supprimer l’ancien opérateur ou l’ancienne opératrice technique d’Adobe Campaign ims-migration-step-10

Une fois que vous avez migré tous les systèmes tiers pour utiliser le nouveau compte technique avec l’authentification IMS, vous pouvez supprimer l’ancien opérateur ou l’ancienne opératrice technique de la console cliente Campaign.

Pour ce faire, connectez-vous à la console cliente Campaign, accédez à Administration > Gestion des accès > Opérateurs et opératrices, recherchez les anciens utilisateurs et utilisatrices techniques et supprimez-les.

recommendation-more-help
c14bd44c-7b5f-474a-888d-1c2baee5a247