Configurar AEM Assets con Brand Portal

Adobe Experience Manager Assets Brand Portal le permite publicar recursos de marca aprobados de Adobe Experience Manager Assets en Brand Portal y distribuirlos a los usuarios de Brand Portal.

AEM Assets se configura con Brand Portal a través de Adobe Developer Console, que obtiene un token de cuenta de Adobe Identity Management Services (IMS) para la autorización del inquilino de Brand Portal.

Esta ayuda describe los dos casos de uso siguientes:

• Nueva configuración: Si es un nuevo usuario de Brand Portal y desea configurar la instancia de autor de AEM Assets con Brand Portal, puede crear la configuración a través de Adobe Developer Console.
• Actualización de la configuración: Si ya es un usuario de Brand Portal que tiene una configuración en la puerta de enlace OAuth heredada, elimine la configuración existente y cree una nueva configuración a través de Adobe Developer Console.

La información proporcionada se basa en el supuesto de que cualquier persona que lea esta Ayuda está familiarizada 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 en ejecución con el Service Pack más reciente
• Una URL de 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

Descargar e instalar AEM Service Pack más reciente

Descargar e instalar AEM 6.5

Se recomienda tener AEM 6.5 para configurar una instancia de autor AEM. Si no tiene AEM en funcionamiento, descárguelo desde las siguientes ubicaciones:

• Si ya es cliente de AEM, descargue AEM 6.5 del sitio web de licencias de Adobe.

• Si es socio de Adobe, utilice el Programa de formación de socios de Adobe para solicitar AEM 6.5.

Después de descargar AEM, para obtener instrucciones para configurar una instancia de autor AEM, consulte implementación y mantenimiento.

Descargue e instale AEM último Service Pack

Para obtener instrucciones detalladas, consulte

• Notas de la versión de Service Pack de AEM 6.5

Póngase en contacto con soporte técnico si no puede encontrar el paquete de AEM o Service Pack más reciente.

Crear configuración

La configuración de AEM Assets con Brand Portal requiere configuraciones tanto en la instancia de autor de AEM Assets como en la consola de desarrollador de Adobe.

1. En AEM Assets, cree una cuenta de 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 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 (URL de la organización).
7. Pruebe la configuración publicando un recurso de AEM Assets en Brand Portal.

Realice los siguientes pasos en la secuencia indicada si configura AEM Assets con Brand Portal por primera vez:

1. Obtener un certificado público
2. Crear conexión de cuenta de servicio (JWT)
3. Configurar la cuenta de IMS
4. Configurar el servicio en la nube
5. Probar la configuración

Crear la configuración de IMS

La configuración de IMS autentica la instancia de autor de AEM Assets con el inquilino de Brand Portal.

La configuración de IMS incluye dos pasos:

• Obtener un certificado público
• Configurar la cuenta de IMS

Obtener un certificado público

La clave pública (certificado) autentica el perfil en Adobe Developer Console.

1. Inicie sesión en la instancia de autor de AEM Assets. La dirección URL predeterminada es http://localhost:4502/aem/start.html.

2. En el panel Herramientas , vaya a Seguridad > Configuraciones de IMS de Adobe.

3. En la página Configuraciones de IMS de Adobe, haga clic en Crear. Se redirigirá a la página Configuración de cuenta técnica de IMS de Adobe. De forma predeterminada, se abre la pestaña Certificate.

4. Seleccione Adobe Brand Portal en la lista desplegable Cloud Solution.

5. Seleccione la casilla Create new certificate y especifique un alias para la clave pública. El alias sirve como nombre de la clave pública.

6. Haga clic en Crear certificado. A continuación, haga clic en OK para generar la clave pública.

   

7. Haga clic en el icono Descargar clave pública y guarde el archivo de clave pública (.crt) en el equipo.

   La clave pública se utilizará más adelante 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 pestaña Account, se crea la cuenta IMS de Adobe, que requiere las credenciales de cuenta de servicio que se generan en Adobe Developer Console. Mantenga esta página abierta por ahora.

   Abra una nueva pestaña 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). Existen dos métodos para configurar la API, mediante la generación de un par de claves (claves privadas y públicas) o cargando una clave pública. Para configurar AEM Assets con Brand Portal, debe generar una clave pública (certificado) en AEM Assets y crear credenciales en Adobe Developer Console cargando la clave pública. Estas credenciales son necesarias 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 IMS (inquilino de Brand Portal). La dirección URL predeterminada es https://www.adobe.com/go/devs_console_ui.

   NOTA

   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. Haga clic en Crear nuevo proyecto. Se crea un proyecto en blanco con un nombre generado por el sistema para su organización.

   Haga clic en Editar proyecto para actualizar el Título del proyecto y Descripción y haga clic en Guardar.

3. En la pestaña Project overview, haga clic en Add API.

4. En Add an API window, seleccione AEM Brand Portal y haga clic en Next.

   Asegúrese de tener acceso al servicio AEM Brand Portal.

5. En la ventana Configure API, haga clic en Upload your public key. A continuación, haga clic en Seleccionar un archivo y cargue la clave pública (archivo .crt) que descargó en la sección obtener certificado público.

   Haga clic en Siguiente.

   

6. Compruebe la clave pública y haga clic en Next.

