Guia de Integração do Captive Portal do MikroTik RouterOS com o Purple WiFi
Este guia técnico fornece instruções passo a passo para integrar o MikroTik RouterOS com a plataforma WiFi da Purple. Abrange a configuração do captive portal de Guest WiFi, a autenticação 802.1X de Staff WiFi e WiFi Multi-Tenant utilizando PSKs Privados para segmentação dinâmica de VLAN.
Ouça este guia
Ver transcrição do podcast
- Resumo Executivo
- Análise Técnica Detalhada
- Guest WiFi: Captive Portal e Walled Garden
- Staff WiFi: Autenticação 802.1X
- WiFi Multi-Tenant: Private PSK (PPSK)
- Guia de Implementação
- 1. Configurar o Cliente RADIUS
- 2. Configuração do Hotspot de Guest WiFi
- 3. Configuração de Staff WiFi 802.1X
- 4. Configuração de PPSK Multi-Tenant
- Boas Práticas
- Resolução de Problemas e Mitigação de Riscos
- ROI e Impacto no Negócio

Resumo Executivo
A integração do MikroTik RouterOS com a Purple cria uma rede unificada e baseada em identidade em ambientes de convidados, funcionários e multi-tenant. Este guia fornece a lógica de configuração específica necessária para implementar a sobreposição de nuvem da Purple no hardware MikroTik. Aprenderá a configurar o Hotspot Gateway do RouterOS para redirecionamento de Guest WiFi , a implementar o IEEE 802.1X para Staff WiFi seguro e a implementar Private Pre-Shared Keys (PPSK) para isolar o tráfego de WiFi Multi-Tenant.
Ao seguir estes modelos de implementação, segmenta a sua rede de forma segura enquanto recolhe dados primários (first-party data) para WiFi Analytics . A Purple processou 440 milhões de inícios de sessão em 2024 com 99,999% de tempo de atividade, tornando esta arquitetura adequada para ambientes de alta densidade no Retalho , Hotelaria e Transportes .
Análise Técnica Detalhada
Guest WiFi: Captive Portal e Walled Garden
O Hotspot Gateway do MikroTik intercepta o tráfego HTTP não autenticado e redireciona-o para o captive portal alojado da Purple. A Purple atua como o servidor RADIUS, tratando da autenticação e da gestão de sessões.
Para garantir que o captive portal carrega corretamente, deve configurar um walled garden. Isto permite o acesso pré-autenticação aos domínios da splash page da Purple, Content Delivery Networks (CDNs) e fornecedores de OAuth (como o Google Workspace e o Microsoft Entra ID). Sem estas entradas, o ciclo de redirecionamento quebra-se.
Após uma autenticação bem-sucedida, o servidor RADIUS da Purple retorna atributos padrão, incluindo Session-Timeout para impor limites de ligação, e opcionalmente Mikrotik-Rate-Limit para impor restrições de largura de banda diretamente a partir do painel da Purple.
Staff WiFi: Autenticação 802.1X
Para Staff WiFi, elimina as palavras-passe partilhadas ao implementar o IEEE 802.1X. O ponto de acesso MikroTik atua como o autenticador, passando as credenciais EAP para o servidor RADIUS da Purple. A Purple integra-se nativamente com o Microsoft Entra ID, Okta e Google Workspace, validando credenciais via PEAP-MSCHAPv2 ou EAP-TLS.
Quando um funcionário se liga, o servidor RADIUS da Purple pode retornar o atributo Mikrotik-Wireless-VLANID. Isto instrui o router MikroTik a colocar o dispositivo autenticado numa VLAN específica, permitindo a segmentação de rede baseada em funções a partir de um único SSID. Para uma visão geral mais ampla dos padrões de segurança, consulte Enterprise WiFi Security: A Complete Guide for 2026 .
WiFi Multi-Tenant: Private PSK (PPSK)
Os ambientes Multi-Tenant requerem um isolamento seguro sem a complexidade do 802.1X, uma vez que muitos dispositivos de consumo (como smart TVs e consolas de jogos) não o suportam. O MikroTik suporta Private PSK (PPSK) através de autenticação RADIUS baseada em MAC.
Quando um dispositivo se liga ao SSID, o router MikroTik envia o endereço MAC do dispositivo para a Purple. A Purple retorna o atributo Mikrotik-Wireless-Psk (a palavra-passe exclusiva para esse inquilino) e o atributo Mikrotik-Wireless-VLANID. Esta arquitetura permite que centenas de inquilinos partilhem um único SSID enquanto permanecem em bolhas de rede completamente isoladas.

