AAA - SPML Provisioning Command Guide Line v0.3

SPML PROVISIONING
COMMAND GUIDELINE
For One-AAA
Version 0.3
Date: 9/April/2012
This document is for an internal use of VMS project only.
Table of Contents
1.
Configuration Information .................................................................................................................... 4

1.1
URL Endpoint................................................................................................................................. 4
1.2
PGW IP Addresses ......................................................................................................................... 4
1.3
The WSDL file for Client ................................................................................................................ 4
1.4
The Schema file ............................................................................................................................. 4
1.5
Date Time Format ......................................................................................................................... 4
1.6
VMS New Services......................................................................................................................... 5
2. Gerneral SPML Commands (VIP Subscriber) ......................................................................................... 6
2.1
Add AAA subscriber (new subscriber)........................................................................................... 6
2.2
Add AAA subscriber to the existing subscriber ............................................................................. 6
2.3
Modify AAA service to the existing AAA subscriber ..................................................................... 7
2.4
Search the existing subscriber ...................................................................................................... 7
2.5
Remove AAA service from the existing subscriber ..................................................................... 10
2.6
Delete AAA subscriber ................................................................................................................ 10
2.7
VIP subscriber - Blackberry and/or M0 ....................................................................................... 11
2.8
VIP subscriber - Vietinbank ......................................................................................................... 12
2.9
VIP subscriber - Fsoft .................................................................................................................. 13
3. Provisioning Step Procedure (VIP Subscriber) .................................................................................... 14
3.1
Add AAA Service .......................................................................................................................... 14
3.2
Modify AAA Service..................................................................................................................... 14
3.3
Delete AAA Service...................................................................................................................... 14
4. Gerneral SPML Commands (OCSID) .................................................................................................... 15
4.1
Add the new MSISDN Range ....................................................................................................... 15
4.2
Modify OCSID to the existing MSISDN Range ............................................................................. 15
4.3
Search the existing MSISDN Range ............................................................................................. 16
4.4
Delete the MSISDN Range........................................................................................................... 16
5. Provisioning Step Procedure (OCSID) ................................................................................................. 17
5.1
Add the new MSISDN Range ....................................................................................................... 17
5.2
Modify OCSID to the existing MSISDN Range ............................................................................. 17
5.3
Delete the MSISDN Range........................................................................................................... 17
REVISION CONTROL
Version
0.1
Description
Initial draft
Editor
Sunun K
Date
08-Mar-2012
0.2
- Modified the delete AAA subscriber command

- Added the search request example
- Added the SPML command for VIP subscriber
Blackberry or M0
- Added the SPML command for VIP subscriber
Vietinbank
- Added Date and Time format information
Sunun K
04-Apr-2012
0.3
Added the SPML command for VIP subscriber - Fsoft
Sunun K
09-Apr-2012
1.
CONFIGURATION INFORMATION
1.1
URL Endpoint
http://<PGW-IP>:8081/ProvisioningGateway/services/SPMLUnifiedSubscriber10Service
https://<PGW-IP>:443/ProvisioningGateway/services/SPMLUnifiedSubscriber10Service
1.2
PGW IP Addresses
pgwhni01
pgwhni02
pgwhcm01
pgwhcm02
10.11.196.144
10.11.196.146
10.19.194.144
10.19.194.146
1.3
The WSDL file for Client
1.4
The Schema file
1.5
Date Time Format
Date and Time type in format yyyy '-' mm '-' dd 'T' hh ':' mm ':' ss timezone. The timezone is optional;
default value is 00:00 i.e. UTC.
For example: 2008-03-22T22:50:59
Timezone is duration with hour and minute properties in range -14:00 ... +14:00.
When a timezone is added to a UTC dateTime, the result is the date and time "in that timezone". For
example, 2002-10-10T12:00:00+05:00 is 2002-10-10T07:00:00Z and 2002-10-10T00:00:00+05:00 is
2002-10-09T19:00:00Z
1.6
VMS New Services
Gi cc
ServiceID
ServiceName
APN
TREC ID
Ch thch
9001
BB0
blackberry.net
Cc dch v chnh ca
Blackberry
gi mms, vo mt
s web ca TT VAS.
APN ny ang khai
tha rt nhiu service
trn NDS
Blackberry
3001
M0
m-wap
Vietinbank
8018
datavietin
vietinbank
Fsoft
8026
datasoft
m-wap
2.
GERNERAL SPML COMMANDS (VIP SUBSCRIBER)
2.1
Add AAA subscriber (new subscriber)

