跳到主要内容

工作原理

在 Casbin 中,访问控制基于 PERM 元模型(Policy、Effect、Request、Matchers) 以 CONF 文件的形式表达。更改项目中的授权工作方式只需编辑配置文件即可。您可以通过组合组件来构建自定义模型——例如,将 RBAC 角色与 ABAC 属性结合在单个模型和策略集中。

PERM 模型包含四个部分:Request、Policy、Effect 和 Matchers。它们共同定义了用户和资源如何交互。

请求​

请求定义指定了访问请求的参数。基本请求是一个由三个元素组成的元组:subject(谁在请求)、object(资源)和 action(操作)。

示例:

r = sub, obj, act

这设置了匹配逻辑的参数名称及其顺序。

Policy​

策略定义描述了访问规则的形状:字段名称和顺序。

示例:

p = sub, obj, act 或 p = sub, obj, act, eft

当定义中省略 eft(策略效果)时,策略文件中的 effect 字段将被忽略,匹配的策略被视为“允许”。

Matcher​

匹配器定义了如何将请求与策略进行匹配。

示例:m = r.sub == p.sub && r.act == p.act && r.obj == p.obj

当请求的主体、对象和操作与策略的字段匹配时,将使用该策略的效果(p.eft)。效果存储在 p.eft 中。

效果​

效果部分使用逻辑表达式组合所有匹配策略的效果。

示例:e = some(where (p.eft == allow))

如果任何匹配的策略具有“允许”效果,则结果为允许。

另一个示例:

e = some(where (p.eft == allow)) && !some(where (p.eft == deny))

这意味着:仅当至少有一个策略允许且没有策略拒绝时,结果才为允许。如果同时匹配到允许和拒绝,拒绝优先。

ACL 是 Casbin 中最简单的模型。以下是一个最小化的 ACL 模型:

# 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

此模型的示例策略:

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

因此:

  • alice 可以读取 data1
  • bob 可以写入 data2

您可以通过在每行末尾添加 \ 来跨行拆分匹配器:

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

in 运算符在 Go 实现中可用(jCasbin 或 Node-Casbin 尚未支持):

# Matchers
[matchers]
m = r.obj == p.obj && r.act == p.act || r.obj in ('data2', 'data3')
警告

数组必须包含多于一个元素;否则 Go 实现可能会发生 panic。

有关更多运算符,请参阅 govaluate。

Comments are powered by giscus and GitHub Discussions. They load from giscus.app and GitHub only after you click the button below.