DocumentaciónAEM GuidesDocumentación de AEM Guides

Configuración de la publicación basada en microservicios con autenticación JWT

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Usuario
  • Administrador

[Cloud Service]{class="badge informative"}

NOTE
Las credenciales de la cuenta de servicio (JWT) han quedado obsoletas y pasan a ser credenciales de servidor a servidor OAuth. Las aplicaciones que utilizan las credenciales de la cuenta de servicio (JWT) dejarán de funcionar a partir del 1 de enero de 2025. Debe migrar a la nueva credencial antes del 1 de enero de 2025 para garantizar que la aplicación siga funcionando. Obtenga más información acerca de migración de la credencial de cuenta de servicio (JWT) a la credencial de servidor a servidor OAuth.

La publicación basada en microservicios en para Adobe Experience Manager Guides as a Cloud Service admite los tipos de ajustes preestablecidos de salida PDF (tanto nativos como basados en DITA-OT), HTML 5, JSON y PERSONALIZADO.

Como las credenciales de la cuenta de servicio (JWT) han quedado obsoletas, se recomienda utilizar la autenticación basada en OAuth de Adobe IMS. Aprenda a configurar la publicación basada en microservicios con autenticación OAuth.

Para el servicio de publicación en la nube protegido por la autenticación basada en JWT de Adobe IMS, los clientes deben seguir los pasos indicados a continuación para integrar sus entornos con los flujos de trabajo de autenticación seguros basados en tokens de Adobe y comenzar a utilizar la nueva solución de publicación escalable basada en la nube.

Creación de configuraciones de IMS en Adobe Developer Console

Rol necesario para crear las confusiones: Administrador del sistema

Realice los siguientes pasos para crear configuraciones de IMS en Adobe Developer Console:

  1. Abrir Developer Console: https://developer.adobe.com/console.

  2. Cambie a la ficha Proyectos desde la parte superior.

    pestaña proyectos {width="500"}

  3. Para crear un nuevo proyecto vacío, selecciona Proyecto vacío en la lista desplegable Crear nuevo proyecto.

    crear nuevo proyecto {width="500"}

  4. Seleccione API del menú desplegable Agregar al proyecto para agregar la API de administración de E/S a su proyecto.

    agregar proyecto {width="300"} administración de io {width="500"}

  5. Cree un nuevo par de claves pública y privada al agregar la API. Esto descargará automáticamente la clave privada en el sistema.

    generar par de claves {width="500"}

  6. Guarde la API configurada.

    guardar api {width="600"}

  7. Vuelva a la ficha Proyectos y haga clic en Información general del proyecto a la izquierda.

    resumen del proyecto {width="500"}

  8. Haga clic en el botón Descargar de la parte superior para descargar el JSON del servicio.

    descargar json {width="500"}

Ahora ha configurado los detalles de autenticación JWT y también ha descargado la clave privada y los detalles del servicio JSON. Mantenga estos dos archivos a mano, ya que estos archivos son necesarios en la siguiente sección.

Añadir la configuración de IMS al entorno

Siga estos pasos para agregar la configuración de IMS al entorno:

  1. Abra Experience Manager y, a continuación, seleccione el programa que contiene el entorno que desea configurar.

  2. Cambie a la ficha Entornos.

  3. Haga clic en el nombre del entorno que desea configurar. Debe ir a la página Información del entorno.

  4. Cambie a la ficha Configuración.

  5. Cargue la clave privada y el JSON del proyecto como se muestra en la captura de pantalla siguiente. Asegúrese de utilizar los mismos nombres y configuraciones que se resaltan a continuación.

    configuraciones de ims {width="500"}

NOTE
Debe abrir, copiar y pegar el contenido de la clave privada y el archivo JSON de detalles de servicio en la columna de valor del panel Configuración, como se muestra en la captura de pantalla anterior.

Una vez añadida la configuración de IMS al entorno, realice los siguientes pasos para vincular estas propiedades con Experience Manager Guides mediante OSGi:

  1. En su código de proyecto Git de Cloud Manager, agregue los dos archivos siguientes (para ver el contenido de los archivos, consulte Apéndice).

    • com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.json
    • com.adobe.fmdita.publishworkflow.PublishWorkflowConfigurationService.xml

  2. Asegúrese de que los archivos recién agregados estén cubiertos por su filter.xml.

  3. Confirme y envíe los cambios de Git.

  4. Ejecute la canalización para aplicar los cambios en el entorno.

Una vez hecho esto, debería poder usar la nueva publicación en la nube basada en microservicios.

Preguntas frecuentes

  1. ¿Se puede utilizar una sola clave en varios entornos de nube?
    • Sí, puede generar una clave privada y utilizarla para todos los entornos, pero debe configurar variables de entorno para todos los entornos y utilizar la misma clave.
  2. AEM Si las configuraciones de OSGi para utilizar microservicios están habilitadas, ¿funcionará el proceso de publicación en un servidor local con la misma base de código?
    • No, si el indicador dxml.use.publish.microservice está establecido en true, siempre buscará configuraciones de microservicio. Establezca dxml.use.publish.microservice en false para que la publicación funcione en su sitio local.
  3. ¿Cuánta memoria se asigna al proceso DITA cuando se utiliza la publicación basada en microservicios? ¿Se conduce mediante parámetros de hormiga de perfil DITA?
    • Con la publicación basada en microservicios, la asignación de memoria no se controla mediante parámetros de hormiga de perfil DITA. La memoria total disponible en el contenedor de servicios es de 8 GB, de los cuales 6 GB se asignan al proceso DITA-OT.

Apéndice appendix

Archivo:
com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.json

Contenido:

{
  "service.account.details": "$[secret:SERVICE_ACCOUNT_DETAILS]",
  "private.key": "$[secret:PRIVATE_KEY]"
}

Archivo: com.adobe.fmdita.publishworkflow.PublishWorkflowConfigurationService.xml

Contenido:

  • dxml.use.publish.microservice: cambiar para habilitar la publicación basada en microservicios mediante DITA-OT
  • dxml.use.publish.microservice.native.pdf: cambiar para habilitar la publicación de PDF nativos basada en microservicios
<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:jcr="http://www.jcp.org/jcr/1.0" xmlns:sling="http://sling.apache.org/jcr/sling/1.0"
          jcr:primaryType="sling:OsgiConfig"
          dxml.publish.microservice.url="https://adobeioruntime.net/api/v1/web/543112-guidespublisher/default/publishercaller.json"
          dxml.use.publish.microservice="{Boolean}true"
          dxml.use.publish.microservice.native.pdf="{Boolean}true"
/>
recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178