Configuration d’AEM Assets avec Brand Portal

Adobe Experience Manager (AEM) Assets est configuré avec Brand Portal via Adobe I/O, qui obtient un jeton IMS pour l’autorisation de votre locataire du portail de marques.

Cette aide décrit les deux cas d’utilisation suivants :

• Nouvelle configuration : Si vous êtes un nouvel utilisateur du portail des marques et souhaitez configurer votre instance d’auteur AEM Assets avec Brand Portal, vous pouvez créer une nouvelle configuration sur Adobe I/O.
• Configuration de la mise à niveau : Si vous êtes un utilisateur existant du portail de marques 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 Adobe I/O.

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 AEM 6.4

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

Téléchargez et installez AEM 6.4

Il est recommandé d’avoir AEM 6.4 pour configurer une instance d’auteur AEM. Si vous ne l’avez pas, téléchargez-le à partir des emplacements suivants :

• Si vous êtes un client AEM existant, téléchargez AEM 6.4 à partir du site Web de gestion des licences d’Adobe.

• Si vous êtes un partenaire d'Adobe, utilisez Adobe de formation de partenaire d'Programme pour demander AEM 6.4.

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

• Notes de mise à jour d’AEM 6.4, Pack de services

Contactez Career Client si vous ne trouvez pas le dernier pack AEM ou 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 :

1. Obtention d’un certificat public
2. Adobe I/O Createintegration
3. Création d’une configuration de compte IMS
4. Configuration du service cloud
5. Test de la configuration

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
• Création d’une configuration de compte IMS

Obtention d’un certificat public

Le certificat public vous permet d'authentifier votre profil sur Adobe I/O.

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 à Sécurité > Adobe Configurations IMS.

   

3. La page Configurations d’Adobe IMS s’ouvre.

   Cliquez sur Créer.

   Vous accédez ainsi à la page Configuration du compte technique IMS Adobe.

4. Par défaut, l’onglet Certificat s’ouvre.

   Dans 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. 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 Adobe I/O intégration.

   

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éer Adobe I/O l'intégration pour obtenir les détails de l'intégration pour les configurations de compte IMS.

Créer une intégration Adobe I/O

Adobe I/OL’intégration 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 du portail de marques.

   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 :

• Obtention d’un certificat public
• Adobe I/O Createintegration

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é d’API, la clé secrète client et la charge utile JWT que vous avez copiée à la fin de Create Adobe I/O intégration.

   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.

   

Configuration du service cloud

Pour créer une configuration de service cloud Brand Portal, procédez comme suit :

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 à Cloud Services " Portail des marques AEM.

   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 d’auteur AEM Assets est désormais intégrée au client du portail de marque.

Test de la 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 author.

   

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.

   

   REMARQUE

   Les agents de réplication fonctionnent en parallèle et partagent la répartition 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é, aucune configuration supplémentaire n’est requise pour activer les agents de réplication activés par défaut pour permettre la publication parallèle de plusieurs actifs.

5. Pour vérifier la connexion entre l’auteur AEM Assets et le portail des marques, cliquez sur Tester la connexion.

   

6. En bas des résultats du test, vérifiez que la réplication a réussi.

   

7. Vérifiez les résultats du test sur les quatre agents de réplication un par un.

   REMARQUE

   Évitez de désactiver tout agent de réplication, car cela peut entraîner l’échec de la réplication de certaines ressources.

   Assurez-vous que les quatre agents de réplication sont configurés pour éviter les erreurs de délai d’attente. Voir résoudre les problèmes de publication en parallèle sur le portail de marque.

Le portail de marque a été correctement configuré avec votre instance d’auteur AEM Assets. Vous pouvez maintenant effectuer les tâches suivantes :

• Publication de ressources à partir d’AEM Assets sur Brand Portal
• Publication de dossiers à partir d’AEM Assets sur Brand Portal
• Publication de collections à partir d’AEM Assets sur Brand Portal
• Configurez l’ origine des ressources pour permettre aux utilisateurs du portail de marque de contribuer et de publier des ressources sur AEM Assets.

Mise à niveau de la configuration

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

1. Vérification des tâches en cours
2. Supprimer les configurations existantes
3. Création d’une configuration

Vérifier les tâches en cours

Assurez-vous qu’aucune tâche de publication n’est exécutée 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 author.

   

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, aucun travail de publication n'est principal.

   

Supprimer les configurations existantes

Vous devez exécuter la liste de vérification suivante lors de la suppression de la configuration existante.

• Supprimer les quatre agents de réplication
• Suppression du service cloud
• Supprimer un utilisateur MAC

Effectuez les étapes suivantes pour supprimer la configuration existante :

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 et supprimez la configuration du Cloud Service.

   

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.4 sur Adobe I/O.

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 :

• Publication de ressources sur Brand Portal
• Publication de ressources et de dossiers sur Brand Portal
• Publication de collections sur Brand Portal