OmniSS7 - Guía del Usuario
OmniSS7 de Omnitouch Network Services es un stack de señalización SS7 completo y de propósito general que proporciona funcionalidad flexible de elementos de red.

Resumen 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á enroutando 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 para el protocolo MAP genérico
- Utilice esto si está enviando solicitudes MAP a elementos de red
-
Guía del Centro SMS - Configuración del Centro de SMS (SMSc)
- Enrutamiento y entrega de mensajes SMS
- Cola de mensajes respaldada por base de datos
- Auto-limpieza e informes de entrega
- Utilice esto si está operando un Centro de SMS
-
Guía HLR - Configuración del Registro de Localización de Suscriptores
- 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
🔧 Características Comunes
- Guía de Características Comunes - Componentes Compartidos
- Resumen y configuración de la interfaz web
- 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 transacción TCAP
- Codificaciones y formatos de caracteres
Inicio Rápido
1. Resumen del Sistema
OmniSS7 puede operar en diferentes modos dependiendo de sus requisitos de red:
3. Configuración
OmniSS7 puede funcionar en 5 modos operativos diferentes. El archivo de configuración config/runtime.exs contiene ejemplos completos y listos para usar.
Para cambiar de modo:
- Abra
config/runtime.exs - Descomente la sección de configuración deseada (STP, HLR, SMSc o CAMEL GW)
- Comente las otras secciones
- Actualice las direcciones IP y las URL de la API según sea necesario
- Reinicie la aplicación
→ Consulte las guías específicas del 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ística | Modo STP | Cliente MAP | Modo SMSc | Modo HLR | Gateway 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 | ❌ | ❌ | ❌ | ❌ | ✅ |
| Facturación en Tiempo Real | ❌ | ❌ | ❌ | ❌ | ✅ |
| Control de Llamadas (Servicios IN) | ❌ | ❌ | ❌ | ❌ | ✅ |
| Interfaz Web | ✅ | ✅ | ✅ | ✅ | ✅ |
| API REST | ✅ | ✅ | ✅ | ✅ | ✅ |
| 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 de pares 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
- Facturación 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 de API Interactiva - Interfaz Swagger para pruebas
- Métricas de Prometheus - Observabilidad completa
- Configuración Multi-rol - STP, Cliente MAP, SMSc, HLR, Gateway CAMEL
Resumen 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ítulos Globales
- NAT SCCP (Reutilización Inteligente de Títulos Globales)
- → Guía STP
Centro SMS (SMSc)
Entregar mensajes SMS a suscriptores móviles
- Entrega de MT-SMS
- Origen de MO-SMS
- Enrutamiento de SMS a Casa
- Ocultamiento de IMSI
- Cortafuegos 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
- Integración completa en OmniHSS
- → Guía HLR
Plataforma de Red Inteligente (Gateway CAMEL)
Control de llamadas y facturación en tiempo real para operadores de telecomunicaciones
- Facturación 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:
- Guía de Configuración STP - Enrutamiento del Punto de Transferencia de Señales
- Guía de Configuración del Cliente MAP - Cliente del protocolo MAP
- Guía de Configuración del Centro SMS - Enrutamiento y entrega de SMS
- Guía de Configuración HLR - Base de datos de suscriptores
- Guía de Configuración del Gateway CAMEL - Red inteligente y facturación
Integración y Referencia:
- Guía del Constructor de Solicitudes CAMEL - Herramienta de prueba interactiva
- Guía de Características Comunes - Componentes compartidos e interfaz web
- Referencia Técnica - Especificaciones del protocolo
Información de Contacto
Producto: OmniSS7
Fabricante: Omnitouch Network Services
Versión de Documentación: 2.0
Última Actualización: 2025
Para soporte técnico, asistencia en la implementación o consultas de ventas, comuníquese con Omnitouch Network Services.
Esta documentación cubre la operación en tiempo de ejecución de OmniSS7 y la funcionalidad para el usuario final. Para instalación, desarrollo o configuración avanzada, consulte la documentación técnica.