system:spicedb@de

Ökosystem

SpiceDB

Die Open-Source-Datenbank von AuthZed für Autorisierungsbeziehungen, gelesen vor dem Hintergrund des Zanzibar-Papers.

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

Betreuer
AuthZed, Inc.
Lizenz
Apache-2.0
Sprache
Go
Status
Aktiv
Neueste Version
v1.57.1 (2026-11-10)
Repository
github.com/authzed/spicedb
Dokumentation
authzed.com/docs

SpiceDB ist eine Open-Source-Datenbank, die Beziehungen speichert und Berechtigungsabfragen darüber beantwortet, im Stil von Zanzibar. Sie ist in Go geschrieben, unter Apache-2.0 lizenziert und wird von AuthZed, Inc. gepflegt (Repository). Ihr erstes GitHub-Release, v1.0.0, ist auf den 2021-09-30 datiert. AuthZed verkauft darum herum auch verwaltete und kommerzielle Dienste; diese werden unten als solche benannt. Die meisten Quellen auf dieser Seite sind die eigene Dokumentation und der Blog von AuthZed.

Begriffe des Papers und Begriffe von SpiceDB

Im Paper In SpiceDB
Namespace-Konfiguration (§2.3) Eine definition im Schema (Schema-Dokumentation)
Relationstupel object#relation@user (§2.1) Relationship resource#relation@subject, z. B. document:readme#editor@user:emilia (Relationships)
_this (§2.3.1) Eine relation mit ihren erlaubten Subjekttypen; die dafür gespeicherten Relationships
computed_userset Eine andere Relation oder Berechtigung innerhalb eines permission-Ausdrucks nennen
tuple_to_userset Der Pfeil parent->view (Alias parent.any(view))
union / intersection / exclusion + / & / -
zookie (§2.4) ZedToken (Konsistenz)
Check (§2.4.4) CheckPermission, CheckBulkPermissions
Read (§2.4.1) ReadRelationships
Write (§2.4.2) WriteRelationships, DeleteRelationships
Watch (§2.4.3) Watch
Expand (§2.4.5) ExpandPermissionTree
Nicht in der API des Papers LookupResources, LookupSubjects, ImportBulkRelationships, ExportBulkRelationships
Leopard (§3.2.4) AuthZed Materialize, ein kommerzieller Dienst für Kunden von AuthZed Dedicated (Dokumentation)
Spanner (§3) CockroachDB, Cloud Spanner, PostgreSQL, MySQL, memdb (Datastores)

Die API-Namen stammen aus den Protokolldateien von AuthZed: permission_service.proto und watch_service.proto.

Das durchgehende Beispiel als Schema

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 SpiceDB werden gespeicherte Relationen und berechnete Berechtigungen getrennt deklariert: relation-Zeilen sagen, wer in einer Relationship geschrieben werden darf, permission-Zeilen sagen, wie der Zugriff berechnet wird.

definition user {}

definition group {
    relation member: user
}

definition folder {
    relation viewer: user | group#member
    permission view = viewer
}

definition doc {
    relation parent: folder
    relation owner: user
    relation editor: user | group#member
    relation viewer: user | group#member

    permission edit = owner + editor
    permission view = viewer + edit + parent->view
}

Die Relationships für Anne, Beto und Chen:

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

Welche gespeicherten Relationships führen jede Person zu view auf dem Readme?