Guia de Implementação
1. Configurar o Cliente RADIUS
Primeiro, defina a Purple como o servidor RADIUS no RouterOS. Isto aplica-se aos três casos de utilização.
/radius
add address=YOUR-PURPLE-RADIUS-IP secret=YOUR-SHARED-SECRET service=hotspot,wireless authentication-port=1812 accounting-port=1813 timeout=3000ms
2. Configuração do Hotspot de Guest WiFi
Execute o assistente de configuração do Hotspot na sua interface VLAN de convidados e, em seguida, ative a autenticação RADIUS no perfil resultante.
/ip hotspot profile
set [ find default=yes ] use-radius=yes radius-accounting=yes
Configure the walled garden to allow access to Purple's infrastructure.
/ip hotspot walled-garden
add action=allow dst-host=*purple.ai
add action=allow dst-host=*purpleportal.net
3. Configuração de Staff WiFi 802.1X
Configure o perfil de segurança sem fios para utilizar WPA2-Enterprise e aponte-o para o servidor RADIUS.
/interface wireless security-profiles
add authentication-types=wpa2-eap eap-methods=passthrough mode=dynamic-keys name=staff-8021x radius-mac-authentication=no
Certifique-se de que a filtragem de VLAN da bridge está ativada para suportar a atribuição dinâmica de VLAN.
/interface bridge
set bridge1 vlan-filtering=yes
4. Configuração de PPSK Multi-Tenant
Para PPSK, ative a autenticação MAC no perfil de segurança sem fios e configure o formato do endereço MAC.
/interface wireless security-profiles
add authentication-types=wpa2-psk mode=dynamic-keys name=multi-tenant-ppsk radius-mac-authentication=yes radius-mac-format=XX:XX:XX:XX:XX:XX

