Configuration du balisage des ressources à l’aide du service de contenu dynamique configure-asset-tagging-using-the-smart-content-service
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.
- Les services de contenu intelligent ne sont plus disponibles pour les nouveaux clients On-Premise Experience Manager Assets. Les clients On-Premise existants, pour lesquels cette fonctionnalité est déjà activée, peuvent continuer à utiliser les services de contenu intelligent.
- Les services de contenu intelligent sont disponibles pour les clients Managed Services Experience Manager Assets, pour lesquels cette fonctionnalité est déjà activée.
- Les nouveaux clients Managed Services Experience Manager Assets peuvent suivre les instructions mentionnées dans cet article pour configurer les services de contenu intelligent.
L’article détaille les tâches clés suivantes, 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.
-
Création d’un service de contenu dynamique configuration dans Experience Manager pour générer une clé publique. Obtenez un certificat public pour l’intégration d’OAuth.
-
Créez une intégration dans Adobe Developer Console et chargez la clé publique générée.
-
Configuration de votre déploiement à l’aide de la clé API et d’autres informations d’identification provenant de Adobe Developer Console.
-
Facultativement, activez le balisage automatique lors du chargement des ressources.
Prérequis prerequisites
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 service 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 obtain-public-certificate
Un certificat public vous permet d’authentifier votre profil sur Adobe Developer Console.
-
Dans l’interface utilisateur Experience Manager, accédez à Outils > Services cloud > Services cloud hérités.
-
Dans la page Services cloud, cliquez sur Configurer maintenant sous Ressources – Balises intelligentes.
-
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.
-
Dans la boîte de dialogue Service de contenu dynamique AEM, utilisez les valeurs suivantes :
URL du service :
https://smartcontent.adobe.io/<region where your Experience Manager author instance is hosted>Par exemple,
https://smartcontent.adobe.io/apac. Vous pouvez indiquerna,emea, ouapaccomme les régions où votre instance d’auteur Experience Manager est hébergée.note note NOTE Si le service géré Experience Manager est mis en service avant le 1er septembre 2022, utilisez l’URL de service suivante : https://mc.adobe.io/marketingcloud/smartcontentServeur d’autorisation :
https://ims-na1.adobelogin.comLaissez les autres champs vides pour l’instant (pour les remplir ultérieurement). Cliquez sur OK.
Image : boîte de dialogue Service de contenu dynamique pour fournir une URL de service de contenu
note note NOTE L’URL fournie en tant qu’URL de service n’est pas accessible via le navigateur et génère un message d’erreur 404. La configuration fonctionne correctement avec la même valeur que le paramètre URL de service. Pour connaître le statut général du service et le planning de maintenance, consultez https://status.adobe.com. -
Cliquez sur Télécharger le certificat public pour l’intégration OAuth et téléchargez le fichier de certificat public
AEM-SmartTags.crt.
Image : paramètres du service de balisage intelligent
Reconfiguration quand un certificat atteint sa date d’expiration certrenew
Lorsque le certificat expire, il n’est plus approuvé. Vous ne pouvez pas renouveler un certificat ayant expiré. Pour ajouter un nouveau certificat, procédez comme suit.
-
Connectez-vous en tant qu’administrateur à votre déploiement Experience Manager. Cliquez sur Outils > Sécurité > Utilisateurs.
-
Recherchez et cliquez sur l’utilisateur dam-update-service. Cliquez sur Keystore .
-
Supprimez le fichier de stockage de clés similaritysearch existant avec le certificat arrivé à expiration. Cliquez sur Enregistrer et fermer.
Figure : Suppression d’une entrée existante
similaritysearchdans le Keystore pour ajouter un nouveau certificat de sécurité. -
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.
-
Pour télécharger un certificat public, cliquez sur Télécharger le certificat public pour l’intégration OAuth.
-
Accès https://console.adobe.io et accédez aux services de contenu dynamique existants sur la page Intégrations page. Téléchargez le nouveau certificat. Pour plus d’informations, consultez les instructions contenues dans Création d’une intégration dans Adobe Developer Console.
Création de l’intégration de la console Adobe Developer create-adobe-i-o-integration
Pour utiliser les API de service de contenu dynamique, créez une intégration dans la console Adobe Developer afin d’obtenir la Clé API (générée dans le champ ID CLIENT de l’intégration de la console Adobe Developer), ID DE COMPTE TECHNIQUE, ID D’ORGANISATION et SECRET CLIENT pour les Paramètres du service de balisage intelligent des ressources de la configuration cloud dans Experience Manager.
-
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.
-
Créez un projet portant le nom de votre choix. Cliquez sur Add API (Ajouter une API).
-
Sur la page Add an API (Ajouter une API), sélectionnez Experience Cloud puis Smart Content (Contenu dynamique). Cliquez sur Next (Suivant).
-
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é.
-
Cliquez sur Next (Suivant).
-
Dans la page Select product profiles (Sélectionner les profils de produits), sélectionnez Smart Content Services (Services de contenu dynamique). Cliquez sur 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 les Paramètres du service de balisage intelligent des ressources de la configuration cloud dans Experience Manager pour configurer des balises intelligentes.
Image : détails de l’intégration dans la console Adobe Developer
Configuration du service de contenu dynamique configure-smart-content-service
Pour configurer l’intégration, utilisez les valeurs d’ID DE COMPTE TECHNIQUE, d’ID D’ORGANISATION, de SECRET CLIENT et d’ID CLIENT à partir de l’intégration de la console Adobe Developer. La création d’une configuration cloud de balises intelligentes permet d’authentifier les demandes d’API provenant du déploiement Experience Manager.
-
Experience ManagerAccédez à Outils > Services cloud > Services cloud hérités pour ouvrir la console Services cloud.
-
Sous , Balises intelligentes des ressources, ouvrez la configuration créée ci-dessus. Sur la page des paramètres du service, cliquez sur Modifier.
-
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.
-
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 de la console Adobe Developer.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 Paramètres du service de balisage intelligent des ressources Champs d’intégration d’Adobe Developer Console 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 validate-the-configuration
Une fois la configuration terminée, utilisez un MBean JMX pour la valider. Pour procéder à la validation, suivez ces étapes.
-
Accédez à votre serveur Experience Manager sur
https://[aem_server]:[port]. -
Accédez à Outils > Opérations > Console Web pour ouvrir la console OSGi. Cliquez sur Principal > JMX.
-
Cliquez sur com.day.cq.dam.similaritysearch.internal.impl. Les tâches relatives à SimilaritySearch s’ouvrent alors.
-
Cliquez sur validateConfigs(). Dans la boîte de dialogue Valider les configurations, cliquez sur Invoquer.
Le résultat de la validation s’affiche dans la même boîte de dialogue.
Activation du balisage intelligent dans le workflow Ressource de mise à jour de la gestion des ressources numériques (Facultatif) enable-smart-tagging-in-the-update-asset-workflow-optional
-
Dans Experience Manager, accédez à Outils > Workflow > Modèles.
-
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).
-
Cliquez sur Modifier dans la barre d’outils.
-
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.
Image : ajout de l’étape de balisage intelligent de la ressource après l’étape Miniatures des processus dans le workflow Ressources de mise à jour de la gestion des ressources numériques.
-
Ouvrez l’étape en mode édition. Dans Paramètres avancés, vérifiez que l’option Avance du gestionnaire est sélectionnée.
Image : configuration du workflow de Ressource de mise à jour de la gestion des ressources numériques et ajout de l’étape de balisage intelligent
-
Dans l’onglet Arguments, sélectionnez Ignorer les erreurs si vous souhaitez que le workflow se termine même si l’étape de balisage automatique échoue.
Image : configuration du workflow de Ressource de mise à jour de la gestion des ressources numériques pour ajouter l’étape de 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.
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 .
-
Cliquez sur OK pour fermer l’étape du workflow, puis enregistrez ce dernier.