Grupos Radius

Guia completo sobre Grupos Radius: criar perfis de acesso, configurar atributos Check e Reply, limites de velocidade e tempo, templates e troubleshooting.

23/12/2025 0 visualizacoes Destacado

👥 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

  1. Acesse Admin → Radius → Grupos
  2. Clique no botão "+ Novo Grupo"
  3. 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:

  1. Ao criar um grupo, clique em "Usar Template"
  2. 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
  3. Os atributos serão preenchidos automaticamente
  4. 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)

  1. Na lista de grupos, clique em "Gerenciar" (ícone de engrenagem)
  2. Na seção "Atributos Reply", clique em "+ Adicionar Reply"
  3. Preencha:
    • Atributo: Selecione da lista ou digite (ex: Session-Timeout)
    • Operador: Normalmente :=
    • Valor: O valor do atributo (ex: 3600 para 1 hora)
  4. Clique em "Salvar"

Adicionar Atributo Check (Validação)

  1. Na seção "Atributos Check", clique em "+ Adicionar Check"
  2. Preencha os campos (similar ao Reply)
  3. 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

  1. Acesse Admin → Radius → Usuários
  2. Clique no botão "Adicionar ao Grupo" (ícone de pessoas) ao lado do usuário
  3. Selecione o grupo e defina prioridade
  4. Clique em "Adicionar"

Opção 2: A partir da tela de Grupos

  1. Na lista de grupos, clique em "Gerenciar"
  2. Na seção "Usuários deste Grupo", clique em "+ Adicionar Usuário"
  3. Selecione o usuário e defina prioridade
  4. 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

  1. Clique no ícone de editar (lápis) ao lado do grupo
  2. Modifique nome ou descrição
  3. 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

  1. Clique no ícone de deletar (lixeira) ao lado do grupo
  2. 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-Limit no formato XM/YM
  • Outros NAS: Use WISPr-Bandwidth-Max-Up e WISPr-Bandwidth-Max-Down em bits por segundo
  • Exemplo: 10Mbps = 10.000.000 bps

Sessão expira muito rápido

Verificar:

  • Valor de Session-Timeout está 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

📞 Precisa de Ajuda?

Entre em contato com o suporte através do menu Suporte

Ultima atualizacao: 23/12/2025

WiFi Liberado - Central de Ajuda