Configure AEM Assets as a Cloud Service con Brand Portal

La configuración de Adobe Experience Manager Assets Brand Portal permite publicar recursos de marca aprobados de Adobe Experience Manager Assets como una instancia Cloud Service en Brand Portal y distribuirlos a los usuarios de Brand Portal.

Activar Brand Portal con Cloud Manager

El usuario de Cloud Manager activa Brand Portal para una instancia de AEM Assets como Cloud Service. El flujo de trabajo de activación crea las configuraciones necesarias (token de autorización, configuración de IMS y servicio en la nube de Brand Portal) en el servidor y refleja el estado del inquilino de Brand Portal en Cloud Manager. Al activar Brand Portal, los usuarios de AEM Assets pueden publicar recursos en Brand Portal y distribuirlos a los usuarios de Brand Portal.

Requisitos previos

Debe lo siguiente para activar Brand Portal en su AEM Assets como instancia Cloud Service:

  • Una instancia de AEM Assets como Cloud Service en ejecución.
  • Un usuario que tiene acceso a Cloud Manager, asignado a Perfiles del producto Cloud Manager. Consulte acceso a Cloud Manager para obtener más información.
NOTA

Una instancia de AEM Assets as a Cloud Service tiene derecho a conectarse únicamente con un inquilino de Brand Portal. Puede tener varios entornos (desarrollo, producción y etapa) para su AEM Assets como instancia Cloud Service, donde Brand Portal se activa en un entorno.

Pasos para activar Brand Portal

Puede activar Brand Portal al crear los entornos para su AEM Assets como instancia Cloud Service o por separado. Supongamos que los entornos ya se han creado y que ahora debe activar Brand Portal.

  1. Inicie sesión en Adobe Cloud Manager y vaya a Environments.

    La página Entornos muestra la lista de todos los entornos existentes.

  2. Seleccione los entornos (uno a uno) de la lista para ver los detalles del entorno.

    Brand Portal tiene derecho a uno de los entornos disponibles y se refleja en Información del entorno.

    Una vez encontrado el entorno asociado con Brand Portal, haga clic en el botón Activate Brand Portal para iniciar el flujo de trabajo de activación.

    Activar Brand Portal

  3. Se tardan unos minutos en activar el inquilino de Brand Portal, ya que el flujo de trabajo de activación crea las configuraciones necesarias en el servidor. Una vez activado el inquilino de Brand Portal, el estado cambia a Activado.

    Ver estado

NOTA

Brand Portal debe activarse en la misma organización de IMS que AEM Assets en una instancia Cloud Service.

Si tiene una configuración de nube de Brand Portal existente (configurada manualmente mediante la Consola de desarrollador de Adobe) para una organización de IMS (con organización1) y la instancia de AEM Assets as a Cloud Service está configurada para otra organización de IMS (org2-new), activar Brand Portal desde Cloud Manager restablece la organización de IMS de Brand Portal a org2-new. Aunque la configuración de nube configurada manualmente en org1-existing será visible en la instancia de autor de AEM Assets, pero ya no estará en uso después de activar Brand Portal desde Cloud Manager.

Si la configuración de nube de Brand Portal existente y la instancia de AEM Assets as a0/> utilizan la misma organización de IMS (org1), solo debe activar Brand Portal desde Cloud Manager.Cloud Service

Consulte también:

Inicie sesión en su inquilino de Brand Portal:

Después de activar el inquilino de Brand Portal en Cloud Manager, puede iniciar sesión en Brand Portal desde el Admin Console o directamente utilizando la URL del inquilino.

La dirección URL predeterminada del inquilino de Brand Portal es: https://<tenant-id>.brand-portal.adobe.com/.

En este caso, el ID del inquilino es la organización de IMS.

Siga estos pasos si no está seguro de la URL de Brand Portal:

  1. Inicie sesión en Admin Console y vaya a Productos.

  2. En el carril izquierdo, seleccione Adobe Experience Manager Brand Portal - Brand Portal.

  3. Haga clic en Ir a Brand Portal para abrir directamente Brand Portal en el explorador.

    O bien, copie la dirección URL del inquilino de Brand Portal del enlace Go to Brand Portal y péguela en el explorador para abrir la interfaz de Brand Portal.

    Acceso a Brand Portal

