👥 Grupos Radius
Os Grupos Radius permitem criar perfis de acesso que definem regras e limites para usuários WiFi. Este artigo explica como criar grupos, configurar atributos e aplicar políticas de acesso.
⚠️ Acesso Restrito: Esta funcionalidade é exclusiva para administradores do sistema.
📋 O Que é um Grupo Radius?
Um grupo Radius é um perfil de acesso que define:
- Limites de tempo: Quanto tempo o usuário pode ficar conectado
- Limites de banda: Velocidade de download/upload
- Restrições de acesso: Horários permitidos, idle timeout
- Políticas de uso: Renovação automática, limites de tráfego
💡 Tabelas RADIUS: Grupos usam duas tabelas principais:
• radgroupcheck - Atributos de verificação (validação)
• radgroupreply - Atributos de resposta (aplicados ao usuário)
🔍 Check vs Reply: Qual a Diferença?
| Tipo | Quando é Usado | Exemplo |
|---|---|---|
| Check | Atributos que o RADIUS verifica antes de aceitar a conexão | Verificar se usuário tem saldo, se está no horário permitido |
| Reply | Atributos que o RADIUS envia de volta para o NAS aplicar | Limite de velocidade, tempo de sessão, idle timeout |
💡 Na prática:
• Check: "Posso conectar?" (validações)
• Reply: "Sim, com estas regras:" (limites aplicados)
➕ Como Criar um Grupo
- Acesse Admin → Radius → Grupos
- Clique no botão "+ Novo Grupo"
- Preencha o formulário:
| Campo | Descrição | Obrigatório |
|---|---|---|
| Nome do Grupo | Identificador único. Ex: plano-premium, visitantes-2h |
✅ Sim |
| Empresa | Organização proprietária do grupo (multi-tenant) | ✅ Sim |
| Descrição | Explicação do que o grupo faz (opcional) | Não |
📝 Atributos Reply Mais Usados
Estes atributos são aplicados ao usuário quando ele se conecta:
| Atributo | Descrição | Exemplo de Valor |
|---|---|---|
Session-Timeout |
Tempo máximo de sessão (segundos) | 3600 (1 hora)7200 (2 horas) |
Idle-Timeout |
Desconecta após inatividade (segundos) | 600 (10 min)1800 (30 min) |
Mikrotik-Rate-Limit |
Velocidade upload/download (Mikrotik) | 5M/10M (5Mbps up / 10Mbps down) |
WISPr-Bandwidth-Max-Down |
Download máximo (bps, padrão WISPr) | 10000000 (10 Mbps) |
WISPr-Bandwidth-Max-Up |
Upload máximo (bps, padrão WISPr) | 5000000 (5 Mbps) |
Acct-Interim-Interval |
Intervalo de atualização de accounting (segundos) | 300 (5 min) |
Framed-IP-Address |
IP fixo para o usuário | 10.0.0.100 |
Framed-Pool |
Pool de IPs (Mikrotik) | pool-premium |
⚙️ Operadores: Como Aplicar Atributos
| Operador | Significado | Quando Usar |
|---|---|---|
:= |
Define sempre (override) | ✅ Mais usado - força o valor |
= |
Define se não existir | Para valores padrão (pode ser sobrescrito) |
== |
Comparação exata (check) | Para validar valores |
+= |
Adiciona à lista | Para múltiplos valores do mesmo atributo |
!= |
Diferente de | Para rejeitar valores específicos |
🎨 Usar Templates (Pré-configurados)
O sistema oferece templates prontos para facilitar a criação de grupos:
- Ao criar um grupo, clique em "Usar Template"
- Selecione um dos templates disponíveis:
- Plano Básico: 2Mbps, 2 horas de sessão
- Plano Premium: 10Mbps, 8 horas de sessão
- Visitante Curto: 1Mbps, 30 minutos
- Visitante Longo: 5Mbps, 24 horas
- Os atributos serão preenchidos automaticamente
- Ajuste conforme necessário
💡 Dica: Templates economizam tempo e garantem configurações testadas. Você pode criar seus próprios templates em Admin → Radius → Templates.
➕ Adicionar Atributos ao Grupo
Após criar o grupo, adicione atributos:
Adicionar Atributo Reply (Aplicado ao Usuário)
- Na lista de grupos, clique em "Gerenciar" (ícone de engrenagem)
- Na seção "Atributos Reply", clique em "+ Adicionar Reply"
- Preencha:
- Atributo: Selecione da lista ou digite (ex:
Session-Timeout) - Operador: Normalmente
:= - Valor: O valor do atributo (ex:
3600para 1 hora)
- Atributo: Selecione da lista ou digite (ex:
- Clique em "Salvar"
Adicionar Atributo Check (Validação)
- Na seção "Atributos Check", clique em "+ Adicionar Check"
- Preencha os campos (similar ao Reply)
- Clique em "Salvar"
👤 Associar Usuários ao Grupo
Há duas formas de associar usuários:
Opção 1: A partir da tela de Usuários
- Acesse Admin → Radius → Usuários
- Clique no botão "Adicionar ao Grupo" (ícone de pessoas) ao lado do usuário
- Selecione o grupo e defina prioridade
- Clique em "Adicionar"
Opção 2: A partir da tela de Grupos
- Na lista de grupos, clique em "Gerenciar"
- Na seção "Usuários deste Grupo", clique em "+ Adicionar Usuário"
- Selecione o usuário e defina prioridade
- Clique em "Salvar"
💡 Prioridade: Se um usuário estiver em múltiplos grupos, o RADIUS usa o grupo com menor número de prioridade primeiro. Exemplo: prioridade 1 tem precedência sobre prioridade 10.
✏️ Editar Grupo
- Clique no ícone de editar (lápis) ao lado do grupo
- Modifique nome ou descrição
- Clique em "Salvar"
⚠️ Atenção: O nome do grupo não pode ser alterado após criação se já houver usuários associados. Delete e recrie se necessário.
🗑️ Deletar Grupo
- Clique no ícone de deletar (lixeira) ao lado do grupo
- Confirme a exclusão
⚠️ Cuidado: Deletar um grupo não deleta os usuários, mas remove todas as associações e atributos configurados.
❓ Casos de Uso Práticos
Caso 1: WiFi de Restaurante - Visitantes
Cenário: Clientes que consomem no local ganham WiFi por 2 horas
Configuração do Grupo:
- Nome:
visitantes-restaurante - Atributos Reply:
Session-Timeout := 7200(2 horas)Idle-Timeout := 1800(30 min de inatividade)Mikrotik-Rate-Limit := 3M/5M(3Mbps up / 5Mbps down)
Caso 2: WiFi Corporativo - Funcionários Premium
Cenário: Gerentes com acesso ilimitado e prioridade
Configuração do Grupo:
- Nome:
gerencia-premium - Atributos Reply:
Mikrotik-Rate-Limit := 50M/100M(50Mbps up / 100Mbps down)Acct-Interim-Interval := 300(atualização a cada 5 min)
- Sem Session-Timeout (conexão ilimitada)
Caso 3: Hotel - Hóspedes com Limite Diário
Cenário: Cada quarto tem acesso por 24h renovável
Configuração do Grupo:
- Nome:
hospedes-24h - Atributos Reply:
Session-Timeout := 86400(24 horas)Idle-Timeout := 3600(1 hora de inatividade)Mikrotik-Rate-Limit := 10M/20M
🔧 Troubleshooting
Atributos não estão sendo aplicados
Verificar:
- Usuário está corretamente associado ao grupo
- Operador está correto (usar
:=para forçar) - Valor do atributo está no formato correto
- NAS suporta o atributo (ex: Mikrotik-Rate-Limit só funciona em Mikrotik)
- Servidor Radius foi reiniciado após mudanças críticas
Velocidade não está sendo limitada
Soluções:
- Mikrotik: Use
Mikrotik-Rate-Limitno formatoXM/YM - Outros NAS: Use
WISPr-Bandwidth-Max-UpeWISPr-Bandwidth-Max-Downem bits por segundo - Exemplo: 10Mbps = 10.000.000 bps
Sessão expira muito rápido
Verificar:
- Valor de
Session-Timeoutestá em segundos, não minutos - Não confundir com
Idle-Timeout(inatividade) - Exemplo: 1 hora = 3600 segundos
Grupo não aparece para seleção
Verificar:
- Grupo pertence à mesma Empresa do usuário
- Sistema é multi-tenant: grupos só aparecem para usuários da mesma empresa
📖 Próximos Passos
- Usuários Radius - Criar e associar usuários
- NAS - Cadastrar equipamentos
- Templates Mikrotik - Criar templates customizados
- Monitoramento - Ver sessões ativas
📞 Precisa de Ajuda?
Entre em contato com o suporte através do menu Suporte