system:permify@de

Ökosystem

Permify

Ein Open-Source-Autorisierungsdienst nach dem Vorbild von Zanzibar, heute im Besitz von FusionAuth und unter AGPL-3.0 lizenziert, mit einer Schemasprache, Snap Tokens und einem PostgreSQL-Datenspeicher.

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

Betreuer
FusionAuth (acquisition announced 2025-11-20)
Lizenz
AGPL-3.0 (Apache-2.0 until 2025-05-12)
Sprache
Go
Status
Aktiv
Neueste Version
v1.7.6 (2026-11-05)
Repository
github.com/Permify/permify
Dokumentation
fusionauth.io/permify-docs

Permify ist ein in Go geschriebener Autorisierungsdienst. Seine Dokumentation nennt ihn “an open-source authorization service for creating fine-grained and scalable authorization systems” (einen Open-Source-Autorisierungsdienst zum Aufbau feingranularer und skalierbarer Autorisierungssysteme), “inspired by Google’s consistent, global authorization system, Google Zanzibar” (inspiriert von Googles konsistentem, globalem Autorisierungssystem, Google Zanzibar) (Permify-Dokumentation). Man beschreibt Entitätstypen und ihre Relationen im Permify Schema, schreibt Beziehungen als Tupel und fragt einen Server über gRPC oder HTTP, ob ein Subjekt eine Berechtigung hat.

Die Übernahme von Permify durch FusionAuth wurde am 2025-11-20 angekündigt (Ankündigung von Permify, Ankündigung von FusionAuth). FusionAuth nennt das Produkt inzwischen “FusionAuth FGA by Permify” (Support-Beitrag von FusionAuth), und die Dokumentation liegt unter fusionauth.io/permify-docs. Der Beitrag von Permify sagt: “The core Permify project remains open source and will continue to live on GitHub.” (Das Kernprojekt Permify bleibt Open Source und wird weiter auf GitHub leben.)

Paper und Permify nebeneinander

Jede Zeile nennt ein Konzept aus dem Paper und das Nächstliegende, das Permify dokumentiert. Wo Permify nichts Vergleichbares hat, sagt die Zelle das.

Im Paper In Permify
Namespace-Konfiguration (§2.3) Ein entity-Block im Permify Schema, mit relation, permission (oder dem Synonym action), attribute und rule (Modellierung)
Relationstupel object#relation@user (§2.1) Relational Tuple entity#relation@subject, zum Beispiel doc:readme#owner@user:anne (Daten speichern)
_this Die gespeicherten Tupel einer relation; eine Berechtigung schließt sie ein, indem sie die Relation nennt
computed_userset Eine andere Relation oder Berechtigung derselben Entität nennen, wie edit in view = viewer or edit
tuple_to_userset Punkt-Traversierung über eine Relation, wie parent.view
Vereinigung, Schnittmenge, Ausschluss or, and, not
zookie (§2.2, §2.4) Snap Token, das Feld snap_token (Snap Tokens)
Check (§2.4.4) Permission.Check, dazu BulkCheck (service.proto)
Read (§2.4.1) Data.ReadRelationships, dazu ReadAttributes
Write (§2.4.2) Data.Write, WriteRelationships, Delete, DeleteRelationships
Watch (§2.4.3) Watch.Watch, ein Server-Stream (Watch-Operationen)
Expand (§2.4.5) Permission.Expand
Leopard (§3.2.4) Keine Entsprechung dokumentiert
Spanner (§3.1) PostgreSQL oder eine In-Memory-Engine (der Konfigurationsstandard) (Konfiguration)

Permify hat außerdem Lookup-Aufrufe, die das Paper nicht beschreibt: LookupEntity, LookupSubject und SubjectPermission.

Das durchgehende Beispiel im Permify Schema

Abbildung 1 des Papers gibt Dokumenten drei konzentrische Relationen: Eigentümer sind Bearbeiter, Bearbeiter sind Betrachter, und Betrachter des übergeordneten Ordners sind Betrachter des Dokuments (§2.3.1). Hier ist dieses Modell mit den Typen des durchgehenden Beispiels im Permify Schema.

entity user {}

entity group {
    relation member @user
}

entity folder {
    relation viewer @user @group#member

    permission view = viewer
}

entity doc {
    relation parent @folder
    relation owner @user
    relation editor @user @group#member
    relation viewer @user @group#member

    permission edit = owner or editor
    permission view = viewer or edit or parent.view
}

@group#member lässt eine Relation ein Userset aufnehmen: „jeder, der Mitglied dieser Gruppe ist“. parent.view folgt der Relation parent zum Ordner und wertet dort die Berechtigung view des Ordners aus; die Dokumentation sagt: “The same traversal rule applies to both relation.userset and relation.permission” (Dieselbe Traversierungsregel gilt sowohl für relation.userset als auch für relation.permission) (Modellierung).

