General search
Tags
Apply
Entitlement server

This section explains Entitlement Servers, their role in modern operator networks, how they interact with devices (especially Apple & Samsung), and how they support eSIM activation and advanced features. 

This documentation is designed for: 

  • Mobile Network Operators (MNOs & MVNOs) 
  • OEM partners 
  • Operator Support & Technical Teams 
  • Engineering & Integration Teams 
  • Analysts and Internal Valid Teams 
4.1
INTRODUCTION TO ENTITLEMENT

What is an Entitlement Server? 

A Device Entitlement Server is a core network function that ensures a device is authorized to use specific operator services and advanced features. 

It is required for: 

  • VoLTE (Voice over LTE) 
  • VoWiFi (Wi-Fi Calling) 
  • 5G Access Validation 
  • Hotspot / Tethering Authorization 
  • SMS/IMS Services on Companion Devices 
  • Smartwatch LTE service 
  • eSIM Activation Entitlement 

In simple terms, the Entitlement Server tells a device: 

“Yes, you are allowed to use this feature on this network.” 

Why Operators Need It 

Modern devices (Apple, Samsung, etc.) will not enable certain features unless the operator validates eligibility through a standardized entitlement flow. 

This protects: 

  • Service integrity 
  • Operator policies 
  • Subscription eligibility 
  • Device compatibility 
  • Fraud prevention 
Who Uses It 
  • Consumer smartphone users 
  • Wearable users (Apple Watch, Samsung Watch) 
  • eSIM customers 
  • Postpaid & prepaid subscribers 
  • IoT wearables (future use cases) 
Mandatory vs Optional Entitlements

Entitlement requirements vary by OEM. Apple devices always require an Entitlement Server for services such as VoLTE, VoWiFi, 5G SA, and multi-SIM. Many Samsung devices also enforce entitlement for these services. However, some Android OEMs do not require entitlement for VoLTE or VoWiFi activation, depending on firmware and operator configuration. 

4.2
SUPPORTED ENTITLEMENT FEATURES

The Entitlement Server handles multiple categories of authorization. 

VoLTE Entitlement

Enables VoLTE calling, requiring: 

  • IMS registration 
  • Correct subscription setup 
  • Valid device model 
  • Operator approval 
VoWiFi Entitlement

Authorizes devices to use Wi-Fi Calling based on: 

  • Network availability 
  • Device capability 
  • Subscription configuration 
5G Entitlement

Controls whether a device is allowed to attach to 5G networks based on: 

  • Plan eligibility 
  • Operator policy 
  • Device model 
eSIM Activation Entitlement

Apple and Samsung require entitlement checks to verify: 

  • User identity 
  • Subscription rights 
  • Network compatibility 
  • EID/IMEI pairing 
  • Capability to download a companion profile (watch pairing) 
Hotspot / Tethering Entitlement

Authorizes whether a device can share its data connection. 

Companion Device Entitlement

Used extensively for: 

  • Apple Watch 
  • Samsung Galaxy Watch 
  • WearOS devices 
  • Other future connected companion devices 

This entitlement checks: 

  • Device pairing 
  • Subscriber rights 
  • Device-model support 
  • Plan compatibility 
4.3
ENTITLEMENT SERVER ARCHITECTURE

The entitlement ecosystem consists of several interacting components. 

Device (Client)

The smartphone or companion device that: 

  • Sends entitlement requests 
  • Validates policies 
  • Logs into operator systems (Apple/Google/Samsung) 
  • Retrieves configuration files 
Entitlement Server

A backend system that: 

  • Validates subscriber information 
  • Checks device model 
  • Confirms service eligibility 
  • Generates configuration for the device 
  • Interacts with operator databases 
Operator Systems / Databases

Typically includes: 

  • HLR/HSS/UDM 
  • IMS Core 
  • Provisioning System 
  • Billing/CRM 
  • Authentication servers 

These systems confirm: 

  • Whether the subscriber is allowed to use VoLTE/VoWiFi/5G 
  • Whether the device is compatible 
  • Whether the plan includes these features 
OEM Ecosystem

When dealing with Apple or Samsung: 

Apple Entitlement Flow 

Relies on: 

  • Apple Push Notification Service (APNS) 
  • Apple Entitlement Client 
  • Carrier Bundle 
  • Apple Watch pairing logic 
Note

Apple devices require a valid APNS registration to complete entitlement flows; if APNS registration fails, the device cannot activate services such as VoLTE, VoWiFi, eSIM activation and watch pairing.

Samsung Entitlement Flow 

Uses: 

  • Samsung proprietary entitlement endpoints 
  • IMS configuration protocols 
Network Elements

Such as: 

  • IMS core 
  • EPC/5GC 
  • Authentication gateways 
  • APNs 
4.4
ENTITLEMENT WORKFLOWS

Each entitlement type has a distinct workflow. 

Below are the full descriptions. 

VoLTE Entitlement Workflow
  1. Device sends entitlement request
  2. Entitlement Server checks:
    subscription eligibility
    device model support
    IMS provisioning state
  3. Server responds with configuration 
  4. Device configures IMS settings
  5. Device registers for VoLTE 

If any part fails, VoLTE will not be enabled. 

VoLTE Entitlement Workflow
  1. Device sends entitlement request
  2. Entitlement Server checks:
    subscription eligibility
    device model support
    IMS provisioning state
  3. Server responds with configuration 
  4. Device configures IMS settings 
  5. Device registers for VoLTE 

If any part fails, VoLTE will not be enabled. 

VoWiFi Entitlement Workflow
  1. Device triggers entitlement request after Wi-Fi attachment
  2. Server validates:
    plan
    device capability
    roaming permissions
  3. Server sends Wi-Fi Calling configuration 
  4. Device registers over IMS via Wi-Fi 
