Configurar AEM Assets con Brand Portal

Adobe Experience Manager Assets Brand Portal le permite publicar los 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 proporciona 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 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 autentificador web JSON (JWT) para obtener un Token de acceso IMS para la autorización.

La configuración mediante OAuth Gateway heredada ya no se admite 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 la puerta de enlace OAuth existente. 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 la configuración mediante Adobe Developer Console.
  • Configuraciónde actualización: Si ya es un usuario de Brand Portal que tiene una configuración en OAuth Gateway heredada, elimine la configuración existente y cree una nueva configuración mediante 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 Service Pack más reciente
  • Dirección 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 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 la asistencia 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.
Nota

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 está configurando 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 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 creación de AEM Assets. La dirección URL predeterminada es http://localhost:4502/aem/start.html.

  2. From the Tools Tools panel, navigate to Security > Adobe IMS Configurations.

  3. En la página Configuraciones de IMS de Adobe, haga clic en Crear. It will redirect to the Adobe IMS Technical Account Configuration page. By default, the Certificate tab opens.

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

  5. Active la casilla de verificación Crear nuevo certificado 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. Then, click OK to generate the public key.

    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 las credenciales de cuenta de servicio en Adobe Developer Console.

    Descargar certificado

  8. Haga clic en Siguiente.

    En la ficha Cuenta , se crea una 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 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). 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 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 de 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. Click Create new project. 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 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 la clave pública (archivo .crt) que ha descargado 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 Siguiente.

  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 de la izquierda, en Credenciales, haga clic en la opción Cuenta de servicio (JWT) .

    Nota

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

  9. En la ficha Credenciales de cliente, copie el ID de cliente.

    Click Retrieve Client Secret and copy the client secret.

    Credenciales de cuenta de servicio

  10. Navigate to the Generate JWT tab and copy the JWT Payload information.

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 certificadopúblico.

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

    In the Authorization Server field, specify the URL: https://ims-na1.adobelogin.com/.

    Especifique el ID de cliente en el campo Clave de API, Secreto de cliente y Carga útil (carga útil JWT) que ha copiado al crear la conexiónde cuenta de servicio (JWT).

    Haga clic en Crear.

    La cuenta de IMS está configurada.

    Configuración de cuenta de IMS

  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.

PRECAUCIÓ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 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 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 cuentade IMS.

    En el campo URL del servicio, 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 AEM Assets Cloud.

  2. From the Tools Tools panel, navigate to Deployment > Replication.

  3. En la página Replicación, haga clic en Agentes en el 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 dirección 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 habilitar la publicación en paralelo de varios recursos.

  4. To verify the connection between AEM Assets and Brand Portal, click on the Test Connection icon.

    Aparece un mensaje que indica que el paquete de prueba se ha entregado 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 (ejecución en cola).

    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.

Ahora puede:

See Brand Portal documentation for more information.

Configuración de actualización

Realice los siguientes pasos en la secuencia indicada para actualizar las configuraciones existentes a la consola de desarrollador de Adobe:

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

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 comprobar 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 creación 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 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 al eliminar 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 del servicio en la nube de Brand Portal /etc/cloudservices/mediaportal y elimínelo.

  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.

En esta página