Configuration d’AEM Assets avec Brand Portal configure-integration-65

Version
Lien de l’article
AEM as a Cloud Service
Cliquez ici
AEM 6.5
Cet article

Adobe Experience Manager Assets Brand Portal permet de publier des ressources de marque approuvées d’Adobe Experience Manager Assets vers Brand Portal et de les distribuer aux utilisateurs et utilisatrices de Brand Portal.

AEM Assets est configuré avec Brand Portal via la console Adobe Developer, qui fournit un jeton de compte Adobe Identity Management Services (IMS) pour l’autorisation du client Brand Portal.

NOTE
La configuration d’AEM Assets avec Brand Portal via la console Adobe Developer est prise en charge sur AEM 6.5.4.0 et les versions ultérieures.
Auparavant, Brand Portal était configuré dans l’interface classique via la passerelle OAuth héritée, qui fait appel à l’échange de jetons d’accès Web JSON (JWT) pour obtenir un jeton 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 la console Adobe Developer.
TIP
Pour les clients existants uniquement
Adobe vous recommande de continuer à utiliser l’ancienne configuration de la passerelle OAuth. Si vous rencontrez des problèmes avec l’ancienne configuration de la passerelle OAuth, supprimez la configuration existante et créez une configuration à l’aide d’Adobe Developer Console.

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

  • Nouvelle configuration : si vous êtes un nouvel utilisateur ou une nouvelle utilisatrice de Brand Portal et que vous souhaitez configurer votre instance de création 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 ou une utilisatrice de Brand Portal disposant d’une configuration sur l’ancienne passerelle OAuth, supprimez la configuration existante et créez une 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 des systèmes d’exploitation Linux® et Microsoft® Windows.

Prérequis prerequisites

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

  • une instance de création AEM Assets en cours d’exécution avec le dernier pack de services ;
  • Une adresse URL du client Brand Portal
  • Un utilisateur disposant de droits d’administrateur système sur l’organisation IMS du client Brand Portal

Télécharger et installer AEM 6.5

Télécharger et installer le dernier pack de services AEM

Télécharger et installer AEM 6.5 aemquickstart

Il est recommandé d’utiliser AEM 6.5 pour configurer une instance de création 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 de création AEM.

Télécharger et installer le dernier pack de services AEM servicepack

Pour obtenir des instructions détaillées, reportez-vous à la section Notes de mise à jour du pack de services AEM 6.5.

Contactez le service clientèle d’Adobe si vous ne trouvez pas le dernier package ou le pack de services AEM.

Création d’une configuration configure-new-integration-65

La configuration d’AEM Assets avec Brand Portal nécessite des configurations à la fois dans l’instance de création AEM Assets et dans Adobe Developer Console.

  1. Dans 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. 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.
NOTE
Une instance de création AEM Assets ne doit être configurée qu’avec un seul client Brand Portal.

Effectuez les étapes suivantes dans l’ordre indiqué si vous configurez AEM Assets avec Brand Portal pour la première fois :

Création de la configuration IMS create-ims-configuration

La configuration IMS authentifie votre instance de création AEM Assets auprès du client Brand Portal.

La configuration IMS comprend deux étapes :

Obtention d’un certificat public public-certificate

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

  1. Connectez-vous à votre instance de création AEM Assets. L’URL par défaut est http://localhost:4502/aem/start.html.

  2. Dans les Outils du 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 Brand Portal et générer des informations d’identification de compte de service dans Adobe Developer Console.

    Téléchargement du certificat

  8. Cliquez sur Suivant.

    Dans l’onglet Compte, un compte Adobe IMS est créé, lequel 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 payload JWT qui servent à configurer le compte IMS.

Création de la connexion au compte de service (JWT) createnewintegration

Dans Adobe Developer Console, les projets et les API sont configurés au niveau du client Brand Portal (organisation). 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 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.

Pour créer les informations d’identification du compte de service et la payload JWT, procédez comme suit :

  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.

    note note
    NOTE
    Assurez-vous d’avoir sélectionné l’organisation IMS appropriée (client Brand Portal) dans la liste déroulante (liste d’organisations) en haut à droite.
  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 Modifier le projet pour mettre à jour le Titre du projet et la Description, puis cliquez sur 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. Après la configuration de l’API, vous êtes redirigé vers sa page d’aperçu. Dans la navigation de gauche, sous Identifiants, cliquez sur Compte de service (JWT).

    note note
    NOTE
    Vous pouvez alors afficher les identifiants et effectuer des actions telles que la génération des jetons JWT, la copie des informations d’identification et la récupération du secret client.
  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 create-ims-account-configuration

