Password Policy
This Public Experimental API gets or updates the domain password policy.
A default password policy is created automatically when a new login domain (organization) is created. There is only one password policy per login domain, so the same password policy applies to all users.
API Methods
Functionality | HTTP | URI |
|---|---|---|
Get the password policy |
|
|
Update the password policy |
|
|
Curl Command Get the Password Policy
The org/:org_id/ path parameter is not specified in this command.
curl -i -X GET https://pce.my-company.com:8443/api/v2/authentication_services/password_policy -H "Accept: application/json" -u $KEY:$TOKEN
Example Default Response: 200 OK
{
"require_type_number": true,
"require_type_lowercase": true,
"require_type_uppercase": true,
"require_type_symbol": false,
"min_characters_per_type": 1,
"min_length": 8,
"min_changed_characters": 1,
"history_count": 1,
"expire_time_days": 0,
"updated_at": "2019-09-20T03:40:00Z",
"updated_by": null
}
Parameters
Parameter | Description | Type | Req |
|---|---|---|---|
| If | Boolean | Yes |
| If | Boolean | Yes |
| If | Boolean | Yes |
| If ! @ # $ % ^ * ? \u0026 \u003c \u003e | Boolean | Yes |
| Minimum number of characters for each character type. | Integer | Yes |
| Minimum password length. | Integer | Yes |
| Minimum number of changed characters for a new password. Minimum: 1 Maximum: 4 | Integer | Yes |
| Number of old passwords to remember. Minimum: 1 Maximum: 24 | Integer | Yes |
| Number of days until the password expires. A value of 0 (zero) means the password never expires. Minimum: 0 Maximum: 99 | Integer | Yes |
| RFC-3339 date-time timestamp of when the password policy was last updated. Automatically recorded by the system. | date-time String | Yes |
| The username of the person that last updated this password policy (null for the default password policy). Automatically recorded by the system. | String | Yes |
Update Password Policy
Curl Command Update the Password Policy
The org/:org_id/ path parameter is not specified in this command.
curl -i -X PUT https://pce.my-company.com:8443/api/v2/authentication_services/password_policy -H "Content-Type: application/json" -u $KEY:$TOKEN -d '{"require_type_symbol": true, "expire_time_days": 90} Request Properties
At least three of the four available character types must be true, otherwise a 406 Not Acceptable error message is returned.*
Parameter | Description | Type | Required |
|---|---|---|---|
| If | Boolean | * |
| If | Boolean | * |
| If | Boolean | * |
| If ! @ # $ % ^ * ? \u0026 \u003c \u003e | Boolean | * |
| Minimum number of characters for each character type. | Integer | No |
| Minimum password length. | Integer | No |
| Minimum number of changed characters for new passwords. Minimum: 1 Maximum: 4 | Integer | No |
| Number of old passwords to remember. Minimum: 1 Maximum: 24 | Integer | No |
| Number of days password expires. A value of 0 (zero) means the password never expires. Minimum: 0 Maximum: 99 | Integer | No |
Example Request Body
Only the parameters to change must be included in the request body.
{
"require_type_number": true,
"require_type_lowercase": true,
"require_type_uppercase": true,
"require_type_symbol": true,
"min_characters_per_type": 1,
"min_length": 8,
"min_changed_characters": 1,
"history_count": 1,
"expire_time_days": 90
}