jCasbin: 强大的访问控制、权限管理框架,支持 ACL, RBAC, ABAC
转自本人的csdn博客:blog.csdn.net/qq_17792831/article/...
jcasbin 是一个用 Java 语言打造的轻量级开源访问控制框架github.com/casbin/jcasbin,是Casbin的Java语言版本。目前在 GitHub 开源。jcasbin 采用了元模型的设计思想,支持多种经典的访问控制方案,如基于角色的访问控制 RBAC、基于属性的访问控制 ABAC 等。
jcasbin 的主要特性包括:
- 支持自定义请求的格式,默认的请求格式为{subject, object, action};
- 具有访问控制模型 model 和策略 policy 两个核心概念;
- 支持 RBAC 中的多层角色继承,不止主体可以有角色,资源也可以具有角色;
- 支持超级用户,如 root 或 Administrator,超级用户可以不受授权策略的约束访问任意资源;
- 支持多种内置的操作符,如 keyMatch,方便对路径式的资源进行管理,如 /foo/bar 可以映射到 /foo*;
jcasbin 不做的事情:
- 身份认证 authentication (即验证用户的用户名、密码),jcasbin 只负责访问控制。应该有其他专门的组件负责身份认证,然后由 jcasbin 进行访问控制,二者是相互配合的关系;
- 管理用户列表或角色列表。jcasbin 认为由项目自身来管理用户、角色列表更为合适,jcasbin 假设所有策略和请求中出现的用户、角色、资源都是合法有效的。
在Maven中引用
<dependency>
<groupId>org.casbin</groupId>
<artifactId>jcasbin</artifactId>
<version>1.5.0</version>
</dependency>
HelloWorld 例子
初始化一个 enforcer,传入两个参数:模型文件路径和策略文件路径;
Enforcer enforcer = new Enforcer("examples/model.conf", "examples/policy.csv");
在你的代码需要进行访问控制的位置,加入如下钩子;
String sub = "alice";
String obj = "data1";
String act = "read";
if (enforcer.enforce(sub, obj, act) == true) {
// permit alice to read data1
} else {
// deny the request, show an error
}
采用管理 API 进行权限的管理,如获取一个用户所有的角色;
roles = enforcer.getRoles("alice");
请参考test目录下的测试类获得更多的使用方法。
社区进展
jcasbin 目前正在积极向社区进行推送,已经联系的社区包括 etcd、tango,将来有可能推送到 docker 社区。
协议
jcasbin 采用 Apache 2.0 开源协议发布。
联系作者
有问题请提交 Issues: github.com/casbin/jcasbin/issues
或者联系作者 QQ: 515964173
本作品采用《CC 协议》,转载必须注明作者和本文链接