Roteiro: Diagnosticar registros SIP¶
Perfil necessário: admin ou viewer (somente leitura) Menus usados: Operação, Roteamento, Sistema Risco: baixo (leitura); médio se alterar subscriber/domínio para corrigir Rollback: reverter credencial/domínio alterado; reload se domínio mudou
Pré-requisitos¶
- [ ] Username/AOR do endpoint que deveria estar registrado
- [ ] Domínio SIP usado pelo equipamento conhecido
Passo a passo¶
1. Ver se o registro existe¶
Caminho: Operação → Registros SIP

Resultado esperado: tabela com AOR, IP:porta de origem, expires restante, user-agent. Colunas conforme a UI (inclui "Expira em").
2. Registro ausente — seguir a trilha¶
- Usuário existe?
Roteamento → Avançado → Usuários SIP→ buscar username. Se não existe, criar (ver routing-usuario-sip-registro). - Domínio correto? O equipamento registra no mesmo domínio cadastrado em
Sistema → Domínios SIP? Domínio novo exige reload. - Credencial confere? No subscriber, use Consultar senha (edição) para conferir o valor esperado.
- Rede/firewall? Se o registro não chega nem ao OpenSIPS, ver logs (
Sistema → Logs) e firewall (Segurança e Rede → Firewall).

Resultado esperado: causa raiz identificada em uma das 4 etapas.
3. Registro presente mas chamadas rejeitadas¶
Registro OK não garante chamada: a origem do INVITE precisa casar com o address/subscriber.
- Conferir em
Roteamento → Avançado → Endereços Confiáveisse o IP de sinalização do INVITE está coberto (ver routing-endereco-confiavel). - Conferir no CDR o código de erro e o endpoint atribuído (ver noc-investigar-chamada).
4. Registrar de novo (equipamento do cliente)¶
Peça re-registro (restart do registro no PBX) e recarregue esta página: o expires reinicia e o IP/user-agent atualiza.
Validação¶
- [ ] AOR visível com IP esperado e expires saudável
- [ ] Chamada de teste do registrador flui (CDR gerado)
- [ ] Nenhum 401/407 recorrente nos logs para esse AOR
Erros comuns¶
| Sintoma | Causa provável | Correção |
|---|---|---|
| 401/407 contínuo | senha/domínio divergentes | Conferir senha; alinhar domínio |
| Registra e some | expires curto / NAT timeout | aumentar expires no equipamento; keepalive |
| Registra em domínio errado | provisioning do PBX | corrigir proxy/realm no PBX; cadastrar domínio se legítimo |
| Registro OK, chamada 403 | INVITE vem de IP não coberto | criar/ajustar endereço confiável + reload address |
Impacto operacional¶
- Registro é a porta de entrada autenticada: credencial vazando = fraude. Use senhas fortes e rotate (Alterar senha).
- Muitos registros fantasma sem BYE também inflam Chamadas Ativas — investigue por AOR.