跳到主要内容

Policy Storage

Casbin 中的策略存储由 adapters 处理。enforcer 通过 adapter API 加载并(可选地)保存策略。

Loading policy from a CSV file​

使用 CSV 文件是最简单的选项,非常适合开发和示例。

Example: examples/rbac_policy.csv

p, alice, data1, read
p, bob, data2, write
p, data2_admin, data2, read
p, data2_admin, data2, write
g, alice, data2_admin
备注

如果字段包含逗号,请用双引号将其包裹:

p, alice, "data1,data2", read --correct
p, alice, data1,data2, read --incorrect (the whole phrase "data1,data2" should be wrapped in double quotes)

如果字段同时包含逗号和双引号,请用双引号将其包裹,并通过加倍内部引号来转义:

p, alice, data, "r.act in (""get"", ""post"")" --correct
p, alice, data, "r.act in ("get", "post")" --incorrect (you should use "" to escape "")

参见 casbin#886。

Adapter API​

方法类型描述
LoadPolicy()basicLoad all policy rules from the storage
SavePolicy()basicSave all policy rules to the storage
AddPolicy()optionalAdd a policy rule to the storage
RemovePolicy()optionalRemove a policy rule from the storage
RemoveFilteredPolicy()optionalRemove policy rules that match the filter from the storage

Database Storage Format​

示例策略 (CSV)

p, data2_admin, data2, read
p, data2_admin, data2, write
g, alice, admin

典型数据库布局(例如 MySQL)

idptypev0v1v2v3v4v5
1pdata2_admindata2read
2pdata2_admindata2write
3galiceadmin

列说明

  • id — 主键(适配器特定;不属于 Casbin 策略的一部分)。
  • ptype — 策略类型:p, g, g2 等。
  • v0–v5 — 按顺序排列的策略字段(在 CSV 中从左到右)。大多数适配器使用 6 列;有些支持更多。如果需要额外字段,请查阅适配器文档。

有关完整的适配器 API 和设计细节,请参阅 Adapters。

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