Gerador de walled garden
Gere regras de domínios permitidos de pré-autenticação, listas de permissões de ACL e scripts de CLI de controlador para 9 plataformas de hardware sem fio corporativas.
Configure e valide walled gardens de portais cativos
1. Selecionar integrações de serviço
2. Adicionar domínios de locais personalizados
Inclua endpoints de API personalizados, hosts de CDN do local ou recursos web necessários para sua página splash.
3. Escolher controlador de hardware e formato de exportação
Selecione seu controlador sem fio empresarial de destino para formatar as regras exatas da lista de permissões para CLI ou painel.
# ==================================================================
# 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 verificação da Apple (captive.apple.com) suprime a sobreposição automática do navegador Captive Network Assistant em dispositivos Apple. Embora isto permita uma autenticação fluida para visitantes recorrentes em ambientes corporativos, impede que a splash page abra automaticamente em dispositivos de visitantes. Para redes de visitantes padrão, mantenha a verificação do Apple CNA desmarcada para garantir a apresentação imediata do ecrã de início de sessão.
Como funcionam os walled gardens de pré-autenticação
Em implantações de WiFi para visitantes corporativo, um walled garden (lista de controle de acesso de pré-autenticação) define os destinos de rede específicos que um dispositivo não autenticado pode acessar antes de concluir a integração na splash page. Quando um visitante se conecta a um SSID para visitantes aberto ou seguro, o controlador LAN sem fio (WLC) ou ponto de acesso gerenciado na nuvem coloca o cliente em um estado restrito de pré-autenticação.
Todo o tráfego web padrão é interceptado e redirecionado para a URL de login do portal cativo. No entanto, para splash pages modernas com login social (OAuth 2.0), cobrança por cartão de crédito (Stripe, PayPal), tipografia personalizada (Google Fonts) ou recursos externos de CDN, o navegador do cliente deve trocar dados com servidores de terceiros antes de receber autorização total de internet. Se algum desses endpoints for omitido da lista de permissões do walled garden do controlador, o processo de login falha silenciosamente, resultando em janelas modais em branco ou botões de checkout quebrados.
Matriz de comparação de walled garden para controladores sem fio corporativos
| Plataforma de hardware | Mecanismo | Formato de wildcard | Interface de configuração | Snooping de DNS dinâmico |
|---|---|---|---|---|
| Cisco Meraki MR | DNS snooping no nível do AP | *.domain.com | Dashboard Web UI / REST API | Automático por MAC do cliente |
| Cisco Catalyst 9800 | Parameter-Map do IOS-XE | redirect-passthrough domain | CLI / Perfil WebAuth da WebUI | Suportado via snooping de FQDN |
| Aruba AOS 8 / 10 | Aliases Netdestination | name *.domain.com | CLI / UI do Aruba Central | Motor DPI integrado |
| Ubiquiti UniFi | Tabela de autorização do gateway | *.domain.com | Configurações de Hotspot do UniFi Network | Integrado ao dnsmasq / UDM |
| Fortinet FortiGate | Objetos de endereço FQDN | set fqdn *.domain.com | CLI do FortiOS / Lista de isenção do portal cativo | Tabela de resolução DNS do FortiGuard |
| Juniper Mist | Hostnames de AP enviados pela nuvem | *.domain.com | Mist AI Portal / Mist API | Aceleração de hardware no AP de borda |
| Ruckus SmartZone | Tabela Walled Garden WISPr | *.domain.com | WebUI do SmartZone / ZoneDirector | Filtro de proxy DNS no nível do AP |
Mecânica de verificação de portal cativo do Apple CNA e Android
Quando dispositivos móveis se associam a um SSID não criptografado ou de visitantes, o sistema operacional inicia uma verificação de conectividade automatizada em segundo plano para determinar se o dispositivo tem acesso irrestrito à internet ou se está retido atrás de um portal cativo:
- Apple iOS e macOS: Envia uma solicitação HTTP GET para
http://captive.apple.com/hotspot-detect.html. Se o servidor retornar qualquer elemento diferente do texto HTML exato contendo<HTML><HEAD><TITLE>Success</TITLE></HEAD><BODY>Success</BODY></HTML>, o sistema operacional abre imediatamente a janela modal do navegador Captive Network Assistant (CNA). - Google Android: Envia uma solicitação HTTP 204 para
http://connectivitycheck.gstatic.com/generate_204. Se o ponto de acesso interceptar a conexão e retornar um redirecionamento HTTP 302 ou uma splash page em HTML, o Android exibirá uma notificação 'Fazer login na rede WiFi' na barra de status do sistema. - Microsoft Windows: Contata o Network Connectivity Status Indicator (NCSI) em
http://www.msftconnecttest.com/connecttest.txt, esperando um 200 OK com a stringMicrosoft Connect Test.
Recomendação de melhores práticas: Não inclua os domínios de teste da Apple ou do Android na lista de permissões, a menos que esteja implementando intencionalmente um fluxo de integração contínuo sem interface (como Passpoint / Hotspot 2.0). Incluir esses testes na lista de permissões faz com que o sistema operacional pense que possui acesso ativo à internet, o que suprime a splash screen e força os visitantes a abrir manualmente um navegador web para descobrir o portal.
Protegendo walled gardens contra tunelamento de DNS e abusos
Embora os walled gardens sejam essenciais para a autenticação de visitantes, listas de permissões configuradas incorretamente podem expor as redes de visitantes a vulnerabilidades de segurança:
Sempre restrinja o tráfego de DNS não autenticado a resolvedores de DNS corporativos confiáveis ou a encaminhadores de proxy do controlador interno. Permitir DNS recursivo aberto na rede de pré-autenticação permite que atores maliciosos tunelem tráfego TCP/UDP arbitrário por meio de consultas de DNS (Iodine / DNScat).
Evite listas de permissões amplas com caracteres curinga de nível superior, como *.amazonaws.com ou *.cloudfront.net, sempre que possível. Especifique hostnames exatos de buckets de recursos (por exemplo, myvenue-assets.s3.amazonaws.com) para evitar a navegação não autorizada em armazenamento em nuvem não autenticado.
Configure as ACLs de sessão de pré-autenticação para permitir apenas a porta de saída TCP 443 (HTTPS) para OAuth de terceiros e processadores de pagamento, fechando a porta 80 não criptografada para evitar o sequestro de sessão por 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 de permissões de domínios permitidos em controladores LAN sem fio corporativos antes da autenticação do usuário.
Selecione as integrações de autenticação necessárias
Selecione os provedores 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 sua página do portal cativo.
Adicione domínios de local personalizados e endpoints de API
Insira quaisquer FQDNs de local personalizados, hosts de API de aplicativo móvel do cliente ou ativos de marca hospedados no validador de domínio personalizado.
Selecione o controlador sem fio 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).
Aplique os comandos de configuração gerados ao controlador sem fio
Copie o script de CLI formatado ou as entradas da lista de permissões do painel e aplique-os à WLAN de visitantes de destino ou à função de usuário pré-autenticação.
Perguntas frequentes sobre walled gardens e portais cativos
O que é um walled garden em redes de WiFi para visitantes e portal cativo?
Um walled garden (também conhecido como lista de permissões de domínios autorizados ou lista de controle de acesso pré-autenticação) é um ambiente de navegação restrito imposto por pontos de acesso sem fio ou controladores LAN sem fio. Antes que um visitante não autenticado faça login por meio de uma splash page do 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 - como servidores de hospedagem do portal cativo, provedores de identidade OAuth, processadores de pagamento e fontes web - , permitindo que a splash page e os scripts de autenticação funcionem sem conceder acesso total à rede.
Como funciona o DNS snooping em pontos de acesso corporativos para walled gardens?
Os pontos de acesso corporativos modernos (como Cisco Meraki, Aruba e Juniper Mist) utilizam DNS snooping dinâmico em vez de listas de controle de acesso de IP estático. Quando um cliente não autenticado envia uma consulta DNS para um domínio na lista de permissões do walled garden (ex.: accounts.google.com), o ponto de acesso intercepta a resposta DNS do resolvedor upstream. O AP inspeciona os registros A ou AAAA retornados e instala temporariamente regras dinâmicas de permissão no firewall 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 colocar o Apple CNA na lista de permissões interrompe o pop-up automático da splash page?
Os dispositivos Apple detectam redes cativas enviando um teste HTTP para captive.apple.com ao se conectarem a um SSID. Se o dispositivo receber a resposta 'Success' esperada, ele presume que o acesso total à internet está disponível e não abrirá a sobreposição do navegador Captive Network Assistant (CNA). Adicionar captive.apple.com à lista de permissões permite que esse teste passe sem interceptação, o que engana o iOS e o macOS fazendo-os acreditar que o dispositivo possui conectividade total, suprimindo o prompt modal automático de login.
Quais domínios devem ser incluídos na lista de permissões para login social via Google, Apple e Microsoft?
Para autenticação do Google, inclua na lista de permissões accounts.google.com, ssl.gstatic.com, apis.google.com e gstatic.com. Para 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 provedores OAuth usam frequentemente redes de entrega de conteúdo (CDNs) e subdomínios, a correspondência com caracteres curinga (*.dominio.com) é recomendada em controladores que suportem essa opção.
O que causa loops de redirecionamento do portal cativo e telas brancas em branco?
Loops de redirecionamento e telas em branco ocorrem tipicamente devido a três problemas: 1) Recursos de CDN ou JavaScript ausentes no walled garden (ex.: fonts.gstatic.com ou js.stripe.com bloqueados antes de carregar), 2) Redirecionamento HTTPS rígido onde o controlador tenta interceptar uma solicitação HTTPS sem um certificado SSL válido no gateway, ou 3) Domínios de retorno de chamada (callback) OAuth ausentes onde o provedor de identidade tenta redirecionar de volta para o host do portal, mas é bloqueado por regras de firewall pré-autenticação.
Como a Purple simplifica o gerenciamento do walled garden em redes multivendedor?
A Purple opera uma infraestrutura em nuvem Anycast de alta disponibilidade com arquiteturas consolidadas de domínio de origem única. Ao centralizar a hospedagem do portal cativo, motores de autenticação e integrações de CRM atrás de endpoints FQDN unificados (como onboarding.purple.ai), a Purple minimiza o número de regras de domínio externo necessárias nos controladores sem fio, reduzindo erros de configuração e eliminando quedas pré-autenticação.
Ferramentas de diagnóstico de rede e WiFi relacionadas
Implantando WiFi para visitantes corporativo em redes multivendedor?
Elimine a manutenção complexa de walled gardens, avisos de SSL e tempos de limite do portal. O Purple integra-se nativamente com Cisco Meraki, Catalyst 9800, Aruba, UniFi, Fortinet, Mist e Ruckus para oferecer portais cativos de alta disponibilidade, integração Passpoint e análises comportamentais dos 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