摘要:采用了元模型的设计思想,支持多种经典的访问控制方案,如基于角色的访问控制基于属性的访问控制等。社区进展目前正在积极向社区进行推送,目前通过插件的方式已经支持与等框架进行集成,将来会推广到更多框架以及社区。
jCasbin是一个用Java语言打造的轻量级开源访问控制框架(),目前在GitHub开源。jCasbin采用了元模型的设计思想,支持多种经典的访问控制方案,如基于角色的访问控制RBAC、基于属性的访问控制ABAC等。
jCasbin的主要特性包括:
支持自定义请求的格式,默认的请求格式为{subject, object, action};
具有访问控制模型model和策略policy两个核心概念;
支持RBAC中的多层角色继承,不止主体可以有角色,资源也可以具有角色;
支持超级用户java用户角色权限设计程序开发,如root或Administrator,超级用户可以不受授权策略的约束访问任意资源;
支持多种内置的操作符,如keyMatch,方便对路径式的资源进行管理,如/foo/bar可以映射到/foo*;
jCasbin不做的事情:
身份认证authentication(即验证用户的用户名、密码),jCasbin只负责访问控制。应该有其他专门的组件负责身份认证java用户角色权限设计,然后由jCasbin进行访问控制,二者是相互配合的关系;
管理用户列表或角色列表。jCasbin认为由项目自身来管理用户、角色列表更为合适,jCasbin假设所有策略和请求中出现的用户、角色、资源都是合法有效的。
安装
Maven:
org.casbin jcasbin 0.0.4-FIX
HelloWorld例子
初始化一个enforcer,传入两个参数:模型文件路径和策略文件路径;
Enforcer enforcer = new Enforcer("path/to/model.conf", "path/to/policy.csv");
在你的代码需要进行访问控制的位置3D道具,加入如下钩子;
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包获得更多的使用方法。
社区进展
jCasbin目前正在积极向社区进行推送,目前通过插件的方式已经支持与Spring Boot、JFinal等Web框架进行集成,将来会推广到更多Web框架以及社区。jCasbin已经有Golang版本和PHP版本。有跨语言需求的开发者可以只用Casbin这一套框架就实现多个不同语言的项目的权限管理任务。
Casbin:
PHP-Casbin:
协议
jCasbin采用Apache 2.0开源协议发布。
联系作者
有问题请提交Issues: ,或者加入QQ群:546057381(Casbin访问控制讨论群)