system:topaz@fr

Écosystème

Topaz

Un service d’autorisation open source qui associe des politiques Open Policy Agent à un annuaire de type Zanzibar dans une base de données embarquée, pris en charge par ses mainteneurs après la cessation d’activité d’Aserto en 2025.

Faits vérifiés le Sections de l’article §2.1, §2.3.1, §2.4

Mainteneur
Former Aserto maintainers (Aserto wound down in 2025)
Licence
Apache-2.0
Langage
Go
État
Open source, actif
Dernière version
v0.33.28 (2026-11-14)
Dépôt
github.com/aserto-dev/topaz
Documentation
www.topaz.sh/docs/intro

Topaz est un service d’autorisation écrit en Go. Il « 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 » (utilise Open Policy Agent (OPA) comme moteur de décision et fournit un annuaire intégré inspiré du modèle de données de Google Zanzibar) (README). Une décision est prise par une politique Rego ; la politique peut demander à l’annuaire si une relation ou une permission existe entre un sujet et un objet, et c’est cette partie qui ressemble à Zanzibar. Les données de l’annuaire sont « modeled and stored locally in an embedded database » (modélisées et stockées localement dans une base de données embarquée) (même README).

Topaz a été développé par Aserto. Le 2025-04-27, Aserto a annoncé qu’elle était en train de « sunsetting the Aserto SaaS control plane and will shut it down by May 31, 2025 » (mettre fin au plan de contrôle SaaS d’Aserto, qui sera arrêté d’ici le 31 mai 2025), qu’elle allait « wind down Aserto as a commercial entity » (cesser l’activité d’Aserto en tant qu’entité commerciale), et que « we have a set of maintainers that will continue to support Topaz » (nous avons un groupe de mainteneurs qui continueront à prendre en charge Topaz) (blog d’Aserto, rédigé par l’éditeur). De nouvelles versions ont été publiées depuis. Les 30 commits les plus récents sur la branche par défaut, au 2026-11-13, sont tous d’un même auteur, Gert Drapers, qui a également signé le billet annonçant la cessation d’activité (commits).

L’article et Topaz côte à côte

Dans l’article Dans Topaz
Configuration d’espace de noms (§2.3) Un type d’objet sous types dans le manifeste, un fichier YAML avec model: version: 3 (manifest reference)
Tuple de relation object#relation@user (§2.1) Un enregistrement de relation : object_type, object_id, relation, subject_type, subject_id et un subject_relation facultatif
_this Les enregistrements stockés d’une relation ; la relation énumère les types de sujets qu’elle accepte, comme viewer: user | group#member
computed_userset Nommer une autre relation ou permission du même type dans une permission
tuple_to_userset La flèche, comme parent->can_read
Union, intersection, exclusion |, &, -
Zookie (§2.2, §2.4) Aucun documenté
Check (§2.4.4) Reader.Check et Checks de l’annuaire ; décisions de politique via Authorizer.Is (reader.proto, authorizer.proto)
Read (§2.4.1) Reader.GetRelation, GetRelations
Write (§2.4.2) Writer.SetRelation, DeleteRelation (writer.proto) ; chargements en masse via Importer.Import (importer.proto)
Watch (§2.4.3) Aucun dans l’API de l’annuaire
Expand (§2.4.5) Pas d’appel Expand ; Reader.GetGraph (« get object relationship graph », obtenir le graphe des relations d’un objet) est le plus proche
Leopard (§3.2.4) Aucun équivalent documenté
Spanner (§3.1) Un fichier BoltDB embarqué (architecture)

L’exemple suivi sous forme de manifeste Topaz

La figure 1 de l’article fait des propriétaires des éditeurs, des éditeurs des lecteurs, et des lecteurs du dossier parent des lecteurs du document (§2.3.1). Un manifeste Topaz sépare les relations, qui contiennent des enregistrements stockés, des permissions, qui sont calculées à partir des relations et d’autres 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 accorde la relation à « everyone with the member relation to a specified group » (toute personne ayant la relation member avec un group donné), et la flèche « allows a permission to be granted to subjects who have a specified relation or permission with another object » (permet d’accorder une permission aux sujets qui ont une relation ou une permission donnée avec un autre objet) (manifest reference). Les noms doivent être en minuscules et compter au plus 64 caractères.

