DocumentationAEM 6.4Guide d’Assets

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

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Admin
CAUTION
AEM 6.4 a atteint la fin de la prise en charge étendue et cette documentation n’est plus mise à jour. Pour plus d’informations, voir notre période de support technique. Rechercher les versions prises en charge here.

Adobe Experience Manager Assets est configuré avec Brand Portal via Adobe I/O, qui fournit un jeton IMS pour autoriser votre client Brand Portal.

NOTE
Configuration d’AEM Assets avec Brand Portal via Adobe I/O est pris en charge sur AEM 6.4.8.0 et versions ultérieures.
Auparavant, Brand Portal était configuré dans l’interface utilisateur classique via la passerelle OAuth héritée, qui fait appel à l’échange de jetons JWT pour obtenir un jeton d’accès IMS en vue de l’autorisation.
TIP
Pour les clients existants uniquement
Il est recommandé de continuer à utiliser la configuration de la passerelle OAuth héritée. Si vous rencontrez des problèmes avec la configuration héritée de la passerelle OAuth, supprimez la configuration existante et créez une configuration via Adobe I/O.

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

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

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 Windows Linux et Microsoft

Prérequis prerequisites

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

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

Téléchargement et installation d’AEM 6.4 aemquickstart

Il est recommandé d’utiliser AEM 6.4 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 pack de services AEM servicepack

Pour obtenir des instructions détaillées, consultez

Contacter le service clientèle si vous ne parvenez pas à trouver le dernier package AEM ou le Service Pack.

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

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

  1. Obtention d’un certificat public
  2. Créer Adobe I/O integration
  3. Création d’une configuration de compte IMS
  4. Configuration du service cloud
  5. Test de la configuration
NOTE
Une instance auteur AEM Assets ne doit être configurée qu’avec un seul client Brand Portal.

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

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 public-certificate

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

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

  2. De Outils Outils , accédez à Sécurité " Configurations d’Adobe IMS.

    Interface utilisateur de configuration du compte Adobe IMS

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

    Cliquez sur Créer.

    Vous accédez alors au Configuration du compte technique Adobe IMS page.

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

    Dans Solution cloud, sélectionnez Adobe Brand Portal.

  5. Cocher la case Création d’un certificat et spécifiez une 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.

    Création d’un certificat

  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 create Adobe I/O integration.

    Téléchargement du certificat

  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 integration pour obtenir les détails d’intégration des configurations de compte IMS.

Créer Adobe I/O integration createnewintegration

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 à Adobe I/O Console avec des privilèges d’administrateur système sur l’organisation IMS du client Brand Portal.

    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.

    Création d’une intégration

  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.

    Création d’une intégration

  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.

    Clé API, secret client et informations de charge utile d’une intégration

  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 create-ims-account-configuration

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

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é API, le secret client et la charge utile JWT que vous avez copiés à la fin de Créer Adobe I/O integration.

    Cliquez sur Créer.

    L’intégration est créée.

    Configuration du compte IMS

  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.

CAUTION
Vous ne devez avoir qu’une seule configuration IMS. N’en créez pas plusieurs.
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 configure-the-cloud-service

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. De Outils Outils , accédez à Cloud Services " AEM Brand Portal.

    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 maintenant intégrée au client Brand Portal.

Test de la configuration test-integration

  1. Connexion à votre instance d’auteur AEM Assets

    URL par défaut : http://localhost:4502/aem/start.html

  2. De Outils Outils , accédez à Déploiement > Réplication.

  3. La page Réplication s’ouvre.

    Cliquez sur Agents sur l’auteur.

  4. Quatre agents de réplication sont créés pour chaque client.

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

    Cliquez sur l’URL de l’agent de réplication.

    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.

  5. Pour vérifier la connexion entre l’auteur AEM Assets et Brand Portal, cliquez sur Tester la connexion.

  6. Consultez le bas des résultats du test pour vérifier que la réplication a réussi.

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

    note note
    NOTE
    Évitez de désactiver les agents 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 toute erreur de délai d’expiration. Consultez Dépannage des problèmes de publication en parallèle sur Brand Portal.

Brand Portal est correctement configuré avec votre instance d’auteur AEM Assets. Vous pouvez maintenant effectuer les tâches suivantes :

Mise à niveau de la configuration upgrade-integration-64

Effectuez les étapes suivantes dans l’ordre indiqué pour mettre à niveau les configurations existantes :

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

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 d’auteur AEM Assets avant d’apporter des modifications. Pour ce faire, 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. De Outils Outils , accédez à Déploiement > Réplication.

  3. La page Réplication s’ouvre.

    Cliquez sur Agents sur l’auteur.

  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, qu’aucune tâche de publication n’est active.

Suppression des configurations existantes delete-existing-configuration

Vous devez exécuter la liste de contrôle suivante lors de la suppression de la configuration existante.

  • Suppression des quatre agents de réplication
  • Suppression du service cloud
  • Suppression de l’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 client Brand Portal.

  3. Accédez à /etc/cloudservices/mediaportal et supprimez la variable Configuration du Cloud Service.

  4. Accédez à /home/users/mac et supprimez la variable Utilisateur Mac de votre client Brand Portal.

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 :

recommendation-more-help
4452738f-2bdf-4cd4-9b45-905a69d607ad