OmniSS7 - Guia do Usuário

OmniSS7 da Omnitouch Network Services é uma pilha de sinalização SS7 abrangente e de uso geral que fornece funcionalidade flexível de elemento de rede.

Visão Geral da Documentação

Esta documentação está organizada por função do elemento de rede. Escolha o guia que corresponde à sua implantação:

📚 Guias de Configuração

• Guia STP - Configuração do Ponto de Transferência de Sinal

  • Roteie o tráfego SS7 entre pares de rede
  • Roteamento de Código de Ponto e Título Global
  • Balanceamento de carga e ocultação de topologia
  • Use isso se você estiver roteando tráfego SS7 entre redes

• Guia do Cliente MAP - Configuração do Cliente MAP

  • Conecte-se como cliente M3UA para enviar solicitações MAP
  • Consultas HLR, autenticação, informações de roteamento
  • Suporte ao protocolo MAP genérico
  • Use isso se você estiver enviando solicitações MAP para elementos de rede

• Guia do Centro de SMS - Configuração do Centro de SMS (SMSc)

  • Roteamento e entrega de mensagens SMS
  • Filas de mensagens com suporte a banco de dados
  • Auto-limpeza e relatórios de entrega
  • Use isso se você estiver operando um Centro de SMS

• Guia HLR - Configuração do Registro de Localização do Assinante

  • Gerenciamento de banco de dados de assinantes
  • Geração de vetores de autenticação
  • Atualizações de localização e informações de roteamento
  • Use isso se você estiver operando um HLR/HSS

• Guia do Gateway CAMEL - Configuração do Gateway CAMEL

  • Serviços de rede inteligente (CAP/CAMEL)
  • Controle de chamadas em tempo real e cobrança
  • Integração CGrateS para faturamento
  • Construtor de solicitações interativas e monitoramento de sessões
  • Use isso se você estiver fornecendo serviços IN ou cobrança em tempo real

• Guia do Gateway USSD - Configuração do Gateway USSD

  • Conecte SS7/MAP USSD a callbacks HTTP/JSON
  • Menus interativos USSD de múltiplas etapas
  • Roteamento de código curto para diferentes URLs de callback
  • Push USSD originado na rede via API REST
  • Use isso se você estiver construindo aplicativos USSD (consultas de saldo, recargas, etc.)

🔧 Recursos Comuns

• Guia de Recursos Comuns - Componentes Compartilhados
  • Visão geral e configuração da interface da Web
  • Documentação da API
  • Monitoramento e métricas (Prometheus)
  • Melhores práticas e solução de problemas

📖 Documentação de Referência

• Apêndice - Referência Técnica
  • Especificações do protocolo SS7
  • Códigos de operação MAP
  • Fluxos de transação TCAP
  • Codificações e formatos de caracteres

---

Início Rápido

1. Visão Geral do Sistema

OmniSS7 pode operar em diferentes modos dependendo das suas necessidades de rede:

3. Configuração

OmniSS7 seleciona seu papel a partir de um conjunto de flags de modo em config/config.exs. As flags se combinam, então uma única instância pode atuar como vários papéis ao mesmo tempo (por exemplo, Cliente MAP mais SMSc).

Nota: config/runtime.exs neste repositório é um pequeno stub de teste. Servidores de produção têm seu próprio runtime.exs implantado separadamente. Edite config/config.exs (e o arquivo específico do ambiente que ele importa) para alterar a configuração padrão.

Para selecionar um papel:

1. Defina as flags de modo relevantes em config/config.exs
2. Configure a conexão M3UA (map_client_m3ua ou cap_client_m3ua) e quaisquer URLs de API de backend
3. Reinicie a aplicação

→ Veja os guias específicos de modo abaixo para instruções completas de configuração

Modo STP — roteie tráfego SCCP/M3UA entre pares:

config :omniss7,
  sctp_handler: %{enabled: true, local_ip: {0, 0, 0, 0}, local_port: 2905, point_code: 100},
  enable_gt_routing: true,
  m3ua_peers: [...],
  m3ua_routes: [...],
  m3ua_gt_routes: [...]

Modo HLR:

config :omniss7,
  hlr_mode_enabled: true,
  map_client_enabled: true,
  hlr_api_base_url: "https://hlr-backend:8443",
  map_client_m3ua: %{...}

Modo SMSc:

config :omniss7,
  map_client_enabled: true,
  smsc_mode_enabled: true,
  smsc_api_base_url: "https://smsc-backend:8443",
  auto_flush_enabled: true,
  map_client_m3ua: %{...}

Modo Gateway CAMEL:

config :omniss7,
  cap_client_enabled: true,
  camelgw_mode_enabled: true,
  cgrates_enabled: true,
  cgrates_url: "http://localhost:2080/jsonrpc",
  cgrates_tenant: "cgrates.org",
  cap_client_m3ua: %{...}

Veja a Referência de Configuração para cada parâmetro, incluindo o Gateway USSD (ussd_gateway_enabled).

4. Acessar a Interface da Web

A interface da Web é servida via HTTPS na porta 8087 — por exemplo https://localhost:8087/ (ou seu host configurado). O endpoint impõe TLS, então http:// simples é redirecionado.

---

Arquitetura do Sistema

---

Matriz de Recursos

