Oracle Communications Services Gatekeeper Subscription Management 1 2012

Oracle Communications Services Gatekeeper Subscription Management 1 | © 2012 Oracle Corporation | Confidential

Overview § This feature provides service subscription function by means of SMS text message and/or RESTful interface. § One subscriber is able to register for a push based application service to OCSG. § After that, the application as an OCSG WS client, will get the permission to use the WS API to provide service for subscriber. 2 Oracle Communications Services Gatekeeper 5. 1 TOI © 2013 Oracle Corporation – Proprietary and Confidential

Architecture overview 3 Oracle Communications Services Gatekeeper 5. 1 TOI © 2013 Oracle Corporation – Proprietary and Confidential

Deployment AT ext_handlers_1. wlng_at_app_subscription_rest. ear NT wlng_nt_app_subscription. ear 4 Oracle Communications Services Gatekeeper 5. 1 TOI © 2013 Oracle Corporation – Proprietary and Confidential

State transition 5 Oracle Communications Services Gatekeeper 5. 1 TOI © 2013 Oracle Corporation – Proprietary and Confidential

DB Table: app_sub_info 6 Column Description id Format of [subscriber@@app. Instance. Id] registration. Id Subscription identifier(UUID) subscriber Subscriber address application. Name Application service name expiry Subscription expire timestamp status Subscription status pending. Expiry Pending subscription expire timestamp app. Subscriptioninfo All subscription information, including access. Token, app. Instance. Id, together with above columns. Oracle Communications Services Gatekeeper 5. 1 TOI © 2013 Oracle Corporation – Proprietary and Confidential

RESTful Interfaces 7 Oracle Communications Services Gatekeeper 5. 1 TOI © 2013 Oracle Corporation – Proprietary and Confidential

Typical message flow – Create subscription 8 Oracle Communications Services Gatekeeper 5. 1 TOI © 2013 Oracle Corporation – Proprietary and Confidential

Typical message flow – App access CS 9 Oracle Communications Services Gatekeeper 5. 1 TOI © 2013 Oracle Corporation – Proprietary and Confidential

OAuth based validation 10 Oracle Communications Services Gatekeeper 5. 1 TOI © 2013 Oracle Corporation – Proprietary and Confidential

Subscription registration based validation 11 Oracle Communications Services Gatekeeper 5. 1 TOI © 2013 Oracle Corporation – Proprietary and Confidential

Configuration § MBean Interface – attributes Configurations related to SMSC, such as SMSC address, SMSC port etc. § MBean Interface - operations Operation 12 Description connect Connect to SMSC. load. App. Subcriptions. Xml Load Application Subscriptions configuration from XML content retrieve. App. Subscriptions. Xml Retrieve Application Subscriptions configuration XML content retrieve. App. Subscirptions. List Retrieve Application Subscriptions configuration detail content Oracle Communications Services Gatekeeper 5. 1 TOI © 2013 Oracle Corporation – Proprietary and Confidential

Configuration An XML configuration file is introduced to describe subscription information such as service number, application name, resource id and other properties, as provision data in OCSG. The file content is shared among OCSG servers and clusters. It is provisioned by Operations: load. App. Subcriptions. Xml. Here is an example of the configuration file. 13 Oracle Communications Services Gatekeeper 5. 1 TOI © 2013 Oracle Corporation – Proprietary and Confidential

Configuration Subscription management utilize existing OAuth access token management to simplify the process of application accessing communication services. To issue a valid access token for subscription, the value of "resource. Id" in subscription configuration file should be configured into OAuth module. operation location: MBean: OAuth 2 MBean OAuth. Service->OAuth. Resource. MBean->load. App. Subscription. Resource. Xml. Here is an example corresponding to the subscription configuration in previous slide. 14 Oracle Communications Services Gatekeeper 5. 1 TOI © 2013 Oracle Corporation – Proprietary and Confidential

Other features § Subscriber Authentication & Authorization All RESTful interfaces exposed to subscriber are protected by OAuth to avoid fake request. § Subscription channel customization Allowed subscription channel can be configured as SMS/REST/ALL. § Request quantity limitation To limit how many times a service can be triggered during a subscription’s lifecycle. § ACR When notifying application, it can hide real subscriber MSISDN by replacing it with ACR. § EDR fields Add optional EDR fields according to subscription configuration. 15 Oracle Communications Services Gatekeeper 5. 1 TOI © 2013 Oracle Corporation – Proprietary and Confidential