Casbin：支持 ACL、RBAC、ABAC 多种模型的 Nodejs 权限管理框架

发布于 1周前 作者 nodeper 来自 nodejs/Nestjs

Casbin：支持 ACL、RBAC、ABAC 多种模型的 Nodejs 权限管理框架

这里写图片描述 casbin

Node-Casbin 是一个用 Node.js 语言打造的轻量级开源访问控制框架（ https://github.com/casbin/node-casbin )，目前在 GitHub 开源。Node-Casbin 采用了元模型的设计思想，支持多种经典的访问控制方案，如基于角色的访问控制 RBAC 、基于属性的访问控制 ABAC 等。

Node-Casbin 的主要特性包括：

  1. 支持自定义请求的格式，默认的请求格式为{subject, object, action}；
  2. 具有访问控制模型 model 和策略 policy 两个核心概念；
  3. 支持 RBAC 中的多层角色继承，不止主体可以有角色，资源也可以具有角色；
  4. 支持超级用户，如 root 或 Administrator，超级用户可以不受授权策略的约束访问任意资源；
  5. 支持多种内置的操作符，如 keyMatch，方便对路径式的资源进行管理，如 /foo/bar 可以映射到 /foo*；

Node-Casbin 不做的事情：

  1. 身份认证 authentication （即验证用户的用户名、密码），Node-Casbin 只负责访问控制。应该有其他专门的组件负责身份认证，然后由 Node-Casbin 进行访问控制，二者是相互配合的关系；
  2. 管理用户列表或角色列表。Node-Casbin 认为由项目自身来管理用户、角色列表更为合适，Node-Casbin 假设所有策略和请求中出现的用户、角色、资源都是合法有效的。

安装

npm install casbin

HelloWorld 例子

初始化一个 enforcer，传入两个参数：模型文件路径和策略文件路径；

const enforcer = new Enforcer('path/to/model.conf', 'path/to/policy.csv');

在你的代码需要进行访问控制的位置，加入如下钩子；

const sub = 'alice'; // the user that wants to access a resource.
const obj = 'data1'; // the resource that is going to be accessed.
const act = 'read'; // the operation that the user performs on the resource.

if (enforcer.enforce(sub, obj, act) == true) {
// permit alice to read data1
} else {
// deny the request, show an error
}

采用管理 API 进行权限的管理，如获取一个用户所有的角色；

const roles = enforcer.getRoles('alice');

请参考test目录获得更多的使用方法。

社区进展

Node-Casbin 目前正在积极向社区进行推送，目前通过插件的方式已经支持与 Koa2 等 Web 框架进行集成，将来会推广到更多 Web 框架以及社区。Casbin 已经有 Golang 版本、Java 版本和 PHP 版本。有跨语言需求的开发者可以只用 Casbin 这一套框架就实现多个不同语言的项目的权限管理任务。

协议

Node-Casbin 采用 Apache 2.0 开源协议发布。

联系作者

有问题请提交 Issues: https://github.com/casbin/node-casbin/issues

或者加入 QQ 群：546057381（ Casbin 访问控制讨论群）


Harmonyos Next教程
3 回复

npcap 作者？


npcap 很火么？为啥都说这个

Casbin确实是一个功能强大的Node.js权限管理框架，它支持ACL（访问控制列表）、RBAC（基于角色的访问控制）和ABAC（基于属性的访问控制）等多种访问控制模型。以下是对Casbin的简要介绍和一些代码示例：

Casbin的核心特性

  • 多模型支持：Casbin提供了ACL、RBAC和ABAC等多种访问控制模型的实现，可根据项目需求灵活选择。
  • 动态策略管理：可以在运行时动态地添加、删除或修改权限策略。
  • 易于集成：易于与现有的Node.js应用程序集成。
  • 高性能：通过优化的算法和缓存机制，确保权限检查的高效性。
  • 可扩展性：支持多种存储适配器，包括文件、数据库等，便于扩展。

代码示例

以下是一个简单的Casbin配置和使用示例：

const { Enforcer } = require('casbin');

// 初始化Casbin执行器
const enforcer = await Enforcer.newEnforcer('path/to/model.conf', 'path/to/policy.csv');

// 加载策略
await enforcer.loadPolicy();

// 权限检查
const sub = 'alice'; // 主体
const obj = 'data1'; // 对象
const act = 'read';  // 动作

if (await enforcer.enforce(sub, obj, act)) {
    console.log('Access granted.');
} else {
    console.log('Access denied.');
}

总之，Casbin凭借其多样的访问控制模型、快速的决策过程以及易于集成的特性，成为了Node.js开发者构建安全应用程序的首选工具之一。

回到顶部