always_use_default_target_path

тип: boolean за замовчуванням: false

Якщо true, то користувачі завдли перенаправляються за цільовим шляхом за замовчуванням, незважаючи на попередній URL, збережений в сесії.

default_target_path

тип: string за замовчуванням: /

Сторінка, на яку перенаправляються користувачі, коли попередня сторінка, збережена в сесії, відсутня (наприклад, коли корситувачі напряму заходять на сторінку входу в систему).

target_path_parameter

тип: string за замовчуванням: _target_path

При використанні форми входу, якщо ви вмикаєте HTML-елемент для установки цільового шляху, ця опція дозволяє вам змінити ім'я самого HTML-елементу.

failure_path_parameter

тип: string за замовчуванням: _failure_path

При використанні форми входу, якщо ви додасте HTML-елемент для установки шляху невдачі, ця опція дозволяє вам змінити ім'я самого HTML-елементу.

use_referer

тип: boolean за замовчуванням: false

Якщо true, то користувач перенаправляється до значення, збереженого у заголовку HTTP_REFERER, коли в сесії не було збережено попередній URL. Якщо реферальний URL такий же, як і згенерований з маршрутом login_path, то користувач перенаправляється за default_target_path, щоб уникнути замкненого перенаправлення.

delete_cookies

тип: array за замовчуванням: []

Перераховує імена (та інші необовʼязкові функції) кукі, які треба видалити, коли користувач вийде з системи:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

# config/packages/security.yaml
security:
    # ...

    firewalls:
        main:
            # ...
            logout:
                delete_cookies:
                    cookie1-name: null
                    cookie2-name:
                        path: '/'
                    cookie3-name:
                        path: null
                        domain: example.com

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

<!-- 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">

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

        <firewall name="main">
            <!-- ... -->
            <logout path="...">
                <delete-cookie name="cookie1-name"/>
                <delete-cookie name="cookie2-name" path="/"/>
                <delete-cookie name="cookie3-name" domain="example.com"/>
            </logout>
        </firewall>
    </config>
</srv:container>

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

// config/packages/security.php

// ...

return static function (SecurityConfig $securityConfig): void {
    // ...

    $securityConfig->firewall('main')
        ->logout()
            ->deleteCookie('cookie1-name')
            ->deleteCookie('cookie2-name')
                ->path('/')
            ->deleteCookie('cookie3-name')
                ->path(null)
                ->domain('example.com');
};

invalidate_session

тип: boolean за замовчуванням: true

За замовчуванням, коли користувачі виходять з будь-якого брандмауера, їх сесії інвалідуються. Це означає, що вихід з одного брандмауера автомаитчно запускає виходи з усіх інших.

Опція invalidate_session дозволяє вам перевизначити цю поведінку. Встановіть цю опцію як false в кожному брандмауері, і користувач буде виконувати вихід лише з поточного брандмауера, але не інших.

path

тип: string за замовчуванням: /logout

Шлях, який запускає вихід з системи. Якщо ви зміните значення за замовчуванням /logout, вам потрібно налаштувати маршрут з відповідним шляхом.

target

тип: string за замовчуванням: /

