Changing the User Password

Description

A user is able to change the password to secure their EMM profile via the REST API given below.

Resource Path /change-password

URL /mdm-admin/users/change-password

HTTP Method POST

Request/Response Format application/json

cURL command

curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer <EMM_API_TOKEN>" -d @'<JSON_PAYLOAD>' -k -v https://<EMM_HOST>:<EMM_HTTPS_PORT>/mdm-admin/users/change-password

For more information on how to generate the <EMM_API_TOKEN>, see Generating the EMM API Token.
Define the path to the JSON file, which includes the required properties to change a user password as <JSON_PAYLOAD> value. For more information, see the Sample JSON Definition.
By default, <EMM_HOST> is localhost. However, if you are using a public IP, the respective IP address or domain needs to be specified.
By default, <EMM_HTTPS_PORT> has been set to 9443. However, if the port offset has been incremented by n, the default port value needs to be incremented by n.

Example:

curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer 33392fb365b3ac693b405b565ddc8a3a" -d @'user.json' -k -v https://localhost:9443/mdm-admin/users/change-password

Sample output

 > POST /mdm-admin/users/change-password HTTP/1.1
> Host: localhost:9443
> User-Agent: curl/7.43.0
> Accept: */*
> Content-Type: application/json
> Authorization: Bearer 9ffd50a15654de12e677ebaac9767597
> Content-Length: 83
< HTTP/1.1 201 Created
< Date: Mon, 21 Mar 2016 12:22:20 GMT
< Content-Type: application/json
< Content-Length: 97
< Server: WSO2 Carbon Server
{"statusCode":201,"messageFromServer":"User password by username: kim was successfully changed."}

Sample JSON Definition

{  
   "username":"kim",
   "oldPassword":"a2ltJDEyMzQ=",
   "newPassword":"a2ltJDEyYmFy"
}

Property	Definition	Data Type
`username`	Provide the name of the user you wish to change the password.	String
`oldPassword`	Provide the current password in the base64 encoded format. Click here for more information on how to encode the password Access any base64 encoder. For example: https://www.base64encode.org/ Enter the current password. For example: `kim$1234` Click Encode to generate the encoded key. The following is an example of an encoded key: `a2ltJDEyMzQ=`	String
`newPassword`	Provide the new password in the base64 encoded format. Click here for more information on how to encode the passwword Access any base64 encoder. For example: https://www.base64encode.org/ Enter the current password. For example: `barKim$5467` Click Encode to generate the encoded key. The following is an example of an encoded key: `YmFyS2ltJDU0Njc=`	String