Implementación de redirecciones de URL sin canalización

Aprenda a implementar redirecciones de URL sin canalizaciones en AEM as a Cloud Service para permitir que el equipo de marketing administre las redirecciones sin necesidad de un desarrollador.

Hay varias opciones para administrar las redirecciones de URL en AEM. Para obtener más información, consulte Redirecciones de URL.

El tutorial se centra en la creación de redirecciones de URL como pares clave-valor en un archivo de texto como Apache RewriteMap y utiliza la configuración específica de AEM as a Cloud Service para cargarlas en el módulo Apache/Dispatcher.

Requisitos previos

Para completar este tutorial, necesita lo siguiente:

Caso de uso del tutorial

Para el propósito de demostración, supongamos que el equipo de marketing de WKND está lanzando una nueva campaña de esquí. Les gustaría crear URL cortas para las páginas de aventura de esquí y administrarlas por su cuenta, como administran el contenido. Decidieron usar el método redirecciones de URL sin canalizaciones para administrar las redirecciones de URL.

En función de los requisitos del equipo de marketing, a continuación se indican las redirecciones URL que deben crearse.

Ahora, veamos cómo administrar estas redirecciones URL y las configuraciones de Dispatcher únicas requeridas en el entorno de AEM as a Cloud Service.

Cómo administrar las redirecciones URL manage-redirects

Para administrar las redirecciones URL, hay varias opciones disponibles, vamos a explorarlas.

Archivo de texto en DAM

Las redirecciones URL se pueden administrar como pares clave-valor en un archivo de texto y cargarse en AEM Digital Asset Management (DAM).

Por ejemplo, las redirecciones de URL anteriores se pueden guardar en un archivo de texto denominado skicampaign.txt y cargarse en la carpeta DAM @ /content/dam/wknd/redirects. Tras su revisión y aprobación, el equipo de marketing puede publicar el archivo de texto.

# Ski Campaign Redirects separated by the TAB character
/ski      /us/en/adventures.html
/ski/northamerica  /us/en/adventures/downhill-skiing-wyoming.html
/ski/westcoast   /us/en/adventures/tahoe-skiing.html
/ski/europe          /us/en/adventures/ski-touring-mont-blanc.html

ACS Commons - Administrador de mapas de redireccionamiento

ACS Commons - Administrador de mapas de redireccionamiento proporciona una interfaz fácil de usar para administrar los redireccionamientos de URL.

Por ejemplo, el equipo de marketing puede crear una nueva página de mapas de redireccionamiento llamada SkiCampaign y agregar las redirecciones de URL anteriores mediante la pestaña Editar entradas. Las redirecciones de URL están disponibles en /etc/acs-commons/redirect-maps/skicampaign/jcr:content.redirectmap.txt.

ACS Commons - Administrador de redireccionamiento

Como alternativa, ACS Commons - Administrador de redireccionamiento también proporciona una interfaz fácil de usar para administrar las redirecciones de URL.

Por ejemplo, el equipo de marketing puede crear una nueva configuración denominada /conf/wknd y agregar las redirecciones de URL anteriores mediante el botón + Configuración de redireccionamiento. Las redirecciones de URL están disponibles en /conf/wknd/settings/redirects.txt.

Configuración de Dispatcher

Para cargar las redirecciones URL como un RewriteMap y aplicarlas a las solicitudes entrantes, se requieren las siguientes configuraciones de Dispatcher.

Habilitar el módulo de Dispatcher para un modo flexible

En primer lugar, compruebe que el módulo Dispatcher esté habilitado para modo flexible. La presencia del archivo USE_SOURCES_DIRECTLY en la carpeta dispatcher/src/opt-in indica que Dispatcher se encuentra en modo flexible.

Cargar redirecciones URL como RewriteMap

A continuación, cree un nuevo archivo de configuración managed-rewrite-maps.yaml en la carpeta dispatcher/src/opt-in con la siguiente estructura.

