system:warrant@de

Ökosystem

Warrant

Ein von Zanzibar inspirierter Autorisierungsdienst, dessen Open-Source-Repository seit Mitte 2024 ruht, nachdem WorkOS das Unternehmen übernommen und das Produkt als WorkOS FGA weitergeführt hat.

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

Betreuer
WorkOS (acquired 2024)
Lizenz
Apache-2.0
Sprache
Go
Status
Als Open Source ruhend; weitergeführt als WorkOS FGA
Neueste Version
v1.15.1 (2024-06-10)
Repository
github.com/warrant-dev/warrant
Dokumentation
workos.com/docs/fga

Warrant ist ein in Go geschriebener Autorisierungsdienst. Sein README beschreibt “a relationship based access control (ReBAC) engine (inspired by Google Zanzibar)” (eine Engine für beziehungsbasierte Zugriffskontrolle (ReBAC), inspiriert von Google Zanzibar), die auch rollen- und attributbasierte Regeln abdeckt, und schreibt eine Beziehung als [user:1] is an [editor] of [document:docA] (README). Eine gespeicherte Beziehung heißt Warrant.

WorkOS hat Warrant 2024 übernommen. Das Datum, 2024-04-23, stammt aus einem Beitrag von WorkOS auf X (Beitrag): X lieferte die Seite nicht an den Prüfer dieser Website aus, daher wurde das Datum aus der ID des Beitrags dekodiert, und der Text des Beitrags (“Today, we are excited to announce the acquisition of @warrant_dev”, also: Heute freuen wir uns, die Übernahme von @warrant_dev bekanntzugeben) wurde nur in einem Suchergebnis gesehen. Ein Blogbeitrag von WorkOS selbst wurde nicht gefunden. Die Warrant-Website zeigt nun “Warrant —> Now WorkOS FGA” (warrant.dev), und das README verlinkt auf die Dokumentation von WorkOS FGA.

Paper und Warrant nebeneinander

Die Dokumentationsseite von Warrant existiert nicht mehr, daher stützt sich diese Tabelle auf den Open-Source-Code.

Im Paper In Warrant (Open Source)
Namespace-Konfiguration (§2.3) Ein Objekttyp: JSON mit type und relations, jede Relation eine Regel (spec.go)
Relationstupel object#relation@user (§2.1) Ein Warrant: objectType, objectId, relation und ein subject mit objectType, objectId und optionaler relation
_this Direkte Warrants, die eine Prüfung immer zuerst versucht (“1. Check for direct warrant match”, also: 1. auf direkten Warrant-Treffer prüfen, check/service.go)
computed_userset { "inheritIf": "owner" }
tuple_to_userset { "inheritIf": "viewer", "ofType": "folder", "withRelation": "parent" }
Vereinigung, Schnittmenge, Ausschluss inheritIf gesetzt auf anyOf, allOf oder noneOf, mit verschachtelten rules
zookie (§2.2, §2.4) Der Header Warrant-Token; der Open-Source-Server reagiert nur auf den Wert latest (siehe Konsistenz) (wookie.go)
Check (§2.4.4) POST /v2/check (auch /v2/authorize)
Read (§2.4.1) GET /v2/warrants; GET /v2/query für Abfragen über den Graphen
Write (§2.4.2) POST /v2/warrants, DELETE /v2/warrants
Watch (§2.4.3) Keines
Expand (§2.4.5) Keines
Leopard (§3.2.4) Keines
Spanner (§3.1) MySQL, PostgreSQL oder SQLite, mit optionaler Read Replica

Das durchgehende Beispiel als Objekttypen

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 Warrant listet jeder Objekttyp seine Relationen auf; ein leeres Objekt {} bedeutet „nur direkte Warrants“, und inheritIf fügt eine Regel hinzu.

