Как ограничить брандмауэры по конкретному запросу

Дата обновления перевода 2023-01-11

Как ограничить брандмауэры по конкретному запросу

При использовании компонента Security, брандмауэры будут определять, будут ли они обрабатывать запрос, основываясь на результате сопоставителя запросов: первый брандмауэр, совпадающий с запросом, обработает его.

Последний брандмауэрр может быть сконфигурирован без сопоставителя, чтобы обрабатывать каждый входящий запрос.

Ограничене по конфигурации

В большинстве случаев вам не понадобится создавать сопоставители самостоятельно, так как Symfony может это сделать за вас, основываясь на вашей конфигурации брандмауэра.

Note

Вы можете использовать любое из следующих ограничений индивидуально или совмещать их, чтобы получить желаемую конфигурацию брандмауэра.

Ограничение по пути

Это ограничение по умолчанию, и оно ограничивает брандмауэр, чтобы он был инициализирован только если путь запроса совпадает со сконфигурированным pattern.

YAML
XML
PHP

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

# ...
security:
    firewalls:
        secured_area:
            pattern: ^/admin
            # ...
    

        1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
        <!-- 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="secured_area" pattern="^/admin">
            <!-- ... -->
        </firewall>
    </config>
</srv:container>
    

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

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

    $security->firewall('secured_area')
        ->pattern('^/admin')
        // ...
    ;
};
    

pattern - это регулярное выражение. В этом примере, брандмауэр будет активирован только ели путь начинается (из-за символа регулярного выражения ^) с /admin. Если путь не совпадает с этим паттерном, брандмауэр не будет активирован, а последующие брандмауэры будут иметь возможность быть сопоставленными с этим запросом.

Ограничение по хосту

Если сопоставления только по pattern недостаточно, то запрос можно также сопоставить с host. Когда установлена опция конфигурации host, брандмауэр будет ограничен так, чтобы запускаться только если хост запроса совпадает с конфигурацией.

YAML
XML
PHP

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

# ...
security:
    firewalls:
        secured_area:
            host: ^admin\.example\.com$
            # ...
    

        1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
        <!-- 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
        http://symfony.com/schema/dic/services/services-1.0.xsd">

    <config>
        <!-- ... -->
        <firewall name="secured_area" host="^admin\.example\.com$">
            <!-- ... -->
        </firewall>
    </config>
</srv:container>
    

        1
2
3
4
5
6
7
8
9
10
11
        // config/packages/security.php

// ...
$container->loadFromExtension('security', array(
    'firewalls' => array(
        'secured_area' => array(
            'host' => '^admin\.example\.com$',
            // ...
        ),
    ),
));
    

host (как и pattern) - это регулярное выражение. В этом примере, брандмауэр будет активирован только если хост полностью приравнивается к имени хоста admin.example.com (из-за символов регулярного выражения ^ и $). Если имя хоста не совпадает с этим шаблоном, брандмауэр не будет активирован, и последующие брандмауэры будут иметь возможность быть сопоставлеными с этим запросом.

Ограничение по HTTP-методам

Опция конфигурации methods ограничивает инициализацию брандмауэра по предоставленным HTTP-методам.

YAML
XML
PHP

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

# ...
security:
    firewalls:
        secured_area:
            methods: [GET, POST]
            # ...
    

        1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
        <!-- 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
        http://symfony.com/schema/dic/services/services-1.0.xsd">

    <config>
        <!-- ... -->
        <firewall name="secured_area" methods="GET,POST">
            <!-- ... -->
        </firewall>
    </config>
</srv:container>
    

        1
2
3
4
5
6
7
8
9
10
11
        // config/packages/security.php

// ...
$container->loadFromExtension('security', array(
    'firewalls' => array(
        'secured_area' => array(
            'methods' => array('GET', 'POST'),
            // ...
        ),
    ),
));
    

В этом примере, брандмауэр будет активирован только если HTTP-метод запроса - GET или POST. Если этого метода нет в массиве разрешённх методов, то брандмауэр не будет активирован, и последующие брандмауэры будут иметь возможность быть сопоставлеными с этим запросом.

Ограничение по сервису

Если опции выше не подходят под ваши потребности, вы можете сконфигурировать любой сервис, реализующий RequestMatcherInterface как request_matcher.

YAML
XML
PHP

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

# ...
security:
    firewalls:
        secured_area:
            request_matcher: App\Security\CustomRequestMatcher
            # ...
    

        1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
        <!-- 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="secured_area" request-matcher="App\Security\CustomRequestMatcher">
            <!-- ... -->
        </firewall>
    </config>
</srv:container>
    

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

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

    $security->firewall('secured_area')
        ->requestMatcher(CustomRequestMatcher::class)
        // ...
    ;
};
    