|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Defines the methods offered by the Wireless Validation Interface (WVI). Supports actions for authentication and verification of clients and subscribers.
Subsbcriber Verification
Many of the methods offered by Location Studio are sensitive in respect to integrity and privacy.
Before allowing a client to, for instance, position a specific msisdn, it is important that
the holder of the msisdn agrees to be positioned.
Location Studio does this by not acting on a msisdn as input for sensitive operations. Instead, a client
is required to supply a special id - a Persistant Subscriber ID, PSID - that represents the subscriber
to be, for instance, positioned.
The method for obtaining the PSID ensures that the holder of the msisdn is involved.
The methods initiateVerifySubscriber and completeVerifySubscriber togheter implements this algorithm.
The client invokes initiateVerifySubscriber with a msisdn and a message as parameters. Location Studio
generates a code and sends that together with the message to the msisdn. A temporary id (verificationAlias)
is returned to the client.
Now the msisdn holder is suppose to supply the code to the client application, wich takes the code and
the verificationAlias and calls completeVerifySubscriber with them as parameters. If the code is the
one generated together with the verification alias, Location Studio knows that the msisdn holder has
supplied it to the client, and PSID is returned from the call.
A client can remove the relation between itself and a subscriber by calling removeSubscriberFromClient().
Subscriber Validation
Subscriber validation is process of checking the type and status of a subscription.
The statuses reported by this method is normal, not a subscriber, no funds (prepaid) and transferred.
If status is transferred, the transfer date is also return. This is used by the client to ensure that
the subbscription hasn't been transferred to another person since the PSID was obtained.
Method Summary | |
WVP10AuthenticationResponse |
authenticateClient(java.lang.String clientId,
java.lang.String password)
Authenticates a client. |
WVP10CompletionResponse |
completeVerifySubscriber(java.lang.String clientId,
java.lang.String password,
WVP10CompletionRequest request)
Used by client to verify that a user has given a msisdn that he/she is in posession of. |
WVP10InitResponse |
initiateVerifySubscriber(java.lang.String clientId,
java.lang.String password,
WVP10InitRequest request)
Used by client to verify that a users has given a msisdn that he/she is in posession of. |
WVP10RemoveSubscriberResponse |
removeSubscriberFromClient(java.lang.String clientId,
java.lang.String password,
SubscriberId subscriber)
Removes the association between a subsciber and the requesting client. |
WVP10ValidationResponse |
validateSubscription(java.lang.String clientId,
java.lang.String password,
SubscriberId subscriber)
Checks that a user's subscription has not been revoked, transferred, ported to another operator or other checks that a client wants to carry out. |
Method Detail |
public WVP10AuthenticationResponse authenticateClient(java.lang.String clientId, java.lang.String password)
clientId
- Mandatory - Identifies the client.password
- Mandatory - Password of client.public WVP10InitResponse initiateVerifySubscriber(java.lang.String clientId, java.lang.String password, WVP10InitRequest request)
clientId
- Mandatory - Identifies the client.password
- Mandatory - Password of client.request
- Mandatory - An WVP10SubscriberVerificationRequest object.public WVP10CompletionResponse completeVerifySubscriber(java.lang.String clientId, java.lang.String password, WVP10CompletionRequest request)
clientId
- Mandatory - Identifies the client.password
- Mandatory - Password of client.request
- Mandatory - An WVP10SubscriberVerificationRequest object.public WVP10RemoveSubscriberResponse removeSubscriberFromClient(java.lang.String clientId, java.lang.String password, SubscriberId subscriber)
clientId
- Mandatory - Identifies the client.password
- Mandatory - Password of client.subscriber
- Mandatory - The subscriber to be disassociated. Types allowed are
MSID, PSID and VSID.public WVP10ValidationResponse validateSubscription(java.lang.String clientId, java.lang.String password, SubscriberId subscriber)
clientId
- Mandatory - Identifies the client.password
- Mandatory - Password of client.subscriber
- Mandatory - The subscriber to be verified.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |