Pular para o conteúdo principal

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 elementos de rede.

Visão Geral de Roteamento

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 isto 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 isto 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
    • Enfileiramento de mensagens com suporte a banco de dados
    • Auto-limpeza e relatórios de entrega
    • Use isto se você estiver operando um Centro de SMS

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

    • Gerenciamento do banco de dados de assinantes
    • Geração de vetores de autenticação
    • Atualizações de localização e informações de roteamento
    • Use isto 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 OCS para faturamento
    • Construtor de solicitações interativas e monitoramento de sessões
    • Use isto 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 isto se você estiver construindo aplicações USSD (consultas de saldo, recargas, etc.)

🔧 Recursos Comuns​

  • Guia de Recursos Comuns - Componentes Compartilhados
    • Visão geral e configuração da interface 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 pode ser executado em 5 modos operacionais diferentes. O arquivo de configuração config/runtime.exs contém exemplos completos e prontos para uso.

Para mudar de modos:

  1. Abra config/runtime.exs
  2. Descomente a seção de configuração desejada (STP, HLR, SMSc ou CAMEL GW)
  3. Comente as outras seções
  4. Atualize os endereços IP e URLs da API conforme necessário
  5. Reinicie a aplicação

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

Exemplos de configurações em runtime.exs:

Modo STP:

config :omniss7,
  map_client_enabled: true,
  hlr_mode_enabled: false,
  smsc_mode_enabled: false,
  camelgw_mode_enabled: false,
  map_client_m3ua: %{...}

Modo HLR:

config :omniss7,
  map_client_enabled: false,
  hlr_mode_enabled: true,
  smsc_mode_enabled: false,
  camelgw_mode_enabled: false,
  hlr_api_base_url: "...",
  map_client_m3ua: %{...}

Modo SMSc:

config :omniss7,
  map_client_enabled: true,
  hlr_mode_enabled: false,
  smsc_mode_enabled: true,
  camelgw_mode_enabled: false,
  smsc_api_base_url: "...",
  auto_flush_enabled: true,
  map_client_m3ua: %{...}

Modo Gateway CAMEL:

config :omniss7,
  cap_client_enabled: true,
  camelgw_mode_enabled: true,
  ocs_enabled: true,
  ocs_url: "http://your-ocs-server/api/charging",
  cap_version: :v2,  # Versão CAP: :v1, :v2, :v3 ou :v4
  cap_client_m3ua: %{...}

4. Acessar a Interface Web​

Navegue até http://localhost (ou seu hostname configurado)

Arquitetura do Sistema​

Matriz de Recursos​

RecursoModo STPCliente MAPModo SMScModo HLRGW 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 Web✅✅✅✅✅
API REST✅✅✅✅✅
Métricas Prometheus✅✅✅✅✅

Operações Comuns​

Acesso à Interface Web​

  • URL: http://localhost (ou hostname configurado)
  • API Swagger: http://localhost/swagger
  • Métricas: http://localhost/metrics

Monitoramento​

# Verifique o status do par M3UA
curl http://localhost/api/m3ua-status

# Veja as métricas do Prometheus
curl http://localhost/metrics

# Verifique a saúde da aplicação
curl http://localhost/api/health

Logs​

# Configure o nível de log em config/runtime.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 OCS para faturamento pré-pago/pós-pago
  • Fila de Mensagens em Tempo Real - Entrega de SMS com suporte a banco de dados
  • Construtor de Solicitações Interativas - Interface web para testes CAMEL/CAP
  • Monitoramento de Sessões - Rastreamento de sessões de chamadas CAMEL em tempo real
  • Documentação da API Interativa - Swagger UI para testes
  • Métricas Prometheus - Observabilidade completa
  • Configuração Multi-função - STP, Cliente MAP, SMSc, HLR, Gateway CAMEL

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 operadoras
  • 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 a 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 fila 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 suas próprias aplicações 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:

Integração e Referência:

Última atualização em