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"
}