Иерархический RBAC в Yii: как работает проверка доступа
Автор может редактировать свои записи, редактор — любые, а контроллер проверяет одно разрешение. Разберём, как выразить это через иерархию RBAC в Yii 2, почему отказ в одной ветке не блокирует другую и как перенести такую схему с CAuthManager.
Роли, разрешения и правила в Yii
RBAC связывает пользователя с действиями через роли. Роль author объединяет права автора, а разрешение updatePost обозначает конкретное действие. Когда доступ зависит от объекта, к элементу иерархии привязывают правило. Например, право автора на редактирование зависит от того, кто создал запись.
В Yii 1.x компонент CAuthManager различал роли, задачи и операции. В Yii 2 у элементов иерархии два типа: роли и разрешения. Старую операцию обычно переносят в разрешение, а задачу с условием можно представить разрешением с классом yii\rbac\Rule. Примеры ниже используют API Yii 2 и синтаксис PHP, общий для PHP 8.3–8.5.
Как направлять связи в иерархии
Связь addChild($parent, $child) означает, что родитель даёт доступ к дочернему элементу с учётом правил на пути. При настройке удобно читать связи от роли к действию:
reader→readPost.author→reader,createPost,updateOwnPost.updateOwnPost→updatePost.editor→reader,updatePost.admin→author,editor,deletePost.
У updatePost два родителя, поэтому иерархия представляет собой граф без циклов. Редактор может править любые записи, но право создавать их получает только через отдельное назначение, например роль автора. Администратор получает оба набора прав, потому что в графе есть обе связи.
В каком порядке Yii проверяет доступ
При вызове Yii::$app->user->can('updatePost', $params) проверка идёт в обратном направлении: от запрошенного разрешения к его родителям. На каждом узле стандартный менеджер Yii 2 действует так:
- Ищет элемент и выполняет привязанное правило, если оно есть. Если элемент отсутствует или правило вернуло
false, этот путь больше не рассматривается. - После успешной проверки правила ищет прямое назначение текущему пользователю или совпадение с настроенной ролью по умолчанию. При совпадении доступ разрешён.
- Если совпадения нет, проверяет родителей по тому же алгоритму. Первый успешный путь завершает проверку. Если все пути исчерпаны, результат —
false.
Для автора путь проходит через updateOwnPost. Если запись своя, правило пропускает проверку дальше, до назначенной роли author. Если запись чужая, эта ветка закрывается. Для редактора достаточно пути updatePost → editor, даже если правило владения в другой ветке вернуло false. Если ограничение должно действовать на всех, его нужно разместить на общем разрешении или проверить отдельно до операции.
Один и тот же массив параметров передаётся правилам на всём пути. Проверка может завершиться до обхода соседних веток, поэтому правила должны обходиться без побочных эффектов. Например, запись факта редактирования относится к операции сохранения, а не к правилу доступа.
Как настроить RBAC в Yii 2
Правило владения записью
Сохраните класс в rbac/OwnPostRule.php приложения с пространством имён app. Пример рассчитан на числовые идентификаторы пользователей и учитывает, что Active Record может вернуть идентификатор строкой. Параметр post должен содержать модель, загруженную на сервере.
<?php
declare(strict_types=1);
namespace app\rbac;
use app\models\Post;
use yii\rbac\Rule;
final class OwnPostRule extends Rule
{
public $name = 'ownPost';
public function execute($user, $item, $params): bool
{
$post = $params['post'] ?? null;
// Без пользователя, записи или автора ветка закрыта.
if ($user === null || !($post instanceof Post) || $post->author_id === null) {
return false;
}
// Одинаково сравниваем идентификатор из сессии и из БД.
return (string) $user === (string) $post->author_id;
}
}Типы параметров execute() оставлены совместимыми с сигнатурой родительского класса Yii 2. Тип результата указан явно. Правило прикрепляется к updateOwnPost, чтобы роль редактора могла получить updatePost по своей ветке.
Регистрация элементов и связей
Настройте authManager как yii\rbac\DbManager в веб- и консольном приложениях с одной базой для RBAC. Примените штатную миграцию RBAC из Yii 2, затем запустите собственную миграцию. Пример рассчитан на первичную настройку, когда перечисленных ролей и разрешений ещё нет.
<?php
declare(strict_types=1);
use app\rbac\OwnPostRule;
use yii\db\Migration;
final class m261119_120000_blog_rbac extends Migration
{
public function up(): bool
{
$auth = Yii::$app->get('authManager');
$rule = new OwnPostRule();
$auth->add($rule);
// Сначала сохраняем узлы, затем добавляем связи.
$items = [];
foreach (['readPost', 'createPost', 'updatePost', 'updateOwnPost', 'deletePost'] as $name) {
$permission = $auth->createPermission($name);
if ($name === 'updateOwnPost') {
$permission->ruleName = $rule->name;
}
$auth->add($permission);
$items[$name] = $permission;
}
foreach (['reader', 'author', 'editor', 'admin'] as $name) {
$items[$name] = $auth->createRole($name);
$auth->add($items[$name]);
}
$children = [
'reader' => ['readPost'],
'author' => ['reader', 'createPost', 'updateOwnPost'],
'updateOwnPost' => ['updatePost'],
'editor' => ['reader', 'updatePost'],
'admin' => ['author', 'editor', 'deletePost'],
];
foreach ($children as $parent => $names) {
foreach ($names as $child) {
$auth->addChild($items[$parent], $items[$child]);
}
}
return true;
}
}Сам граф никому не выдаёт доступ. Назначение делают отдельно через $auth->assign($auth->getRole('author'), $userId), где $userId — идентификатор существующего пользователя. Если у пользователя несколько ролей, достаточно успешного пути к любой из них. Прямое назначение updatePost даёт доступ в обход ветки владения, поэтому для обычного автора назначайте роль author.
Где проверять право на редактирование
Загрузите запись по идентификатору из маршрута и проверьте доступ до обработки данных формы. В правиле владения используется author_id из сохранённой записи. Если массово загрузить данные запроса раньше, можно случайно проверить уже изменённого автора. Само поле author_id следует исключить из полей обычного редактирования.
// Метод контроллера Yii 2. Сценарий edit ограничивает поля формы.
public function actionUpdate(int $id): \yii\web\Response|string
{
$post = \app\models\Post::findOne($id);
if ($post === null) {
throw new \yii\web\NotFoundHttpException('Запись не найдена.');
}
if (!\Yii::$app->user->can('updatePost', ['post' => $post])) {
throw new \yii\web\ForbiddenHttpException('Редактирование недоступно.');
}
$post->scenario = 'edit';
if ($post->load(\Yii::$app->request->post()) && $post->save()) {
return $this->redirect(['view', 'id' => $post->id]);
}
return $this->render('update', ['post' => $post]);
}В модели Post объявите сценарий edit и включите в него только разрешённые к изменению поля, например заголовок и текст. Та же авторизация нужна в каждом серверном обработчике, который меняет запись. Скрытая кнопка в интерфейсе лишь отражает решение о доступе.
Что учесть при переносе с CAuthManager
В Yii 1.x Yii::app()->user->checkAccess() — проверка для текущего пользователя. В Yii 2 её аналог — Yii::$app->user->can(). У менеджера Yii 2 также есть checkAccess($userId, $permissionName, $params) для проверки прав по явно переданному идентификатору. Строковые бизнес-правила Yii 1.x перенесите в классы правил. Если условие раньше было задано на самом назначении, перенесите его на отдельную роль или разрешение с правилом и воспроизведите нужные связи: назначение Yii 2 не имеет собственного бизнес-правила.
Проверьте defaultRoles отдельно. Роль по умолчанию участвует в проверке без записи о персональном назначении. Не считайте её признаком входа в аккаунт: если роль должна работать только для вошедших пользователей, закрепите это условие явно. Например, публичное чтение можно разрешить всем, а чтение закрытого раздела проверять отдельно.
Чек-лист перед включением RBAC
- Проверьте действие через конкретное разрешение, например
updatePost. Контроллеру достаточно имени действия и объекта. - Пройдите граф от разрешения до назначенных ролей и отметьте, где действуют правила. Проверьте, может ли соседняя ветка дать доступ после отказа.
- Проверьте автора на своей и чужой записи, редактора на чужой, читателя на любой, а также пользователя без назначения и гостя.
- Вызовите проверку для автора без параметра
post. Ожидается отказ без предупреждений PHP, если у пользователя нет другого пути к разрешению. - Попробуйте изменить
author_idчерез форму и отправить запрос напрямую. Сервер должен принимать решение по сохранённой записи и разрешать изменение только полей сценария редактирования.
Частые вопросы
Почему правило updateOwnPost вернуло false, а Yii разрешил редактирование?
Отказ закрывает путь через updateOwnPost. Если пользователю назначена роль editor, ведущая к updatePost напрямую, Yii разрешит действие по этой ветке.
Что использовать в Yii 2 вместо Yii::app()->user->checkAccess()?
Для текущего пользователя используйте Yii::$app->user->can($permissionName, $params). Для проверки прав по конкретному идентификатору вызовите checkAccess($userId, $permissionName, $params) у authManager.
Можно ли выдать разрешение пользователю напрямую?
Да. Прямое назначение тоже учитывает правило самого разрешения. Например, прямое назначение updatePost в этой схеме даёт право редактировать любые записи, поскольку проверка владения привязана к updateOwnPost.