Pular para o conteúdo principal

Configuração de Walled Garden para Guest WiFi

Este guia fornece uma referência técnica abrangente e neutra em relação a fornecedores para configurar walled gardens em implantações de WiFi de visitantes corporativos. Ele aborda a arquitetura de acesso pré-autenticação, o papel crítico da resolução de DNS dinâmico, a lista de permissões de domínios para login social, os requisitos de teste de Captive Portal do sistema operacional e as considerações de conformidade sob PCI DSS e GDPR. Destinado a gerentes de TI, arquitetos de rede e diretores de operações de locais, ele oferece orientações práticas de implementação com estudos de caso reais dos setores de hotelaria, varejo e eventos.

📖 11 min de leitura📝 2,695 palavras🔧 2 exemplos práticos3 questões práticas📚 9 definições principais

Ouça este guia

Ver transcrição do podcast
ROTEIRO DE PODCAST: Configuração de Walled Garden para WiFi de Visitantes Plataforma de Inteligência Purple WiFi — Série de Briefings Técnicos Duração: Aproximadamente 10 minutos Voz: Inglês britânico, tom de consultor sênior — confiante, conversacional, autoritativo --- [INTRODUÇÃO — 1 MINUTO] Bem-vindo à Série de Briefings Técnicos da Purple. Eu sou o seu anfitrião e hoje vamos abordar um dos elementos mais constantemente incompreendidos na implantação de WiFi corporativo para visitantes: o walled garden. Se você já teve uma implementação de WiFi para visitantes onde os usuários não conseguiam passar da splash page — não conseguiam fazer login com o Google, não conseguiam carregar o Captive Portal de jeito nenhum —, há uma grande chance de que a configuração do walled garden tenha sido a culpada. E, no entanto, esse é um daqueles itens que raramente recebe a atenção que merece em um briefing de design de rede. Nos próximos dez minutos, quero dar a você uma visão clara e prática do que realmente é um walled garden, por que ele é importante, quais domínios você precisa incluir na whitelist e como as integrações de login social mudam essa equação. Quer você esteja implantando WiFi para visitantes em uma rede de hotéis, em uma rede de varejo, em um estádio ou em instalações do setor público, este briefing fornecerá a estrutura de configuração necessária para acertar de primeira. Vamos começar. --- [APROFUNDAMENTO TÉCNICO — 5 MINUTOS] Então, o que é um walled garden no contexto de WiFi para visitantes? Pense da seguinte forma. Quando o dispositivo de um visitante se conecta à sua rede WiFi, mas ainda não se autenticou por meio do seu Captive Portal, esse dispositivo fica em uma espécie de estado de limbo. Ele tem um endereço IP. Ele pode enviar e receber pacotes. Mas o seu controlador de rede — seja ele um Cisco Meraki, um Ruckus SmartZone, um Fortinet FortiGate ou uma plataforma Aruba gerenciada na nuvem — está interceptando todas as solicitações HTTP e HTTPS de saída e redirecionando-as para a sua splash page. O walled garden é o conjunto de domínios e endereços IP que têm permissão explícita para passar por essa camada de interceptação antes que a autenticação seja concluída. Todo o resto é bloqueado. Essa é a parede (wall). O jardim (garden) é o espaço curado dentro dela — o pequeno conjunto controlado de recursos que um visitante pode acessar antes de provar quem é. Agora, por que isso importa tanto? Porque os Captive Portals modernos não são autossuficientes. Eles dependem de serviços externos para funcionar. Sua splash page pode estar hospedada em uma CDN. Seus botões de login social chamam endpoints OAuth no Google, Facebook, Apple ou Microsoft. Sua plataforma de analytics pode estar carregando scripts de rastreamento. Seu gateway de pagamento — se você estiver cobrando pelo acesso premium — precisa carregar seu próprio JavaScript e fazer chamadas de API. Cada uma dessas dependências externas precisa ser explicitamente incluída na whitelist do seu walled garden, caso contrário, o fluxo de autenticação falhará. Deixe-me orientá-lo pelas categorias de domínios que você precisa considerar. Primeiro: a sua própria plataforma de Captive Portal. Se você estiver usando o Purple, isso significa colocar na lista de permissões (whitelist) o CDN e os endpoints de API do Purple — coisas como cdn.purple.ai, portal.purple.ai e api.purple.ai. Se estiver usando uma plataforma diferente, o princípio é idêntico: coloque na lista de permissões todos os domínios que servem os recursos do portal e lidam com o handshake de autenticação. Segundo: Google OAuth. Este é o principal, porque o Google Sign-In é o método de login social mais comum em implantações de WiFi para convidados corporativos. Você precisa colocar na lista de permissões accounts.google.com, oauth2.googleapis.com, apis.google.com e o CDN gstatic.com — é de lá que o Google serve suas fontes, ícones e bibliotecas do lado do cliente. Se esquecer de qualquer um deles, o botão de login do Google falhará silenciosamente ou gerará um erro de CORS que o convidado nunca verá. Terceiro: Facebook e Meta OAuth. Se você estiver oferecendo login do Facebook — e em hotelaria e varejo, ele continua popular devido aos dados de marketing que fornece — você precisa colocar na lista de permissões www.facebook.com, graph.facebook.com, connect.facebook.net e o CDN do Facebook em static.xx.fbcdn.net. A Meta tem o hábito de rotacionar subdomínios de CDN, por isso recomendo o uso de entradas com caracteres curinga (wildcard) onde seu controlador suportar: *.fbcdn.net e *.facebook.com. Quarto: Apple Sign In. Isso se tornou obrigatório para qualquer aplicativo iOS que ofereça login de terceiros após 2019, e é cada vez mais esperado em portais baseados na web também. Os domínios principais são appleid.apple.com e idmsa.apple.com. A Apple também usa uma variedade de subdomínios em apple.com para seus fluxos de autenticação, portanto, uma entrada curinga para *.apple.com é a abordagem mais prática. Quinto: se você estiver operando uma camada de WiFi paga — comum em hubs de transporte, hotéis premium e centros de convenções — precisará colocar seu gateway de pagamento na lista de permissões. Para o Stripe, é stripe.com e *.stripe.com. Para o PayPal, é www.paypal.com e *.paypal.com. A conformidade com o PCI DSS exige que os fluxos de pagamento sejam processados via TLS 1.2 ou superior, e a configuração do seu walled garden precisa permitir esse tráfego sem interceptação. Agora, é aqui que a parte técnica fica interessante: o problema de resolução de DNS. A maioria dos controladores de rede implementa walled gardens no nível do endereço IP, e não puramente no nível do nome de domínio. Isso significa que quando você coloca accounts.google.com na lista de permissões, o controlador resolve esse domínio para um conjunto de endereços IP e permite o tráfego para esses IPs. O problema é que o Google, o Facebook, a Apple e os principais CDNs usam intervalos de IP dinâmicos e roteamento anycast. O endereço IP para o qual accounts.google.com resolve no seu data center não é necessariamente o mesmo IP para o qual ele resolve na sua rede de convidados, e ele mudará com o tempo. A implicação prática é esta: você não pode confiar em uma lista de permissões de IP estático. Você precisa de um controlador que execute a resolução de DNS dinâmico para entradas de walled garden — resolvendo os domínios permitidos em intervalos regulares e atualizando o conjunto de IPs permitidos de acordo. A maioria dos controladores de nível empresarial suporta isso. Se o seu não suportar, você estará operando com uma configuração que se degradará com o tempo, à medida que os intervalos de IP da CDN mudarem. Há também a questão da interceptação de HTTPS. Quando um dispositivo convidado faz uma solicitação HTTPS para um domínio não incluído na lista de permissões antes da autenticação, seu controlador tem duas opções: ele pode descartar a conexão silenciosamente ou pode tentar interceptá-la e redirecionar para o portal. Descartes silenciosos fazem com que o navegador do convidado exiba um erro genérico de "o site não pode ser acessado", o que é confuso. A interceptação requer um certificado TLS válido em seu controlador e, sem ele, o convidado vê um aviso de certificado — o que é alarmante e, em ambientes regulamentados, um potencial problema de conformidade. A solução limpa é garantir que a lógica de redirecionamento do seu portal opere no tráfego HTTP e que seu walled garden permita que o tráfego HTTPS para domínios na lista de permissões passe sem alterações. Deixe-me também abordar o mecanismo de detecção de Captive Portal, porque ele afeta diretamente o design do seu walled garden. Os sistemas operacionais modernos — iOS, Android, macOS, Windows — usam uma técnica chamada Captive Network Assistant, ou CNA. Quando um dispositivo se conecta a uma nova rede, o SO faz uma solicitação HTTP para um endpoint de teste conhecido: em dispositivos Apple, é o captive.apple.com; no Android, é o connectivitycheck.gstatic.com; no Windows, é o msftconnecttest.com. Se a resposta não for a esperada pelo SO, ele sabe que está atrás de um Captive Portal e inicia o navegador do portal automaticamente. O ponto crítico: todos esses endpoints de teste devem estar na lista de permissões do seu walled garden. Se estiverem bloqueados, o SO nunca detectará o Captive Portal, o convidado nunca verá a splash page e, sob a perspectiva dele, o WiFi simplesmente não funcionará. Este é um dos erros de configuração mais comuns que vejo em campo, e é totalmente evitável. --- [RECOMENDAÇÕES DE IMPLEMENTAÇÃO E ARMADILHAS — 2 MINUTOS] Deixe-me apresentar a estrutura de implementação que eu recomendaria para qualquer nova implantação. Comece com uma lista de permissões básica que cubra cinco categorias: a plataforma do seu portal, Google OAuth, Facebook OAuth, Apple Sign In e testes de Captive Portal do SO. Esse é o seu walled garden mínimo viável. Adicione gateways de pagamento se estiver operando com planos pagos. Adicione os domínios da sua plataforma de analytics e marketing se o seu portal carregar scripts de rastreamento. Teste seu walled garden antes de entrar em produção usando um dispositivo em estado não autenticado — não uma conta de teste, mas um dispositivo novo real que nunca tenha se conectado a essa rede. Passe por todos os métodos de login que você está oferecendo. Se algum método de login falhar, capture a saída do console do navegador e o tráfego de rede para identificar qual domínio está sendo bloqueado. Implemente um processo de revisão trimestral. Provedores de OAuth e CDNs alteram suas estruturas de domínio. A Apple atualizou seus domínios de Sign In duas vezes em 2023. O Google adiciona periodicamente novos subdomínios ao seu fluxo de OAuth. Um walled garden que estava correto na implantação perderá o alinhamento sem uma manutenção ativa. Os erros a evitar: primeiro, liberação excessiva (over-whitelisting). Já vi implantações em que a equipe de TI, frustrada por falhas intermitentes, simplesmente liberou faixas inteiras de IP ou adicionou entradas curinga que, na prática, burlaram o walled garden por completo. Isso anula o propósito e cria um risco de conformidade. Seja preciso. Segundo, ignorar o IPv6. Se a sua rede suporta IPv6 — e, cada vez mais, deveria — suas regras de walled garden precisam cobrir faixas de endereços IPv6, bem como IPv4. Terceiro, não considerar os deep links de aplicativos móveis. Alguns fluxos de login social, especialmente no iOS, tentam abrir o aplicativo nativo em vez de um navegador web. Isso pode quebrar o fluxo de OAuth completamente. Garanta que a configuração do seu portal force o OAuth baseado em web em vez de fluxos baseados em aplicativos. --- [PERGUNTAS E RESPOSTAS RÁPIDAS — 1 MINUTO] Deixe-me passar por algumas perguntas que ouço regularmente. "Preciso liberar toda a faixa de IP do Google?" Não. Libere domínios específicos e use resolução de DNS dinâmico. Liberar ASNs inteiros é um risco de segurança. "Posso usar a mesma configuração de walled garden em todos os meus sites?" Em tese, sim — se a sua plataforma de portal e os provedores de login social forem consistentes. Mas teste em cada site, pois os resolvedores de DNS locais podem se comportar de maneira diferente. "Como a GDPR afeta a configuração do walled garden?" A GDPR não rege diretamente os domínios do walled garden, mas rege quais dados seu portal coleta durante a autenticação. Certifique-se de que os escopos de OAuth do seu login social solicitem apenas os dados mínimos necessários — normalmente nome e e-mail — e que seu aviso de privacidade esteja acessível de dentro do walled garden antes que o visitante se autentique. "Qual é o TTL correto para entradas de DNS no walled garden?" A maioria dos controladores define como padrão 60 segundos. Para implantações de alta disponibilidade, recomendo não menos que 30 segundos para evitar carga excessiva de consultas DNS. --- [RESUMO E PRÓXIMOS PASSOS — 1 MINUTO] Para resumir: um walled garden é a zona controlada de pré-autenticação na sua implantação de WiFi para visitantes. Acertar nisso significa liberar sua plataforma de portal, todos os provedores de OAuth social que você está usando, endpoints de teste de Captive Portal do sistema operacional e quaisquer serviços de pagamento ou análise dos quais seu portal dependa. Use resolução de DNS dinâmico, não listas de IPs estáticos. Teste com dispositivos reais não autenticados antes de entrar em produção. E inclua um processo de revisão trimestral em seu calendário operacional. Se você está implantando ou revisando uma infraestrutura de WiFi para visitantes e deseja validar sua configuração atual de walled garden, a plataforma da Purple inclui gerenciamento integrado de walled garden com conjuntos de domínios pré-configurados para todos os principais provedores de login social. É uma daquelas coisas que é genuinamente mais fácil de acertar com as ferramentas certas apoiando você. Obrigado por ouvir. O guia de referência técnica completo para este tópico — incluindo diagramas de arquitetura, whitelists de domínio e cenários de implementação práticos — está disponível na base de conhecimento da Purple. Até a próxima. --- [FIM DO ROTEIRO]

