OpenFGA 是一个开源授权引擎。其文档说,其模型语言的 JSON 形式,也就是 API 所接受的形式,“closely tracks the language in the Zanzibar paper”(紧密沿用 Zanzibar 论文中的语言);DSL 则增加了语法糖,并编译为该 JSON(配置语言)。CNCF 宣布其进入孵化阶段的文章说,它 “was developed by a group of Okta employees, and is the foundation for the Auth0 FGA commercial offering”(由一群 Okta 员工开发,是 Auth0 FGA 商业产品的基础)(CNCF,2025-11-11)。它用 Go 编写,采用 Apache-2.0 许可证(仓库)。Auth0 的托管服务称自己 “based on OpenFGA, an open-source project owned by the Cloud Native Computing Foundation”(基于 OpenFGA,一个归云原生计算基金会所有的开源项目)(Auth0 FGA 文档)。
论文术语与 OpenFGA 术语
OpenFGA 自己的文档中有一张 “Equivalent Zanzibar Concepts”(对应的 Zanzibar 概念)表(配置语言);下表把它扩展到了 API 和存储。
| 论文中 | OpenFGA 中 |
|---|---|
| 命名空间配置(§2.3) | 授权模型中的一个 type,用 DSL 或 JSON 编写(配置语言) |
关系元组 object#relation@user(§2.1) |
包含 user、relation、object 的关系元组(relationship tuple),例如 user:anne、owner、doc:readme;用户集写作 group:eng#member |
_this(§2.3.1) |
直接类型限制,例如 [user, group#member](JSON 中为 this) |
computed_userset |
直接写关系名,例如 or owner |
tuple_to_userset |
viewer from parent(JSON 中为 tupleToUserset) |
union / intersection / exclusion |
or / and / but not(JSON 中为 union / intersection / difference) |
| zookie(§2.4) | 无;查询选择 MINIMIZE_LATENCY 或 HIGHER_CONSISTENCY(一致性) |
| Check(§2.4.4) | Check、BatchCheck |
| Read(§2.4.1) | Read |
| Write(§2.4.2) | Write |
| Watch(§2.4.3) | ReadChanges,一种带续传令牌的分页列表读取(元组变更) |
| Expand(§2.4.5) | Expand |
| 不在论文的 API 中 | ListObjects、StreamedListObjects、ListUsers;store;模型版本(WriteAuthorizationModel、ReadAuthorizationModel(s)) |
| Leopard(§3.2.4) | 这里引用的文档中没有对应物 |
| Spanner(§3) | memory(默认)、postgres、mysql、sqlite(配置 OpenFGA) |
API 名称来自 openfga_service.proto。
用模型表示贯穿示例
论文的图 1 使所有者成为编辑者,编辑者成为查看者,父文件夹的查看者成为文档的查看者(§2.3.1)。在 OpenFGA 的 DSL 中,同样的规则每个关系占一行:
model
schema 1.1
type user
type group
relations
define member: [user]
type folder
relations
define viewer: [user, group#member]
type doc
relations
define parent: [folder]
define owner: [user]
define editor: [user, group#member] or owner
define viewer: [user, group#member] or editor or viewer from parent
Anne、Beto 和 Chen 的元组:
| user | relation | object |
|---|---|---|
user:anne |
owner |
doc:readme |
folder:A |
parent |
doc:readme |
user:beto |
member |
group:eng |
group:eng#member |
viewer |
doc:readme |
user:chen |
viewer |
folder:A |
对每个人检查 readme 上的 viewer 时,分别会经过这些元组中的哪些?
注意,承载“所有者是编辑者”和“编辑者是查看者”的是模型,而不是元组:这正是论文的观点,即关系之间的关系应放在配置中,而不是为每个对象存一个元组(§2.3.1)。
架构
一个 OpenFGA 部署由什么组成?文档描述的是一组服务器加一个 SQL 数据存储。每台服务器可以为 Check 维护内存缓存,生产指南建议使用 “a small pool of servers with high capacity (memory and CPU cores) instead of a big pool of servers, to increase cache hit ratios”(一个由高容量(内存和 CPU 核心)服务器组成的小池,而不是一个大池,以提高缓存命中率)(在生产环境中运行)。对于 PostgreSQL,可以配置一个二级(只读副本)数据存储;HIGHER_CONSISTENCY 的读取发往主库(配置 OpenFGA)。变更的消费者调用 ReadChanges 并保存续传令牌(元组变更)。
对比论文的图 2(§3):aclservers 相互扇出工作,watchservers 推送流,Leopard 维护一个反规范化索引。这里引用的 OpenFGA 文档对这三者都没有描述;服务器根据数据存储和自己的缓存作答。
没有 zookie 的一致性
OpenFGA 没有 zookie。其文档在 “Future work”(未来工作)下说明了这一点:论文 “has a feature called Zookies”(有一项名为 Zookies 的功能),而 OpenFGA “is considering a similar feature in future releases”(正在考虑在未来版本中加入类似功能)(一致性)。取而代之的是,Read 和各查询 API 接受以下两个值之一:
| 模式 | 行为(一致性文档) | 论文中的对应 |
|---|---|---|
MINIMIZE_LATENCY(默认) |
“will serve queries from the cache when possible”(会尽可能从缓存中提供查询结果) | 不带 zookie 的请求:“a reasonably recent snapshot”(一个合理较新的快照)(§2.4.1) |
HIGHER_CONSISTENCY |
“will skip the cache and query the database directly”(会跳过缓存,直接查询数据库) | 没有完全对应的;最接近的是在最新快照上评估 |
缓存 “disabled by default”(默认关闭),此时 “all queries will have strong consistency regardless of the consistency mode specified”(无论指定哪种一致性模式,所有查询都将具有强一致性)(一致性)。只有在开启缓存之后,模式才有意义。
开启缓存时,Chen 刚被移出文件夹 A 后,还能看到 readme 吗?
文档建议按请求作决定:如果应用存储了资源的最后修改时间,就可以把这个时间与缓存 TTL 比较,在两种模式之间选择(一致性)。这个时间戳由应用保存,承担了 zookie 的一部分作用。此外还有缓存失效参数(cache-controller-enabled),用于检查 store 最近是否有写入。
与论文的差异
- 没有 zookie。 不返回也不接受任何一致性令牌;以两种模式加一个默认关闭的缓存代之(一致性)。论文的一致性模型建立在 zookie 之上(§2.2)。
- 变更需要轮询。
ReadChanges返回一页 “sorted by ascending time”(按时间升序排列)的元组变更以及一个续传令牌(openfga_service.proto)。论文的 Watch 是带有心跳 zookie 的流(§2.4.3)。 - 存储。 论文使用 Spanner(§3.1)。OpenFGA 提供
memory(默认,“Data is lost between server restarts”,服务器重启后数据会丢失)、PostgreSQL(可带只读副本)、MySQL 和 SQLite(配置 OpenFGA)。 - 条件。 像
[user with non_expired_grant]这样的类型限制使元组只在某个 CEL 条件成立时才计入(条件)。论文的元组(§2.1)没有条件。 - 上下文元组。 随单次 Check、ListObjects、ListUsers 或 Expand 请求发送的元组,“not persisted in the datastore”(不会持久化到数据存储中)(概念,上下文元组)。
- 通配符。
[user, user:*]允许公开授权(配置语言);论文的元组语法没有通配符(§2.1)。 - Store 与模型版本。 一个 store 保存 “one or more versions of an authorization model”(一个授权模型的一个或多个版本)及其元组;“Store data cannot be shared across stores”(store 的数据不能在 store 之间共享)(概念)。在论文中,配置存储在一张以命名空间 ID 为键的表中,旁边是配置更新的变更日志,每个请求在一个配置快照时间戳上评估(§3.1.3、§3.2.2)。OpenFGA 中的检查可以指明所用的模型版本。
- 没有 Leopard。 这里引用的文档描述的是 Check 缓存和迭代器缓存,而不是像 Leopard 那样的预计算集合索引(§3.2.4)。
- 列表 API。
ListObjects、StreamedListObjects和ListUsers不在论文的 API 中(§2.4)。
状态
截至 2026-11-13:活跃。最新版本 v1.22.1 发布于 2026-10-28;首个版本 v0.1.0 发布于 2022-06-10;约 6.1k 个 GitHub star;Apache-2.0(仓库,releases)。
- 2022 年 6 月:开源(项目文章,2026-01-07)。
- 2022 年:被接纳为 CNCF Sandbox 项目。各来源的日期不一致:CNCF 的项目页面说 OpenFGA “was accepted to CNCF on September 14, 2022”(于 2022 年 9 月 14 日被 CNCF 接纳),其公告说是 2022 年 9 月;项目自己的文章则说是 2022 年 12 月(CNCF 项目页面,CNCF,项目文章)。
- 2025-10-28:据 CNCF 项目页面,进入孵化(Incubating)成熟度级别。
- 2025-11-11:CNCF 宣布其技术监督委员会 “has voted to accept OpenFGA as a CNCF incubating project”(已投票接纳 OpenFGA 为 CNCF 孵化项目)(CNCF)。
- 托管服务是 Auth0 FGA(文档)。
来源
- https://github.com/openfga/openfga
- https://github.com/openfga/openfga/releases
- https://openfga.dev/docs
- https://openfga.dev/docs/concepts
- https://openfga.dev/docs/configuration-language
- https://openfga.dev/docs/interacting/consistency
- https://openfga.dev/docs/interacting/read-tuple-changes
- https://openfga.dev/docs/interacting/contextual-tuples
- https://openfga.dev/docs/modeling/conditions
- https://openfga.dev/docs/best-practices/running-in-production
- https://openfga.dev/docs/getting-started/setup-openfga/configure-openfga
- https://github.com/openfga/api/blob/main/openfga/v1/openfga_service.proto
- https://github.com/openfga/sample-stores/blob/main/stores/gdrive/model.fga
- https://openfga.dev/blog/incubation-announcement
- https://www.cncf.io/blog/2025/11/11/openfga-becomes-a-cncf-incubating-project/
- https://www.cncf.io/projects/openfga/
- https://docs.fga.dev/fga