Integração Hubsoft com Mikrotik

Sobre a Mikrotik

A MikroTik fabrica hardware e software de rede usados em quase todos os países. Os roteadores rodam o sistema RouterOS e são administrados pelo Winbox, uma ferramenta gráfica de gerenciamento. A empresa tem como missão tornar as tecnologias de internet mais rápidas, potentes e acessíveis.

O que a integração faz

Cadastrado como equipamento de conexão, o Mikrotik passa a usar o RADIUS do Hubsoft:

• O RADIUS autentica as conexões PPPoE dos assinantes e recebe o accounting a cada 10 minutos.
• Rádios Mikrotik autenticam clientes wireless por MAC, com a interface wireless (SSID, MAC e WPA) cadastrada no Hubsoft.
• O Hubsoft desconecta assinantes pela porta de incoming do RADIUS.
• A equipe vê os clientes conectados, o uso de banda em tempo real e gráficos históricos por dia, semana e mês.
• Assinantes suspensos ou cancelados conectam num pool de IP separado, em IPv4 e IPv6, que o provedor bloqueia no firewall.
• O extrato de conexão registra o prefixo IPv6 entregue a cada assinante. O RouterOS não envia esse dado ao RADIUS; um script no perfil PPP avisa a API do Hubsoft a cada conexão.
• Os operadores entram no Mikrotik com o usuário do Hubsoft, via RADIUS, no grupo de permissão definido no cadastro de cada um.
• As regras de CGNAT determinístico do Mikrotik, inclusive Netmap, ficam documentadas em Rede > Mapeamento CGNat.

O que você precisa

• Um usuário SSH no Mikrotik para o Hubsoft.
• O POP do concentrador cadastrado em Rede > Pontos de Presença.
• O mesmo secret do RADIUS no Mikrotik e no Hubsoft.
• Para o IPv6 no extrato: a URL da API e o token da sua instância, fornecidos pela equipe de atendimento da Hubsoft.

Como ativar

1. No Hubsoft, em Rede > Equipamentos de Conexão, adicione o Mikrotik com nome, IP, fabricante, modelo e POP. Ative o RADIUS, informe o secret e a porta incoming, escolha o tipo de NAS e preencha o usuário, a senha e a porta SSH.
2. Na aba Interfaces do mesmo cadastro, adicione a interface do concentrador, em geral VLAN ou Ethernet.
3. No Winbox, em RADIUS, adicione o servidor com o serviço ppp, o IP do RADIUS, o mesmo secret e o IP do concentrador em Src. Address.
4. Ainda em RADIUS, em Incoming, marque Accept e informe a mesma porta cadastrada no Hubsoft, normalmente 3799.
5. Em PPP > Secrets > PPP Authentication & Accounting, marque Use Radius e ajuste o Interim Update para 00:10:00.
6. Em System > Users, remova os usuários que não são mais necessários, como os do sistema anterior.

O passo a passo com as telas está na wiki da Hubsoft: configuração do Mikrotik, rádio Mikrotik, IPv6 no extrato de conexão e problemas de autenticação.

Limitações

• O prefixo IPv6 não aparece na hora no extrato: o Hubsoft guarda os dados numa fila e sincroniza a cada 1 minuto.
• Depois de incluir o script de IPv6 nos perfis PPP, as sessões PPPoE ativas precisam reconectar. A Hubsoft recomenda fazer isso fora do horário comercial.
• No rádio, o cliente só autentica se a autenticação wireless estiver marcada na configuração de RADIUS do Mikrotik.

Perguntas frequentes

O assinante não autentica. O que conferir primeiro?

Teste o ping até o RADIUS. Bad Replies subindo indica secret diferente do Hubsoft; Timeouts subindo, problema de rede ou timeout baixo. No log de autenticação do Hubsoft, confira se o serviço está habilitado e se MAC e senha estão certos. NAT entre o concentrador e o RADIUS também bloqueia a autenticação.

O Mikrotik envia o IPv6 do assinante para o Hubsoft?

Não sozinho. O RouterOS não manda o prefixo delegado ao RADIUS. O script da wiki, no parâmetro on-up dos perfis PPP, envia o prefixo à API do Hubsoft a cada conexão.

Os técnicos podem entrar no Mikrotik com o usuário do Hubsoft?

Sim. Em Configuração > Geral > Usuários, marque "Possui acesso via Radius" e adicione o parâmetro Mikrotik-Group com o grupo de permissão. No Mikrotik, habilite o login via RADIUS.

Revisado em 10/10/2026.