Resumo Executivo

Um walled garden é um componente fundamental de qualquer implantação de WiFi para convidados segura e amigável. Ele define o conjunto limitado de recursos de rede que o dispositivo de um convidado pode acessar antes de concluir a autenticação por meio de um Captive Portal. Uma configuração incorreta ou incompleta do walled garden é a principal causa isolada de falhas de login de convidados em implantações corporativas — resultando em uma experiência do usuário degradada, aumento de chamados de suporte e danos mensuráveis à reputação em ambientes de hotelaria e varejo. Para gerentes de TI e arquitetos de rede, dominar a configuração de walled garden WiFi não é apenas uma tarefa técnica; é um passo crítico para mitigar riscos de segurança, garantir a conformidade com padrões como PCI DSS v4.0 e GDPR, e maximizar o retorno sobre o investimento de uma infraestrutura de WiFi para convidados. Este guia fornece uma estrutura neutra em relação a fornecedores e acionável para projetar, implementar e manter um walled garden robusto que suporte métodos modernos de autenticação — incluindo logins sociais via OAuth 2.0, gateways de pagamento e detecção de Captive Portal em nível de sistema operacional — em ambientes corporativos, incluindo hotelaria, varejo, eventos e organizações do setor público.

header_image.png

Aprofundamento Técnico

A Anatomia do Acesso Pré-Autenticação

Em uma arquitetura típica de WiFi para convidados, quando o dispositivo de um usuário se associa a um SSID aberto, ele recebe um endereço IP via DHCP e é colocado em uma função de pré-autenticação ou VLAN isolada pelo controlador de rede. Nesse estado, o controlador intercepta todo o tráfego HTTP e HTTPS de saída e o redireciona para a página de splash do Captive Portal. Esse é o mecanismo que força o navegador do convidado a ir para a tela de login. O walled garden é a exceção explícita a essa regra de interceptação: uma lista de permissões selecionada de domínios externos e faixas de endereços IP com os quais o dispositivo tem permissão para se comunicar livremente durante a fase de pré-autenticação.

Sem um walled garden configurado corretamente, os próprios serviços necessários para concluir a autenticação são bloqueados. Os Captive Portals modernos não são aplicações monolíticas e independentes. Eles são compostos de microsserviços e APIs de terceiros. Os próprios ativos do portal — HTML, CSS, JavaScript e imagens — podem ser servidos a partir de uma Rede de Distribuição de Conteúdo (CDN) totalmente separada da infraestrutura local do controlador. A funcionalidade de login social depende do alcance dos endpoints do OAuth 2.0 no Google, Facebook, Apple ou Microsoft. Se um plano de WiFi pago for oferecido, o portal deve se comunicar com um processador de pagamento, como Stripe ou PayPal. Plataformas de análise e marketing podem carregar scripts de rastreamento de suas próprias origens de CDN. Cada uma dessas dependências representa um domínio que deve ser explicitamente permitido no walled garden, caso contrário, o fluxo de autenticação falhará silenciosamente ou com um erro confuso.

walled_garden_architecture.png

O Problema de Resolução de DNS

O aspecto tecnicamente mais sutil da configuração do walled garden é a lacuna entre a administração baseada em domínio e a aplicação baseada em IP. Enquanto os administradores de rede configuram o walled garden usando nomes de domínio legíveis por humanos (por exemplo, accounts.google.com), a maioria dos controladores de rede aplica essas regras na camada de IP. Quando um domínio é adicionado à lista de permissões, o controlador realiza uma consulta DNS para resolvê-lo em um ou mais endereços IP e adiciona esses IPs a uma lista de controle de acesso (ACL) temporária.

Isso cria um risco operacional significativo com os principais provedores de nuvem. Google, Meta, Apple e as principais CDNs usam roteamento anycast e atribuição dinâmica de endereço IP. O endereço IP que accounts.google.com resolve no momento da configuração pode ser totalmente diferente do endereço que ele resolve seis meses depois, ou mesmo em um segmento de rede diferente. Uma lista de permissões de IP estático, portanto, não é uma configuração sustentável; ela se degradará com o tempo à medida que os intervalos de IP da CDN mudarem.

A solução correta é a resolução dinâmica de DNS, onde o controlador de rede resolve periodicamente cada domínio na lista de permissões e atualiza suas ACLs de acordo. A maioria dos controladores de nível empresarial da Cisco, Aruba, Ruckus e Fortinet oferece suporte nativo a isso. Se o seu controlador não suportar, você estará operando com uma configuração que produzirá falhas intermitentes difíceis de diagnosticar e que piorarão com o tempo.