Boas Práticas
- Padronize no RouterOS 7: A atribuição dinâmica de VLAN via RADIUS sem fios é significativamente mais robusta no RouterOS 7 em comparação com o RouterOS 6.
- Aumente os Timeouts do RADIUS: O limite de tempo (timeout) predefinido do RADIUS no MikroTik é de 1100ms. Aumente-o para 3000ms para evitar falhas de autenticação intermitentes causadas pela latência da rede.
- Utilize Entradas de Walled Garden com Nomes de Anfitrião: Utilize sempre
dst-hostem vez dedst-addresspara as entradas de walled garden, uma vez que os endereços IP da infraestrutura de nuvem alterge frequentemente. - Ativar a Filtragem de VLAN na Bridge: A atribuição dinâmica de VLAN via RADIUS (
Mikrotik-Wireless-VLANID) requervlan-filtering=yesna interface bridge.
Resolução de Problemas e Mitigação de Riscos
Se o Captive Portal não carregar, o walled garden está quase certamente incompleto. Utilize a ferramenta MikroTik Torch para monitorizar consultas DNS rejeitadas de clientes não autenticados na VLAN de convidados. Adicione os domínios em falta ao walled garden.
Se os clientes 802.1X não se conseguirem autenticar, verifique o segredo partilhado e certifique-se de que o cliente RADIUS está configurado com service=wireless. Verifique os registos do painel de controlo da Purple para confirmar se o Access-Reject tem origem na Purple ou no seu fornecedor de identidade.
Se os clientes se autenticarem mas receberem o endereço IP incorreto, confirme se a filtragem de VLAN na bridge está ativada e se o servidor DHCP está corretamente associado à interface VLAN atribuída dinamicamente.
ROI e Impacto no Negócio
A implementação da Purple na sua infraestrutura MikroTik transforma um centro de custos num gerador de receitas. Ao capturar dados primários (first-party data), os espaços podem criar perfis digitais detalhados e automatizar campanhas de marketing. Por exemplo, a Avanti West Coast obteve um retorno do investimento de 463% ao capitalizar em viajantes frequentes e oportunidades de upsell.
Além disso, a rede baseada em identidade reduz os custos operacionais de TI. A automatização do onboarding e offboarding para o Staff WiFi através do Entra ID elimina a gestão manual de palavras-passe, enquanto o PPSK para Multi-Tenant WiFi permite que os gestores de propriedades aprovisionem redes isoladas sem implementar hardware dedicado por unidade.
Definições Principais
Hotspot Gateway
Uma funcionalidade do RouterOS que intercepta o tráfego HTTP não autenticado e o redireciona para uma página de entrada (splash page) do captive portal.
Utilizado para recolher dados de convidados e impor termos de serviço antes de conceder acesso à internet.
Walled Garden
Uma lista de destinos permitidos aos quais os utilizadores não autenticados podem aceder.
Crítico para permitir que os convidados acedam à splash page da Purple, CDNs e fornecedores de OAuth (como o Google) para concluir o processo de início de sessão.
802.1X
Um padrão IEEE para controlo de acesso à rede baseado em portas que fornece um mecanismo de autenticação para dispositivos que desejam ligar-se a uma LAN ou WLAN.
Utilizado para Staff WiFi seguro, permitindo a autenticação através do Entra ID ou Okta em vez de uma palavra-passe partilhada.
Private PSK (PPSK)
Uma arquitetura de segurança onde múltiplas chaves pré-partilhadas (Pre-Shared Keys) exclusivas são utilizadas num único SSID, frequentemente associadas a endereços MAC e VLANs específicos.
Ideal para WiFi Multi-Tenant, fornecendo bolhas de rede isoladas para os residentes e os seus dispositivos de consumo.
RADIUS
Remote Authentication Dial-In User Service. Um protocolo de rede que fornece gestão centralizada de Autenticação, Autorização e Contabilidade (AAA).
O protocolo principal que liga o hardware MikroTik à plataforma de nuvem da Purple para validação de identidade.
VLAN Filtering
Uma definição de bridge do RouterOS que impõe regras de marcação (tagging) e desmarcação (untagging) de VLAN nas portas da bridge.
Deve estar ativado para que a atribuição dinâmica de VLAN via RADIUS funcione corretamente.
CAPsMAN
Controlled Access Point system Manager. O sistema de gestão sem fios centralizado da MikroTik.
Utilizado para implementar perfis de segurança sem fios e definições RADIUS consistentes em múltiplos pontos de acesso.
EAP-TLS
Extensible Authentication Protocol - Transport Layer Security. Um método de autenticação altamente seguro que requer certificados do lado do cliente.
Suportado pela Purple para implementações de Staff WiFi zero-trust onde é necessária autenticação sem palavra-passe.
Exemplos Práticos
Um hotel de 200 quartos necessita de implementar Staff WiFi seguro nos seus pontos de acesso MikroTik. Pretendem que a equipa financeira fique na VLAN 10 e a equipa de operações na VLAN 20, utilizando as suas credenciais existentes do Microsoft Entra ID.
- Integre a Purple com o Microsoft Entra ID no painel da Purple.
- Configure o cliente RADIUS do MikroTik para apontar para a Purple com
service=wireless. - Crie um perfil de segurança sem fios MikroTik com
authentication-types=wpa2-eap. - Ative
vlan-filtering=yesna bridge do MikroTik. - Na Purple, mapeie o grupo 'Finance' do Entra ID para retornar
Mikrotik-Wireless-VLANID=10e o grupo 'Operations' para retornarMikrotik-Wireless-VLANID=20.
Um gestor de propriedades de arrendamento de longa duração (build-to-rent) necessita de fornecer redes WiFi isoladas para 50 apartamentos utilizando uma única transmissão de SSID a partir do MikroTik CAPsMAN.
- Configure o perfil de segurança sem fios do MikroTik para o SSID com
authentication-types=wpa2-pskeradius-mac-authentication=yes. - Certifique-se de que o cliente RADIUS está configurado com
service=wirelessa apontar para a Purple. - No painel da Purple, registe os endereços MAC dos dispositivos dos residentes.
- Atribua uma PSK e um ID de VLAN exclusivos a cada apartamento na Purple.
- Quando um dispositivo se liga, a Purple retorna os atributos
Mikrotik-Wireless-PskeMikrotik-Wireless-VLANID, colocando o dispositivo na sua bolha de rede isolada.
Perguntas de Prática
Q1. Configurou o Hotspot Gateway do MikroTik e apontou-o para o servidor RADIUS da Purple. Os convidados ligam-se ao SSID, mas os seus navegadores apresentam um erro de limite de tempo (timeout) em vez da splash page da Purple. Qual é o erro de configuração mais provável?
Dica: Considere o que deve acontecer antes de o convidado se autenticar.
Ver resposta modelo
O walled garden está mal configurado ou faltam entradas. Sem permitir o acesso aos domínios da splash page da Purple e CDNs associadas em /ip hotspot walled-garden, o convidado não autenticado não consegue carregar a página de login, resultando num timeout.
Q2. Uma cadeia de retalho pretende implementar Staff WiFi utilizando 802.1X e Entra ID. Configuram `authentication-types=wpa2-eap` e definem o cliente RADIUS. No entanto, a autenticação falha. Verifica a configuração do cliente RADIUS e vê `service=hotspot`. Como resolve isto?
Dica: Diferentes métodos de autenticação sem fios requerem diferentes tipos de serviço RADIUS no RouterOS.
Ver resposta modelo
Altere a configuração do cliente RADIUS para incluir service=wireless. O tipo de serviço hotspot é apenas utilizado para autenticação de captive portal. A autenticação 802.1X e MAC requerem o tipo de serviço wireless.
Q3. Está a implementar WiFi Multi-Tenant utilizando PSKs Privados. A Purple retorna com sucesso os atributos `Mikrotik-Wireless-Psk` e `Mikrotik-Wireless-VLANID`, e o dispositivo liga-se. No entanto, o dispositivo recebe um endereço IP da sub-rede de gestão predefinida, e não da sub-rede isolada do inquilino. Que definição do RouterOS está em falta?
Dica: A atribuição dinâmica de VLAN requer que a bridge processe etiquetas (tags) de VLAN.
Ver resposta modelo
A filtragem de VLAN da bridge está desativada. Deve definir vlan-filtering=yes na interface bridge. Sem isto, a bridge ignora a etiqueta dinâmica de VLAN atribuída pelo RADIUS, e o tráfego reverte para o PVID predefinido sem etiqueta (untagged).
Continue a ler esta série
Integração do CommScope Ruckus com o Purple WiFi: Guia de Instalação e Configuração
Este guia de referência técnica fornece um manual de configuração autoritativo para integrar arquiteturas CommScope Ruckus com o Purple WiFi. Detalha implementações passo a passo para Captive Portals de Guest WiFi, WiFi seguro para funcionários via 802.1X e isolamento de rede multi-tenant utilizando Ruckus Dynamic PSK.
Integração de Pontos de Acesso Grandstream GWN com o Purple WiFi
Este guia de referência técnica detalha como integrar os pontos de acesso Grandstream GWN com a plataforma de Guest WiFi e analítica da Purple. Abrange a configuração do Captive Portal da Grandstream, definições de RADIUS AAA, configuração de walled garden, autenticação segura de funcionários 802.1X com direcionamento dinâmico de VLAN e segmentação PPSK multi-tenant — fornecendo orientações práticas e passo a passo para MSPs e equipas de TI que implementam WiFi para convidados e funcionários em grande escala.
Integração do Huawei AirEngine e CloudCampus com o Purple WiFi
Este guia fornece instruções passo a passo para integrar os pontos de acesso Huawei AirEngine e o iMaster NCE-Campus com o Purple WiFi. Abrange a configuração do Captive Portal, a autenticação de funcionários por 802.1X e o direcionamento dinâmico de VLAN por PPSK para redes empresariais.