Subscription Management Interface (FT-1031.001)
About this document
Scope
This document provides background information as well as a functional description of the FT-1031.01 Subscription Management Interface add-on feature. The described feature is supported from the release version 2.0 onward.
Note
Subscription Management Interface is an add-on feature and requires a special license. Ensure that you have agreed with Mavoco about the usage of this feature before taking it into use.
This feature is part of the Single Pane of Glass functionality with number FN-1031.
Feature Availability
Feature Version | Available from | Summary of changes |
|---|---|---|
v1 | CMP Release 2.0 | Initial release |
Benefits
MAVOCO’s Overlay capability provides customers a Single Pane of Glass by aggregating multiple CMPs and MNO networks and abstracting the capabilities offered by every underlying system. This aggregation supports multinational customers and their supply chains by working across network operators in different countries and handling settlement between operators, even within and outside an operator group to give a single-supplier-experience to multinational IoT customers.
The Subscription Management interface feature comes with out-of-the-box plug-ins towards multiple carrier grade CMPs on the market. This offers our customers the flexibility they need to aggregate their current business into one single pane of glass for remote SIM provisioning and control.
Feature overview
Goals
The aim of the Subscription Management Interface feature is to provide an integration path for a full-featured MAVOCO CMP in relation to network control for remote SIM provisioning and control.
The following plug-ins are available:
MAVOCO CMP
Cisco Jasper Control Center
Aeris IoT Accelerator
Comarch CMP
Vodafone GDSP
Out of scope
eSIM and Multi-IMSI use cases
Functionality of the feature
3rd-party Platform Integration
3rd-party platform integration covers end to end use cases to enable CMP functionalities in relation to SIM provisioning and control.
Depending on the level of integration and available options at the 3rd party platform, all or just some of the demand functionalities might be available at CMP.
SIM Management Use Cases
UC.Nr | Use Case | Description | Additional Comment |
|---|---|---|---|
1 | Get SIM Details | To verify if the SIM does exist and has valid properties, before any change operation is allowed to be performed. | Depending on the provided details, CMP might verify the already set Communication Profile before trying to change it. This way, unnecessary provisioning requests and network overhead towards the Provisioning Gateway can be prevented. |
2 | Change SIM Status | To change the (billing) status of the SIM. | Depending on the remote system, CMP does change the (billing) status along with the CMP SIM status. |
3 | Change SIM Communication Profile | To control any Data, SMS and Voice services, APNs and Roaming Agreement of a SIM. | Depending on the remote system, a Communication Profile (aka. Communication Package, Subscription Package, …) is mapped within CMP and changed at the 3rd-party platform accordingly.
The Communication Profiles and their services have to be agreed during the integration design. |
4 | Perform SIM Cancel Location | To perform a Cancel Location / Refresh operation of a SIM. | This is an optional functionality of the Enterprise Portal, as part of the SIM diagnostics feature. |
5 | Get Communication Profile Details | To validate Communication Profile resources. | This is an optional functionality of the Overlay feature, to verify the validity and existence of a Communication Profile. CMP might request this list before trying to change a Communication Profile of a SIM or before allowing a User to activate a Communication Profile in the Resource Manager. Note: Feature Roadmap |
HLR/HSS/CRM Integration
The HLR/HSS/CRM integration covers end to end use cases to enable all available CMP functionalities in relation to SIM provisioning and control via the HLR/HSS or via CRM. Integration can be provided either directly to the HLR/HSS (or related middleware) or through BSS/CRM which does provide the required functionalities via API.
Depending on the level of integration and available options at the remote system, all or just some of the described functionalities might be available at CMP.
In general, CMP is flexible and each (or even all) use cases can be performed offline and locally on CMP only, in case the related integration or level of service is not available.
SIM Management Use Cases
UC.Nr | Use Case | Description | Additional Comment |
|---|---|---|---|
1 | Get SIM Details | To verify if the SIM does exist and got provisioned properly at HLR/HSS, before any change operation is allowed to be performed. | Depending on the provided details, CMP might verify the already set APN, Roaming Profile and Services before trying to change them. This way, unnecessary provisioning requests and network overhead towards the Provisioning Gateway can be prevented. |
2 | Change SIM Status | To change the (network) status of the SIM. | Depending on the remote setup, CMP might either directly control the SIM via the Network Status (IMSI active or equivalent; Subscriber is allowed to attach to the network or not) or something like a Billing Status (Active, Inactive, Suspend, …). Generally, preventing network attach might cause issues for some devices, so an equivalent of a Billing Status at the remote system is usually preferred. If not available, CMP might achieve the same behavior by just bar/unbar all services for a specific SIM. |
3 | Change SIM Service Set | To control any Data, SMS and Voice services of a SIM. | This is a standard functionality of the Enterprise Portal, and CMP maps the Service Profile to the individual services at the remote system. The available services have to be agreed during the integration design. |
4 | Change SIM Roaming Profile | To control the roaming agreement of a SIM. | This is a standard functionality of the Enterprise Portal and Price Plans, and CMP maps the Roaming Profile to an identifier at the remote system. The available roaming agreements have to be agreed during the integration design. |
5 | Change SIM APN(s) | To control the APNs and QoS Profiles assigned to a SIM. | This is a standard functionality of the Enterprise Portal, and CMP maps the APN(s) to an identifier at the remote system. The available APN(s) have to be agreed during the integration design. |
6 | Change SIM Static IP Address | To control the IP Address of a specific APN of a SIM. | This is an optional feature, in case CMP should be responsible to assign Static IPs from a configured pool. CMP does only provide this option, in case the IP has to be provisioned along the APN change by CMP itself. Further, CMP does offer a dedicated function to change the IP to a specific one on-demand, using the Resource Manager (Operator) or Enterprise Portal (Customer) applications. |
7 | Change SIM MSISDN | To control the MSISDN of a specific SIM. | This is an optional feature, in case CMP should be responsible to assign or change MSISDNs from a configured pool. |
8 | Perform SIM Cancel Location | To perform a Cancel Location / Refresh operation of a SIM. | This is an optional functionality of the Enterprise Portal, as part of the SIM diagnostics feature. |
9 | Perform SIM Swap | To perform a SIM Swap operation of a SIM. | This is an optional functionality of the Resource Manager, to perform a SIM Swap / Replace operation (swap two Subscribers, including all their profiles and attributes). Typical use cases to perform such operation are replacing a broken or stolen SIM. |
10 | Perform SIM Purge | To perform a SIM Purge / Delete operation of a SIM. | This is an optional functionality of the Resource Manager, to perform a SIM Purge / Delete operation as part of the Unassign & Purge operation in CMP. |
11 | Get APN Details | To validate APN resources. | This is an optional functionality of the Overlay feature, to verify the validity and existence of an APN. CMP might request this list before trying to change an APN of a SIM or before allowing a User to activate an APN in the Resource Manager. |
12 | Get QoS Details | To validate QoS resources. | This is an optional functionality of the Overlay feature, to verify the validity and existence of a QoS Profile. CMP might request this list before trying to change an APN of a SIM or before allowing a User to activate an QoS Profile in the Resource Manager. |
13 | Get Roaming Profile Details | To validate Roaming Agreement resources. | This is an optional functionality of the Overlay feature, to verify the validity and existence of a Roaming Profile. CMP might request this list before trying to change a Roaming Profile of a SIM or before allowing a User to activate a Roaming Profile in the Resource Manager. |
14 | Change SIM Security Profile | To update security restrictions as whitelist/blacklist for Voice, SMS and IMEI. | This is an optional functionality of the Resource Manager. |
15 | Activate SIM | To provision / activate a SIM. | This is an optional functionality of the Resource Manager, as part of the Purchase Order and/or SIM lifecycle. CMP does not store any security related data (like encryption keys), so the remote system has to store all required details and offer a simplistic function to trigger the remote SIM load and activation in HLR/HSS and/or BSS/CRM. |
CMP Platform Integration Matrix
UC.Nr | Use Case | Carrier Integration *1 | Overlay Integration | Overlay Integration | Overlay Integration | Overlay Integration | Overlay Integration | Overlay Integration |
|---|---|---|---|---|---|---|---|---|
1 | Get SIM Details | Yes | Partial | Partial | Partial | Partial | Partial | Yes |
2 | Change SIM Status | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
3 | Change SIM Service Set | Yes | Yes (indirect) *2 | Yes (indirect) *2 | Yes (indirect) *2 | Yes (indirect) *2 | Yes (indirect) *2 | Yes |
4 | Change SIM Roaming Profile | Yes | Yes (indirect) *2 | Yes (indirect) *2 | Yes (indirect) *2 | Yes (indirect) *2 | Yes (indirect) *2 | Yes |
5 | Change SIM APN(s) | Yes | Yes (indirect) *2 | Yes (indirect) *2 | Yes (indirect) *2 | Yes (indirect) *2 | Yes (indirect) *2 | Yes |
6 | Change SIM Static IP Address | Yes | Partial *3 | Partial *3 | Partial *3 | Partial *3 | Yes | Yes |
7 | Change SIM MSISDN | Yes | No | No | No | No | No | Yes |
8 | Perform SIM Cancel Location | Yes | Yes | No | Yes | No | No | Yes |
9 | Perform SIM Swap | Yes | No | No | No | No | No | Yes |
10 | Perform SIM Purge | Yes | No | No | No | No | Yes | Yes |
11 | Get APN Details | Yes | No | No | No | No | No | Yes |
12 | Get QoS Details | Yes | No | No | No | No | No | Yes |
13 | Get Roaming Profile Details | Yes | No | No | No | No | No | Yes |
14 | Change SIM Security Profile | Yes | No | No | No | No | No | Yes |
15 | Activate SIM | Yes | No | No | No | No | No | Yes |
*1 - Carrier Integration enables full set of CMP capabilities, but still depends on the availability of operator APIs to perform required operations directly at the Mobile Core or indirectly via BSS/CRM or others.
*2 - Changing Service Profiles, APNs and Roaming Profiles at 3rd party legacy Platforms can only be performed indirectly using their provided SIM Profile (Communication Profile, Service Package, Service Profile, etc.).
*3 - Changing the Static IP of a SIM at 3rd party legacy Platforms is normally not supported as such, but can be controlled using Radius based Session Control for example.