Forgot Password
A user can use the OIG Self Service REST API to reset a forgotten password using the following URIs:
-
/unauthservice/passwordreset GET
: This retrieves the challenge questions for the user. -
/unauthservice/passwordreset POST
: The user supplies the new password and responses to the challenge questions.
cURL Example for Retrieving the Challenge Questions for the User
curl -H "Content-Type: application/json" -X GET https://pseudo.com/iam/governance/selfservice/api/v1/unauthservice/passwordreset?userId=jlong
GET Response Body
{ "challengeQuestions": [ "What is the name of your pet?", "What is the city of your birth?", "What is your mother's maiden name?" ] }
cURL Example for Supplying the New Password and Responses to the Challenge Questions
curl -H "Content-Type: application/json" -H "X-Requested-By: <anyvalue>" -X POST -d @post.json https://pseudo.com/iam/governance/selfservice/api/v1/unauthservice/passwordreset
POST Request Body
{
"userId": "jlong",
"newPassword": "NEW_PASSWORD",
"challengeQuestions": [
{
"name": "What is your mother's maiden name?",
"value": "name"
},
{
"name": "What is the name of your pet?",
"value": "pet"
},
{
"name": "What is the city of your birth?",
"value": "birth"
}
]
}
POST Response Body
{ "status": "true" }