com.signalsoftcorp.lst.client
Interface WVIValidation


public interface WVIValidation

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

authenticateClient

public WVP10AuthenticationResponse authenticateClient(java.lang.String clientId,
                                                      java.lang.String password)
Authenticates a client.
Parameters:
clientId - Mandatory - Identifies the client.
password - Mandatory - Password of client.
Returns:
true if client is authenticated, false otherwise.

initiateVerifySubscriber

public 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. This method is used to initiate the process. It returns a verificationAlias in the response. To complete the process, completeVerifySubscriber is called.
Upon completion a PSID that can be used for location requests is passed to the client.
Parameters:
clientId - Mandatory - Identifies the client.
password - Mandatory - Password of client.
request - Mandatory - An WVP10SubscriberVerificationRequest object.
Returns:
an object of type WVP10InitResponse

completeVerifySubscriber

public 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. This method completes the process that is initiated by initiateVerifySubscriber.
Parameters:
clientId - Mandatory - Identifies the client.
password - Mandatory - Password of client.
request - Mandatory - An WVP10SubscriberVerificationRequest object.
Returns:
an object of type WVP10CompletionResponse

removeSubscriberFromClient

public WVP10RemoveSubscriberResponse removeSubscriberFromClient(java.lang.String clientId,
                                                                java.lang.String password,
                                                                SubscriberId subscriber)
Removes the association between a subsciber and the requesting client.
Parameters:
clientId - Mandatory - Identifies the client.
password - Mandatory - Password of client.
subscriber - Mandatory - The subscriber to be disassociated. Types allowed are MSID, PSID and VSID.
Returns:
an object of type WVP10ValidationResponse

validateSubscription

public 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. The actual check performed is operator dependent.
Parameters:
clientId - Mandatory - Identifies the client.
password - Mandatory - Password of client.
subscriber - Mandatory - The subscriber to be verified.
Returns:
The status of the subscribtion as a WVP10ValidationResponse


Copyright © SignalSoft Corp. All Rights Reserved.