Impostazioni configurazione OSGi osgi-configuration-settings
OSGi è un elemento fondamentale nello stack tecnologico dell’AEM. Viene utilizzato per controllare i bundle compositi dell'AEM e la loro configurazione.
OSGi "fornisce le primitive standardizzate che consentono di creare applicazioni a partire da componenti di piccole dimensioni, riutilizzabili e collaborativi. Questi componenti possono essere composti in un’applicazione e distribuiti".
Questa funzionalità consente una facile gestione dei bundle, poiché possono essere arrestati, installati e avviati singolarmente. Le interdipendenze vengono gestite automaticamente. Ogni componente OSGi (vedi Specifiche OSGi) è contenuto in uno dei vari bundle. Quando si lavora con l’AEM, esistono diversi metodi per gestire le impostazioni di configurazione per tali bundle; vedi Configurazione di OSGi per ulteriori dettagli e le pratiche consigliate.
Le seguenti impostazioni di configurazione OSGi (elencate in base al bundle) sono rilevanti per l’implementazione del progetto. Non tutte le impostazioni elencate devono essere regolate, alcune sono menzionate per aiutarti a capire come funziona l'AEM.
Listener di eventi di replica AEM Configura:
-
Il Modalità di esecuzione, in cui gli eventi di replica vengono distribuiti ai listener. Ad esempio, se è definito come autore, è il sistema che "avvia" la replica.
-
Aggiungere la modalità di esecuzione pubblicare se il codice del progetto elabora gli eventi di replica (replica inversa) in un ambiente di pubblicazione. Ad esempio, quando Dispatcher viene utilizzato per eseguire il flushing dall’ambiente di pubblicazione o quando si verifica la replica standard in altre istanze di pubblicazione.
Listener di modifica dell’archivio AEM Configura:
- Il Percorsi, posizioni per l’ascolto degli eventi dell’archivio pronti per la distribuzione.
Archivio client CRX Sling Configurare l’accesso all’archivio dei contenuti sottostante.
- Il Password amministratore devono essere modificate dopo l'installazione per garantire che protezione della tua istanza.
- Altre modifiche non dovrebbero essere necessarie e occorre prestare attenzione in quanto possono influire sull’accesso all’archivio.
Console di gestione Apache Felix OSGi Configura:
- Plug-in, gli elementi di navigazione principali (plug-in della console) da rendere disponibili nel Console di gestione web Apache Felix come voci di menu di primo livello. Disattiva qualsiasi elemento non necessario in quanto ciascuno richiede spazio e risorse.
La password deve essere modificata dopo l'installazione iniziale per garantire che protezione della tua istanza.
Registratore dati di richieste personalizzabili Apache Sling Configura:
- Nome logger e Formato registro per configurare il percorso e il formato della registrazione delle richieste e degli accessi (impostazione predefinita:
request.log
). Questo file di registro è essenziale per l’analisi delle prestazioni o delle funzionalità di debug relative alla catena web. È abbinato al Logger richieste Apache Sling.
Consulta Registrazione AEM e Sling Logging.
Pool di thread eventi Apache Sling Configura:
-
Dimensione minima pool e Dimensione massima pool, la dimensione del pool utilizzato per contenere i thread evento.
-
Dimensione coda, la dimensione massima della coda del thread se il pool è esaurito.
Il valore consigliato è-1
perché imposta la coda su illimitata. Se viene fissato un limite, potrebbero verificarsi perdite al superamento di tale limite. -
La modifica di queste impostazioni può migliorare le prestazioni in scenari con un numero elevato di eventi. Ad esempio, un uso intensivo di DAM AEM o di Workflow.
-
I valori specifici dello scenario devono essere stabiliti utilizzando test.
-
Queste impostazioni possono influire sulle prestazioni dell’istanza, pertanto non modificarle senza un motivo valido e la dovuta considerazione.
Apache Sling GET Servlet Configura alcuni aspetti del rendering:
- Indice automatico per attivare/disattivare il rendering della directory per la navigazione.
- Abilita (o disabilita) le rappresentazioni predefinite, ad esempio HTML, Testo normale, JSON, o XML.
Non disabilitare JSON.
Gestore JavaScript Apache Sling Configurare le impostazioni per la compilazione di file Java come script (servlet).
Alcune impostazioni possono influire sulle prestazioni. Se possibile, disabilita queste impostazioni, in particolare per un’istanza di produzione.
-
VM di origine e VM di destinazione, definiscono la versione JDK utilizzata come JVM di runtime
-
per le istanze di produzione:
- disable Genera informazioni di debug
Programma di installazione di Apache Sling JCR Questi parametri probabilmente non richiedono configurazione, ma possono essere utili da conoscere durante lo sviluppo o il debug. Ad esempio, le cartelle di installazione possono essere utili per l'archiviazione o l'estrazione o per la creazione di un pacchetto.
-
Nome delle cartelle di installazione regexp e Profondità massima della gerarchia delle cartelle di installazione : specifica dove e a quale profondità vengono cercate le risorse da installare nelle cartelle del repository. Quando viene utilizzato un carattere jolly (come in .*/install) vengono cercate tutte le corrispondenze appropriate, ad esempio,
/libs/sling/install
e/libs/cq/core/install
. -
Percorso di ricerca, elenco di percorsi che jcrinstall cerca le risorse da installare, con un numero che indica il fattore di ponderazione per tale percorso.
Gestore evento processo Apache Sling Configurare i parametri che gestiscono la pianificazione dei job:
-
Intervallo tra tentativi, Numero massimo di tentativi, Numero massimo processi paralleli, Riconosci tempo di attesa, tra gli altri.
-
La modifica di queste impostazioni può migliorare le prestazioni in scenari con un numero elevato di processi, ad esempio l’utilizzo intensivo di DAM e Flussi di lavoro AEM.
-
I valori specifici dello scenario devono essere stabiliti utilizzando test.
-
Non modificare queste impostazioni senza motivo, cambiale solo dopo la dovuta considerazione.
Gestore script Apache Sling JSP Configura le impostazioni relative alle prestazioni per il gestore di script JSP. Per migliorare le prestazioni, disattiva il più possibile.
In particolare, per le istanze di produzione:
- disable Genera informazioni di debug
- disable Mantieni Java generato™
- disable Contenuto mappato
- disable Visualizza frammenti di origine
Configurazione registrazione Apache Sling Configura:
-
Livello registro e File di registro, per definire la posizione e il livello di registro della configurazione di registrazione centrale (error.log). Il livello può essere impostato su uno dei seguenti
DEBUG
,INFO
,WARN
,ERROR
, eFATAL
. -
Numero di file di registro e Soglia file di registro per definire le dimensioni e la rotazione della versione del file di registro.
-
Pattern messaggio definisce il formato dei messaggi di registro.
Consulta Registrazione AEM e Sling Logging.
Configurazione del logger di registrazione Sling Apache (configurazione di fabbrica) Configura:
-
Livello registro, File di registro e Formato del messaggio per definire i dettagli del file di registro e dei messaggi.
-
Logger per definire la categoria; ad esempio, registra solo per com.day.cq.
-
Utilizzando Configurazioni di fabbrica, è possibile aggiungere qualsiasi numero di configurazioni aggiuntive per soddisfare i vari livelli di registro e le varie categorie necessarie.
-
Tali configurazioni sono utili durante lo sviluppo; ad esempio, per registrare i messaggi di TRACE per un servizio specifico in un file di registro specifico.
-
Tali configurazioni sono utili in un ambiente di produzione; ad esempio, per registrare messaggi su un servizio specifico in un singolo file di registro per un monitoraggio più semplice.
Consulta Registrazione AEM e Sling Logging.
Configurazione writer di registrazione Sling Apache (configurazione di fabbrica) Configura:
-
File di registro per definire l'esistenza di un file di log.
-
Numero di file di registro per definire la rotazione della versione.
-
Il writer può essere utilizzato da un Configurazione logger registrazione Sling Apache configurazione.
-
Tali configurazioni sono utili durante lo sviluppo; ad esempio, per registrare i messaggi di TRACE per un servizio specifico in un file di registro specifico.
-
Tali configurazioni sono utili in un ambiente di produzione; ad esempio, per registrare messaggi su un servizio specifico in un singolo file di registro per un monitoraggio più semplice.
Consulta Registrazione AEM e Sling Logging.
Servlet principale Apache Sling Configura:
- Numero di chiamate per richiesta e Profondità di ricorsione per proteggere il sistema da ricorsioni infinite e chiamate di script eccessive.
Servizio tipo MIME Apache Sling Configura:
- Tipi MIME per aggiungere al sistema i tipi richiesti dal progetto. Questa operazione consente di:
GET
richiedere a un file di impostare l’intestazione del tipo di contenuto corretta per collegare il tipo di file e l’applicazione.
Filtro referrer Apache Sling Per risolvere i problemi di sicurezza noti con CSRF (Cross-Site Request Forgery) in CRX WebDAV e Apache Sling, è necessario configurare il filtro Referrer.
Il servizio di filtro dei referenti è un servizio OSGi che consente di configurare:
- quali metodi http filtrare
- se è consentita un’intestazione referente vuota
- e un elenco di server da consentire in aggiunta all’host del server.
Consulta la Elenco di controllo della sicurezza: problemi relativi alla falsificazione di richieste tra siti diversi per ulteriori dettagli.
Logger richieste Apache Sling Configura:
-
vari parametri per definire la modalità di registrazione delle richieste.
-
Abilita registro richieste, per attivare o disattivare.
-
Abilita log degli accessi, per attivare o disattivare.
Accoppiato con Registratore dati di richieste personalizzabili Apache Sling.
Consulta Registrazione AEM e Sling Logging.
Apache Sling Resource Resolver Factory Configura gli aspetti centrali della risoluzione delle risorse Sling:
-
Percorsi di ricerca delle risorse, aggiungi qualsiasi percorso specifico del progetto (ma non rimuovi)
/libs
o/apps
). -
URL virtuali per definire le mappature degli URL personalizzati.
-
Mappature URL per definire eventuali alias. Ad esempio, da
/content
a/
. -
Posizione mappatura, la configurazione del mapper esternalizzata in
/etc/map
. -
Utilizza l’installazione locale (ad esempio, utilizza
https://localhost:4502/system/console/jcrresolver
) per determinare quale Resource Resolver è attivo.
Consulta: https://cwiki.apache.org/confluence/display/SLING/Flexible+Resource+Resolution.
Apache Sling Servlet/Script Resolver e Error Handler Il servlet Sling e lo script Resolver hanno più attività:
-
Viene utilizzato come
ServletResolver
per selezionare il servlet o lo script da chiamare per gestire la richiesta. -
Agisce come
SlingScriptResolver
. -
Gestisce la gestione degli errori implementando
ErrorHandler
per selezionare servlet e script di gestione degli errori come viene utilizzato per risolvere servlet e script di elaborazione delle richieste.
È possibile impostare vari parametri, tra cui:
-
Percorsi di esecuzione : elenca i percorsi per la ricerca di script eseguibili. Configurando percorsi specifici, puoi limitare quali script possono essere eseguiti. Se non è configurato alcun percorso, viene utilizzato quello predefinito (
/
= root), che consente l'esecuzione di tutti gli script.
Se un valore di percorso configurato termina con una barra, la ricerca viene eseguita nell'intera sottostruttura. Senza una barra finale di questo tipo, lo script viene eseguito solo se corrisponde esattamente. -
Utente script - Questa proprietà facoltativa può specificare l'account utente del repository utilizzato per la lettura degli script. Se non viene specificato alcun account, il
admin
viene utilizzato per impostazione predefinita. -
Estensioni predefinite : elenco di estensioni per le quali viene utilizzato il comportamento predefinito. L’ultimo segmento di percorso del tipo di risorsa può essere utilizzato come nome dello script.
Configurazione proxy dei componenti HTTP Apache : configurazione proxy per tutto il codice utilizzando il client HTTP Apache, utilizzato quando viene creato un HTTP. Ad esempio, durante la replica.
Durante la creazione di una configurazione, non modificare la configurazione di fabbrica. Creare invece una configurazione di fabbrica per questo componente utilizzando la gestione della configurazione disponibile qui: https://localhost:4502/system/console/configMgr/. La configurazione proxy è disponibile in org.apache.http.proxyconfigurator.
Day CQ Antispam Configura il servizio anti-spam (Akismet) utilizzato. Questa funzione richiede la registrazione di quanto segue:
- Provider
- Chiave API
- URL registrato
Adobe Granite HTML Library Manager Configura per controllare la gestione delle librerie client (css o js), incluso, ad esempio, il modo in cui viene visualizzata la struttura sottostante.
-
Per le istanze di produzione:
- abilita Minimizza (per rimuovere i caratteri CRLF e gli spazi vuoti).
- abilita Gzip (per consentire l’estrazione e l’accesso ai file con una sola richiesta).
- disable Debug
- disable Tempistica
-
Per lo sviluppo JS (in particolare durante il debug/debug del firewall):
- disable Minimizza
- abilita Debug per separare i file per il debug e utilizzarli con fire bug.
- abilita Tempistica se sono interessati ai tempi.
- abilita Debug per visualizzare i messaggi del registro della console JS.
Gestore autenticazione intestazione HTTP Day CQ Impostazioni di sistema per il metodo di autenticazione di base della richiesta HTTP.
Quando si utilizza gruppi utenti chiusi, puoi configurare, tra gli altri, quanto segue:
- Realm HTTP
- Il Pagina di accesso predefinita
Servizio Day CQ Link Checker Seleziona e, se necessario, configura:
-
Periodo modulo di pianificazione per definire l'intervallo di controllo automatico dei collegamenti esterni.
-
Verifica Intervallo di tolleranza collegamenti non valido per il periodo dopo il quale un collegamento esterno non riuscito è considerato non valido.
-
Modelli di sostituzione verifica collegamenti, per definire eventuali percorsi da escludere dal controllo dei collegamenti.
Attività Day CQ Link Checker Configurare le impostazioni per un'attività di verifica collegamento singolo (un'attività che controlla un collegamento esterno):
-
Controlla gli intervalli definiti in Intervallo di prova collegamento valido e Intervallo di prova collegamento non valido
-
I vari parametri relativi ai proxy per l'accesso a Internet e NTLM necessari per l'accesso esterno durante la verifica di un collegamento.
Day CQ Mail Service Configura il nome host e i dettagli di accesso per il server di posta. Consulta la sezione Configurazione del servizio di posta.
Newsletter Day CQ MCM Configura le varie impostazioni utilizzate con la newsletter.
Mappatura radice Day CQ Configura:
- Percorso di destinazione per definire dove una richiesta a "
/
" viene reindirizzato a.
Nell’AEM sono disponibili due interfacce:
- l’interfaccia touch è quella standard
- e l’interfaccia classica obsoleta è ancora completamente operativa
Utilizzando AEM Root Mapping puoi configurare l’interfaccia utente che desideri impostare come predefinita per la tua istanza:
-
Per impostare l'interfaccia touch come interfaccia predefinita, Percorso di destinazione deve puntare ai seguenti elementi:
code language-shell /projects.html
-
Per impostare l'interfaccia classica come interfaccia predefinita, Percorso di destinazione deve puntare ai seguenti elementi:
code language-shell /welcome.html
Adobe Gestore autenticazione SSO Granite - Configurare i dettagli SSO (Single Sign On). Questi dettagli sono spesso necessari nelle impostazioni di authoring Enterprise, spesso con LDAP.
Sono disponibili diverse proprietà di configurazione:
-
Percorso
Percorso per cui è attivo il gestore di autenticazione. Se questo parametro viene lasciato vuoto, il gestore di autenticazione viene disabilitato. Ad esempio, il percorso / determina l’utilizzo del gestore di autenticazione per l’intero archivio. -
Classifica dei servizi
Il valore Classifica servizio framework OSGi viene utilizzato per indicare l’ordine utilizzato per chiamare questo servizio. Questo valore è unint
valore in cui i valori più alti indicano una precedenza maggiore.
Il valore predefinito è0
. -
Nomi intestazione
Nomi delle intestazioni che potrebbero contenere un ID utente. -
Nomi cookie
Nomi dei cookie che potrebbero contenere un ID utente. -
Nomi parametri
Nomi dei parametri di richiesta che potrebbero fornire l’ID utente. -
Mappa utente
Per gli utenti selezionati, il nome utente estratto dalla richiesta HTTP può essere sostituito con uno diverso nell’oggetto credenziali. La mappatura è definita qui. Se il nome utenteadmin
viene visualizzato su entrambi i lati della mappa, la mappatura viene ignorata. Il carattere "=" deve essere preceduta da "". -
Formato
Indica il formato in cui viene fornito l’ID utente. Usa:Basic
se l’ID utente è codificato nel formato di autenticazione HTTP BasicAsIs
se l’ID utente è fornito in testo normale o qualsiasi valore di espressione regolare applicato deve essere utilizzato così com’è o qualsiasi espressione regolare
Filtro di debug Day CQ WCM Ciò è utile quando si sviluppa in quanto consente l'uso di suffissi come ?debug=layout durante l'accesso a una pagina. Ad esempio, https://localhost:4502/cf#/content/geometrixx/en/support.html?debug=layout fornisce informazioni di layout che possono essere di interesse per lo sviluppatore.
- Per garantire prestazioni e sicurezza, disattiva nelle istanze di produzione.
Filtro WCM Day CQ Configura:
-
Modalità WCM per definire la modalità predefinita.
-
In un’istanza Autore, questa modalità potrebbe essere
edit
,disable,preview
, oanalytics
.
È possibile accedere alle altre modalità dalla barra laterale o dal suffisso?wcmmode=disabled
può essere utilizzato per emulare un ambiente di produzione. -
In un’istanza di pubblicazione, questa modalità deve essere impostata su
disabled
per garantire che nessun'altra modalità sia accessibile.
Configurazione verifica collegamenti Day CQ WCM Configura:
- Elenco delle configurazioni di riscrittura per specificare un elenco di posizioni per le configurazioni di verifica collegamenti basate sul contenuto. Le configurazioni possono essere basate sulla modalità di esecuzione. Questo fatto è importante per distinguere tra ambienti di authoring e di pubblicazione, in quanto le impostazioni del Link Checker possono essere diverse.
Day CQ WCM Page Manager Factory Configura:
- Controllo attivazione sottoalbero pagine per consentire a un utente (senza autorizzazioni di replica) di eliminare o spostare pagine (anche se le pagine non sono attivate).
Day CQ WCM Page Processor Configura:
- Percorsi, un elenco di posizioni in cui il sistema ascolta le modifiche apportate alla pagina prima di attivare una
jcr:Event
.
Tracciamento impression pagina di Adobe Per un’istanza Autore, configura come segue:
- sling.auth.requirements: imposta il valore di questa proprietà su
-/libs/wcm/stats/tracker
Statistiche pagina WCM Day CQ Per un’istanza Publish, configura:
-
URL per l’invio dei dati per configurare l’URL utilizzato per tenere traccia delle statistiche della pagina (fondamentale se una richiesta di tracciamento passa attraverso Dispatcher); ad esempio, l’impostazione predefinita è
https://localhost:4502/libs/wcm/stats/tracker
. -
Script di tracciamento abilitato per attivare (
true
) o disattiva (false
) l’inclusione dello script di tracciamento nelle pagine. Il valore predefinito èfalse
.
Gestione versioni WCM Day CQ Controlla se e come le versioni vengono gestite nel sistema:
-
Crea versione all'attivazione, abilitato in un'installazione standard
-
Abilita rimozione
-
Percorsi di rimozione, i percorsi cercati da un’azione di ricerca.
-
Percorsi di controllo delle versioni impliciti, i percorsi in cui è attivo il controllo delle versioni implicito.
-
Età massima versione, l’età massima (in giorni) di una versione
-
Numero max versioni, il numero massimo di versioni da mantenere
Consulta Rimozione versione per ulteriori informazioni.
Servizio di notifica e-mail flusso di lavoro Day CQ Configura le impostazioni e-mail per le notifiche inviate da un flusso di lavoro.
CQ Rewriter HTML Parser Factory
Controlla il parser HTML per il rewriter CQ.
- Tag aggiuntivi da elaborare - È possibile aggiungere o rimuovere i tag HTML da elaborare tramite il parser. Per impostazione predefinita, vengono elaborati i seguenti tag: A,IMG,AREA,FORM,BASE,LINK,SCRIPT,BODY,HEAD.
- Mantieni Camel Case - Per impostazione predefinita, il parser HTML converte gli attributi in notazione Camel (ad esempio,
eBay
) in minuscolo (ad esempio,ebay
). È possibile disattivare questa impostazione per mantenere gli attributi Camel Case. Questa impostazione è utile quando si utilizzano framework frontend come Angular 2.
Pool connessioni JDBC Day Commons Configurare l'accesso a un database esterno utilizzato come origine del contenuto.
Configurazione di fabbrica, che consente di configurare più istanze.
Rewriter CDN La comunicazione tra l’AEM e una rete CDN deve essere garantita in modo che gli asset/dati binari siano consegnati in modo sicuro all’utente finale. Questo processo prevede le due attività seguenti:
- La prima volta (o dopo la scadenza nella cache) si accede alla risorsa dall’AEM tramite la rete CDN.
- Accesso sicuro alla risorsa memorizzata nella cache in CDN. Una volta che la risorsa è memorizzata nella cache in CDN, la richiesta non viene inviata a AEM e tutti gli utenti che hanno accesso a tale risorsa in devono essere serviti da CDN.
AEM fornisce un rewriter per riscrivere gli URL delle risorse interne in URL CDN esterni. Riscrive i collegamenti da passare alla rete CDN, inclusa una firma JWS, e scade per consentire l’accesso sicuro alla risorsa. Questa funzione deve essere utilizzata nelle istanze di authoring.
Il flusso complessivo è il seguente:
-
L’utente si autentica con AEM e richiede una pagina con risorse.
-
La pagina richiesta contiene una risorsa simile a
/content/dam/geometrixx-media/articles/paladin_trailer.jpg/jcr:content/renditions/cq5dam.thumbnail.319.319.png
-
Il rewriter trasforma il collegamento in un URL CDN contenente una firma JWS:
CDN_domain/content/dam/geometrixx-media/articles/paladin_trailer.jpg/_jcr_content/renditions/cq5dam.thumbnail.319.319.png?cdn_sign=JWS_SIGNATURE
-
Il browser dell’utente inoltra quindi la richiesta di risorsa al server CDN
-
La rete CDN deve essere configurata per inoltrare la richiesta all’AEM insieme al
cdn_sign
parametro. -
Un gestore di autenticazione convalida
cdn_sign
e restituisce la risorsa alla rete CDN che viene quindi consegnata all'utente
Il flusso tra il browser dell’utente, la rete CDN e l’AEM può essere visualizzato come segue.
CDNConfigServiceImpl Fornisce configurazioni CDN
La funzione di riscrittura CDN può essere attivata fornendo Nome del dominio di distribuzione CDN nella configurazione per com.adobe.cq.cdn.rewriter.impl.CDNConfigServiceImpl.
Il servizio contiene anche altre opzioni di configurazione come abilitare/disabilitare la riscrittura CDN, prefissi di percorso per i quali viene eseguita la riscrittura CDN, valori TTL e protocollo (HTTP o HTTPS).
CDNRewriter Un rewriter per riscrivere gli URL immagine interni in URL CDN
Il Attributi tag Il valore in com.adobe.cq.cdn.rewriter.impl.CDNRewriter può essere definito in modo che vengano riscritti solo i collegamenti immagine selettivi.