Show Menu
TEMAS×

Configurar AEM Assets con Brand Portal

Recursos Adobe Experience Manager (AEM) se configura con Brand Portal a través de Adobe Developer Console, que proporciona un distintivo IMS para la autorización del inquilino de Brand Portal.
La configuración de AEM Assets con Brand Portal mediante Adobe Developer Console es compatible con AEM 6.5.4.0 y versiones posteriores.
Anteriormente, Brand Portal se configuraba en la IU clásica mediante OAuth Gateway heredado, que utiliza el intercambio de tokens JWT para obtener un Token de acceso IMS para la autorización.
La configuración mediante OAuth heredado ya no se admite a partir del 6 de abril de 2020 y se cambia a la configuración mediante Adobe Developer Console.
Solo para clientes existentes
Se recomienda seguir utilizando la configuración heredada de OAuth Gateway. En caso de que surjan problemas con la configuración heredada de OAuth Gateway, elimine la configuración existente y cree una nueva configuración mediante Adobe Developer Console.
Esta ayuda describe los dos casos de uso siguientes:
  • Nueva configuración : Si es un usuario nuevo de Brand Portal y desea configurar su instancia de autor de AEM Assets con Brand Portal, puede crear una nueva configuración en Adobe Developer Console.
  • Configuración de actualización: Si ya es un usuario de Brand Portal con su instancia de autor de Recursos AEM configurada con Brand Portal en OAuth Gateway heredado, se recomienda eliminar las configuraciones existentes y crear una nueva configuración en Adobe Developer Console.
La información proporcionada se basa en el supuesto de que cualquiera que lea esta Ayuda está familiarizado con las siguientes tecnologías:
  • Instalación, configuración y administración de paquetes de Adobe Experience Manager y AEM
  • Uso de sistemas operativos Linux y Microsoft Windows

Requisitos previos

Para configurar AEM Assets con Brand Portal, es necesario lo siguiente:
  • Una instancia de creación de Recursos AEM activa y en ejecución con el último Service Pack.
  • URL del inquilino de Brand Portal.
  • Un usuario con privilegios de administrador del sistema en la organización IMS del inquilino de Brand Portal.

Descargar e instalar AEM 6.5

Se recomienda disponer de AEM 6.5 para configurar una instancia de creación de AEM. Si AEM no está en funcionamiento, descárguelo de las siguientes ubicaciones:
Después de descargar AEM, para obtener instrucciones sobre cómo configurar una instancia de autor de AEM, consulte Implementación y mantenimiento .

Descargar e instalar AEM Service Pack más reciente

Para obtener instrucciones detalladas, consulte
Póngase en contacto con el Servicio de atención al cliente si no puede encontrar el paquete de AEM o Service Pack más recientes.

Crear configuración

La configuración de Recursos AEM con Brand Portal requiere configuraciones tanto en la instancia de creación de Recursos AEM como en Adobe Developer Console.
  1. En la instancia de creación de Recursos AEM, cree una cuenta IMS y genere un certificado público (clave pública).
  2. En Adobe Developer Console, cree un proyecto para el inquilino (organización) de Brand Portal.
  3. En el proyecto, configure una API con la clave pública para crear una conexión de cuenta de servicio (JWT).
  4. Obtenga las credenciales de la cuenta de servicio y la información de carga útil de JWT.
  5. En la instancia de creación de Recursos AEM, configure la cuenta IMS con las credenciales de cuenta de servicio y la carga útil JWT.
  6. En la instancia de creación de Recursos AEM, configure el servicio en la nube de Brand Portal mediante la cuenta IMS y el extremo de Brand Portal (dirección URL de la organización).
  7. Pruebe la configuración publicando un recurso de la instancia de creación de Recursos AEM en Brand Portal.
Un inquilino de Brand Portal solo se configurará con una instancia de autor de AEM Assets.
No configure un inquilino de Brand Portal con varias instancias de autor de Recursos AEM.
Realice los siguientes pasos en la secuencia mostrada si va a configurar Recursos AEM con Brand Portal por primera vez:

Crear la configuración de IMS

La configuración de IMS autentica el inquilino de Brand Portal con la instancia de creación de AEM Assets.
La configuración de IMS incluye dos pasos:

Obtener un certificado público

