Saltar al contenido principal

OmniSS7 - Guía del Usuario

OmniSS7 de Omnitouch Network Services es un stack de señalización SS7 integral y de propósito general que proporciona funcionalidad flexible de elementos de red.

Descripción General del Enrutamiento

Descripción General de la Documentación​

Esta documentación está organizada por el rol del elemento de red. Elija la guía que coincida con su implementación:

📚 Guías de Configuración​

  • Guía STP - Configuración del Punto de Transferencia de Señales

    • Enrutar tráfico SS7 entre pares de red
    • Enrutamiento de Código de Punto y Título Global
    • Balanceo de carga y ocultamiento de topología
    • Utilice esto si está enrutando tráfico SS7 entre redes

  • Guía del Cliente MAP - Configuración del Cliente MAP

    • Conectarse como cliente M3UA para enviar solicitudes MAP
    • Consultas HLR, autenticación, información de enrutamiento
    • Soporte del protocolo MAP genérico
    • Utilice esto si está enviando solicitudes MAP a elementos de red

  • Guía del Centro SMS - Configuración del Centro SMS (SMSc)

    • Enrutamiento y entrega de mensajes SMS
    • Cola de mensajes respaldada por base de datos
    • Informes de entrega y auto-limpieza
    • Utilice esto si está operando un Centro SMS

  • Guía HLR - Configuración del Registro de Ubicación del Hogar

    • Gestión de base de datos de suscriptores
    • Generación de vectores de autenticación
    • Actualizaciones de ubicación e información de enrutamiento
    • Utilice esto si está operando un HLR/HSS

  • Guía del Gateway CAMEL - Configuración del Gateway CAMEL

    • Servicios de red inteligente (CAP/CAMEL)
    • Control de llamadas en tiempo real y facturación
    • Integración OCS para facturación
    • Constructor de solicitudes interactivas y monitoreo de sesiones
    • Utilice esto si está proporcionando servicios IN o facturación en tiempo real

  • Guía del Gateway USSD - Configuración del Gateway USSD

    • Puente SS7/MAP USSD a callbacks HTTP/JSON
    • Menús USSD interactivos de múltiples turnos
    • Enrutamiento de códigos cortos a diferentes URLs de callback
    • Empuje USSD originado en la red a través de REST API
    • Utilice esto si está construyendo aplicaciones USSD (consultas de saldo, recargas, etc.)

🔧 Características Comunes​

  • Guía de Características Comunes - Componentes Compartidos
    • Descripción general de la interfaz web y configuración
    • Documentación de API
    • Monitoreo y métricas (Prometheus)
    • Mejores prácticas y solución de problemas

📖 Documentación de Referencia​

  • Apéndice - Referencia Técnica
    • Especificaciones del protocolo SS7
    • Códigos de operación MAP
    • Flujos de transacciones TCAP
    • Codificaciones y formatos de caracteres

Inicio Rápido​

1. Descripción General del Sistema​

OmniSS7 puede operar en diferentes modos dependiendo de sus requisitos de red:

3. Configuración​

OmniSS7 puede ejecutarse en 5 modos operativos diferentes. El archivo de configuración config/runtime.exs contiene ejemplos completos y listos para usar.

Para cambiar de modo:

  1. Abra config/runtime.exs
  2. Descomente la sección de configuración deseada (STP, HLR, SMSc o CAMEL GW)
  3. Comente las otras secciones
  4. Actualice las direcciones IP y las URLs de API según sea necesario
  5. Reinicie la aplicación

→ Consulte las guías específicas de modo a continuación para obtener instrucciones completas de configuración

Ejemplos de configuraciones en 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,  # Versión CAP: :v1, :v2, :v3, o :v4
  cap_client_m3ua: %{...}

4. Acceso a la Interfaz Web​

Navegue a http://localhost (o su nombre de host configurado)

Arquitectura del Sistema​

Matriz de Características​

