Authentication and password management API reference for on-premises management consoles
This article lists the authentication and password management REST APIs supported for Microsoft Defender for IoT on-premises management consoles.
set_password (Change password)
Use this API to let users change their own passwords. All Defender for IoT user roles can work with the API.
You don't need a Defender for IoT access token to use this API.
URI: /external/authentication/set_password
POST
Type: JSON
Example:
request:
{
"username": "test",
"password": "Test12345\!",
"new_password": "Test54321\!"
}
Request parameters
Name | Type | Required / Optional |
---|---|---|
username | String | Required |
password | String | Required |
new_password | String | Required |
set_password_by_admin (User password update by system admin)
Use this API to let system administrators change passwords for specified users. Defender for IoT admin user roles can work with the API.
You don't need a Defender for IoT access token to use this API.
URI: /external/authentication/set_password_by_admin
POST
Type: JSON
Request example
request:
{
"admin_username": "admin",
"admin_password: "Test0987"
"username": "test",
"new_password": "Test54321\!"
}
Request parameters
Name | Type | Required / Optional |
---|---|---|
admin_username | String | Required |
admin_password | String | Required |
username | String | Required |
new_password | String | Required |
validation (Authenticate user credentials)
Use this API to validate user credentials.
You don't need a Defender for IoT access token to use this API.
URI: /external/authentication/validation
POST
Type: JSON
Query parameters
Name | Type | Required/Optional |
---|---|---|
username | String | Required |
password | String | Required |
Request example
request:
{
"username": "test",
"password": "Test12345\!"
}
Next steps
For more information, see the Defender for IoT API reference overview.
Maklum balas
https://aka.ms/ContentUserFeedback.
Akan datang: Sepanjang 2024, kami akan menghentikan secara berperingkat Isu GitHub sebagai kaedah maklum balas untuk kandungan dan menggantikannya dengan sistem maklum balas baharu. Untuk mendapatkan maklumat lanjut lihat:Kirim dan lihat maklum balas untuk