/msp/password_change.php
[GET] [POST]
Change passwords for all or some users in the same subscription. This API allows Managers, Administrators, Unit Managers to change passwords for multiple users at once as a "batch" process. New passwords are automatically generated by the service. This API does not support session based authentication.
Permissions - Managers can change password for all users in subscription, except the user making the request. Unit Managers can change password for all users in same business unit, except the user making the request. Administrator can change password for all users in subscription, except Manager and the user making the request.
Parameter |
Description |
user_logins={value} |
(Required) One or more Qualys user login IDs of user accounts to change the password for. Multiple user login IDs are comma separated. Specify user_logins=all to change the password for all users in the user’s account, except the requesting user. |
send_email={0|1} |
(Optional) A flag that indicates whether users will receive an email notification alerting them to the password change. 1 - (default) When set to 1, an email notification will be sent to affected users. Each user clicks a secure link in the email to view the new password. 0 - When set to 0, an email notification will not be sent to affected users, and the XML report returned by the function will include the login ID and password for each user account as XML value pairs. If you make such a request on an account with the status “pending activation”, the API automatically assigns the “active” status since the login credentials are available in the XML report. |
Password change request for two accounts, send affected users an email notification including a secure link to their new password.
API request
https://qualysapi.qualys.com/msp/password_change.php?user_logins=acme_jr,acme_dd
Password change request for all users in the API user’s account (except the API user) and return the login ID and password for each affected user in the password change XML report.
API request
https://qualysapi.qualys.com/msp/password_change.php?user_logins=all&email=0
<platform API server>/password_change_output.dtd