This documentation is for WSO2 Identity Server 5.4.0. View documentation for the latest release.
User Information Recovery Service - Identity Server 5.4.0 - WSO2 Documentation
||
Skip to end of metadata
Go to start of metadata

This section lists out and describes the service methods available in the user information recovery API: 

confirmUserSelfRegistration

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

Permission level: /permission/admin/login

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

userNameStringUsername of the user.
codeStringConfirmation code send to the user.
captchaCaptchaCaptcha code. Includes imagePath, secretKey and UserAnswer

getAllChallengeQuestions

This method is used to get all challenge questions.

Permission level: /permission/admin/login

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

getCaptcha

This method is used to get the captcha code.

Permission level: /permission/admin/login

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

getUserChallengeQuestion

This method is used to get the challenge question for the user.

Permission level: /permission/admin/login

<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

userNameStringUsername of the user.
confirmationStringConfirmation code send to the user.
questionIdStringQuestion ID.

getUserChallengeQuestionIds

This method is used to get the challenge question IDs.

Permission level: /permission/admin/login

<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

userNameStringUsername of the user.
confirmationStringConfirmation code send to the user.

getUserIdentitySupportedClaims

This method is used to get the user supported claims.

Permission level: /permission/admin/login

<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

dialectStringClaim 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.

Permission level: /permission/admin/login

<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

userNameStringUsername of the user.
passwordStringPassword of the user.

claims

UserIdentityClaim[]
User claims. Includes claimUri and claimValue.
profileNameStringUser profile name.
tenantDomainStringTenant 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.

Permission level: /permission/admin/login

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

Parameters

Parameter

Type

Description

userNameStringUsername of the user.
codeStringConfirmation code send to the user.
tenantDomainStringTenant domain of the user.

sendRecoveryNotification

This method is used to send the recovery notification.

Permission level: /permission/admin/login

<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

userNameStringUsername of the user.
keyStringConfirmation key send to the user.
notificationTypeStringNotification 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.

Permission level: /permission/admin/login

<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

userNameStringUsername of the user.
confirmationCodeStringConfirmation code send to the user.
newPasswordStringNew password for the user.

verifyAccount

Verifies the user against the provided claims and captcha information.

Permission level: /permission/admin/login

<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

claimsUserIdentityClaim[]User claims. Includes claimUri and claimValue.
captchaCaptchaCaptcha code. Includes imagePath, secretKey and UserAnswer
tenantDomainStringTenant 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.

Permission level: /permission/admin/login

<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

userNameStringUsername of the user.
codeStringConfirmation code send to the user.
captchaCaptchaCaptcha code. Includes imagePath, secretKey and UserAnswer

verifyUser

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

Permission level: /permission/admin/login

<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

userNameStringUsername of the user.
captchaCaptchaCaptcha code. Includes imagePath, secretKey and UserAnswer

verifyUserChallengeAnswer

This method is used to verify the user against the challenge question.

Permission level: /permission/admin/login

<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

userNameStringUsername of the user.
confirmationStringConfirmation code send to the user.
questionIdStringQuestion ID.
answerStringAnswer to the question.
  • No labels