Vérifiez que vous avez déjà effectué les étapes suivantes :

Pour configurer le compte IMS, procédez comme suit :

  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 Serveur d’autorisation , indiquez l’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.

    Boîte de dialogue de confirmation de configuration saine

CAUTION
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. Supprimez-la et créez une autre configuration valide.

Configuration du service cloud Brand Portal configure-the-cloud-service

  1. Connectez-vous à votre instance de création AEM Assets.

  2. Dans le panneau Outils 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.

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

    Fenêtre de configuration Brand Portal

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

    Votre instance de création AEM Assets est maintenant configurée avec le client Brand Portal.

Test et validation de la configuration test-integration

  1. Connectez-vous à votre instance cloud AEM Assets.

  2. Dans les Outils du panneau Outils , accédez à Déploiement  > Réplication.

    Panneau Outils

  3. Sur la page Réplication, cliquez sur Agents sur l’auteur.

    Page Réplication

    Vous voyez les quatre agents de réplication pour votre client Brand Portal.

    Recherchez les agents de réplication de votre client Brand Portal et cliquez sur l’URL de l’agent de réplication.

    Configuration de la réplication des ressources

    note note
    NOTE
    Les agents de réplication fonctionnent en parallèle et partagent la distribution des tâches à parts égales, ce qui multiplie par quatre la vitesse de publication par rapport à la vitesse d’origine. Une fois le service cloud configuré, aucune configuration supplémentaire n’est nécessaire pour activer les agents de réplication qui sont activés par défaut de façon à permettre la publication en parallèle de plusieurs ressources.
  4. Pour vérifier la connexion entre AEM Assets et Brand Portal, cliquez sur l’icône Tester la connexion.

    Vérification des paramètres de réplication des ressources

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

    Sortie de confirmation de test

  5. Vérifiez les résultats du test sur les quatre agents de réplication.

    note note
    NOTE
    Évitez de désactiver un agent de réplication car cela peut entraîner l’échec de la réplication de certaines ressources (en cours de traitement).
    Assurez-vous que les quatre agents de réplication sont configurés pour éviter toute erreur de délai d’expiration. Consultez Dépannage des problèmes de publication en parallèle sur Brand Portal.
    Ne modifiez aucun paramètre généré automatiquement.

Vous pouvez maintenant effectuer les tâches suivantes :

Pour plus d’informations, voir la documentation de Brand Portal.

Mise à niveau de la configuration upgrade-integration-65

Pour mettre à niveau vos configurations existantes vers Adobe Developer Console, procédez comme suit, dans l’ordre indiqué :

Vérification des tâches en cours verify-jobs

Assurez-vous qu’aucune tâche de publication n’est en cours d’exécution sur votre instance de création AEM Assets avant d’apporter des modifications. Pour ce faire, vous pouvez vérifier le statut 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 de création AEM Assets.

  2. Dans les Outils du panneau Outils , accédez à Déploiement  > Réplication du déploiement.

  3. Sur la page Réplication, cliquez sur Agents sur l’auteur.

    Agents de réplication pour les ressources

  4. Localisez les agents de réplication de votre client Brand Portal.

    Assurez-vous que La file d’attente est inactive pour tous les agents de réplication et qu’aucune tâche de publication n’est active.

    Paramètres de file d’attente de réplication

Suppression des configurations existantes delete-existing-configuration

Exécutez la liste de contrôle suivante avant de supprimer les configurations existantes :

  • Suppression des quatre agents de réplication
  • Suppression du service cloud Brand Portal
  • Suppression de l’utilisateur ou l’utilisatrice MAC
  1. Connectez-vous à votre instance de création AEM Assets et ouvrez CRX Lite en tant qu’administrateur ou administratrice. 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 client Brand Portal.

    Agent de réplication dans CRXDE

  3. Accédez à /etc/cloudservices/mediaportal et supprimez la configuration du service cloud Brand Portal.

    Détail de l’agent de réplication dans CRXDE

  4. Accédez à /home/users/mac et supprimez l’utilisateur Mac de votre client Brand Portal.

    Plus de détails sur l’agent de réplication dans CRXDE

Vous pouvez désormais créer une configuration au moyen d’Adobe Developer Console sur votre instance de création AEM 6.5.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2