Interceptação HTTPS e Conformidade TLS

Uma camada adicional de complexidade surge da prevalência do HTTPS. Quando um dispositivo convidado no estado de pré-autenticação tenta carregar um recurso HTTPS que não está na lista de permissões, o controlador deve decidir como lidar com a solicitação. Existem duas abordagens comuns, ambas com desvantagens significativas se não forem gerenciadas corretamente.

A primeira abordagem é um silent drop (descarte silencioso), onde o controlador simplesmente bloqueia a conexão. O navegador do visitante exibe um erro genérico de "o site não pode ser acessado", o que não fornece nenhuma orientação útil e é frequentemente interpretado como uma falha de rede, em vez de um aviso de portal. A segunda abordagem é a interceptação HTTPS, onde o controlador tenta apresentar um redirecionamento para o Captive Portal. Isso exige que o controlador atue como um proxy man-in-the-middle (MITM), apresentando seu próprio certificado TLS. Se esse certificado não for confiável para o dispositivo do visitante — o que quase nunca é em uma rede pública de visitantes — o navegador exibirá um aviso de segurança, o que é alarmante para os usuários e, em ambientes regulamentados, pode constituir um problema de conformidade.

A abordagem arquitetônica correta é garantir que todos os domínios necessários para o fluxo de autenticação estejam na lista de permissões (whitelist), permitindo que seu tráfego HTTPS passe sem alterações. O redirecionamento do Captive Portal deve ser acionado pelo mecanismo de varredura no nível do sistema operacional, em vez de pela interceptação HTTPS. Isso elimina totalmente o problema de confiança do certificado. Os navegadores modernos também implementam o HTTP Strict Transport Security (HSTS) e, em alguns casos, a fixação de certificado (certificate pinning). Ambos os mecanismos farão com que a interceptação HTTPS falhe imediatamente para os principais domínios, produzindo uma conexão interrompida em vez de um redirecionamento — outro argumento forte para um walled garden configurado corretamente em vez de uma política ampla de interceptação HTTPS.

Captive Network Assistant (CNA) e Domínios de Varredura do SO

Um dos aspectos mais frequentemente negligenciados na configuração do walled garden é o mecanismo pelo qual os sistemas operacionais modernos detectam a presença de um Captive Portal. Todos os principais sistemas operacionais — iOS, iPadOS, macOS, Android e Windows — implementam um Captive Network Assistant (CNA) que varre um endpoint HTTP conhecido imediatamente após a conexão a uma nova rede WiFi. Se a resposta for diferente do valor esperado, o SO infere que está atrás de um Captive Portal e abre automaticamente uma janela do navegador para processar o login.

Os endpoints de varredura usados por cada plataforma são os seguintes:

Sistema Operacional Domínio de Varredura Resposta Esperada
Apple (iOS, macOS) captive.apple.com HTTP 200 com corpo específico
Android (Google) connectivitycheck.gstatic.com HTTP 204 No Content
Windows www.msftconnecttest.com HTTP 200 com corpo específico
Firefox / Mozilla detectportal.firefox.com HTTP 200 com corpo específico

Se qualquer um desses domínios de varredura for bloqueado pelo walled garden, o SO nunca detectará o Captive Portal. Do ponto de vista do visitante, a rede WiFi simplesmente não terá acesso à internet. Este é um dos erros de configuração mais comuns observados em implantações de produção e é totalmente evitável ao incluir esses domínios na lista de permissões básica.

Guia de Implantação

Passo 1: Descoberta de Domínio de Linha de Base

Antes de alterar a configuração do seu controlador, realize uma auditoria minuciosa de cada serviço externo do qual o seu Captive Portal depende. A melhor maneira de fazer isso é carregando o portal em um navegador com as ferramentas de desenvolvedor abertas e inspecionando a aba de rede para identificar todas as solicitações de recursos externos. A lista resultante deve ser categorizada da seguinte forma:

Categoria Finalidade Domínios Essenciais
Plataforma de Captive Portal Serve os recursos da splash page e gerencia a lógica de autenticação. *.purple.ai, cdn.your-vendor.com
Google OAuth Permite o Google Sign-In. accounts.google.com, oauth2.googleapis.com, apis.google.com, *.gstatic.com
Facebook / Meta OAuth Permite o Facebook Login. www.facebook.com, graph.facebook.com, connect.facebook.net, *.fbcdn.net
Apple Sign In Permite o Sign in com a Apple. appleid.apple.com, idmsa.apple.com, *.apple.com
Sondas de Captive Portal de SO Permite a detecção automática do portal. captive.apple.com, connectivitycheck.gstatic.com, www.msftconnecttest.com
Gateways de Pagamento Processa pagamentos para planos premium. *.stripe.com, *.paypal.com
Analytics / Marketing Carrega scripts de rastreamento e analytics. Específico do fornecedor (ex: *.segment.com, *.mixpanel.com)

domain_whitelist_infographic.png

Passo 2: Configuração do Controlador

A implementação varia de acordo com o fornecedor, mas os princípios subjacentes são universais. Navegue até a configuração do Captive Portal ou splash page na interface de gerenciamento do seu controlador de rede — no Cisco Meraki, isso é encontrado em Wireless > Configure > Splash Page; no Aruba Central, é o Captive Portal Profile; no Fortinet, fica dentro de Security Policies > Captive Portal. Localize a seção de acesso pré-autenticação ou lista de permissões do walled garden e proceda da seguinte forma:

  1. Insira os Domínios por Categoria: Adicione cada domínio da sua auditoria sistematicamente, passando por cada categoria. Use curingas (*.gstatic.com) onde seu controlador os suportar e onde o perfil de risco for aceitável. Para ambientes de alta segurança, prefira subdomínios explícitos em vez de curingas amplos.
  2. Habilite a Resolução de DNS Dinâmico: Confirme se o seu controlador está configurado para resolver periodicamente os domínios da lista de permissões, em vez de armazenar em cache uma lista de IPs estáticos. Consulte a documentação do seu fornecedor para verificar se isso está ativo. Defina um TTL de DNS de 60 segundos ou menos para as entradas do walled garden.
  3. Configure Regras de Dual-Stack: Se a sua rede suporta IPv6 — e deveria, considerando o esgotamento do espaço de endereçamento IPv4 — garanta que suas ACLs de walled garden se apliquem tanto ao tráfego IPv4 quanto ao IPv6. Um dispositivo de convidado com um endereço IPv6 ignorará as ACLs exclusivas para IPv4.
  4. Apply to Guest SSID: Associe o perfil do Captive Portal e seu walled garden apenas ao SSID de convidados. Nunca aplique políticas de walled garden de nível de convidado a SSIDs corporativos.

