Saltar al contenido principal

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.

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

    • Rote el 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

    • Conéctese 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
    • Generador 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 SS7/MAP USSD a callbacks HTTP/JSON
    • Menús USSD interactivos de múltiples turnos
    • Enrutamiento de códigos cortos a diferentes URL de callbacks
    • 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 transacción TCAP
    • Codificaciones y formatos de caracteres

🧭 Ejemplos de Enrutamiento de Títulos Globales​

Inicio Rápido​

1. Descripció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:

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

→ Consulte las guías específicas del 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:// plano es redirigido.

Arquitectura del Sistema​

Matriz de Características​

CaracterísticaModo STPCliente MAPModo SMScModo HLRGW 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 SMS❌❌✅❌❌
Auto-Vaciado 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 de Prometheus✅✅✅✅✅

Operaciones Comunes​

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

PuertoProtocoloServido porPropósito
8087HTTPSControlPanel (Phoenix)Panel de UI Web (TLS aplicado)
8445HTTPSapi_exAPI de estado JSON (/api/status, /api/m3ua-status, /api/routing, …)
9090HTTPAPIhandler (Plug.Cowboy)API de operación MAP (/api/*), Swagger UI (/swagger), especificación OpenAPI (/swagger.json), métricas de Prometheus (/metrics)
2905SCTPM3UA/M2PATransporte de señalización SS7

Acceso a la Interfaz Web​

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

Monitoreo​

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

# Verificar estado del par 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 Fase 2/3 de MAP
  • 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
  • Generador 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 - Swagger UI para pruebas
  • Métricas de Prometheus - Observabilidad completa
  • Configuración Multi-rol - STP, Cliente MAP, SMSc, HLR, Gateway CAMEL, Gateway USSD

Descripción General de la Pila de Protocolo​

Ejemplos de Casos de Uso​

Gateway de Red (STP)​

Rote el 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 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 cobro para operadores de telecomunicaciones

  • Cobro de llamadas prepago/postpago
  • Control de llamadas (conectar, liberar, enrutamiento)
  • Gestión de sesiones y generación de CDR
  • Generador 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