罗罗编程学习记录
本页内容 展开查看

06.5.3.13 RBAC 权限与认证

所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.3 Yii

06.5.3.13-001 Yii 的 RBAC 由哪个组件管理?基本模型是什么?

一句话结论

RBAC 由 authManager 组件管理,核心模型为角色(Role)、权限(Permission)、规则(Rule)与分配(Assignment);权限挂在角色下,角色分配给用户,校验时沿层级向上聚合判定。

概念解释

角色是一组权限的集合,权限是可执行的操作(如 article.update);规则是附加条件的可执行判定逻辑,可挂在权限/角色上。分配把角色或权限绑定到用户 ID。2.x 提供 PhpManager(文件存储)与 DbManager(数据库存储)两类实现,3.0 对应独立 RBAC 包,具体类名待确认。

原理流程

  1. 定义权限与角色,建立父子层级。
  2. 把角色分配给用户。
  3. 校验时 checkAccess() 沿层级聚合用户拥有的权限。
  4. 附加规则的权限在判定时执行规则条件。

代码或图示

角色:editor
  ├─ 权限:article.create
  ├─ 权限:article.update
  └─ 权限:article.delete
分配:用户 1001 → 角色 editor

常见误区

  • 把角色直接当权限字符串散落在代码:缺少层级与集中管理,后续调整权限要改多处。
  • 认为 RBAC 只控制菜单:后端每个动作都必须独立校验,前端隐藏不等于授权。

追问

  • RBAC 与简单 AccessControl 规则如何分工?答:AccessControl 适合登录状态、访客/登录等粗粒度规则(见 06.5.3.5-007);细粒度操作权限走 RBAC checkAccess。
  • 权限命名如何组织?答:按资源-动作分段,如 article.update,前缀按业务域分组,避免平铺难维护。

06.5.3.13-002 PhpManager 与 DbManager 有何区别?

一句话结论

PhpManager 把权限层级与分配存为 PHP 文件,部署简单但不适合运行时动态授权;DbManager 存数据库表,支持后台动态分配与多实例共享,生产项目通常使用数据库存储。

概念解释

PhpManager 配置文件中定义角色权限,变更需改文件并发布;DbManager 通过表存储,权限、角色、父子关系与用户分配都可在运行时读写。多实例部署时文件存储需同步各节点文件,数据库存储天然共享。具体表名与配置键以当前版本为准。

原理流程

  1. 配置 authManager 组件类与存储参数。
  2. 初始化时读取权限结构(文件或数据库)。
  3. 授权变更写入对应存储。
  4. 校验从存储聚合层级判定。

代码或图示

'components' => [
    'authManager' => [
        'class' => 'yii\rbac\DbManager',
    ],
],

常见误区

  • 多实例用 PhpManager 却不同步文件:各节点权限不一致。
  • 把 DbManager 当实时高并发读存储:权限校验频繁时需配合缓存(见 06.5.3.13-014)。

追问

  • 能否从文件方案迁到数据库方案?答:编写初始化脚本把文件定义导入数据库表;迁移后以数据库为准。
  • 权限数据需要备份吗?答:需要,分配关系属于业务数据,纳入数据库备份范围。

06.5.3.13-003 DbManager 的数据表结构包含哪些表?

一句话结论

数据库存储通常包含权限项表、父子关系表、用户分配表与规则表四张核心表:auth_item(角色/权限)、auth_item_child(层级)、auth_assignment(用户分配)、auth_rule(规则)。

概念解释

auth_item 记录名称、类型(角色/权限)、描述与规则引用;auth_item_child 记录父子包含关系;auth_assignment 记录用户 ID 与角色/权限的分配及分配时间;auth_rule 存规则类名与数据。表名可在组件配置中覆盖,实际字段以安装迁移为准。

原理流程

  1. 权限/角色写入 auth_item。
  2. 父子关系写入 auth_item_child。
  3. 用户分配写入 auth_assignment。
  4. 规则类名与数据存入 auth_rule,校验时实例化执行。

代码或图示

auth_item          name, type, description, rule_name, data
auth_item_child    parent, child
auth_assignment    item_name, user_id, created_at
auth_rule           name, data, created_at, updated_at

