Page Comparison

...

This method is used to confirm the self-registered user account and unlock it.

...

Code Block

language	xml
title	Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.mgt.identity.carbon.wso2.org" xmlns:xsd="http://beans.mgt.captcha.carbon.wso2.org/xsd">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:confirmUserSelfRegistration>
         <!--Optional:-->
         <ser:username></ser:username>
         <!--Optional:-->
         <ser:code>?</ser:code>
         <!--Optional:-->
         <ser:captcha>
            <!--Optional:-->
            <xsd:imagePath></xsd:imagePath>
            <!--Optional:-->
            <xsd:secretKey></xsd:secretKey>
            <!--Optional:-->
            <xsd:userAnswer></xsd:userAnswer>
         </ser:captcha>
         <!--Optional:-->
         <ser:tenantDomain></ser:tenantDomain>
      </ser:confirmUserSelfRegistration>
   </soapenv:Body>
</soapenv:Envelope>

Parameters

Parameter	Type	Description
userName	String	Username of the user.
code	String	Confirmation code

send

sent to the user.
captcha	Captcha	Captcha code. Includes `imagePath, secretKey and UserAnswer`

getAllChallengeQuestions

This method is used to get all challenge questions.

...

Code Block

language	xml

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.mgt.identity.carbon.wso2.org">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:getUserChallengeQuestion>
         <!--Optional:-->
         <ser:userName></ser:userName>
         <!--Optional:-->
         <ser:confirmation></ser:confirmation>
         <!--Optional:-->
         <ser:questionId></ser:questionId>
      </ser:getUserChallengeQuestion>
   </soapenv:Body>
</soapenv:Envelope>

Parameters

Parameter	Type	Description
userName	String	Username of the user.
confirmation	String	Confirmation code

send

sent to the user.
questionId	String	Question ID.

getUserChallengeQuestionIds

...

Code Block

language	xml

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.mgt.identity.carbon.wso2.org">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:getUserChallengeQuestionIds>
         <!--Optional:-->
         <ser:username></ser:username>
         <!--Optional:-->
         <ser:confirmation>?</ser:confirmation>
      </ser:getUserChallengeQuestionIds>
   </soapenv:Body>
</soapenv:Envelope>

Parameters

Parameter	Type	Description
userName	String	Username of the user.
confirmation	String	Confirmation code

send

sent to the user.

getUserIdentitySupportedClaims

...

Code Block

language	xml

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.mgt.identity.carbon.wso2.org">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:getUserIdentitySupportedClaims>
         <!--Optional:-->
         <ser:dialect></ser:dialect>
      </ser:getUserIdentitySupportedClaims>
   </soapenv:Body>
</soapenv:Envelope>

Parameters

Parameter	Type	Description
dialect	String	Claim dialect.

registerUser

This method is used to register a user in the system. The account will be locked if the Authentication.Policy.Account.Lock.On.Creation property is set to true, otherwise the user will be able to login after registration.

...

Code Block

language	xml

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.mgt.identity.carbon.wso2.org" xmlns:xsd="http://dto.mgt.identity.carbon.wso2.org/xsd">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:registerUser>
         <!--Optional:-->
         <ser:userName></ser:userName>
         <!--Optional:-->
         <ser:password></ser:password>
         <!--Zero or more repetitions:-->
         <ser:claims>
            <!--Optional:-->
            <xsd:claimUri></xsd:claimUri>
            <!--Optional:-->
            <xsd:claimValue></xsd:claimValue>
         </ser:claims>
         <!--Optional:-->
         <ser:profileName></ser:profileName>
         <!--Optional:-->
         <ser:tenantDomain></ser:tenantDomain>
      </ser:registerUser>
   </soapenv:Body>
</soapenv:Envelope>

Parameters

Parameter	Type	Description
userName	String	Username of the user.
password	String	Password of the user.
claims	UserIdentityClaim[]	User claims. Includes `claimUri` and `claimValue`.
profileName	String	User profile name.
tenantDomain	String	Tenant domain of the user.

...

resendSignUpConfirmationCode

This method is used to resend the self sign up confirmation code when the user has not received the email properly.

...

Code Block

language	xml

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.mgt.identity.carbon.wso2.org">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:resendSignUpConfiramtionCode>
         <!--Optional:-->
         <ser:userName></ser:userName>
         <!--Optional:-->
         <ser:code>?</ser:code>
         <!--Optional:-->
         <ser:profileName></ser:profileName>
         <!--Optional:-->
         <ser:tenantDomain></ser:tenantDomain>
      </ser:resendSignUpConfiramtionCode>
   </soapenv:Body>
</soapenv:Envelope>

Parameters

Parameter	Type	Description
userName	String	Username of the user.
code	String	Confirmation code

send

sent to the user.
tenantDomain	String	Tenant domain of the user.

sendRecoveryNotification

This method is used to send the recovery notification.

...

Code Block

language	xml

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.mgt.identity.carbon.wso2.org">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:sendRecoveryNotification>
         <!--Optional:-->
         <ser:username></ser:username>
         <!--Optional:-->
         <ser:key>?</ser:key>
         <!--Optional:-->
         <ser:notificationType></ser:notificationType>
      </ser:sendRecoveryNotification>
   </soapenv:Body>
</soapenv:Envelope>

Parameters

Parameter	Type	Description
userName	String	Username of the user.
key	String	Confirmation key send to the user.
notificationType	String	Notification type.