CaracterísticaModo STPCliente MAPModo SMScModo HLRGateway CAMEL
Enrutamiento de Código de Punto✅❌❌❌❌
Enrutamiento de Título Global✅❌❌❌❌
Reescritura de SSN✅❌❌❌❌
Soporte Multi-Peer✅✅✅✅✅
Solicitudes MAP (Enviar)❌✅✅✅❌
Respuestas MAP (Recibir)❌✅✅✅❌
Gestión de Cola de SMS❌❌✅❌❌
Auto-Limpieza de SMS❌❌✅❌❌
Base de Datos de Suscriptores❌❌❌✅❌
Vectores de Autenticación❌❌❌✅❌
Actualizaciones de Ubicación❌❌❌✅❌
Soporte CAP/CAMEL❌❌❌❌✅
Carga en Tiempo Real❌❌❌❌✅
Control de Llamadas (Servicios IN)❌❌❌❌✅
Interfaz Web✅✅✅✅✅
REST API✅✅✅✅✅
Métricas de Prometheus✅✅✅✅✅

Operaciones Comunes​

Acceso a la Interfaz Web​

  • URL: http://localhost (o nombre de host configurado)
  • API Swagger: http://localhost/swagger
  • Métricas: http://localhost/metrics

Monitoreo​

# Verificar estado del par M3UA
curl http://localhost/api/m3ua-status

# Ver métricas de Prometheus
curl http://localhost/metrics

# Verificar salud de la aplicación
curl http://localhost/api/health

Registros​

# Configurar nivel de registro en config/runtime.exs
config :logger,
  level: :debug  # Opciones: :debug, :info, :warning, :error

Capacidades Clave​

  • Soporte Completo del Protocolo MAP - Operaciones de MAP Fase 2/3
  • Soporte del Protocolo CAP/CAMEL - CAP v1/v2/v3/v4 para servicios de red inteligente
  • Señalización M3UA/SCTP - Transporte SS7 basado en IP
  • Carga en Tiempo Real - Integración OCS para facturación prepago/postpago
  • Cola de Mensajes en Tiempo Real - Entrega de SMS respaldada por base de datos
  • Constructor de Solicitudes Interactivas - Interfaz web para pruebas CAMEL/CAP
  • Monitoreo de Sesiones - Seguimiento de sesiones de llamadas CAMEL en tiempo real
  • Documentación API Interactiva - Interfaz Swagger para pruebas
  • Métricas de Prometheus - Observabilidad completa
  • Configuración Multi-rol - STP, Cliente MAP, SMSc, HLR, Gateway CAMEL

Descripción General de la Pila de Protocolo​

Ejemplos de Casos de Uso​

Gateway de Red (STP)​

Enrutar tráfico SS7 entre diferentes redes móviles

  • Conectar redes de operadores
  • Gateway SS7 internacional
  • Balanceo de carga entre HLRs
  • Traducción de Título Global
  • NAT SCCP (Reutilización Inteligente de Título Global)
  • → Guía STP

Centro SMS (SMSc)​

Entregar mensajes SMS a suscriptores móviles

  • Entrega de MT-SMS
  • Origen de MO-SMS
  • Enrutamiento SMS en el hogar
  • Ocultamiento de IMSI
  • Firewall de SMS
  • Gestión de colas de mensajes
  • Informes de entrega
  • Integrado en OmniMessage para manejar todos los SMS MAP
  • → Guía del Centro SMS

Cliente MAP​

Interactuar con cualquier elemento de red a través de MAP utilizando una simple API RESTful

  • PRN / SRI / ATI / etc.
  • Construya sus propias aplicaciones SS7/MAP utilizando APIs RESTful
  • Gateways USSD
  • Solicitudes de vectores de autenticación
  • Búsquedas de IMSI/MSISDN
  • Consultas de información de enrutamiento
  • → Guía del Cliente MAP

Base de Datos de Suscriptores (HLR)​

Gestionar datos de suscriptores y autenticación

  • Actualizaciones de ubicación
  • Generación de autenticación
  • Provisión de información de enrutamiento
  • Se integra completamente en OmniHSS
  • → Guía HLR

Plataforma de Red Inteligente (Gateway CAMEL)​

Control de llamadas en tiempo real y facturación para operadores de telecomunicaciones

  • Carga de llamadas prepago/postpago
  • Control de llamadas (conectar, liberar, enrutar)
  • Gestión de sesiones y generación de CDR
  • Constructor de solicitudes interactivas para pruebas
  • → Guía del Gateway CAMEL

Soporte y Recursos​

Documentación​

Guías de Configuración del Núcleo:

Integración y Referencia:

Última actualización en