常见误区

  • 手工改表绕过 authManager API:层级与规则一致性容易被破坏,应通过组件方法维护。
  • 漏建规则表:带规则的权限校验时报规则缺失错误。

追问

  • 这些表的迁移从哪里来?答:RBAC 扩展提供对应迁移;执行前核对表名前缀与现有库结构(参见 06.5.3.9)。
  • type 字段如何区分角色与权限?答:按组件常量区分角色/权限枚举值,具体常量名以当前版本为准,待确认。

06.5.3.13-004 权限、角色与父子层级如何创建与关联?

一句话结论

用 createPermission()、createRole() 创建项,addChild() 建立包含关系;角色可包含权限与其他角色,权限可聚合子权限,校验时沿父子链向上匹配。

概念解释

权限是最小操作单元;角色按岗位聚合权限。addChild($parent, $child) 表示父项包含子项。层级可多层,但应避免循环包含。初始化脚本或控制台命令在部署时构建基础角色权限,后台再做用户分配。

原理流程

  1. 创建权限项并设置描述。
  2. 创建角色项。
  3. addChild 把权限挂到角色,或角色挂到上级角色。
  4. 校验时从用户分配项出发遍历子树。

代码或图示

$auth = Yii::$app->authManager;

$create = $auth->createPermission('article.create');
$create->description = '创建文章';
$auth->add($create);

$editor = $auth->createRole('editor');
$auth->add($editor);
$auth->addChild($editor, $create);

常见误区

  • 先 addChild 再 add 项:未持久化的项无法建立关系。
  • 角色互相嵌套形成环:层级遍历可能异常,设计时限制嵌套深度。

追问

  • 角色能否包含另一个角色?答:可以,父角色继承子角色全部权限;层级深度按可维护性控制。
  • 权限描述在哪里展示?答:后台权限管理界面读取 description 字段,面向管理员说明用途。

06.5.3.13-005 规则(Rule)如何编写与执行?

一句话结论

规则继承规则基类,实现 execute($user, $item, $params) 方法,返回 true/false 决定该项是否通过;规则挂到权限或角色上,校验时携带上下文参数执行。

概念解释

规则用于数据级权限:如“只能编辑自己创建的文章”。$user 为用户 ID,$item 为被校验的权限/角色项,$params 携带业务上下文(如当前文章记录)。规则类需在 auth_rule 中注册名称与类名。规则不应产生副作用,只做判定。

原理流程

  1. 编写规则类实现 execute()。
  2. 在权限/角色上绑定规则名。
  3. 校验时 authManager 实例化规则并传入用户、项与参数。
  4. 返回 false 则该项不通过。

代码或图示

class OwnArticleRule extends \yii\rbac\Rule
{
    public $name = 'ownArticle';

    public function execute($user, $item, $params)
    {
        return isset($params['article'])
            && (int)$params['article']->author_id === (int)$user;
    }
}

常见误区

  • 规则里查会话或请求上下文:规则应只依赖传入参数,保持可测试与无状态。
  • 规则返回 null/抛异常被当成通过:按实现明确返回布尔值,异常需在调用层处理。

追问

  • 规则参数从哪里传?答:checkAccess($name, $params) 的第二参数带入业务对象;控制器在动作内取出上下文后传入。
  • 规则数据字段存什么?答:复杂规则可存配置数据(如部门范围),data 字段读取使用,具体以实现为准。

06.5.3.13-006 如何把角色/权限分配给用户并撤销?

一句话结论

assign($role, $userId) 绑定分配,revoke()/revokeAll() 撤销;分配记录按用户 ID 存储,校验时读取用户拥有的全部项。

概念解释

分配可直接挂角色,也可直接挂权限(绕过角色的特例授权)。撤销按项与用户移除记录;用户注销/离职时应清理其分配。后台授权操作需记录审计日志,谁在何时授予了什么角色。

原理流程

  1. 选择目标用户与角色/权限项。
  2. assign() 写入分配表。
  3. 校验时聚合用户分配项及其子树。
  4. 撤销时删除对应分配记录。

代码或图示

$auth = Yii::$app->authManager;
$auth->assign($editor, $userId);

// 撤销
$auth->revoke($editor, $userId);
// 清空某用户全部分配
$auth->revokeAll($userId);

常见误区

  • 离职用户不清理分配:账号禁用后仍可能通过其他会话或接口持有权限。
  • 直接在分配表插数据:绕过组件校验,父子项与规则引用可能不一致。

追问

  • 一个用户能分配多个角色吗?答:可以,权限为多角色并集;冲突策略按业务定义。
  • 分配变更何时生效?答:数据库存储写入后即生效;缓存了权限结果时需刷新缓存(见 06.5.3.13-014)。

06.5.3.13-007 权限校验如何调用?user->can() 与 checkAccess() 是什么关系?

一句话结论

authManager 提供 checkAccess($permissionName, $params) 做底层判定;用户身份组件的 can() 内部基于当前用户 ID 调用 authManager 校验,业务代码通常通过 Yii::$app->user->can() 调用。

概念解释

checkAccess 返回布尔结果,可携带规则参数;can() 绑定当前登录用户,未登录用户按未授权处理。校验点应放在控制器动作或服务层入口,视图按钮级判断只是展示辅助。权限名与创建时保持一致,避免拼写漂移。

原理流程

  1. 动作内取业务上下文参数。
  2. 调用 user->can('article.update', ['article' => $model])。
  3. 内部取用户 ID 调 checkAccess。
  4. 沿层级与规则判定,不通过抛 403 或返回错误。

代码或图示

if (!Yii::$app->user->can('article.update', ['article' => $model])) {
    throw new \yii\web\ForbiddenHttpException('无权操作该文章');
}

常见误区

  • 只在列表/详情页判断权限:更新、删除接口同样必须校验。
  • 校验不传业务参数:数据级规则拿不到记录对象,无法判定归属。

追问

  • 未登录用户 can() 返回什么?答:按未授权处理;具体返回值与异常行为以用户组件实现为准,待确认。
  • 权限名常量化有什么好处?答:避免字符串散落拼写错误,集中定义便于重构与审计。

06.5.3.13-008 权限层级如何继承与聚合?

一句话结论

子项权限被父项包含,用户拥有父项即拥有全部子项;校验时从用户分配项遍历子树聚合,角色之间的包含形成继承链。

概念解释

聚合方向:addChild(parent, child),父包含子。用户被分配角色后,该角色下所有权限及其嵌套子权限都可用。设计时把通用权限放底层角色,岗位角色组合通用角色,减少重复挂载。层级循环会导致遍历问题,需在建模时规避。

原理流程

  1. 权限组织为基础能力集合。
  2. 角色组合基础角色与权限。
  3. 用户分配岗位角色。
  4. 校验遍历分配项子树并合并权限集合。

代码或图示

base.view(查看基础内容)
  └─ editor(编辑角色)
       ├─ article.create
       └─ article.update
admin(管理角色)
  └─ editor(继承编辑全部能力)
       └─ article.delete

常见误区

  • 层级过深:权限来源难以追溯,排障要逐层展开。
  • 同一权限挂多个父项:调整时容易漏改一处。

追问

  • 权限并集还是交集?答:多角色分配取并集;规则条件在各权限项上独立判定。
  • 如何查看某角色包含哪些权限?答:通过 authManager 获取子项列表;后台界面据此展示权限树。

06.5.3.13-009 权限与角色初始化数据如何纳入部署流程?

一句话结论

基础角色权限通过迁移或控制台命令在部署时构建,分配关系可由后台维护;初始化脚本保证各环境权限结构一致,不依赖手工在数据库里逐项录入。

概念解释

部署顺序:先建 RBAC 表,再执行初始化脚本创建权限/角色与层级。脚本要幂等:已存在的项跳过或更新描述,不重复创建。环境差异(如 demo 角色)放本地覆盖配置,不进线上初始化。

原理流程

  1. 迁移创建 RBAC 数据表。
  2. 控制台命令/迁移读取权限定义。
  3. 逐项创建或更新项与父子关系。
  4. 后台运行时再做用户分配。

代码或图示

// 幂等初始化片段(示意)
$existing = $auth->getPermission('article.create');
if ($existing === null) {
    $permission = $auth->createPermission('article.create');
    $auth->add($permission);
}

常见误区

  • 初始化脚本非幂等:重复执行报唯一键冲突或产生重复项。
  • 权限结构只在某台机器手工配置:新环境缺少角色,功能报错。

