Service: ContactAuthenticationPublicService

Version: 2_17 (other versions, change log, ZUMSTEIN_V4.1-SNAPSHOT) Deprecated. This version is frozen and still supported.

SOAP Demo endpoint: https://myinstit.ws.secutix.com/tnco/external-remoting/com.secutix.service.contact.v2_17.ContactAuthenticationPublicService.webservice?wsdl

REST Demo endpoint (only POST): https://myinstit.ws.secutix.com/tnco/backend-apis/contactAuthenticationPublicService/v2_17/{methodName} Replace {methodName} for the desired method name as shown below.

To get the endpoint for your own institution, replace "myinstit" (just after https://) in the url by your own institution code.

For further documentation and examples, please check in Platform Website.

Methods:

authenticate

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

This method is used to authenticate a contact based on his login and password and more attributes available from ContactAuthenticationData.

Authentication can be based either on login+password, either on a anterior authentication having generated a unique identifier rememberMe.

During a login/password authentication, boolean remmemberMe allows to decide wether such a token must be generated. A rememberMe token is valid during one month max.

If authentication is done through a token, a NEW token + identifier are generated, invalidating the other ones.

This method takes into account parametrization of point of sales. In case of B2B sales, it checks wether the contact is authorized to log on the given point of sales.

Parameters

contactAuthenticationDataContactAuthenticationData     

ContactAuthenticationData
contactTypeScope(INDIVIDUAL|STRUCTURE|
ANY)
     
guestLoginboolean     
identificationString     
identityProviderString     
loginString     
passwordString     
pointOfSalesIdLong     
providerUserReferenceString     
rememberMeboolean     
socialLoginboolean     
structureContactNumberString (20)     
targetContactNumberString (20)     
uniqueTokenString     

Return value

ContactAuthenticationResult
contactNumberString (20)     
identificationString     
uniqueTokenString     
requestIdInteger     
statusCodeString (8)     
statusDetailString     

changePassword

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

This method allows to modify the current password of a contact identified by its contact number.

Parameters

contactNumberString (20)Mandatory
number of the contact to alter its password; mandatory.
currentPasswordStringMandatory
current contact password; mandatory;
newPasswordStringMandatory
new password if the existing password match; mandatory.

Return value

WebMethodResult
requestIdInteger     
statusCodeString (8)     
statusDetailString     

listAuthorizedPOS

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

This method returns the list of point of sales authorized for given contact who needs to be authenticated.

Parameters

contactNumberString (20)- the contact number who needs to be authenticated.

Return value

ListAuthorizedPOSResult
pointOfSalesList of PosSummary     
requestIdInteger     
statusCodeString (8)     
statusDetailString     

PosSummary
pointOfSalesIdLong     
urlString (255)     

recoverPassword

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

This method allows a contact identified by the given email address to request a new randomly generated password for authentication. The old password is automatically invalidated.

Parameters

emailStringMandatory
Mandatory, email of the contact
contactNumberString (20)Mandatory
Only mandatory and to be considered for relay contacts.(STX-5744) Since the email is not unique and this function can used for individual contact and structure contact, we add a new parameter contactNumber to help identify the right contact to modify.
contactTypeScope(INDIVIDUAL|STRUCTURE|
ANY)
     

Return value

PasswordRecoveryResult
emailString     
requestIdInteger     
statusCodeString (8)     
statusDetailString