Відносний шлях (якщо значення починається з /), або абсоолютний URL (якщо воно починається з http:// чи https://) або ім'я маршруту (в інших випадках), щоб перенаправляти після виходу з системи.

enable_csrf

тип: boolean за замовчуванням: null

Встановіть цю опцію як true, щоб включити CSRF-захист під час процесу виходу з
системи, з викоирстанням генератора токенів CSRF Symfony за замовчуванням. Також встановіть опцію csrf_token_generator, якщо вам потрібно було використати користувацький генератор токенів CSRF.

csrf_parameter

тип: string за замовчуванням: _csrf_token'

Ім'я параметра, який зберігає значення токена CSRF.

csrf_token_generator

тип: string за замовчуванням: null

id сервісу, який використовується для генерування токенів CSRF. Symfony надає сервіс за замовчуванням з ID security.csrf.token_manager.

csrf_token_id

тип: string за замовчуванням: 'ogout'

Довільний рядок, який використовується для ідентифікації токена (і перевірки його валідності після цього).

check_path

тип: string за замовчуванням: /login_check

Це URL або ім'я маршруту, яке система має опублікувати, щоб аутентифікувати з використанням JSON-аутентифікатора. Шлях має бути охоплений брандмауером, в якому аутентифікується користувач.

username_path

тип: string за замовчуванням: username

Виокристайте це і password_path, щоб змінювати очікувану структуру тіла запиту JSON-аутентіфикатора. Наприклад, якщо JSON-документ має наступну структуру:

1
2
3
4
5
6
7
8

{
    "security": {
        "credentials": {
            "login": "dunglas",
            "password": "MyPassword"
        }
    }
}

Конфігурація безпеки має бути:

1
2
3
4
5
6
7
8
9
10
11

# config/packages/security.yaml
security:
    # ...

    firewalls:
        main:
            lazy: true
            json_login:
                check_path:    login
                username_path: security.credentials.login
                password_path: security.credentials.password

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:srv="http://symfony.com/schema/dic/services"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    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" lazy="true">
            <json-login check-path="login"
                username-path="security.credentials.login"
                password-path="security.credentials.password"/>
        </firewall>
    </config>
</srv:container>

1
2
3
4
5
6
7
8
9
10
11
12

// config/packages/security.php
use Symfony\Config\SecurityConfig;

return static function (SecurityConfig $security): void {
    $mainFirewall = $security->firewall('main');
    $mainFirewall->lazy(true);
    $mainFirewall->jsonLogin()
        ->checkPath('/login')
        ->usernamePath('security.credentials.login')
        ->passwordPath('security.credentials.password')
    ;
};

password_path

тип: string за замовчуванням: password

Використовуйте цю опцію, щоб змінювати очікувану структуру тіла запиту. Див. username_path, щоб дізнатися більше.

service

тип: string за замовчуванням*: ldap

Це ім'я вашого сконфігурованого LDAP-клієнта.

dn_string

тип: string за замовчуванням: {username}

Це рядок, який буде використано як зв'язуючий DN. Заповнювач {username} буде замінено на значення, надане користувачем (його вхід в систему). В залежності від вашої конфігурації LDAP-серверу, вам може знадобитися перевизначити це значення.

query_string

тип: string за замовчуванням*: null

Це рядок, який буде використано для запиту до DN. Заповнювач {username} буде замінено на значення, надане користувачем (його вхід в систему). В залежності від вашої конфігурації LDAP-серверу, вам може знадобитися перевизначити це значення. Це налаштування необхідне лише якщо DN користувача не може бути виведений статично, використовуючи опцію конфігурації dn_string.

Постачальник користувачів

Користувачі все ще будуть добуті із сконфігурованого постачальника користувачів. Якщо ви хочете добути користувачів з LDAP-серверу, вам потрібно буде використати Постачальника користувачів LDAP і будь-який з цих провайдерів аутентифікації: form_login_ldap або http_basic_ldap або json_login_ldap.

user

тип: string за замовчуванням: SSL_CLIENT_S_DN_Email

Ім'я параметру $_SERVER, який містить ідентифікатор користувача, використовуваний для завантаження користувача в Symfony. Значення за замовчуванням відображається завдяки Apache.

credentials

тип: string за замовчуванням: SSL_CLIENT_S_DN

Якщо параметр user недоступний - імʼя параметра $_SERVER, яке містить повне "визначене імʼя" сертифікату (розкритого наприклад, через Nginx).

За замовчуванням, Symfony ідентифікує значення, слідуючи emailAddress= в цьому параметрі. Це можна змінити з використанням опції user_identifier.

user_identifier

тип: string за замовчуванням: emailAddress

Значення цієї опції повідомляє Symfony, який параметр використати для пошуку ідентифікатора користувача у "distinguished name".

Наприклад, якщо "distinguished name" - Subject: C=FR, O=My Organization, CN=user1, emailAddress=user1@myorg.fr, а значення цієї опції - 'CN', ідентифікатор користувача буде 'user1'.

provider

тип: string

ID сервісу постачальника користувачів, який має бути використаний даним аутентифікатором.

user

тип: string за замовчуванням: REMOTE_USER

Ім'я параметру $_SERVER, який містить ідентифікатор користувача.