El certificado público le permite autenticar su perfil en Adobe Developer Console.
  1. Inicie sesión en la instancia de creación de Recursos AEM. La dirección URL predeterminada es http:// localhost:4502/aem/start.html
  2. From the Tools panel, navigate to Security > Adobe IMS Configurations .
  3. En la página Configuraciones de Adobe IMS, haga clic en Crear .
  4. Se le redirige a la página de configuración de la cuenta técnica de Adobe IMS. By default, the Certificate tab opens.
    Seleccione la solución de nube Adobe Brand Portal .
  5. Marque la casilla de verificación Crear nuevo certificado y especifique un alias para el certificado. El alias sirve como nombre del cuadro de diálogo.
  6. Haga clic en Crear certificado . A continuación, haga clic en Aceptar en el cuadro de diálogo para generar el certificado público.
  7. Click Download Public Key and save the certificate (.crt) file on your machine.
    El archivo de certificado se utilizará en pasos adicionales para configurar la API para el inquilino de Brand Portal y generar credenciales de cuenta de servicio en Adobe Developer Console.
  8. Haga clic en Siguiente .
    En la ficha Cuenta , cree la cuenta de Adobe IMS, pero para ello necesitará las credenciales de cuenta de servicio que se generan en Adobe Developer Console. Mantenga esta página abierta por ahora.
    Abra una nueva ficha y cree una conexión de cuenta de servicio (JWT) en Adobe Developer Console para obtener las credenciales y la carga útil JWT para configurar la cuenta de IMS.

Crear conexión de cuenta de servicio (JWT)

En Adobe Developer Console, los proyectos y las API se configuran en el nivel de organización (inquilino de Brand Portal). La configuración de una API crea una conexión de cuenta de servicio (JWT) en Adobe Developer Console. Existen dos métodos para configurar la API, mediante la generación de un par de claves (claves privadas y públicas) o mediante la carga de una clave pública. Para configurar la instancia de creación de Recursos AEM con Brand Portal, debe generar un certificado público (clave pública) en la instancia de creación de Recursos AEM y crear credenciales en Adobe Developer Console cargando la clave pública. Esta clave pública se utiliza para configurar la API para la organización de Brand Portal seleccionada y genera las credenciales y la carga útil JWT para la cuenta de servicio. Estas credenciales se utilizan además para configurar la cuenta de IMS en la instancia de creación de Recursos AEM. Una vez configurada la cuenta de IMS, puede configurar el servicio en la nube de Brand Portal en la instancia de creación de Recursos AEM.
Realice los siguientes pasos para generar las credenciales de cuenta de servicio y la carga útil JWT:
  1. Inicie sesión en Adobe Developer Console con privilegios de administrador del sistema en la organización de IMS (inquilino de Brand Portal). La dirección URL predeterminada es
    Asegúrese de seleccionar la organización de IMS correcta (inquilino de Brand Portal) en el menú desplegable (lista de la organización) situado en la esquina superior derecha.
  2. Click Create new project . Se crea un proyecto en blanco para su organización.
    Haga clic en Editar proyecto para actualizar el título y la descripción del proyecto y, a continuación, haga clic en Guardar .
  3. En la ficha Información general del proyecto, haga clic en Añadir API .
  4. En la ventana Añadir una API, seleccione AEM Brand Portal y haga clic en Siguiente .
    Asegúrese de tener acceso al servicio AEM Brand Portal.
  5. En la ventana Configurar API, haga clic en Cargar la clave pública. A continuación, haga clic en Seleccionar un archivo y cargue el certificado público (archivo .crt) que ha descargado en la sección Obtener certificado público.
    Haga clic en Siguiente .
  6. Compruebe el certificado público y haga clic en Siguiente .
  7. Seleccione el producto predeterminado perfil Assets Brand Portal y haga clic en Guardar configuración .
  8. Con la API configurada, se le redirige a la información general de la API. En el panel de navegación izquierdo, en Credenciales , haga clic en Cuenta de servicio (JWT) .
    Puede vista de las credenciales y realizar otras acciones (generar tokens JWT, copiar detalles de credenciales, recuperar el secreto del cliente, etc.) según sea necesario.
  9. En la ficha Credenciales de cliente, copie el ID de cliente.
    Click Retrieve Client Secret and copy the client secret .
  10. Navigate to the Generate JWT tab and copy the JWT Payload .
Ahora puede utilizar el ID de cliente (clave de API), el secreto de cliente y la carga útil JWT para configurar la cuenta IMS en la instancia de nube de AEM Assets.

Crear la configuración de cuenta IMS

