Pré-requisitos
Acesso às informações do ambiente do cliente para validar:
Sistema operacional e arquitetura
Regras de rede/firewall (portas e destinos)
Permissões de instalação (administrador local)
Acesso à internet para validação do token
Passo a Passo (Checklist de validação)
Validar sistema operacional
Confirmar se o endpoint é:
Windows 10 ou superior ou
Windows Server 2016 ou superior
Validar arquitetura suportada
Confirmar se o endpoint é:
x64, x86 ou ARM64
Validar conectividade DNS (consultas)
Garantir liberação para Servidores DNS na porta 53 em UDP/TCP (consultas DNS).
Validar conectividade com API/validação
Garantir liberação para o destino app.edgedns.com.br na porta 443/HTTPS (API e validação).
Validar permissões e internet
Confirmar Administrador local para instalação.
Confirmar acesso à internet para validação do token.
Referência de Campos
Requisitos de Sistema Operacional
Campo | Função | Valores aceitos |
Sistema operacional | Define compatibilidade do agente | Windows 10 ou superior; Windows Server 2016 ou superior |
Arquitetura | Define compatibilidade do binário/instalador | x64, x86, ARM64 |
Requisitos de Rede
Campo | Função | Valores aceitos |
Destino | Endpoint/serviço que precisa ser acessível | Servidores DNS; app.edgedns.com.br |
Porta | Porta de comunicação necessária | 53; 443 |
Protocolo | Protocolo de transporte | UDP/TCP (porta 53); HTTPS (porta 443) |
Finalidade | Motivo da liberação | Consultas DNS; API e validação |
Permissões
Campo | Função | Valores aceitos |
Administrador local | Permite instalar o agente | Obrigatório para instalação |
Acesso à internet | Necessário para validação do token | Obrigatório para validação do token |
Troubleshooting
Sintoma | Causa provável | Ação corretiva |
Instalação não pode ser executada | Falta de Administrador local | Executar com permissão de administrador local |
Validação do token falha | Sem acesso à internet | Liberar/garantir acesso à internet para validação do token |
Não comunica com API/validação | Bloqueio de rede para app.edgedns.com.br:443/HTTPS | Liberar destino app.edgedns.com.br na porta 443/HTTPS |
Consultas DNS não funcionam | Bloqueio de rede para porta 53/UDP-TCP | Liberar comunicação com Servidores DNS na porta 53 (UDP/TCP) |
Endpoint não é suportado | SO/arquitetura fora do suportado | Validar: Windows 10+ ou Windows Server 2016+; x64/x86/ARM64 |
Avisos e Boas Práticas
Garanta privilégio de Administrador local apenas durante a instalação, para reduzir risco operacional.
Mantenha liberadas as portas necessárias:
53/UDP e TCP para consultas DNS em Servidores DNS
443/HTTPS para API e validação em app.edgedns.com.br
Valide SO e arquitetura antes do deploy (Windows 10+/Server 2016+; x64/x86/ARM64) para evitar tentativa de instalação em ambiente incompatível.
Confirme acesso à internet antes de iniciar a instalação com token, para não falhar na etapa de validação.