DocumentaçãoKCS da Experience Cloud

Gerar e implantar uma X-AEM-Edge-Key no AEMaaCS

Última atualização: 1 de setembro de 2026

Este artigo fornece instruções passo a passo para gerar, configurar e implantar a X-AEM-Edge-Key em um ambiente do Adobe Experience Manager as a Cloud Service. Ele também explica como usar a chave em vários domínios e implantá-la por meio do Cloud Manager.

Descrição description

Ambiente

Adobe Experience Manager as a Cloud Service (AEMaaCS) (todas as versões)

Problema/Sintomas

  • É necessário configurar o X-AEM-Edge-Key para um novo ambiente de preparo ou não produção.
  • Incerteza sobre o uso da mesma chave de borda para vários domínios no mesmo ambiente.
  • A opção de implantação Config não está visível ao criar um pipeline de Não Produção no Cloud Manager, impedindo a implantação da configuração de CDN necessária.

Causa

O cliente gerencia o X-AEM-Edge-Key e deve configurá-lo e implantá-lo por meio de um pipeline de configuração no Cloud Manager. Somente um pipeline de configuração é permitido por ambiente e a chave se aplica ao ambiente em vez de domínios individuais.

Resolução resolution

Siga estas etapas para resolver o problema:

  1. Gere a X-AEM-Edge-Key:

    1. Use um gerador aleatório seguro para criar uma string hexadecimal de 32 bytes. Por exemplo: openssl rand -hex 32
    2. Use o valor gerado como sua X-AEM-Edge-Key.

  2. Crie uma variável de ambiente secreta no Cloud Manager:

    1. No Cloud Manager, adicione uma variável de ambiente secreta, como CDN_EDGEKEY_<date>, ao ambiente de destino.
    2. Defina o valor correspondente à chave de borda gerada.

  3. Referencie o segredo na configuração do CDN:

    1. No repositório, adicione ou atualize o arquivo de configuração CDN no caminho de configuração apropriado, como config/staging/cdn.yaml.
    2. Faça referência à variável secreta no arquivo YAML. Por exemplo: edgeKey1: ${{CDN_EDGEKEY_<date>}}

  4. Implante a configuração da CDN por meio de um pipeline de Configuração: Observação: somente um pipeline de configuração pode existir por ambiente. Se a opção Config não estiver visível, verifique se um pipeline de Configuração já tem como destino o ambiente. Se não houver um pipeline de configuração, entre em contato com o Suporte da Adobe para ativar a opção.

    1. No Cloud Manager, confirme se um pipeline de configuração está direcionado ao ambiente.

    2. Se um pipeline de configuração já existir, edite-o para usar as seguintes configurações:

      • Repositório: seu repositório do AEM
      • Ramificação: sua ramificação de desenvolvimento, como dev
      • Local do código: config ou a subpasta apropriada

    3. ​​ ​ ​ ​ ​para implantar o pipeline cdn.yaml para o Adobe CDN

  5. Configure a CDN externa:

    • Defina os seguintes cabeçalhos ao encaminhar o tráfego para a instância de publicação:

      • Host: seu nome de host da instância de publicação
      • X-Forwarded-Host: Seu domínio
      • X-AEM-Edge-Key: a chave de borda gerada

  6. Verifique a configuração:

    1. Após a implantação, confirme se as solicitações encaminhadas da CDN externa para o AEM incluem o X-AEM-Edge-Key correto.
    2. Confirme se o Adobe CDN aceita as solicitações.
recommendation-more-help
experience-cloud-kcs-help-kbarticles