Che cosa fa il Dispatcher, e cosa no
Il Dispatcher è un modulo Apache che sta davanti all'istanza Publish di AEM con due compiti: mettere in cache le risposte per servirle senza interrogare AEM e filtrare le richieste, lasciando passare solo quelle legittime. Una configurazione fatta male produce i due problemi opposti: pagine lente perché nulla viene messo in cache, oppure contenuti vecchi e URL interni esposti. Questa bozza descrive le regole che controlliamo per prime. Il servizio completo è descritto nella pagina performance, Dispatcher e CDN; per le altre competenze vedi l'hub AEM.
Le indicazioni valgono sia per AEM on-premise sia per AEM as a Cloud Service, dove la struttura dei file è più rigida e viene validata in pipeline. Dove le differenze contano, le segnaliamo; i dettagli di versione vanno sempre confrontati con la documentazione Adobe corrente. [VERIFICARE]
Filtri: parti da «nega tutto»
La regola di sicurezza più importante è l'approccio a lista bianca: la prima regola nega ogni richiesta, quelle successive consentono solo ciò che serve davvero, cioè pagine HTML, clientlibs, asset del DAM e poco altro. Con questo approccio un nuovo endpoint aggiunto dagli sviluppatori non diventa pubblico per distrazione.
Bisogna bloccare in modo esplicito i percorsi e i selettori che espongono la struttura del repository, anche se la regola generale li nega già. Un secondo livello di difesa evita regressioni quando qualcuno allarga un filtro.
/filter {
/0001 { /type "deny" /url "*" }
/0010 { /type "allow" /method "GET" /url "/content/*" /extension '(html|json)' }
/0020 { /type "allow" /method "GET" /url "/etc.clientlibs/*" }
/0030 { /type "allow" /method "GET" /url "/content/dam/*" }
# Selettori che espongono il repository
/0090 { /type "deny" /selectors '(feed|rss|pages|languages|blueprint|infinity|tidy|sysview|docview|query|[0-9-]+|jcr:content)' /extension '(json|xml|html|feed)' }
}Nell'esempio il filtro /0090 blocca i selettori più usati per enumerare il contenuto, come .infinity.json e .tidy.json. L'elenco va adattato al progetto: se un componente usa una risposta JSON legittima con un selettore, quel selettore va consentito in modo mirato, non rimuovendo la regola.
Cache: cosa si memorizza e per quanto
Per impostazione predefinita il Dispatcher mette in cache le risposte GET che rispondono 200, senza query string, e le invalida tramite il file di stato (.stat) quando AEM pubblica una pagina. Il parametro /statfileslevel decide fino a che profondità dell'albero un'attivazione invalida le altre pagine: troppo basso e ogni pubblicazione svuota gran parte della cache, troppo alto e le pagine che includono contenuti di altri rami restano vecchie.
Sui siti con molti parametri di tracciamento (utm, gclid, fbclid) la regola /ignoreUrlParams evita che ogni URL con un parametro diverso venga trattata come una pagina nuova e salti la cache. È una delle correzioni più semplici e con più effetto che si possano fare.
/ignoreUrlParams: ignorare i parametri di marketing che non cambiano il contenuto./serveStaleOnError: servire la copia in cache se AEM non risponde, invece di mostrare un errore./enableTTL: rispettare gli header di scadenza inviati da AEM per contenuti che devono scadere da soli./gracePeriod: tollerare brevi ritardi tra pubblicazione e invalidazione quando ci sono più Dispatcher.- Escludere dalla cache le risposte personalizzate o legate alla sessione, che non devono mai essere condivise tra utenti.
Header HTTP e CDN
Dispatcher e CDN si dividono i compiti con gli header di cache. Un'impostazione comune è far memorizzare la pagina HTML dalla CDN per un tempo breve e dal browser per un tempo ancora più breve o nullo, mentre per le risorse versionate (clientlibs, immagini con hash) si imposta una scadenza lunga. Con l'header Surrogate-Control o equivalenti si possono dare istruzioni alla CDN diverse da quelle del browser.
Sul fronte della sicurezza, gli header che consigliamo di impostare a livello Apache sono: Strict-Transport-Security, X-Content-Type-Options: nosniff, Referrer-Policy e una Content-Security-Policy introdotta prima in modalità report, perché una policy troppo rigida può rompere script di terze parti.
<LocationMatch "^/content/.*\.htmlquot;>
Header set Cache-Control "max-age=300"
Header set Surrogate-Control "max-age=3600, stale-while-revalidate=600"
</LocationMatch>
<LocationMatch "^/etc.clientlibs/.*">
Header set Cache-Control "max-age=2592000, immutable"
</LocationMatch>Invalidazione e purge
L'invalidazione parte dall'istanza Author tramite replication verso Publish, che a sua volta chiama il Dispatcher. Il Dispatcher accetta richieste di invalidazione solo da indirizzi autorizzati (/allowedClients): lasciarlo aperto significa permettere a chiunque di svuotare la cache. Se la CDN ha una propria cache, serve un secondo passaggio di purge, automatico o via API, altrimenti il Dispatcher è aggiornato ma l'utente vede ancora la versione precedente. Nel Cloud Service questo flusso è gestito dalla piattaforma, ma restano a carico del progetto le regole di cache e gli header.
Come verificare che funzioni
Una configurazione non si valida «a vista». Usiamo tre controlli: validazione sintattica con gli strumenti del Dispatcher, test in locale con il Dispatcher in container e un controllo mirato dall'esterno con richieste di prova sui percorsi sensibili. Nel Cloud Service la validazione è parte della pipeline di Cloud Manager.
Poi si misura: percentuale di richieste servite dalla cache (cache hit ratio), tempi di risposta (TTFB) e carico sull'istanza Publish. Un cache hit ratio basso sulle pagine HTML è quasi sempre dovuto a query string non ignorate, a risposte con cookie o a invalidazioni troppo ampie.
- Nessun percorso interno (/system, /crx, /bin) raggiungibile dall'esterno.
- Selettori di enumerazione del contenuto bloccati e verificati con richieste di prova.
- Parametri di tracciamento ignorati dalla cache.
- /allowedClients ristretto agli indirizzi necessari.
- Header di sicurezza presenti su tutte le risposte HTML.
- TTL di CDN, Dispatcher e browser documentati e coerenti tra loro.
Dove la cache incontra le prestazioni
Una cache ben configurata è la base per tempi di risposta bassi, ma non basta per superare le soglie di Google su LCP e INP: servono anche immagini, JavaScript e font ottimizzati. Ne parliamo in Core Web Vitals su AEM. Se invece la configurazione fa parte di una migrazione, la checklist completa è in migrare ad AEM Cloud Service.
Servizio correlato
Performance, Dispatcher e CDN per AEMPanoramica di tutte le competenze: consulenza Adobe Experience Manager.
Vuoi far verificare la tua configurazione Dispatcher?
Analizziamo filtri, cache e header della tua installazione e ti consegniamo un elenco di interventi in ordine di priorità.
Richiedi una revisione