PasswordStrength

Дата оновлення перекладу 2024-05-29

PasswordStrength

Валідує, що заданий пароль досяг мінімальної надійності, яка вимагається обмеженням. Надійність пароля не оцінюється за допомогою набору заздалегідь визначених правил (включення числа, використання малих та великих літер тощо), а шляхом вимірювання ентропії пароля на основі його довжини та кількості використаних унікальних символів.

?????????????? ??	??????????? ??? ??????
????	PasswordStrength
?????????	PasswordStrengthValidator

Базове застосування

Наступне обмеження гарантує, що властивість rawPassword класу User досягне мінімальної надійності, що вимагається обмеженням. За замовчуванням мінімально необхідна оцінка дорівнює 2.

        1
2
3
4
5
6
7
8
9
10
        // src/Entity/User.php
namespace App\Entity;

use Symfony\Component\Validator\Constraints as Assert;

class User
{
    #[Assert\PasswordStrength]
    protected $rawPassword;
}
    

        1
2
3
4
5
        # config/validator/validation.yaml
App\Entity\User:
    properties:
        rawPassword:
            - PasswordStrength
    

        1
2
3
4
5
6
7
8
9
10
11
12
        <!-- config/validator/validation.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">

    <class name="App\Entity\User">
        <property name="rawPassword">
            <constraint name="PasswordStrength"></constraint>
        </property>
    </class>
</constraint-mapping>
    

        1
2
3
4
5
6
7
8
9
10
11
12
13
        // src/Entity/User.php
namespace App\Entity;

use Symfony\Component\Validator\Constraints as Assert;
use Symfony\Component\Validator\Mapping\ClassMetadata;

class User
{
    public static function loadValidatorMetadata(ClassMetadata $metadata)
    {
        $metadata->addPropertyConstraint('rawPassword', new Assert\PasswordStrength());
    }
}
    

Доступні опції

`minScore`

тип: integer за замовчуванням: PasswordStrength::STRENGTH_MEDIUM (2)

Мінімальна потрібна надійність пароля. Доступні константи:

PasswordStrength::STRENGTH_WEAK = 1
PasswordStrength::STRENGTH_MEDIUM = 2
PasswordStrength::STRENGTH_STRONG = 3
PasswordStrength::STRENGTH_VERY_STRONG = 4

PasswordStrength::STRENGTH_VERY_WEAK доступно, але використовується лише внутрішньо або ж користувацьким оцінювачем надійності пароля.

        1
2
3
4
5
6
7
8
9
10
11
12
        // src/Entity/User.php
namespace App\Entity;

use Symfony\Component\Validator\Constraints as Assert;

class User
{
    #[Assert\PasswordStrength([
        'minScore' => PasswordStrength::STRENGTH_VERY_STRONG, // Very strong password required
    ])]
    protected $rawPassword;
}
    

`message`

тип: string за замовчуванням: Надійність пароля занизька. Будь ласка, використайте надійніший пароль.

Повідомлення за замовчуванням, як відображається, якщо пароль не досягає мінімальної необхідної оцінки.

        1
2
3
4
5
6
7
8
9
10
11
12
        // src/Entity/User.php
namespace App\Entity;

use Symfony\Component\Validator\Constraints as Assert;

class User
{
    #[Assert\PasswordStrength([
        'message' => 'Le mot de passe est trop faible. Veuillez utiliser un mot de passe plus fort.'
    ])]
    protected $rawPassword;
}
    