Show Menu
SUJETS×

Configuration d’AEM Assets avec Brand Portal

Le portail Marque des ressources Adobe Experience Manager Assets vous permet de publier des ressources de marque approuvées depuis Adobe Experience Manager Assets sur le portail des marques et de les distribuer aux utilisateurs du portail des marques.
AEM Assets est configuré avec Brand Portal via Adobe Developer Console, qui fournit un jeton de compte IMS (Adobe Identity Management Services) pour l’autorisation du locataire du portail Marque.
La configuration de AEM Assets avec Brand Portal via Adobe Developer Console est prise en charge sur AEM 6.5.4.0 et versions ultérieures.
Auparavant, le portail de marque avait été configuré via la passerelle OAuth héritée, qui utilise l’échange JSON Web Token (JWT) pour obtenir un Jeton d'accès IMS pour l’autorisation.
La configuration via la passerelle OAuth héritée n’est plus prise en charge à partir du 6 avril 2020 et est remplacée par Adobe Developer Console.
Pour les clients existants uniquement
Il est recommandé de continuer à utiliser la configuration héritée de la passerelle OAuth. Si vous rencontrez des problèmes avec la configuration héritée de la passerelle OAuth, supprimez la configuration existante et créez une nouvelle configuration via Adobe Developer Console.
Cette aide décrit les deux cas d’utilisation suivants :
  • Nouvelle configuration : Si vous êtes un nouvel utilisateur du portail Marques et souhaitez configurer votre instance d’auteur AEM Assets avec Brand Portal, vous pouvez créer une configuration via Adobe Developer Console.
  • Configuration de la mise à niveau : Si vous êtes un utilisateur existant du portail de marques ayant une configuration sur la passerelle OAuth héritée, supprimez la configuration existante et créez une nouvelle configuration via Adobe Developer Console.
Cette aide s’adresse à un public familiarisé avec les technologies suivantes :
  • Installation, configuration et administration des packages Adobe Experience Manager et AEM.
  • Utilisation de 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 du portail de marques
  • Utilisateur disposant de droits d’administrateur système sur l’organisation IMS du locataire du portail de marque

Téléchargement et installation de 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 pack AEM ou Service Pack.

Création d’une configuration

La configuration d’AEM Assets avec Brand Portal nécessite des configurations à la fois dans l’instance d’auteur AEM Assets et dans la console de développement Adobe.
  1. En AEM Assets, créez un compte IMS et générez un certificat public (clé publique).
  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 (JWT).
  4. Obtenez les informations d’identification du compte de service et les informations de charge utile 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.
Une instance d’auteur AEM Assets ne doit être configurée qu’avec un seul client du portail de marques.
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 instance d’auteur AEM Assets 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 à votre instance d’auteur AEM Assets. L’URL par défaut est http://localhost:4502/aem/start.html .
  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 . 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.
  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.
  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 .
    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 .
  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.
  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.
    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 .
  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é.
  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 .
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 à votre instance d’auteur 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 créée lors de la configuration du compte IMS .
    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 instance d’auteur AEM Assets est maintenant configurée avec le client du portail de marque.

Test de la configuration

Pour valider la configuration, procédez comme suit :
  1. Connectez-vous à votre instance cloud AEM Assets.
  2. From the Tools panel, navigate to Deployment > Replication .
  3. Sur la page Réplication, cliquez sur Agents sur l’auteur .
    Vous pouvez voir les quatre agents de réplication créés pour votre locataire du portail de marque.
    Localisez les agents de réplication de votre locataire du portail de marque et cliquez sur l'URL de l'agent de réplication.
    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.
  4. To verify the connection between AEM Assets and Brand Portal, click on the Test Connection icon.
    Un message s’affiche indiquant que votre package de test est livré avec succès.
  5. Vérifiez les résultats du test sur les quatre agents de réplication.
    Evitez de désactiver l’un des agents de réplication, car cela peut entraîner l’échec de la réplication des actifs (en cours d’exécution).
    Assurez-vous que les quatre agents de réplication sont configurés pour éviter les erreurs de délai d’attente. See troubleshoot issues in parallel publishing to Brand Portal .
Vous pouvez maintenant :
See Brand Portal documentation for more information.

Mise à niveau de la configuration

Effectuez les étapes suivantes dans la séquence répertoriée pour mettre à niveau vos configurations existantes vers Adobe Developer Console :

Vérification des 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 l'état des tâches principales sur les quatre agents de réplication et vous assurer que les files d'attente sont inactives.
  1. Connectez-vous à votre instance d’auteur AEM Assets.
  2. From the Tools panel, navigate to Deployment > Deployment Replication .
  3. Sur la page Réplication, 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, qu'aucune tâche de publication n'est principale.

Supprimer les configurations existantes

Vous devez exécuter la liste de contrôle suivante lors de la suppression des configurations existantes :
  • Supprimer les quatre agents de réplication
  • Suppression du service cloud de Brand Portal
  • Supprimer un utilisateur MAC
  1. Connectez-vous à votre instance d’auteur AEM Assets et ouvrez CRX Lite en tant qu’administrateur. L’URL par défaut est 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 de Brand Portal et supprimez-la.
  4. Accédez à /home/users/mac l’utilisateur ​MAC de votre locataire du portail de marque et supprimez-le.
Vous pouvez désormais créer une configuration via Adobe Developer Console sur votre instance d’auteur AEM 6.5.