Ir para o conteúdo

Roteiro: Criar endpoint completo (identificação, conexão e atributos)

Perfil necessário: admin Menus usados: Roteamento, Plataforma Risco: médio (o endpoint define a origem confiável de tráfego; IP/atributo errados travam o cliente ou abrem chamadas não autorizadas) Rollback: excluir o endpoint (ou editar revertendo os atributos) e recarregar OpenSIPS

Pré-requisitos

  • [ ] IP (v4/v6) e porta SIP do equipamento do cliente (PBX/gateway/SBC)
  • [ ] SIP Profile existente (Plataforma → Sistema → SIP Profiles) para vincular
  • [ ] Interfaces de rede conhecidas se for usar Local IP / RTP IP Override (Segurança e Rede → Rede)
  • [ ] Decisões de mídia: âncora RTP? SRTP? transcodificação? DTMF?

Passo a passo

1. Abrir a listagem de endpoints

Caminho: Roteamento → Endpoints Clique: [Novo Endpoint] (toolbar da listagem)

Listagem de endpoints com botão Novo Endpoint destacado

2. Preencher a identificação do endpoint

Preencha (dialog Novo Endpoint):

Campo Obrig. Formato/exemplo Efeito
Nome sim pbx-acme-01 identificador único; referência em CDR, grupos e firewall
SIP Profile sim perfil existente (dropdown) comportamento SIP/timers no OpenSIPS
IP SIP do Endpoint sim 203.0.113.10 (IPv4 ou IPv6) origem esperada do tráfego; virá como destino SIP
Porta SIP sim 5060 (1–65535) porta de origem do cliente
Dead Letter URI não sip:trap@dominio:5060 destino alternativo quando não há rota possível
Forçar ancora RTP não booleano mídia sempre ancorada no rtpengine nas chamadas originadas deste endpoint

Resultado esperado: campos de identificação prontos; os dois primeiros blocos do dialog preenchidos sem erro de validação.

3. Configurar os atributos do endpoint (grid)

Preencha (bloco Atributos — aba Formulário):

Atributo Tipo Efeito / quando usar
Nome do Endpoint texto espelha o Nome; mantido automaticamente ao salvar
SIP-I toggle transporta ISUP (troca de sinalização PTT/interconexão); liga só se o par really suporta SIP-I
SIP-I Versao texto perfil ISUP (default BR97); deve casar com a operadora/par
SRTP toggle mídia criptografada; ligar apenas se o cliente suporta (DTLS/SDES conforme perfil)
Ocultar topologia SIP toggle remove hops internos (Via/Record-Route) da sinalização exposta ao cliente
Local IP (SIP/RTP) select IP local do softswitch usado para falar com o endpoint (multi-homed/VLAN por cliente)
RTP IP Override select IP de mídia diferente do SIP (ex.: mídia por outra interface); vazio = usa Local IP
RTPEngine out-iface (alias) texto alias da interface de saída de mídia no rtpengine
Protocolo SIP Saída texto transporte para o destino (udp, tcp, tls)
Porta SIP Saída número porta de destino da sinalização (default 5060)
Converter DTMF toggle converte RFC2833 ↔ SIP INFO para interoperabilidade do destino
User Phone toggle adiciona user=phone no R-URI (pares TDM legados)
PAI (P-Asserted-Identity) toggle envia PAI com a identidade do chamador (trunks que exigem PAI)
Duração Mínima (seg) número rejeita chamadas com duração abaixo do valor (antifraude de chamadas curtas)
Transcodificação toggle roteia mídia por media server para converter codecs incompatíveis

Dialog Novo Endpoint com bloco Atributos

A aba JSON Avançado permite editar o mesmo objeto como JSON (valida antes de salvar); prefira a aba Formulário no dia a dia.

Clique: [Criar] (footer do dialog)

Dialog Novo Endpoint com botão Criar destacado

Resultado esperado: dialog fecha, toast "Endpoint criado", linha nova na listagem com Destino SIP ip:porta, SIP Profile, contagem de Endereços ≥ 1 (o IP do endpoint vira endereço confiável automaticamente) e Status Online/Offline após ~15 s.

Nota: ao salvar, o sistema cria automaticamente o endereço confiável do IP SIP do endpoint (e o remove ao excluir). Regras de firewall do endpoint também são sincronizadas.

Validação

  • [ ] Visual: endpoint na listagem com Destino SIP correto e Reload yes → após reload vira no
  • [ ] Funcional: opensips-cli -x mi ds_list mostra o destino do grupo do endpoint; chamada de teste entra com origem identificada (CDR src_endpoint)
  • [ ] Operação → CDR da chamada de teste mostra a origem mapeada para o endpoint

Erros comuns

Sintoma Causa provável Correção
"Informe um IP válido (IPv4/IPv6)" hostname em IP SIP do Endpoint cadastrar IP ou corrigir valor (o campo exige IP, não hostname)
INVITE do cliente rejeitado (403/407) IP/porta divergentes do cadastrado conferir IP/porta; conferir endereço confiável auto-criado
Chamadas sem rota caindo em destino errado Dead Letter URI vazio ou inválido preencher com URI SIP válida
Sem áudio com 200 OK âncora RTP / iface errada revisar Local IP / RTP IP Override / RTPEngine out-iface
488/415 no egress codecs incompatíveis habilitar Transcodificação ou ajustar codecs do tronco
Atributo não faz efeito reload pendente executar reload (passo 4) e refazer o teste
"Este endpoint possui N trunk(s) vinculado(s)" ao excluir endpoint usado por troncos de operadora remover/editar os trunks em Operadoras e Troncos antes

Impacto operacional

  • O IP do endpoint é porta de entrada de tráfego: máscara/IP errados autorizam chamadas de terceiros.
  • SRTP, SIP-I e topology hiding mudam interoperabilidade — homologue com o par antes de ligar em massa.
  • Duração Mínima é camada antifraude; não desabilite sem substituto equivalente.
  • O nome do endpoint é referência em CDR/grupos/firewall — não renomeie sem plano.

Referência rápida

  • Listagem: colunas Nome, Destino SIP, Dead Letter, IP Local, SIP Profile, Endereços, Status, SIP-I, Reload, Atualizado.
  • Status e contagem de endereços se atualizam automaticamente (~15 s).
  • Busca da toolbar: por nome, IP SIP ou IP local.
  • Normalizar RTP (toolbar): normaliza attrs RTP de todos os endpoints e já executa o reload (dispatcher, address, dialplan).