system:openfga@de

Ökosystem

OpenFGA

Die von Zanzibar inspirierte Autorisierungs-Engine der CNCF, gelesen vor dem Hintergrund des Papers.

Fakten geprüft am Abschnitte im Paper §2.1, §2.2, §2.3.1, §2.4, §3, §3.1.3, §3.2.2, §3.2.4

Betreuer
CNCF project (Okta core maintainer)
Lizenz
Apache-2.0
Sprache
Go
Status
Aktiv, CNCF Incubating
Neueste Version
v1.22.1 (2026-10-28)
Repository
github.com/openfga/openfga
Dokumentation
openfga.dev/docs

OpenFGA ist eine Open-Source-Autorisierungs-Engine. Ihre Dokumentation sagt, dass die JSON-Form ihrer Modellsprache, diejenige, die die API akzeptiert, “closely tracks the language in the Zanzibar paper” (sich eng an die Sprache im Zanzibar-Paper anlehnt); die DSL fügt syntaktischen Zucker hinzu und wird in dieses JSON kompiliert (Konfigurationssprache). Der CNCF-Beitrag zur Aufnahme als Incubating-Projekt sagt, sie “was developed by a group of Okta employees, and is the foundation for the Auth0 FGA commercial offering” (wurde von einer Gruppe von Okta-Mitarbeitern entwickelt und ist die Grundlage des kommerziellen Angebots Auth0 FGA) (CNCF, 2025-11-11). Sie ist in Go geschrieben und unter Apache-2.0 lizenziert (Repository). Der verwaltete Dienst von Auth0 beschreibt sich als “based on OpenFGA, an open-source project owned by the Cloud Native Computing Foundation” (basierend auf OpenFGA, einem Open-Source-Projekt im Besitz der Cloud Native Computing Foundation) (Auth0-FGA-Dokumentation).

Begriffe des Papers und Begriffe von OpenFGA

Die Dokumentation von OpenFGA enthält eine eigene Tabelle der “Equivalent Zanzibar Concepts” (entsprechenden Zanzibar-Konzepte) (Konfigurationssprache); diese hier erweitert sie um die API und den Speicher.

