Externalización de direcciones URL

En AEM, Externalizer es un servicio OSGi que le permite transformar mediante programación una ruta de recursos (p. ej. /path/to/my/page) en una dirección URL externa y absoluta (por ejemplo, https://www.mycompany.com/path/to/my/page) añadiendo un prefijo a la ruta con un DNS preconfigurado.

Dado que una instancia as a Cloud Service AEM no puede saber su URL visible externamente y que a veces se debe crear un vínculo fuera del ámbito de la solicitud, este servicio proporciona un lugar central para configurar esas URL externas y crearlas.

Este artículo explica cómo configurar el servicio externalizador y cómo utilizarlo. Para obtener detalles técnicos del servicio, consulte Javadocs.

Comportamiento predeterminado del externalizador y cómo ignorarlo

De forma predeterminada, el servicio externalizador tiene valores como author-p12345-e6789.adobeaemcloud.com y publish-p12345-e6789.adobeaemcloud.com.

Para anular estos valores, utilice variables de entorno de Cloud Manager como se describe en el artículo Configuración de OSGi para AEM as a Cloud Service y configuración de las variables predefinidas AEM_CDN_DOMAIN_AUTHOR y AEM_CDN_DOMAIN_PUBLISH .

Configuración del servicio externalizador

El servicio externalizador le permite definir de forma centralizada el dominio que se puede utilizar para prefijar programáticamente las rutas de recursos. El servicio externalizador solo debe utilizarse para aplicaciones con un solo dominio.

Para definir una asignación de dominio para el servicio externalizador:

1. Vaya al Administrador de configuración mediante:

   https://<host>:<port>/system/console/configMgr

2. Haga clic en Day CQ Link Externalizer para abrir el cuadro de diálogo de configuración.

   

   NOTA

   El enlace directo a la configuración es https://<host>:<port>/system/console/configMgr/com.day.cq.commons.impl.ExternalizerImpl

3. Defina una asignación de Domains. Una asignación consiste en un nombre único que se puede utilizar en el código para hacer referencia al dominio, un espacio y el dominio:

   <unique-name> [scheme://]server[:port][/contextpath]

   Donde:

   • scheme generalmente es http o https, pero puede ser otro protocolo.

     • Se recomienda utilizar https para aplicar los vínculos https.
     • Se utilizará si el código de cliente no anula el esquema al solicitar la externalización de una URL.

   • server es el nombre de host (un nombre de dominio o una dirección ip).

   • port (opcional) es el número de puerto.

   • contextpath (opcional) solo se establece si AEM está instalado como una aplicación web en una ruta de contexto diferente.

   Por ejemplo: production https://my.production.instance

   Los siguientes nombres de asignación están predefinidos y siempre deben configurarse como AEM dependen de ellos:

   • local : la instancia local
   • author - el DNS del sistema de creación
   • publish - el sitio web DNS de cara al público
   NOTA

   Una configuración personalizada le permite agregar una nueva categoría, como production, staging o incluso sistemas no AEM externos como my-internal-webservice. Es útil evitar codificar dichas URL en distintos lugares de la base de código de un proyecto.

4. Haga clic en Guardar para guardar los cambios.

Uso del servicio externalizador

Esta sección muestra algunos ejemplos de cómo se puede utilizar el servicio externalizador.

• Para externalizar una ruta con el dominio "publicar":

  String myExternalizedUrl = externalizer.publishLink(resolver, "/my/page") + ".html";
  

  Suponiendo la asignación de dominios:

  • publish https://www.website.com

  • myExternalizedUrl termina con el valor:

  • https://www.website.com/contextpath/my/page.html

• Para externalizar una ruta con el dominio "autor":

  String myExternalizedUrl = externalizer.authorLink(resolver, "/my/page") + ".html";
  

  Suponiendo la asignación de dominios:

  • author https://author.website.com

  • myExternalizedUrl termina con el valor:

  • https://author.website.com/contextpath/my/page.html

• Para externalizar una ruta con el dominio "local":

  String myExternalizedUrl = externalizer.externalLink(resolver, Externalizer.LOCAL, "/my/page") + ".html";
  

  Suponiendo la asignación de dominios:

  • local https://publish-3.internal

  • myExternalizedUrl termina con el valor:

  • https://publish-3.internal/contextpath/my/page.html