[
  { "type": "group", "relations": { "member": {} } },
  { "type": "folder", "relations": { "viewer": {} } },
  {
    "type": "doc",
    "relations": {
      "parent": {},
      "owner": {},
      "editor": { "inheritIf": "owner" },
      "viewer": {
        "inheritIf": "anyOf",
        "rules": [
          { "inheritIf": "editor" },
          { "inheritIf": "viewer", "ofType": "folder", "withRelation": "parent" }
        ]
      }
    }
  }
]

Es gibt keinen Eintrag user: Der Server legt in seiner ersten Datenbankmigration einen eingebauten Objekttyp user an (Migration). Die Regel mit ofType und withRelation findet die Warrants doc:readme#parent@folder:… und prüft viewer auf jedem gefundenen Ordner, wie im Prüfcode (getMatchingSubjectsBySubjectType in check/service.go).

Die fünf Warrants des durchgehenden Beispiels als Bodies für POST /v2/warrants:

{ "objectType": "doc", "objectId": "readme", "relation": "owner", "subject": { "objectType": "user", "objectId": "anne" } }
{ "objectType": "group", "objectId": "eng", "relation": "member", "subject": { "objectType": "user", "objectId": "beto" } }
{ "objectType": "doc", "objectId": "readme", "relation": "viewer", "subject": { "objectType": "group", "objectId": "eng", "relation": "member" } }
{ "objectType": "doc", "objectId": "readme", "relation": "parent", "subject": { "objectType": "folder", "objectId": "A" } }
{ "objectType": "folder", "objectId": "A", "relation": "viewer", "subject": { "objectType": "user", "objectId": "chen" } }

Welcher Warrant und welche Regel entscheiden über die Relation viewer jeder Person zum Readme?