7. Seleccione Assets Brand Portal como perfil de producto predeterminado y haga clic en Guardar API configurada.

   

8. Una vez configurada la API, se le redirige a la página de información general de la API. En el panel de navegación izquierdo de Credentials, haga clic en la opción Service Account (JWT).

   NOTA

   Puede ver las credenciales y realizar acciones como generar tokens JWT, copiar detalles de credenciales, recuperar secreto de cliente, etc.

9. En la pestaña Client Credentials, copie el client ID.

   Haga clic en Recuperar secreto de cliente y copie el secreto de cliente.

   

10. Vaya a la pestaña Generate JWT y copie la información JWT Payload.

Ahora puede utilizar el ID de cliente (clave de API), el secreto del cliente y la carga útil JWT para configurar la cuenta de IMS en AEM Assets.

Configurar la cuenta de IMS

Asegúrese de haber realizado los siguientes pasos:

• Obtener un certificado público
• Crear conexión de cuenta de servicio (JWT)

Realice los siguientes pasos para configurar la cuenta de IMS.

1. Abra la configuración de IMS y vaya a la pestaña Account. Mantuvo la página abierta mientras obtenía el certificado público.

2. Especifique un Título para la cuenta de IMS.

   En el campo Servidor de autorización, especifique la dirección URL: https://ims-na1.adobelogin.com/.

   Especifique el ID de cliente en el campo API key, Client Secret y Payload (carga útil JWT) que ha copiado mientras crea la conexión de cuenta de servicio (JWT).

   Haga clic en Crear.

   La cuenta de IMS está configurada.

   

3. Seleccione la configuración de la cuenta de IMS y haga clic en Comprobar estado.

   Haga clic en Check en el cuadro de diálogo. Si la configuración es correcta, aparece un mensaje que indica que el Token se recupera correctamente.

   

Configurar el servicio en la nube

Siga estos pasos para configurar el servicio en la nube de Brand Portal:

1. Inicie sesión en la instancia de autor de AEM Assets.

2. En el panel Herramientas , vaya a 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 mientras configura la cuenta de IMS.

   En el campo Service URL , especifique la dirección URL del inquilino (organización) de Brand Portal.

   

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 nube de AEM Assets.

2. En el panel Herramientas , vaya a Implementación > Replicación.

   

3. En la página Replicación, haga clic en Agentes del autor.

   

   Puede ver los cuatro agentes de replicación creados para el inquilino de Brand Portal.

   Busque los agentes de replicación del inquilino de Brand Portal y haga clic en la URL del agente de replicación.

   

   NOTA

   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 permitir la publicación en paralelo de varios recursos.

4. Para verificar la conexión entre AEM Assets y Brand Portal, haga clic en el icono Probar conexión.

   

   Aparece un mensaje que el paquete de prueba se entrega correctamente.

   

5. Compruebe los resultados de la prueba en los cuatro agentes de replicación.

   NOTA

   Evite desactivar cualquiera de los agentes de replicación, ya que puede provocar errores en la replicación de los recursos (que se ejecutan en la cola).

   Asegúrese de que los cuatro agentes de replicación estén configurados para evitar errores de tiempo de espera. Consulte solución de problemas en la publicación paralela en Brand Portal.

Ahora puede:

• Publicar recursos desde AEM Assets en Brand Portal
• Publicar recursos desde Brand Portal en AEM Assets : abastecimiento de recursos en Brand Portal
• Publicar carpetas desde AEM Assets en Brand Portal
• Publicar colecciones desde AEM Assets en Brand Portal
• Publicar ajustes preestablecidos, esquemas y facetas en Brand Portal
• Publicar etiquetas en Brand Portal

Consulte la documentación de Brand Portal para obtener más información.

Actualización de la configuración

Siga estos pasos en la secuencia indicada para actualizar las configuraciones existentes a Adobe Developer Console:

1. Comprobar trabajos en ejecución
2. Eliminar configuraciones existentes
3. Crear configuración

Comprobar trabajos en ejecución

Asegúrese de que no se esté ejecutando ningún trabajo de publicación en la instancia de autor de AEM Assets antes de realizar ninguna modificación. Para ello, puede verificar el estado de los trabajos activos en los cuatro agentes de replicación y asegurarse de que las colas estén inactivas.

1. Inicie sesión en la instancia de autor 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 del 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, que no haya ningún trabajo de publicación activo.

   

Eliminar configuraciones existentes

Debe ejecutar la siguiente lista de comprobación al eliminar las configuraciones existentes:

• Eliminar los cuatro agentes de replicación
• Eliminar el servicio en la nube de Brand Portal
• Eliminar usuario MAC

1. Inicie sesión en la instancia de autor de AEM Assets y abra CRX Lite como administrador. La dirección URL predeterminada es http://localhost:4502/crx/de/index.jsp.

2. Vaya a /etc/replications/agents.author y elimine los cuatro agentes de replicación del inquilino de Brand Portal.

   

3. Vaya a /etc/cloudservices/mediaportal y elimine la configuración del servicio en la nube de Brand Portal.

   

4. Vaya a /home/users/mac y elimine el usuario MAC del inquilino de Brand Portal.

   

Ahora puede crear configuración a través de Adobe Developer Console en la instancia de autor de AEM 6.5.