Socotra
API ReferenceConfiguration and Development API

Passwords API

ActionEndpoint
Fetch Password PolicyGET/auth/identity/passwordPolicy
Update Password PolicyPUT/auth/identity/passwordPolicy

Fetch

Fetch Password Policy

Fetch Password PolicyfetchPasswordPolicy
GET/auth/identity/passwordPolicy
Security Group:identity
Permissions:
read,custom
PasswordPolicyResponse

Required properties

PropertyTypeDescription
passwordPoliciesPasswordPolicies
PasswordPolicies

Required properties

PropertyTypeDescription
digitsintegerThe minimum number of numeric digits required in the password string.
forceExpiredPasswordChangeintegerThe number of days the password is valid before a new password is required.
lengthintegerThe minimum number of characters allowed in the password.
lowercaseintegerThe minimum number of uppercase characters required in the password string.
maxLengthintegerThe maximum number of characters allowed in the password.
passwordHistoryintegerThe count of previous passwords that are not allowed to be reused, starting with the most recent.
specialCharsintegerThe minimum number of special characters required in the password string.
uppercaseintegerThe minimum number of uppercase characters required in the password string.

Update

Update Password Policy

Update Password PolicyupdatePasswordPolicy
PUT/auth/identity/passwordPolicy
Response:void
Security Group:identity
Permissions:
add,custom
PasswordPolicyUpdateRequest

Required properties

PropertyTypeDescription
passwordPoliciesPasswordPoliciesUpdateRequest
PasswordPoliciesUpdateRequest

Properties

PropertyTypeDescription
digitsinteger?The minimum number of numeric digits required in the password string.
forceExpiredPasswordChangeinteger?The number of days the password is valid before a new password is required.
lengthinteger?The minimum number of characters allowed in the password.
lowercaseinteger?The minimum number of uppercase characters required in the password string.
maxLengthinteger?The maximum number of characters allowed in the password.
passwordHistoryinteger?The minimum age of a password in days to allow its reuse.
specialCharsinteger?The minimum number of special characters required in the password string.
uppercaseinteger?The minimum number of uppercase characters required in the password string.

The Update Password Policy endpoint is a PUT endpoint, which means all the password policy settings will be replaced. If any properties are not included in the update request, the default values will be used.

See Also

On this page