Configurações do OSGi

O OSG é um elemento fundamental na pilha de tecnologia de AEM. É usado para controlar os pacotes compostos de AEM e sua configuração.

O OSGi "fornece as primitivas padronizadas que permitem que os aplicativos sejam construídos a partir de componentes pequenos, reutilizáveis e colaborativos. Esses componentes podem ser compostos em um aplicativo e implantados".

Isso permite o gerenciamento fácil de pacotes, pois eles podem ser interrompidos, instalados e iniciados individualmente. As interdependências são tratadas automaticamente. Cada componente OSGi (consulte a Especificação OSGi) está contido em um dos vários pacotes. Ao trabalhar com AEM existem vários métodos de gestão das definições de configuração para esses pacotes; consulte Configuração do OSGi para obter mais detalhes e as práticas recomendadas.

As seguintes configurações OSGi (listadas de acordo com o pacote) são relevantes para a implementação do projeto. Nem todas as configurações listadas precisam de ajuste, algumas são mencionadas para ajudá-lo a entender como AEM opera.

AEM Replication Evento ListenerConfigurar:

• Os Modos de Execução, nos quais os eventos de replicação serão distribuídos aos ouvintes. Por exemplo, se definido como autor, esse é o sistema que "iniciará" a replicação.

• O modo de execução publish precisa ser adicionado se o código do projeto processar eventos de replicação (replicação reversa) em um ambiente de publicação. Por exemplo, quando o dispatcher é usado para liberar do ambiente de publicação ou quando ocorre replicação padrão para outras instâncias de publicação.

AEM Listener de alteração do repositórioConfigurar:

• Os locais Caminhos para acompanhar eventos de repositório prontos para distribuição.

CRX Sling Client RepositoryConfigure o acesso ao repositório de conteúdo subjacente.

• A Senha de Admin deve ser alterada após a instalação para garantir a segurança da sua instância.

• Outras alterações não devem ser necessárias e devem ser tomadas precauções, uma vez que podem afetar o acesso ao repositório.

Wiki Mail ServiceConfigure as configurações de email para emails enviados por um wiki.

Apache Felix OSGi Management ConsoleConfigurar:

• Plug-ins, os itens de navegação principais (plug-ins do console) que estarão disponíveis no Apache Felix Web Management Consoleas como itens de menu de nível superior. Desative qualquer item de que você não precise, pois cada um requer espaço e recursos.

Apache Sling Customizable Request Data LoggerConfigurar:

• Nome do agente de log e Formato de log para configurar o local e o formato do registro de solicitação e acesso (padrão: request.log). Esse arquivo de log é essencial ao analisar o desempenho ou a funcionalidade de depuração relacionada à cadeia da Web.

  Isso é emparelhado com o Apache Sling Request Logger.

Para obter mais informações, consulte AEM Log e Sling Logging.

Apache Sling Event Thread PoolConfigurar:

• Tamanho do pool mín. e Tamanho máximo do pool, o tamanho do pool usado para armazenar threads do evento.

• Tamanho da fila, o tamanho máximo da fila de encadeamento se o pool estiver esgotado.

  O valor recomendado é -1, pois isso define a fila como ilimitada; se um limite for definido, as perdas podem ocorrer quando for excedido.

• Alterar essas configurações pode ajudar no desempenho em cenários com um número elevado de eventos; por exemplo, uso pesado AEM DAM ou Fluxo de trabalho.

• Valores específicos do seu cenário devem ser estabelecidos por meio de testes.

• Essas configurações podem afetar o desempenho da sua instância, portanto, não as altere sem motivo e consideração.

Apache Sling GET ServletConfigure alguns aspectos da renderização:

• O Avanço Automático permite/desativa a renderização do diretório para navegação.

• Ative (ou desative) execuções padrão, como HMTL, Texto simples, ​​JSON ou XML.

  Você não deve desativar o JSON.

Apache Sling Java Script HandlerDefine as configurações para a compilação de arquivos .java como scripts (servlets).

Determinadas configurações podem afetar o desempenho; elas devem ser desativadas sempre que possível, principalmente para uma instância de produção.

• S VM de origem e VM de Público alvo, definem a versão do JDK como a usada como JVM de tempo de execução