追问

  • 权限定义放哪里维护?答:代码中的初始化命令/迁移可版本化;运行时动态分配存数据库。
  • 新增权限如何上线?答:新增迁移或命令创建权限并挂到对应角色,再随代码发布。

06.5.3.13-010 AccessControl 过滤器如何与 RBAC 配合?

一句话结论

AccessControl 处理登录状态、访客/登录等粗粒度规则;细粒度操作权限在动作内或服务层调用 RBAC can() 判定,两者组合使用而不是互相替代。

概念解释

AccessControl 规则可配置 allow、roles、permissions、matchCallback;matchCallback 内可调用 checkAccess 接入 RBAC。典型分层:过滤器先挡未登录请求,动作内 RBAC 校验具体操作与数据归属。控制器过滤器组织见 06.5.3.5-007。

原理流程

  1. 控制器 behaviors 注册 AccessControl。
  2. 规则匹配请求:未登录先拒绝放行策略。
  3. 进入动作后 RBAC 校验操作权限与数据规则。
  4. 两级判定都通过才执行业务。

代码或图示

public function behaviors()
{
    return array_merge(parent::behaviors(), [
        'access' => [
            'class' => \yii\filters\AccessControl::class,
            'rules' => [
                ['allow' => true, 'roles' => ['@']],
            ],
        ],
    ]);
}

常见误区

  • 用 AccessControl 的 roles 字段塞 RBAC 角色就以为完成鉴权:仍需在动作内按操作与数据校验。
  • 在过滤器里写复杂数据级规则:上下文记录未加载,规则参数不完整。

追问

  • matchCallback 如何接 RBAC?答:回调内取当前请求与模型上下文,调用 Yii::$app->user->can(),返回布尔控制放行。
  • API 无会话怎么做粗粒度鉴权?答:走令牌认证身份后,动作内 RBAC 校验;过滤器规则按认证状态配置。

06.5.3.13-011 用户身份组件如何实现认证接口?

一句话结论

身份类实现 IdentityInterface:提供 findIdentity、findIdentityByAccessToken、getId、getAuthKey、validateAuthKey 等方法,用户组件据此加载登录用户并保持会话。

概念解释

findIdentity($id) 按会话中的用户 ID 加载身份;findIdentityByAccessToken($token, $type) 用于无会话 API 令牌认证;getAuthKey()/validateAuthKey() 支持会话固定保护类校验。身份类通常对应用户 AR,接口方法返回实现接口的对象或 null。

原理流程

  1. 配置 user 组件的 identityClass。
  2. 登录时凭据校验通过,加载身份对象写入会话。
  3. 后续请求按会话 ID 调 findIdentity 恢复身份。
  4. API 请求按令牌调 findIdentityByAccessToken。

代码或图示

class User extends \yii\db\ActiveRecord implements \yii\web\IdentityInterface
{
    public static function findIdentity($id)
    {
        return static::findOne($id);
    }

    public static function findIdentityByAccessToken($token, $type = null)
    {
        return static::findOne(['access_token' => $token]);
    }

    public function getId() { return $this->id; }
    public function getAuthKey() { return $this->auth_key; }
    public function validateAuthKey($key) { return $this->auth_key === $key; }
}

常见误区

  • 身份类返回数组而非对象:用户组件按接口调用方法,数组不满足接口。
  • 令牌查询不做失效检查:过期/撤销令牌仍被放行。

追问

  • 身份类与 RBAC 用户 ID 如何对应?答:getId() 返回的标识与 auth_assignment.user_id 使用同一用户标识体系。
  • 多端登录会话如何管理?答:会话与 AuthKey 策略在用户组件配置;具体会话固定防护机制以版本为准,待确认。

06.5.3.13-012 登录与登出流程如何完成?

一句话结论

凭据校验通过后调用用户组件 login($identity, $duration) 写入会话;logout() 清除会话与身份关联;登录前绑定来源校验,登出后销毁会话并刷新令牌。

概念解释

login 接受身份对象与记住时长;登录成功前先验证密码哈希(见 06.5.3.10-012)。登出清除会话数据,必要时让 CSRF 令牌与会话重新生成。会话存储机制见 06.5.3.6-006、06.5.3.6-017。

原理流程

  1. 表单模型校验输入。
  2. 按账号查身份,验证密码哈希。
  3. 通过后 login() 写入会话,设置记住登录时长。
  4. 登出调用 logout(),清理会话。