Das durchgehende Beispiel besteht aus fünf Tupeln:

doc:readme#owner@user:anne
group:eng#member@user:beto
doc:readme#viewer@group:eng#member
doc:readme#parent@folder:A
folder:A#viewer@user:chen

Welche gespeicherten Tupel und welche Regeln geben jeder der drei Personen Zugriff auf das Readme?

Das durchgehende Beispiel als Permify-BeziehungenFünf Beziehungen. user:anne ist owner von doc:readme. user:beto ist member von group:eng. group:eng#member ist viewer von doc:readme. folder:A ist parent von doc:readme. user:chen ist viewer von folder:A. Der Pfad von Chen über Ordner A zum Readme ist hervorgehoben: Er wird durch die Regel parent.view aufgelöst.user:anneuser:betouser:chengroup:engfolder:Adoc:readmeownermemberviewer (#member)viewerparent
Anne sieht über owner → edit → view, Beto über das Gruppen-Userset, Chen über parent.view. Gestrichelt: ein Userset, kein einzelner Benutzer.

Der Pfeil von folder:A zum Readme ist ein gespeichertes Tupel (doc:readme#parent@folder:A), während der Schritt von Chens Ordnerzugriff zum Readme nirgends gespeichert ist: Das parent.view des Schemas berechnet ihn zur Prüfzeit, so wie es tuple_to_userset im Paper tut.

Architektur

Wie teilen sich Permify-Server die Arbeit, und wo liegen die Tupel?

Permify-Bereitstellung, wie in der Dokumentation beschriebenEin Dienst ruft Permify-Pods über gRPC auf Port 3478 oder HTTP auf Port 3476 auf. Im verteilten Modus bilden die Pods einen Ring mit konsistentem Hashing, sodass eine Anfrage, die auf Pod 2 gehasht wird, aus dem lokalen Ristretto-Cache von Pod 2 beantwortet wird. Beide Pods lesen und schreiben PostgreSQL, das mit getrennten Writer- und Reader-Verbindungen konfiguriert sein kann. Ein Watch-Konsument hält einen Stream zu einem Pod.Ihr DienstWatch-KonsumentPermify-Pod 1lokaler CachePermify-Pod 2lokaler CachePostgreSQLWriter + ReaderCheck, WriteHash-RingSQLSQLWatch-Stream
Gelb: Permify-Server. Grün: der Datenspeicher. Blau: Clients. Der Ring ist optional (verteilter Modus).

Die Teile, jeweils aus der Dokumentation:

  • Server lauschen standardmäßig auf HTTP-Port 3476 und gRPC-Port 3478 (Konfiguration). Der Datenbankabschnitt akzeptiert getrennte URIs für writer und reader.
  • Jeder Pod hält einen prozesslokalen Ristretto-Cache von Prüfergebnissen; “there is no shared cache layer” (es gibt keine gemeinsame Cache-Schicht) (Cache).
  • Mit distributed.enabled hashen die Pods jede Anfrage auf einen Ring mit konsistentem Hashing, sodass “subsequent API calls with the same hash will retrieve the response from the instance 2, regardless of which instance that API called from” (nachfolgende API-Aufrufe mit demselben Hash die Antwort von Instanz 2 erhalten, unabhängig davon, von welcher Instanz die API aufgerufen wurde). Ein Circuit Breaker stoppt Aufrufe an die Datenbank, solange diese ausgefallen ist.
  • PostgreSQL speichert Tupel mit MVCC: Permify erzeugt “a separate database snapshot for each write and delete operation” (einen separaten Datenbank-Snapshot für jede Schreib- und Löschoperation), und ein optionaler Garbage Collector löscht alte Versionen.
  • Jeder Watch-Stream “opens a long-lived connection with a continuous polling loop against the database” (öffnet eine langlebige Verbindung mit einer fortlaufenden Abfrageschleife gegen die Datenbank) (Watch-Operationen).

Konsistenz

Das Snap Token von Permify übernimmt die Rolle des zookie. Ein Write gibt es zurück; der Client speichert es mit der Ressource und sendet es bei späteren Prüfungen als snap_token zurück. Die Dokumentation beschreibt es als “a token that consists of an encoded timestamp” (ein Token, das aus einem kodierten Zeitstempel besteht), das bei Zugriffsprüfungen verglichen wird, “to ensure that the snapshot of the access control is at least as fresh as the resource timestamp” (um sicherzustellen, dass der Snapshot der Zugriffskontrolle mindestens so aktuell ist wie der Zeitstempel der Ressource) (Snap Tokens). Das ist die Garantie des Papers für eine Prüfung, die einen zookie trägt: “a consistent snapshot no earlier than” (ein konsistenter Snapshot, der nicht früher liegt als) der angegebene zookie (§2.4.4).

Wie sieht eine Prüfung nach einer Freigabeänderung diese Änderung?

Der Weg eines Snap TokensDer Dienst schreibt das Tupel doc:readme#viewer@group:eng#member. Permify hält es in einer neuen Transaktion in PostgreSQL fest und gibt ein Snap Token zurück. Der Dienst speichert das Token mit dem Readme. Eine spätere Prüfung für Beto auf dem Readme sendet das Token mit, und Permify wertet die Prüfung auf einem Snapshot aus, der nicht älter ist als das Token, sodass das neue viewer-Tupel sichtbar ist.ZeitIhr DienstPermifyPostgreSQLsnap_tokenWrite: eng#membersieht ReadmeData.Writeneue Transaktionfestgehaltengibt snap_tokenzurückToken mit demReadme speichernCheck beto view+ snap_tokenSnapshot nicht älterals das Token
Das Token reist mit dem Inhalt, wie der zookie des Papers (§2.2).

Beachten Sie das Verhalten ohne Token. Das Paper lässt Zanzibar “choose a reasonably recent snapshot, possibly offering a lower-latency response” (§2.4.1) (einen hinreichend aktuellen Snapshot wählen und so möglicherweise eine Antwort mit geringerer Latenz bieten). Permify liest stattdessen die ID der neuesten Transaktion aus seiner Tabelle transactions und wertet auf diesem Snapshot aus; das Ergebnis wird unter einem Schlüssel gecacht, der diese ID enthält (Snap Tokens). Der Cache-Schlüssel ist check_{tenant_id}_{schema_version}:{snapshot_token}:{check_request} (Cache), sodass ein neuer Schreibvorgang neue Schlüssel erzeugt, statt alte zu invalidieren.

Unterschiede zum Paper

  • Attribute und Regeln. Das Permify Schema fügt attribute und rule für attributbasierte Prüfungen hinzu, etwa permission view = check_ip_range(ip_range) or admin (Modellierung). Die Umschreibungen von Zanzibar arbeiten nur auf Tupeln (§2.3.1).
  • Kontextuelle Tupel. Relationen, die “dynamically added to permission request operations” (dynamisch zu Berechtigungsanfragen hinzugefügt) werden, werden mit den gespeicherten ausgewertet und nie geschrieben (kontextuelle Tupel).
  • Mandanten. Ein Dienst Tenancy legt Mandanten an, listet sie auf und löscht sie (service.proto); das Paper hat kein Mandantenkonzept.
  • Speicherung. PostgreSQL mit MVCC-Snapshots statt Spanner, dessen TrueTime-Mechanismus jeden ACL-Schreibvorgang mit einem Zeitstempel versieht (§2.2, §3.1). Der verteilte Cache funktioniert “across availability zones (within an AWS region)” (über Availability Zones hinweg (innerhalb einer AWS-Region)) (Cache).
  • Kein denormalisierter Index. Das Paper beantwortet Prüfungen tief verschachtelter Gruppen mit Leopard (§3.2.4). Permify dokumentiert Ergebnis-Caching und konsistentes Hashing, keinen Mengenindex.
  • Lookups. LookupEntity und LookupSubject beantworten Fragen nach „welchen Ressourcen“ und „welchen Subjekten“, die die API des Papers nicht abdeckt.

Status

  • Erstes Release v0.0.0-alpha1 am 2022-08-03; neuestes v1.7.6 am 2026-11-05; letzter Commit auf den Standardbranch am 2026-11-10; etwa 6.000 Sterne (Releases, GitHub-API, 2026-11-13).
  • Lizenz: Die LICENSE-Datei wurde am 2023-02-14 durch den Text von Apache-2.0 ersetzt (Commit 97285f9) und am 2025-05-12 durch den Text von AGPL-3.0, in einem Commit mit dem Titel “docs: update license” (Commit 26912d9). Davor, im Jahr 2022, enthielt die Datei den Text von Apache-2.0 (2022-07-14), dann GPL-3.0 (2022-08-25), dann AGPL-3.0 (2022-08-26) (LICENSE-Historie).
  • Eigentum: von FusionAuth übernommen, angekündigt am 2025-11-20 im Permify-Blog (Beitrag); die Ankündigungsseite von FusionAuth zeigt kein Datum (Beitrag). Beide sind vom Hersteller verfasst.
  • Die Dokumentation ist von docs.permify.co nach fusionauth.io/permify-docs umgezogen.

Quellen