system:ory-keto@fr

Écosystème

Ory Keto

Le serveur de permissions open source d’Ory, reconstruit sur le modèle Zanzibar en 2021, configuré dans un sous-ensemble de TypeScript, avec des champs snaptoken qui ne sont pas encore implémentés.

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

Mainteneur
Ory Corp
Licence
Apache-2.0
Langage
Go
État
Actif, rythme de publication ralenti
Dernière version
v26.2.0 (2026-03-20)
Dépôt
github.com/ory/keto
Documentation
www.ory.com/docs/keto

Ory Keto est un serveur de permissions écrit en Go par Ory Corp. Son README le présente comme « an open source implementation of ‘Zanzibar: Google’s Consistent, Global Authorization System’ » (une implémentation open source de « Zanzibar : le système d’autorisation global et cohérent de Google ») (README). Ory l’exploite également comme service géré : « Ory Permissions is powered by the open source Ory Keto » (Ory Permissions repose sur Ory Keto, open source) sur l’Ory Network (même README).

Keto n’a pas commencé comme un système de type Zanzibar. La conception Zanzibar est arrivée avec la v0.6.0-alpha.1 le 2021-04-07 ; les notes de version indiquent que l’ancien Keto a été déplacé dans une branche legacy-0.5 et que « the architectures are vastly different » (les architectures sont très différentes) (notes de version). Les réécritures de userset, écrites dans l’Ory Permission Language, ont suivi avec la v0.10.0-alpha.0 le 2022-09-27 (notes de version).

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

Dans l’article Dans Ory Keto
Configuration d’espace de noms (§2.3) Une class qui implements Namespace dans l’Ory Permission Language (OPL), un sous-ensemble de TypeScript (OPL reference)
Tuple de relation object#relation@user (§2.1) namespace:object#relation@subject, par exemple Group:eng#members@User:beto (relation tuples, analyseur)
_this this.related.viewers.includes(ctx.subject)
computed_userset this.permits.edit(ctx) : « A permission can call another permission defined on the same namespace » (une permission peut appeler une autre permission définie dans le même espace de noms)
tuple_to_userset this.related.parents.traverse((p) => p.permits.view(ctx))
Union, intersection, exclusion ||, &&, !
Zookie (§2.2, §2.4) Des champs snaptoken existent dans l’API, mais chacun est « not implemented yet and has no effect » (pas encore implémenté et sans effet) (check_service.proto)
Check (§2.4.4) CheckService.Check, BatchCheck
Read (§2.4.1) ReadService.ListRelationTuples (read_service.proto)
Write (§2.4.2) WriteService.TransactRelationTuples, DeleteRelationTuples (write_service.proto)
Watch (§2.4.3) Aucun dans l’API
Expand (§2.4.5) ExpandService.Expand (expand_service.proto)
Leopard (§3.2.4) Aucun équivalent documenté
Spanner (§3.1) PostgreSQL, MySQL ou CockroachDB ; SQLite pour le développement uniquement (production guide)

L’exemple suivi en OPL

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). En OPL, chaque espace de noms est une classe : related déclare les relations et les types de sujets qu’elles acceptent, et permits contient des fonctions qui renvoient vrai ou faux pour ctx.subject.

import { Namespace, SubjectSet, Context } from "@ory/keto-namespace-types"

class User implements Namespace {}

class Group implements Namespace {
  related: {
    members: User[]
  }
}

class Folder implements Namespace {
  related: {
    viewers: (User | SubjectSet<Group, "members">)[]
  }

  permits = {
    view: (ctx: Context): boolean => this.related.viewers.includes(ctx.subject),
  }
}

class Doc implements Namespace {
  related: {
    parents: Folder[]
    owners: User[]
    editors: (User | SubjectSet<Group, "members">)[]
    viewers: (User | SubjectSet<Group, "members">)[]
  }

  permits = {
    edit: (ctx: Context): boolean =>
      this.related.owners.includes(ctx.subject) ||
      this.related.editors.includes(ctx.subject),

    view: (ctx: Context): boolean =>
      this.related.viewers.includes(ctx.subject) ||
      this.permits.edit(ctx) ||
      this.related.parents.traverse((p) => p.permits.view(ctx)),
  }
}

SubjectSet<Group, "members"> est le type OPL pour « les membres d’un groupe », le userset de l’article. Les relations sont toujours des tableaux, car « an object can have many subjects » (un objet peut avoir de nombreux sujets) (OPL reference).

Les cinq tuples de l’exemple suivi, dans la forme textuelle de Keto. Un sujet écrit User:anne est un ensemble de sujets (subject set) dont la relation est vide ; les tuples d’exemple des mainteneurs écrivent les utilisateurs de cette façon (tuples.json).

Doc:readme#owners@User:anne
Group:eng#members@User:beto
Doc:readme#viewers@Group:eng#members
Doc:readme#parents@Folder:A
Folder:A#viewers@User:chen

Quel tuple et quelle expression OPL décident de l’accès de chaque personne au readme ?