代码或图示

$identity = User::findByUsername($model->username);
if ($identity && $identity->validatePassword($model->password)) {
    Yii::$app->user->login($identity, 3600 * 24 * 7);
} else {
    $model->addError('password', '凭据无效');
}

常见误区

  • 密码校验失败也 login:必须先验证哈希再写会话。
  • 登出只跳页面不调 logout():会话残留,他人复用浏览器仍可访问。

追问

  • 记住登录时长如何配置?答:login 第二参数控制持久化时长;过长效期需权衡被盗风险。
  • 登录失败如何防枚举?答:统一错误文案、失败计数与限流;本章不展开完整爆破防护体系。

06.5.3.13-013 数据级权限如何用规则参数实现归属判定?

一句话结论

动作内加载目标记录后,把记录作为参数传入 can(),规则比对记录归属与当前用户;实现“本人/本部门”级别的行级授权,而不只是功能开关。

概念解释

功能级权限回答“能不能用更新功能”,数据级权限回答“能不能改这一条”。规则参数携带记录、部门等上下文;判定失败返回 403。归属判断也可在服务层显式检查,但复用规则可统一 RBAC 模型管理。

原理流程

  1. 动作按 ID 加载记录。
  2. 调用 can('article.update', ['article' => $record])。
  3. 规则执行比对 author_id 与当前用户。
  4. 不通过抛禁止异常,通过继续业务。

代码或图示

$model = Article::findOne($id);
if ($model === null) {
    throw new \yii\web\NotFoundHttpException();
}
if (!Yii::$app->user->can('article.update', ['article' => $model])) {
    throw new \yii\web\ForbiddenHttpException();
}

常见误区

  • 先返回数据再判断权限:未授权响应不应泄露记录内容。
  • 规则只判断用户角色不判断记录:越权访问他人记录。

追问

  • 部门级归属怎么扩展?答:规则参数带部门 ID,比对用户部门集合;部门关系在用户/组织模型中维护。
  • 批量操作如何逐条鉴权?答:批量场景先按权限条件过滤数据集,再对操作记录逐条或批量校验,不能只验一次功能权限。

06.5.3.13-014 多角色判定与权限性能如何优化?

一句话结论

用户权限为多角色并集,频繁校验时应缓存权限集合与规则结果;避免每次请求遍历数据库表,缓存粒度按用户角色变更失效。

概念解释

DbManager 每次 checkAccess 可能查询层级与分配表;高并发接口应在应用层缓存用户权限集合(角色变更后失效)。规则判定本身很轻,但规则内数据库查询会放大开销,规则参数尽量由上层准备好。

原理流程

  1. 首次加载用户角色与权限集合。
  2. 结果写入缓存,键含用户 ID 与版本。
  3. 后续 can() 先查缓存集合。
  4. 授权变更时清除对应用户缓存。

代码或图示

$cacheKey = "rbac:user:{$userId}";
$permissions = Yii::$app->cache->get($cacheKey);
if ($permissions === false) {
    $permissions = $auth->getPermissionsByUser($userId);
    Yii::$app->cache->set($cacheKey, $permissions, 1800);
}

常见误区

  • 缓存整个权限集合不过期:授权撤销后旧权限仍生效。
  • 规则内反复查库:把归属数据作为参数传入,规则只做比较。

追问

  • 缓存失效时机?答:角色分配/权限层级变更后清除对应用户缓存;批量调整角色时按受影响用户清理。
  • 权限数据量多大需要关注?答:单用户角色权限条目多、接口 QPS 高时优先优化;常规后台场景直接查询通常可接受。

06.5.3.13-015 权限命名与组织有哪些规范?

一句话结论

权限按 资源.动作 命名,按业务域前缀分组;角色按岗位命名,描述面向管理员可读;避免单字母缩写与平铺字符串,权限项集中定义便于审计。

概念解释

命名示例:article.create、article.update、member.impersonate。角色名使用岗位语义(editor、admin),不直接暴露内部 ID。权限描述写清操作范围;高危权限(删除、导出、 impersonate)单独标注并纳入审计。

原理流程

  1. 按业务域划分资源前缀。
  2. 定义动作粒度权限。
  3. 岗位角色组合权限。
  4. 后台界面按层级展示名称与描述。