Das durchgehende Beispiel als SpiceDB-RelationshipsFünf Relationships. 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. Der Pfad von Chen über folder:A zum Readme ist hervorgehoben: Er ist der Pfeil parent->view.user:anneuser:betouser:chengroup:engfolder:Adoc:readmeownermemberviewer(eng#member)viewerparent
Jeder Pfeil ist eine gespeicherte Relationship. Anne erreicht view über edit (owner), Beto über die Gruppe und Chen über den hervorgehobenen Pfeil parent->view.

Keine Relationship erwähnt view oder edit: Beides sind Berechtigungen, die zur Prüfzeit aus dem Schema berechnet werden, so wie die Umschreibregeln des Papers berechnet statt gespeichert werden (§2.3.1).

Architektur

Wie beantwortet eine SpiceDB-Installation eine Prüfung? AuthZed beschreibt SpiceDB als “fundamentally a gRPC service” (im Kern einen gRPC-Dienst) mit einem optionalen HTTP-Gateway (Architekturbeitrag, 2021-11-17). Ein Knoten zerlegt eine Anfrage in kleinere Fragen und leitet sie an andere Knoten weiter, ein Vorgang, den SpiceDB Dispatch nennt; jeder Knoten hält “an in-memory cache of permissions queries it has resolved in the past” (einen In-Memory-Cache der Berechtigungsabfragen, die er in der Vergangenheit aufgelöst hat) (Performance-Dokumentation). Ein konsistenter Hash schickt “the same (sub-)requests to the same server” (dieselben (Teil-)Anfragen an denselben Server) (Architekturbeitrag). Alle Knoten teilen einen Datastore. Materialize berechnet, wenn verwendet, ausgewählte Berechtigungen vorab, und SpiceDB “can dispatch sub-queries to Materialize” (kann Teilabfragen an Materialize dispatchen) (Performance-Dokumentation).

SpiceDB-ArchitekturEin Anwendungsclient sendet CheckPermission an einen von drei SpiceDB-Knoten. Die Knoten dispatchen Teilanfragen aneinander, geleitet durch konsistentes Hashing. Alle drei Knoten lesen und schreiben einen gemeinsamen Datastore (CockroachDB, Spanner, PostgreSQL oder MySQL). Ein Watch-Konsument empfängt einen Stream von Änderungen von einem SpiceDB-Knoten. AuthZed Materialize, ein kommerzieller Dienst, beobachtet den Datastore, liest periodische Snapshots davon und beantwortet Teilabfragen, die SpiceDB an ihn dispatcht.Anwendung(gRPC-/HTTP-Client)SpiceDB-KnotenSpiceDB-KnotenSpiceDB-KnotenDatastoreCockroachDB · SpannerPostgreSQL · MySQLWatch-KonsumentAuthZed Materialize(kommerziell)CheckPermissionDispatchDispatchLesen / SchreibenWatchÄnderungen, SnapshotsTeilabfragen
Gelb: Server. Grün: der gemeinsame Datastore. Blau: Clients. Gestrichelt: der optionale kommerzielle Materialize-Pfad.

Zum Vergleich Abbildung 2 des Papers (§3): Dort fächern aclservers Arbeit ebenfalls auf andere Server im Cluster auf, aber der Speicher ist immer Spanner, Watch wird von separaten watchservers bedient, die ein Changelog fortlaufend lesen, und Leopard liest sowohl Offline-Snapshots als auch Watch. SpiceDB hat in der hier zitierten Dokumentation keinen eigenen Servertyp für Watch; Watch ist ein RPC desselben Dienstes.

Konsistenz: ZedTokens und zookies

AuthZed nennt das ZedToken “the SpiceDB equivalent of Google Zanzibar’s Zookie concept which protects users from the New Enemy Problem” (die SpiceDB-Entsprechung des Zookie-Konzepts von Google Zanzibar, das Benutzer vor dem „New Enemy“-Problem schützt) (Konsistenz-Dokumentation). Schreibvorgänge geben eines zurück (written_at), Prüfungen ebenso (checked_at). Eine Anfrage kann einen von vier Modi wählen:

Modus Was er verlangt Entsprechung im Paper
minimize_latency Was der Server am schnellsten beantworten kann Kein zookie: “a reasonably recent snapshot” (ein hinreichend aktueller Snapshot) (§2.4.1)
at_least_as_fresh + ZedToken Einen Snapshot, der nicht älter ist als das Token Ein zookie in einer Prüfung oder einem Lesevorgang (§2.2, §2.4)
at_exact_snapshot + ZedToken Genau den Snapshot des Tokens Ein Lese-zookie, wiederverwendet, um “the same snapshot as a previous read” (denselben Snapshot wie ein vorheriger Lesevorgang) zu erhalten (§2.4.1)
fully_consistent Die neuesten Daten Keine direkte Entsprechung; die Content-Change-Prüfung des Papers wird auf dem neuesten Snapshot ausgewertet (§2.4.4)

Bei CockroachDB warnt die Dokumentation, dass fully_consistent “does not guarantee read-after-write consistency” (keine Read-after-Write-Konsistenz garantiert), weil die Uhren der Knoten um bis zu max_offset des Clusters abweichen können; sie empfiehlt stattdessen ein ZedToken mit at_least_as_fresh (Konsistenz-Dokumentation).

fully_consistent ist der Standard für WriteRelationships, DeleteRelationships, ReadSchema und WriteSchema; minimize_latency ist der Standard für jede andere API (Konsistenz-Dokumentation).

Wie verhindert ein ZedToken, dass Chen, der vor der Bearbeitung aus Ordner A entfernt wurde, das bearbeitete Readme sieht?

Ein ZedToken wie einen zookie verwendenDie Anwendung entfernt Chens Sichtrecht auf Ordner A mit WriteRelationships. SpiceDB committet und gibt ein ZedToken Z1 als written_at zurück. Die Anwendung speichert den neuen Inhalt des Readmes zusammen mit Z1. Später wird eine Prüfung für Chen auf dem Readme mit at_least_as_fresh Z1 gesendet. SpiceDB wertet sie auf einem Snapshot aus, der nicht älter als Z1 ist, also wird die Entfernung gesehen, und Chen wird abgewiesen.ZeitAnwendungSpiceDBApp-DatenbankWriteRelationshipswritten_at = Z1at_least_as_fresh Z1Chen aus A entfernenCommitZ1 haltenReadme + Z1 speichernInhalt, Z1darf Chen sehen?Snapshot ≥ Z1abgewiesen
Das Token reist mit dem Inhalt, wie der zookie des Papers (§2.2). Ohne es könnte eine Prüfung mit minimize_latency aus einem Cache beantwortet werden, der älter ist als die Entfernung.

Im Paper stammt der mit dem Inhalt gespeicherte zookie aus einer Content-Change-Prüfung (§2.2, §2.4.4). Die SpiceDB-Dokumentation sagt, dass bei einer Änderung einer Ressource “a new ZedToken is either returned or it should be requested by performing a check with full consistency” (ein neues ZedToken entweder zurückgegeben wird oder durch eine Prüfung mit voller Konsistenz angefordert werden sollte) (Konsistenz-Dokumentation); beide Wege existieren also.

Auch Watch verwendet ZedTokens: Eine Anfrage kann bei optional_start_cursor beginnen, und jede Antwort trägt changes_through zum Fortsetzen, was dem Heartbeat-zookie des Papers entspricht (§2.4.3) (watch_service.proto).

Unterschiede zum Paper

  • Speicherung. Das Paper speichert alles in Spanner (§3.1). SpiceDB hat austauschbare Datastores: CockroachDB (“high throughput and/or multi-region”, also hoher Durchsatz und/oder mehrere Regionen), Cloud Spanner, PostgreSQL (“single-region”, eine Region), MySQL (“Not recommended”, nicht empfohlen) und memdb (lokale Entwicklung und Tests) (Datastores).
  • Relationen und Berechtigungen sind getrennt. Das Paper hängt eine Userset-Umschreibung an eine Relation (§2.3.1). SpiceDB trennt gespeicherte relations von berechneten permissions (Schema).
  • Caveats. Relationships können einen benannten CEL-Ausdruck tragen, der im Schema mit with angehängt wird (z. B. relation viewer: user | user with ip_allowlist) (Caveats). Das Tupel des Papers (§2.1) hat kein solches Feld.
  • Wildcards. relation viewer: user | user:* erlaubt eine öffentliche Freigabe (Schema). Die Tupelgrammatik des Papers hat eine Benutzer-ID oder ein Userset (§2.1), keine Wildcard.
  • Schnittmengen-Pfeil. .all() verlangt, dass jedes verbundene Objekt die Berechtigung gewährt (Schema). Die drei Umschreib-Blätter des Papers (§2.3.1) haben keine solche Form.
  • Standard-Veraltung. Das Paper wählt die Standard-Veraltung adaptiv anhand von Statistiken zu Lesevorgängen außerhalb der Zone (§3.2.1) und rundet unabhängig davon Auswertungszeitstempel “to a coarse granularity, such as one or ten seconds” (auf eine grobe Granularität, etwa eine oder zehn Sekunden) auf, damit Cache-Einträge geteilt werden (§3.2.5). SpiceDB hat nur die Rundung: Es gruppiert Anfrage-Revisionen in Fenster, die durch --datastore-revision-quantization-interval festgelegt werden, damit Cache-Einträge wiederverwendet werden können; AuthZed nennt “the default is 5s” (der Standard ist 5 s) (Beitrag zu Hotspot-Caching, 2023-05-10), was RevisionQuantization: 5 * time.Second im Quellcode entspricht.
  • Lookup-APIs. LookupResources und LookupSubjects beantworten Fragen nach „welchen Ressourcen“ und „welchen Subjekten“ (permission_service.proto). Die API des Papers hat Read, Write, Watch, Check und Expand (§2.4).
  • Leopard. “AuthZed Materialize takes inspiration from the Leopard index component described in the Zanzibar paper” (AuthZed Materialize ist von der im Zanzibar-Paper beschriebenen Leopard-Indexkomponente inspiriert) (Materialize-Dokumentation). Es ist Teil des kostenpflichtigen Angebots von AuthZed, nicht des Open-Source-SpiceDB: Laut Dokumentation ist seine Funktion Accelerated Queries “generally available to users of AuthZed Dedicated” (allgemein verfügbar für Benutzer von AuthZed Dedicated).

Status

Stand 2026-11-13: aktiv. Neuestes Release v1.57.1 am 2026-11-10, Repository nicht archiviert, etwa 7.200 GitHub-Sterne, Apache-2.0 (Repository, Releases).

AuthZed veröffentlicht außerdem eine annotierte Fassung des Papers unter zanzibar.tech (“Annotations © 2026 AuthZed, Inc. Zanzibar Paper © USENIX and original authors”).

Quellen