Skip to main content

OmniSEP - Service Endpoint Platform

OmniSEP is a unified service endpoint platform providing carrier-grade implementations of mobile device provisioning protocols. It handles TS.43 Entitlement Configuration, XCAP Supplementary Services, and Visual Voicemail from a single platform.

Operations & Monitoring​

Service Documentation​

  • TS.43 Entitlements - GSMA TS.43 Service Entitlement Configuration
  • XCAP Simservs - ETSI TS 183 023 Supplementary Services (Call Forwarding, Call Barring, Caller ID)
  • Visual Voicemail - OMTP VVM v1.3 / GSMA TS.46 Visual Voicemail Server

Architecture Overview​

Supported Services​

TS.43 Entitlement Configuration​

Implements GSMA TS.43 for device service entitlement queries:

App IDServiceDescription
ap2003Voice-over-CellularVoLTE/VoNR entitlement status
ap2004VoWiFiVoice over WiFi calling entitlement
ap2005SMSoIPSMS over IP entitlement
ap2006ODSA CompanionOn-Device Service Activation (companion)
ap2009ODSA PrimaryOn-Device Service Activation (primary)
ap2010Data Plan BoostData plan information
ap2012Direct Carrier BillingDCB service status
ap2016Satellite ModeSatellite connectivity entitlement

XCAP Supplementary Services​

Implements ETSI TS 183 023 for IMS supplementary service configuration:

ServiceDescriptionReference
Communication DiversionCall forwarding (CFU, CFB, CFNA, CFNRC)ETSI TS 183 004
Incoming Call BarringBlock incoming calls by typeETSI TS 183 023
Outgoing Call BarringBlock outgoing calls by typeETSI TS 183 023
OIP/OIRCaller ID presentation and restrictionETSI TS 183 023

Visual Voicemail​

Implements OMTP VVM Specification v1.3 and GSMA TS.46:

ComponentDescriptionReference
IMAP ServerMessage retrieval and managementRFC 3501
SMS ProtocolSYNC/STATUS provisioning messagesOMTP VVM v1.3
Greeting ManagementPersonal and extended absence greetingsGSMA TS.46
TranscriptionVoicemail-to-text supportOMTP VVM v1.3

Endpoints Overview​

EndpointMethodDescription
/GET/POSTTS.43 Entitlement queries
/simservs.ngn.etsi.org/users/{sip}/simservs.xmlGET/PUTFull XCAP document operations
/simservs.ngn.etsi.org/users/{sip}/simservs.xml/~~/{xpath}GET/PUT/DELETEXCAP element operations
/api/activityGETActivity log search
/api/entitlements/{imsi}GET/POSTEntitlement management
/api/xcap/{msisdn}GET/POSTXCAP profile management
/healthGETHealth check

Web UI​

OmniSEP includes a real-time web interface for monitoring and management, built with Phoenix LiveView. Access the UI at http://<host>:9014/.

XCAP Profile Management

XCAP Simservs Profile management showing subscriber supplementary services configuration

Dashboards​

DashboardPathDescription
Status/System health, service status, memory usage, storage statistics
Entitlements/entitlementsView and manage TS.43 custom entitlements by IMSI
Sessions/sessionsMonitor EAP-AKA sessions and active authentication tokens
Activity/activityBrowse TS.43 activity logs with filtering and pagination
XCAP Profiles/xcapManage XCAP Simservs profiles, sync with HSS
Diameter/diameterMonitor Diameter peer connections and status
Logs/logsReal-time system log viewer with level filtering

Status Dashboard​

The main status dashboard provides at-a-glance system health:

  • Service Status: HTTP server, EAP-AKA, VVM service indicators
  • Storage Counters: Entitlements, XCAP profiles, sessions, tokens, activity records
  • Memory Usage: Total, process, and ETS memory breakdown
  • Uptime: System uptime display

All metrics auto-refresh every 5 seconds.

XCAP Profile Management​

The XCAP dashboard allows operators to:

  • Search and view subscriber profiles by MSISDN
  • Edit supplementary service settings (OIP/OIR, call forwarding, call barring)
  • Pull profiles from HSS via Diameter Sh interface
  • Push local changes back to HSS
  • View modification metadata (timestamp, client IP, User-Agent)

Activity Monitoring​

The activity dashboard provides real-time visibility into all device requests:

Activity Log

Activity log showing XCAP and entitlement requests with request/response details

Features:

  • Filter by request type (XCAP, Entitlement Query, EAP Challenge, etc.)
  • Search by IMSI, MSISDN, Terminal ID, or Client IP
  • View detailed request/response data including headers, body, and path
  • Track HTTP method and response status codes

Session Monitoring​

The sessions dashboard displays:

  • Sessions Tab: Active EAP-AKA sessions with state (pending, challenge_sent, authenticated, failed)
  • Tokens Tab: Active authentication tokens with time remaining until expiry

Both views support manual session/token revocation.

Authentication Flow​

Quick Start Configuration​

Minimal Configuration​

# config/config.exs
import Config

config :omni_sep,
  http_port: 9014,
  http_ip: {0, 0, 0, 0},
  server_fqdn: "sep.mnc001.mcc001.pub.3gppnetwork.org",
  entitlement_version: "2.0"

# Default entitlements for all subscribers
config :omni_sep, :default_entitlements,
  vowifi: %{
    entitlement_status: 1,
    addr_status: 2,
    tc_status: 2,
    prov_status: 1
  },
  volte: %{
    entries: [
      %{access_type: 1, home_roaming_nw_type: 1, entitlement_status: 1}
    ]
  }

# Token settings
config :omni_sep, :token,
  validity_seconds: 86400,
  signing_secret: "your-production-secret-here"

# EAP-AKA settings
config :omni_sep, :eap_aka,
  enabled: true,
  session_timeout_ms: 30_000

See Configuration Reference for complete parameter documentation.

Documentation Structure​

By Role​

Network Operators:

  1. Start with this overview
  2. Review Configuration Reference for deployment settings
  3. Review Troubleshooting for common issues

Service Configuration:

  1. TS.43 Entitlements for VoWiFi/VoLTE provisioning
  2. XCAP Simservs for call forwarding/barring

Troubleshooting:

  1. Troubleshooting Guide for common issues
  2. Check Activity Logging for request tracking

By Protocol​

GSMA TS.43:

ETSI XCAP: