Gerador de walled garden
Gere regras de domínios permitidos de pré-autenticação, listas brancas de ACL e scripts CLI de controlador para 9 plataformas de hardware sem fios empresarial.
Configure e valide walled gardens de portais cativos
1. Selecionar integrações de serviços
2. Adicionar domínios de local personalizados
Inclua endpoints de API personalizados, hosts de CDN do local ou recursos web necessários para a sua página splash.
3. Escolher o controlador de hardware e o formato de exportação
Selecione o controlador sem fios empresarial de destino para formatar as regras exatas da lista de permissões da CLI ou do painel de controlo.
# ==================================================================
# Cisco Meraki Dashboard - Walled Garden Allowed Domain List
# Location: Wireless > Configure > Access control > Splash page
# ==================================================================
*.aadcdn.msauth.net
*.aadcdn.msftauth.net
*.account.live.com
*.accounts.google.co.uk
*.accounts.google.com
*.accounts.youtube.com
*.api.purple.ai
*.apis.google.com
*.app.purple.ai
*.appleid.apple.com
*.appleid.cdn-apple.com
*.assets.purple.ai
*.auth.gfx.ms
*.auth.purple.ai
*.captive.purple.ai
*.cdnjs.cloudflare.com
*.challenges.cloudflare.com
*.fonts.googleapis.com
*.fonts.gstatic.com
*.googleusercontent.com
*.gsa.apple.com
*.gstatic.com
*.idmsa.apple.com
*.login.live.com
*.login.microsoftonline.com
*.logincdn.msauth.net
*.onboarding.purple.ai
*.portal.purple.ai
*.purple.ai
*.ssl.gstatic.com
*.static.cloudflareinsights.com
*.www.purple.aiNotas importantes sobre o bypass do CNA da Apple e deteção de portal cativo
Adicionar à lista de permissões os hostnames de teste da Apple (captive.apple.com) oculta a sobreposição automática do navegador do Captive Network Assistant em dispositivos Apple. Embora isto permita uma autenticação sem interrupções para visitantes recorrentes em ambientes corporativos, impede que a splash page abra automaticamente nos dispositivos dos visitantes. Em redes de visitantes padrão, deixe o teste do CNA da Apple não selecionado para garantir a exibição imediata da solicitação de início de sessão.
Como funcionam os walled gardens de pré-autenticação
Em implementações empresariais de WiFi para visitantes, um walled garden (lista de controlo de acesso de pré-autenticação) define os destinos de rede específicos que um dispositivo não autenticado pode alcançar antes de concluir o onboarding na splash page. Quando um visitante se liga a um SSID de visitantes aberto ou seguro, o controlador LAN sem fios (WLC) ou o ponto de acesso gerido na nuvem coloca o cliente num estado restrito de pré-autenticação.
Todo o tráfego web padrão é intercetado e redirecionado para o URL de início de sessão do portal cativo. Contudo, no caso de splash pages modernas com início de sessão social (OAuth 2.0), faturação por cartão de crédito (Stripe, PayPal), tipografia personalizada (Google Fonts) ou recursos de CDN externos, o navegador do cliente precisa de trocar dados com servidores de terceiros antes de receber autorização total de acesso à internet. Se algum destes endpoints for omitido da lista branca do walled garden do controlador, o processo de início de sessão falha silenciosamente, resultando em janelas modais em branco ou botões de pagamento inoperantes.
Matriz comparativa de walled gardens para controladores sem fios empresariais
| Plataforma de hardware | Mecanismo | Formato wildcard | Interface de configuração | Snooping de DNS dinâmico |
|---|---|---|---|---|
| Cisco Meraki MR | DNS snooping ao nível do AP | *.domain.com | Dashboard Web UI / REST API | Automático por MAC do cliente |
| Cisco Catalyst 9800 | IOS-XE Parameter-Map | redirect-passthrough domain | CLI / Perfil WebAuth de WebUI | Suportado via FQDN snooping |
| Aruba AOS 8 / 10 | Aliases de Netdestination | name *.domain.com | CLI / UI do Aruba Central | Motor DPI integrado |
| Ubiquiti UniFi | Tabela de autorização do gateway | *.domain.com | Definições de Hotspot do UniFi Network | Integrado no dnsmasq / UDM |
| Fortinet FortiGate | Objetos de endereço FQDN | set fqdn *.domain.com | CLI do FortiOS / Captive Exempt List | Tabela de resolução DNS do FortiGuard |
| Juniper Mist | Hostnames do AP enviados pela cloud | *.domain.com | Mist AI Portal / Mist API | Aceleração de hardware no AP Edge |
| Ruckus SmartZone | Tabela Walled Garden do WISPr | *.domain.com | WebUI do SmartZone / ZoneDirector | Filtro proxy DNS ao nível do AP |
Mecanismos de verificação de CNA da Apple e portal cativo do Android
Quando os dispositivos móveis se associam a um SSID não encriptado ou de visitantes, o sistema operativo executa uma verificação automática de conetividade em segundo plano para determinar se o dispositivo tem acesso irrestrito à internet ou se está bloqueado atrás de um portal cativo:
- Apple iOS e macOS: Envia um pedido HTTP GET para
http://captive.apple.com/hotspot-detect.html. Se o servidor devolver qualquer resposta diferente do texto HTML exato contendo<HTML><HEAD><TITLE>Success</TITLE></HEAD><BODY>Success</BODY></HTML>, o sistema operativo abre imediatamente o navegador modal Captive Network Assistant (CNA). - Google Android: Envia um pedido HTTP 204 para
http://connectivitycheck.gstatic.com/generate_204. Se o ponto de acesso intercetar a ligação e devolver um redirecionamento HTTP 302 ou uma splash page HTML, o Android exibe uma notificação 'Iniciar sessão na rede WiFi' na barra de sistema. - Microsoft Windows: Contacta o Network Connectivity Status Indicator (NCSI) em
http://www.msftconnecttest.com/connecttest.txt, aguardando um 200 OK com a stringMicrosoft Connect Test.
Recomendação de boas práticas: Não inclua os domínios de verificação da Apple ou do Android na lista branca, a menos que esteja intencionalmente a implementar um fluxo de onboarding simplificado sem intervenção (como Passpoint / Hotspot 2.0). Incluir estas verificações na lista branca faz com que o sistema operativo assuma que tem acesso ativo à internet, suprimindo o ecrã de entrada (splash screen) e forçando os visitantes a abrir manualmente um navegador web para localizar o portal.
Proteger walled gardens contra tunelamento de DNS e utilizações indevidas
Embora os walled gardens sejam essenciais para a autenticação de visitantes, listas brancas incorretamente configuradas podem expor as redes de visitantes a vulnerabilidades de segurança:
Restrinja sempre o tráfego DNS não autenticado a resolutores DNS corporativos de confiança ou a forwarders proxy internos do controlador. Permitir DNS recursivo aberto na rede de pré-autenticação permite que agentes maliciosos criem túneis para tráfego TCP/UDP arbitrário através de consultas DNS (Iodine / DNScat).
Sempre que possível, evite listas brancas genéricas com caracteres universais ao nível do domínio superior, como *.amazonaws.com ou *.cloudfront.net. Especifique os hostnames exatos dos buckets de recursos (por exemplo, myvenue-assets.s3.amazonaws.com) para impedir a navegação não autorizada em armazenamento na nuvem sem autenticação.
Configure as ACLs de sessão de pré-autenticação para permitir apenas a porta TCP 443 (HTTPS) de saída para OAuth de terceiros e processadores de pagamento, fechando a porta 80 não encriptada para evitar o roubo de sessão através de ataques man-in-the-middle na VLAN de visitantes.
Como configurar um walled garden de pré-autenticação para portais cativos de WiFi para visitantes
Instruções passo a passo para engenheiros de rede gerarem, validarem e aplicarem listas brancas de domínios permitidos em controladores LAN sem fios empresariais antes da autenticação do utilizador.
Selecione as integrações de autenticação necessárias
Selecione os fornecedores de identidade externos (Google OAuth, Microsoft Entra ID, Apple ID), processadores de pagamento (Stripe, PayPal), CDNs e repositórios de fontes necessários para a página de entrada do seu portal cativo.
Adicione domínios de local personalizados e endpoints de API
Insira quaisquer FQDNs personalizados do local, hosts de API da aplicação móvel do cliente ou recursos de marca alojados no validador de domínios personalizados.
Selecione o controlador sem fios de hardware de destino
Escolha o seu fornecedor de hardware de destino (Cisco Meraki, Cisco Catalyst 9800, Aruba OS, Ubiquiti UniFi, Fortinet FortiGate, Ruckus SmartZone, Juniper Mist, Extreme Networks ou Cambium cnMaestro).
Alique os comandos de configuração gerados ao controlador sem fios
Copie o script CLI formatado ou as entradas da lista de permissões do painel de controlo e aplique-os à WLAN para visitantes de destino ou à função de utilizador pré-autenticação.
Perguntas frequentes sobre walled gardens e portais cativos
O que é um walled garden em redes de WiFi para visitantes e de portal cativo?
Um walled garden (também conhecido como lista de permissões de domínios autorizados ou lista de controlo de acessos de pré-autenticação) é um ambiente de navegação restrito imposto por pontos de acesso sem fios ou controladores LAN sem fios. Antes de um visitante não autenticado iniciar sessão através de uma página inicial de portal cativo, todo o tráfego geral da internet é bloqueado. O walled garden inclui explicitamente na lista de permissões nomes de domínio totalmente qualificados (FQDNs) e intervalos de IP específicos - tais como servidores de alojamento do portal cativo, fornecedores de identidade OAuth, processadores de pagamentos e fontes web - permitindo que a página inicial e os scripts de autenticação funcionem sem conceder acesso total à rede.
Como funciona o DNS snooping em pontos de acesso empresariais para walled gardens?
Os pontos de acesso empresariais modernos (como o Cisco Meraki, Aruba e Juniper Mist) utilizam DNS snooping dinâmico em vez de listas de controlo de acessos IP estáticas. Quando um cliente não autenticado envia uma consulta DNS para um domínio na lista de permissões do walled garden (por exemplo, accounts.google.com), o ponto de acesso interjeta a resposta DNS do resolvedor a montante. O AP inspeciona os registos A ou AAAA devolvidos e instala temporariamente regras de permissão de firewall dinâmicas de Camada 3 para esses endereços IP específicos para o endereço MAC do cliente, expirando-as quando o TTL do DNS se esgota.
Por que razão a inclusão do Apple CNA na lista de permissões interrompe a abertura automática da página inicial?
Os dispositivos Apple detetam redes cativas enviando uma verificação HTTP para captive.apple.com ao ligarem-se a um SSID. Se o dispositivo receber a resposta esperada 'Success', assume que está disponível o acesso total à internet e não abre a sobreposição de navegador do Captive Network Assistant (CNA). A inclusão do captive.apple.com na lista de permissões permite que esta verificação passe sem interceção, o que engana o iOS e o macOS fazendo-os acreditar que o dispositivo tem conectividade total, suprimindo o pedido de início de sessão automático.
Que domínios devem ser incluídos na lista de permissões para o início de sessão social através do Google, Apple e Microsoft?
Para a autenticação da Google, inclua na lista de permissões accounts.google.com, ssl.gstatic.com, apis.google.com e gstatic.com. Para o Microsoft Entra ID / 365, inclua login.microsoftonline.com, login.live.com, aadcdn.msftauth.net e aadcdn.msauth.net. Para o Sign in with Apple, inclua appleid.apple.com e appleid.cdn-apple.com. Como os fornecedores OAuth utilizam frequentemente redes de distribuição de conteúdos e subdomínios, recomenda-se a correspondência por caracteres de substituição (*.domain.com) em controladores compatíveis.
O que causa loops de redirecionamento do portal cativo e ecrãs brancos em branco?
Os loops de redirecionamento e ecrãs brancos ocorrem normalmente devido a três problemas: 1) Recursos de CDN ou JavaScript em falta no walled garden (por exemplo, fonts.gstatic.com ou js.stripe.com bloqueados antes de carregar), 2) Redirecionamento HTTPS estrito onde o controlador tenta intercetar um pedido HTTPS sem um certificado SSL válido no gateway, ou 3) Domínios de callback OAuth em falta onde o fornecedor de identidade tenta redirecionar de volta para o anfitrião do portal, mas é bloqueado por regras de firewall de pré-autenticação.
Como é que a Purple simplifica a gestão do walled garden em redes de múltiplos fornecedores?
A Purple opera uma infraestrutura na nuvem Anycast de alta disponibilidade com arquiteturas consolidadas de domínio de origem única. Ao centralizar o alojamento do portal cativo, os motores de autenticação e as integrações de CRM atrás de pontos finais FQDN unificados (como onboarding.purple.ai), a Purple minimiza o número de regras de domínio externo necessárias nos controladores sem fios, reduzindo erros de configuração e eliminando falhas na pré-autenticação.
Ferramentas de diagnóstico de rede e WiFi relacionadas
A implementar WiFi para visitantes empresarial em redes multi-vendor?
Elimine a manutenção complexa de walled gardens, avisos de SSL e tempos de espera do portal. O Purple integra-se nativamente com Cisco Meraki, Catalyst 9800, Aruba, UniFi, Fortinet, Mist e Ruckus para disponibilizar portais cativos de alta disponibilidade, onboarding com Passpoint e análise comportamental de visitantes.
Book a 20-min demoNetforge Network Multi-Tool
Run offline network health checks, path analysis, and latency diagnostic scans directly from your desktop.
Download Multi-Tool