在 Yii2 中,需要判断当前登录用户是否具有接口具体数据访问权限(基于 RBAC、默认角色、子权限)
1、参考:在 Yii2 中,需要判断当前登录用户是否具体接口访问权限(基于 RBAC、默认角色)
2、权限机制设计如下:
1、现在 RBAC 中有 2 个角色: companyEmployeeRole participantShareRecipientRole 1 2、每一个角色分别绑定了一个规则: companyEmployeeRole(CompanyEmployeeRule) participantShareRecipientRole(ParticipantShareRecipientRule) 1 3、现在 RBAC 中有 4 个权限: participantShareFilterViewPermission participantShareFilterDownloadPermission participantShareFilterOwnViewPermission participantShareFilterOwnDownloadPermission 1 4、角色 companyEmployeeRole 赋予了权限: participantShareFilterViewPermission participantShareFilterDownloadPermission 1 5、2 个权限分别绑定了一个规则: participantShareFilterOwnViewPermission(ParticipantShareFilterOwnViewRule) participantShareFilterOwnDownloadPermission(ParticipantShareFilterOwnDownloadRule) 1 6、"participantShareFilterOwnViewPermission" 权限将由 "participantShareFilterViewPermission" 权限使用、"participantShareFilterOwnDownloadPermission" 权限将由 "participantShareFilterDownloadPermission" 权限使用 1 7、允许 接收者 浏览、下载 自己的高级筛选的分享记录的报名列表 角色 participantShareRecipientRole 赋予了权限: participantShareFilterOwnViewPermission 1 角色 participantShareRecipientRole 赋予了权限: participantShareFilterOwnDownloadPermission 1 8、基于 第 2 点角色绑定的规则,自动分配 2 个角色至当前的登录用户 1 9、使用 can 方法检查用户的 participantShareFilterViewPermission participantShareFilterDownloadPermission 权限
3、新增加一个数据库迁移文件,代码实现如下
<?php use common\rbac\ParticipantShareFilterOwnDownloadRule; use common\rbac\ParticipantShareFilterOwnViewRule; use common\rbac\ParticipantShareRecipientRule; use yii\db\Migration; /** * Class m250407_132039_init_convention_participant_share_filter_rbac */ class m250407_132039_init_convention_participant_share_filter_rbac extends Migration { /** * {@inheritdoc} */ public function safeUp() { $auth = Yii::$app->authManager; // 创建自定义规则 $participantShareRecipientRule = new ParticipantShareRecipientRule(); $auth->add($participantShareRecipientRule); $participantShareFilterOwnViewRule = new ParticipantShareFilterOwnViewRule(); $auth->add($participantShareFilterOwnViewRule); $participantShareFilterOwnDownloadRule = new ParticipantShareFilterOwnDownloadRule(); $auth->add($participantShareFilterOwnDownloadRule); // 创建权限 $participantShareFilterViewPermission = $auth->createPermission('participantShareFilterViewPermission'); $participantShareFilterViewPermission->description = '高级筛选结果的浏览权限'; $auth->add($participantShareFilterViewPermission); $participantShareFilterDownloadPermission = $auth->createPermission('participantShareFilterDownloadPermission'); $participantShareFilterDownloadPermission->description = '高级筛选结果的下载权限'; $auth->add($participantShareFilterDownloadPermission); // 创建角色并分配规则、赋予权限 $companyEmployeeRole = $auth->getRole('companyEmployeeRole'); $auth->addChild($companyEmployeeRole, $participantShareFilterViewPermission); $auth->addChild($companyEmployeeRole, $participantShareFilterDownloadPermission); $participantShareRecipientRole = $auth->createRole('participantShareRecipientRole'); $participantShareRecipientRole->ruleName = $participantShareRecipientRule->name; $auth->add($participantShareRecipientRole); // 添加 "participantShareFilterOwnViewPermission"、"participantShareFilterOwnDownloadPermission" 权限并与规则关联 $participantShareFilterOwnViewPermission = $auth->createPermission('participantShareFilterOwnViewPermission'); $participantShareFilterOwnViewPermission->description = '做为接收者,高级筛选结果的浏览权限'; $participantShareFilterOwnViewPermission->ruleName = $participantShareFilterOwnViewRule->name; $auth->add($participantShareFilterOwnViewPermission); $participantShareFilterOwnDownloadPermission = $auth->createPermission('participantShareFilterOwnDownloadPermission'); $participantShareFilterOwnDownloadPermission->description = '做为接收者,高级筛选结果的下载权限'; $participantShareFilterOwnDownloadPermission->ruleName = $participantShareFilterOwnDownloadRule->name; $auth->add($participantShareFilterOwnDownloadPermission); // "participantShareFilterOwnViewPermission" 权限将由 "participantShareFilterViewPermission" 权限使用 $auth->addChild($participantShareFilterOwnViewPermission, $participantShareFilterViewPermission); // "participantShareFilterOwnDownloadPermission" 权限将由 "participantShareFilterDownloadPermission" 权限使用 $auth->addChild($participantShareFilterOwnDownloadPermission, $participantShareFilterDownloadPermission); // 允许 接收者 浏览、下载 自己的高级筛选的分享记录的报名列表 $auth->addChild($participantShareRecipientRole, $participantShareFilterOwnViewPermission); $auth->addChild($participantShareRecipientRole, $participantShareFilterOwnDownloadPermission); } /** * {@inheritdoc} */ public function safeDown() { echo "m250407_132039_init_convention_participant_share_filter_rbac cannot be reverted.\n"; return false; } /* // Use up()/down() to run migration code without a transaction. public function up() { } public function down() { echo "m250407_132039_init_convention_participant_share_filter_rbac cannot be reverted.\n"; return false; } */ }
4、4 个规则文件实现如下
CompanyEmployeeRule.php
<?php namespace common\rbac; use yii\rbac\Item; use yii\rbac\Rule; use common\models\CompanyEmployeeMapping; /** * 检查 user_id 是否和通过参数传进来的 user 参数相符 */ class CompanyEmployeeRule extends Rule { public $name = 'isCompanyEmployee'; /** * @param string|integer $userId 用户 ID. * @param Item $item 该规则相关的角色或者权限 * @param array $params 传给 ManagerInterface::checkAccess() 的参数 * @return boolean 代表该规则相关的角色或者权限是否被允许 */ public function execute($userId, $item, $params): bool { if (!isset($params['convention'])) { return false; } return CompanyEmployeeMapping::find() ->where([ 'user_id' => $userId, 'company_id' => $params['convention']->company_id, ]) ->exists(); } }
FormContentShareRecipientRule.php
<?php namespace common\rbac; use api\models\ConventionFormContentShareRecipient; use common\models\ConventionFormContentShareRecipient as CommonConventionFormContentShareRecipient; use Yii; use yii\rbac\Item; use yii\rbac\Rule; /** * 检查当前登录用户是否为信息表单的分享内容的接收者 */ class FormContentShareRecipientRule extends Rule { public $name = 'isFormContentShareRecipient'; /** * @param string|integer $userId 用户 ID. * @param Item $item 该规则相关的角色或者权限 * @param array $params 传给 ManagerInterface::checkAccess() 的参数 * @return boolean 代表该规则相关的角色或者权限是否被允许 */ public function execute($userId, $item, $params): bool { if (!isset($params['conventionForm'])) { return false; } return ConventionFormContentShareRecipient::find() ->where([ 'form_id' => $params['conventionForm']->id ]) ->andWhere(['user_id' => Yii::$app->user->id]) ->andWhere(['status' => [CommonConventionFormContentShareRecipient::STATUS_NORMAL, CommonConventionFormContentShareRecipient::STATUS_SUSPENDED]]) ->exists(); } }
ParticipantShareFilterOwnDownloadRule.php
<?php namespace common\rbac; use api\models\ConventionParticipantShareRecipient; use common\models\ConventionParticipantShareRecipient as CommonConventionParticipantShareRecipient; use Yii; use yii\rbac\Item; use yii\rbac\Rule; /** * 检查当前登录用户是否为高级筛选的分享记录的接收者,且具有下载权限 */ class ParticipantShareFilterOwnDownloadRule extends Rule { public $name = 'allowParticipantShareFilterOwnDownload'; /** * @param string|integer $userId 用户 ID. * @param Item $item 该规则相关的角色或者权限 * @param array $params 传给 ManagerInterface::checkAccess() 的参数 * @return boolean 代表该规则相关的角色或者权限是否被允许 */ public function execute($userId, $item, $params): bool { if (!isset($params['conventionParticipantShareFilter'])) { return false; } return ConventionParticipantShareRecipient::find() ->where([ 'share_filter_id' => $params['conventionParticipantShareFilter']->id ]) ->andWhere(['user_id' => Yii::$app->user->id]) ->andWhere(['status' => [CommonConventionParticipantShareRecipient::STATUS_NORMAL, CommonConventionParticipantShareRecipient::STATUS_SUSPENDED]]) ->andWhere(['download' => CommonConventionParticipantShareRecipient::DOWNLOAD_YES]) ->exists(); } }
ParticipantShareFilterOwnViewRule.php
<?php namespace common\rbac; use api\models\ConventionParticipantShareRecipient; use common\models\ConventionParticipantShareRecipient as CommonConventionParticipantShareRecipient; use Yii; use yii\rbac\Item; use yii\rbac\Rule; /** * 检查当前登录用户是否为高级筛选的分享记录的接收者,且具有浏览权限 */ class ParticipantShareFilterOwnViewRule extends Rule { public $name = 'allowParticipantShareFilterOwnView'; /** * @param string|integer $userId 用户 ID. * @param Item $item 该规则相关的角色或者权限 * @param array $params 传给 ManagerInterface::checkAccess() 的参数 * @return boolean 代表该规则相关的角色或者权限是否被允许 */ public function execute($userId, $item, $params): bool { if (!isset($params['conventionParticipantShareFilter'])) { return false; } return ConventionParticipantShareRecipient::find() ->where([ 'share_filter_id' => $params['conventionParticipantShareFilter']->id ]) ->andWhere(['user_id' => Yii::$app->user->id]) ->andWhere(['status' => [CommonConventionParticipantShareRecipient::STATUS_NORMAL, CommonConventionParticipantShareRecipient::STATUS_SUSPENDED]]) ->andWhere(['view' => CommonConventionParticipantShareRecipient::VIEW_YES]) ->exists(); } }
5、最终检查权限的实现如下,直接在控制器的方法实现
if (!Yii::$app->user->can('formDownloadPermission', ['convention' => $conventionForm->convention, 'conventionForm' => $conventionForm])) { return [ 'code' => 14021, 'message' => '你没有权限', ]; }
6、在 main.php 中配置默认角色
'authManager' => [ 'class' => 'yii\rbac\DbManager', 'cache' => 'cache', 'defaultRoles' => ['companyEmployeeRole', 'conventionContactRole', 'checkinManagerRole', 'participantShareRecipientRole', 'formContentShareRecipientRole'], // @see <a href="https://www.yiiframework.com/doc/guide/2.0/zh-cn/security-authorization#using-default-roles">使用默认角色</a> ],
7、最终实现的效果如下
查看分享链接的权限调整如下: 不是接收者 且 不是企业员工 无浏览下载权限 是接收者且具有浏览权限 且 不是企业员工 有浏览权限 是接收者且具有下载权限 且 不是企业员工 有下载权限 不是接收者 且 是企业员工 有浏览下载权限 是接收者 且 是企业员工 有浏览下载权限
近期评论