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.

NOTA

La configuración de AEM Assets con Brand Portal a través de Adobe Developer Console es compatible con AEM 6.5.4.0 y versiones posteriores.

Anteriormente, Brand Portal se configuraba mediante la puerta de enlace OAuth heredada, que utiliza el intercambio de tokens web JSON (JWT) para obtener un token de acceso IMS para la autorización.

La configuración mediante la puerta de enlace OAuth heredada ya no es compatible a partir del 6 de abril de 2020 y se cambia a Adobe Developer Console.

CONSEJO

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 a través de Adobe Developer Console.

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:

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

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.
NOTA

Una instancia de autor de AEM Assets solo se debe configurar con un inquilino de 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

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 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.

    Crear certificado

  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.

    Descargar certificado

  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.

    Cargar clave pública

  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.

    Seleccionar perfil de producto

  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.

    Credenciales de cuenta de servicio

  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:

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.

    Configuración de cuenta de IMS

  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.

ATENCIÓN

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 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 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 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:

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 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.

En esta página

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now