network_engineer_config.png

Passo 3: Protocolo de Testes Pré-Lançamento

Os testes são inegociáveis e devem ser realizados com dispositivos reais em um estado genuíno de pré-autenticação — não com contas de administrador que possam ter acesso elevado, e não com dispositivos que já se conectaram anteriormente à rede e possam ter credenciais em cache.

Para cada plataforma de dispositivo (iOS, Android, Windows, macOS), execute o seguinte:

  1. Esqueça a rede no dispositivo de teste para garantir que não haja estado em cache.
  2. Conecte-se ao SSID de convidados e observe se o Captive Portal é iniciado automaticamente via mecanismo CNA.
  3. Tente todos os métodos de login oferecidos no portal — cadastro por e-mail, Google Sign-In, Facebook Login, Apple Sign In — e confirme se cada um é concluído com sucesso.
  4. Teste o fluxo de pagamento se uma camada paga for oferecida, usando um número de cartão de teste do ambiente de sandbox do seu gateway de pagamento.
  5. Inspecione o console do navegador em qualquer teste que falhar. A aba de rede identificará o domínio exato que está sendo bloqueado, permitindo que você o adicione à whitelist com precisão.

Documente os resultados deste protocolo de teste em um registro de configuração que seja retido para fins de conformidade.

Melhores Práticas

O Princípio do Menor Privilégio é a regra fundamental para a configuração do walled garden. Adicione à whitelist apenas os domínios que são comprovadamente necessários para o funcionamento do fluxo de autenticação. Evite wildcards amplos como *.google.com ou *.facebook.com, a menos que a implementação do seu controlador os exija; prefira subdomínios específicos. Cada domínio adicional na whitelist representa uma superfície de ataque potencial na zona de pré-autenticação.

Uma Cadência de Revisão Trimestral é essencial para manter um walled garden funcional ao longo do tempo. Provedores de login social e CDNs atualizam sua infraestrutura regularmente. A Apple modificou sua estrutura de domínio do Sign In em 2023. O Google adicionou novos subdomínios ao seu fluxo de OAuth em várias ocasiões. Um walled garden que estava correto na implantação perderá o alinhamento em poucos meses sem manutenção ativa. Inclua uma revisão trimestral em seu calendário operacional, cruzando sua whitelist com a documentação atual de cada provedor. Alinhamento de Conformidade exige que a configuração do seu walled garden não viole inadvertidamente os requisitos das normas aplicáveis. Sob o PCI DSS v4.0, qualquer rede que processe, armazene ou transmita dados de portadores de cartão deve manter controles de acesso rigorosos. Se o seu WiFi de convidados incluir uma categoria paga, o walled garden deve permitir conexões TLS 1.2 ou superior para o seu processador de pagamento sem interceptação. Sob a GDPR, o aviso de privacidade deve estar acessível aos convidados antes que eles forneçam quaisquer dados pessoais — o que significa que o link para sua política de privacidade deve ser acessível de dentro do walled garden, mesmo antes da autenticação.

Documentação de Gerenciamento de Mudanças é uma obrigação profissional para qualquer alteração em rede de produção. Cada modificação no walled garden — seja adicionando um novo domínio, removendo um descontinuado ou atualizando um caractere curinga (wildcard) — deve ser registrada com um carimbo de data/hora, o motivo da alteração e o engenheiro responsável. Essa trilha de auditoria é inestimável para a resolução de falhas intermitentes e para demonstrar a devida diligência em uma auditoria de conformidade.

Resolução de Problemas e Mitigação de Riscos

A tabela a seguir mapeia os modos de falha mais comuns às suas causas raiz e mitigações recomendadas:

Sintoma Causa Raiz Mitigação
O portal não inicia automaticamente no iOS/Android Os domínios de teste de Captive Portal do SO estão bloqueados. Adicione captive.apple.com e connectivitycheck.gstatic.com ao walled garden.
O botão de login do Google não responde Um ou mais domínios do Google OAuth ou CDN estão ausentes. Adicione accounts.google.com, oauth2.googleapis.com, apis.google.com e *.gstatic.com.
O login do Facebook falha com um erro de CORS Os subdomínios da CDN do Facebook (*.fbcdn.net) não estão na lista de permissões. Adicione entradas curinga para *.fbcdn.net e *.facebook.com.
O login funciona inicialmente, mas falha de forma intermitente Lista de permissões de IP estático; os endereços IP da CDN rotacionaram. Ative a resolução de DNS dinâmico no controlador.
Os convidados veem avisos de certificado TLS O controlador está interceptando o tráfego HTTPS para domínios não listados na lista de permissões. Adicione todos os domínios necessários à lista de permissões para que o HTTPS passe sem interrupções.
A página de pagamento não carrega Os domínios de API ou CDN do gateway de pagamento não estão na lista de permissões. Adicione *.stripe.com ou *.paypal.com conforme apropriado.
Usuários de IPv6 não conseguem acessar o portal As ACLs do walled garden são apenas IPv4. Estenda todas as regras do walled garden para cobrir intervalos de endereços IPv6.
Mitigação de Riscos: Over-Whitelisting é um risco real e subestimado. Quando ocorrem falhas intermitentes, a resposta tentadora é adicionar entradas de wildcard progressivamente mais amplas até que o problema desapareça. Essa abordagem pode resultar em um walled garden que é efetivamente aberto, permitindo que convidados não autenticados acessem grandes partes da internet sem concluir o fluxo de login. Isso anula o propósito do Captive Portal, prejudica a coleta de dados para fins de marketing e pode criar responsabilidade sob o GDPR se os convidados puderem acessar a rede sem consentir com os termos e condições. Sempre diagnostique o domínio bloqueado específico antes de adicionar entradas.