Asegúrese de haber realizado los siguientes pasos:
Realice los siguientes pasos para configurar la cuenta de IMS que ha creado para obtener un certificado público.
  1. Abra la Configuración de IMS y vaya a la ficha Cuentas . Mantuvo la página abierta mientras obtenía un certificado público.
  2. Especifique un Título para la cuenta de IMS.
    En Servidor de autorización , introduzca la dirección URL: https://ims-na1.adobelogin.com/
    Pegue el ID de cliente en la clave de API, el secreto de cliente y la carga útil JWT que ha copiado al crear la conexión de cuenta de servicio (JWT).
    Haga clic en Crear .
    La cuenta de IMS está configurada.
  3. Seleccione la configuración de IMS y haga clic en Comprobar estado .
    Haga clic en Proteger en el cuadro de diálogo. Si la configuración es correcta, aparece un mensaje que indica que el token se recupera correctamente .
Sólo debe tener una configuración de IMS. No cree varias configuraciones de IMS.
Asegúrese de que la configuración de IMS pase la comprobación de estado. Si la configuración no pasa la comprobación de estado, no es válida. Debe eliminarla y crear una configuración nueva y válida.

Configurar el servicio en la nube

Siga estos pasos para crear el servicio en la nube de Brand Portal:
  1. Inicie sesión en la instancia de creación de Recursos AEM.
  2. From the Tools panel, navigate to Cloud Services > AEM Brand Portal .
  3. En la página Configuraciones de Brand Portal, haga clic en Crear .
  4. Especifique un Título para la configuración.
    Seleccione la configuración de IMS que ha creado al configurar la cuenta de IMS.
    In the Service URL , enter your Brand Portal tenant (organization) URL.
  5. Haga clic en Guardar y cerrar . Se crea la configuración de nube. La instancia de creación de Recursos AEM ahora está configurada con el inquilino de Brand Portal.

Probar la configuración

Realice los siguientes pasos para validar la configuración:
  1. Inicie sesión en la instancia de nube de AEM Assets.
  2. From the Tools panel, navigate to Deployment > Replication .
  3. En la página Replicación, haga clic en Agentes en el autor .
  4. Se crean cuatro agentes de replicación para cada inquilino.
    Busque los agentes de replicación del inquilino de Brand Portal.
    Haga clic en la dirección URL del agente de replicación.
    Los agentes de replicación trabajan en paralelo y comparten la distribución del trabajo por igual, aumentando así la velocidad de publicación en cuatro veces la velocidad original. Una vez configurado el servicio en la nube, no se requiere una configuración adicional para habilitar los agentes de replicación activados de forma predeterminada para habilitar la publicación en paralelo de varios recursos.
  5. Para comprobar la conexión entre AEM Assets y Brand Portal, haga clic en Probar conexión .
    Aparece un mensaje en la parte inferior de la página que indica que el paquete de prueba se entregó correctamente.
  6. Compruebe los resultados de la prueba en los cuatro agentes de replicación uno por uno.
    Evite desactivar cualquiera de los agentes de replicación, ya que puede provocar errores en la replicación de algunos de los recursos.
La instancia de creación de AEM Assets se ha configurado correctamente con Brand Portal y ahora puede:

Configuración de actualización

Realice los siguientes pasos en la secuencia indicada para actualizar las configuraciones existentes:

Verificar trabajos en ejecución

Asegúrese de que no se esté ejecutando ningún trabajo de publicación en la instancia de creación de Recursos AEM antes de realizar ninguna modificación. Para ello, puede verificar los cuatro agentes de replicación y asegurarse de que la cola sea ideal o esté vacía.
  1. Inicie sesión en la instancia de creación de Recursos AEM.
  2. En el panel Herramientas , vaya a Implementación > Replicación de implementación .
  3. En la página Replicación, haga clic en Agentes en el autor .
  4. Busque los agentes de replicación del inquilino de Brand Portal.
    Asegúrese de que la cola esté inactiva para todos los agentes de replicación y de que no haya ningún trabajo de publicación activo.

Eliminar configuraciones existentes

Debe ejecutar la siguiente lista de comprobación mientras elimina las configuraciones existentes.
  • Eliminar los cuatro agentes de replicación
  • Eliminar servicio de nube
  • Eliminar usuario de MAC
  1. Inicie sesión en la instancia de creación de Recursos AEM y abra CRX Lite como administrador. La dirección URL predeterminada es
    http:// localhost:4502/crx/de/index.jsp
  2. Navegue hasta los cuatro agentes de replicación del inquilino de Brand Portal /etc/replications/agents.author y elimínelos.
  3. Vaya a /etc/cloudservices/mediaportal y elimine la configuración del servicio de nube.
  4. Navegue hasta /home/users/mac y elimine el usuario ​MAC del inquilino de Brand Portal.
Ahora puede crear la configuración en la instancia de creación de AEM 6.5.
Después de que la replicación se realice correctamente, puede publicar recursos, carpetas y colecciones en Brand Portal. Para obtener más información, consulte: