Configuration du balisage des ressources à l’aide du service de contenu dynamique

Vous pouvez intégrer Adobe Experience Manager au service de contenu dynamique à l’aide de Adobe Developer Console. Utilisez cette configuration pour accéder au service de contenu dynamique à partir de Experience Manager.

L’article détaille les tâches essentielles suivantes qui sont requises pour configurer le service de contenu dynamique. En arrière-plan, le serveur Experience Manager authentifie vos informations d’identification du service auprès de la passerelle Adobe Developer Console avant de transférer votre demande au service de contenu dynamique.

  1. Création d’une configuration de service de contenu dynamique dans pour générer une clé publique. Experience Manager Obtenez un certificat public pour l’intégration d’OAuth.

  2. Créez une intégration dans Adobe Developer Console et chargez la clé publique générée.

  3. Configurez votre déploiement à l’aide de la clé API et d’autres informations d’identification de Adobe Developer Console.

  4. Testez la configuration.

  5. Si vous le souhaitez, activez le balisage automatique lors du chargement de la ressource.

Prérequis

Avant d’utiliser le service de contenu dynamique, assurez-vous des points suivants pour créer une intégration sur Adobe Developer Console :

  • L’organisation doit disposer d’un compte Adobe ID pourvu de droits d’administrateur.

  • Le de contenu dynamique est activé pour votre organisation.

Pour activer les balises intelligentes améliorées, en plus de ce qui précède, installez également le dernier Service Pack Experience Manager.

Création d’une configuration de service de contenu dynamique pour obtenir un certificat public

Un certificat public permet d’authentifier votre profil sur Adobe Developer Console.

  1. Dans l’interface utilisateur Experience Manager, accédez à Outils > Cloud Services > Cloud Services hérités.

  2. Dans la page Cloud Services, cliquez sur Configurer maintenant sous Ressources - Balises intelligentes.

  3. Dans la boîte de dialogue Créer une configuration, spécifiez un titre et un nom pour la configuration de balises intelligentes. Cliquez sur Créer.

  4. Dans la boîte de dialogue Service de contenu dynamique AEM, utilisez les valeurs suivantes :

    URL du service: https://mc.adobe.io/marketingcloud/smartcontent

    Serveur d’autorisation: https://ims-na1.adobelogin.com

    Laissez les autres champs vides pour l’instant (pour les remplir ultérieurement). Cliquez sur OK.

    Boîte de dialogue Service de contenu dynamique de Experience Manager pour fournir l’URL du service de contenu

    Figure : Boîte de dialogue Smart Content Service pour fournir l’URL du service de contenu

    REMARQUE

    L’URL fournie comme URL du service n’est pas accessible par navigateur et génère une erreur 404. La configuration fonctionne sur OK avec la même valeur que le paramètre URL du service . Pour connaître l’état global du service et le planning de maintenance, voir https://status.adobe.com.

  5. Cliquez sur Télécharger le certificat public pour l’intégration OAuth, puis téléchargez le fichier de certificat public AEM-SmartTags.crt.

    Représentation des paramètres créés pour le service de balisage intelligent

    Figure : Paramètres du service de balisage intelligent

Reconfiguration à l’expiration d’un certificat

Une fois qu’un certificat a expiré, il n’est plus approuvé. Vous ne pouvez pas renouveler un certificat ayant expiré. Pour ajouter un nouveau certificat, procédez comme suit.

  1. Connectez-vous en tant qu’administrateur à votre déploiement Experience Manager. Cliquez sur Outils > Sécurité > Utilisateurs.

  2. Recherchez et cliquez sur l’utilisateur dam-update-service. Cliquez sur l’onglet KeyStore.

  3. Supprimez le fichier de stockage de clés similaritysearch existant avec le certificat arrivé à expiration. Cliquez sur Enregistrer et fermer.

    Supprimez l’entrée similaritysearch existante dans Keystore pour ajouter un nouveau certificat de sécurité.

    Figure : Suppression d’une entrée existantesimilaritysearch dans le Keystore pour ajouter un nouveau certificat de sécurité.

  4. Accédez à Outils > Cloud Services > Ancienne version de Cloud Services. Cliquez sur Balises dynamiques de ressources > Afficher la configuration > Configurations disponibles. Cliquez sur la configuration requise.

  5. Pour télécharger un certificat public, cliquez sur Télécharger le certificat public pour l’intégration Oauth.

  6. Accédez à https://console.adobe.io et accédez aux services de contenu intelligent existants sur la page Intégrations. Téléchargez le nouveau certificat. Pour plus d’informations, voir les instructions de la section Création de l’intégration d’Adobe Developer Console.

Création de l’intégration Adobe Developer Console