ROI e Impacto nos Negócios

Um walled garden implementado corretamente oferece valor comercial mensurável em várias dimensões. No setor de hospitalidade, uma experiência de login de WiFi de convidado perfeita se correlaciona diretamente com as pontuações de satisfação dos hóspedes. Pesquisas da J.D. Power identificam consistentemente o desempenho do WiFi como um dos principais fatores de satisfação dos hóspedes de hotéis. Um portal que falha ao carregar — porque o walled garden está mal configurado — cria uma primeira impressão negativa que afeta toda a experiência da estadia.

Para operadores de varejo, o walled garden é a porta de entrada para o programa de fidelidade. Cada convidado que faz login com sucesso por meio do Captive Portal fornece uma identidade verificada que pode ser vinculada ao comportamento de compra, permitindo campanhas de marketing personalizadas com taxas de conversão comprovadamente mais altas do que a publicidade anônima. Um walled garden mal configurado que impede o login reduz diretamente o volume de dados primários capturados, com um impacto quantificável no ROI de marketing.

No setor de eventos — estádios, centros de conferências, pavilhões de exposições —, o walled garden deve ser projetado para escala. No pico de carga, dezenas de milhares de dispositivos tentarão se autenticar simultaneamente. Um walled garden que depende de um resolvedor DNS lento ou sobrecarregado criará um gargalo que se manifesta como um portal lento ou que não responde, mesmo que a infraestrutura de rede subjacente esteja dimensionada corretamente. Implantar um resolvedor DNS local de cache que seja autoritativo para domínios de walled garden é uma prática padrão para implantações de alta densidade.

Para organizações do setor público, o walled garden também é um instrumento de conformidade. Sob os Regulamentos de Redes e Sistemas de Informação (NIS) do Reino Unido e o escopo mais amplo do GDPR, as organizações devem demonstrar que o acesso a redes voltadas para o público é controlado e auditável. Um walled garden configurado corretamente, combinado com um Captive Portal em conformidade, fornece a base técnica para essa trilha de auditoria.

O custo de configurar incorretamente o walled garden não é meramente técnico. Ele é medido no volume de chamadas do helpdesk, nas pontuações de satisfação dos hóspedes, na perda de dados de marketing e na potencial exposição regulatória. O investimento na configuração e manutenção de um walled garden robusto é modesto em relação a esses riscos, e o retorno — na forma de maiores taxas de adoção do portal, dados primários mais ricos e menor fricção operacional — é mensurável e significativo.

Definições principais

Walled Garden

Um conjunto controlado de domínios e faixas de endereços IP pré-aprovados que um dispositivo de convidado pode acessar em uma rede WiFi antes de concluir a autenticação. Todo o tráfego para domínios fora desta lista é bloqueado ou redirecionado para o Captive Portal.

Este é o mecanismo fundamental que permite o funcionamento de um Captive Portal. Sem ele, o próprio portal — e todos os provedores de login social dos quais ele depende — ficariam inacessíveis para dispositivos não autenticados.

Captive Portal

Uma página web que intercepta o tráfego de internet de um usuário de WiFi recém-conectado e exige que ele realize uma ação — como fazer login, aceitar os termos ou efetuar um pagamento — antes de liberar o acesso total à rede.

O Captive Portal é o principal ponto de interação para os convidados. É o mecanismo pelo qual os operadores coletam dados primários, aplicam termos de serviço e gerenciam planos de acesso pagos.

OAuth 2.0

Um padrão aberto de autorização que permite aos usuários conceder a um aplicativo de terceiros acesso limitado à sua conta em outro serviço, sem compartilhar sua senha. É o protocolo que sustenta o "Entrar com o Google" e o "Entrar com o Facebook".

Todas as opções de login social em um Captive Portal dependem do OAuth 2.0. Os endpoints de OAuth de cada provedor devem ser incluídos na lista de permissões (whitelist) do walled garden para que o fluxo de login seja concluído com sucesso.

Resolução de DNS Dinâmico

Um recurso do controlador de rede que resolve periodicamente os nomes de domínio permitidos para seus endereços IP atuais e atualiza as ACLs de aplicação de acordo, em vez de usar uma lista de IPs estáticos.

Isso é essencial para a confiabilidade do walled garden. Sem isso, os endereços IP armazenados em cache no momento da implantação ficarão desatualizados à medida que as CDNs rotacionam sua infraestrutura, causando falhas de login intermitentes e difíceis de diagnosticar.

Rede de Distribuição de Conteúdo (CDN)

Uma rede de servidores distribuída geograficamente que entrega conteúdo web aos usuários a partir do local mais próximo disponível, melhorando o desempenho e a disponibilidade.

Os Captive Portals e os provedores de login social dependem de CDNs para fornecer scripts, fontes e imagens. Os subdomínios de CDN (por exemplo, *.gstatic.com para o Google, *.fbcdn.net para o Facebook) devem ser incluídos no walled garden.

Assistente de Rede Captive (CNA)

Um recurso integrado dos sistemas operacionais modernos (iOS, Android, Windows, macOS) que detecta automaticamente a presença de um Captive Portal ao testar um endpoint HTTP conhecido após a conexão a uma nova rede WiFi.

O CNA é o que faz com que a janela de login do portal apareça automaticamente no dispositivo do convidado. Se o domínio de teste for bloqueado pelo walled garden, o CNA não conseguirá detectar o portal e o convidado não verá nenhuma solicitação de login.

ACL de Pré-Autenticação

Uma Lista de Controle de Acesso aplicada a uma sessão de rede antes de o usuário ser autenticado. Ela define qual tráfego é permitido (o walled garden) e qual é bloqueado ou redirecionado.

Esta é a implementação técnica do walled garden em controladores de rede corporativos. As equipes de TI configuram as ACLs de Pré-Autenticação nas configurações de Captive Portal de seus controladores sem fio.

PCI DSS

