Casbin 使用记录

阅读原文时间：2023年07月09日阅读：1

Casbin 是什么？

官方解释：Casbin是一个强大的、高效的开源访问控制框架，其权限管理机制支持多种访问控制模型。

Casbin只负责访问控制。身份认证 authentication（即验证用户的用户名、密码），需要其他专门的身份认证组件负责。例如（jwt-go）

两个核心概念：

访问控制模型model和策略policy。

工作原理：

Casbin把访问控制模型被抽象为基于

PERM元模型 (Policy, Effect, Request, Matchers) [策略，效果，请求，匹配器]

PERM(Policy, Effect, Request, Matchers)模型很简单, 但是反映了权限的本质 – 访问控制

Policy: 定义权限的规则
Effect: 定义组合了多个 Policy 之后的结果, allow/deny
Request: 访问请求, 也就是谁想操作什么
Matcher: 判断 Request 是否满足 Policy

匹配来源：定义的 request 和存储的 police 比对判断。

所有 model file 中主要就是定义 PERM 4 个部分。

的一个文件（ model.conf , 这个文件一般是固定的）。因此，切换或升级项目的授权机制与修改配置一样简单。您可以通过组合可用的模型来定制您自己的访问控制模型（ACL， RBAC, ABAC）。例如，您可以在一个model中获得RBAC角色和ABAC属性，并共享一组policy规则。

Casbin中最基本、最简单的model是ACL。ACL中的model CONF为:

# Request definition
[request_definition] 自定义请求的格式
r = sub, obj, act

Policy definition

[policy_definition] 策略定义
p = sub, obj, act

Policy effect

[policy_effect]
e = some(where (p.eft == allow))

Matchers

[matchers]
m = r.sub == p.sub && r.obj == p.obj && r.act == p.act

　　g, g2, g3 表示不同的 RBAC 体系, _, _ 表示用户和角色 _, _, _ 表示用户, 角色, 域(也就是租户)

ACL model的示例policy如下:

p, alice, data1, read
p, bob, data2, write

Model 语法：

Model CONF 至少应包含四个部分: [request_definition], [policy_definition], [policy_effect], [matchers]。
如果 model 使用 RBAC, 还需要添加[role_definition]部分

policy 不同，model 只能加载，不能保存。因为我们认为 model 不是动态组件，不应该在运行时进行修改，所以我们没有实现一个 API 来将 model 保存到存储中.

policy file

定义具体的策略, 权限的检查就是基于定义的 model file 和 policy file 来完成的.

相对于 model file 定义规则, policy file 中定义的就是具体的内容.

如何使用？

创建一个Casbin决策器需要有一个模型文件和策略文件为参数：

import "github.com/casbin/casbin"

e := casbin.NewEnforcer("path/to/model.conf", "path/to/policy.csv")

在访问发生之前, 在代码中添加强制挂钩:（这一步就是校验访问控制权，然后根据返回值做对象的分之操作）

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

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

casbin 存储到数据库的记录是策略，访问控制模型当系统确定户基本很少改动。可以存储到项目配置文件（本地）

casbin 存储RBAC方案中用户和角色之间的映射关系。（而这个关系是基于 midel 访问控制模型）

权限管理系统最好全局依赖一个Casbin 决策器（这个决策器依赖模型文件和策略文件为参数）

在访问发生之前，在代码中加入强制钩子，控制。

这个请求格式是可以自定义的，默认为默认的请求格式为 { subject, object , action }

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

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

Casbin 模型可以是多个组合。也可以共享同一组policy规则。

数据库里存储的策略第一个字段代表的是在 model 里定义的模型类型。

p, alice, data1, read 其中的 p 是在 model.conf 文件中定义好的。