5G Entitlement Workflow

Triggered when connecting to a 5G network. 

Flow: 

  1. Device requests entitlement 
  2. Server checks 5G subscription rights 
  3. Server returns authorization or denial 
  4. Device enables/disables 5G support 
eSIM Entitlement Workflow (Critical for Apple & WearOS)

For eSIM activation: 

  1. Device requests entitlement configuration
  2. Server validates:
    MSISDN/IMSI ownership
    EID/IMEI linking
    Plan eligibility
    Device model compatibility
  3. Server sends entitlement token
  4. Device proceeds with eSIM activation
  5. RSP download occurs via SM-DP+ 

Without entitlement approval activation fails, even if SM-DP+ is correct. 

4.5
SMARTWATCH & COMPANION DEVICE ENTITLEMENT

Wearables rely heavily on entitlement logic. 

APPLE WATCH PAIRING (LTE Service)

The flow is highly structured: 

  1. iPhone initiates pairing 
  2. iPhone requests entitlement from operator 
  3. Server validates:
    subscription
    account status
    device model 
  4. Entitlement Server communicates with Apple services 
  5. eSIM profile is prepared 
  6. Watch downloads profile via SM-DP+ 
  7. Entitlement Server sends Watch-specific IMS settings 
  8. Watch attaches to network 

If entitlement fails: 

  • The “Set up Mobile Service” screen will show an error 
  • Watch will not receive an eSIM 
SAMSUNG / WEAROS WATCH ENTITLEMENT

Similar sequence: 

  1. Smartphone requests entitlement 
  2. Server validates device 
  3. Profile is prepared 
  4. Watch downloads via RSP 
  5. Device receives IMS settings 

Entitlement ensures: 

  • Device is allowed 
  • Subscription includes watch support 
  • Correct provisioning flows are used 
4.6
OPERATOR INTEGRATION (FULL DETAILS)

Operators must integrate several backend elements. 

Subscription Validation

The Entitlement Server must query operator systems: 

  • HLR/HSS 
  • UDM 
  • CRM 
  • Billing 
  • Provisioning systems 

It checks: 

  • Is subscriber allowed to use feature X? 
  • Does plan support VoLTE / VoWiFi / 5G / eSIM Watch? 
  • Is device compatible? 
Device Information Checks

The server validates: 

  • IMEI 
  • EID 
  • Device model 
  • Supported features 
Authentication Mechanisms

Entitlement uses: 

  • OAuth tokens 
  • Operator subscriber authentication 
  • Secure device-to-server signaling 
  • TLS encryption 
Operator Policy Enforcement

Examples: 

  • VoWiFi allowed only for postpaid 
  • Watch pairing allowed only for certain plans 
  • 5G allowed only in specific regions 
Logging & Monitoring

The Entitlement Server should record: 

  • Device checks 
  • Subscriber validation outcomes 
  • Error types 
  • Configuration requests 
4.7
ENTITLEMENT TROUBLESHOOTING
Device Says “Plan Not Eligible”

Causes: 

  • Incorrect subscriber provisioning 
  • CRM mismatch 
  • Plan restrictions 

Resolution: 

  • Update subscriber plan 
  • Trigger backend sync 
  • Retry entitlement request 
VoLTE Not Working

Causes: 

  • IMS misconfiguration 
  • Entitlement denial 
  • Device compatibility issues 

Resolution: 

  • Verify IMS settings 
  • Check VoLTE entitlement logs 
  • Update carrier bundle for Apple/Samsung devices 
Smartwatch Cannot Download eSIM

Causes: 

  • Missing eSIM entitlement 
  • EID mismatch 
  • MSISDN not authorized for pairing 

Resolution: 

  • Re-register subscriber in Entitlement Server 
  • Validate EID/IMEI 
  • Ensure plan supports watch service 
eSIM Activation Fails on iPhone

Common reasons: 

  • Entitlement service offline 
  • Device not authenticated 
  • Operator plan not matching 
  • EID authorization missing 

Resolution: 

  • Restart entitlement backend 
  • Verify subscriber provisioning 
  • Update plan eligibility 
5G Not Enabled on Device

Causes: 

  • No 5G entitlement 
  • Device model mismatch 
  • Network coverage constraint 

Resolution: 

  • Enable 5G in CRM 
  • Validate device 5G support 
  • Re-trigger entitlement 
4.8
SECURITY & COMPLIANCE

The Entitlement Server must comply with: 

  • GSMA eSIM requirements 
  • OEM entitlement specifications (Apple/Samsung) 
  • Carrier policy rules 
  • TLS security standards 
  • GDPR and privacy frameworks 
  • Device manufacturer certification 

Security mechanisms include: 

  • Token-based client authentication 
  • End-to-end encryption 
  • Integrity checks 
  • Preventing unauthorized feature access 
  • Protecting network resources 
4.9
OPERATIONAL BEST PRACTICES
  1. MaintainAccurate Subscriber Databases 

Entitlement failures almost always originate from: 

  • Outdated CRM data 
  • Incorrect billing configurations 
  • Broken provisioning workflows 
  1. Keep Device Compatibility Lists Updated

Especially important for: 

  • Apple Watch 
  • Samsung WearOS 
  • 5G handset models 
  1. Monitor Logs Continuously

Entitlement logs provide: 

  • Failure patterns 
  • Device request trends 
  • Feature adoption metrics 
  1. ValidateAgainst OEM Requirements 

Apple and Samsung update entitlement requirements regularly. 

  1. Keep Carrier Configuration Files Updated

Especially important for Apple iOS carrier bundles.