Integração de Access Points Grandstream GWN com Purple WiFi

Bem-vindo à série Purple Technical Briefing. Sou seu anfitrião e hoje abordaremos um padrão de implantação que está se tornando cada vez mais comum nos setores de hotelaria, varejo e propriedades multi-tenant: a integração dos access points Grandstream GWN com a plataforma de WiFi para visitantes da Purple. Se você é um MSP, uma equipe de TI interna ou um arquiteto de rede que recebeu uma implantação do Grandstream GWN e precisa adicionar um Captive Portal personalizado com analytics, este episódio é para você. Abordaremos toda a estrutura: redirecionamento de splash page de visitantes, configuração de walled garden, WiFi seguro para funcionários usando 802.1X e segmentação multi-tenant usando o recurso Private Pre-Shared Key da Grandstream. Vamos ao que interessa. --- Primeiro, um pouco de contexto. A série GWN da Grandstream é uma linha robusta de access points para o mercado intermediário. Você tem o GWN7600 e o GWN7630 para implantações internas, o GWN7660 e o GWN7664 para ambientes Wi-Fi 6, e o GWN7610 como uma opção de montagem no teto para espaços de maior densidade. Eles são gerenciados por meio do GWN Manager, que é um controlador local instalado em um servidor Linux ou Windows, ou pelo GWN dot Cloud, a plataforma de gerenciamento na nuvem da Grandstream, agora reformulada como GDMS Networking. A boa notícia para os MSPs é que ambas as plataformas de gerenciamento oferecem suporte nativo à configuração de Captive Portal. Você pode criar a política do portal, personalizar a splash page e associá-la a um SSID inteiramente dentro do GWN Manager ou GWN dot Cloud. No entanto, para implantações corporativas que exigem captura de dados em conformidade com o GDPR, automação de marketing e analytics em tempo real, você precisará substituir esse portal nativo por uma plataforma externa. É aí que a Purple entra. A Purple opera como um cloud overlay. Ela se posiciona acima do seu hardware e fornece o Captive Portal, a camada de autenticação RADIUS, o motor de analytics e as ferramentas de marketing. A Purple atende a 80.000 locais ativos e processou 440 milhões de logins somente em 2024, demonstrando a robustez da plataforma em larga escala. A integração com o Grandstream GWN segue o mesmo padrão baseado em normas que a Purple utiliza com Cisco Meraki, HPE Aruba, Ruckus, Juniper Mist e Ubiquiti UniFi. --- Vamos detalhar a arquitetura técnica. O fluxo de WiFi para visitantes no Grandstream GWN com a Purple funciona da seguinte maneira. Um visitante se conecta ao seu SSID de visitantes. O dispositivo dele envia uma requisição HTTP para qualquer site. O access point GWN intercepta essa requisição e emite um redirecionamento HTTP 302 para a URL do portal Purple. O visitante chega à sua splash page personalizada, hospedada pela Purple. Ele se autentica, seja por e-mail, login social, verificação por SMS ou um formulário personalizado. A plataforma da Purple valida essa autenticação, registra o consentimento e os dados em conformidade com o GDPR e, em seguida, envia um RADIUS Access-Accept de volta ao access point GWN. O AP libera o acesso à internet. Todo esse fluxo leva de três a cinco segundos, desde a conexão até o acesso à internet. Agora, os principais componentes de configuração do lado da Grandstream são: a política de captive portal, as configurações da splash page, o walled garden e a associação do SSID. Vou orientar você em cada um deles. --- Passo um: configurar a política de captive portal no GWN Manager ou GWN dot Cloud. Navegue até Captive Portal, depois Policy List, e crie uma nova política. Dê a ela um nome descritivo, algo como "Purple-Guest-Portal". Defina o Authentication Type como RADIUS Server. Você verá os campos para RADIUS Server Address, RADIUS Server Port e RADIUS Server Secret. Insira o endereço IP do servidor RADIUS da Purple e a porta 1812 para autenticação. Seu segredo compartilhado (shared secret) é obtido no console de administração do portal Purple, na seção de configuração de hardware do local. Defina o RADIUS Authentication Method como PAP, que é o que o fluxo de captive portal da Purple utiliza. Em Landing Page, defina como Redirect to External Page e insira a URL de redirecionamento do portal Purple. Esta é a URL para a qual os visitantes serão direcionados quando se conectarem pela primeira vez. Novamente, ela é obtida no seu console de administração Purple. Defina o Expiration time para corresponder à política de sessão do seu local. Para um hotel, 24 horas é o mais comum. Para um centro de convenções, você pode definir para a duração do evento. Para um ambiente de varejo, de duas a quatro horas é o padrão. Habilite o Failsafe Mode. Isso é importante. Se o ponto de acesso GWN não conseguir alcançar o servidor RADIUS da Purple, o modo failsafe garante o acesso à internet de qualquer forma, em vez de bloquear todos os visitantes. Para a maioria das implantações de hotelaria e varejo, uma breve interrupção do RADIUS não deve fazer com que todos os visitantes percam a conectividade WiFi. --- Passo dois: configurar o walled garden. O walled garden é a lista de domínios e endereços IP que os visitantes podem acessar antes de se autenticarem pelo portal. Se você errar isso, os visitantes verão uma página em branco ou um portal quebrado, e culparão o WiFi. No GWN Manager, o walled garden é configurado sob a política de captive portal como Pre-Authentication Rules. Adicione os seguintes domínios como regras de permissão: o domínio do portal Purple, que é portal dot purple dot ai; quaisquer domínios de CDN dos quais a splash page da Purple carregue recursos, incluindo cloudfront dot net usando uma entrada curinga; o endpoint de detecção de captive portal da Apple, captive dot apple dot com; e o endpoint de verificação de conectividade do Google, connectivitycheck dot gstatic dot com. O portal de suporte da Purple possui um gerador de walled garden dinâmico em support dot purple dot ai. Selecione Grandstream na lista de hardware, escolha seus métodos de autenticação e ele gerará a lista exata de domínios que você precisa. Use essa lista. Não tente criá-la manualmente do zero.Uma decisão que você precisa tomar: você inclui captive dot apple dot com no walled garden ou não? Se você o incluir, os dispositivos iOS não exibirão o mini-navegador Captive Network Assistant automaticamente. Os visitantes precisarão abrir um navegador manualmente para acessar o portal. Se você o excluir, o iOS aciona o mini-navegador automaticamente quando o dispositivo se conecta. Para a maioria das implantações de hotelaria, você deseja que o mini-navegador apareça, portanto, deixe captive dot apple dot com fora do walled garden. --- Etapa três: configure o SSID. No GWN Manager, navegue até SSID e edite seu SSID de visitantes. Ative o Captive Portal e selecione a política que você acabou de criar. Defina o SSID como WPA2-Personal com uma senha aberta simples, ou configure-o como um SSID aberto se o seu estabelecimento preferir essa abordagem. A segurança neste fluxo vem da autenticação do portal, não da senha do WiFi. Ative o Client Isolation. Isso impede que os visitantes vejam os dispositivos uns dos outros na rede. É um requisito básico de segurança e uma consideração do PCI DSS se o seu estabelecimento processar pagamentos com cartão na mesma infraestrutura. Atribua o SSID à sua VLAN de visitantes. A VLAN 10 é uma convenção comum para o tráfego de visitantes. Certifique-se de que seu switch e roteador upstream estejam configurados para rotear essa VLAN para a internet com as regras de firewall apropriadas. --- Agora vamos falar sobre o WiFi da equipe usando 802.1X. O IEEE 802.1X é o padrão para controle de acesso à rede baseado em porta. Para o WiFi da equipe, ele substitui a chave pré-compartilhada por credenciais por usuário, validadas em um provedor de identidade. Quando um membro da equipe se conecta, o ponto de acesso GWN atua como o autenticador, seu dispositivo é o solicitante e o servidor RADIUS da Purple funciona como o servidor de autenticação. No GWN Manager, crie um SSID separado para a equipe. Defina o Modo de Segurança como WPA2-Enterprise, que ativa o 802.1X. Configure as definições do servidor RADIUS com o IP do RADIUS da Purple, porta 1812 e seu segredo compartilhado. Ative o RADIUS Accounting na porta 1813 para obter uma trilha de auditoria completa de quem se conectou, quando e por quanto tempo. Essa trilha de auditoria é o que você precisa para conformidade com a GDPR e para responder a quaisquer incidentes de segurança. Para o método EAP, você tem duas opções principais. O EAP-TLS usa certificados digitais tanto no servidor quanto no dispositivo do cliente. É a opção mais segura, mas requer uma plataforma de Gerenciamento de Dispositivos Móveis para enviar os certificados para os dispositivos da equipe. Se você possui o Microsoft Intune ou o Jamf, o EAP-TLS é a escolha certa. O PEAP, que significa Protected EAP, usa um nome de usuário e senha dentro de um túnel TLS criptografado. É mais fácil de implantar, principalmente para ambientes BYOD, mas você deve garantir que a equipe seja instruída a não aceitar avisos de certificado. Um ponto de acesso não autorizado pode coletar credenciais PEAP se os usuários clicarem e aceitarem erros de certificado. Habilite a atribuição de VLAN dinâmica nas configurações de SSID. Quando ativa, o servidor RADIUS pode retornar um ID de VLAN no pacote Access-Accept, e o AP GWN colocará o dispositivo conectado nessa VLAN. Isso significa que você pode ter um único SSID para a equipe, mas segmentar automaticamente a equipe de TI na VLAN 20, a gerência na VLAN 21 e os dispositivos de ponto de venda na VLAN 40, tudo com base na identidade do usuário no diretório da Purple. Os atributos RADIUS para VLAN dinâmica são: Tunnel-Type definido como VLAN, que é o valor de atributo 13; Tunnel-Medium-Type definido como IEEE-802, que é o valor de atributo 6; e Tunnel-Private-Group-ID definido como o número da VLAN como uma string. Esses três atributos no pacote Access-Accept são tudo o que o AP GWN precisa para direcionar o dispositivo para a VLAN correta. --- Agora, falemos do recurso que é particularmente relevante para propriedades multi-inquilino: as Chaves Privadas Pré-Compartilhadas Grandstream, ou PPSK. O PPSK é um mecanismo que permite que um único SSID ofereça suporte a várias senhas exclusivas, cada uma mapeada para uma VLAN ou política de rede diferente. Pense em um condomínio residencial de aluguel, um espaço de co-working ou um edifício de escritórios compartilhados. Você deseja um único SSID visível para todos, mas cada inquilino recebe sua própria senha que os coloca em seu próprio segmento de rede isolado. No GWN Manager, o PPSK é configurado nas definições de SSID. Defina o Modo de Segurança como WPA2-Personal e, em seguida, habilite o PPSK. Você poderá criar entradas PSK individuais, cada uma com uma senha exclusiva e um ID de VLAN associado. Quando um dispositivo se conecta usando a senha do Inquilino A, o AP o coloca na VLAN 31. Quando um dispositivo usa a senha do Inquilino B, ele vai para a VLAN 32. Os inquilinos compartilham o mesmo SSID, mas ficam completamente isolados uns dos outros na camada de rede. Para implantações maiores, a Grandstream também suporta PPSK com backend RADIUS. Nesse modo, o AP envia a PSK como um atributo RADIUS para o servidor de autenticação, que a valida e retorna a atribuição de VLAN apropriada. É aqui que o recurso Identity-Based Networks da Purple se integra diretamente. A Purple pode gerenciar o banco de dados PPSK, validar as chaves em seu diretório e retornar atribuições de VLAN dinâmicas, oferecendo a você o gerenciamento centralizado de centenas de credenciais de inquilinos a partir de uma única plataforma. O atributo RADIUS usado para validação de PPSK é normalmente o atributo Tunnel-Password, ou um atributo específico do fornecedor, dependendo da versão do firmware. Verifique as notas de versão da Grandstream para o seu firmware específico, pois o mapeamento de atributos evoluiu nas versões do GWN Manager. --- Deixe-me abordar os dois modos de falha mais comuns que vejo em implantações da Grandstream com portais externos. O primeiro é o redirecionamento que não funciona. Um visitante se conecta ao SSID, abre um navegador e recebe um erro de "site não pode ser acessado" em vez da página do portal. A causa mais provável é uma configuração incorreta do walled garden. A própria página do portal está sendo bloqueada antes da autenticação. Abra as ferramentas de desenvolvedor do seu navegador em um dispositivo de teste conectado ao SSID de visitantes, verifique a aba de rede e identifique quais solicitações estão falhando. Adicione esses domínios às suas regras de pré-autenticação. O segundo modo de falha é o timeout do RADIUS. O AP envia um Access-Request para o servidor RADIUS da Purple e não recebe resposta. Isso geralmente significa que um firewall está bloqueando a porta UDP 1812 de saída da VLAN de gerenciamento do AP para a faixa de IP do RADIUS da Purple. Verifique as regras do seu firewall. Os endereços de IP do RADIUS da Purple estão documentados no console de administração da Purple em configurações do local. Certifique-se de que os IPs do RADIUS primário e secundário estejam permitidos. Um terceiro que vale a pena mencionar: VLAN dinâmica não funcionando. A equipe se conecta e cai na VLAN errada. A causa mais comum é que a opção "Enable Dynamic VLAN" não está marcada nas configurações de SSID no GWN Manager. É uma caixa de seleção única que é fácil de esquecer. A segunda causa é uma divergência na chave secreta compartilhada (shared secret). Se a chave secreta compartilhada no AP não coincidir com a configurada na Purple, o AP descarta silenciosamente a resposta do RADIUS e reverte para a VLAN padrão. --- Deixe-me apresentar dois cenários do mundo real para tornar isso concreto. Cenário um: um hotel de 120 quartos. O hotel opera pontos de acesso GWN7660 gerenciados através do GWN dot Cloud. Eles precisam de um portal de visitantes personalizado para os hóspedes, uma rede segura para a equipe da recepção e governança, e uma VLAN de gerenciamento separada para o sistema de gerenciamento de propriedade. A configuração utiliza três SSIDs: Guest WiFi na VLAN 10 com a política de Captive Portal da Purple; Staff WiFi na VLAN 20 com WPA2-Enterprise e autenticação PEAP contra o RADIUS da Purple; e um SSID de gerenciamento oculto na VLAN 30 para terminais de PMS. A atribuição de VLAN dinâmica no SSID da equipe significa que os dispositivos da governança caem na VLAN 21 com acesso restrito à internet, enquanto os dispositivos da recepção caem na VLAN 20 com acesso total. O painel de análise da Purple mostra ao operador do hotel a contagem diária de visitantes, a duração das sessões e as taxas de opt-in para marketing, fornecendo à equipe de marketing os dados necessários para realizar campanhas direcionadas. Cenário dois: um bloco de apartamentos para locação de 40 unidades. O operador gerencia pontos de acesso GWN7630 com o GWN Manager local. Cada apartamento precisa de sua própria rede isolada. O operador utiliza PPSK com backend RADIUS. A Purple gerencia 40 credenciais exclusivas de inquilinos, cada uma mapeada para uma VLAN dedicada. Os residentes se conectam ao SSID único "BuildingConnect" usando a senha de sua unidade. O portal da Purple lida com o fluxo de integração inicial, captura o consentimento do residente e fornece ao operador análises de ocupação e dados de engajamento. Quando um residente se muda, o operador revoga sua credencial PPSK no console de administração da Purple, e o acesso é imediatamente encerrado. Não há necessidade de alterar a senha do SSID ou reconfigurar os APs. --- Perguntas rápidas. Três perguntas que recebo constantemente sobre implantações Grandstream. Pergunta um: Posso usar o GWN dot Cloud em vez do GWN Manager para a integração com a Purple? Sim. A configuração do Captive Portal no GWN dot Cloud é funcionalmente idêntica à do GWN Manager. Os caminhos do menu são os mesmos. As configurações de RADIUS e walled garden estão nos mesmos locais. O GWN dot Cloud é a melhor escolha para MSPs que gerenciam vários locais, pois você obtém um painel de controle único para todas as implantações. Pergunta dois: A Purple suporta as análises nativas da Grandstream junto com as suas próprias? A Purple substitui as análises nativas de Captive Portal por seu próprio conjunto de dados mais detalhado. Você obtém contagem de sessões, tempos de permanência, taxas de adesão, dados demográficos de campos de formulários e integração com plataformas de marketing. As análises nativas do GWN para desempenho de RF, integridade do AP e contagem de clientes permanecem disponíveis no GWN Manager ou GWN dot Cloud junto com as análises do portal da Purple. Pergunta três: Qual versão de firmware preciso nos APs GWN para PPSK com RADIUS? O PPSK com backend RADIUS requer o firmware GWN 1.0.19 ou superior na série GWN76xx. Verifique as notas de versão da Grandstream antes da implantação. Executar um firmware desatualizado é a causa mais comum de comportamento inesperado em implantações de PPSK. --- Para encerrar. Integrar os pontos de acesso Grandstream GWN com a Purple é uma implantação direta quando você segue a sequência correta. Configure as definições do seu servidor RADIUS na política do Captive Portal primeiro. Crie seu walled garden usando a ferramenta geradora de domínio da Purple. Associe a política ao seu SSID de convidados e habilite o isolamento de clientes. Para o WiFi de funcionários, habilite o WPA2-Enterprise com atribuição dinâmica de VLAN. Para propriedades de múltiplos inquilinos, use PPSK com backend RADIUS e gerencie as credenciais centralmente por meio da Purple. As cinco coisas que você deve acertar: RADIUS no UDP 1812 com uma chave secreta compartilhada correspondente; o walled garden cobrindo todos os domínios de ativos do portal; isolamento de clientes habilitado no SSID de convidados; VLAN dinâmica habilitada nas configurações do SSID; e firmware PPSK na versão 1.0.19 ou superior. Acerte esses cinco pontos e você terá uma implantação sólida e escalonável que atenderá ao seu estabelecimento por anos. A equipe de integração da Purple pode validar sua configuração antes do lançamento, e o uptime de 99,999% da plataforma significa que você não precisará explicar quedas no Captive Portal aos hóspedes do hotel às duas da manhã. Obrigado por nos ouvir. Para mais guias técnicos sobre integrações de WiFi corporativo, visite purple dot ai. No próximo episódio, abordaremos a atribuição dinâmica de VLAN com o Microsoft Entra ID e o recurso SecurePass da Purple. Até lá.