Teste de Conectividade de Rede network-connectivity-test
O Teste de Conectividade de Rede é uma ferramenta de diagnóstico da Cloud Manager que permite validar a configuração de Rede Avançada e VPN antes de habilitar a Rede Avançada em seus ambientes e antes de você ativar. Use-o para verificar se os hosts e as portas que o AEM deve alcançar, incluindo endpoints internos ou privados, podem ser acessados pelo mesmo caminho de conectividade que a Rede avançada usará.
O teste é executado da infraestrutura de proxy de saída que pertence à configuração Avançada de Rede do seu programa, não de um pod Autor ou Publicação. Ele usa o mesmo caminho de rede de saída que a AEM usa quando a Rede avançada está ativa. Este design é especialmente útil para cenários de VPN: você pode confirmar a resolução de DNS, o roteamento de rede, as regras de firewall e a disponibilidade de serviço para sistemas privados ou locais antes de entrar em funcionamento.
Para obter informações sobre o provisionamento de VPN, IP de saída dedicado ou saída de porta flexível, consulte Configurando a Rede Avançada para o AEM as a Cloud Service.
Quando usar esta ferramenta when-to-use
- Depois que a Rede Avançada é criada no nível do programa e antes ou ao habilitá-la em ambientes.
- Para validar a conectividade da VPN com sistemas locais ou privados que você opera (por exemplo, nomes de host internos ou endereços IP privados).
- Para restringir os problemas de DNS em relação aos problemas de firewall ou roteamento quando um serviço não responde conforme esperado.
Pré-requisitos prerequisites
- Um programa do Cloud Manager.
- A infraestrutura de Rede Avançada já foi criada para o programa (consulte Configurando Rede Avançada).
Como executar um teste how-to-run-a-test
-
Faça logon no Cloud Manager em my.cloudmanager.adobe.com e abra sua organização e programa.
-
Abra a guia Ambientes do programa. Na barra lateral esquerda, selecione Infraestrutura de Rede.
-
Na página Infraestrutura de Rede, localize sua infraestrutura na tabela. Selecione uma linha para abrir a experiência de teste ou abra o menu de ações de linha (
) e escolha Testar.
-
A caixa de diálogo Teste de Rede é aberta. Insira o Host e a Porta, selecione Teste e examine a resolução DNS, a porta aberta, a conectividade HTTP e a acessibilidade na área de resultados. Ações opcionais como Copiar para a área de transferência e histórico de testes recentes aparecem na caixa de diálogo. Consulte Entendendo os Resultados para saber como interpretar cada seção.
Campos de entrada input-fields
internal-api.example.com, 10.0.1.50443Etapas test-steps
- Insira Host e Porta.
- Selecione Testar. Os resultados geralmente aparecem em alguns segundos.
- Opcional: Use Copiar para a área de transferência para capturar o resultado JSON completo (útil para casos de suporte).
- Testes recentes podem ser listados para execuções rápidas.
Noções básicas dos resultados understanding-results
A ferramenta relata várias dimensões. Juntos, eles descrevem se o público-alvo pode ser acessado a partir da rede avançada e como as verificações com reconhecimento de HTTP se comportaram.
Resolução de DNS dns-resolution
ips: ["10.0.1.50"]error: "DNS resolution error: ..."Porta aberta port-open
Yes / trueNo / falsoConectividade HTTP http-connectivity
Tentativa de solicitação HTTP/HTTPS em a cada porta. A ferramenta sempre tenta HTTPS primeiro e depois retorna para HTTP. Se nenhum dos dois funcionar, o resultado será mapeado para uma mensagem de erro curta e legível (consulte a tabela abaixo).
Saídas com Êxito
protocol: "https", status_code: 200, reason: "200 OK"protocol: "http", status_code: 301, reason: "301 Moved Permanently"Saídas de Erro Classificadas
"Not an HTTP/HTTPS service""The service appears to be a non-HTTP service (e.g., database, message queue, or custom TCP). Use the port_open and reachability fields to verify connectivity.""Connection refused""The port is not accepting connections. Verify the service is running and listening on this port.""Connection timed out""The connection timed out. Check firewall rules and network routing.""No IPs resolved for host"200, 301, 302, 403, 404 ou 500) é um sinal de sucesso para conectividade, significa que o caminho de rede funciona. O código de status reflete a resposta do próprio serviço, não a integridade geral da rede. Para serviços não HTTP, a ferramenta indica Não é um serviço HTTP/HTTPS; use Porta aberta e Acessabilidade como indicadores confiáveis para esses serviços.Alcance reachability
Vários resolvedores de DNS multiple-dns-resolvers
Se sua infraestrutura de Rede Avançada definir mais de um resolvedor de DNS:
- Quando todos os resolvedores retornam resultados idênticos, você vê um resultado único consolidado rotulado
default. - Quando os resolvedores retornam resultados diferentes, cada resultado do resolvedor é mostrado separadamente (rotulado
resolver_1,resolver_2e assim por diante), com o IP do resolvedor, para que você possa ver qual servidor DNS está causando a inconsistência.
Resolução de problemas troubleshooting
Os cenários a seguir combinam o que você provavelmente verá na ferramenta com etapas para restringir a causa. Para obter o JSON Copiar para a área de transferência completo, que ilustra as mesmas situações, consulte Exemplos de Saídas.
Falha na resolução de DNS dns-failed
Saída
O nome de host não foi resolvido usando as configurações de DNS de rede avançada, portanto, a ferramenta não pode testar a porta. Na exibição de resultados, a resolução DNS mostra uma cadeia de caracteres de erro, e a Capacidade de alcance relata que o DNS falhou:
DNS Resolution: error: "DNS resolution error: ..."
Reachability: "Unreachable: DNS resolution failed"
Recomendações
- Verifique se o nome do host está correto—verifique se há erros de digitação e se você está usando a zona DNS pretendida (a zona errada é um erro comum).
- Verifique se seus resolvedores de DNS—aqueles configurados na infraestrutura de rede—estão acessíveis a partir do intervalo CIDR de Rede Avançada (o mesmo espaço de endereço que a ferramenta e o AEM usam para verificações de saída). Se você depende de DNS privado, esses servidores devem ser acessíveis através do túnel VPN ou dentro do espaço de endereço de rede que o roteamento expõe à Rede avançada.
- Verifique se os servidores DNS configurados podem resolver o nome do host — A Rede Avançada usa somente os resolvedores definidos na configuração da infraestrutura de rede, não DNS público (por exemplo,
8.8.8.8). Se o DNS interno não tiver registro para esse nome de host, a resolução falhará. - Para configurações VPN: Confirme se os endereços IP do servidor DNS estão no espaço de endereço VPN (o CIDR da rede remota para o qual o túnel foi criado). Os resolvedores em uma sub-rede que não é roteada pelo túnel VPN não podem ser acessados pela rede avançada.
O DNS funciona, mas a porta não está acessível dns-ok-port-blocked
Saída
A ferramenta pode resolver o host, mas o TCP na porta não é bem-sucedido. Um resumo geralmente tem esta aparência:
DNS Resolution: ips: ["10.0.1.50"]
Port Open: No
Reachability: "Unreachable: Port not accessible"
Recomendações
- Revisar regras de firewall e de lista de permissões no serviço de destino—o tráfego de entrada do intervalo CIDR da infraestrutura Avançada de Rede (e os endereços IP de saída que a AEM usa) deve ser permitido. Se você usa uma VPN, inclua CIDRs de rede remota conforme exigido pelo design.
- Verifique se o serviço está em execução e escutando no host e na porta que você inseriu no teste.
- Para configurações de VPN: Confirme se o túnel está ativo, se o roteamento atinge a sub-rede de destino e se o endereço de destino se encontra no espaço de endereço de rede remoto transportado pela VPN.
- Em sua infraestrutura, analise os NSGs (grupos de segurança de rede), regras de segurança ou equivalente que podem bloquear a porta entre a Rede Avançada e o destino.
- Confirme o número da porta—verifique se o processo está realmente escutando na porta que você está testando.
O teste mostra que é possível acessar, mas o AEM não se conecta reachable-but-aem-fails
Saída
A própria verificação de conectividade foi bem-sucedida. Um resumo condensado geralmente tem esta aparência:
Port Open: Yes
Reachability: "Reachable"
Esse resultado significa que o caminho da rede avançada para o host e a porta que você testou está aberto. Isso não garante que o tráfego do aplicativo AEM esteja usando esse caminho: quando seu código é executado, os logs de serviço ainda podem não mostrar nenhuma solicitação do IP de saída esperado.
Recomendações
- O código do aplicativo deve ser configurado para usar o proxy. O teste de conectividade comprova que o caminho de rede funciona, mas o AEM deve rotear explicitamente as solicitações por meio do proxy de rede avançada (por exemplo, por meio da variável de ambiente
AEM_PROXY_HOST). Se o código fizer conexões diretas sem o proxy, o tráfego não passará pela infraestrutura avançada de rede. - Revisar configurações de proxy em seus clientes HTTP - Os clientes HTTP devem usar a mesma configuração de proxy (
AEM_PROXY_HOSTe encaminhamento de porta, quando aplicável). - Verifique a configuração de encaminhamento de porta para Rede Avançada no nível ambiente: em
portForwards, cada entrada deve mapearportOrigparaportDestno host de destino direito.portOrigé a porta à qual o código de aplicativo do AEM se conecta quando abre a conexão de saída por meio do proxy.portDesté a porta real no serviço de destino onde o processo remoto está escutando. O host de destino é o nome do host ou endereço desse serviço conforme usado no encaminhamento. Todos os três devem corresponder ao modo como o aplicativo é gravado para conexão. - Verificar
nonProxyHosts. Se o host de destino estiver listado lá, as solicitações ignorarão o proxy para esse host e não seguirão o caminho de Rede Avançada validado.
HTTP mostra um erro, mas a porta está aberta http-error-port-open
Saída
TCP bem-sucedido, mas o teste HTTP/HTTPS ainda relata uma falha. Um resumo geralmente tem esta aparência:
Port Open: Yes
HTTP Connectivity: error: "Connection error: ..." or "Both HTTPS and HTTP failed. ..."
Reachability: "Reachable"
Recomendações
- O serviço pode não falar HTTP ou HTTPS — por exemplo, TCP bruto, gRPC ou outro protocolo. A investigação HTTP pode falhar enquanto
Port open: YeseReachability: Reachableainda confirmam que o caminho de rede funciona. Use esses campos como a fonte da verdade para serviços não HTTP. - Investigar configuração de TLS e certificado. Se o HTTPS falhar, mas o HTTP for bem-sucedido (às vezes indicado por uma observação como
HTTPS failed, HTTP succeeded), o serviço pode ter problemas de certificado ou pode oferecer HTTP somente nessa porta.
Tempo limite da solicitação timeout
Saída
{ "error": "Request timeout" }
Recomendações
- Permitir tempo de resposta do serviço—a verificação usa um tempo limite de 5 segundos. Alvos que respondem mais lentamente do que isso expirarão mesmo quando estiverem de outra forma saudáveis.
- Conta para latência de rede. Em conexões VPN, a alta latência ou um túnel não íntegro podem ultrapassar o limite; revise o status e o roteamento do túnel.
- Executar o teste novamente. Falhas de rede únicas podem produzir um tempo limite que não se repete.
Exemplo de saídas example-outputs
Teste HTTPS bem-sucedido (por exemplo, API interna na porta 443) example-output-successful-https
{
"resolvers": [
{
"name": "default",
"dns_resolution": {
"ips": ["10.0.1.50"]
},
"port_open": true,
"http_connectivity": {
"protocol": "https",
"status_code": 200,
"reason": "200 OK"
},
"reachability": "Reachable"
}
]
}
Teste de Serviço Não HTTP Bem-sucedido (por exemplo, Banco de Dados na Porta 5432) example-output-successful-non-http
{
"resolvers": [
{
"name": "default",
"dns_resolution": {
"ips": ["10.0.1.50"]
},
"port_open": true,
"http_connectivity": {
"error": "Not an HTTP/HTTPS service",
"note": "The service appears to be a non-HTTP service (e.g., database, message queue, or custom TCP). Use the port_open and reachability fields to verify connectivity."
},
"reachability": "Reachable"
}
]
}
Falha de Resolução de DNS example-output-dns-resolution-failure
{
"resolvers": [
{
"name": "default",
"dns_resolution": {
"error": "DNS resolution error: dial udp 10.0.0.2:53: i/o timeout"
},
"port_open": false,
"http_connectivity": {
"error": "DNS resolution failed"
},
"reachability": "Unreachable: DNS resolution failed"
}
]
}
Porta Não Acessível (Firewall / Serviço Inativo) example-output-port-not-accessible
{
"resolvers": [
{
"name": "default",
"dns_resolution": {
"ips": ["10.0.1.50"]
},
"port_open": false,
"http_connectivity": {
"error": "Connection error: dial tcp 10.0.1.50:443: i/o timeout"
},
"reachability": "Unreachable: Port not accessible"
}
]
}
Observações importantes important-notes
O que este teste não faz what-this-test-does-not-do
- O teste não é executado de dentro de um autor do AEM ou pod de publicação. Ela é executada a partir de infraestrutura de proxy de saída. Isso valida a camada de rede e não a configuração de proxy no nível do aplicativo no código.
- Isso não valida as configurações de proxy do aplicativo AEM. Mesmo quando o resultado é
Reachable, o código AEM ainda deve ser configurado para usar o proxy. - Ela não valida a configuração de encaminhamento de portas no nível do ambiente por si só. Testa a conectividade bruta do caminho da infraestrutura.
- Ele não envia cargas personalizadas. Testes HTTP emitem uma solicitação básica de
GETpara/.
Tempo de resposta response-time
- Típica: cerca de 2 a 3 segundos.
- Máximo: tempo limite de aproximadamente cinco segundos.
- Todos os resolvedores de DNS e verificações de conectividade são executados em paralelo.
Serviços HTTP vs. não HTTP http-vs-non-http-services
A ferramenta tenta uma conexão HTTP/HTTPS em cada porta. Para serviços não HTTP (por exemplo, PostgreSQL na porta 5432, MySQL em 3306, SFTP em 22, Redis em 6379), a verificação HTTP pode falhar com um erro de conexão; isso é esperado. Conte com Port open e Reachability para confirmar a conectividade desses serviços.