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]

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)

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 |
| não | email@exemplo.com |
contato operacional |

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.

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)

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

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_dumpmostra 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.