Skip to end of metadata
Go to start of metadata
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 | |
---|
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 |
|
---|