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

Listagem: Nome, Socket, Protocolo, Porta, Advertise, Reload, Atualizado.
2. Criar o perfil¶
Clique: [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

Listagem: Domínio, Padrão (Sim/Não), Status (Ativo/Inativo), Descrição, Atualizado.
2. Criar o domínio¶
Clique: [Novo domínio]

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 SIPmostra o AOR)

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 |