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.
La configuration d’AEM Assets avec Brand Portal via Adobe I/O est prise en charge sur AEM 6.5.4.0 et versions ultérieures.
Auparavant, Brand Portal était configuré dans l’interface utilisateur classique via la passerelle OAuth héritée, qui fait appel à l’échange de jetons JWT pour obtenir un jeton d’accès IMS en vue de l’autorisation.
La configuration via application OAuth héritée n’est plus prise en charge à partir du 6 avril 2020 et est remplacée par la configuration via Adobe I/O.
Pour les clients existants uniquement
Il est recommandé de continuer à utiliser la configuration de la passerelle OAuth héritée. Si vous rencontrez des problèmes avec la configuration héritée de la passerelle OAuth, supprimez la configuration existante et créez une configuration via Adobe I/O.
Cette aide décrit les deux cas d’utilisation suivants :
  • Nouvelle configuration : Si vous êtes un nouvel utilisateur du portail de marque et souhaitez configurer votre instance d’auteur AEM Assets avec Brand Portal, vous pouvez créer une nouvelle configuration sur les E/S Adobe.
  • Configuration de la mise à niveau : Si vous êtes un utilisateur du portail de marque existant dont l’instance d’auteur AEM Assets est configurée avec Brand Portal sur la passerelle OAuth héritée, il est recommandé de supprimer les configurations existantes et de créer une nouvelle configuration sur les E/S Adobe.
Cette aide s’adresse à un public familiarisé avec les technologies suivantes :
  • Installation, configuration et administration des packs Adobe Experience Manager et AEM
  • Utilisation des systèmes d’exploitation Linux et Microsoft Windows

Conditions préalables

Pour configurer AEM Assets avec Brand Portal, vous devez disposer des éléments suivants :
  • Une instance d’auteur AEM Assets en cours d’exécution avec le dernier Service Pack
  • URL du client Brand Portal
  • Un utilisateur disposant de droits d’administrateur système sur l’organisation IMS du client Brand Portal

Téléchargement et installation d’AEM 6.5

Il est recommandé d’avoir AEM 6.5 pour configurer une instance d’auteur AEM. Si vous ne l’avez pas, téléchargez-le à partir des emplacements suivants :
Après avoir téléchargé AEM, consultez la page Déploiement et maintenance pour obtenir des instructions sur la configuration d’une instance d’auteur AEM.

Télécharger et installer le dernier Service Pack AEM

Pour obtenir des instructions détaillées, voir
Contactez l’assistance si vous ne parvenez pas à trouver le dernier package AEM ou le Service Pack.

Création d’une configuration

Effectuez les étapes suivantes dans la séquence répertoriée si vous configurez AEM Assets avec Brand Portal pour la première fois :

Création de la configuration IMS

La configuration IMS authentifie votre client du portail de marque avec l’instance d’auteur AEM Assets.
La configuration IMS comprend deux étapes :

Obtention d’un certificat public

Le certificat public vous permet d’authentifier vos d’sur les E/S Adobe.
  1. Connectez-vous à votre instance d’auteur AEM AssetsURL par défaut : http:// localhost:4502/aem/start.html
  2. Dans le panneau Outils , accédez à Sécurité > Configurations Adobe IMS.
  3. La page Configurations d’Adobe IMS s’ouvre.
    Cliquez sur Créer .
    Vous accéderez ainsi à la page Configuration du compte technique IMS d’ Adobe.
  4. Par défaut, l’onglet Certificat s’ouvre.
    Dans la solution ​Cloud, sélectionnez Adobe Brand Portal .
  5. Cochez la case Créer un nouveau 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. Click Download Public Key and save the AEM-Adobe-IMS.crt certificate file on your machine. The certificate file is used to create Adobe I/O integration .
  8. Cliquez sur Suivant .
    Dans l’onglet Compte , vous créez le compte Adobe IMS, mais vous aurez besoin des détails d’intégration. Gardez cette page ouverte pour l'instant.
    Ouvrez un nouvel onglet et créez une intégration d’E/S Adobe pour obtenir les détails d’intégration des configurations de compte IMS.

Créer l’intégration Adobe I/O

L’intégration des E/S Adobe génère une clé d’API, une clé secrète client et une charge utile (JWT) requises pour configurer les configurations de compte IMS.
  1. Connectez-vous à la console d’E/S Adobe avec les droits d’administrateur système sur l’organisation IMS du client du portail de marque.
    URL par défaut : https://console.adobe.io/
  2. Click Create Integration .
  3. Sélectionnez Accéder à une API , puis cliquez sur Continuer .
  4. Créez une page d’intégration qui s’ouvre.
    Sélectionnez votre organisation dans le déroulant.
    Dans Experience Cloud , sélectionnez AEM Brand Portal et cliquez sur Continuer .
    If the Brand Portal option is disabled for you, ensure that you have selected correct organization from the drop-down box above the Adobe Services option. Si vous ne connaissez pas le nom de votre entreprise, contactez votre administrateur.
  5. Indiquez un nom et une description pour l’intégration. Click Select a File from your computer and upload the AEM-Adobe-IMS.crt file downloaded in the obtain public certificates section.
  6. Sélectionnez le de votre organisation.
    Ou bien, sélectionnez le portail des marques Ressources par défaut et cliquez sur Créer une intégration . L’intégration est alors créée.
  7. Click Continue to integration details to view the integration information.
    Copie de la clé API
    Cliquez sur Récupérer la clé secrète du client et copiez la clé secrète du client.
  8. Accédez à l’onglet JWT et copiez la charge ​JWT.
    La clé API, la clé secrète client et les informations de charge utile JWT seront utilisées pour créer la configuration du compte IMS.

