Безопасность: Сложный контроль доступа с выражениями

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

Безопасность: Сложный контроль доступа с выражениями

See also

Наилучшим решением для работы со сложными правилами авторизации является использование Системы избирателей.

В дополнение к роли вроде ROLE_ADMIN, метод isGranted() также принимает объект Expression:

  • Attributes
  • PHP
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
// src/Controller/MyController.php
namespace App\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\ExpressionLanguage\Expression;
use Symfony\Component\HttpFoundation\Response;

class MyController extends AbstractController
{
    #[IsGranted(new Expression(
        '"ROLE_ADMIN" in role_names or (is_authenticated() and user.isSuperAdmin())'
    ))]
    public function index(): Response
    {
        // ...
    }
}

6.2

Атрибут #[IsGranted()] был представлен в Symfony 6.2.

В этом примере, если текущий пользователь имеет ROLE_ADMIN или если метод объекта текущего пользователя isSuperAdmin() возвращает true, то доступ будет гарантирован (примечание: ваш объект Пользователь может не иметь метода isSuperAdmin(), этот метод был выдуман для данного примера).

Здесь используется выражение, и вы можете узнать больше о синтаксисе языка выражений, см. .

Внутри выражения у вас есть доступ к нескольким переменным:

user
Объект пользователя (или строка anon, если вы не аутентифицированы).
role_names
Массив ролей, которые имеет пользователь, со строковым представлением. Этот массив включает в себя все роли, предоставленные не напрямую через иерархию ролей , но не включает атрибуты IS_AUTHENTICATED_* (см. функции ниже).
object
Объект (если есть), которые передаётся в качестве второго аргумента isGranted().
subject
Хранит то же значение, что и object, поэтому они эквивалентны.
token
Объект токена.
trust_resolver
Объект AuthenticationTrustResolverInterface,: вы скорее всего будете использовать функции is_*(), описанные ниже.

Кроме того, у вас есть доступ к следующим функциям внутри выражения:

is_authenticated()
Возвращает true, если пользователь аутентифицирован через "запомнить меня" или "полностью" аутентифицирован - т.е. возвращает "true", если пользователь находится в системе.
is_remember_me()
Похоже на, но не эквивалентно IS_AUTHENTICATED_REMEMBERED, см. ниже.
is_fully_authenticated()
Похоже, но не эквивалентно IS_AUTHENTICATED_FULLY, см. ниже.
is_granted()
Проверяет, есть ли у пользователя заданное разрешение. Дополнительно принимает второй аргмент с объектом, где проверяется разрешение. Эквивалентно использованию метода isGranted() из сервиса безопасности.

Функции is_remember_me() и is_authenticated_fully() похожи на использование IS_AUTHENTICATED_REMEMBERED и IS_AUTHENTICATED_FULLY с функцией isGranted(), но они не одинаковы. Следующий отрезок из контроллера демонстрирует отличия:

1
2
3
4
5
6
7
8
9
10
11
12
use Symfony\Component\ExpressionLanguage\Expression;
use Symfony\Component\Security\Core\Authorization\AuthorizationCheckerInterface;
// ...

public function index(AuthorizationCheckerInterface $authorizationChecker): Response
{
    $access1 = $authorizationChecker->isGranted('IS_AUTHENTICATED_REMEMBERED');

    $access2 = $authorizationChecker->isGranted(new Expression(
        'is_remember_me() or is_fully_authenticated()'
    ));
}

Здесь, $access1 и $access2 будут иметь одинаковое значение. В отличие от поведения IS_AUTHENTICATED_REMEMBERED и IS_AUTHENTICATED_FULLY, функция is_remember_me() возвращает "ture" только, если пользователь аутентифицирован через куки "запомнить меня" и is_fully_authenticated, возвращает "true" только, если пользователь вошел в систему в течение этой сессии (т.е. полнофункциональный).