Show Menu
TEMAS×

Configurar AEM Assets con Brand Portal

Adobe Experience Manager (AEM) Assets 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 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 Gateway heredado ya no se admite a partir del 6 de abril de 2020 y se cambia a 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 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 la instancia de autor de AEM Assets con Brand Portal, puede crear una configuración en Adobe Developer Console.
  • Configuración de actualización: Si ya es usuario de Brand Portal y la instancia de autor de AEM Assets está configurada con Brand Portal en OAuth Gateway heredada, elimine la configuración existente y cree 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 autor de AEM Assets activa y en ejecución con el último Service Pack.
  • Dirección 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 tener AEM 6.5 para configurar una instancia de autor AEM. Si no AEM en ejecución, descárguelo de las siguientes ubicaciones:
Después de descargar AEM, para obtener instrucciones sobre cómo configurar una instancia de AEM autor, consulte Implementación y mantenimiento .

Descargar e instalar AEM último Service Pack

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 AEM Assets con Brand Portal requiere configuraciones tanto en la instancia de creación de AEM Assets como en la consola de desarrollador de Adobe.
  1. En AEM Assets, 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 AEM Assets, configure la cuenta IMS con las credenciales de cuenta de servicio y la carga útil JWT.
  6. En AEM Assets, configure el servicio en la nube de Brand Portal con 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 AEM Assets en Brand Portal.
Una instancia de autor de AEM Assets solo se configurará con un inquilino de Brand Portal.
Realice los siguientes pasos en la secuencia mostrada si va a configurar AEM Assets 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 AEM Assets. 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 IMS de Adobe, haga clic en Crear .
  4. Se le redirige a la página de configuración de la cuenta técnica de IMS de Adobe. By default, the Certificate tab opens.
    Seleccione el portal de marcas de Adobe de la solución de nube.
  5. Mark the Create new certificate checkbox and specify an alias for the certificate. 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á más adelante para configurar la API para el inquilino de Brand Portal y generar las credenciales de cuenta de servicio en Adobe Developer Console.
  8. Haga clic en Siguiente .
    En la ficha Cuenta , se crea la cuenta IMS de Adobe, pero para ello necesitará las credenciales de cuenta de servicio que se generan en la Consola de programadores de Adobe. 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 inquilino (organización) de Brand Portal. La configuración de una API crea una conexión de cuenta de servicio (JWT) en la consola de desarrollador de Adobe. 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 AEM Assets con Brand Portal, debe generar un certificado público (clave pública) en AEM Assets y crear credenciales en Adobe Developer Console cargando la clave pública. Esta clave pública se utiliza para configurar la API para el inquilino de Brand Portal seleccionado 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 AEM Assets. Una vez configurada la cuenta de IMS, puede configurar el servicio en la nube de Brand Portal en AEM Assets.
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 la lista desplegable (organización) situada 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 portal de marca 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 portal de marca perfil Assets del producto predeterminado y haga clic en Guardar API configurada.
  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 AEM Assets.

Configurar cuenta de IMS

Asegúrese de haber realizado los siguientes pasos:
Realice los siguientes pasos para configurar la cuenta de IMS.
  1. Abra la Configuración de IMS y vaya a la ficha Cuenta . Mantuvo la página abierta mientras obtenía el 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 la clave de API (ID de cliente), Secreto de cliente y Carga útil (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. Select the IMS account configuration and click Check Health .
    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.
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 los pasos siguientes para configurar el servicio en la nube de Brand Portal:
  1. Inicie sesión en la instancia de creación de AEM Assets.
  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 autor de AEM Assets 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 AEM Assets Cloud.
  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 ha entregado correctamente.
  6. Compruebe los resultados de la prueba en los cuatro agentes de replicación.
    Evite deshabilitar cualquiera de los agentes de replicación. Puede provocar errores en la replicación de algunos de los recursos.
    Asegúrese de que los cuatro agentes de replicación estén configurados para evitar errores de tiempo de espera. See troubleshoot issues in parallel publishing to Brand Portal .
La instancia de autor 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 AEM Assets antes de realizar ninguna modificación. Para ello, puede verificar los cuatro agentes de replicación y asegurarse de que las colas están inactivas.
  1. Inicie sesión en la instancia de creación de AEM Assets.
  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 el servicio en la nube de Brand Portal
  • Eliminar usuario de MAC
  1. Inicie sesión en la instancia de creación de AEM Assets 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 la configuración /etc/cloudservices/mediaportal del Cloud Service y elimínela .
  4. Navegue hasta /home/users/mac y elimine el usuario ​MAC del inquilino de Brand Portal.
Ahora puede crear la configuración mediante Adobe Developer Console en la instancia de creación de AEM 6.5.