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]

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

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]

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]

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)

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
200e a rota esperada. - Testar Classificação com o número A do cliente e B real bate com o regime esperado.

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
addressexecutado 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
/32vs bloco. Max CPSbaixo 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.