Ir para o conteúdo

Roteiro: Gerir SIP Profiles e Domínios SIP

Perfil necessário: admin (duas páginas restritas a admin) Menus usados: Sistema Risco: médio — SIP Profile em endereço/porta errada tira o listen de produção; domínio SIP excluído/inativado quebra autenticação digest dos subscribers daquele domínio Rollback: recriar/editar o registro com os valores anteriores e reiniciar o OpenSIPS (profiles/sockets são lidos no arranque); para domínios, recriar com o mesmo domain

Parte A — SIP Profiles

O que é

Perfis de socket SIP do OpenSIPS (tabela sip_profiles): cada perfil define nome, socket de escuta (IP), protocolo, porta e endereço de advertise. Endpoints/rotas selecionam o perfil; a troca de IP na página Rede também sincroniza esses sockets.

1. Abrir a página

Caminho: Plataforma → Sistema → SIP Profiles

Página SIP Profiles com o botão Novo SIP Profile destacado

Listagem: Nome, Socket, Protocolo, Porta, Advertise, Reload, Atualizado.

2. Criar o perfil

Clique: [Novo SIP Profile]

Dialog Novo SIP Profile

Preencha:

Campo Obrig. Formato/exemplo Efeito
Nome * sim udp-5060-lan identificação usada nos cadastros (endpoints etc.)
Socket * sim 0.0.0.0 IP de escuta do socket (sem porta)
Protocolo sim (default udp) udp/tcp/tls/ws/wss transporte do socket
Porta sim (default 5060) 1–65535 porta de escuta
Advertise Address não IP/host público endereço anunciado no SDP atrás de NAT

Clique: [Criar] (ou [Salvar] na edição).

Resultado esperado: perfil listado; na edição, a coluna Reload marca yes automaticamente (backend força reload_profile = "yes" em toda atualização).

3. Efetivar e validar

  • Sockets novos só existem no OpenSIPS após reinício (systemctl restart opensips) — regeneração do cfg/restart conforme o ambiente.
  • Validar listen: opensips-cli -x mi get_statistics all (sem erros de socket) e OPTIONS/REGISTER respondendo no IP:porta novo.
  • Perfil em uso por endpoints: o cadastro do endpoint referencia o perfil — revise antes de excluir (exclusão pede confirmação).

Parte B — Domínios SIP

O que é

Domínios (realms) aceitos na autenticação digest dos Usuários SIP (subscribers). O campo domain do subscriber precisa casar com um domínio ativo daqui. Existe um único domínio padrão por vez (marcado na listagem; ao marcar um novo, o backend desmarca os demais).

1. Abrir a página

Caminho: Plataforma → Sistema → Domínios SIP

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

Listagem: Domínio, Padrão (Sim/Não), Status (Ativo/Inativo), Descrição, Atualizado.

2. Criar o domínio

Clique: [Novo domínio]

Dialog Novo domínio SIP

Preencha:

Campo Obrig. Formato/exemplo Efeito
Domínio * sim sip.atplus.com.br realm aceito no digest; único (duplicado recusa 409)
Descrição não livre documentação
Ativo toggle (default ligado) on/off domínio inativo não autentica
Domínio padrão toggle on/off realm default; exige Ativo (422 se inativo); se nenhum existe, o primeiro domínio ativo criado vira default automaticamente

Clique: [Criar] (ou [Salvar] na edição).

Resultado esperado: domínio listado; se marcado padrão, os demais perdem o marcador (aparece Padrão: Sim só em um).

3. Regras de proteção (o que o backend recusa)

  • Renomear domínio com subscribers vinculados → 409 "Dominio em uso por subscribers; crie outro dominio para novos cadastros".
  • Inativar domínio com subscribers vinculados → 409 "nao pode ser inativado".
  • Excluir domínio padrão → 409 "Dominio padrao nao pode ser excluido"; excluir com subscribers → 409 com a contagem.
  • Trocar o padrão de um domínio com subscribers exige outro domínio ativo como padrão antes (409).

Resultado esperado: alterações bloqueadas aparecem como erro do backend no toast — corrija a dependência (migre os subscribers) antes.

Validação

  • [ ] Visual: perfil/domínio listado com os valores novos
  • [ ] Funcional (profiles): OpenSIPS reinicia sem erro de cfg e escuta no socket novo
  • [ ] Funcional (domínios): REGISTER de um subscriber com realm do domínio novo é aceito (Registro SIP mostra o AOR)

Registro SIP validando o domínio

Erros comuns

Sintoma Causa provável Correção
OpenSIPS não sobe após criar perfil socket/porta já em uso ou IP inexistente no host corrigir socket/porta (ou criar o IP em Rede), regenerar cfg e reiniciar
409 "Dominio SIP ja existe" domínio duplicado usar o existente ou escolher outro nome
422 "Dominio padrao deve estar ativo" marcou padrão com Ativo desligado ligar Ativo antes do padrão
409 dominio "em uso por subscribers" subscribers cadastrados no domínio migrar subscribers para outro domínio antes de renomear/inativar/excluir
REGISTER falha com 401 em loop domínio do subscriber não está ativo na lista criar/ativar o domínio na Parte B
Perfil editado não tem efeito sockets lidos só no arranque reiniciar o OpenSIPS