L’exemple suivi sous forme de tuples de relation KetoCinq tuples de relation. User:anne est dans owners de Doc:readme. User:beto est dans members de Group:eng. Group:eng#members est dans viewers de Doc:readme. Folder:A est dans parents de Doc:readme. User:chen est dans viewers de Folder:A. Le chemin de Chen via Folder:A est mis en évidence : il est résolu par traverse sur parents.User:anneUser:betoUser:chenGroup:engFolder:ADoc:readmeownersmembersviewers(#members)viewersparents
Anne : owners → permits.edit → view. Beto : l’ensemble de sujets Group:eng#members. Chen : parents.traverse(p => p.permits.view). Pointillés : un ensemble de sujets.

On remarque que seules les flèches sont stockées. Chaque étape qui fait d’un propriétaire un lecteur, ou d’un lecteur du dossier un lecteur du document, se trouve dans les fonctions permits et s’exécute au moment de la vérification.

Architecture

Quelles parties d’un déploiement Keto communiquent avec lesquelles ?

Déploiement d’Ory Keto, tel que décrit dans la documentationChaque conteneur Keto sert par défaut une Read API sur le port 4466 et une Write API sur le port 4467. Les clients exposés au public n’atteignent que la Read API, derrière une passerelle. Votre backend utilise la Write API. Tous les conteneurs partagent une seule base de données SQL. Passer à l’échelle consiste à ajouter des conteneurs.Clients viapasserelle d’APIVotre backendConteneur KetoRead :4466 · Write :4467Conteneur KetoRead :4466 · Write :4467Base de données SQLRead API seuleWrite + ReadSQLSQL
Jaune : conteneurs Keto. Vert : la base de données partagée. Bleu : clients. Aucun trafic entre conteneurs n’est documenté.
  • Chaque conteneur sert une Read API (port par défaut 4466), une Write API (4467) et une API de syntaxe OPL (4469), chacune en HTTP et en gRPC (config schema).
  • « A good practice is to not expose the Write API at all to the public internet » (une bonne pratique consiste à ne pas exposer du tout la Write API sur l’internet public), et « The Read API should also be protected » (la Read API doit également être protégée) (production guide).
  • Passage à l’échelle : « There are no additional requirements for scaling when self-hosting Ory Keto, just spin up another container! » (il n’y a pas d’exigence supplémentaire pour passer à l’échelle lorsqu’on héberge soi-même Ory Keto : il suffit de lancer un autre conteneur !) (même guide). Les conteneurs partagent la base de données.

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). L’API protobuf de Keto reprend la même idée dans ses noms de champs : snaptoken sur Check, Expand et ListRelationTuples, snaptokens sur TransactRelationTuples, et un indicateur latest pour une vérification de modification de contenu. Chacun de ces champs est documenté comme « not implemented yet and has no effect » (pas encore implémenté et sans effet) (check_service.proto).

Qu’advient-il aujourd’hui d’un jeton envoyé par un client ?

Des champs snaptoken sans effetLe service écrit un tuple avec TransactRelationTuples ; Keto le stocke dans la base de données SQL. La réponse comporte un champ snaptokens, qui n’est pas implémenté. Plus tard, le service envoie un Check avec un snaptoken ; Keto ignore le champ, si bien que le jeton n’apporte aucune garantie de fraîcheur.tempsVotre serviceKetoBase de données SQLTransact : ajouterun viewer à Doc:readmeligne écritesnaptokens :non implémentéCheck avecsnaptokenchampsans effet
La forme de l’API suit le protocole zookie de l’article ; le comportement n’est pas encore implémenté.

On remarque que la garantie que l’article construit sur les zookies, à savoir protéger le contenu contre le problème du « nouvel ennemi » (§2.2), dépend donc du comportement de la base de données SQL sous-jacente. Les pages de documentation de Keto consultées ici ne disent rien de la cohérence.

Différences avec l’article

  • Pas de zookies. Les champs existent ; le comportement, non (voir ci-dessus).
  • Pas de Watch. L’API v1alpha2 comporte les services Check, Expand, Read, Write, Namespaces et Version, ainsi qu’un service de syntaxe OPL distinct (opl/v1alpha1), mais aucun flux de modifications (répertoire proto). Le Watch de l’article alimente des index secondaires et Leopard (§2.4.3, §3.2.4).
  • Pas de Leopard. Aucun index d’ensembles dénormalisé n’est documenté.
  • Une syntaxe de langage de programmation. OPL est un sous-ensemble de TypeScript afin que « users can get context help from their IDE » (les utilisateurs puissent obtenir une aide contextuelle de leur IDE) (spécification OPL). La figure 1 de l’article écrit une configuration dans une syntaxe textuelle de type protocol buffer (§2.3.1) ; l’article ne nomme pas le format.
  • Stockage SQL. Une base de données SQL partagée plutôt que Spanner (§3.1).
  • Profondeur des vérifications. Les requêtes Check portent un max_depth, « The maximum depth to search for a relation » (la profondeur maximale de recherche d’une relation) (check_service.proto).

Statut

  • Première version le 2018-11-13 (conception antérieure à Zanzibar) ; conception Zanzibar à partir de la v0.6.0-alpha.1 le 2021-04-07 ; OPL à partir de la v0.10.0-alpha.0 le 2022-09-27 (versions).
  • Les numéros de version ont changé de schéma après la v0.14.0 (2025-03-06) : la version suivante a été la v25.4.0 (2025-11-07), puis la v26.2.0 (2026-03-20), la plus récente au 2026-11-13.
  • Dernier commit sur la branche par défaut : 2026-07-29. Environ 5.4k étoiles (API GitHub, 2026-11-13).

Sources