URL personalizzati del dispatcher

Questo documento ti aiuterà a capire come l’AEM gestisce gli URL personalizzati e alcune tecniche aggiuntive, come l’utilizzo di regole di riscrittura per mappare il contenuto più vicino al limite della consegna.

Descrizione description

Ambiente

Experience Manager

Problemi/Sintomi

Come si comporta l’AEM con gli URL personalizzati? Esistono tecniche aggiuntive per mappare il contenuto più vicino al limite della distribuzione?

Cosa sono gli URL personalizzati?

Se il contenuto risiede in una struttura di cartelle, non sempre si trova in un URL di facile riferimento. Gli URL personalizzati sono come scelte rapide. URL più brevi o univoci che fanno riferimento a dove si trova il contenuto reale.

Ecco un esempio: /aboutus puntato a /content/we-retail/us/en/about-us.html

Gli autori dell’AEM possono impostare le proprietà dell’URL personalizzato su un contenuto nell’AEM e pubblicarlo.

Affinché questa funzione funzioni, è necessario regolare i filtri del dispatcher per consentire il reindirizzamento. Questa situazione diventa poco ragionevole se si regolano i file di configurazione del dispatcher alla velocità con cui gli autori dovrebbero impostare queste voci di pagina personalizzate.

Per questo motivo il modulo dispatcher dispone di una funzione che consente automaticamente tutto ciò che è elencato come reindirizzamento nella struttura del contenuto.

Risoluzione resolution

Come funziona?

Creazione di URL personalizzati

L’autore visita una pagina in AEM, visita le proprietà della pagina e aggiunge voci nella sezione degli URL personalizzati.

Una volta salvate le modifiche e attivata la pagina, il reindirizzamento viene assegnato a essa.

Interfaccia utente touch:

Finder contenuti classico:

Nota: Ti preghiamo di capire che questo è molto vulnerabile a problemi di spazio dei nomi. Le voci personalizzate sono globali per tutte le pagine, questo è solo uno dei difetti per cui è necessario pianificare soluzioni alternative. Ne spiegheremo alcuni in seguito.

Risoluzione/mappatura risorse:

Ogni voce di reindirizzamento è una voce di mappatura sling per un reindirizzamento interno. Queste mappe sono visibili nella console Felix delle istanze dell'AEM (/system/console/jcrresolver)

Ecco una schermata della voce di mappa creata da una voce di reindirizzamento:

Nell'esempio precedente quando chiediamo all'istanza AEM di visitare /aboutus si risolverà in /content/we-retail/us/en/about-us.html

Filtri di Dispatcher per l’autorizzazione automatica:

Il Dispatcher in uno stato protetto esclude le richieste nel percorso o nel Dispatcher, perché si tratta della radice della struttura JCR.

È importante assicurarsi che gli editori consentano solo i contenuti /content e altri percorsi sicuri ecc… e non percorsi come /system ecc.

Questo è il problema: gli URL personalizzati si trovano nella cartella base di /, quindi come possiamo consentire loro di raggiungere gli editori mantenendo la sicurezza?

Semplice, Dispatcher dispone di un meccanismo di filtro automatico per l’autorizzazione. Occorre installare un pacchetto AEM e poi configurare il Dispatcher in modo che punti alla pagina dei pacchetti. Visita qui per il pacchetto AEM.

Il file farm di Dispatcher contiene una sezione di configurazione:

/vanity_urls {      /url    "/libs/granite/dispatcher/content/vanityUrls.html"
  /file   "/tmp/vanity_urls"      /delay  300 }

Questa configurazione comunica al Dispatcher di recuperare questo URL dall’istanza AEM che esegue ogni 300 secondi per recuperare l’elenco di elementi che si desidera autorizzare.

Memorizza la cache della risposta nell’argomento /file, quindi in questo esempio /tmp/vanity_urls

Quindi, se visiti l’istanza dell’AEM all’URI, vedrai cosa recupera:

È un elenco molto semplice.

Riscrivi regole come regole personalizzate

Perché citare l’utilizzo di regole di riscrittura invece del meccanismo predefinito integrato nell’AEM come descritto sopra?

Semplicemente perché i problemi di spazio dei nomi, le prestazioni e la logica di livello superiore possono essere gestiti meglio.

Passiamo ora a un esempio della voce di reindirizzamento /aboutus al suo contenuto /content/we-retail/us/en/about-us.html utilizzo di Apache mod_rewrite per eseguire questa operazione.

RewriteRule /aboutus /content/we-retail/us/en/about-us.html PT,L,NC

Questa regola cerca il reindirizzamento /aboutus e recupera il percorso completo dal renderer con il flag PT (Pass Through).

Inoltre, smetterà di elaborare tutte le altre regole con flag L (Last), il che significa che non dovrà elaborare un lungo elenco di regole come nel caso del Resolving JCR.

Oltre a non dover delegare la richiesta e attendere che l’editore dell’AEM risponda, questi due elementi rendono il metodo molto più performante.

La ciliegina sulla torta qui è il flag NC (No Case-Sensitive) che significa che se un cliente sbatte l’URI con /Aboutus invece di /aboutus funzionerà comunque e consentirà di recuperare la pagina giusta.

Per creare una regola di riscrittura a questo scopo, crea un file di configurazione in Dispatcher (ad esempio: /etc/httpd/conf.d/rewrites/examplevanity_rewrite.rules) e includerlo nella .vhost file che gestisce il dominio che richiede l’applicazione di questi url personalizzati.

Di seguito è riportato un frammento di codice di esempio da includere all’interno:

/etc/httpd/conf.d/enabled_vhosts/we-retail.vhost
 VirtualHost *:80    ServerName    weretail.com    ServerAlias

www.weretail.com        ........ SNIP ........     IfModule mod_rewrite.c

   ReWriteEngine    on       LogLevel warn rewrite:info

Include /etc/httpd/conf.d/rewrites/examplevanity_rewrite.rules      / IfModule
   ........ SNIP ......../VirtualHost

Quale metodo e dove usarlo?

A. L’utilizzo dell’AEM per controllare le voci vanity presenta i seguenti vantaggi:

B. Utilizzo mod_rewrite per controllare le voci di reindirizzamento sono disponibili i seguenti vantaggi:

C. Utilizzare entrambi i metodi, ma ecco i consigli e i criteri su quale utilizzare quando:

Nota: Se desideri utilizzare la funzione di reindirizzamento AEM ed evitare lo spazio dei nomi, puoi creare una convenzione di denominazione. Utilizzo di URL personalizzati nidificati come /brand1/aboutus, brand2/aboutus, brand3/aboutus