O Payment Card Industry Data Security Standard é um conjunto de padrões de segurança projetado para garantir que todas as empresas que aceitam, processam, armazenam ou transmitem informações de cartão de crédito mantenham um ambiente seguro.

Relevante para qualquer implantação de WiFi para convidados com um plano de acesso pago. O walled garden deve permitir conexões TLS 1.2+ com o gateway de pagamento sem interceptação, e a rede de convidados deve ser segmentada de qualquer ambiente de dados de portadores de cartão.

Segurança de Transporte Estrita HTTP (HSTS)

Um mecanismo de política de segurança web que instrui os navegadores a interagir com um servidor apenas usando HTTPS, evitando ataques de downgrade de protocolo e sequestro de cookies.

O HSTS faz com que a interceptação de HTTPS por um controlador de Captive Portal falhe imediatamente para os principais domínios, pois o navegador se recusa a aceitar um certificado no qual não confia. Isso reforça a necessidade de um walled garden configurado corretamente em vez de uma abordagem de interceptação de HTTPS.

Exemplos práticos

Um hotel de luxo de 500 quartos está implantando uma nova rede WiFi para hóspedes usando hardware Cisco Meraki e a plataforma Purple. Eles precisam oferecer suporte a logins do Google e Facebook, e oferecer um plano pago de velocidade premium via Stripe. Qual é o conjunto mínimo de domínios que deve ser incluído na lista de permissões (walled garden) do Meraki e como eles devem ser configurados?

Os seguintes domínios devem ser inseridos no painel do Meraki em Wireless > Configure > Splash Page > Walled Garden Ranges:

  1. Plataforma Purple: *.purple.ai (cobre os subdomínios cdn, portal e api)
  2. Google OAuth: accounts.google.com, oauth2.googleapis.com, apis.google.com, *.gstatic.com
  3. Facebook OAuth: www.facebook.com , graph.facebook.com, connect.facebook.net, *.fbcdn.net
  4. Stripe Payments: *.stripe.com
  5. Sondas de SO: captive.apple.com, connectivitycheck.gstatic.com, www.msftconnecttest.com

A Cisco Meraki realiza a resolução de DNS dinâmico nativamente para entradas do walled garden, portanto, nenhuma configuração adicional é necessária para a resolução de IP. O hotel também deve garantir que a URL da sua política de privacidade esteja acessível de dentro do walled garden para cumprir com o GDPR. Após a implantação, a equipe de TI deve testar com um dispositivo iOS restaurado para os padrões de fábrica e um dispositivo Android restaurado para os padrões de fábrica para verificar o fluxo completo de login para ambos os métodos de login social.

Comentário do examinador: Esta solução é abrangente e precisa. Ela identifica corretamente todas as cinco categorias de domínios essenciais para este cenário específico. A inclusão de domínios de sondas de SO é um detalhe crítico que frequentemente é esquecido. A referência ao caminho de configuração específico do Meraki demonstra conhecimento prático e aplicável. A nota de conformidade com o GDPR adiciona o contexto de negócios que diferencia a resposta de um profissional sênior de uma resposta puramente técnica.

Uma rede de varejo nacional com 200 lojas está enfrentando falhas intermitentes de login do Google em seu WiFi de convidados. As falhas são aleatórias — algumas lojas não são afetadas, outras apresentam falhas em determinados dias ou horários. A rede usa controladores Fortinet FortiGate. Qual é a causa raiz mais provável e como você a resolveria?

A causa raiz mais provável é que o walled garden do FortiGate está usando uma lista de IPs estáticos para os domínios de OAuth do Google, e a CDN do Google rotacionou seus endereços IP em alguns locais. A natureza intermitente e específica por local das falhas é um indicador clássico de rotação de IP de CDN — as listas de IPs em cache de algumas lojas ainda são válidas, enquanto outras ficaram desatualizadas.

Etapas de resolução:

  1. Faça login no console de gerenciamento do FortiGate em uma loja afetada e navegue até a configuração do walled garden do Captive Portal.
  2. Verifique se os domínios de OAuth do Google estão configurados como nomes de domínio ou como endereços IP estáticos.
  3. Se houver IPs estáticos, substitua-os por entradas baseadas em domínio: accounts.google.com, oauth2.googleapis.com, apis.google.com, *.gstatic.com.
  4. Ative os objetos de endereço baseados em FQDN do FortiGate com um intervalo de atualização curto (recomendado: 60 segundos) para garantir que a resolução de DNS dinâmico esteja ativa.
  5. Implemente essa alteração de configuração em todas as 200 lojas via FortiManager para garantir a consistência.
  6. Monitore as lojas afetadas por 48 horas após a alteração para confirmar a resolução.
Comentário do examinador: Este diagnóstico identifica corretamente o problema de IP estático / rotação de CDN como a causa raiz de falhas intermitentes e geograficamente distribuídas. A resolução é tecnicamente precisa e demonstra conhecimento do recurso de objeto de endereço FQDN do FortiGate. A recomendação de usar o FortiManager para implantação centralizada reflete a realidade operacional de uma implantação em 200 lojas e mostra conscientização sobre o gerenciamento de mudanças em escala.

Questões práticas

Q1. Você está projetando o WiFi de visitantes para um novo terminal de aeroporto internacional. Os requisitos incluem login via Google, Apple e WeChat, além de uma camada de acesso premium vendida via PayPal. Quais desafios únicos esse cenário apresenta para a sua configuração de walled garden e como você os resolveria?

Dica: Considere a natureza geográfica e específica do aplicativo do fluxo de login do WeChat, e as implicações de uma base de usuários globalmente diversa para a resolução de IP de CDN.

Ver resposta modelo