Pour utiliser les API de service de contenu dynamique, créez une intégration dans Adobe Developer Console afin d’obtenir la clé API (générée dans le champ ID CLIENT de l’intégration d’Adobe Developer Console), ID DE COMPTE TECHNIQUE, ID ORGANIZATION et SECRET CLIENT pour Paramètres du service de balisage intelligent des ressources de la configuration cloud dans Experience Manager.

  1. Accédez à l’URL https://console.adobe.io dans un navigateur. Sélectionnez le compte approprié et vérifiez que le rôle d’organisation associé est administrateur système.

  2. Créez un projet portant le nom de votre choix. Cliquez sur Add API (Ajouter une API).

  3. Sur la page Add an API (Ajouter une API), sélectionnez Experience Cloud puis Smart Content (Contenu dynamique). Cliquez sur Next (Suivant).

  4. Sélectionnez Upload your public key (Charger votre clé publique). Fournissez le fichier de certificat téléchargé depuis Experience Manager. Le message Public key(s) uploaded successfully (La ou les clés publiques ont été chargées) s’affiche. Cliquez sur Next (Suivant).

    La page Create a new Service Account (JWT) credential (Créer des informations d’identification de compte de service (JWT)) affiche la clé publique du compte de service qui vient d’être configuré.

  5. Cliquez sur Next (Suivant).

  6. Dans la page Select product profiles (Sélectionner les profils de produits), sélectionnez Smart Content Services (Services de contenu dynamique). Cliquez sur Save configured API (Enregistrer l’API configurée).

    Une page affiche davantage d’informations sur la configuration. Laissez cette page ouverte pour copier et ajouter ces valeurs dans Paramètres du service de balisage intelligent des ressources de la configuration cloud dans Experience Manager pour configurer les balises intelligentes.

    Dans l’onglet Overview (Aperçu), vous pouvez consulter les informations fournies pour l’intégration.

    Figure : Détails de l’intégration dans Adobe Developer Console

Configuration du service de contenu dynamique

Pour configurer l’intégration, utilisez les valeurs ID DE COMPTE TECHNIQUE, ID D’ORGANISATION, SECRET CLIENT et les champs ID CLIENT de l’intégration Adobe Developer Console. La création d’une configuration cloud de balises intelligentes permet d’authentifier les demandes d’API provenant du déploiement Experience Manager.

  1. Dans Experience Manager, accédez à Outils > Cloud Service > Cloud Services hérités pour ouvrir la console Cloud Services.

  2. Sous Ressources – Balises intelligentes, ouvrez la configuration créée ci-dessus. Sur la page de paramètres du service, cliquez sur Modifier.

  3. Dans la boîte de dialogue Service de contenu dynamique AEM, utilisez les valeurs préremplies pour les champs URL de service et Serveur d’autorisation.

  4. Pour les champs Clé d’API, ID de compte technique, ID d’organisation et Secret du client, copiez et utilisez les valeurs suivantes générées dans l’ intégration d’Adobe Developer Console.

    Paramètres du service de balisage intelligent des ressources Adobe Developer Console champs d'intégration
    Clé API ID CLIENT
    Identifiant de compte technique ID DE COMPTE TECHNIQUE
    Identifiant d'organisation ID D’ORGANISATION
    Secret client SECRET CLIENT

Validation de la configuration

Une fois la configuration terminée, utilisez un MBean JMX pour la valider. Pour procéder à la validation, suivez ces étapes.

  1. Accédez à votre serveur Experience Manager à l’adresse https://[aem_server]:[port].

  2. Accédez à Outils > Opérations > Console Web pour ouvrir la console OSGi. Cliquez sur Principal > JMX.

  3. Cliquez sur com.day.cq.dam.similaritysearch.internal.impl. Il ouvre Tâches diverses SimilaritySearch.

  4. Cliquez sur validateConfigs(). Dans la boîte de dialogue Valider les configurations, cliquez sur Invoquer.

    Les résultats de la validation s’affichent dans la même boîte de dialogue.

Activation du balisage intelligent dans le workflow Ressources de mise à jour de gestion des actifs numériques (facultatif)

  1. Dans Experience Manager, accédez à Outils > Workflow > Modèles.

  2. Sur la page Modèles de processus, sélectionnez le modèle de processus Ressources de mise à jour de gestion des actifs numériques (DAM).

  3. Cliquez sur Modifier dans la barre d’outils.

  4. Développez le panneau latéral pour afficher les étapes. Faites glisser l’étape Balisage intelligent de la ressource disponible dans la section Processus de DAM (gestion des actifs numériques) et placez-la après l’étape Miniatures des processus.

    Ajout de l’étape Balisage intelligent de la ressource après l’étape Miniatures des processus dans le processus Ressources de mise à jour de gestion des actifs numériques (DAM)

    Figure : Ajout de l’étape Balisage intelligent de la ressource après l’étape Miniatures des processus dans le processus Ressources de mise à jour de gestion des actifs numériques (DAM).

  5. Ouvrez l’étape en mode édition. Dans Paramètres avancés, vérifiez que l’option Avance du gestionnaire est sélectionnée.

    Configuration du workflow Ressources de mise à jour de gestion des actifs numériques et ajout de l’étape Balisage intelligent

    Figure : Configuration du workflow Ressources de mise à jour de gestion des actifs numériques et ajout de l’étape Balisage intelligent

  6. Dans l’onglet Arguments, sélectionnez Ignorer les erreurs si vous souhaitez que le processus se termine même si l’étape de balisage automatique échoue.

    Configuration du workflow Ressources de mise à jour de gestion des actifs numériques pour ajouter l’étape Balisage intelligent et sélectionner l’avance du gestionnaire

    Figure : Configuration du workflow Ressources de mise à jour de gestion des actifs numériques pour ajouter l’étape Balisage intelligent et sélectionner l’avance du gestionnaire

    Pour baliser les ressources lors de leur chargement, et ce, que le balisage intelligent soit activé ou non dans les dossiers, cochez la case Ignorer l’indicateur de balise intelligente.

    Configurez le workflow Ressources de mise à jour de gestion des actifs numériques pour ajouter une étape de balise intelligente et sélectionnez Ignorer l’indicateur de balise intelligente .

    Figure : Configurez le workflow Ressources de mise à jour de gestion des actifs numériques pour ajouter une étape de balise intelligente et sélectionnez Ignorer l’indicateur de balise intelligente .

  7. Cliquez sur OK pour fermer l’étape du processus, puis enregistrez ce dernier.

Sur cette page