OmniSS7 - Guía del Usuario

OmniSS7 de Omnitouch Network Services es una pila de señalización SS7 completa y de propósito general que proporciona funcionalidad flexible de elementos de red.

Visión General del Enrutamiento

Visió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
- Enrutamiento de 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 de SMS (SMSc)
- Enrutamiento y entrega de mensajes SMS
- Cola de mensajes respaldada por base de datos
- Auto-vaciado e informes de entrega
- Utilice esto si está operando un Centro de 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 cobro
- Integración de CGrateS para facturación
- Constructor de solicitudes interactivas y monitoreo de sesiones
- Utilice esto si está proporcionando servicios IN o cobro en tiempo real
Guía del Gateway USSD - Configuraci��n del Gateway USSD
- Puente USSD SS7/MAP a callbacks HTTP/JSON
- Menús USSD interactivos de múltiples turnos
- Enrutamiento de código corto 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.)

🔧 Funciones Comunes

Guía de Funciones Comunes - Componentes Compartidos
- Visión general 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. Visión General del Sistema

OmniSS7 puede operar en diferentes modos dependiendo de los requisitos de su red:

3. Configuración

OmniSS7 selecciona su rol de un conjunto de banderas de modo en config/config.exs. Las banderas se componen, por lo que una sola instancia puede actuar como varios roles a la vez (por ejemplo, Cliente MAP más SMSc).

Nota: config/runtime.exs en este repositorio es un breve stub de prueba. Los servidores de producción tienen su propio runtime.exs desplegado por separado. Edite config/config.exs (y el archivo específico del entorno que importa) para cambiar la configuración predeterminada.

Para seleccionar un rol:

Establezca las banderas de modo relevantes en config/config.exs
Configure la conexión M3UA (map_client_m3ua o cap_client_m3ua) y cualquier URL de API de backend
Reinicie la aplicación

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

Modo STP — enrutamiento de tráfico 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: %{...}

Consulte la Referencia de Configuración para cada parámetro, incluida la Gateway USSD (ussd_gateway_enabled).

4. Acceso a la Interfaz Web

La interfaz web se sirve a través de HTTPS en el puerto 8087 — por ejemplo https://localhost:8087/ (o su host configurado). El endpoint aplica TLS, por lo que http:// se redirige.

Arquitectura del Sistema

Matriz de Funciones

Función	Modo STP	Cliente MAP	Modo SMSc	Modo HLR	GW 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-Vaciado de SMS	❌	❌	✅	❌	❌
Base de Datos de Suscriptores	❌	❌	❌	✅	❌
Vectores de Autenticación	❌	❌	❌	✅	❌
Actualizaciones de Ubicación	❌	❌	❌	✅	❌
Soporte CAP/CAMEL	❌	❌	❌	❌	✅
Cobro en Tiempo Real	❌	❌	❌	❌	✅
Control de Llamadas (Servicios IN)	❌	❌	❌	❌	✅
Interfaz Web	✅	✅	✅	✅	✅
API REST	✅	✅	✅	✅	✅
Métricas Prometheus	✅	✅	✅	✅	✅

Operaciones Comunes

OmniSS7 escucha en varios puertos, cada uno sirviendo una superficie diferente:

Puerto	Protocolo	Servido por	Propósito
`8087`	HTTPS	ControlPanel (Phoenix)	Panel web (TLS aplicado)
`8445`	HTTPS	api_ex	API de estado JSON (`/api/status`, `/api/m3ua-status`, `/api/routing`, …)
`8080`	HTTP	APIhandler (Plug.Cowboy)	API de operación MAP (`/api/*`), Interfaz Swagger (`/swagger`), especificación OpenAPI (`/swagger.json`), métricas de Prometheus (`/metrics`)
`2905`	SCTP	M3UA/M2PA	Transporte de señalización SS7

Acceso a la Interfaz Web

Interfaz Web: https://localhost:8087/ (o host configurado)
Interfaz Swagger: http://localhost:8080/swagger
Especificación OpenAPI: http://localhost:8080/swagger.json
Métricas: http://localhost:8080/metrics

Monitoreo

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

# Verificar estado de pares M3UA (TLS, certificado autofirmado)
curl -k https://localhost:8445/api/m3ua-status

# Estado del servicio
curl -k https://localhost:8445/api/status

Registros

Los registros se emiten como JSON estructurado (un objeto por línea) para la ingestión por Loki/Alloy, a través de OmniLogger.JsonFormatter. Establezca el nivel de registro en config/config.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
Cobro en Tiempo Real - Integración de CGrateS para facturación prepago/postpago
Entrega de SMS - Cola de mensajes respaldada por HTTP/JSON con auto-vaciado
Constructor de Solicitudes Interactivas - Interfaz web para pruebas de 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 Prometheus - Observabilidad completa
Configuración Multi-rol - STP, Cliente MAP, SMSc, HLR, Gateway CAMEL, Gateway USSD

Visió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 de SMS en el hogar
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 API RESTful simple

PRN / SRI / ATI / etc.
Construya sus propias aplicaciones SS7/MAP utilizando APIs RESTful
Gateways USSD
Solicitudes de vectores de autenticación
Consultas 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 y cobro en tiempo real para operadores de telecomunicaciones

Cobro de llamadas prepago/postpago
Control de llamadas (conectar, liberar, enrutamiento)
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 cobro

Integración y Referencia:

Guía del Constructor de Solicitudes CAMEL - Herramienta de prueba interactiva
Guía de Funciones Comunes - Componentes compartidos e interfaz web
Referencia Técnica - Especificaciones de protocolo

Visión General de la Documentación​

📚 Guías de Configuración​

🔧 Funciones Comunes​

📖 Documentación de Referencia​

Inicio Rápido​

1. Visión General del Sistema​

3. Configuración​

4. Acceso a la Interfaz Web​

Arquitectura del Sistema​

Matriz de Funciones​

Operaciones Comunes​

Acceso a la Interfaz Web​

Monitoreo​

Registros​

Capacidades Clave​

Visión General de la Pila de Protocolo​

Ejemplos de Casos de Uso​

Gateway de Red (STP)​

Centro SMS (SMSc)​

Cliente MAP​

Base de Datos de Suscriptores (HLR)​

Plataforma de Red Inteligente (Gateway CAMEL)​

Soporte y Recursos​

Documentación​