Les cinq relations de l’exemple suivi, au format JSON Lines des données d’exemple des mainteneurs (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"}

Quel enregistrement et quelle expression de permission décident du can_read de chaque personne sur le readme ?

L’exemple suivi sous forme de relations TopazCinq relations. L’utilisateur anne est owner du doc readme. L’utilisateur beto est member du groupe eng. group eng#member est viewer du doc readme. Le dossier A est parent du doc readme. L’utilisateur chen est viewer du dossier A. Le chemin de Chen via le dossier A est mis en évidence : il est résolu par la flèche parent->can_read.user:anneuser:betouser:chengroup:engfolder:Adoc:readmeownermemberviewer (#member)viewerparent
Anne : owner → can_write → can_read. Beto : la relation de sujet group#member. Chen : parent->can_read. Pointillés : une relation de sujet, et non un utilisateur unique.

On remarque que l’annuaire répond seul à cette question, via Reader.Check. La couche de politique est ce que Topaz ajoute par-dessus : une règle Rego peut appeler l’annuaire et combiner sa réponse avec des attributs de la requête.

Architecture

Où une décision s’exécute-t-elle, et où résident les données de relations ?

Composants de Topaz, tels que décrits dans la documentationVotre application appelle l’API is, query ou decisiontree de l’authorizer via REST ou gRPC. L’authorizer évalue une politique OPA, qui appelle l’annuaire au moyen de fonctions intégrées comme ds.check. L’annuaire stocke les objets et les relations dans un fichier BoltDB. Ce qui charge les données écrit les relations via l’API Writer ou Importer de l’annuaire. L’authorizer consigne un journal de décision pour chaque décision.Votre applicationÉcriture des données(votre code ou CLI)Authorizerpolitique OPAAnnuaireJournaux de décisionFichier BoltDBis / queryds.checkSetRelationImport
Jaune : composants de Topaz. Vert : stockage. Bleu : appelants. Une instance Topaz s’exécute comme sidecar ou comme microservice à côté de l’application.
  • « The Authorizer exposes three APIs to the calling application » (l’authorizer expose trois API à l’application appelante) : authz/is, authz/query et authz/decisiontree, chacune étant « a POST or gRPC API » (une API POST ou gRPC) (architecture).
  • Les politiques atteignent l’annuaire au moyen de fonctions intégrées d’OPA, dont ds.check, ds.check_relation et ds.check_permission (même page).
  • « The directory is implemented as a BoltDB instance » (l’annuaire est implémenté sous la forme d’une instance BoltDB) (même page). « Directory objects are loaded on-demand, in contrast to data.json files » (les objets de l’annuaire sont chargés à la demande, contrairement aux fichiers data.json), qui sont chargés avec la politique.
  • « The authorizer captures and stores decision logs for every decision that it evaluates » (l’authorizer capture et stocke des journaux de décision pour chaque décision qu’il évalue) (même page).
  • Topaz peut être déployé « as a sidecar or a microservice in your cloud » (comme sidecar ou comme microservice dans votre cloud) (intro).

Cohérence

Le zookie de l’article permet à un client de demander une vérification « at a consistent snapshot no earlier than the given zookie » (sur un instantané cohérent qui n’est pas antérieur au zookie donné) (§2.4.4). Topaz ne documente rien de comparable : les pages de référence du manifeste et d’architecture ne disent rien de la cohérence, et les messages Reader et Writer de l’annuaire ne comportent aucun champ de jeton ou d’instantané (reader.proto, writer.proto). Une vérification lit le fichier BoltDB de l’instance Topaz sur laquelle elle s’exécute. La manière dont plusieurs instances partagent ou copient les données n’est pas décrite dans les pages consultées ici.

Différences avec l’article

  • La politique d’abord. L’API de décision est Is, qui évalue une politique Rego ; la vérification de type Zanzibar n’est qu’une entrée dont la politique peut se servir. Dans l’article, le Check sur le userset est la décision (§2.4.4).
  • Stockage local et embarqué. Un fichier BoltDB par instance au lieu de Spanner répliqué dans le monde entier (§3.1).
  • Ni zookie, ni Watch, ni Leopard. Aucun n’est documenté.
  • Jokers. viewer: user | user:* permet une relation avec le sujet d’identifiant * (manifest reference).
  • Journaux de décision. Chaque décision est journalisée à des fins d’audit, ce que l’article ne décrit pas pour Zanzibar.

Statut

  • Première version v0.20.3 le 2022-10-25 ; dernière v0.33.28 le 2026-11-14 ; dernier commit sur la branche par défaut le 2026-11-14 ; environ 1.4k étoiles (versions, API GitHub, 2026-11-15).
  • Aserto a annoncé sa cessation d’activité le 2025-04-27 et la fin de son plan de contrôle SaaS d’ici le 2025-05-31 ; des mainteneurs poursuivent Topaz (blog d’Aserto). Le dépôt se trouve toujours dans l’organisation aserto-dev.

Sources