Topaz is an authorization service written in Go. It “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” (README). A decision is made by a Rego policy; the policy can ask the directory whether a relation or permission holds between a subject and an object, which is the part that resembles Zanzibar. The directory data is “modeled and stored locally in an embedded database” (same README).
Topaz was built by Aserto. On 2025-04-27 Aserto announced that it was “sunsetting the Aserto SaaS control plane and will shut it down by May 31, 2025”, that it would “wind down Aserto as a commercial entity”, and that “we have a set of maintainers that will continue to support Topaz” (Aserto blog, vendor-authored). Releases have continued since. The 30 most recent commits on the default branch, as of 2026-11-13, are all by one author, Gert Drapers, who also signed the wind-down post (commits).
Paper and Topaz side by side
| In the paper | In Topaz |
|---|---|
| Namespace config (§2.3) | An object type under types in the manifest, a YAML file with model: version: 3 (manifest reference) |
Relation tuple object#relation@user (§2.1) |
A relation record: object_type, object_id, relation, subject_type, subject_id and an optional subject_relation |
_this |
A relation’s stored records; the relation lists the subject types it accepts, as viewer: user | group#member |
computed_userset |
Naming another relation or permission of the same type inside a permission |
tuple_to_userset |
The arrow, as parent->can_read |
| Union, intersection, exclusion | |, &, - |
| Zookie (§2.2, §2.4) | None documented |
| Check (§2.4.4) | Directory Reader.Check and Checks; policy decisions through Authorizer.Is (reader.proto, authorizer.proto) |
| Read (§2.4.1) | Reader.GetRelation, GetRelations |
| Write (§2.4.2) | Writer.SetRelation, DeleteRelation (writer.proto); bulk loads through Importer.Import (importer.proto) |
| Watch (§2.4.3) | None in the directory API |
| Expand (§2.4.5) | No Expand call; Reader.GetGraph (“get object relationship graph”) is the closest |
| Leopard (§3.2.4) | No equivalent documented |
| Spanner (§3.1) | An embedded BoltDB file (architecture) |
The running example as a Topaz manifest
The paper’s Figure 1 makes owners editors, editors viewers, and viewers of the parent folder viewers of the document (§2.3.1). A Topaz manifest separates relations, which hold stored records, from permissions, which are computed from relations and other permissions.
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 grants the relation to “everyone with the member relation to a specified group”, and the arrow “allows a permission to be granted to subjects who have a specified relation or permission with another object” (manifest reference). Names must be lowercase and at most 64 characters.
The five relations of the running example, in the JSON-lines format of the maintainers’ sample data (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"}
Which record and which permission expression decide each person’s can_read on the readme?
Notice that the directory answers this question on its own, through Reader.Check. The policy layer is what Topaz adds on top: a Rego rule can call the directory and combine its answer with attributes of the request.
Architecture
Where does a decision run, and where does the relationship data live?
- “The Authorizer exposes three APIs to the calling application”:
authz/is,authz/queryandauthz/decisiontree, each “a POST or gRPC API” (architecture). - Policies reach the directory through OPA built-ins, including
ds.check,ds.check_relationandds.check_permission(same page). - “The directory is implemented as a BoltDB instance” (same page). “Directory objects are loaded on-demand, in contrast to
data.jsonfiles”, which are loaded with the policy. - “The authorizer captures and stores decision logs for every decision that it evaluates” (same page).
- Topaz can be deployed “as a sidecar or a microservice in your cloud” (intro).
Consistency
The paper’s zookie lets a client ask for a check “at a consistent snapshot no earlier than the given zookie” (§2.4.4). Topaz documents nothing comparable: the manifest reference and architecture pages make no statement about consistency, and the directory’s Reader and Writer messages carry no token or snapshot field (reader.proto, writer.proto). A check reads the BoltDB file of the Topaz instance it runs on. How several instances share or copy data is not described on the pages checked here.
Differences from the paper
- Policy first. The decision API is
Is, which evaluates a Rego policy; the Zanzibar-style check is one input the policy can use. In the paper, Check on the userset is the decision (§2.4.4). - Local, embedded storage. One BoltDB file per instance instead of Spanner replicated worldwide (§3.1).
- No zookie, Watch or Leopard. None is documented.
- Wildcards.
viewer: user | user:*allows a relation to the subject with ID*(manifest reference). - Decision logs. Every decision is logged for audit, which the paper does not describe for Zanzibar.
Status
- First release v0.20.3 on 2022-10-25; latest v0.33.28 on 2026-11-14; last commit to the default branch on 2026-11-14; about 1.4k stars (releases, GitHub API, 2026-11-15).
- Aserto announced its wind-down on 2025-04-27 and the end of its SaaS control plane by 2025-05-31; maintainers continue Topaz (Aserto blog). The repository still lives under the
aserto-devorganization.
Sources
- Topaz repository and README: github.com/aserto-dev/topaz
- Topaz docs, introduction: topaz.sh/docs/intro
- Architecture: topaz.sh/docs/architecture
- Manifest reference: topaz.sh/docs/directory/manifest-reference
- Sample manifest and relations: manifest.yaml, gdrive_relations.jsonl
- Directory API: reader.proto, writer.proto, importer.proto
- Recent commits: github.com/aserto-dev/topaz/commits/main
- Authorizer API: authorizer.proto
- Aserto wind-down: aserto.com/blog/the-final-chapter-for-aserto