Show Menu
SUJETS×

Configuration d’AEM Assets avec Brand Portal

Adobe Experience Manager (AEM) Assets est configuré avec Brand Portal via Adobe I/O, qui fournit un jeton IMS pour autoriser votre client Brand Portal.

Conditions préalables

Pour configurer AEM Assets avec Brand Portal, vous devez disposer des éléments suivants :
  • Une instance cloud AEM Assets en cours d’exécution.
  • URL du client Brand Portal
  • Un utilisateur disposant de droits d’administrateur système sur l’organisation IMS du client Brand Portal
Contactez l’assistance si vous avez d’autres questions.

Création d’une configuration

Vous pouvez créer une configuration sur Adobe I/O pour configurer votre instance cloud AEM Assets avec Brand Portal.
Effectuez les étapes suivantes dans leur ordre d’apparition :

Création de la configuration IMS

La configuration IMS authentifie votre client Brand Portal avec l’instance d’auteur AEM Assets.
La configuration IMS comprend deux étapes :

Obtention d’un certificat public

Un certificat public permet d’authentifier votre profil sur Adobe I/O.
  1. Connectez-vous à votre instance cloud AEM Assets.
  2. Dans le panneau outil , accédez à Sécurité  > Configurations d’Adobe IMS .
  3. La page Configurations d’Adobe IMS s’ouvre.
    Cliquez sur Créer .
    Vous accédez alors à la page Configuration du compte technique Adobe IMS .
  4. Par défaut, l’onglet Certificat s’ouvre.
    Dans Solution cloud , sélectionnez Adobe Brand Portal .
  5. Cochez la case Créer un certificat et spécifiez un alias pour le certificat. L’alias sert de nom à la boîte de dialogue.
  6. Cliquez sur Créer un certificat . Une boîte de dialogue s’affiche. Cliquez sur OK pour générer le certificat public.
  7. Cliquez sur Télécharger la clé publique et enregistrez le fichier de certificat AEM-Adobe-IMS.crt sur votre ordinateur. Le fichier de certificat est utilisé pour créer une intégration Adobe I/O .
  8. Cliquez sur Suivant .
    Dans l’onglet Compte , vous créez le compte Adobe IMS, mais vous avez pour cela besoin des détails d’intégration. Gardez cette page ouverte pour l’instant.
    Ouvrez un nouvel onglet et créez une intégration Adobe I/O pour obtenir les détails d’intégration des configurations de compte IMS.

Création de l’intégration Adobe I/O

L’intégration Adobe I/O génère une clé API, un secret client et une charge utile (JWT), dont vous avez besoin pour configurer les configurations de compte IMS.
  1. Connectez-vous à la console Adobe I/O avec les droits d’administrateur système sur l’organisation IMS du client Brand Portal.
    URL par défaut : https://console.adobe.io/
  2. Cliquez sur Créer une intégration .
  3. Sélectionnez Accéder à une API , puis cliquez sur Continuer .
  4. La page Créer une intégration s’affiche.
    Sélectionnez votre entreprise dans la liste déroulante.
    Dans Experience Cloud , sélectionnez AEM Brand Portal et cliquez sur Continuer .
    Si l’option Brand Portal est désactivée, assurez-vous d’avoir sélectionné la bonne entreprise dans la liste déroulante au-dessus de l’option Adobe Services (Services Adobe). Si vous ne connaissez pas le nom de votre entreprise, contactez votre administrateur.
  5. Spécifiez le nom et la description de l’intégration. Cliquez sur Select a File from your computer (Sélectionner un fichier sur votre ordinateur) et téléchargez le fichier AEM-Adobe-IMS.crt téléchargé dans la section obtenir des certificats publics .
  6. Sélectionnez le profil de votre entreprise.
    Ou sélectionnez le profil Assets Brand Portal par défaut et cliquez sur Créer une intégration . L’intégration est créée.
  7. Appuyez sur Continue to integration details (Continuer vers les détails d’intégration) pour afficher les informations d’intégration.
    Copiez la clé API .
    Cliquez sur Retrieve Client Secret (Récupérer le secret client) et copiez la clé secrète client.
  8. Accédez à l’onglet JWT et copiez la charge JWT .
    Les informations de clé API, de clé secrète client et de charge utile JWT seront utilisées pour créer la configuration du compte IMS.

Création d’une configuration de compte IMS

Vérifiez que vous avez effectué les étapes suivantes :
Procédure de création de la configuration du compte IMS :
  1. Ouvrez la page Configuration IMS de l’onglet Comptes . Vous avez gardé la page ouverte à la fin de la section Obtention d’un certificat public .
  2. Spécifiez un titre pour le compte IMS.
    Dans Serveur d’autorisation , entrez l’adresse URL : https://ims-na1.adobelogin.com/
    Collez la clé API, le secret client et la charge utile JWT que vous avez copiés à la fin de Création de l’intégration Adobe I/O .
    Cliquez sur Créer .
    L’intégration est créée.
  3. Sélectionnez la configuration IMS et cliquez sur Contrôle de l’intégrité . Une boîte de dialogue s’affiche.
    Cliquez sur Vérifier . Une fois la connexion établie, le message Jeton récupéré avec succès s’affiche.