Probar conexión

Realice los siguientes pasos para validar la conexión entre la instancia de AEM Assets como Cloud Service y el inquilino de Brand Portal:

  1. Inicie sesión en AEM Assets.

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

    Se crea un agente de distribución de Brand Portal (bpdistributionagent0) en Publicar en Brand Portal.

  3. Haga clic en Publicar en Brand Portal para abrir el agente de distribución.

    Puede ver las colas de distribución en la pestaña Status.

    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.

    NOTA

    Se recomienda revisar los errores y borrar la cola de errores periódicamente.

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

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

    NOTA

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

Para verificar la conexión entre la instancia de AEM Assets as a Cloud Service y el inquilino de Brand Portal, publique un recurso de AEM Assets en Brand Portal. Si la conexión se realiza correctamente, el recurso publicado se puede ver en la interfaz de Brand Portal.

Ahora puede:

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

Registros de distribución

Puede controlar los registros del agente de distribución para el flujo de trabajo de publicación de recursos.

Ahora vamos a publicar un recurso de AEM Assets en Brand Portal y a ver los registros.

  1. Siga los pasos (del 1 al 4) que se muestran en la sección Test connection y vaya a la página del agente de distribución.

  2. Haga clic en Logs para ver los registros de procesamiento y error.

El agente de distribución ha generado los siguientes registros:

  • INFORMACIÓN: Es un registro generado por el sistema que déclencheur en una configuración correcta del 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 déclencheur otra solicitud para publicar la carpeta de AEM Assets (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 de AEM Assets (que contiene 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 (Agregar ruta) en Brand Portal porque el recurso se publicó por primera vez, por lo que activó una solicitud adicional para crear una carpeta principal con el mismo nombre en Brand Portal donde se publica el recurso.

NOTA

Se genera una solicitud adicional en caso de que la carpeta principal no exista en Brand Portal o se haya modificado en AEM Assets.

Junto con el flujo de trabajo de automatización para activar Brand Portal en AEM Assets as a Cloud Service, existe otro método para configurar AEM Assets como Cloud Service manualmente con Brand Portal mediante la consola de desarrollador de Adobe, que ya no se recomienda.

NOTA

Póngase en contacto con el servicio de asistencia al Adobe si tiene algún problema al activar su inquilino de Brand Portal.

Configuración manual mediante Adobe Developer Console

En la siguiente sección se describe cómo configurar manualmente AEM Assets as a Cloud Service con Brand Portal mediante Adobe Developer Console.

Anteriormente, AEM Assets as a Cloud Service se configuraba manualmente 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. Requiere configuraciones tanto en AEM Assets como en Adobe Developer Console.

  1. En AEM Assets, cree una cuenta de IMS y genere una clave pública (certificado).
  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.
  4. Obtenga las credenciales de cuenta de servicio y la información de carga útil de token web JSON (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 organización).
  7. Pruebe la configuración publicando un recurso de AEM Assets a Brand Portal.
NOTA

Una instancia de AEM Assets as a Cloud Service solo se debe configurar con un inquilino de Brand Portal.

Requisitos previos

Para configurar AEM Assets con Brand Portal, es necesario lo siguiente:

  • Una instancia de AEM Assets como Cloud Service en ejecución
  • 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

Crear configuración

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

  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

Crear la configuración de IMS

La configuración de IMS autentica su AEM Assets como instancia Cloud Service 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 AEM Assets.

  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 Solución de nube.

  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 utiliza 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 (inquilino de Brand Portal) correcta 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 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 creó mientras configuraba la cuenta de IMS.

    En el campo Service URL , especifique la 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 AEM Assets as a Cloud Service ahora está configurada con el inquilino de Brand Portal.

Ahora puede probar la configuración comprobando el agente de distribución y publicando recursos en Brand Portal.

En esta página