Skip to end of metadata
Go to start of metadata
You are viewing an old version of this page. View the current version.
Compare with Current
View Page History
Version 1
Next »
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 |
|
---|