Ir para o conteúdo

Roteiro: Criar usuários admin/viewer no painel administrativo

Perfil necessário: admin Menus usados: Administração (menu do usuário, canto superior direito) Risco: médio (conta errada como admin concede controle total do softswitch; viewer apenas consulta) Rollback: editar o usuário e ajustar Perfil/Status, ou excluir o usuário pela ação da tabela

Pré-requisitos

  • [ ] Login como usuário com perfil admin (a rota /users é exclusiva de admin)
  • [ ] Senha inicial de no mínimo 8 caracteres definida para o novo usuário

O que admin e viewer veem

As rotas com requiresAdmin são bloqueadas para viewer (redirecionamento para o Dashboard e item oculto na navegação):

Seção Página Viewer vê?
Administração Usuários (/users) Não
Sistema SIP Profiles (/system/sip-profiles) Não
Sistema Domínios SIP (/system/sip-domains) Não
Sistema Backups (/system/backups) Não
Sistema MCP (/system/mcp) Não
Roteamento Avançado → Usuários SIP (/advanced/subscribers) Não

Todo o restante (Operação, Comercial, Roteamento, Políticas, Infraestrutura, Rede/Firewall, Minha Conta) é visível para viewer em modo leitura: ações de escrita falham com 403 do backend.

Passo a passo

1. Abrir a página de usuários

Caminho: Avatar do usuário (canto superior direito) → Gerenciar Usuários

Ou direto pela URL /users.

Lista de Usuários com o botão Novo usuário destacado

Clique: [Novo usuário]

Resultado esperado: dialog Novo usuário abre.

2. Preencher o dialog Novo usuário

Dialog Novo usuário com campos de cadastro

Preencha:

Campo Obrig. Formato/exemplo Efeito
Usuário * Sim noc01 (único; fica travado após criar) Login do painel e da API
Perfil Sim Administrador ou Visualizador (default: Administrador) Define requiresAdmin das rotas
Nome de exibição Não NOC Turno A Exibido nas listas e no avatar
Status Sim Ativo ou Inativo (default: Ativo) Inativo não consegue logar
Senha * Sim (na criação) mínimo 8 caracteres Credencial de login

Clique: [Criar] (rodapé do dialog)

Resultado esperado: toast "Usuário criado" e linha nova na tabela com Status Ativo.

3. Ajustar um usuário existente (opcional)

Na linha do usuário, Clique: [Editar usuário] (ícone de lápis em Ações).

O dialog muda para Editar usuário: Usuário fica travado; senha passa a ser opcional ("Nova senha (opcional)") e só troca se preenchida.

Resultado esperado: toast "Usuário atualizado".

Não é possível excluir o próprio usuário — a UI bloqueia com o aviso "Não é possível excluir o próprio usuário".

Validação

  • [ ] Visual: linha nova na tabela com Perfil e Status corretos
  • [ ] Funcional: logar com o novo usuário — viewer não acessa /users nem /system/mcp (cai no Dashboard); admin acessa tudo
  • [ ] Funcional: curl -H "Authorization: Bearer <JWT>" http://127.0.0.1:8080/api/auth/me devolve o usuário criado

Erros comuns

Sintoma Causa provável Correção
Toast "Usuário e senha são obrigatórios" criação sem usuário ou senha preencher os dois campos marcados com *
Toast "Senha deve ter no mínimo 8 caracteres" senha curta usar senha ≥ 8 caracteres
Backend responde 409/400 ao criar username já existe escolher outro username
Viewer vê "Falha ao carregar usuários" perfil sem permissão (/auth/users é admin-only) usar conta admin para gerenciar

Tabela de referência rápida

Tarefa Onde
Criar usuário Usuários → Novo usuário
Trocar perfil/senha/status Usuários → ícone lápis na linha
Excluir usuário Usuários → ícone lixeira na linha (confirmação obrigatória)