<spml:addRequest xmlns:spml="urn:siemens:names:prov:gw:SPML:2:0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="urn:siemens:names:prov:gw:UNIFIED_SUBSCRIBER:1:0 unified_subscriber1.0.xsd" language="en_us">
<version>UNIFIED_SUBSCRIBER_v10</version>
<object xmlns:sub="urn:siemens:names:prov:gw:UNIFIED_SUBSCRIBER:1:0"
xsi:type="sub:Subscriber">
<profile>
<givenName>noname</givenName>
<surname>nosurname</surname>
<username>MSISDN</username>
<password>123456</password>
<loginPassword>654321</loginPassword>
<prepaid>true</prepaid>
<roamingAllowed>true</roamingAllowed>
</profile>
<aaa>
<v2g3g>
<flagStatus>free</flagStatus>
<barringStatus>closed</barringStatus>
<profile>aaaProfile</profile>
<ip>1.1.1.1</ip>
<productCode>123</productCode>
<type>type</type>
<class>CLASS2G3G</class>
<provider>na</provider>
<service>SERVICE2G3G</service>
<accountGroup>b</accountGroup>
<poolGroup>na</poolGroup>
<classification>1</classification>
<status>closed</status>
<apnGroup>APNGROUP2G3G</apnGroup>
<uniqueId>uniqueId</uniqueId>
<msisdn>MSISDN</msisdn>
</v2g3g>
</aaa>
</object>
</spml:addRequest>
2.2
Add AAA subscriber to the existing subscriber

<spml:modifyRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:subscriber="urn:siemens:names:prov:gw:UNIFIED_SUBSCRIBER:1:0"
xsi:schemaLocation="urn:siemens:names:prov:gw:UNIFIED_SUBSCRIBER:1:0 unified_subscriber1.0.xsd" xmlns:spml="urn:siemens:names:prov:gw:SPML:2:0">
<objectclass>Subscriber</objectclass>
<identifier alias="msisdn" xsi:type="subscriber:AAAIdentifier">MSISDN</identifier>
<modification operation="addorset" scope="uniqueTypeMapping">
<valueObject xsi:type="subscriber:Profile">
</valueObject>
</modification>
<modification operation="addorset" scope="uniqueTypeMapping">
<valueObject xsi:type="subscriber:AAA">
<v2g3g>
<ip>1.1.1.1</ip>
<type>type</type>
</v2g3g>
</valueObject>
</modification>
</spml:modifyRequest>
2.3
Modify AAA service to the existing AAA subscriber

<modification operation="set" scope="uniqueTypeMapping">
<valueObject xsi:type="subscriber:V2G3G">
</valueObject>
</modification>
2.4
Search the existing subscriber

<spml:searchRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
<base >
<alias name="msisdn" xsi:type="subscriber:AAAAliasType" value="MSISDN"/>
</base>
</spml:searchRequest>
Examples of Search Request Responses are below.

a) Subscriber who has both AAA and PCS services
<spml:searchResponse executionTime="59" requestID="5a33f837:135eca0fb84:-7ff6"
result="success" searchStatus="completeResult"
xsi:schemaLocation="urn:siemens:names:prov:gw:UNIFIED_SUBSCRIBER:1:0 unified_subscriber1.0.xsd" xmlns:spml="urn:siemens:names:prov:gw:SPML:2:0"
xmlns:subscriber="urn:siemens:names:prov:gw:UNIFIED_SUBSCRIBER:1:0">
<objects xsi:type="ns2:Subscriber"
xmlns:ns2="urn:siemens:names:prov:gw:UNIFIED_SUBSCRIBER:1:0">
<identifier>129a8eb6-4064-4b19-b2d7-cd092397</identifier>
<profile>
<username>771226010035</username>
</profile>
<aaa>
<v2g3g>
<ip>1.1.1.1</ip>
<type>type</type>
<creationDate>2012-03-08T15:21:19Z</creationDate>
<msisdn>771226010035</msisdn>
</v2g3g>
</aaa>
<pcs>
<imsi>771119980000035</imsi>
<preferredDomain>NONE</preferredDomain>
<pcsService>
<serviceId>302</serviceId>
<serviceEnabled>true</serviceEnabled>
<usedQuota>555555555</usedQuota>
<usedUplinkQuota>0</usedUplinkQuota>
<usedDownlinkQuota>0</usedDownlinkQuota>
<usedTime>0</usedTime>
<accumulatedCharge>0</accumulatedCharge>
</pcsService>
<pricingPlan>mobileinternet</pricingPlan>
<httpFirstHomeUse>false</httpFirstHomeUse>
<httpFirstRoamingUse>false</httpFirstRoamingUse>
<userNotification>sms</userNotification>
<subscriberUsedTime>0</subscriberUsedTime>
<notificationThreshold>0</notificationThreshold>
<bspAccumulatedCharge>0</bspAccumulatedCharge>
<smsNotificationMsisdn>99999999999</smsNotificationMsisdn>
</pcs>
</objects>
</spml:searchResponse>
b) Subscriber who has only AAA service