Vous ne devez avoir qu’une seule configuration IMS. N’en créez pas plusieurs.
Assurez-vous que la configuration IMS réussit le contrôle d’intégrité. Si tel n’est pas le cas, elle n’est pas valide. Vous devez la supprimer et créer une configuration valide.

Configuration du service cloud

Pour créer une configuration de service cloud Brand Portal, procédez comme suit :
  1. Connectez-vous à votre instance cloud AEM Assets.
  2. Dans le panneau outil , accédez à Services cloud  > AEM Brand Portal .
    La page Configurations de Brand Portal s’affiche.
  3. Cliquez sur Créer .
  4. Saisissez un titre pour la configuration.
    Sélectionnez la configuration IMS que vous avez créée à l’étape Création d’une configuration de compte IMS .
    Dans URL du service , entrez votre URL du client Brand Portal.
  5. Cliquez sur Enregistrer et fermer . La configuration cloud est alors créée. Votre instance cloud AEM Assets est maintenant configurée avec le client Brand Portal.

Test de la configuration

  1. Connectez-vous à votre instance cloud AEM Assets.
  2. Dans le panneau outil , accédez à Déploiement  > Distribution .
  3. La page Distribution s’ouvre.
    Un agent de distribution Brand Portal bpdistributionagent0 est créé sous Publier sur Brand Portal .
    Cliquez sur Publier sur Brand Portal .
    Par défaut, un agent de distribution est créé pour un client Brand Portal.
  4. La page de l’agent de distribution s’ouvre. Par défaut, l’onglet État s’ouvre, et les files d’attente de distribution sont alors renseignées.
    Un agent de distribution contient deux files d’attente :
    • processing-queue  : pour la distribution des ressources de Brand Portal.
    • error-queue  : pour les ressources dont la distribution a échoué.
    Il est recommandé d’examiner les erreurs et d’effacer régulièrement la file d’attente error-queue .
  5. Pour vérifier la connexion entre AEM Assets et Brand Portal, cliquez sur Tester la connexion .
    Un message s’affiche en bas de la page pour indiquer que votre package de test a été livré.
    Évitez de désactiver l’agent de distribution, car cela peut entraîner l’échec de la distribution des ressources (running-in-queue).
Votre instance cloud AEM Assets est correctement configurée avec Brand Portal, et vous pouvez à présent effectuer les actions suivantes :
Outre ce qui précède, vous pouvez également publier des schémas de métadonnées, des paramètres d’image prédéfinis, des facettes de recherche et des balises d’AEM Assets sur Brand Portal.
Pour plus d’informations, voir Publication de balises sur Brand Portal .

Journaux de distribution

Vous pouvez consulter les journaux pour obtenir des informations détaillées sur les actions effectuées sur l’agent de distribution.
Par exemple, nous avons publié une ressource d’AEM Assets sur Brand Portal pour vérifier la configuration.
  1. Suivez les étapes (1 à 4), comme indiqué dans Test de la connexion , puis accédez à la page de l’agent de distribution.
  2. Cliquez sur Journaux pour afficher les journaux de distribution. Vous pouvez afficher les journaux de traitement et d’erreur ici.
L’agent de distribution génère les journaux suivants :
  • INFO : Il s’agit d’un journal généré par le système qui se déclenche lors d’une configuration réussie activant l’agent de distribution.
  • DSTRQ1 (requête 1) : Déclencheurs lors du test de la connexion.
Lors de la publication de la ressource, les journaux de requête et de réponse suivants sont générés :
Requête de l’agent de distribution  :
  • DSTRQ2 (requête 2) : La requête de publication de ressource est déclenchée.
  • DSTRQ3 (requête 3) : Le système déclenche une autre requête pour publier le dossier dans lequel se trouve la ressource et réplique le dossier dans Brand Portal.
Réponse de l’agent de distribution  :
  • queue-bpdistributionagent0 (DSTRQ2) : La ressource est publiée sur Brand Portal.
  • queue-bpdistributionagent0 (DSTRQ3) : Le système réplique le dossier contenant la ressource dans Brand Portal.
Dans l’exemple ci-dessus, une requête et une réponse supplémentaires sont déclenchées. Le système n’a pas trouvé le dossier parent (alias Ajouter chemin d’accès) dans Brand Portal, car la ressource a été publiée pour la première fois. Par conséquent, il déclenche une requête supplémentaire pour créer un dossier parent portant le même nom dans Brand Portal à l’emplacement où la ressource est publiée.
Une requête supplémentaire est générée au cas où le dossier parent n’existerait pas dans Brand Portal (dans l’exemple ci-dessus) ou si le dossier parent a été modifié dans AEM Assets.