Configuration d’AEM Assets as a Cloud Service avec Brand Portal

La configuration d’Adobe Experience Manager Assets Brand Portal permet de publier des ressources de marque approuvées d’Adobe Experience Manager Assets as a Cloud Service vers Brand Portal et de les distribuer aux utilisateurs de Brand Portal.

Activer le portail de marque à l’aide de Cloud Manager

L’utilisateur de Cloud Manager active Brand Portal pour une AEM Assets en tant qu’instance Cloud Service. Le processus d’activation crée les configurations requises (jeton d’autorisation, configuration IMS et service cloud du portail de marque) à l’arrière-plan et reflète l’état du client du portail de marque dans Cloud Manager. L’activation du portail de marques permet aux utilisateurs d’AEM Assets de publier des fichiers sur le portail de marques et de les distribuer aux utilisateurs du portail de marques.

Conditions préalables

Vous avez besoin des éléments suivants pour activer le portail de marque sur votre AEM Assets en tant qu'instance Cloud Service :

  • Une instance AEM Assets as a Cloud Service opérationnelle.
  • Utilisateur ayant accès à Cloud Manager, affecté aux Profils du produit Cloud Manager. Voir accès à Cloud Manager pour plus d’informations.
REMARQUE

Une AEM Assets en tant qu'instance Cloud Service est autorisée à se connecter à un seul client du portail de marques. Vous pouvez avoir plusieurs environnements (développement, production et étape) pour votre AEM Assets en tant qu’instance Cloud Service, dans laquelle le portail de marque est activé sur un environnement.

Procédure d’activation du portail des marques

Vous pouvez activer le portail de marques lors de la création des environnements pour votre AEM Assets en tant qu'instance Cloud Service, ou séparément. Supposons que les environnements ont déjà été créés et que vous deviez activer le portail de marque.

  1. Connectez-vous à Adobe Cloud Manager et accédez à Environnements.

    La page Environnements affiche la liste de tous les environnements existants.

  2. Sélectionnez les environnements (un par un) de la liste à la vue des détails de l'environnement.

    Le portail de la marque a droit à l'un des environnements disponibles et est reflété dans les informations sur l'Environnement.

    Une fois que vous avez trouvé l'environnement associé au portail de la marque, cliquez sur le bouton Activer le portail de la marque pour lancer le processus d'activation.

    Activer Brand Portal

  3. L’activation du client du portail de marques prend quelques minutes, car le processus d’activation crée les configurations requises sur le serveur principal. Une fois que le client du portail de marques est activé, l’état devient Activé.

    État de la vue

REMARQUE

Le portail de marque doit être activé sur la même organisation IMS que l’AEM Assets en tant qu’instance Cloud Service.

Si vous disposez d’une configuration cloud du portail de marque existante (configurée manuellement à l’aide de la Console développeur d’Adobe) pour une organisation IMS (org1-existant) et que votre AEM Assets en tant qu’instance Cloud Service est configurée pour une autre organisation IMS (org2-new), l’activation du portail de marque à partir de Cloud Manager réinitialise l’organisation IMS du portail de marque à org2-new. Bien que la configuration de cloud configurée manuellement sur org1-existing soit visible dans l’instance d’auteur AEM Assets, elle ne sera plus utilisée après l’activation du portail de marque à partir de Cloud Manager.

Si la configuration cloud existante du portail de marque et l’AEM Assets en tant qu’instance Cloud Service utilisent la même organisation IMS (org1), il vous suffit d’activer le portail de marque à partir de Cloud Manager.

Voir également:

Connectez-vous à votre client Brand Portal:

Après l’activation de votre locataire du portail de marque dans Cloud Manager, vous pouvez vous connecter au portail de marque à partir du Admin Console ou directement à l’aide de l’URL du locataire.

L’URL par défaut de votre locataire du portail de marques est : https://<tenant-id>.brand-portal.adobe.com/.

Où que ce soit, l'identifiant locataire est l'organisation IMS.

