IDM 7.3.1

Forgotten username REST requests

The following REST requests and responses demonstrate the flow through a forgotten username process:

  1. Client initiates the username retrieval process. The server returns the initial set of requirements:

    curl \
 --header "X-OpenIDM-Username: anonymous" \
 --header "X-OpenIDM-Password: anonymous" \
 --header "X-OpenIDM-NoSession: true" \
 --request GET \
 "https://localhost:8443/openidm/selfservice/username"
{
   "_id":"1",
   "_rev":"959264722",
   "type":"userQuery",
   "tag":"initial",
   "requirements":{
      "$schema":"http://json-schema.org/draft-04/schema#",
      "description":"Find your account",
      "type":"object",
      "required":[
         "queryFilter"
      ],
      "properties":{
         "queryFilter":{
            "description":"filter string to find account",
            "type":"string"
         }
      }
   }
}

  2. Client submits the requirements, along with the token. Server returns the username and the end tag to indicate the end of the process:

    curl \
 --header "X-OpenIDM-Username: anonymous" \
 --header "X-OpenIDM-Password: anonymous" \
 --request POST \
 --data '{
  "token": "eyJ0eXAiOiJKV1QiLCJjdHkiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.ZXlKMGVY…​W5ywOcr8",
  {
     "input":{
        "queryFilter":"mail eq \"babs.k.jensen@gmail.com\""
  }
}' \
 "https://localhost:8443/openidm/selfservice/username?_action=submitRequirements"
{
   "type":"retrieveUsername",
   "tag":"end",
   "status":{
      "success":true
   },
   "additions":{
      "userName":"bjensen"
   }
}