Das durchgehende Beispiel als WarrantsFünf Warrants. 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 folder A ist hervorgehoben: Er wird durch die Regel mit ofType folder und withRelation parent aufgelöst.user:anneuser:betouser:chengroup:engfolder:Adoc:readmeownermemberviewer (#member)viewerparent
Anne: owner → editor → viewer per inheritIf. Beto: ein Warrant, dessen Subjekt group:eng#member ist. Chen: die Regel ofType/withRelation. Gestrichelt: ein Subjekt mit einer Relation.

Architektur

Welche Datenbank beantwortet eine Anfrage?

Warrant-Bereitstellung, nach dem Open-Source-CodeIhr Dienst ruft einen Warrant-HTTP-Dienst auf. Schreibvorgänge und Lesevorgänge, die Warrant-Token latest tragen, gehen an die primäre SQL-Datenbank. Andere Lesevorgänge gehen an den Reader-Pool, wenn ein Reader-DSN konfiguriert ist.Ihr DienstWarrant-HTTP-DienstPrimäre DBReader-DB(optional)/v2/check, /v2/warrantsSchreiben, latestandere Lesevorgänge
Gelb: der Warrant-Dienst. Grün: Datenbanken. Blau: der Aufrufer. Gestrichelt: nur verwendet, wenn ein Reader-DSN gesetzt ist.
  • Ein Go-Dienst bedient die HTTP-API (router.go).
  • Konfigurationen für MySQL und PostgreSQL nehmen einen dsn und einen optionalen readerDsn (config.go); auch SQLite wird unterstützt, “in-memory or file” (im Arbeitsspeicher oder als Datei) (README).
  • Die Regel für die Wahl eines Pools ist ein Kommentar in sql.go: den Writer verwenden, wenn der Aufruf ein Schreibvorgang ist, wenn es keinen Reader gibt, wenn der Kontext “contains ‘latest’ wookie” (einen „latest“-Wookie enthält) oder wenn Code im Server eine Writer-Überschreibung gesetzt hat; andernfalls den Reader verwenden.

Konsistenz

Der Code von Warrant nennt sein Token einen Wookie (wookie). Ein Typ Token enthält eine ID, eine Version und einen Zeitstempel, aber der Open-Source-Server sendet nie eines an den Client: Der Warrant-Dienst gibt an dieser Stelle nil zurück, und die HTTP-Handler ignorieren es (warrant/service.go, warrant/handlers.go). Was der Server tatsächlich liest, ist der Anfrage-Header Warrant-Token, und nur ein Wert ändert das Verhalten: latest.

Was ändert Warrant-Token: latest für eine Prüfung direkt nach einem Schreibvorgang?

Warrant-Token: latestDer Dienst schreibt den Warrant doc:readme viewer group:eng#member; er geht an die primäre Datenbank. Eine Prüfung ohne den Header wird aus der Reader-Datenbank gelesen. Eine Prüfung mit Warrant-Token latest wird aus der primären Datenbank gelesen, die den Schreibvorgang bereits enthält.ZeitIhr DienstWarrantPrimäre DBReader-DBPOST/v2/warrantsWarrantgeschriebenPrüfung ohneHeaderaus Reader-Pool gelesenPrüfung mitlatestaus primärerDB gelesen
Der zookie des Papers benennt einen Snapshot (§2.4); latest benennt nur eine Datenbank.

Das README selbst sagt, dass niedrige Latenz bei hohem Durchsatz “requires running Warrant as a distributed service with the use of Warrant-Tokens (also referred to as Zookies in Google Zanzibar)” (erfordert, Warrant als verteilten Dienst mit Warrant-Tokens zu betreiben (in Google Zanzibar auch Zookies genannt)), und dass “this open source version of Warrant is only capable of handling low-to-moderate throughput” (diese Open-Source-Version von Warrant nur niedrigen bis mittleren Durchsatz bewältigen kann) (README, vom Hersteller verfasst). Sein Link zu Warrant-Tokens führt inzwischen zur allgemeinen Übersicht von WorkOS FGA, die sie nicht beschreibt.

Beachten Sie den Unterschied zum Paper. Ein zookie setzt eine Untergrenze, die es Zanzibar erlaubt, “to choose any timestamp fresher than the one encoded in a zookie” (jeden Zeitstempel zu wählen, der aktueller ist als der in einem zookie kodierte) und die meisten Prüfungen “at a default staleness with already replicated data” (mit einer Standard-Veraltung auf bereits replizierten Daten) zu bedienen (§2.2). latest enthält keinen Zeitpunkt: Es verlegt den Lesevorgang auf die primäre Datenbank: Das ist die aktuellste Kopie, verzichtet aber auf das Replikat.

Unterschiede zum Paper

  • Keine Snapshot-Tokens im Open-Source-Server, wie oben.
  • RBAC und ABAC eingebaut. Eingebaute Objekttypen für Rollen, Berechtigungen, Mandanten, Preisstufen und Features sowie Richtlinienbedingungen an Warrants (README, Migration).
  • Eine Abfragesprache. GET /v2/query beantwortet Listenfragen, die Read und Expand des Papers nicht beantworten (Query-Handler).
  • Kein Watch, kein Expand, kein Leopard, und eine einzige primäre SQL-Datenbank statt Spanner (§3.1).

Status

  • Open Source: erstes Release v0.1.0 am 2023-02-23; letztes Release v1.15.1 am 2024-06-10; letzter Commit am 2025-12-05, eine Änderung am README; nicht archiviert; etwa 1.300 Sterne (Releases, GitHub-API, 2026-11-13).
  • Unternehmen: von WorkOS übernommen, angekündigt auf X am 2024-04-23 (siehe oben; der Beitrag selbst konnte nicht geladen werden).
  • Produkt: WorkOS FGA. Seine aktuelle Dokumentation erwähnt weder Warrant noch Zanzibar. Sie stellt FGA als Erweiterung von WorkOS RBAC dar: “You configure resource types in the WorkOS Dashboard” (Sie konfigurieren Ressourcentypen im WorkOS-Dashboard), und FGA “can be adopted incrementally, with no data migration or confusing schema DSL” (kann schrittweise eingeführt werden, ohne Datenmigration oder verwirrende Schema-DSL) (WorkOS-FGA-Dokumentation, vom Hersteller verfasst). Das Objekttyp-JSON auf dieser Seite ist das Open-Source-Format, nicht das von WorkOS FGA.

Quellen