代码或图示

article.create   创建文章
article.update   编辑文章
article.delete   删除文章
member.export    导出会员数据

常见误区

  • 权限名按页面命名而非操作:同一页面多个动作无法细分。
  • 角色名与权限名混用:层级模型混乱,难以复用。

追问

  • 动作粒度多细合适?答:按业务风险与界面操作划分;高危操作独立授权,普通查看可合并。
  • 命名变更影响什么?答:代码校验点、后台分配与缓存键都需同步;重命名属于破坏性变更,需全量检索。

06.5.3.13-016 视图与按钮级控制如何与后端鉴权配合?

一句话结论

视图用 can() 判断是否显示按钮/菜单,属于体验层;后端动作校验才是安全边界,前端隐藏不能替代授权检查。

概念解释

按钮级判断减少界面干扰,但用户可直接构造请求访问动作;每个受保护动作必须在后端重复校验。菜单权限同样基于权限集合渲染,未授权入口不显示。权限判定结果可在视图前由控制器准备,避免视图内重复查询。

原理流程

  1. 后端动作先完成 RBAC 校验。
  2. 视图按同一权限名判断按钮显隐。
  3. 未授权请求被后端 403 拦截。
  4. 审计日志记录拒绝与通过的高危操作。

代码或图示

<?php if (Yii::$app->user->can('article.delete')): ?>
    <?= Html::a('删除', ['delete', 'id' => $model->id], ['data-method' => 'post']) ?>
<?php endif; ?>

常见误区

  • 视图判断后认为接口安全:直接请求动作仍需后端校验。
  • 权限名在视图与动作中各写一份不一致:显隐与实际授权错位。

追问

  • 菜单数据如何按权限过滤?答:菜单配置项绑定权限名,渲染时遍历 can() 过滤;菜单结构与权限定义对应维护。
  • 高危操作二次确认怎么做?答:前端确认框只是交互,后端仍需权限校验与审计记录。

06.5.3.13-017 3.0 的授权组件与 2.x 有何对照?

一句话结论

3.0 授权能力位于独立 RBAC 包,规则与授权项走接口抽象,装配通过容器完成;模型思想(角色、权限、规则、分配)延续,类命名空间、存储实现与配置方式与 2.x 不同,具体以安装包文档为准。

概念解释

2.x authManager 是框架组件;3.0 包化后授权服务作为接口注册到容器,控制器/服务通过注入获取。存储实现(PHP/DB)按包提供。迁移时核对规则接口签名、权限项方法名与分配表结构,不照搬 2.x 类名。

原理流程

  1. 确认 3.0 RBAC 包版本与文档。
  2. 梳理 2.x 权限定义、规则类与校验点。
  3. 按新包接口重建授权服务与存储。
  4. 补充授权测试用例回归。

代码或图示

2.x:yii\rbac\DbManager 组件 + Yii::$app->authManager
3.0:独立 rbac 包 + 容器注入授权服务(具体类名待确认)

常见误区

  • 把 2.x Rule 类直接继承到 3.0:基类命名空间与接口方法可能调整。
  • 继续用全局定位器取授权服务:3.0 倾向显式注入,全局访问是待解耦点。

追问

  • 哪些 RBAC 设计可跨版本复用?答:权限命名规范、角色岗位划分、数据级规则思路、权限审计要求。
  • 如何核实 3.0 授权 API?答:查看已安装包的接口与实现类、README;本机未装 vendor 时不写实测结论。

06.5.3.13-018 认证与会话在多端/无状态场景如何处理?

一句话结论

Web 会话认证依赖 session 组件;无状态 API 使用访问令牌,身份通过 findIdentityByAccessToken 加载,不写服务端会话;令牌需有签发、过期、撤销与审计策略。

概念解释

会话模式:登录后服务端记录身份,Cookie 携带会话标识。令牌模式:请求头携带令牌,服务端校验令牌并加载身份,可水平扩展无会话状态。令牌存储、刷新与撤销属于安全设计,框架只提供身份加载接口。多端共存时各端令牌独立失效。

原理流程

  1. 凭据交换签发访问令牌(含过期时间)。
  2. 请求携带令牌,身份类按令牌查用户。
  3. 加载身份后进入动作鉴权链。
  4. 过期/撤销令牌拒绝访问。

