RBAC 权限模型与接口级权限控制

通过角色分配操作权限,并在实际接口中同时检查权限与资源归属

🎯 引言

学完这篇文章,你能通过角色分配操作权限,并在实际接口中同时检查权限与资源归属。

🧱 用户关联角色,角色关联权限

RBAC 是基于角色的访问控制。把“编辑文章”“删除文章”等操作定义为权限,再把一组权限授予角色,用户通过角色获得权限。

角色允许操作
readerarticle:read
editorarticle:read、article:update
adminarticle:read、article:update、article:delete

权限字符串是项目自定的标识。数据库里可以分别保存用户角色关系和角色权限关系,不需要每个接口都写死“角色等于 admin”。


🔍 编写单一的权限判断

新建 permissions.mjs:

permissions.mjs
const permissions = {
    reader: ['article:read'],
    editor: ['article:read', 'article:update'],
    admin: ['article:read', 'article:update', 'article:delete']
};

export function hasPermission(actor, permission) {
    return actor.roles.some(role => permissions[role]?.includes(permission));
}

actor.roles 来自服务器可信用户记录,不能直接使用客户端提交的角色数组。返回 true 表示角色允许这类操作,还没有判断某篇文章是否属于当前用户。


🚪 在接口前检查操作权限

身份验证中间件应先将可信用户记录放入 res.locals.user,例如 { id: 1, roles: ['editor'] }。在 permissions.mjs 添加权限检查中间件:

permissions.mjs
export function requireArticleUpdate(req, res, next) {
    const user = res.locals.user;
    if (!user) return res.status(401).json({ error: '请先登录' });
    if (!hasPermission(user, 'article:update')) {
        return res.status(403).json({ error: '没有修改文章的权限' });
    }
    next();
}

编辑者通过后进入下一个处理函数;只读角色得到 403;未登录得到 401。身份中间件必须从会话或验证后的令牌取得用户,不能把请求中的角色直接放进 locals。


🔒 再检查文章属于谁

角色允许编辑,还需要判断目标文章的归属。在同一文件定义业务判断:

permissions.mjs
export function canEditArticle(user, article) {
    return user.roles.includes('admin') || article.ownerId === user.id;
}

article 应来自数据库查询。这里约定管理员可跨用户修改,普通编辑者只能修改本人文章。更新接口应先执行权限中间件,再查询文章,调用归属判断,通过后才写入数据库。


🧪 检查角色和归属的组合

新建 permission-demo.mjs:

permission-demo.mjs
import { hasPermission, canEditArticle } from './permissions.mjs';

const editor = { id: 1, roles: ['editor'] };
console.log(hasPermission(editor, 'article:update'));
console.log(canEditArticle(editor, { ownerId: 1 }));
console.log(canEditArticle(editor, { ownerId: 2 }));

运行后输出 true、true、false。编辑者有修改资格,但对其他用户的文章仍应返回 403。


⚠️ 权限变化要及时生效

管理员移除某角色后,不能继续无限信任旧 Token 内的角色。敏感操作可查询当前权限,或用权限版本和短有效期控制更新延迟。

默认应拒绝没有明确授予的操作。新增接口时要明确它公开还是受保护,不能因为忘记登记权限就自动公开。


❓ 知识问答

Q1:菜单隐藏能替代 RBAC 吗?

不能,菜单只是展示结果。权限必须在真实接口执行前检查。

Q2:有 article:update 就能修改所有文章吗?

不一定,操作类型权限与数据范围是两层检查,本文还限制了归属。

Q3:所有项目都需要很多角色吗?

不需要。先从实际职责划分少量角色,不要为每个用户单独发明一个角色。


🧪 小练习

增加 reviewer 角色,只允许读取文章。验证它即使面对自己创建的文章,也不能通过 article:update 检查。

// 请在这里编写代码或记录验证结果