Як налаштувати відповіді аутентифікатора форми входу

Дата оновлення перекладу 2022-12-22

Як налаштувати відповіді аутентифікатора форми входу

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

Перенаправлення після успіху

За замовчуванням, форма перенаправлятиме за URL, запитаним користувачем (тобто, URL, який викликав відображення форми входу). Наприклад, якщо користувач запитав http://www.example.com/admin/post/18/edit, то після успішного входу в систему, він буде зрештою направлений назад на http://www.example.com/admin/post/18/edit.

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

Зміна сторінки за замовчуванням

Визначіть опцію default_target_path, щоб змінити сторінку, куди буде перенаправлено користувача, якщо в сесії не була збережена попередня сторінка. Значення може бути абсолютним /відносним URL або іменем маршруту Symfony:

YAML
XML
PHP

        1
2
3
4
5
6
7
8
9
        # config/packages/security.yaml
security:
    # ...

    firewalls:
        main:
            form_login:
                # ...
                default_target_path: after_login_route_name
    

        1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
        <!-- config/packages/security.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<srv:container xmlns="http://symfony.com/schema/dic/security"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:srv="http://symfony.com/schema/dic/services"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        https://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/security
        https://symfony.com/schema/dic/security/security-1.0.xsd">

    <config>
        <!-- ... -->

        <firewall name="main">
            <form-login default-target-path="after_login_route_name"/>
        </firewall>
    </config>
</srv:container>
    

        1
2
3
4
5
6
7
8
9
10
11
12
13
        // config/packages/security.php
use Symfony\Config\SecurityConfig;

return static function (SecurityConfig $security) {
    // ...

    $security->firewall('main')
        // ...
        ->formLogin()
            // ...
            ->defaultTargetPath('after_login_route_name')
    ;
};
    

Завжди перенаправляти на сторінку за замовчуванням

Визначіть булеву опцію always_use_default_target_path, щоб ігнорувати раніше запитаний URL і завжди перенаправляти на сторінку за замовчуванням:

YAML
XML
PHP

        1
2
3
4
5
6
7
8
9
        # config/packages/security.yaml
security:
    # ...

    firewalls:
        main:
            form_login:
                # ...
                always_use_default_target_path: true
    

        1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
        <!-- config/packages/security.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<srv:container xmlns="http://symfony.com/schema/dic/security"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:srv="http://symfony.com/schema/dic/services"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        https://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/security
        https://symfony.com/schema/dic/security/security-1.0.xsd">

    <config>
        <!-- ... -->

        <firewall name="main">
            <!-- ... -->
            <form-login always-use-default-target-path="true"/>
        </firewall>
    </config>
</srv:container>
    

        1
2
3
4
5
6
7
8
9
10
11
12
13
        // config/packages/security.php
use Symfony\Config\SecurityConfig;

return static function (SecurityConfig $security) {
    // ...

    $security->firewall('main')
        // ...
        ->formLogin()
            // ...
            ->alwaysUseDefaultTargetPath(true)
    ;
};
    

Контроль перенаправлення з використанням параметрів запиту

URL для перенаправлення після входу у систему може бути визначений з використанням параметра _target_path запитів GET і POST. Його значення повинно бути відносним або абсолютним URL, а не іменем маршруту Symfony.

Визначення URL перенаправлення через GET, використовуючи параметр рядку запиту:

        1
        http://example.com/some/path?_target_path=/dashboard
    

Визначення URL перенаправлення через POST, використовуючи приховане поле форми:

        1
