jCasbin 是一个用 Java 语言打造的轻量级开源访问控制框架（ https://github.com/casbin/jcasbin ），目前在 GitHub 开源。jCasbin 采用了元模型的设计思想，支持多种经典的访问控制方案，如基于角色的访问控制 RBAC、基于属性的访问控制 ABAC 等。
jCasbin 的主要特性包括：
- 支持自定义请求的格式，默认的请求格式为{subject, object, action}；
- 具有访问控制模型 model 和策略 policy 两个核心概念；
- 支持 RBAC 中的多层角色继承，不止主体可以有角色，资源也可以具有角色；
- 支持超级用户，如 root 或 Administrator，超级用户可以不受授权策略的约束访问任意资源；
- 支持多种内置的操作符，如 keyMatch，方便对路径式的资源进行管理，如 /foo/bar 可以映射到 /foo*；
jCasbin 不做的事情：
- 身份认证 authentication （即验证用户的用户名、密码），jCasbin 只负责访问控制。应该有其他专门的组件负责身份认证，然后由 jCasbin 进行访问控制，二者是相互配合的关系；
- 管理用户列表或角色列表。jCasbin 认为由项目自身来管理用户、角色列表更为合适，jCasbin 假设所有策略和请求中出现的用户、角色、资源都是合法有效的。
安装
git clone https://github.com/casbin/jcasbin
HelloWorld 例子
初始化一个 enforcer，传入两个参数：模型文件路径和策略文件路径；
Enforcer enforcer = new Enforcer("path/to/model.conf", "path/to/policy.csv");
在你的代码需要进行访问控制的位置，加入如下钩子；
String sub = "alice"; // the user that wants to access a resource.
String obj = "data1"; // the resource that is going to be accessed.
String 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 进行权限的管理，如获取一个用户所有的角色；
Roles roles = enforcer.getRoles("alice");
请参考src/test包获得更多的使用方法。
社区进展
casbin 目前正在积极向社区进行推送，已经联系的社区包括 Apache Shiro、Sentry，将来有可能推送到 Spring Security 社区。
协议
casbin 采用 Apache 2.0 开源协议发布。
联系作者
有问题请提交 Issues: https://github.com/casbin/jcasbin/issues，或者联系我 QQ: 515964173
Select Language