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.
¿Cómo funciona la configuración?
La configuración de la instancia de nube de AEM Assets con un inquilino (organización) de Brand Portal requiere configuraciones tanto en la instancia de nube de AEM Assets como en Adobe Developer Console.
  1. En la instancia de nube de 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 la cuenta de servicio y la información de carga útil de JWT.
  5. En la instancia de nube de AEM Assets, configure la cuenta de IMS con las credenciales de cuenta de servicio y la carga útil de JWT.
  6. En la instancia de nube de 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 la instancia de nube de AEM Assets en Brand Portal.
Un inquilino de Brand Portal solo se configurará con una instancia de nube de AEM Assets.
No configure un inquilino de Brand Portal con varias instancias de nube de AEM Assets.

Requisitos previos

Para configurar AEM Assets con Brand Portal, es necesario lo siguiente:
  • Una instancia de nube de AEM Assets en ejecució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.
Póngase en contacto con el Servicio de atención al cliente para obtener más consultas.

Crear configuración

Realice los siguientes pasos en la secuencia especificada para configurar la instancia de nube de AEM Assets con Brand Portal.

Crear la configuración de IMS

La configuración de IMS autentica el inquilino de Brand Portal con la instancia de nube 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 nube de AEM Assets.
  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 nube de AEM Assets con Brand Portal, debe generar un certificado público (clave pública) en la instancia de nube de 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 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 nube de AEM Assets. Una vez configurada la cuenta de IMS, puede configurar el servicio en la nube de Brand Portal en la instancia de nube de 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 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.

Configurar cuenta de 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 . La página se ha mantenido abierta mientras se obtiene 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 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. 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. 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 los pasos siguientes para configurar el servicio en la nube de Brand Portal:
  1. Inicie sesión en la instancia de nube 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 nube 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. From the Tools panel, navigate to Deployment > Distribution .
  3. En la página Distribución, puede ver que bpdistributionagent0 se ha creado un agente de distribución de Brand Portal para la publicación en Brand Portal .
    Haga clic en Publicar en Brand Portal.
    De forma predeterminada, se crea un agente de distribución para un inquilino de Brand Portal.
  4. En la página del agente de distribución, puede ver las colas de distribución en la ficha Estado .
    Un agente de distribución contiene dos colas:
    • processing-queue : para la distribución de recursos a Brand Portal.
    • error-queue : para los recursos en los que la distribución ha fallado.
    Se recomienda revisar los errores y borrar la cola de errores periódicamente.
  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.
    Evite desactivar el agente de distribución, ya que puede provocar errores en la distribución de los recursos (que se ejecutan en la cola).
La instancia de nube de AEM Assets se ha configurado correctamente con Brand Portal y ahora puede:
Además de lo anterior, también puede publicar esquemas de metadatos, ajustes preestablecidos de imagen, facetas de búsqueda y etiquetas de AEM Assets en Brand Portal.
Consulte la documentación de Brand Portal para obtener más información.

Registros de distribución

Puede consultar los registros para obtener información detallada sobre las acciones realizadas por el agente de distribución.
Por ejemplo, hemos publicado un recurso de Recursos AEM en Brand Portal para validar la configuración.
  1. Follow the steps (from 1 to 4) as shown in the test connection section and navigate to the distribution agent page.
  2. Haga clic en Registros para ver los registros de distribución. Aquí puede ver los registros de procesamiento y de errores.
El agente de distribución genera los siguientes registros:
  • INFORMACIÓN: Es un registro generado por el sistema que se activa en una configuración correcta que habilita el agente de distribución.
  • DSTRQ1 (Solicitud 1): Se activa en comprobar la conexión.
Al publicar el recurso, se generan los siguientes registros de solicitud y respuesta:
Solicitud del agente de distribución :
  • DSTRQ2 (Solicitud 2): Se activa la solicitud de publicación de recursos.
  • DSTRQ3 (Solicitud 3): El sistema activa otra solicitud para publicar la carpeta en la que existe el recurso y replica la carpeta en Brand Portal.
Respuesta del agente de distribución :
  • queue-bpdistributionagent0 (DSTRQ2): El recurso se publica en Brand Portal.
  • queue-bpdistributionagent0 (DSTRQ3): El sistema replica la carpeta con el recurso en Brand Portal.
En el ejemplo anterior, se activa una solicitud y una respuesta adicionales. El sistema no pudo encontrar la carpeta principal (denominada Agregar ruta) en Brand Portal porque el recurso se publicó por primera vez, por lo tanto se activa una solicitud adicional para crear una carpeta principal con el mismo nombre en Brand Portal en la que se publica el recurso.
Se genera una solicitud adicional si la carpeta principal no existe en Brand Portal (en el ejemplo anterior) o si la carpeta principal se ha modificado en AEM Assets.