<spml:searchResponse executionTime="53" requestID="-11e6eb83:135eca0ad4f:-7feb"
<profile>
<username>771226010035</username>
</profile>
<aaa>
<v2g3g>
<ip>1.1.1.1</ip>
<type>type</type>
<creationDate>2012-03-08T15:21:19Z</creationDate>
</v2g3g>
</aaa>
</objects>
a) Subscriber who has only PCS service

<spml:searchResponse executionTime="53" requestID="-11e6eb83:135eca0ad4f:-7feb"
<pcs>
<imsi>771119980000035</imsi>
<preferredDomain>NONE</preferredDomain>
<pcsService>
<serviceId>302</serviceId>
<serviceEnabled>true</serviceEnabled>
<usedTime>0</usedTime>
</pcsService>
<pricingPlan>mobileinternet</pricingPlan>
<httpFirstHomeUse>false</httpFirstHomeUse>
<httpFirstRoamingUse>false</httpFirstRoamingUse>
<userNotification>sms</userNotification>
<subscriberUsedTime>0</subscriberUsedTime>
<notificationThreshold>0</notificationThreshold>
<bspAccumulatedCharge>0</bspAccumulatedCharge>
<smsNotificationMsisdn>99999999999</smsNotificationMsisdn>
</pcs>
</objects>
2.5
Remove AAA service from the existing subscriber

<modification operation="remove" name="aaa"/>
<modification operation="remove" name="profile"/>
2.6
Delete AAA subscriber

<spml:deleteRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
</spml:deleteRequest>
Caution: This SPML command will delete all services (PCS and AAA) of this subscriber, then
delete this subscriber from One-NDS.
2.7
VIP subscriber - Blackberry and/or M0

<profile>
</profile>
<aaa>
<v2g3g>
<ip>1.1.1.1</ip>
<type>type</type>
<class>9|9</class>
<service>BB0|M0</service>
<apnGroup>blackberry.net|m-wap</apnGroup>
</v2g3g>
</aaa>
</object>
</spml:addRequest>
2.8
VIP subscriber - Vietinbank

<profile>
</profile>
<aaa>
<v2g3g>
<ip>1.1.1.1</ip>
<type>type</type>
<class>9</class>
<service>datavietin</service>
<apnGroup>vietinbank</apnGroup>
</v2g3g>
</aaa>
</object>
</spml:addRequest>
2.9
VIP subscriber - Fsoft

<profile>
</profile>
<aaa>
<v2g3g>
<ip>1.1.1.1</ip>
<type>type</type>
<class>9</class>
<service>datasoft</service>
<apnGroup>m-wap</apnGroup>
</v2g3g>
</aaa>
</object>
</spml:addRequest>
3.
PROVISIONING STEP PROCEDURE (VIP SUBSCRIBER)
3.1
Add AAA Service

1. Check the MSISDN number whether the subscriber is already existing or not. By using the SPML
command 2.4 Search the existing subscriber
If found, go to step 2
If not found, go to step 3
2. If the subscriber is already existent, then use the SPML command 2.2 Add AAA subscriber to
the existing subscriber
3. If the subscriber is NOT existent, then use the SPML command 2.1 Add AAA subscriber (new
subscriber)
3.2
Modify AAA Service

2. If the subscriber is already existent, then use the SPML command 2.3 Modify AAA service to
the existing AAA subscriber
3. If the subscriber is NOT existent, then do nothing
3.3
Delete AAA Service

