DocumentaçãoKCS da Experience Cloud

Configuração e validação de um IP de saída dedicado no AEM as a Cloud Service

Última atualização: 21 de junho de 2026

A configuração de IP de saída dedicado no AEM as a Cloud Service confunde os clientes porque a criação ocorre no nível do programa, mas o IP não está ativo para tráfego de saída até que seja explicitamente ativado por ambiente. O IP dedicado nunca aparece na interface do usuário do Cloud Manager; ele é recuperado por meio de uma pesquisa de DNS no nome de host externo do programa. Atrasos de provisionamento e erros de cota do Cloud Manager aumentam a confusão. Criar a infraestrutura de rede, habilitá-la em cada ambiente, resolver o IP via DNS e confirmar se o tráfego de saída usa esse IP para concluir uma configuração de incluo na lista de permissões de trabalho.

Descrição description

Problema: o IP de saída dedicado não pode ser localizado ou não roteia o tráfego de saída no AEM as a Cloud Service

Descrição

Ao configurar endereços IP de saída dedicados no Cloud Manager, os clientes não conseguem localizar a interface de usuário de configuração correta, experimentar um comportamento inesperado na interface ou não têm certeza de como recuperar o IP de saída final para incluir na lista de permissões sistemas externos. O Cloud Manager exibe erros como An error occurred while triggering network creation, Only one network infrastructure per program is allowed ou NETWORK_INFRASTRUCTURES_EXCEEDS_LIMIT. Os clientes também precisam validar qual endereço IP a AEM usa para chamadas de saída (HTTP/HTTPS ou SMTP), especialmente para firewall ou WAF. O problema ocorre quando o recurso não é totalmente provisionado ou ainda não está ativado no nível do ambiente, ou quando a criação da infraestrutura no nível do programa é confundida com a ativação no nível do ambiente.

Ambiente:

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • Fundamentos do AEM Assets
  • Cloud Manager (rede avançada)

Problema/sintomas:

  • O Cloud Manager exibe erros como An error occurred while triggering network creation ou Only one network infrastructure per program is allowed.
  • O endereço IP de saída dedicado não pode ser encontrado na interface do usuário e o IP não é exibido em nenhum lugar do Cloud Manager.
  • As conexões de saída com sistemas de terceiros são bloqueadas devido a IPs de origem não reconhecidos, causando erros 403/503 ou recusas do WAF.
  • A infraestrutura de IP de saída dedicado parece ter sido criada, mas o tráfego de saída não está usando o IP de origem esperado.

Causa raiz:

O AEM as a Cloud Service usa o Cloud Manager para provisionar recursos avançados de rede. A criação de IP de saída dedicado ocorre no nível do programa, mas o IP não está ativo para tráfego de saída até que seja explicitamente ativado por ambiente. O IP dedicado não aparece na interface do usuário; em vez disso, ele deve ser resolvido por meio de uma pesquisa de DNS. Interpretação incorreta dessas etapas, combinada com diferenças na interface do usuário do Cloud Manager e atrasos de provisionamento de até uma a duas horas, gera confusão ou falha no incluir na lista de permissões de saída. Alguns erros do Cloud Manager ocorrem ao tentar criar várias infraestruturas em um programa ou quando as cotas são excedidas.

Como confirmar

  1. Verifique o status de provisionamento. Faça logon no Cloud Manager, selecione seu programa, abra a guia Ambientes e escolha Infraestrutura de Rede na barra lateral esquerda. Um registro para Endereço IP de saída dedicado é exibido com um status de pronto ou provisionamento.

  2. Recupere o IP de saída dedicado com uma pesquisa de DNS local, substituindo {programId} pela ID do programa:

    code language-none 
    dig +short p{programId}.external.adobeaemcloud.com

O comando retorna um único endereço IP público. Se o registro retornar vazio, o provisionamento ainda não estará concluído.

Resolução resolution

  1. Crie a infraestrutura de IP de saída dedicado. No Cloud Manager, vá para Ambientes > Infraestrutura de Rede > Adicionar Infraestrutura de Rede, selecione Endereço IP de saída dedicado, escolha uma região e clique em Salvar. Uma nova entrada é exibida e seu status muda para pronto dentro de aproximadamente 15 a 60 minutos. Se o Cloud Manager retornar An error occurred while triggering network creation ou NETWORK_INFRASTRUCTURES_EXCEEDS_LIMIT, resolva as permissões ou remova uma infraestrutura existente, pois somente uma infraestrutura de rede por programa é permitida.

  2. Ative o IP de saída dedicado no nível do ambiente. Vá para Ambientes, selecione o ambiente específico (Dev/Preparo/Prod), abra Rede Avançada, habilite a infraestrutura de rede e clique em Salvar. Em Infraestrutura de Rede, confirme se a coluna Ambientes mostra o ambiente como habilitado. Se ele não for atualizado, confirme se você pressionou Salvar na caixa de diálogo de nível de ambiente.

  3. Recupere o IP de saída dedicado e confirme. Execute a pesquisa de DNS e confirme se o IP retornado corresponde ao valor visto nos registros ou por meio de um serviço de eco remoto:

    code language-none 
    dig +short p{programId}.external.adobeaemcloud.com

  4. Valide se o tráfego de saída usa o IP de saída dedicado. No código AEM ou em um cliente HTTP usando propriedades de proxy do sistema, chame um serviço de eco ou seu sistema de destino e confirme se o destino registra o mesmo IP retornado pelo comando dig. Verifique se o código de cliente usa configurações de proxy do sistema, como HttpClientBuilder.useSystemProperties().

  5. Configure o tráfego SMTP ou outro não HTTP/HTTPS, se necessário. Para portas SMTP ou personalizadas, envie uma definição JSON portForwards no Cloud Manager. Confirme se os logs de terceiros mostram solicitações que chegam do IP dedicado. Se as conexões falharem, valide as definições de encaminhamento de porta e tente novamente depois que a infraestrutura atingir um estado pronto.

Validação

  1. Execute a pesquisa de DNS e confirme se ele retorna o IP esperado:

    code language-none 
    dig +short p{programId}.external.adobeaemcloud.com

  2. Execute uma chamada HTTP de teste do AEM para um serviço de eco e confirme se o IP retornado corresponde ao IP de saída dedicado.

  3. Confirme se os sistemas de terceiros (SMTP, WAF, CRM e semelhantes) agora registram o tráfego de entrada do IP dedicado.

Leitura relacionada

recommendation-more-help
experience-cloud-kcs-help-kbarticles