Topaz ist ein in Go geschriebener Autorisierungsdienst. Er “uses the Open Policy Agent (OPA) as its decision engine, and provides a built-in directory that is inspired by the Google Zanzibar data model” (verwendet den Open Policy Agent (OPA) als Entscheidungs-Engine und bietet ein eingebautes Verzeichnis, das vom Datenmodell von Google Zanzibar inspiriert ist) (README). Eine Entscheidung trifft eine Rego-Richtlinie; die Richtlinie kann das Verzeichnis fragen, ob zwischen einem Subjekt und einem Objekt eine Relation oder Berechtigung besteht, und das ist der Teil, der Zanzibar ähnelt. Die Verzeichnisdaten werden “modeled and stored locally in an embedded database” (lokal in einer eingebetteten Datenbank modelliert und gespeichert) (dasselbe README).
Topaz wurde von Aserto entwickelt. Am 2025-04-27 kündigte Aserto an, es sei “sunsetting the Aserto SaaS control plane and will shut it down by May 31, 2025” (dabei, die SaaS-Control-Plane von Aserto auslaufen zu lassen, und werde sie bis zum 31. Mai 2025 abschalten), es werde “wind down Aserto as a commercial entity” (Aserto als kommerzielles Unternehmen abwickeln), und “we have a set of maintainers that will continue to support Topaz” (wir haben eine Gruppe von Maintainern, die Topaz weiter unterstützen werden) (Aserto-Blog, vom Hersteller verfasst). Seitdem sind weiter Releases erschienen. Die 30 neuesten Commits auf dem Standardbranch stammen mit Stand 2026-11-13 alle von einem Autor, Gert Drapers, der auch den Beitrag zur Abwicklung unterzeichnet hat (Commits).
Paper und Topaz nebeneinander
| Im Paper | In Topaz |
|---|---|
| Namespace-Konfiguration (§2.3) | Ein Objekttyp unter types im Manifest, einer YAML-Datei mit model: version: 3 (Manifest-Referenz) |
Relationstupel object#relation@user (§2.1) |
Ein Relationsdatensatz: object_type, object_id, relation, subject_type, subject_id und ein optionales subject_relation |
_this |
Die gespeicherten Datensätze einer Relation; die Relation listet die Subjekttypen auf, die sie akzeptiert, etwa viewer: user | group#member |
computed_userset |
Eine andere Relation oder Berechtigung desselben Typs innerhalb einer Berechtigung nennen |
tuple_to_userset |
Der Pfeil, etwa parent->can_read |
| Vereinigung, Schnittmenge, Ausschluss | |, &, - |
| zookie (§2.2, §2.4) | Keiner dokumentiert |
| Check (§2.4.4) | Reader.Check und Checks des Verzeichnisses; Richtlinienentscheidungen über Authorizer.Is (reader.proto, authorizer.proto) |
| Read (§2.4.1) | Reader.GetRelation, GetRelations |
| Write (§2.4.2) | Writer.SetRelation, DeleteRelation (writer.proto); Massenladen über Importer.Import (importer.proto) |
| Watch (§2.4.3) | Keines in der Verzeichnis-API |
| Expand (§2.4.5) | Kein Expand-Aufruf; Reader.GetGraph (“get object relationship graph”, also: Beziehungsgraph eines Objekts abrufen) kommt am nächsten |
| Leopard (§3.2.4) | Keine Entsprechung dokumentiert |
| Spanner (§3.1) | Eine eingebettete BoltDB-Datei (Architektur) |
Das durchgehende Beispiel als Topaz-Manifest
Abbildung 1 des Papers macht Eigentümer zu Bearbeitern, Bearbeiter zu Betrachtern und Betrachter des übergeordneten Ordners zu Betrachtern des Dokuments (§2.3.1). Ein Topaz-Manifest trennt relations, die gespeicherte Datensätze enthalten, von permissions, die aus Relationen und anderen Berechtigungen berechnet werden.
model:
version: 3
types:
user: {}
group:
relations:
member: user
folder:
relations:
viewer: user | group#member
permissions:
can_read: viewer
doc:
relations:
parent: folder
owner: user
editor: user | group#member
viewer: user | group#member
permissions:
can_write: owner | editor
can_read: viewer | can_write | parent->can_read
group#member gewährt die Relation “everyone with the member relation to a specified group” (jedem mit der Relation member zu einer angegebenen group), und der Pfeil “allows a permission to be granted to subjects who have a specified relation or permission with another object” (erlaubt es, eine Berechtigung Subjekten zu gewähren, die eine angegebene Relation oder Berechtigung zu einem anderen Objekt haben) (Manifest-Referenz). Namen müssen kleingeschrieben und höchstens 64 Zeichen lang sein.
Die fünf Relationen des durchgehenden Beispiels im JSON-Lines-Format der Beispieldaten der Maintainer (gdrive_relations.jsonl):
{"object_type":"doc","object_id":"readme","relation":"owner","subject_type":"user","subject_id":"anne"}
{"object_type":"group","object_id":"eng","relation":"member","subject_type":"user","subject_id":"beto"}
{"object_type":"doc","object_id":"readme","relation":"viewer","subject_type":"group","subject_id":"eng","subject_relation":"member"}
{"object_type":"doc","object_id":"readme","relation":"parent","subject_type":"folder","subject_id":"A"}
{"object_type":"folder","object_id":"A","relation":"viewer","subject_type":"user","subject_id":"chen"}
Welcher Datensatz und welcher Berechtigungsausdruck entscheiden über das can_read jeder Person für das Readme?
Das Verzeichnis beantwortet diese Frage für sich allein, über Reader.Check. Die Richtlinienschicht ist das, was Topaz obendrauf setzt: Eine Rego-Regel kann das Verzeichnis aufrufen und dessen Antwort mit Attributen der Anfrage kombinieren.
Architektur
Wo läuft eine Entscheidung, und wo liegen die Beziehungsdaten?
- “The Authorizer exposes three APIs to the calling application” (Der Autorisierer stellt der aufrufenden Anwendung drei APIs bereit):
authz/is,authz/queryundauthz/decisiontree, jede “a POST or gRPC API” (eine POST- oder gRPC-API) (Architektur). - Richtlinien erreichen das Verzeichnis über OPA-Built-ins, darunter
ds.check,ds.check_relationundds.check_permission(dieselbe Seite). - “The directory is implemented as a BoltDB instance” (Das Verzeichnis ist als BoltDB-Instanz implementiert) (dieselbe Seite). “Directory objects are loaded on-demand, in contrast to
data.jsonfiles” (Verzeichnisobjekte werden bei Bedarf geladen, im Gegensatz zudata.json-Dateien), die mit der Richtlinie geladen werden. - “The authorizer captures and stores decision logs for every decision that it evaluates” (Der Autorisierer erfasst und speichert Entscheidungsprotokolle für jede Entscheidung, die er auswertet) (dieselbe Seite).
- Topaz kann “as a sidecar or a microservice in your cloud” (als Sidecar oder Microservice in Ihrer Cloud) bereitgestellt werden (Einführung).
Konsistenz
Der zookie des Papers erlaubt es einem Client, eine Prüfung “at a consistent snapshot no earlier than the given zookie” (§2.4.4) (auf einem konsistenten Snapshot, der nicht früher liegt als der angegebene zookie) anzufordern. Topaz dokumentiert nichts Vergleichbares: Die Manifest-Referenz und die Architekturseiten treffen keine Aussage zur Konsistenz, und die Reader- und Writer-Nachrichten des Verzeichnisses tragen kein Token- oder Snapshot-Feld (reader.proto, writer.proto). Eine Prüfung liest die BoltDB-Datei der Topaz-Instanz, auf der sie läuft. Wie mehrere Instanzen Daten teilen oder kopieren, ist auf den hier geprüften Seiten nicht beschrieben.
Unterschiede zum Paper
- Richtlinie zuerst. Die Entscheidungs-API ist
Is, die eine Rego-Richtlinie auswertet; die Prüfung im Zanzibar-Stil ist eine Eingabe, die die Richtlinie verwenden kann. Im Paper ist Check auf dem Userset die Entscheidung (§2.4.4). - Lokaler, eingebetteter Speicher. Eine BoltDB-Datei pro Instanz statt eines weltweit replizierten Spanner (§3.1).
- Kein zookie, kein Watch, kein Leopard. Keines davon ist dokumentiert.
- Wildcards.
viewer: user | user:*erlaubt eine Relation zum Subjekt mit der ID*(Manifest-Referenz). - Entscheidungsprotokolle. Jede Entscheidung wird für Audits protokolliert, was das Paper für Zanzibar nicht beschreibt.
Status
- Erstes Release v0.20.3 am 2022-10-25; neuestes v0.33.28 am 2026-11-14; letzter Commit auf den Standardbranch am 2026-11-14; etwa 1.400 Sterne (Releases, GitHub-API, 2026-11-15).
- Aserto kündigte seine Abwicklung am 2025-04-27 an und das Ende seiner SaaS-Control-Plane bis zum 2025-05-31; Maintainer führen Topaz weiter (Aserto-Blog). Das Repository liegt weiterhin unter der Organisation
aserto-dev.
Quellen
- Repository und README von Topaz: github.com/aserto-dev/topaz
- Topaz-Dokumentation, Einführung: topaz.sh/docs/intro
- Architektur: topaz.sh/docs/architecture
- Manifest-Referenz: topaz.sh/docs/directory/manifest-reference
- Beispielmanifest und -relationen: manifest.yaml, gdrive_relations.jsonl
- Verzeichnis-API: reader.proto, writer.proto, importer.proto
- Neueste Commits: github.com/aserto-dev/topaz/commits/main
- Autorisierer-API: authorizer.proto
- Abwicklung von Aserto: aserto.com/blog/the-final-chapter-for-aserto