Ir para o conteúdo

Roteiro: Criar usuário SIP (subscriber) e validar registro

Perfil necessário: admin (a página /advanced/subscribers exige admin) Menus usados: Roteamento, Operação, Plataforma Risco: médio (senha fraca ou domínio errado expõem a plataforma a fraudes de registro) Rollback: desabilitar o subscriber (Status Inativo) ou excluir; alterar senha; recarregar OpenSIPS

Pré-requisitos

  • [ ] Domínio SIP já cadastrado (Plataforma → Sistema → Domínios SIP) — o dialog só oferece domínios existentes
  • [ ] Política de senha conhecida (senha forte; o backend guarda senha e recalcula HA1/HA1B automaticamente)
  • [ ] Saber se o caso é ramal (extension) ou tronco registrado (trunk_registered)

Passo a passo

1. (Opcional) Criar o domínio SIP

Caminho: Plataforma → Sistema → Domínios SIP Clique: [Novo domínio]

Domínios SIP com botão Novo domínio destacado

Preencha: o domínio (ex.: sip.empresa.com.br), marque como default se for o domínio padrão da plataforma.

Resultado esperado: domínio listado; OpenSIPS o aceita nos registros após reload.

Aviso da própria página de Usuários SIP: subscribers são gerenciados automaticamente quando você cria/edita Linhas via Clientes. Edite aqui apenas se souber o que está fazendo.

2. Criar o usuário SIP

Caminho: Roteamento → Avançado → Usuários SIP Clique: [Novo usuário SIP] (toolbar da listagem)

Listagem de usuários SIP com botão Novo usuário SIP destacado

Preencha (dialog Novo Usuario SIP):

Campo Obrig. Formato/exemplo Efeito
Username sim 2101 ou acme-trunk01 AOR (username@domain) do registro; combinação deve ser única
Domínio sim domínio do passo 1 (dropdown) realm de autenticação; entra no cálculo do HA1
Senha sim (na criação) senha forte credencial; HA1 = MD5(user:domain:pass) e HA1B = MD5(user@domain:domain:pass) são calculados no save
Confirmar senha sim (na criação) igual à senha validação de digitação
Perfil não Ramal (extension) ou Tronco registrado (default Ramal (extension)) comportamento associado ao subscriber
Status sim Ativo ou Inativo (default Ativo) habilita/bloqueia o registro
Email não email@exemplo.com contato operacional

Dialog Novo Usuario SIP com botão Criar destacado

Clique: [Criar] (footer do dialog)

Resultado esperado: dialog fecha, toast "Criado", linha nova na listagem com Username, Domínio, Perfil (tag), Email, Status Ativo e Atualizado.

3. (Opcional) Consultar ou trocar a senha depois

Abra o subscriber pelo ícone de lápis da linha (tooltip Editar) — dialog Editar Usuario SIP:

  • Clique: [Consultar senha] — exibe a senha salva no banco (campo somente leitura).
  • Clique: [Alterar senha] — abre os campos Nova senha / Confirmar senha; ao salvar, HA1/HA1B são recalculados.
  • Cancelar alteracao de senha desfaz a edição em andamento sem salvar.

Dialog Editar Usuario SIP com botão Alterar senha destacado

4. Recarregar OpenSIPS

Subscriber não é reload-to-memory (autenticação lê o banco), mas o domínio novo do passo 1 precisa entrar na memória:

Caminho: Plataforma → Sistema → OpenSIPS (Reload) Clique: [Recarregar todos os módulos] (ou o card do domínio/módulo correspondente)

Página de reload com botão Recarregar todos os módulos destacado

Resultado esperado: mensagem de sucesso por módulo.

5. Validar o registro

Caminho: Operação → Registros SIP

  • [ ] Configure o PBX/softphone com username, senha e domínio criados
  • [ ] A listagem mostra o AOR com Usuário, Domínio, IP cliente, Borda, Contact, User Agent e tag verde de Expira em (> 60 s)
  • [ ] Auto-refresh (15 s) ligado, use a busca por usuário/domínio/IP para filtrar

Registros SIP com o AOR registrado

Validação

  • [ ] Visual: subscriber listado com Status Ativo; registro visível em Registros SIP
  • [ ] Funcional: registro renova dentro do expires (Expira em volta a subir após re-REGISTER); chamada de teste do subscriber gera CDR com origem correta
  • [ ] MI: opensips-cli -x mi ul_dump mostra o contato registrado

Erros comuns

Sintoma Causa provável Correção
401/407 persiste no REGISTER usuário/senha/divergência de domínio usar Consultar senha para conferir; conferir domínio do AOR
"As senhas nao coincidem" Confirmar senha diferente redigitar; campos ficam vermelhos até coincidirem
"Subscriber 'x@y' já existe" username@domain duplicado escolher outro username ou domínio
Não aparece em Registros SIP registra em domínio não cadastrado, ou Status Inativo cadastrar domínio + reload; ativar o subscriber
Registro aceito, chamada rejeitada perfil/linha/DIDs não configurados revisar linha do cliente, DIDs e políticas
Registro some da listagem expires vencido sem re-REGISTER conferir configuração do PBX (intervalo de registro)

Impacto operacional

  • Subscriber é credencial de entrada: senha fraca = fraude internacional em horas. Exija senha forte e mantenha limites na linha associada (Canais/CPS/Duração Mínima).
  • Rotacione senhas periodicamente com Alterar senha; o campo Consultar senha existe para conferência — não anote senha em planilha.
  • Mudança de username/domínio/status recalcula HA1/HA1B e recompila planos de entrega que referenciam o subscriber.