Configurer Experience Manager Assets avec Brand Portal configure-aem-assets-with-brand-portal
La configuration de Adobe Experience Manager Assets Brand Portal vous permet de publier des ressources de marque approuvées à partir de Adobe Experience Manager Assets as a Cloud Service à Brand Portal et distribuez-les aux utilisateurs de Brand Portal.
Activation de Brand Portal à l’aide de Cloud Manager activate-brand-portal
L’utilisateur ou l’utilisatrice de Cloud Manager active Brand Portal pour une instance Experience Manager Assets as a Cloud Service. Le workflow d’activation crée les configurations requises (jeton d’autorisation, configuration IMS et service cloud de Brand Portal) sur le serveur principal et reflète le statut du client ou de la cliente Brand Portal dans Cloud Manager. L’activation de Brand Portal permet aux utilisateurs et utilisatrices d’Experience Manager Assets de publier des ressources sur Brand Portal et de les distribuer aux utilisateurs et utilisatrices de Brand Portal.
Conditions préalables
Vous avez besoin des éléments suivants pour activer Brand Portal sur votre instance Experience Manager Assets as a Cloud Service :
- Une instance Experience Manager Assets as a Cloud Service opérationnelle.
- Utilisateur ayant accès à Cloud Manager, affecté aux Profils du produit Cloud Manager. Consultez Accès à Cloud Manager pour plus d’informations.
Étapes d’activation de Brand Portal
Vous pouvez activer Brand Portal au moment de la création des environnements de production pour votre instance Experience Manager Assets as a Cloud Service ou à un autre moment. Supposons que l’environnement a déjà été créé et que vous devez maintenant activer Brand Portal.
-
Connectez-vous à Adobe Cloud Manager et accédez à Environnements.
La page Environnements affiche la liste de tous les environnements existants.
-
Sélectionnez les environnements (un par un) de la liste pour afficher les détails de l’environnement.
Brand Portal a alloué à l’un des environnements disponibles et apparaît dans les Informations sur l’environnement.
Une fois que vous avez trouvé l’environnement associé à Brand Portal, cliquez sur le bouton Activer Brand Portal pour lancer le workflow d’activation.
-
L’activation du client Brand Portal prend quelques minutes car le processus d’activation crée les configurations requises sur le serveur principal. Une fois que le client Brand Portal est activé, son statut passe sur Activé.
org2-new
. Bien que la configuration manuelle du cloud sur org1-existing
soit visible dans l’instance de création Experience Manager Assets, elle n’est plus utilisée une fois Brand Portal activé à partir de Cloud Manager.Voir aussi :
Connexion à votre client Brand Portal :
Après l’activation de votre client Brand Portal dans Cloud Manager, vous pouvez vous connecter à Brand Portal à partir de l’Admin Console ou directement à l’aide de l’URL du client.
L’URL par défaut de votre client Brand Portal est : https://<tenant-id>.brand-portal.adobe.com/
.
dans lequel l’identifiant client est l’organisation IMS.
Suivez les étapes suivantes si vous n’êtes pas sûr de l’URL de Brand Portal :
-
Connectez-vous à l’Admin Console et accédez à Produits.
-
Dans le panneau de gauche, sélectionnez Adobe Experience Manager Brand Portal - Brand Portal.
-
Cliquez sur Accéder à Brand Portal pour ouvrir directement Brand Portal dans le navigateur.
Vous pouvez également copier l’URL du client Brand Portal à partir du lien Accéder à Brand Portal et la coller dans votre navigateur pour ouvrir l’interface de Brand Portal.
Test de la connexion
Suivez les étapes suivantes pour valider la connexion entre votre instance Experience Manager Assets as a Cloud Service et votre client Brand Portal :
-
Connectez-vous à Experience Manager Assets.
-
Dans le panneau Outils, accédez à Déploiement > Distribution.
Un agent de distribution Brand Portal (bpdistributionagent0) est créé sous Publier sur Brand Portal.
-
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é.
note note NOTE Il est recommandé d’examiner les erreurs et d’effacer régulièrement la file d’attente error-queue. -
-
Vérification de la connexion entre Experience Manager Assets as a Cloud Service et Brand Portal, cliquez sur le bouton Tester la connexion Icône
Un message s’affiche indiquant que votre package de test a bien été livré.
note note NOTE É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 instance Experience Manager Assets as a Cloud Service et le client Brand Portal, publiez une ressource d’Experience Manager Assets vers Brand Portal. Si la connexion est établie, la ressource publiée est visible dans l’interface de Brand Portal.
Vous pouvez maintenant effectuer les tâches suivantes :
- Publier des ressources d’Experience Manager Assets vers Brand Portal.
- Publier des dossiers d’Experience Manager Assets vers Brand Portal.
- Publier des collections d’Experience Manager Assets vers Brand Portal.
- Publication de ressources de Brand Portal vers Experience Manager Assets - Approvisionnement de ressources dans Brand Portal
- Publication de paramètres prédéfinis, de schémas et de facettes sur Brand Portal
- Publication de balises sur Brand Portal
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 une ressource d’Experience Manager Assets vers Brand Portal et examinons les journaux.
-
Suivez les étapes (1 à 4), comme indiqué dans la section Test de la connexion, puis accédez à la page de l’agent de distribution.
-
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 Experience Manager 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 Experience Manager 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.
Outre le workflow d’automatisation de l’activation de Brand Portal sur Experience Manager Assets as a Cloud Service, il existe une autre méthode permettant de configurer manuellement Experience Manager Assets as a Cloud Service avec Brand Portal à l’aide d’Adobe Developer Console, mais elle n’est plus recommandée.
Configuration manuelle à l’aide d’Adobe Developer Console manual-configuration
La section suivante décrit comment configurer manuellement Experience Manager Assets as a Cloud Service avec Brand Portal à l’aide d’Adobe Developer Console.
Auparavant, Experience Manager Assets as a Cloud Service était configuré manuellement avec Brand Portal par le biais d’Adobe Developer Console, qui fournissait un jeton de compte Identity Management Services (IMS) Adobe pour l’autorisation du client Brand Portal. Cela nécessite des configurations à la fois dans Experience Manager Assets et dans l’Adobe Developer Console.
- Dans Experience Manager Assets, créez un compte IMS et générez une clé publique (certificat).
- Dans Adobe Developer Console, créez un projet pour votre client Brand Portal (organisation).
- Dans le projet, configurez une API à l’aide de la clé publique pour créer une connexion au compte de service.
- Procurez-vous les informations d’identification du compte de service et les informations de charge utile JSON Web Token (JWT).
- Dans Experience Manager Assets, configurez le compte IMS à l’aide des informations d’identification du compte de service et de la payload JWT.
- Dans Experience Manager Assets, configurez le service cloud Brand Portal à l’aide du compte IMS et du point d’entrée Brand Portal (URL de l’organisation).
- Testez votre configuration en publiant une ressource d’Experience Manager Assets sur Brand Portal.
Conditions préalables
Pour configurer Experience Manager Assets avec Brand Portal, vous devez disposer des éléments suivants :
- Une instance Experience Manager 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 create-new-configuration
Procédez comme suit dans la séquence spécifiée pour configurer Experience Manager Assets avec Brand Portal.
Création de la configuration IMS create-ims-configuration
La configuration IMS authentifie votre instance Experience Manager Assets as a Cloud Service 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.
-
Connectez-vous à Experience Manager Assets.
-
Dans le panneau Outils, accédez à Sécurité > Configurations d’Adobe IMS.
-
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.
-
Sélectionner Adobe Brand Portal dans le Solution cloud liste déroulante.
-
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.
-
Cliquez sur Créer un certificat. Cliquez sur OK pour générer la clé publique.
-
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 les informations d’identification de compte de service dans la console Adobe Developer.
-
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éer une 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. 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 Experience Manager Assets avec Brand Portal, vous devez générer une clé publique (certificat) dans Experience Manager 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 dans Experience Manager Assets. Une fois le compte IMS configuré, vous pouvez configurer le service cloud Brand Portal dans Experience Manager Assets.
Procédez comme suit pour générer les informations d’identification du compte de service et la payload JWT :
-
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 (organisation) située dans le coin supérieur droit. -
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).
-
Dans l’onglet Project overview (Aperçu du projet), cliquez sur Add API (Ajouter une API).
-
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 Experience Manager Brand Portal.
-
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).
-
Vérifiez la clé publique et cliquez sur Next (Suivant).
-
Sélectionnez Assets Brand Portal comme profil de produit par défaut et cliquez sur Save configured API (Enregistrer l’API configurée).
-
Après la configuration de l’API, vous êtes redirigé vers sa page d’aperçu. Dans la navigation de gauche sous Informations d’identification, cliquez sur le Compte de service (JWT) .
note note NOTE 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.). -
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.
-
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 payload JWT pour configurer le compte IMS dans Experience Manager Assets.
Configuration du compte IMS create-ims-account-configuration
Vérifiez que vous avez effectué les étapes suivantes :
Effectuez les étapes suivantes pour configurer le compte IMS.
-
Ouvrez la configuration IMS et accédez à l’onglet Compte. Vous avez maintenu la page ouverte lors de l’obtention du certificat public.
-
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é.
-
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.
Configuration du service cloud configure-the-cloud-service
Pour configurer le service cloud Brand Portal, procédez comme suit :
-
Connectez-vous à Experience Manager Assets.
-
Dans le panneau Outils, accédez à Cloud Services > AEM Brand Portal.
-
Dans la page Configurations Brand Portal, cliquez sur Créer.
-
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).
-
Cliquez sur Enregistrer et fermer. La configuration cloud est alors créée.
Votre instance Experience Manager 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 Brand Portal.
Placer sur la liste autorisée les adresses IP sortantes dans SPS si l’aperçu sécurisé est activé
En cas d’utilisation de Dynamic Media-Scene7 (avec l’aperçu sécurisé activé pour une entreprise), il est conseillé à l’administrateur ou à l’administratrice Scene7 de l’entreprise de placer sur la liste autorisée les adresses IP publiques sortantes pour les régions respectives à l’aide de l’IU flash SPS (système de publication Scene7).
Les adresses IP sortantes sont les suivantes :
Voir également
- Traduire les ressources
- API HTTP Assets
- Formats de fichiers pris en charge par Assets
- Rechercher des ressources
- Ressources connectées
- Rapports de ressources
- Schémas de métadonnées
- Télécharger des ressources
- Gestion des métadonnées
- Facettes de recherche
- Gérer les collections
- Import des métadonnées en bloc