Créer 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, onglet Comptes . Vous avez gardé la page ouverte à la fin de la section Obtenir des certificats publics .
  2. Spécifiez un titre pour le compte IMS.
    Dans Authorization Server , saisissez l’URL : https://ims-na1.adobelogin.com/
    Collez la clé d’API, la clé secrète client et la charge utile JWT que vous avez copiée à la fin de l’intégration d’E/S Create Adobe.
    Cliquez sur Créer .
    L’intégration est créée.
  3. Select the IMS configuration and click Check Health . Une boîte de dialogue s’affiche.
    Cliquez sur Vérifier . Une fois la connexion établie, le message Token retrieved successfully (Jeton récupéré) s’affiche.
Vous ne devez avoir qu’une seule configuration IMS. Ne créez pas plusieurs configurations IMS.
Assurez-vous que la configuration IMS réussit le contrôle d’intégrité. Si la configuration ne réussit pas le contrôle d'intégrité, il n'est pas valide. Vous devez le supprimer et créer une nouvelle configuration valide.

Configure cloud service

Effectuez les étapes suivantes pour créer la configuration du service cloud de Portal de marque :
  1. Connexion à votre instance d’auteur AEM Assets
    URL par défaut : http:// localhost:4502/aem/start.html
  2. Dans le panneau Outils , accédez à Services Cloud > Portail de marque AEM.
    La page Configurations du portail de marque s’ouvre.
  3. Cliquez sur Créer .
  4. Specify a Title for the configuration.
    Sélectionnez la configuration IMS que vous avez créée à l’étape, créez la configuration du compte IMS.
    Dans l’URL du service, saisissez l’URL du client du portail de marque.
  5. Click Save and Close . La configuration cloud est alors créée. Votre instance d’auteur AEM Assets est maintenant intégrée au client du portail de marque.

Test configuration

  1. Connexion à votre instance d’auteur AEM Assets
    URL par défaut : http:// localhost:4502/aem/start.html
  2. Dans le panneau Outils , accédez à Déploiement > Réplication .
  3. La page Réplication s’ouvre.
    Cliquez sur Agents sur l’auteur .
  4. Quatre agents de réplication sont créés pour chaque client.
    Localisez les agents de réplication de votre locataire du portail de marque.
    Cliquez sur l’URL de l’agent de réplication.
    Les agents de réplication fonctionnent en parallèle et partagent la distribution des tâches de manière égale, augmentant ainsi la vitesse de publication de quatre fois la vitesse initiale. Une fois le service cloud configuré, une configuration supplémentaire n’est pas nécessaire pour activer les agents de réplication qui sont activés par défaut pour activer la publication parallèle de plusieurs ressources.
    Évitez de désactiver tout agent de réplication, car cela peut entraîner l’échec de la réplication de certaines ressources.
  5. Pour vérifier la connexion entre l’auteur AEM Assets et le portail de marque, cliquez sur Tester la connexion .
  6. En bas des résultats du test, vérifiez que la réplication a réussi.
    Les agents de réplication fonctionnent en parallèle et partagent la distribution des tâches de manière égale, augmentant ainsi la vitesse de publication de quatre fois la vitesse initiale. Une fois le service cloud configuré, une configuration supplémentaire n’est pas nécessaire pour activer les agents de réplication qui sont activés par défaut pour activer la publication parallèle de plusieurs ressources.
  7. Vérifiez les résultats du test sur les quatre agents de réplication un par un.
    Évitez de désactiver tout agent de réplication, car cela peut entraîner l’échec de la réplication de certaines ressources.
Le portail de marque est correctement configuré avec votre instance d’auteur AEM Assets. Vous pouvez maintenant :

Mise à niveau de la configuration

Effectuez les étapes suivantes dans la séquence répertoriée pour mettre à niveau les configurations existantes :

Vérification des tâches en cours

Assurez-vous qu’aucune tâche de publication n’est en cours d’exécution sur votre instance d’auteur AEM Assets avant d’apporter des modifications. Pour cela, vous pouvez vérifier les quatre agents de réplication et vous assurer que la file d’attente est idéale/vide.
  1. Connexion à votre instance d’auteur AEM Assets
    URL par défaut : http:// localhost:4502/aem/start.html
  2. Dans le panneau Outils , accédez à Déploiement > Réplication .
  3. La page Réplication s’ouvre.
    Cliquez sur Agents sur l’auteur .
  4. Localisez les agents de réplication de votre locataire du portail de marque.
    Assurez-vous que la file d’attente est inactive pour tous les agents de réplication ; aucune tâche de publication n’est active.

Supprimer les configurations existantes

Vous devez exécuter le de vérification suivant lors de la suppression des configurations existantes.
  • Supprimer les quatre agents de réplication
  • Suppression du service cloud
  • Supprimer un utilisateur MAC
  1. Connectez-vous à votre instance d’auteur AEM Assets et ouvrez CRX Lite en tant qu’administrateur.
    URL par défaut : http:// localhost:4502/crx/de/index.jsp
  2. Accédez à /etc/replications/agents.author et supprimez les quatre agents de réplication de votre locataire du portail de marque.
  3. Accédez à /etc/cloudservices/mediaportal la configuration du service Cloud et supprimez-la.
  4. Accédez à /home/users/mac et supprimez l’utilisateur ​MAC de votre locataire du portail de marque.
Vous pouvez désormais créer une configuration sur votre instance d’auteur AEM 6.5 sur les E/S Adobe.
Une fois la réplication réussie, vous pouvez publier des ressources, des dossiers et des collections sur Brand Portal. Pour plus d’informations, voir :