Recurso	Modo STP	Cliente MAP	Modo SMSc	Modo HLR	GW CAMEL
Roteamento de Código de Ponto	✅	❌	❌	❌	❌
Roteamento de Título Global	✅	❌	❌	❌	❌
Reescrita de SSN	✅	❌	❌	❌	❌
Suporte a Múltiplos Pares	✅	✅	✅	✅	✅
Solicitações MAP (Enviar)	❌	✅	✅	✅	❌
Respostas MAP (Receber)	❌	✅	✅	✅	❌
Gerenciamento de Fila de SMS	❌	❌	✅	❌	❌
Auto-Limpeza de SMS	❌	❌	✅	❌	❌
Banco de Dados de Assinantes	❌	❌	❌	✅	❌
Vetores de Autenticação	❌	❌	❌	✅	❌
Atualizações de Localização	❌	❌	❌	✅	❌
Suporte CAP/CAMEL	❌	❌	❌	❌	✅
Cobrança em Tempo Real	❌	❌	❌	❌	✅
Controle de Chamadas (Serviços IN)	❌	❌	❌	❌	✅
Interface da Web	✅	✅	✅	✅	✅
API REST	✅	✅	✅	✅	✅
Métricas Prometheus	✅	✅	✅	✅	✅

---

Operações Comuns

OmniSS7 escuta em várias portas, cada uma servindo uma superfície diferente:

Porta	Protocolo	Servido por	Propósito
8087	HTTPS	ControlPanel (Phoenix)	Dashboard da interface da Web (TLS aplicado)
8445	HTTPS	api_ex	API de status JSON (/api/status, /api/m3ua-status, /api/routing, …)
8080	HTTP	APIhandler (Plug.Cowboy)	API de operação MAP (/api/*), Swagger UI (/swagger), especificação OpenAPI (/swagger.json), métricas Prometheus (/metrics)
2905	SCTP	M3UA/M2PA	Transporte de sinalização SS7

Acesso à Interface da Web

• Interface da Web: https://localhost:8087/ (ou host configurado)
• Swagger UI: http://localhost:8080/swagger
• Especificação OpenAPI: http://localhost:8080/swagger.json
• Métricas: http://localhost:8080/metrics

Monitoramento

# Visualizar métricas Prometheus
curl http://localhost:8080/metrics

# Verificar status do par M3UA (TLS, certificado autoassinado)
curl -k https://localhost:8445/api/m3ua-status

# Status do serviço
curl -k https://localhost:8445/api/status

Logs

Os logs são emitidos como JSON estruturado (um objeto por linha) para ingestão pelo Loki/Alloy, via OmniLogger.JsonFormatter. Defina o nível de log em config/config.exs:

config :logger,
  level: :debug  # Opções: :debug, :info, :warning, :error

---

Principais Capacidades

• Suporte Completo ao Protocolo MAP - Operações da Fase 2/3 do MAP
• Suporte ao Protocolo CAP/CAMEL - CAP v1/v2/v3/v4 para serviços de rede inteligente
• Sinalização M3UA/SCTP - Transporte SS7 baseado em IP
• Cobrança em Tempo Real - Integração CGrateS para faturamento pré-pago/pós-pago
• Entrega de SMS - Fila de mensagens com suporte a HTTP/JSON e auto-limpeza
• Construtor de Solicitações Interativo - Interface da Web para testes CAMEL/CAP
• Monitoramento de Sessões - Rastreamento em tempo real de sessões de chamadas CAMEL
• Documentação da API Interativa - Swagger UI para testes
• Métricas Prometheus - Observabilidade completa
• Configuração de Múltiplos Papéis - STP, Cliente MAP, SMSc, HLR, Gateway CAMEL, Gateway USSD

---

Visão Geral da Pilha de Protocolo

---

Exemplos de Casos de Uso

Gateway de Rede (STP)

Roteie o tráfego SS7 entre diferentes redes móveis

• Conecte redes de operadores
• Gateway SS7 internacional
• Balanceamento de carga entre HLRs
• Tradução de Título Global
• NAT SCCP (Reutilização Inteligente de Título Global)
• → Guia STP

Centro de SMS (SMSc)

Entregue mensagens SMS para assinantes móveis

• Entrega de MT-SMS
• Originação de MO-SMS
• Roteamento de SMS para casa
• Ocultação de IMSI
• Firewall de SMS
• Gerenciamento de filas de mensagens
• Relatórios de entrega
• Integrado ao OmniMessage para gerenciar todos os SMS MAP
• → Guia do Centro de SMS

Cliente MAP

Interaja com qualquer elemento de rede via MAP usando uma simples API RESTful

• PRN / SRI / ATI / etc
• Construa seus próprios aplicativos SS7/MAP usando APIs RESTful
• Gateways USSD
• Solicitações de vetores de autenticação
• Consultas IMSI/MSISDN
• Consultas de informações de roteamento
• → Guia do Cliente MAP

Banco de Dados de Assinantes (HLR)

Gerencie dados de assinantes e autenticação

• Atualizações de localização
• Geração de autenticação
• Provisão de informações de roteamento
• Integra-se totalmente ao OmniHSS
• → Guia HLR

Plataforma de Rede Inteligente (Gateway CAMEL)

Controle de chamadas em tempo real e cobrança para operadores de telecomunicações

• Cobrança de chamadas pré-pagas/pós-pagas
• Controle de chamadas (conectar, liberar, roteamento)
• Gerenciamento de sessões e geração de CDR
• Construtor de solicitações interativas para testes
• → Guia do Gateway CAMEL

---

Suporte e Recursos

Documentação

Guias de Configuração do Core:

• Guia de Configuração STP - Roteamento do Ponto de Transferência de Sinal
• Guia de Configuração do Cliente MAP - Cliente do protocolo MAP
• Guia de Configuração do Centro de SMS - Roteamento e entrega de SMS
• Guia de Configuração do HLR - Banco de dados de assinantes
• Guia de Configuração do Gateway CAMEL - Rede inteligente e cobrança

Integração & Referência:

• Guia do Construtor de Solicitações CAMEL - Ferramenta de teste interativa
• Guia de Recursos Comuns - Componentes compartilhados e Interface da Web
• Referência Técnica - Especificações do protocolo