2. If the subscriber is already existent with both PCS and AAA services, then use the SPML
command 2.5 Remove AAA service from the existing subscriber
3. If the subscriber is already existent with ONLY AAA services, then use the command 2.6 Delete
AAA subscriber
4. If the subscriber is NOT existent, then do nothing
4.
GERNERAL SPML COMMANDS (OCSID)
4.1
Add the new MSISDN Range

xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
xsi:schemaLocation="urn:siemens:names:prov:gw:UNIFIED_SUBSCRIBER:1:0
unified_subscriber-1.0.xsd" language="en_us">
<profile>
<givenName>msisdnrange</givenName>
<surname>msisdnrange</surname>
<username>MSISDN-RANGE</username>
</profile>
<aaa>
<v2g3g>
<profile>OCSProfile</profile>
<ip>1.1.1.1</ip>
<type>type</type>
<class>1</class>
<provider>OCSProvider</provider>
<service>na</service>
<accountGroup>na</accountGroup>
<poolGroup>OCSID</poolGroup>
<apnGroup>na</apnGroup>
<msisdn>MSISDN-RANGE</msisdn>
</v2g3g>
</aaa>
</object>
</spml:addRequest>
4.2
Modify OCSID to the existing MSISDN Range

<identifier alias="msisdn" xsi:type="subscriber:AAAIdentifier">MSISDN-RANGE</identifier>
<modification operation="set" scope="uniqueTypeMapping">
<valueObject xsi:type="subscriber:V2G3G">
<poolGroup>OCSID</poolGroup>
</valueObject>
</modification>
4.3
Search the existing MSISDN Range

<spml:searchRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
<base >
<alias name="msisdn" xsi:type="subscriber:AAAAliasType" value="MSISDN-RANGE"/>
</base>
</spml:searchRequest>
4.4
Delete the MSISDN Range

<spml:deleteRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
<identifier alias="msisdn" xsi:type="subscriber:AAAIdentifier">MSISDN-RANGE</identifier>
</spml:deleteRequest>
5.
PROVISIONING STEP PROCEDURE (OCSID)
5.1
Add the new MSISDN Range

1. Check the MSISDN range whether this MSISDN range is already existing or not. By using the
SPML command 4.3 Search the existing MSISDN Range
2. If the MSISDN range is already existent, then do nothing. Verifying that the data is correct or
not.
3. If the subscriber is NOT existent, then use the SPML command 4.1 Add the new MSISDN Range
5.2
Modify OCSID to the existing MSISDN Range

2. If the MSISDN range is already existent, then use the SPML command 4.2 Modify OCSID to the
existing MSISDN Range.
3. If the MSISDN range is NOT existent, then do nothing
5.3
Delete the MSISDN Range

2. If the MSISDN range is already existent, then use the SPML command 4.4 Delete the MSISDN
Range
3. If the MSISDN range is NOT existent, then do nothing

AAA - SPML Provisioning Command Guide Line v0.3

Transféré par

Informations du document

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

AAA - SPML Provisioning Command Guide Line v0.3

Transféré par

Droits d'auteur :

Formats disponibles

SPML PROVISIONING

This document is for an internal use of VMS project only.

Configuration Information .................................................................................................................... 4

- Modified the delete AAA subscriber command

Added the SPML command for VIP subscriber - Fsoft

The WSDL file for Client

The Schema file

Date Time Format

VMS New Services

GERNERAL SPML COMMANDS (VIP SUBSCRIBER)

Add AAA subscriber (new subscriber)

Add AAA subscriber to the existing subscriber

Modify AAA service to the existing AAA subscriber

Search the existing subscriber

Examples of Search Request Responses are below.

b) Subscriber who has only AAA service

a) Subscriber who has only PCS service

Remove AAA service from the existing subscriber

Delete AAA subscriber

VIP subscriber - Blackberry and/or M0

VIP subscriber - Vietinbank

VIP subscriber - Fsoft

PROVISIONING STEP PROCEDURE (VIP SUBSCRIBER)

Add AAA Service

Modify AAA Service

Delete AAA Service

GERNERAL SPML COMMANDS (OCSID)

Add the new MSISDN Range

Modify OCSID to the existing MSISDN Range

Search the existing MSISDN Range

Delete the MSISDN Range

PROVISIONING STEP PROCEDURE (OCSID)

Add the new MSISDN Range

Modify OCSID to the existing MSISDN Range

Delete the MSISDN Range

Vous aimerez peut-être aussi