URL personalizzati Dispatcher | AEM

Questo documento ti aiuterà a capire come Adobe Experience Manager gestisce gli URL personalizzati e le tecniche aggiuntive, ad esempio l’utilizzo di regole di riscrittura per avvicinare il contenuto al limite della consegna.

Descrizione description

Ambiente

Adobe 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: Devi 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 mappa sling per un reindirizzamento interno. Queste mappe sono visibili nella console Felix delle istanze dell'AEM (/system/console/jcrresolver)

Ecco una schermata di una voce 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 / tramite 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.

Nel file farm di Dispatcher è presente una sezione di configurazione:

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

Questa configurazione comunica a 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 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 scorri l’URL con /Aboutus invece di /aboutus funzionerà comunque e consentirà di recuperare la pagina giusta.

Per creare una regola di riscrittura a questo scopo è necessario creare 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 a cui devono essere applicati 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