2022-04-02 22:32:57 +00:00
|
|
|
---
|
|
|
|
layout: default
|
|
|
|
title: Password Policy
|
|
|
|
parent: Configuration
|
|
|
|
nav_order: 17
|
|
|
|
---
|
|
|
|
|
|
|
|
# Password Policy
|
2022-04-03 00:48:26 +00:00
|
|
|
|
2022-04-02 22:32:57 +00:00
|
|
|
_Authelia_ allows administrators to configure an enforced password policy.
|
|
|
|
|
|
|
|
## Configuration
|
|
|
|
|
|
|
|
```yaml
|
|
|
|
password_policy:
|
|
|
|
standard:
|
2022-04-03 00:48:26 +00:00
|
|
|
enabled: false
|
2022-04-02 22:32:57 +00:00
|
|
|
min_length: 8
|
|
|
|
max_length: 0
|
2022-04-03 11:58:27 +00:00
|
|
|
require_uppercase: false
|
|
|
|
require_lowercase: false
|
|
|
|
require_number: false
|
|
|
|
require_special: false
|
2022-04-02 22:32:57 +00:00
|
|
|
zxcvbn:
|
|
|
|
enabled: false
|
|
|
|
```
|
|
|
|
|
|
|
|
## Options
|
|
|
|
|
|
|
|
### standard
|
|
|
|
<div markdown="1">
|
|
|
|
type: list
|
2022-04-03 11:58:27 +00:00
|
|
|
{: .label .label-config .label-purple }
|
2022-04-02 22:32:57 +00:00
|
|
|
required: no
|
|
|
|
{: .label .label-config .label-green }
|
|
|
|
</div>
|
|
|
|
|
2022-04-03 00:48:26 +00:00
|
|
|
This section allows you to enable standard security policies.
|
|
|
|
|
|
|
|
#### enabled
|
|
|
|
<div markdown="1">
|
2022-04-02 22:32:57 +00:00
|
|
|
type: bool
|
2022-04-03 11:58:27 +00:00
|
|
|
{: .label .label-config .label-purple }
|
2022-04-02 22:32:57 +00:00
|
|
|
required: no
|
|
|
|
{: .label .label-config .label-green }
|
|
|
|
</div>
|
|
|
|
|
2022-04-03 00:48:26 +00:00
|
|
|
Enables standard password policy.
|
|
|
|
|
|
|
|
#### min_length
|
|
|
|
<div markdown="1">
|
2022-04-02 22:32:57 +00:00
|
|
|
type: integer
|
2022-04-03 11:58:27 +00:00
|
|
|
{: .label .label-config .label-purple }
|
|
|
|
default: 8
|
|
|
|
{: .label .label-config .label-blue }
|
2022-04-02 22:32:57 +00:00
|
|
|
required: no
|
|
|
|
{: .label .label-config .label-green }
|
|
|
|
</div>
|
|
|
|
|
2022-04-03 00:48:26 +00:00
|
|
|
Determines the minimum allowed password length.
|
|
|
|
|
|
|
|
#### max_length
|
|
|
|
<div markdown="1">
|
2022-04-02 22:32:57 +00:00
|
|
|
type: integer
|
2022-04-03 11:58:27 +00:00
|
|
|
{: .label .label-config .label-purple }
|
|
|
|
default: 0
|
|
|
|
{: .label .label-config .label-blue }
|
2022-04-02 22:32:57 +00:00
|
|
|
required: no
|
|
|
|
{: .label .label-config .label-green }
|
|
|
|
</div>
|
|
|
|
|
2022-04-03 00:48:26 +00:00
|
|
|
Determines the maximum allowed password length.
|
|
|
|
|
|
|
|
#### require_uppercase
|
|
|
|
<div markdown="1">
|
2022-04-02 22:32:57 +00:00
|
|
|
type: bool
|
2022-04-03 11:58:27 +00:00
|
|
|
{: .label .label-config .label-purple }
|
2022-04-02 22:32:57 +00:00
|
|
|
required: no
|
|
|
|
{: .label .label-config .label-green }
|
|
|
|
</div>
|
|
|
|
|
2022-04-03 00:48:26 +00:00
|
|
|
Indicates that at least one UPPERCASE letter must be provided as part of the password.
|
|
|
|
|
|
|
|
#### require_lowercase
|
|
|
|
<div markdown="1">
|
2022-04-02 22:32:57 +00:00
|
|
|
type: bool
|
2022-04-03 11:58:27 +00:00
|
|
|
{: .label .label-config .label-purple }
|
2022-04-02 22:32:57 +00:00
|
|
|
required: no
|
|
|
|
{: .label .label-config .label-green }
|
|
|
|
</div>
|
|
|
|
|
2022-04-03 00:48:26 +00:00
|
|
|
Indicates that at least one lowercase letter must be provided as part of the password.
|
|
|
|
|
|
|
|
#### require_number
|
|
|
|
<div markdown="1">
|
2022-04-02 22:32:57 +00:00
|
|
|
type: bool
|
2022-04-03 11:58:27 +00:00
|
|
|
{: .label .label-config .label-purple }
|
2022-04-02 22:32:57 +00:00
|
|
|
required: no
|
|
|
|
{: .label .label-config .label-green }
|
|
|
|
</div>
|
|
|
|
|
2022-04-03 00:48:26 +00:00
|
|
|
Indicates that at least one number must be provided as part of the password.
|
|
|
|
|
|
|
|
#### require_special
|
|
|
|
<div markdown="1">
|
2022-04-02 22:32:57 +00:00
|
|
|
type: bool
|
2022-04-03 11:58:27 +00:00
|
|
|
{: .label .label-config .label-purple }
|
2022-04-02 22:32:57 +00:00
|
|
|
required: no
|
|
|
|
{: .label .label-config .label-green }
|
|
|
|
</div>
|
|
|
|
|
2022-04-03 00:48:26 +00:00
|
|
|
Indicates that at least one special character must be provided as part of the password.
|
2022-04-02 22:32:57 +00:00
|
|
|
|
|
|
|
### zxcvbn
|
|
|
|
|
2022-04-03 00:48:26 +00:00
|
|
|
This password policy enables advanced password strength metering, using [zxcvbn](https://github.com/dropbox/zxcvbn).
|
2022-04-02 22:32:57 +00:00
|
|
|
|
2022-04-03 00:48:26 +00:00
|
|
|
Note that this password policy do not restrict the user's entry it just gives the user feedback as to how strong their
|
|
|
|
password is.
|
2022-04-02 22:32:57 +00:00
|
|
|
|
2022-04-03 00:48:26 +00:00
|
|
|
#### enabled
|
|
|
|
<div markdown="1">
|
2022-04-02 22:32:57 +00:00
|
|
|
type: bool
|
2022-04-03 11:58:27 +00:00
|
|
|
{: .label .label-config .label-purple }
|
2022-04-02 22:32:57 +00:00
|
|
|
required: no
|
|
|
|
{: .label .label-config .label-green }
|
|
|
|
</div>
|
|
|
|
|
2022-04-03 00:48:26 +00:00
|
|
|
_**Important Note:** only one password policy can be applied at a time._
|
|
|
|
|
|
|
|
Enables zxcvbn password policy.
|
|
|
|
|
|
|
|
|