• para instâncias de produção:

  • desabilitar Gerar Informações de Depuração

Apache Sling JCR InstallerEsses parâmetros provavelmente não precisam de configuração, mas podem ser úteis ao desenvolver ou depurar. Por exemplo, as pastas de instalação podem ser úteis para fazer check-in/check-out ou criar um pacote.

• Nome das pastas de instalação re-expanda a profundidade máxima da hierarquia das pastas de instalação - especifique onde e em que profundidade as pastas do repositório serão pesquisadas para que os recursos sejam instalados. Quando um curinga é usado (como em .*/install) todas as correspondências apropriadas serão pesquisadas, por exemplo, /libs/sling/install e /libs/cq/core/install.

• Caminho de pesquisa, lista de caminhos que se desinstalam procura recursos a serem instalados, juntamente com um número indicando o fator de ponderação para esse caminho.

Apache Sling Job HandlerConfigurar parâmetros que gerenciam a programação de tarefas:

• Intervalo de tentativas, Tentativas ​​máximas, Trabalhos paralelos máximos, Tempo de espera de reconhecimento, entre outros.

• A alteração dessas configurações pode melhorar o desempenho em cenários com um alto número de trabalhos; por exemplo, uso intenso de AEM DAM e Workflows.

• Valores específicos do seu cenário devem ser estabelecidos por meio de testes.

• Não altere essas configurações sem motivo, só altere após a devida consideração.

Apache Sling JSP Script HandlerDefine as configurações relevantes para o desempenho do manipulador de scripts JSP. Para melhorar o desempenho, você deve desativar o máximo possível.

Em especial, para as instâncias de produção:

• desabilitar Gerar Informações de Depuração
• desativar Manter Java Gerado
• desabilitar Conteúdo mapeado
• desativar Apresentar Fragmentos de Origem

Configuração de registro do Apache SlingConfigurar:

• Log Leveland Log File, para definir o local e o nível de log da configuração central do log (error.log). O nível pode ser definido como DEBUG, INFO, WARN, ERROR e FATAL.

• Número de arquivos de log e limites do arquivo de log para definir o tamanho e a rotação da versão do arquivo de log.

• O padrão de mensagem define o formato das mensagens de log.

Para obter mais informações, consulte AEM Log e Sling Logging.

Configuração do Apache Sling Logging Logger (Configuração de fábrica) Configurar:

• Nível de log, Arquivo de Log e Formatação de Mensagem para definir detalhes do arquivo de log e das mensagens.

• ​​Loggeror para definir a categoria; por exemplo, registre apenas com.day.cq.

• Ao usar Configurações de fábrica, qualquer número de configurações adicionais pode ser adicionado para atender aos vários níveis de log e categorias necessários.

• Essas configurações são úteis durante o desenvolvimento; por exemplo, para registrar mensagens de TRACE para um serviço específico em um arquivo de log específico.

• Essas configurações são úteis em um ambiente de produção; por exemplo, para que mensagens sobre um serviço específico sejam registradas em um arquivo de log individual para facilitar o monitoramento.

Para obter mais informações, consulte AEM Log e Sling Logging.

Configuração do Apache Sling Logging Writer (Configuração de fábrica) Configurar:

• Arquivo de log para definir a existência de um arquivo de log.

• Número de arquivos de log para definir a rotação da versão.

• O gravador pode ser usado por uma configuração Apache Sling Logging Logger Configuration.

• Essas configurações são úteis durante o desenvolvimento; por exemplo, para registrar mensagens de TRACE para um serviço específico em um arquivo de log específico.

• Essas configurações são úteis em um ambiente de produção; por exemplo, para que mensagens sobre um serviço específico sejam registradas em um arquivo de log individual para facilitar o monitoramento.

Para obter mais informações, consulte AEM Log e Sling Logging.

Apache Sling Principal ServletConfigurar:

• Número de chamadas por solicitação e profundidade de recorrência para proteger seu sistema contra chamadas de recursão infinitas e de script excessivas.

Apache Sling MIME Type ServiceConfigurar:

• Tipo MIME para adicionar ao sistema os necessários para o seu projeto. Isso permite que uma solicitação GET em um arquivo defina o cabeçalho do tipo de conteúdo correto para vincular o tipo de arquivo e o aplicativo.

