Laboratório: Portal Cativo com Consentimento LGPD usando openNDS e FreeRADIUS

Roteiro para estudo em ambiente de laboratório ou de teste. Execute apenas em equipamentos, redes e contas que você tenha autorização para usar, com backup e homologação próprios. Comandos podem causar indisponibilidade ou perda de dados. Software e marcas citados pertencem aos seus titulares. Termos de Uso.

Duração estimada

120 min

Passos

12

Validações

5

Versões da documentação consultada

OpenWrt 22.03 · openNDS a versão estável atual · FreeRADIUS 3.x estável

Topologia

Uma VM (ou PC) atua como roteador Wi-Fi com OpenWrt, rodando openNDS e FreeRADIUS. Clientes Wi-Fi conectam-se a essa rede e, ao tentar acessar a internet, são redirecionados ao portal cativo. Após consentimento e autenticação, o acesso é liberado. Endereços de exemplo: roteador 192.168.100.1/24, clientes 192.168.100.10-50.

Internet
   |
[VM Host]
   |
[OpenWrt VM: openNDS + FreeRADIUS]
   |
Wi-Fi (SSID: PortalLGPD)
   |
[Clientes Wi-Fi]

Equipamentos e software

Roteiro

1. Preparar a VM OpenWrt

   Instale OpenWrt em uma VM com duas interfaces de rede. Uma será LAN (192.168.100.1/24), outra WAN (acesso à internet). Isso simula um roteador Wi-Fi real.

   Consulte https://openwrt.org/docs/guide-user/virtualization/qemuCopiar

   O que você deve ver: A VM OpenWrt inicializa, acessível via SSH na LAN.

2. Configurar rede LAN e Wi-Fi

   Configure a interface LAN para 192.168.100.1/24 e crie um SSID 'PortalLGPD' aberto (sem senha).

   uci set network.lan.ipaddr='192.168.100.1'
   uci commit network
   uci set wireless.@wifi-iface[0].ssid='PortalLGPD'
   uci set wireless.@wifi-iface[0].encryption='none'
   uci commit wireless
   /etc/init.d/network restartCopiar

   O que você deve ver: SSID 'PortalLGPD' visível e conectável.

3. Instalar openNDS e dependências

   openNDS faz o redirecionamento para o portal cativo. Instale-o pelo opkg.

   opkg update
   opkg install openndsCopiar

   O que você deve ver: openNDS instalado sem erros.

4. Instalar FreeRADIUS

   FreeRADIUS será o backend de autenticação. Instale-o pelo opkg.

   opkg install freeradius3 freeradius3-mod-eap freeradius3-mod-filesCopiar

   O que você deve ver: FreeRADIUS instalado e rodando.

5. Configurar FreeRADIUS: criar usuário de teste

   Crie um usuário de teste para autenticação. Edite o arquivo users.

   echo 'usuario1 Cleartext-Password := "senha123"' >> /etc/freeradius3/mods-config/files/authorize
   /etc/init.d/freeradius3 restartCopiar

   O que você deve ver: FreeRADIUS reinicia sem erros.

6. Configurar openNDS para usar FreeRADIUS

   Edite o arquivo de configuração do openNDS para usar autenticação RADIUS.

   vi /etc/opennds/nds.conf
   # Configure AuthServer, AuthPort, AuthSecret conforme documentaçãoCopiar

   O que você deve ver: openNDS reconhece o backend RADIUS.

7. Customizar portal cativo: consentimento LGPD

   Edite a página de login do openNDS para exibir e exigir aceite do termo LGPD. O arquivo está em /etc/opennds/htdocs/splash.html.

   vi /etc/opennds/htdocs/splash.html
   # Inclua um checkbox obrigatório para consentimento e link para política de privacidade.Copiar

   O que você deve ver: Página de login exibe termo LGPD e checkbox obrigatório.

8. Configurar logs de acesso (Marco Civil)

   Garanta que openNDS registre MAC, IP, horário e usuário autenticado. Verifique a configuração de logs em /etc/opennds/nds.conf.

   grep Log /etc/opennds/nds.conf
   # Consulte a documentação para detalhes de retenção.Copiar

   O que você deve ver: Logs são gerados em /var/log/opennds.log ou caminho configurado.

9. Reiniciar serviços

   Reinicie openNDS e FreeRADIUS para aplicar todas as configurações.

   /etc/init.d/opennds restart
   /etc/init.d/freeradius3 restartCopiar

   O que você deve ver: Ambos os serviços sobem sem erros.

10. Conectar cliente Wi-Fi

    Conecte um notebook ou smartphone ao SSID 'PortalLGPD'.

    O que você deve ver: Cliente recebe IP na faixa 192.168.100.x e é redirecionado ao portal cativo ao tentar navegar.

11. Testar fluxo de autenticação e consentimento

    No portal, preencha usuário, senha e aceite o termo LGPD. Submeta.

    O que você deve ver: Após autenticação, acesso liberado à internet.

12. Verificar logs de autenticação e consentimento

    Cheque os logs para garantir que o acesso foi registrado, incluindo consentimento.

    cat /var/log/opennds.log | tailCopiar

    O que você deve ver: Registro do usuário, IP, MAC, horário e aceite do termo.

Como saber que funcionou

Troubleshooting

Segurança e hardening

• Altere o segredo compartilhado (AuthSecret) do RADIUS para um valor forte e único
• Restrinja acesso SSH e web ao OpenWrt apenas à rede administrativa
• Garanta que logs de acesso estejam protegidos contra acesso não autorizado
• Implemente HTTPS no portal cativo para proteger credenciais e consentimento
• Revise permissões dos arquivos de configuração e logs

Checklist final

• OpenWrt instalado e acessível
• SSID 'PortalLGPD' visível
• openNDS e FreeRADIUS instalados e rodando
• Usuário de teste criado no FreeRADIUS
• Portal cativo exibe termo LGPD e exige aceite
• Autenticação libera acesso à internet
• Logs registram autenticação e consentimento