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?
Architektur
Welche Datenbank beantwortet eine Anfrage?
- Ein Go-Dienst bedient die HTTP-API (router.go).
- Konfigurationen für MySQL und PostgreSQL nehmen einen
dsnund einen optionalenreaderDsn(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?
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/querybeantwortet 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
- Repository und README von Warrant: github.com/warrant-dev/warrant
- Spezifikation der Objekttypen: pkg/authz/objecttype/spec.go
- Check-Engine: pkg/authz/check/service.go
- Tokens: pkg/wookie
- Datenbank-Pools: pkg/database/sql.go, pkg/config/config.go
- Standard-Objekttypen: 000002_create_default_obj_types.up.sql
- Testfixtures: tests/v2/authz.json
- Website: warrant.dev
- Beitrag von WorkOS auf X: x.com/WorkOS/status/1782774170146791776
- Dokumentation von WorkOS FGA: workos.com/docs/fga