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

Vous pouvez intégrer des Adobe Experience Manager avec le service de contenu dynamique utilisant 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. À l’arrière-plan, la variable Experience Manager le serveur authentifie vos informations d’identification de service auprès de la fonction Adobe Developer Console passerelle avant de transférer votre demande vers le 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. Configuration de votre déploiement à l’aide de la clé API et d’autres informations d’identification provenant de Adobe Developer Console.

  4. Testez la configuration.

  5. Éventuellement, activation du balisage automatique lors du chargement de ressources.

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 la dernière version Service Pack Experience Manager.

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

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

  1. Dans le Experience Manager interface utilisateur, accès Outils > Cloud Services > Cloud Services hérités.

  2. Dans la page Cloud Services, cliquez sur Configurer maintenant under Balises intelligentes des ressources.

  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 sous la forme URL du service n’est pas accessible par le biais du navigateur et génère une erreur 404. La configuration fonctionne correctement avec la même valeur que la variable URL du service . Pour connaître l’état général 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 et télécharger 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 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 Clé API (généré dans ID CLIENT champ de l’intégration d’Adobe Developer Console), ID DE COMPTE TECHNIQUE, ID D’ORGANISATION, 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 des 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 de ID DE COMPTE TECHNIQUE, ID D’ORGANISATION, SECRET CLIENT, et ID CLIENT des champs de l’intégration d’Adobe Developer Console. La création d’une configuration de cloud de balises intelligentes permet d’authentifier les requêtes d’API provenant de Experience Manager déploiement.

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

  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é Api, Identifiant du compte technique, ID d’organisation, et Secret du client, copiez et utilisez les valeurs suivantes générées dans 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 à Experience Manager server at 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 s’ouvre. Tâches diverses SimilaritySearch.

  4. Cliquez sur validateConfigs(). Dans le Validation des configurations boîte de dialogue, cliquez sur Appeler.

    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