maps:
- name: <MAPNAME>.map # e.g. skicampaign.map
    path: <ABSOLUTE_PATH_TO_URL_REDIRECTS_FILE> # e.g. /content/dam/wknd/redirects/skicampaign.txt, /etc/acs-commons/redirect-maps/skicampaign/jcr:content.redirectmap.txt, /conf/wknd/settings/redirects.txt
    wait: false # Optional, default is false, when true, the Apache waits for the map to be loaded before starting
    ttl: 300 # Optional, default is 300 seconds, the reload interval for the map

Durante la implementación, Dispatcher crea el archivo <MAPNAME>.map en la carpeta /tmp/rewrites.

Aplicar redirecciones URL a solicitudes entrantes

Finalmente, cree o actualice el archivo de configuración de reescritura de Apache para utilizar el mapa anterior (<MAPNAME>.map). Por ejemplo, usemos el archivo rewrite.rules de la carpeta dispatcher/src/conf.d/rewrites para aplicar las redirecciones de URL.

...
# Use the RewriteMap to define the URL redirects
RewriteMap <MAPALIAS> dbm=sdbm:/tmp/rewrites/<MAPNAME>.map

RewriteCond ${<MAPALIAS>:$1} !=""
RewriteRule ^(.*)$ ${<MAPALIAS>:$1|/} [L,R=301]
...

Configuraciones de ejemplo

Revisemos las configuraciones de Dispatcher para cada una de las opciones de administración de redireccionamiento de URL mencionadas arriba.

maps:
- name: skicampaign.map
  path: /content/dam/wknd/redirects/skicampaign.txt

...

# The DAM-managed skicampaign.txt file as skicampaign.map
RewriteMap skicampaign dbm=sdbm:/tmp/rewrites/skicampaign.map

# Apply the RewriteMap for matching request URIs
RewriteCond ${skicampaign:$1} !=""
RewriteRule ^(.*)$ ${skicampaign:$1|/} [L,R=301]

...

maps:
- name: skicampaign.map
  path: /etc/acs-commons/redirect-maps/skicampaign/jcr:content.redirectmap.txt

...

# The Redirect Map Manager-managed skicampaign.map
RewriteMap skicampaign dbm=sdbm:/tmp/rewrites/skicampaign.map

# Apply the RewriteMap for matching request URIs
RewriteCond ${skicampaign:$1} !=""
RewriteRule ^(.*)$ ${skicampaign:$1|/} [L,R=301]

...

maps:
- name: skicampaign.map
  path: /conf/wknd/settings/redirects.txt

...

# The Redirect Manager-managed skicampaign.map
RewriteMap skicampaign dbm=sdbm:/tmp/rewrites/skicampaign.map

# Apply the RewriteMap for matching request URIs
RewriteCond ${skicampaign:$1} !=""
RewriteRule ^(.*)$ ${skicampaign:$1|/} [L,R=301]

...

Cómo implementar las configuraciones

Para implementar las configuraciones, usa la canalización full-stack o configuración de nivel web en Cloud Manager.

Una vez implementada correctamente, las redirecciones URL están activas y el equipo de marketing puede administrarlas sin necesidad de un desarrollador.

Prueba de las redirecciones URL

Probemos las redirecciones de URL usando el explorador o el comando curl. Acceda a la dirección URL /ski/westcoast y verifique que redirige a /us/en/adventures/tahoe-skiing.html.

Resumen

En este tutorial, ha aprendido a administrar las redirecciones URL mediante configuraciones sin canalización en el entorno de AEM as a Cloud Service.

El equipo de marketing puede administrar las redirecciones URL como pares clave-valor en un archivo de texto y cargarlas en DAM o utilizar ACS Commons - Gestor de mapas de redireccionamiento o Gestor de redireccionamiento. Las configuraciones de Dispatcher se actualizan para cargar las redirecciones URL como un RewriteMap y aplicarlas a las solicitudes entrantes.

Recursos adicionales