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() | basic | Load all policy rules from the storage |
| SavePolicy() | basic | Save all policy rules to the storage |
| AddPolicy() | optional | Add a policy rule to the storage |
| RemovePolicy() | optional | Remove a policy rule from the storage |
| RemoveFilteredPolicy() | optional | Remove 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)
| id | ptype | v0 | v1 | v2 | v3 | v4 | v5 |
|---|---|---|---|---|---|---|---|
| 1 | p | data2_admin | data2 | read | |||
| 2 | p | data2_admin | data2 | write | |||
| 3 | g | alice | admin |
列说明
- 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.