Configure AEM Assets as a Cloud Service with Brand Portal

La configuration de Adobe Experience Manager Assets Brand Portal permet de publier des fichiers de marque approuvés à partir de Adobe Experience Manager Assets en tant qu’instance de Cloud Service sur Brand Portal et de les distribuer aux utilisateurs du portail de marque.

Processus de configuration

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

  1. En 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. Sous le projet, configurez une API à l’aide de la clé publique pour créer une connexion au compte de service.
  4. Obtenez les informations d’identification du compte de service et les informations de charge utile JSON Web Token (JWT).
  5. En 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 du portail des marques à l’aide du compte IMS et du point de terminaison du portail des marques (URL de l’organisation).
  7. Testez votre configuration en publiant un fichier d’AEM Assets vers Brand Portal.
Remarque

Une AEM Assets en tant qu’instance Cloud Service ne doit être configurée qu’avec un seul client du portail de marques.

Conditions préalables

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

  • Une AEM Assets en cours d’exécution en tant qu’instance Cloud Service
  • URL du client du portail de marques
  • Utilisateur disposant de droits d’administrateur système sur l’organisation IMS du locataire du portail de marque

Création d’une configuration

Effectuez les étapes suivantes 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
  5. Test de la configuration

Création de la configuration IMS

La configuration IMS authentifie votre AEM Assets en tant qu’instance de Cloud Service auprès du locataire du portail de marques.

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. From the Tools panel, navigate to Security > Adobe IMS Configurations.

  3. Dans la page Configurations d’Adobe IMS, cliquez sur Créer. It will redirect to the Adobe IMS Technical Account Configuration page. Par défaut, l’onglet Certificat s’ouvre.

  4. Sélectionnez Portail de marque d’Adobe dans la liste déroulante Solution ​Cloud.

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

  6. Cliquez sur Créer un certificat. Then, click OK to generate the public key.

    Création d’un certificat

  7. Click the Download Public Key icon and save the public key (.crt) file on your machine.

    La clé publique sera 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 IMS Adobe 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 (organisation) du portail de la marque. 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 téléchargeant la clé publique. Ces informations d’identification sont requises pour configurer le compte IMS en AEM Assets. Une fois le compte IMS configuré, vous pouvez configurer le service cloud du portail de marque en 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 (locataire du portail de marque) dans la liste de liste déroulante (organisation) située dans l’angle supérieur droit.

  2. Cliquez sur Créer un projet. Un projet vierge portant un nom généré par le système est créé pour votre entreprise.

    Cliquez sur Modifier le projet pour mettre à jour le Titre du projet et la Description, puis cliquez sur Enregistrer.

  3. In the Project overview tab, click Add API.

  4. In the Add an API window, select AEM Brand Portal and click Next.

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

  5. In the Configure API window, click Upload your public key. Then, click Select a File and upload the public key (.crt file) that you have downloaded in the obtain public certificate section.

    Cliquez sur Suivant.

    Charger la clé publique

  6. Verify the public key and click Next.

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

    Sélectionner le profil de produit

  8. Une fois l’API configurée, vous êtes redirigé vers la page d’aperçu de l’API. From the left navigation under Credentials, click on the Service Account (JWT) option.

    Remarque

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

  9. Dans l’onglet Informations d’identification client, copiez l’ID client.

    Cliquez sur Récupérer le secret client et copiez le secret client.

    Informations d’identification du compte de service

  10. Navigate to the Generate JWT tab and copy the JWT Payload information.

You can now use the client ID (API key), client secret, and JWT payload to configure the IMS account in 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. Open the IMS Configuration and navigate to the Account tab. You kept the page open while obtaining the public certificate.

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

    In the Authorization Server field, specify the URL: https://ims-na1.adobelogin.com/

    Specify client ID in the API key field, Client Secret, and Payload (JWT payload) that you have copied while creating the service account (JWT) connection.

    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. From the Tools panel, navigate to Cloud Services > AEM Brand Portal.

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

  4. Saisissez un titre pour la configuration.

    Select the IMS configuration that you created while configuring the IMS account.

    In the Service URL field, specify your Brand Portal tenant (organization) URL.

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

    Votre AEM Assets en tant qu’instance de Cloud Service est maintenant configurée avec le client du portail de marques.

Test de la configuration

Pour valider la configuration, procédez comme suit :

  1. Connectez-vous à AEM Assets.

  2. From the Tools panel, navigate to Deployment > Distribution.

    A Brand Portal distribution agent (bpdistributionagent0) is created under Publish to Brand Portal.

  3. Cliquez sur Publier sur le portail des marques pour ouvrir l'agent de distribution.

    Vous pouvez voir les files d'attente de distribution sous l'onglet Etat .

    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 en tant que Cloud Service et le portail de marque, cliquez sur l’icône Tester la connexion .

    Un message s’affiche indiquant que votre package de test est livré avec succès.

    Remarque

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

Vous pouvez maintenant :

See Brand Portal documentation for more information.

Journaux de distribution

Vous pouvez surveiller les journaux de l’agent de distribution pour le processus de publication des ressources.

Par exemple, nous avons publié une ressource d’AEM Assets sur Brand Portal pour valider la configuration.

  1. Suivez les étapes (1 à 4), comme indiqué dans la section Test de la configuration, puis accédez à la page de l’agent de distribution.

  2. Cliquez sur Journaux pour vue des journaux de traitement et d’erreurs.

L'agent de distribution a généré 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 (Demande 3) : Le système déclenche une autre demande de publication du dossier AEM Assets (dans lequel la ressource existe) et répliquera le dossier dans le portail de marques.

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épliquera le dossier AEM Assets (contenant le fichier) 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 pu trouver le dossier parent (chemin d’accès à l’Ajoute) dans Brand Portal car la ressource a été publiée pour la première fois. Par conséquent, il a déclenché une demande supplémentaire pour créer un dossier parent portant le même nom dans Brand Portal où la ressource est publiée.

Remarque

Une requête supplémentaire est générée au cas où le dossier parent n’existerait pas dans le portail de la marque ou aurait été modifié en AEM Assets.

Sur cette page