Apache Sling FilterPara resolver problemas de segurança conhecidos com o CSRF (Cross-Site Request Forgery) no CRX WebDAV e no Apache Sling, é necessário configurar o filtro de Quem indicou.

O serviço de filtro de quem indicou é um serviço OSGi que permite configurar:

• quais métodos http devem ser filtrados
• se um cabeçalho de quem indicou vazio é permitido
• e uma lista de servidores a ser permitida além do host do servidor.

Consulte a Lista de verificação de segurança - Problemas com a falsificação de solicitação entre sites para obter mais detalhes.

Apache Sling Request LoggerConfigure:

• vários parâmetros para definir como as solicitações são registradas.

• Ative o Log de solicitações para ativar ou desativar.

• Ative o Log de acesso para ativar ou desativar.

Isso é emparelhado com o Apache Sling Customizable Request Data Logger.

Para obter mais informações, consulte AEM Log e Sling Logging.

Apache Sling Resource Resolver FatoryConfigurar aspectos centrais da resolução de recursos Sling:

• Caminhos de pesquisa de recursos, adicione quaisquer caminhos específicos do projeto (mas não remova /libs ou /apps).

• URL virtual para definir seus mapeamentos vanity de URL.

• Mapeamentos de URL para definir qualquer alias; por exemplo, de /content para /.

• Localização de mapeamento, a configuração do mapeador externalizada em /etc/map.

