OpenFGA는 오픈 소스 인가 엔진이다. 문서에 따르면 그 모델 언어의 JSON 형식, 즉 API가 받는 형식은 “closely tracks the language in the Zanzibar paper”(Zanzibar 논문의 언어를 충실히 따른다)이며, DSL은 문법적 편의를 더하고 그 JSON으로 컴파일된다(configuration language). 인큐베이션을 알리는 CNCF의 글은 OpenFGA가 “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”(Cloud Native Computing Foundation이 소유한 오픈 소스 프로젝트인 OpenFGA에 기반한다)이라고 소개한다(Auth0 FGA 문서).
논문의 용어와 OpenFGA의 용어
OpenFGA 문서에는 “Equivalent Zanzibar Concepts”(대응하는 Zanzibar 개념) 표가 있다(configuration language). 이 표는 그것을 API와 저장소까지 확장한 것이다.
| 논문 | OpenFGA |
|---|---|
| 네임스페이스 설정 (§2.3) | 인가 모델 안의 type. DSL이나 JSON으로 작성한다(configuration language) |
관계 튜플 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를 고른다(consistency) |
| Check (§2.4.4) | Check, BatchCheck |
| Read (§2.4.1) | Read |
| Write (§2.4.2) | Write |
| Watch (§2.4.3) | ReadChanges. 연속 토큰을 쓰는 페이지 단위 목록 읽기(tuple changes) |
| Expand (§2.4.5) | Expand |
| 논문의 API에 없음 | ListObjects, StreamedListObjects, ListUsers. 스토어. 모델 버전(WriteAuthorizationModel, ReadAuthorizationModel(s)) |
| Leopard (§3.2.4) | 여기서 인용한 문서에는 대응물이 없음 |
| Spanner (§3) | memory(기본값), postgres, mysql, sqlite(configure 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 코어)이 큰 작은 서버 풀)를 권한다(running in production). PostgreSQL에서는 보조(읽기 복제본) 데이터 저장소를 설정할 수 있으며, HIGHER_CONSISTENCY 읽기는 주 데이터 저장소로 간다(configure OpenFGA). 변경의 소비자는 ReadChanges를 호출하고 연속 토큰을 보관한다(tuple changes).
논문의 그림 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”(향후 릴리스에서 비슷한 기능을 검토하고 있다)(consistency). 대신 Read와 쿼리 API는 두 값 중 하나를 받는다.
| 모드 | 동작(consistency 문서) | 논문의 대응 |
|---|---|---|
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”(지정한 일관성 모드와 관계없이 모든 쿼리가 강한 일관성을 가진다)(consistency). 모드는 캐시를 켰을 때에만 의미가 있다.
캐시를 켠 상태에서, Chen이 폴더 A에서 제거된 직후에도 여전히 readme를 볼 수 있는가?
문서는 요청마다 결정할 것을 제안한다. 애플리케이션이 리소스를 마지막으로 수정한 시각을 저장해 두면, 그 시각을 캐시 TTL과 비교하여 두 모드 중 하나를 고를 수 있다(consistency). 애플리케이션이 보관하는 그 타임스탬프가 zookie 역할의 일부를 한다. 스토어에 대한 최근 쓰기를 확인하는 캐시 무효화 플래그(cache-controller-enabled)도 있다.
논문과의 차이
- zookie 없음. 일관성 토큰을 반환하지도 받지도 않는다. 두 가지 모드와 기본적으로 꺼진 캐시가 그 자리를 대신한다(consistency). 논문의 일관성 모델은 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를 제공한다(configure OpenFGA). - 조건.
[user with non_expired_grant]같은 타입 제약은 CEL 조건이 성립할 때에만 튜플이 효력을 갖게 한다(conditions). 논문의 튜플(§2.1)에는 조건이 없다. - 컨텍스트 튜플. Check, ListObjects, ListUsers, Expand 요청 하나와 함께 보내는 튜플로, “not persisted in the datastore”(데이터 저장소에 영속되지 않는다)(concepts, contextual tuples).
- 와일드카드.
[user, user:*]는 공개 부여를 허용한다(configuration language). 논문의 튜플 문법에는 와일드카드가 없다(§2.1). - 스토어와 모델 버전. 스토어는 “one or more versions of an authorization model”(인가 모델의 하나 이상의 버전)과 그 튜플을 담으며, “Store data cannot be shared across stores”(스토어 데이터는 스토어 사이에 공유할 수 없다)(concepts). 논문에서 설정은 네임스페이스 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, GitHub 스타 약 6.1k, Apache-2.0(저장소, 릴리스).
- 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