Effectuez les étapes suivantes si vous n’êtes pas sûr de l’URL du portail de marque :

  1. Connectez-vous à Admin Console et accédez à Produits.

  2. Dans le rail de gauche, sélectionnez Portail de marques Adobe Experience Manager - Portail de marques.

  3. Cliquez sur Accéder au portail des marques pour ouvrir directement le portail des marques dans le navigateur.

    Vous pouvez également copier l’URL du locataire du portail de marque à partir du lien Accéder au portail de marque et la coller dans votre navigateur pour ouvrir l’interface du portail de marque.

    Accès au portail de marque

Testez la connexion.

Effectuez les étapes suivantes pour valider la connexion entre votre AEM Assets en tant qu’instance Cloud Service et locataire du portail de marques :

  1. Connectez-vous à AEM Assets.

  2. Dans le panneau Outils, accédez à Déploiement > Distribution.

    Un agent de distribution Brand Portal (bpdistributionagent0) est créé sous Publier sur Brand Portal.

  3. Cliquez sur Publier sur Brand Portal pour ouvrir l’agent de distribution.

    Les files d’attente de distribution apparaissent dans l’onglet État.

    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é.

    REMARQUE

    Il est recommandé d’examiner les erreurs et d’effacer régulièrement la file d’attente error-queue.

  4. Pour vérifier la connexion entre AEM Assets as a Cloud Service et Brand Portal, cliquez sur l’icône Tester la connexion.

    Un message s’affiche indiquant que votre package de test a bien été livré.

    REMARQUE

    Évitez de désactiver l’agent de distribution, car cela peut entraîner l’échec de la distribution des ressources (running-in-queue).

Pour vérifier la connexion entre votre AEM Assets en tant qu’instance Cloud Service et le client du portail des marques, publiez un fichier d’AEM Assets vers le portail des marques. Si la connexion est établie, le fichier publié est visible dans l’interface du portail de marque.

Vous pouvez maintenant effectuer les tâches suivantes :

Pour plus d’informations, voir Publication de balises sur Brand Portal.

Journaux de distribution

Vous pouvez surveiller les journaux de l’agent de distribution correspondant au workflow de publication de ressources.

