Ir para o conteúdo

Roteiro: Provisionar cliente PBX com autenticação por IP

Perfil necessário: admin (criação de linha/endereço) — viewer só para consulta Menus usados: Comercial, Roteamento, Sistema Risco: médio (IP errado pode travar tráfego do cliente ou abrir chamadas não autorizadas) Rollback: desabilitar a linha, remover endereço confiável e recarregar OpenSIPS

Pré-requisitos

  • [ ] Cliente já cadastrado (ver roteiro de clientes; ou criar no passo 1)
  • [ ] Perfil de saída definido (Políticas de Saída) e plano, quando houver faturamento
  • [ ] IP público fixo do PBX do cliente
  • [ ] DIDs a atribuir (E.164 já disponível na plataforma)

Passo a passo

1. Criar o cliente (se ainda não existe)

Caminho: Comercial → Clientes Clique: [Novo Cliente]

Listagem de clientes com botão Novo Cliente destacado

Preencha:

Campo Obrig. Formato/exemplo Efeito
Tipo de Documento sim CNPJ/CPF identificação fiscal
Numero do Documento sim 12345678000199 identificação fiscal
Nome / Razao Social sim ACME Telecom nome exibido
Nome Fantasia não ACME exibição alternativa
Numero do Contrato não livre referência comercial
Status sim ativo/inativo controle de vigência
Limite de Credito não decimal teto de crédito
Limite simultaneo do cliente não inteiro teto de chamadas simultâneas
Dia da Fatura (1-31) não inteiro ciclo de faturamento
Nome/Email/Telefone de Contato não livre contato operacional
Observacoes não livre anotações

Resultado esperado: cliente criado e listado; abrir o detalhe do cliente.

2. Criar a linha do cliente

Caminho: Comercial → Clientes → (detalhe do cliente) Clique: [Nova Linha] na seção Linhas

Detalhe do cliente com botão Nova Linha destacado

Preencha:

Campo Obrig. Formato/exemplo Efeito
Cliente sim pré-preenchido dono da linha
Tipo sim LOC/LDN/MOV conforme tráfego classificação do tráfego
Perfil de Saída não perfil existente normalização/entrega do número B
Plano (faturamento) não plano existente franquias/tarifas
Tech Prefix não string prefixo técnico opcional
Max Concurrent não inteiro limite de chamadas simultâneas
Max CPS não inteiro limite de chamadas por segundo (antifraude)
Status sim ativa/suspeita/bloqueada habilitação
Dead Letter URI não SIP URI destino de chamadas sem rota
Forçar ancora RTP não booleano âncora de mídia no rtpengine
IPs autorizados a enviar chamadas sim p/ IP auth CIDR/IP autenticação por IP (Adicionar IP)

Resultado esperado: linha criada; anotar o id da linha para os DIDs.

3. Atribuir os DIDs

Caminho: Comercial → DIDs Clique: [Novo DID]

Listagem de DIDs com botão Novo DID destacado

Preencha:

Campo Obrig. Formato/exemplo Efeito
Número E.164 da plataforma sim 55113334444 número do cliente
Linha não seletor (filtrável por cliente) dono do DID
Status sim ativo/inativo habilitação
Portado para dentro em não data histórico de portabilidade
Portado para fora em não data histórico de portabilidade
Operadora atual não operadora referência atual
Tipo de serviço não LOC/LDN/MOV etc. classificação
Primary — CallerID default da linha não booleano CLI padrão (um por linha)
Permitir como caller-id apresentado não booleano CLI permitido em saída
Permitir chamadas saintes não booleano uso em saída
Dígitos entregues no inbound sim inteiro quantos dígitos o carrier entrega

Repita para cada DID do cliente.

Resultado esperado: DIDs listados, vinculados à linha; um marcado como Primary.

4. Liberar o IP do PBX (endereço confiável)

Caminho: Roteamento → Avançado → Endereços Confiáveis Clique: [Novo Endereço]

Listagem de endereços confiáveis com botão Novo Endereço destacado

Preencha:

Campo Obrig. Formato/exemplo Efeito
IP/Máscara sim 203.0.113.10/32 origem autorizada
Contexto/linha sim linha do cliente desambiguação de origem
Grupo não grupo de address organização
Comportamento sim conforme UI (autenticado por IP) trata INVITE sem registro

Crie um endereço por IP do PBX (inclua IPs secundários/sementes).

Resultado esperado: endereços listados; origem do cliente autorizada.

5. Recarregar OpenSIPS

Caminho: Sistema → OpenSIPS Clique: [Recarregar todos os módulos] (ou módulo address individualmente)

Página de reload com botão Recarregar todos os módulos destacado

Resultado esperado: mensagem de sucesso por módulo; memória do OpenSIPS atualizada.

6. Validar com uma chamada real

Peça ao cliente uma chamada de teste e confirme:

  • Operação → CDR com filtro Origem/Destino mostra a chamada com código 200 e a rota esperada.
  • Testar Classificação com o número A do cliente e B real bate com o regime esperado.

Testar Classificação

Validação

  • [ ] Cliente, linha e DIDs visíveis nos seus CRUDs
  • [ ] Endereço confiável criado para cada IP do PBX
  • [ ] Reload do módulo address executado sem erro
  • [ ] Chamada de teste com 200 e CDR gerado
  • [ ] CLI apresentado é o DID marcado como Primary

Erros comuns

Sintoma Causa provável Correção
401/407 no INVITE do cliente IP não cadastrado ou máscara errada conferir IP/máscara e recriar endereço
Chamada entra e cai com 404 DID não vinculado à linha ou dígitos inbound errados ajustar DID e "Dígitos entregues no inbound"
Sem rota de saída perfil de saída ausente na linha vincular perfil em Linhas
CLI errado no destino DID Primary incorreto ou CLI não permitido marcar Primary e permitir o DID
Mudanças não fazem efeito reload não executado rodar Reload (address/dialplan)

Impacto operacional

  • Endereço confiável é porta de entrada de tráfego: IP errado autoriza chamadas de terceiros — revise máscara /32 vs bloco.
  • Max CPS baixo demais bloqueia picos legítimos; alto demais reduz proteção antifraude.
  • Toda alteração de endereço exige reload; sem isso, memória e banco ficam divergentes.