2
3
4
5
6
7
        {# templates/security/login.html.twig #}
<form action="{{ path('login') }}" method="post">
    {# ... #}

    <input type="hidden" name="_target_path" value="{{ path('account') }}"/>
    <input type="submit" name="login"/>
</form>
    

Використання URL-реферера

У випадку, якщо попередній URL не зберігався у сесії, а в запиті не додано параметр _target_path, ви можете використати замість цього значення заголовку HTTP_REFERER, так як це часто буде одним і тим же. Визначіть булеву опцію use_referer, щоб включити цю поведінку:

YAML
XML
PHP

        1
2
3
4
5
6
7
8
9
10
        # config/packages/security.yaml
security:
    # ...

    firewalls:
        main:
            # ...
            form_login:
                # ...
                use_referer: true
    

        1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
        <!-- config/packages/security.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<srv:container xmlns="http://symfony.com/schema/dic/security"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:srv="http://symfony.com/schema/dic/services"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        https://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/security
        https://symfony.com/schema/dic/security/security-1.0.xsd">

    <config>
        <!-- ... -->

        <firewall name="main">
            <!-- ... -->
            <form-login use-referer="true"/>
        </firewall>
    </config>
</srv:container>
    

        1
2
3
4
5
6
7
8
9
10
11
12
13
        // config/packages/security.php
use Symfony\Config\SecurityConfig;

return static function (SecurityConfig $security) {
    // ...

    $security->firewall('main')
        // ...
        ->formLogin()
            // ...
            ->useReferer(true)
    ;
};
    

Note

URL-реферер використовується лише коли він відрізняється від URL, згенерованого маршрутом login_path. щоб уникнути петлі перенаправлень.

Перенаправлення після невдачі

Після невдалого входу у систему (наприклад, було відправлено неправильний пароль або імʼя користувача), користувач перенаправляється назад до самої форми входу. Використайте опцію failure_path, щоб визначити нову ціль через абсолютний/відносний URL або імʼя маршруту Symfony:

YAML
XML
PHP

        1
2
3
4
5
6
7
8
9
10
        # config/packages/security.yaml
security:
    # ...

    firewalls:
        main:
            # ...
            form_login:
                # ...
                failure_path: login_failure_route_name
    

        1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
        <!-- config/packages/security.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<srv:container xmlns="http://symfony.com/schema/dic/security"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:srv="http://symfony.com/schema/dic/services"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        https://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/security
        https://symfony.com/schema/dic/security/security-1.0.xsd">

    <config>
        <!-- ... -->

        <firewall name="main">
            <!-- ... -->
            <form-login failure-path="login_failure_route_name"/>
        </firewall>
    </config>
</srv:container>
    

        1
2
3
4
5
6
7
8
9
10
11
12
13
        // config/packages/security.php
use Symfony\Config\SecurityConfig;

return static function (SecurityConfig $security) {
    // ...

    $security->firewall('main')
        // ...
        ->formLogin()
            // ...
            ->failurePath('login_failure_route_name')
    ;
};
    

Ця опція також може бути встановлена через параметр запиту _failure_path:

        1
        http://example.com/some/path?_failure_path=/forgot-password
    

        1
2
3
4
5
6
7
        {# templates/security/login.html.twig #}
<form action="{{ path('login') }}" method="post">
    {# ... #}

    <input type="hidden" name="_failure_path" value="{{ path('forgot_password') }}"/>
    <input type="submit" name="login"/>
</form>
    

Налаштування параметрів цілі невдалого запиту

Імʼя атрибутів запитів, використовуване для визначення успішних та невдалих перенаправлень входу у систему, може бути налаштоване, використовуючи опції target_path_parameter і failure_path_parameter брандмауера, який визначає форму входу.

YAML
XML
PHP

        1
2
3
4
5
6
7
8
9
10
        # config/packages/security.yaml
security:
    # ...

    firewalls:
        main:
            # ...
            form_login:
                target_path_parameter: go_to
                failure_path_parameter: back_to
    

        1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
        <!-- config/packages/security.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<srv:container xmlns="http://symfony.com/schema/dic/security"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:srv="http://symfony.com/schema/dic/services"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        https://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/security
        https://symfony.com/schema/dic/security/security-1.0.xsd">

    <config>
        <!-- ... -->

        <firewall name="main">
            <!-- ... -->
            <form-login target-path-parameter="go_to"/>
            <form-login failure-path-parameter="back_to"/>
        </firewall>
    </config>
</srv:container>
    

        1
2
3
4
5
6
7
8
9
10
11
12
13
14
        // config/packages/security.php
use Symfony\Config\SecurityConfig;

return static function (SecurityConfig $security) {
    // ...

    $security->firewall('main')
        // ...
        ->formLogin()
            // ...
            ->targetPathParameter('go_to')
            ->failurePathParameter('back_to')
    ;
};
    

Використовуючи конфігурацію вище, ви отримаєте повністю налаштовувані приховані поля форми та параметри рядку запиту:

        1
        http://example.com/some/path?go_to=/dashboard&back_to=/forgot-password
    

        1
2
3
4
5
6
7
8
        {# templates/security/login.html.twig #}
<form action="{{ path('login') }}" method="post">
    {# ... #}

    <input type="hidden" name="go_to" value="{{ path('dashboard') }}"/>
    <input type="hidden" name="back_to" value="{{ path('forgot_password') }}"/>
    <input type="submit" name="login"/>
</form>
    