代码或图示

// API 动作内按令牌加载身份(示意,令牌校验细节由认证过滤器/组件完成)
$identity = User::findIdentityByAccessToken($token);

常见误区

  • 令牌永久有效:泄露后无法收敛,必须设过期与撤销机制。
  • 无状态接口仍读 session:状态存储与扩展模型不一致。

追问

  • 令牌放哪里传输?答:请求头 Authorization 方案;不要放 URL 查询参数,避免日志泄露。
  • 刷新令牌怎么管理?答:长有效期刷新令牌配合短访问令牌;本章不展开完整 OAuth/JWT 体系。

06.5.3.13-019 常见越权与权限事故有哪些类型?

一句话结论

高频事故包括:前端隐藏按钮但后端不校验、直接改 ID 访问他人记录(水平越权)、普通角色访问管理动作(垂直越权)、分配未清理、规则参数缺失导致放行。

概念解释

水平越权:同级别用户访问他人数据;垂直越权:低权限调用高权限功能。防护:每个动作后端校验、数据级规则传记录对象、敏感字段不进批量赋值(见 06.5.3.10-006)、离职清理分配。测试用例覆盖他人 ID、越权角色与缺失参数场景。

原理流程

  1. 盘点所有受保护动作与权限点。
  2. 每个动作补功能级与数据级校验。
  3. 构造越权请求回归测试。
  4. 审计日志监控拒绝事件与高危操作。

代码或图示

越权类型
水平越权:改他人记录 ID 访问
垂直越权:普通账号调用管理动作
分配残留:离职/降权后旧角色仍有效
规则绕过:上下文参数缺失时误判通过

常见误区

  • 认为登录后就安全:认证不等于授权,登录用户仍需逐项授权。
  • 列表接口过滤了他人数据,详情/更新接口漏校验:越权点常在单条记录接口。

追问

  • 如何做授权测试?答:用不同角色账号分别请求各动作与他人记录 ID,断言 403;自动化用例纳入回归。
  • 权限变更后旧会话怎么办?答:必要时强制重新登录或失效会话;撤销权限后缓存同步清理。

06.5.3.13-020 认证授权章节有哪些高频踩坑与检查清单?

一句话结论

高频问题集中在:只做前端隐藏、后端动作漏校验、规则缺上下文、分配残留、权限无缓存失效、3.0 API 照搬;交付前按“身份接口齐备、动作逐点鉴权、数据规则传参、分配可撤销、命名规范、缓存可失效、越权用例回归”逐项检查。

概念解释

检查清单覆盖:authManager 存储选型、表结构齐备、权限角色层级与幂等初始化、规则无状态判定、分配与撤销、can() 校验点分布、身份接口方法、登录登出流程、多角色缓存失效、视图按钮与后端一致、API 令牌加载、越权测试覆盖。不确定的方法签名与默认行为标注待确认并对照文档实测。

原理流程

  1. 梳理权限点清单与对应动作。
  2. 核对身份类接口与认证流程。
  3. 检查每个动作的功能级 + 数据级校验。
  4. 审计分配清理、缓存失效与命名规范。
  5. 用多角色与他人记录 ID 回归越权场景。

代码或图示

RBAC 自检
[ ] authManager 存储与表结构符合生产要求
[ ] 权限/角色/层级由幂等脚本初始化
[ ] 规则只依赖传入参数,返回明确布尔值
[ ] 受保护动作后端逐点调用 can()
[ ] 数据级规则携带目标记录上下文
[ ] 分配可撤销,离职清理残留角色
[ ] 权限缓存随授权变更失效
[ ] 视图显隐与后端权限名一致
[ ] 越权(水平/垂直)有测试用例回归
[ ] 高危操作有审计记录

常见误区

  • 把 RBAC 配置完就视为安全:校验点是否覆盖全部动作才是落地关键。
  • 权限模型过度复杂:角色层级与规则按业务需要设计,能简单角色聚合就不要堆规则。

追问

  • 权限审计记录哪些内容?答:谁在何时对哪条记录执行了什么操作、结果通过或拒绝;日志通道见日志组件相关章节。
  • 新功能上线如何补权限?答:先定义权限点与角色挂载,再在动作与视图接入;未授权默认拒绝,不默认放行。