Im Paper In OpenFGA
Namespace-Konfiguration (§2.3) Ein type in einem Autorisierungsmodell, geschrieben in der DSL oder in JSON (Konfigurationssprache)
Relationstupel object#relation@user (§2.1) Relationship Tuple mit user, relation, object, z. B. user:anne, owner, doc:readme; ein Userset wird group:eng#member geschrieben
_this (§2.3.1) Eine direkte Typbeschränkung wie [user, group#member] (this in JSON)
computed_userset Ein bloßer Relationsname, z. B. or owner
tuple_to_userset viewer from parent (tupleToUserset in JSON)
union / intersection / exclusion or / and / but not (union / intersection / difference in JSON)
zookie (§2.4) Keiner; eine Abfrage wählt MINIMIZE_LATENCY oder HIGHER_CONSISTENCY (Konsistenz)
Check (§2.4.4) Check, BatchCheck
Read (§2.4.1) Read
Write (§2.4.2) Write
Watch (§2.4.3) ReadChanges, ein paginierter Listen-Lesevorgang mit Fortsetzungstoken (Tupeländerungen)
Expand (§2.4.5) Expand
Nicht in der API des Papers ListObjects, StreamedListObjects, ListUsers; Stores; Modellversionen (WriteAuthorizationModel, ReadAuthorizationModel(s))
Leopard (§3.2.4) Keine Entsprechung in der hier zitierten Dokumentation
Spanner (§3) memory (Standard), postgres, mysql, sqlite (OpenFGA konfigurieren)

Die API-Namen stammen aus openfga_service.proto.

Das durchgehende Beispiel als Modell

Abbildung 1 des Papers macht Eigentümer zu Bearbeitern, Bearbeiter zu Betrachtern und Betrachter des übergeordneten Ordners zu Betrachtern des Dokuments (§2.3.1). In der DSL von OpenFGA stehen dieselben Regeln in einer Zeile pro Relation:

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

Die Tupel für Anne, Beto und 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

Welche dieser Tupel durchläuft eine Prüfung auf viewer am Readme für jede Person?

Das durchgehende Beispiel als OpenFGA-TupelFünf Tupel. user:anne ist owner von doc:readme. user:beto ist member von group:eng, und group:eng#member ist viewer von doc:readme. user:chen ist viewer von folder:A, und folder:A ist parent von doc:readme. Annes Pfad ist hervorgehoben: owner führt zu editor, das zu viewer führt.user:anneuser:betouser:chengroup:engfolder:Adoc:readmeownermemberviewer(eng#member)viewerparent
Jeder Pfeil ist ein gespeichertes Tupel. Annes owner-Tupel (hervorgehoben) zählt als editor, dann als viewer; Beto kommt über die Gruppe herein und Chen über viewer from parent.

Das Modell, nicht ein Tupel, trägt „Eigentümer sind Bearbeiter“ und „Bearbeiter sind Betrachter“: Das ist der Punkt des Papers, dass Beziehungen zwischen Relationen in die Konfiguration gehören, nicht in ein Tupel pro Objekt (§2.3.1).

Architektur

Woraus besteht eine OpenFGA-Installation? Die Dokumentation beschreibt Server auf einem SQL-Datenspeicher. Jeder Server kann In-Memory-Caches für Check halten, und der Produktionsleitfaden rät zu “a small pool of servers with high capacity (memory and CPU cores) instead of a big pool of servers, to increase cache hit ratios” (einem kleinen Pool von Servern mit hoher Kapazität (Arbeitsspeicher und CPU-Kerne) statt eines großen Pools, um die Cache-Trefferquote zu erhöhen) (Betrieb in Produktion). Für PostgreSQL kann ein sekundärer Datenspeicher (Read Replica) konfiguriert werden; Lesevorgänge mit HIGHER_CONSISTENCY gehen an den primären (OpenFGA konfigurieren). Konsumenten von Änderungen rufen ReadChanges auf und behalten das Fortsetzungstoken (Tupeländerungen).

OpenFGA-ArchitekturEin Anwendungsclient sendet Check über gRPC oder HTTP an einen von zwei OpenFGA-Servern. Jeder Server hat einen optionalen In-Memory-Check-Cache. Beide Server schreiben in einen primären PostgreSQL-Datenspeicher und können von einer optionalen Read Replica lesen, die durch PostgreSQL-Replikation gespeist wird. Ein Änderungskonsument ruft ReadChanges auf einem Server mit einem Fortsetzungstoken auf.Anwendung(gRPC-/HTTP-Client)Änderungskonsument(fragt ReadChanges ab)OpenFGA-Server+ Check-CacheOpenFGA-Server+ Check-CachePrimärer DatenspeicherPostgreSQL · MySQL · SQLiteRead Replica(PostgreSQL, optional)CheckReadChanges + TokenSchreiben, HIGHER_CONSISTENCYandere LesevorgängeReplikation
Gelb: Server. Grün: Datenspeicher. Blau: Clients. Gestrichelt: optional. Die Dokumentation beschreibt keinen Dispatch von Server zu Server.

Zum Vergleich Abbildung 2 des Papers (§3): aclservers fächern Arbeit untereinander auf, watchservers liefern einen Stream, und Leopard hält einen denormalisierten Index. Die hier zitierte OpenFGA-Dokumentation beschreibt keines der drei; Server antworten aus dem Datenspeicher und ihren eigenen Caches.

Konsistenz ohne zookies

OpenFGA hat keinen zookie. Die Dokumentation sagt das unter “Future work” (zukünftige Arbeit): Das Paper “has a feature called Zookies” (hat eine Funktion namens Zookies), und OpenFGA “is considering a similar feature in future releases” (erwägt eine ähnliche Funktion in zukünftigen Releases) (Konsistenz). Stattdessen nehmen Read und die Abfrage-APIs einen von zwei Werten:

Modus Verhalten (Konsistenz-Dokumentation) Entsprechung im Paper
MINIMIZE_LATENCY (Standard) “will serve queries from the cache when possible” (bedient Abfragen nach Möglichkeit aus dem Cache) Eine Anfrage ohne zookie: “a reasonably recent snapshot” (ein hinreichend aktueller Snapshot) (§2.4.1)
HIGHER_CONSISTENCY “will skip the cache and query the database directly” (umgeht den Cache und fragt die Datenbank direkt ab) Keine genaue Entsprechung; am nächsten kommt die Auswertung auf dem neuesten Snapshot

Caching ist “disabled by default” (standardmäßig deaktiviert), und dann gilt: “all queries will have strong consistency regardless of the consistency mode specified” (alle Abfragen haben starke Konsistenz, unabhängig vom angegebenen Konsistenzmodus) (Konsistenz). Der Modus spielt erst eine Rolle, wenn ein Cache eingeschaltet ist.

Kann Chen mit eingeschaltetem Cache das Readme noch sehen, direkt nachdem er aus Ordner A entfernt wurde?

Cache und Konsistenzmodi in OpenFGAMit eingeschaltetem Check-Cache wird eine erste Prüfung für Chen auf dem Readme erlaubt und gecacht. Die Anwendung löscht dann Chens viewer-Tupel auf Ordner A. Eine zweite Prüfung mit MINIMIZE_LATENCY kann aus dem Cache beantwortet werden und weiterhin erlaubt sagen. Eine dritte Prüfung mit HIGHER_CONSISTENCY umgeht den Cache, liest den Datenspeicher und wird abgewiesen.ZeitAnwendungOpenFGA-ServerDatenspeicherCheckWrite (Löschen)MINIMIZE_LATENCYHIGHER_CONSISTENCYdarf Chen sehen?erlaubt, gecachtChens Tupel löschenTupel gelöschtdarf Chen sehen?Cache: erlaubtdarf Chen sehen?Tupel lesenabgewiesen
Zeile 2 ist das, wovor die Dokumentation warnt: Die Tupeländerung „might not be taken in consideration“ (wird möglicherweise nicht berücksichtigt), wenn das Ergebnis aus dem Cache kommt. Ein zookie würde der Anwendung erlauben, „mindestens so aktuell wie mein Schreibvorgang“ zu verlangen (§2.2); hier heißt die Wahl alles oder nichts.

Die Dokumentation schlägt vor, pro Anfrage zu entscheiden: Speichert die Anwendung, wann eine Ressource zuletzt geändert wurde, kann sie diesen Zeitpunkt mit der Cache-TTL vergleichen, um zwischen den beiden Modi zu wählen (Konsistenz). Dieser Zeitstempel übernimmt einen Teil der Rolle eines zookie, gehalten von der Anwendung. Außerdem gibt es Flags zur Cache-Invalidierung (cache-controller-enabled), die auf kürzliche Schreibvorgänge in den Store prüfen.

Unterschiede zum Paper

  • Kein zookie. Es wird kein Konsistenztoken zurückgegeben oder angenommen; zwei Modi plus ein standardmäßig ausgeschalteter Cache ersetzen es (Konsistenz). Das Konsistenzmodell des Papers beruht auf zookies (§2.2).
  • Änderungen werden per Polling abgefragt. ReadChanges gibt eine Seite von Tupeländerungen “sorted by ascending time” (aufsteigend nach Zeit sortiert) mit einem Fortsetzungstoken zurück (openfga_service.proto). Watch ist im Paper ein Stream mit Heartbeat-zookies (§2.4.3).
  • Speicherung. Das Paper verwendet Spanner (§3.1). OpenFGA bietet memory (Standard, “Data is lost between server restarts”, also: Daten gehen zwischen Serverneustarts verloren), PostgreSQL (mit optionaler Read Replica), MySQL und SQLite (OpenFGA konfigurieren).
  • Conditions. Eine Typbeschränkung wie [user with non_expired_grant] lässt ein Tupel nur zählen, wenn eine CEL-Bedingung gilt (Conditions). Das Tupel des Papers (§2.1) hat keine Bedingung.
  • Kontextuelle Tupel. Tupel, die mit einer einzelnen Check-, ListObjects-, ListUsers- oder Expand-Anfrage gesendet und “not persisted in the datastore” (nicht im Datenspeicher persistiert) werden (Konzepte, kontextuelle Tupel).
  • Wildcards. [user, user:*] erlaubt eine öffentliche Freigabe (Konfigurationssprache); die Tupelgrammatik des Papers hat keine Wildcard (§2.1).
  • Stores und Modellversionen. Ein Store enthält “one or more versions of an authorization model” (eine oder mehrere Versionen eines Autorisierungsmodells) und seine Tupel; “Store data cannot be shared across stores” (Store-Daten können nicht zwischen Stores geteilt werden) (Konzepte). Im Paper werden Konfigurationen in einer Tabelle mit der Namespace-ID als Schlüssel gespeichert, neben einem Changelog der Konfigurationsänderungen, und jede Anfrage wird zu einem Konfigurations-Snapshot-Zeitstempel ausgewertet (§3.1.3, §3.2.2). Eine Prüfung in OpenFGA kann die Modellversion nennen, die sie verwendet.
  • Kein Leopard. Die hier zitierte Dokumentation beschreibt Check-Caches und Iterator-Caches, keinen vorberechneten Mengenindex wie Leopard (§3.2.4).
  • Listen-APIs. ListObjects, StreamedListObjects und ListUsers liegen außerhalb der API des Papers (§2.4).

Status

Stand 2026-11-13: aktiv. Neuestes Release v1.22.1 am 2026-10-28; erstes Release v0.1.0 am 2022-06-10; etwa 6.100 GitHub-Sterne; Apache-2.0 (Repository, Releases).

  • Juni 2022: als Open Source veröffentlicht (Projektbeitrag, 2026-01-07).
  • 2022: als CNCF-Sandbox-Projekt aufgenommen. Die Quellen widersprechen sich beim Datum: Die CNCF-Projektseite sagt, OpenFGA “was accepted to CNCF on September 14, 2022” (wurde am 14. September 2022 in die CNCF aufgenommen), und ihre Ankündigung nennt September 2022; der eigene Beitrag des Projekts nennt Dezember 2022 (CNCF-Projektseite, CNCF, Projektbeitrag).
  • 2025-10-28: laut CNCF-Projektseite in die Reifestufe Incubating gewechselt.
  • 2025-11-11: Die CNCF gibt bekannt, dass ihr Technical Oversight Committee “has voted to accept OpenFGA as a CNCF incubating project” (dafür gestimmt hat, OpenFGA als CNCF-Incubating-Projekt aufzunehmen) (CNCF).
  • Der verwaltete Dienst ist Auth0 FGA (Dokumentation).

Quellen