updatePassword

This method is used to update the password in the system for password recovery process. Before calling this method, the caller needs to call the verifyConfirmationCode() method and get the newly generated confirmation code.

...

Code Block

language	xml

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.mgt.identity.carbon.wso2.org">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:updatePassword>
         <!--Optional:-->
         <ser:username></ser:username>
         <!--Optional:-->
         <ser:confirmationCode></ser:confirmationCode>
         <!--Optional:-->
         <ser:newPassword></ser:newPassword>
      </ser:updatePassword>
   </soapenv:Body>
</soapenv:Envelope>

Parameters

Parameter	Type	Description
userName	String	Username of the user.
confirmationCode	String	Confirmation code send to the user.
newPassword	String	New password for the user.

verifyAccount

Verifies the user against the provided claims and captcha information.

...

Code Block

language	xml

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.mgt.identity.carbon.wso2.org" xmlns:xsd="http://dto.mgt.identity.carbon.wso2.org/xsd" xmlns:xsd1="http://beans.mgt.captcha.carbon.wso2.org/xsd">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:verifyAccount>
         <!--Zero or more repetitions:-->
         <ser:claims>
            <!--Optional:-->
            <xsd:claimUri></xsd:claimUri>
            <!--Optional:-->
            <xsd:claimValue></xsd:claimValue>
         </ser:claims>
         <!--Optional:-->
         <ser:captcha>
            <!--Optional:-->
            <xsd1:imagePath></xsd1:imagePath>
            <!--Optional:-->
            <xsd1:secretKey></xsd1:secretKey>
            <!--Optional:-->
            <xsd1:userAnswer></xsd1:userAnswer>
         </ser:captcha>
         <!--Optional:-->
         <ser:tenantDomain></ser:tenantDomain>
      </ser:verifyAccount>
   </soapenv:Body>
</soapenv:Envelope>

Parameters

Parameter	Type	Description
claims	`UserIdentityClaim[]`	User claims. Includes `claimUri` and `claimValue`.
captcha	Captcha	Captcha code. Includes `imagePath, secretKey and UserAnswer`
tenantDomain	String	Tenant domain of the user.

verifyConfirmationCode

This method is used to verify the confirmation code supplied by user. This invalidates the current code, generates a new code and sends it to the user.

...

Code Block

language	xml

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.mgt.identity.carbon.wso2.org" xmlns:xsd="http://beans.mgt.captcha.carbon.wso2.org/xsd">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:verifyConfirmationCode>
         <!--Optional:-->
         <ser:username></ser:username>
         <!--Optional:-->
         <ser:code>?</ser:code>
         <!--Optional:-->
         <ser:captcha>
            <!--Optional:-->
            <xsd:imagePath></xsd:imagePath>
            <!--Optional:-->
            <xsd:secretKey></xsd:secretKey>
            <!--Optional:-->
            <xsd:userAnswer></xsd:userAnswer>
         </ser:captcha>
      </ser:verifyConfirmationCode>
   </soapenv:Body>
</soapenv:Envelope>

Parameters

Parameter	Type	Description
userName	String	Username of the user.
code	String	Confirmation code send to the user.
captcha	Captcha	Captcha code. Includes `imagePath, secretKey and UserAnswer`

verifyUser

This method is used to verify the user against the captcha code.

...

Code Block

language	xml

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.mgt.identity.carbon.wso2.org" xmlns:xsd="http://beans.mgt.captcha.carbon.wso2.org/xsd">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:verifyUser>
         <!--Optional:-->
         <ser:username></ser:username>
         <!--Optional:-->
         <ser:captcha>
            <!--Optional:-->
            <xsd:imagePath></xsd:imagePath>
            <!--Optional:-->
            <xsd:secretKey></xsd:secretKey>
            <!--Optional:-->
            <xsd:userAnswer></xsd:userAnswer>
         </ser:captcha>
      </ser:verifyUser>
   </soapenv:Body>
</soapenv:Envelope>

Parameters

Parameter	Type	Description
userName	String	Username of the user.
captcha	Captcha	Captcha code. Includes `imagePath, secretKey and UserAnswer`

verifyUserChallengeAnswer

...

Code Block

language	xml

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.mgt.identity.carbon.wso2.org">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:verifyUserChallengeAnswer>
         <!--Optional:-->
         <ser:userName></ser:userName>
         <!--Optional:-->
         <ser:confirmation></ser:confirmation>
         <!--Optional:-->
         <ser:questionId></ser:questionId>
         <!--Optional:-->
         <ser:answer></ser:answer>
      </ser:verifyUserChallengeAnswer>
   </soapenv:Body>
</soapenv:Envelope>

Parameters

Parameter	Type	Description
userName	String	Username of the user.
confirmation	String	Confirmation code send to the user.
questionId	String	Question ID.
answer	String	Answer to the question.

Versions Compared

Old Version 1

New Version 2

Key

Parameters

getAllChallengeQuestions

Parameters

getUserChallengeQuestionIds

Parameters

getUserIdentitySupportedClaims

Parameters

registerUser

Parameters

resendSignUpConfirmationCode

Parameters

sendRecoveryNotification

Parameters

updatePassword

Parameters

verifyAccount

Parameters

verifyConfirmationCode

Parameters

verifyUser

Parameters

verifyUserChallengeAnswer

Parameters