Ir para o conteúdo

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

Tabela de 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

  1. Usuário existe? Roteamento → Avançado → Usuários SIP → buscar username. Se não existe, criar (ver routing-usuario-sip-registro).
  2. Domínio correto? O equipamento registra no mesmo domínio cadastrado em Sistema → Domínios SIP? Domínio novo exige reload.
  3. Credencial confere? No subscriber, use Consultar senha (edição) para conferir o valor esperado.
  4. Rede/firewall? Se o registro não chega nem ao OpenSIPS, ver logs (Sistema → Logs) e firewall (Segurança e Rede → Firewall).

Logs do sistema para investigar registro ausente

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.

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.