• Use a instalação local (por exemplo, use http://localhost:4502/system/console/jcrresolver) para determinar qual Resolvedor de recursos está ativo.

Para obter mais informações, consulte: https://cwiki.apache.org/confluence/display/SLING/Flexible+Resource+Resolution.

Apache Sling Servlet/Script Resolver e Error HandlerO Sling Servlet e o Script Resolver têm várias tarefas:

1. É usado como ServletResolver para selecionar o Servlet ou Script para chamar para lidar com a solicitação.

2. Funciona como SlingScriptResolver.

3. Ele gerencia a manipulação de erros implementando a interface ErrorHandler usando o mesmo algoritmo para selecionar servlets e scripts que manipulam erros usados para resolver servlets e scripts de processamento de solicitação.

Vários parâmetros podem ser definidos, incluindo:

• Os Caminhos de execução listam os caminhos para procurar scripts executáveis; ao configurar caminhos específicos, você pode limitar quais scripts podem ser executados. Se nenhum caminho estiver configurado, o padrão será usado ( / = raiz), isso permitirá a execução de todos os scripts.

  Se um valor de caminho configurado terminar com uma barra, a subárvore inteira será pesquisada. Sem essa barra, o script só será executado se for uma correspondência exata.

• Usuário de script - essa propriedade opcional pode especificar a conta de usuário do repositório usada para ler os scripts. Se nenhuma conta for especificada, o usuário admin será usado por padrão.

• Extensões padrãoA lista de extensões para as quais o comportamento padrão será usado. Isso significa que o último segmento de caminho do tipo de recurso pode ser usado como o nome do script.

Day Commons GFX Font HelperAo renderizar gráficos, você pode usar DrawText para incorporar texto. Para isso, você também pode instalar suas próprias fontes:

• Defina o Caminho da fonte a ser pesquisado para fontes específicas do projeto.

  Por exemplo, /apps/myapp/fonts.

Configuração do proxy dos componentes HTTP Apache Configuração do proxy do proxy para todos os códigos usando o cliente HTTP Apache, usado quando um HTTP é feito; por exemplo, na replicação.

Ao criar uma nova configuração, não faça alterações na configuração de fábrica, mas crie uma nova configuração de fábrica para este componente usando o gerenciador de configuração disponível aqui: http://localhost:4502/system/console/configMgr/. A configuração do proxy está disponível em org.apache.http.proxyconfigurator.

Dia CQ AntispamConfigure o serviço antisspam (Akismet) usado. Isso requer que você registre o:

• Provedor
• Chave da API
• URL registrado

Adobe Granite HTML Library ManagerConfigure-o para controlar a manipulação de bibliotecas de clientes (css ou js); incluindo, por exemplo, a forma como a estrutura subjacente é vista.

• Para instâncias de produção:

  • habilite Minify (para remover caracteres CRLF e de espaço em branco).
  • habilite Gzip (para permitir que os arquivos sejam compactados e acessados com uma solicitação).
  • desativar Depurar
  • desabilitar Tempo

• Para o desenvolvimento de JS (especialmente quando firebugging/debugging):

  • desativar Minify
  • habilite Depurar a separar os arquivos para depuração e uso com firebug.
  • ative Timing no caso de interesse em tempo.
  • ative o console Depurar para ver as mensagens de log do console JS.

Configurações gerais do Manipulador de Autenticação do Cabeçalho HTTP do CQ do diaConfigurações do sistema para o método de autenticação básico da solicitação HTTP.

Ao usar grupos de usuários fechados você pode configurar (entre outros):

• Realm HTTP
• A Página de Início de Sessão Predefinida

Verificação de serviço do verificador de links CQ de dia e, se necessário, configuração:

• Período do scheduler para definir o intervalo no qual os links externos devem ser verificados automaticamente.

• Verifique Intervalo de tolerância de link inválido para o período após o qual um link externo malsucedido é considerado inválido.

• Padrões de substituição de verificação de link para definir quaisquer caminhos a serem excluídos da verificação de link.

Tarefa do verificador de links do CQ de diaConfigure as configurações para uma tarefa do verificador de links único (uma tarefa que verifica um link externo):

• Verifique os intervalos definidos em Bom Intervalo de Teste de Link e Intervalo de Teste de Link Incorreto

• Os vários parâmetros relacionados aos proxies para acesso à Internet e ao NTLM necessários para acesso externo ao verificar um link.

Dia CQ Mail ServiceConfigure o nome do host e os detalhes de acesso do servidor de email. Consulte a seção Configuração do serviço de e-mail.

Newsletter Day CQ MCM Configure as várias configurações usadas com o boletim informativo.

Mapeamento raiz do Day CQ Configuração:

• Público alvo Caminho para definir para onde uma solicitação para " /" será redirecionada.

Há duas interfaces de usuário disponíveis em AEM:

• a interface otimizada para toque foi introduzida
• e a interface clássica ainda está totalmente operacional

Usando AEM Mapeamento raiz, você pode configurar a interface que deseja ter como padrão para sua instância:

• Para ter a interface otimizada ao toque como a interface padrão, o Caminho do Público alvo deve apontar para:

     /projects.html
  

• Para ter a interface clássica como a interface padrão, o Caminho do Público alvo deve apontar para:

     /welcome.html
  

Adobe Granite SSO Authentication HandlerConfigurar detalhes do Single Sign On (SSO); essas configurações são frequentemente necessárias em configurações de autor corporativo, geralmente em conjunto com LDAP.

Várias propriedades de configuração estão disponíveis:

• ​
  PathPath para o qual este manipulador de autenticação está ativo. Se esse parâmetro for deixado em branco, o manipulador de autenticação será desativado. Por exemplo, o caminho / faz com que o manipulador de autenticação seja usado para todo o repositório.

• O valor
  de classificação do serviço de estrutura OSGi é usado para indicar a ordem usada para chamar esse serviço. Isto é um
  int quando valores mais altos designam precedência mais alta.

  O valor padrão é 0.

• Nomes
  do cabeçalhoOs nomes dos cabeçalhos que podem conter uma ID de usuário.

• Nomes de
  cookiesOs nomes dos cookies que podem conter uma ID de usuário.

• Nomes
  de parâmetrosO nome dos parâmetros de solicitação que podem fornecer a ID do usuário.

• User
  MapPara usuários selecionados, o nome de usuário extraído da solicitação HTTP pode ser substituído por outro no objeto de credenciais. O mapeamento é definido aqui. Se o nome do usuário
  admin for exibido em ambos os lados do mapa, o mapeamento será ignorado. Lembre-se de que o caractere "=" deve ser escapado com um "" à esquerda.

• ​
  FormatoIndica o formato no qual a ID de usuário é fornecida. Uso:

  • Basic se a ID do usuário estiver codificada no formato HTTP Basic Authentication
  • AsIs se a ID do usuário for fornecida em texto simples ou qualquer valor aplicado de expressão regular deve ser usado como está ou em qualquer expressão regular

Filtro de Depuração de CQ WCM de DiaÉ útil ao desenvolver, pois permite o uso de sufixos como ?debug=layout ao acessar uma página. Por exemplo, http://localhost:4502/cf#/content/geometrixx/en/support.html?debug=layout fornecerá informações de layout que podem ser de interesse para o desenvolvedor.

• Desative isso nas instâncias de produção para garantir o desempenho e a segurança.

Dia CQ WCM FiltroConfigurar:

• O Modo WCM define o modo padrão.

• Em uma instância do autor, isso pode ser edit, disable,preview ou analytics.

  Os outros modos podem ser acessados do sidekick, ou o sufixo ?wcmmode=disabled pode ser usado para emular um ambiente de produção.

• Em uma instância de publicação, isso deve ser definido como disabled para garantir que nenhum outro modo seja acessível.

Configurador do Verificador de Link do Day CQ WCM Configuração:

• Lista de configurações de regravação para especificar uma lista de locais para configurações do verificador de links baseadas em conteúdo. As configurações podem ser baseadas no modo de execução; isso é importante para distinguir entre ambientes de autor e publicação, pois as configurações do verificador de links podem ser diferentes.

Dia CQ WCM Página ProcessadorConfigurar:

• Caminhos, uma lista de locais onde o sistema escuta modificações de página antes de acionar uma jcr:Event.

Adobe Page Impressions TrackerPara uma instância do autor, configure:

• sling.auth.requirements: defina o valor dessa propriedade como -/libs/wcm/stats/tracker

Estatísticas de página do WCM CQ de diaPara obter uma configuração de instância de publicação:

• URL para enviar dados para configurar o URL usado para rastrear as estatísticas da página (é vital se uma solicitação do rastreador passar pelo dispatcher); por exemplo, o padrão é http://localhost:4502/libs/wcm/stats/tracker.

• O script de rastreamento permitiu ativar ( true) ou desativar ( false) a inclusão do script de rastreamento nas páginas. O valor padrão é false.

Day CQ WCM Version ManagerControle se, e como, as versões são gerenciadas no seu sistema:

• Criar versão na Ativação, ativada em uma instalação padrão

• Ativar Expurgação

• Expurgar caminhos, os caminhos que uma ação de pesquisa procurará

• Caminhos de controle de versão implícitos, os caminhos nos quais o controle de versão implícito está ativo.

• Idade máxima da versão, a idade máxima (em dias) de uma versão

• Número máximo de versões, o número máximo de versões a serem mantidas

Consulte Expurgação da versão para obter mais informações.

Serviço de notificação por e-mail do fluxo de trabalho do Day CQ Configure as configurações de e-mail para notificações enviadas por um fluxo de trabalho.

Serviço HTTP CQSE Controle o Mecanismo Servlet CQ:

• NIO para HTTP, se deve ou não usar NIO para HTTP. O padrão é true. Usado somente se HTTP estiver ativado.

• Tempo limite da conexão, tempo limite da conexão em milissegundos. Essa propriedade se aplica às conexões HTTP e HTTPS. O padrão é 60 segundos.

• Habilite HTTPS, se HTTPS está ou não habilitado. O padrão é false.

• Tempo limite da sessão, duração padrão de uma sessão HTTP especificada em minutos. Se o tempo limite for 0 ou menor, as sessões nunca atingirão o tempo limite. O padrão é 10 minutos.

• Registro de Depuração, se deve ou não gravar mensagens de nível DEBUG. O padrão é false.

• Tamanho do buffer de solicitação, Tamanho do buffer para solicitações em bytes. O padrão é 8 KB.

• Número máximo de threads, número máximo de threads a serem usados para lidar com solicitações. O padrão é 200.

As seguintes propriedades só se aplicam se HTTPS estiver ativado.

• Porta HTTPS, Porta para acompanhar a solicitação HTTPS. O padrão é 433.
• NIO para HTTPS, se deve ou não usar NIO para HTTP. O padrão é o valor da propriedade NIO para HTTP.
• Keystore, caminho absoluto para o Keystore a ser usado para HTTPS. Obrigatório se HTTPS estiver ativado.
• Senha do armazenamento de chaves, Senha para acessar o armazenamento de chaves.
• Alias-chave, Alias da chave secreta no Keystore.
• Senha da chave, Senha para desbloquear a chave secreta no Keystore.
• Certificado do cliente, requisito para que o cliente forneça um certificado válido. O padrão é nenhum.

Consulte também Habilitando HTTP sobre SSL para obter detalhes sobre as opções relacionadas ao SSL e uma descrição completa sobre como habilitar HTTPS para CQSE.

Fábrica de Analisadores HTML do CQ Rewriter

Controla o Analisador HTML para o gravador de CQ.

• Tags adicionais a serem processadas - você pode adicionar ou remover tags HTML a serem processadas pelo analisador. Por padrão, as seguintes tags são processadas: A,IMG,ÁREA,FORMULÁRIO,BASE,LINK,SCRIPT,CORPO,HEAD.
• Preserve Camel Case - por padrão, o analisador HTML converte atributos em camel case (por exemplo, eBay) para caixa baixa (por exemplo, ebay). Você pode desativar isso para preservar os atributos de maiúsculas e minúsculas do camelo. Isso é útil ao usar estruturas de front-end como Angular 2.

Pool de Conexões JDBC do Day CommonsConfigure o acesso a um banco de dados externo que está sendo usado como fonte de conteúdo.

Esta é uma configuração de fábrica, portanto várias instâncias podem ser configuradas.

Adobe CQ Media DPS Sessions ServiceGerenciar sessões da DPS para uso com Publicações.

Em particular, você pode definir dps.session.service.url.name: o padrão está definido como https://dpsapi2.digitalpublishing.acrobat.com/webservices/sessions

CDN RewriterA comunicação entre AEM e um CDN deve ser assegurada para que os ativos/binários sejam entregues ao usuário final de forma segura. Isso envolve duas tarefas:

• Acessar o recurso de AEM por meio da CDN na primeira vez (ou após expirar em cache).
• Acessar o recurso armazenado em cache no CDN com segurança, pois uma vez que o recurso é armazenado em cache no CDN, a solicitação não vai para AEM e todos os usuários que têm acesso a esse recurso devem ser atendidos no CDN.

AEM fornece um regravador para regravar URLs de ativos internos em URLs CDN externos. Ele regrava links para serem transmitidos ao CDN, incluindo uma assinatura JWS e expira no tempo para permitir que o ativo seja acessado com segurança. Esse recurso deve ser usado em instâncias do autor.

O fluxo global é o seguinte:

1. O usuário é autenticado com AEM e solicita uma página com ativos.

2. A página solicitada contém um ativo semelhante a /content/dam/geometrixx-media/articles/paladin_trailer.jpg/jcr:content/renditions/cq5dam.thumbnail.319.319.png

3. O Rewriter transforma o link em um URL CDN contendo uma Assinatura JWS:

   CDN_domain/content/dam/geometrixx-media/articles/paladin_trailer.jpg/_jcr_content/renditions/cq5dam.thumbnail.319.319.png?cdn_sign=JWS_SIGNATURE

4. O navegador do usuário encaminha a solicitação de ativo para o servidor CDN

5. O CDN deve ser configurado para encaminhar a solicitação para AEM junto com o parâmetro cdn_sign.

6. Um Manipulador de autenticação valida o parâmetro cdn_sign e retorna o ativo ao CDN, que é então entregue ao usuário

O fluxo entre o navegador do usuário, o CDN e o AEM pode ser visualizado da seguinte maneira.

Configurações de CDNConfigServiceImplProvides CDN

O recurso de regravação de CDN pode ser ativado fornecendo nome do domínio de distribuição de CDN na configuração para com.adobe.cq.cdn.rewriter.impl.CDNConfigServiceImpl.

O serviço também contém outras opções de configuração como ativar/desativar a regravação de CDN, prefixos de caminho para os quais a regravação de CDN é executada, valores TTL e protocolo (HTTP ou HTTPS).

​​CDNRewriterUm regravador para regravar URLs de imagem interna para URLs CDN

O valor Atributos de tag em com.adobe.cq.cdn.rewriter.impl.CDNRewriter pode ser definido para que somente os links de imagem seletivos sejam regravados.