Três desafios únicos surgem. Primeiro, o login do WeChat: ao contrário do OAuth padrão baseado na web, o fluxo de login do WeChat em dispositivos móveis frequentemente tenta abrir o aplicativo nativo do WeChat por meio de um deep link, em vez de concluir o fluxo em um navegador web. Isso pode quebrar completamente o fluxo do Captive Portal. A solução é configurar o portal para forçar um fluxo de código QR baseado na web e colocar na whitelist os domínios específicos da Tencent que servem o código QR e lidam com o handshake de autenticação (ex: open.weixin.qq.com, wx.qq.com). Segundo, a resolução global de CDN: um aeroporto internacional atende a usuários de todas as regiões. A resolução de DNS dinâmico é crítica, pois Google, Apple e PayPal servem seu conteúdo a partir de nós de CDN distribuídos geograficamente. O controlador deve re-resolver os domínios do walled garden frequentemente para garantir que os endereços IP regionais corretos estejam na whitelist. Terceiro, a localização do PayPal: o PayPal usa domínios e CDNs específicos de cada país para experiências de pagamento localizadas. Além de *.paypal.com, pode ser necessário colocar na whitelist *.paypalobjects.com e variantes regionais. Recomenda-se uma auditoria minuciosa do fluxo de checkout do PayPal a partir de múltiplos locais de dispositivos antes do go-live.

Q2. Um estádio de 60.000 lugares está enfrentando falhas generalizadas de login no portal durante os primeiros 15 minutos de cada evento, após os quais o desempenho se normaliza. A infraestrutura está dimensionada corretamente para a carga de usuários. Qual é o provável gargalo e como você o resolveria?

Dica: Pense no que acontece quando 60.000 dispositivos tentam se conectar e resolver os mesmos domínios simultaneamente.

Ver resposta modelo

O gargalo é quase certamente a resolução de DNS. Quando 60.000 dispositivos se conectam simultaneamente, todos tentam resolver os mesmos domínios do walled garden (CDN do portal, Google OAuth, Apple Sign In, etc.) ao mesmo tempo. Se o resolvedor de DNS upstream — normalmente o resolvedor recursivo do ISP ou um serviço de DNS em nuvem — não puder lidar com esse pico de consultas, a latência de resolução aumenta, fazendo com que o portal pareça lento ou sem resposta, mesmo que a rede em si esteja funcionando corretamente. O desempenho se normaliza após a correria inicial porque o cache do resolvedor aquece e as consultas subsequentes são servidas a partir do cache. A solução é implantar um resolvedor de DNS local com cache (ex: Unbound ou um appliance dedicado) dentro da infraestrutura de rede do estádio. Esse resolvedor deve ser pré-alimentado com os domínios do walled garden antes do início do evento, para que todas as consultas de DNS para esses domínios sejam respondidas a partir do cache local com latência de sub-milissegundos. A configuração de DHCP do controlador deve apontar os dispositivos dos visitantes para este resolvedor local.

Q3. Sua empresa está adquirindo uma rede de hotéis boutique que usa a plataforma de Captive Portal de um concorrente. Você tem a tarefa de migrá-los para a Purple. A equipe de TI existente não possui documentação de sua configuração atual de walled garden. Como você abordaria a migração para garantir que não haja interrupção para os hóspedes?

Dica: Antes de construir o novo, você deve entender o antigo. Considere tanto a descoberta técnica quanto os requisitos de negócios.

Ver resposta modelo

A migração deve ocorrer em quatro etapas. Etapa 1 — Descoberta: Conecte um laptop ao WiFi de visitantes existente em um estado não autenticado e use uma ferramenta de captura de pacotes (Wireshark) para registrar todas as consultas de DNS e solicitações HTTP/HTTPS feitas durante o fluxo de autenticação. Isso produz uma lista definitiva de todos os domínios dos quais o portal existente depende, independentemente do que está ou não documentado. Etapa 2 — Categorização: Mapeie os domínios descobertos para as categorias padrão (plataforma do portal, OAuth, CDN, sondagens de OS, pagamentos). Identifique quaisquer domínios não padrão — estes podem indicar integrações personalizadas (ex: uma API de programa de fidelidade, uma plataforma de marketing local) que devem ser preservadas na nova configuração. Etapa 3 — Implantação Paralela: Configure a plataforma Purple com a lista de domínios descoberta e implante-a em um SSID de teste ao lado do portal existente. Execute o protocolo de teste completo em ambos os SSIDs simultaneamente para validar se a configuração da Purple é funcionalmente equivalente. Etapa 4 — Transição: Uma vez validada, migre o SSID de produção para a Purple durante um período de baixo tráfego (ex: 3h da manhã em uma noite de semana). Monitore as taxas de adoção do portal e os chamados do helpdesk pelas 48 horas seguintes para confirmar uma transição limpa.

Continue a ler esta série

How to Set Up a Captive Portal on Starlink: A Guide for Remote & Maritime Venues

Este guia detalha como contornar o hardware nativo da Starlink e integrar um Captive Portal gerenciado na nuvem usando equipamentos de roteamento corporativos. Você aprenderá como superar a limitação de CGNAT, impor a segmentação de VLAN, gerenciar restrições de largura de banda de satélite e garantir a conformidade regulatória.

Ler o guia →

Melhores Práticas de Captive Portal: Projetando para Alta Conversão e Conformidade

Este guia técnico oferece aos gerentes de TI, arquitetos de rede e diretores de operações de locais um roteiro completo para a implantação de captive portals que equilibram a segurança de rede com uma alta conversão de usuários. O guia abrange toda a arquitetura, desde a segmentação de VLAN e autenticação RADIUS até o design de consentimento em conformidade com a GDPR e a seleção de métodos de autenticação. Extraído da experiência operacional da Purple em mais de 80.000 locais e 440 milhões de logins em 2024, cada recomendação é baseada em dados reais de implantação.

Ler o guia →

Como otimizar Captive Portals para máxima segurança de rede e conversão de usuários

Este guia fornece um blueprint técnico completo para otimizar captive portals em ambientes corporativos, cobrindo arquitetura de segmentação de rede, seleção de métodos de autenticação, design de consentimento em conformidade com o GDPR e otimização de conversão. Ele foi escrito para gerentes de TI, arquitetos de rede e CTOs em hotéis, redes de varejo, estádios e organizações do setor público que precisam equilibrar a segurança de rede com a captura de dados primários (first-party data). A Purple opera a infraestrutura de captive portal em mais de 80.000 locais, com 440 milhões de logins em 2024, e as estruturas apresentadas aqui refletem essa experiência operacional.

Ler o guia →