Publions maintenant un fichier d'AEM Assets sur Brand Portal et voyons les journaux.

  1. Suivez les étapes (de 1 à 4) décrites dans la section Tester la connexion et accédez à la page de l'agent de distribution.

  2. Cliquez sur Journaux pour afficher les journaux de traitement et d’erreurs.

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 de 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 AEM Assets (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 AEM Assets (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 (Ajouter chemin d’accès) dans Brand Portal, car la ressource a été publiée pour la première fois. Par conséquent, il a déclenché 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.

REMARQUE

Une requête supplémentaire est générée au cas où le dossier parent n’existe pas dans Brand Portal ou a été modifié dans AEM Assets.

Outre le processus d’automatisation pour activer Brand Portal sur AEM Assets en tant que Cloud Service, il existe une autre méthode pour configurer manuellement AEM Assets en tant que Cloud Service avec Brand Portal à l’aide de la Console développeur d’Adobes qui n’est plus recommandée.

REMARQUE

Contactez l’assistance Adobe si vous rencontrez un problème lors de l’activation de votre client du portail de marque.

Configuration manuelle à l’aide de la Console développeur d’Adobes

La section suivante décrit comment configurer manuellement AEM Assets en tant que Cloud Service avec Brand Portal à l’aide d’Adobe Developer Console.

Auparavant, AEM Assets en tant que Cloud Service avait été configuré manuellement avec Brand Portal via Adobe Developer Console, qui achetait un jeton de compte IMS (Adobe Identity Management Services) pour l'autorisation du locataire du portail Marque. Il nécessite des configurations à la fois dans AEM Assets et dans Adobe Developer Console.

  1. Dans AEM Assets, créez un compte IMS et générez une clé publique (certificat).
  2. Dans Adobe Developer Console, créez un projet pour votre client Brand Portal (organisation).
  3. Dans le projet, configurez une API à l’aide de la clé publique pour créer une connexion au compte de service.
  4. Procurez-vous les informations d’identification du compte de service et les informations de charge utile JSON Web Token (JWT).
  5. Dans AEM Assets, configurez le compte IMS à l’aide des informations d’identification du compte de service et de la charge utile JWT.
  6. Dans AEM Assets, configurez le service cloud Brand Portal à l’aide du compte IMS et du point d’entrée Brand Portal (URL de l’organisation).
  7. Testez votre configuration en publiant une ressource d’AEM Assets sur Brand Portal.
REMARQUE

Une instance AEM Assets as a Cloud Service ne doit être configurée qu’avec un seul client Brand Portal.

Conditions préalables

Pour configurer AEM Assets avec Brand Portal, vous devez disposer des éléments suivants :

  • Une instance AEM Assets as a Cloud Service opérationnelle
  • Une adresse URL du client Brand Portal
  • Un utilisateur disposant de droits d’administrateur système sur l’organisation IMS du client Brand Portal

Création d’une configuration

Procédez comme suit dans la séquence spécifiée pour configurer AEM Assets avec Brand Portal.

  1. Obtention d’un certificat public
  2. Création d’une connexion au compte de service (JWT)
  3. Configuration du compte IMS
  4. Configuration du service cloud

Création de la configuration IMS

La configuration IMS authentifie votre instance AEM Assets as a Cloud Service auprès du client Brand Portal.

La configuration IMS comprend deux étapes :

Obtention d’un certificat public

La clé publique (certificat) authentifie votre profil sur Adobe Developer Console.

  1. Connectez-vous à AEM Assets.

  2. Dans le panneau Outils, accédez à Sécurité > Configurations d’Adobe IMS.

  3. Dans la page Configurations d’Adobe IMS, cliquez sur Créer. Vous êtes redirigé vers la page Configuration du compte technique Adobe IMS. Par défaut, l’onglet Certificat s’ouvre.

  4. Sélectionnez Adobe Brand Portal dans la liste déroulante Solution cloud.

  5. Cochez la case Créer un certificat et spécifiez un alias pour la clé publique. L’alias constitue le nom de la clé publique.

  6. Cliquez sur Créer un certificat. Cliquez sur OK pour générer la clé publique.

    Création d’un certificat

  7. Cliquez sur l’icône Télécharger la clé publique et enregistrez le fichier de clé publique (CRT) sur votre ordinateur.

    La clé publique est utilisée ultérieurement pour configurer l’API de votre client du portail de marque et générer les informations d’identification du compte de service dans la console de développement des Adobes.

    Téléchargement du certificat

  8. Cliquez sur Suivant.

    Dans l’onglet Compte, un compte Adobe IMS est créé, ce qui nécessite les informations d’identification du compte de service qui sont générées dans Adobe Developer Console. Gardez cette page ouverte pour l’instant.

    Ouvrez un nouvel onglet et créez une connexion au compte de service (JWT) dans Adobe Developer Console pour obtenir les informations d’identification et la charge utile JWT qui servent à configurer le compte IMS.

Création d’une connexion au compte de service (JWT)

Dans Adobe Developer Console, les projets et les API sont configurés au niveau du client Brand Portal. La configuration d’une API crée une connexion au compte de service (JWT). Il existe deux méthodes pour configurer l’API : générer une paire de clés (clés privée et publique) ou télécharger une clé publique. Pour configurer AEM Assets avec Brand Portal, vous devez générer une clé publique (certificat) dans AEM Assets et créer des informations d’identification dans Adobe Developer Console en chargeant la clé publique. Ces informations d’identification sont requises pour configurer le compte IMS dans AEM Assets. Une fois le compte IMS configuré, vous pouvez configurer le service cloud Brand Portal dans AEM Assets.

Procédez comme suit pour générer les informations d’identification du compte de service et la charge utile JWT :

  1. Connectez-vous à Adobe Developer Console avec les privilèges d’administrateur système sur l’organisation IMS (client Brand Portal). L’URL par défaut est https://www.adobe.com/go/devs_console_ui_fr.

    REMARQUE

    Assurez-vous d’avoir sélectionné l’organisation IMS appropriée (client Brand Portal) dans la liste déroulante (liste d’organisations) située dans l’angle supérieur droit.

  2. Cliquez sur Create new project (Créer un projet). Un projet vierge portant un nom généré par le système est créé pour votre organisation.

    Cliquez sur Edit project (Modifier le projet) pour mettre à jour le Project Title (Titre du projet) et la Description, puis cliquez sur Save (Enregistrer).

  3. Dans l’onglet Project overview (Aperçu du projet), cliquez sur Add API (Ajouter une API).

  4. Dans la fenêtre Add API (Ajouter une API), sélectionnez AEM Brand Portal, puis cliquez sur Next (Suivant).

    Assurez-vous d’avoir accès au service AEM Brand Portal.

  5. Dans la fenêtre Configure API (Configurer l’API), cliquez sur Upload your public key (Charger votre clé publique). Cliquez ensuite sur Select a File (Sélectionner un fichier) et chargez la clé publique (fichier .crt) que vous avez téléchargé comme indiqué à la section Obtain public certificate (Obtention d’un certificat public).

    Cliquez sur Next (Suivant).

    Charger la clé publique

  6. Vérifiez la clé publique et cliquez sur Next (Suivant).

  7. Sélectionnez Assets Brand Portal comme profil de produit par défaut et cliquez sur Save configured API (Enregistrer l’API configurée).

    Sélectionner le profil de produit

  8. Une fois l’API configurée, vous êtes redirigé vers sa page d’aperçu. Dans le volet de navigation de gauche, sous Credentials (Informations d’identification), cliquez sur Service Account (JWT) (Compte de service (JWT)).

    REMARQUE

    Vous pouvez voir les informations d’identification et effectuer des actions (générer des jetons JWT, copier les informations d’identification, récupérer le secret client, etc.).

  9. Dans l’onglet Client Credentials (Informations d’identification client), copiez l’ID client.

    Cliquez sur Retrieve Client Secret (Récupérer le secret client) et copiez le secret client.

    Informations d’identification du compte de service

  10. Accédez à l’onglet Generate JWT (Générer le jeton JWT) et copiez les informations JWT Payload (Charge utile JWT).

Vous pouvez maintenant utiliser l’ID client (clé API), le secret client et la charge utile JWT pour configurer le compte IMS dans AEM Assets.

Configuration du compte IMS

Vérifiez que vous avez effectué les étapes suivantes :

Effectuez les étapes suivantes pour configurer le compte IMS.

  1. Ouvrez la configuration IMS et accédez à l’onglet Compte. Vous avez maintenu la page ouverte lors de l’obtention du certificat public.

  2. Spécifiez un titre pour le compte IMS.

    Dans le champ Serveur d’autorisation, spécifiez l’adresse URL : https://ims-na1.adobelogin.com/

    Spécifiez l’ID client dans le champ Clé API, le Secret client et la Charge utile (charge utile JWT) que vous avez copiés lors de la création d’une connexion au compte de service (JWT).

    Cliquez sur Créer.

    Le compte IMS est configuré.

    Configuration du compte IMS

  3. Sélectionnez la configuration de compte IMS et cliquez sur Contrôle de l’intégrité.

    Cliquez sur Vérifier dans la boîte de dialogue. Une fois la configuration réussie, un message s’affiche avec la mention Jeton récupéré avec succès.

ATTENTION

Vous ne devez avoir qu’une seule configuration IMS.

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 configurer le service cloud Brand Portal, procédez comme suit :

  1. Connectez-vous à AEM Assets.

  2. Dans le panneau Outils, accédez à Cloud Services > AEM Brand Portal.

  3. Dans la page Configurations Brand Portal, cliquez sur Créer.

  4. Saisissez un titre pour la configuration.

    Sélectionnez la configuration IMS que vous avez créée lors de la configuration du compte IMS.

    Dans le champ URL du service, entrez l’adresse URL de votre client Brand Portal (organisation).

  5. Cliquez sur Enregistrer et fermer. La configuration cloud est alors créée.

    Votre instance AEM Assets as a Cloud Service est maintenant configurée avec le client Brand Portal.

Vous pouvez maintenant tester la configuration en vérifiant l’agent de distribution et en publiant les ressources sur le portail de marque.

Sur cette page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now