system:ory-keto@es

Ecosistema

Ory Keto

El servidor de permisos de código abierto de Ory, reconstruido sobre el modelo de Zanzibar en 2021, configurado en un subconjunto de TypeScript y con campos snaptoken que aún no están implementados.

Datos verificados el Secciones del artículo §2.1, §2.2, §2.3.1, §2.4

Mantenedor
Ory Corp
Licencia
Apache-2.0
Lenguaje
Go
Estado
Activo, con un ritmo de versiones más lento
Última versión
v26.2.0 (2026-03-20)
Repositorio
github.com/ory/keto
Documentación
www.ory.com/docs/keto

Ory Keto es un servidor de permisos escrito en Go por Ory Corp. Su README lo llama “an open source implementation of ‘Zanzibar: Google’s Consistent, Global Authorization System’” (una implementación de código abierto de “Zanzibar: Google’s Consistent, Global Authorization System”) (README). Ory también lo ofrece como servicio gestionado: “Ory Permissions is powered by the open source Ory Keto” (Ory Permissions funciona con el Ory Keto de código abierto) en Ory Network (mismo README).

Keto no nació como un sistema Zanzibar. El diseño de Zanzibar llegó en la v0.6.0-alpha.1 el 2021-04-07; las notas de la versión dicen que el Keto anterior pasó a una rama legacy-0.5 y que “the architectures are vastly different” (las arquitecturas son muy distintas) (notas de la versión). Las reescrituras de usersets, escritas en el Ory Permission Language, llegaron después, en la v0.10.0-alpha.0 el 2022-09-27 (notas de la versión).

El artículo y Keto, uno al lado del otro

En el artículo En Ory Keto
Configuración del espacio de nombres (§2.3) Una class que implements Namespace en el Ory Permission Language (OPL), un subconjunto de TypeScript (referencia de OPL)
Tupla de relación object#relation@user (§2.1) namespace:object#relation@subject, por ejemplo Group:eng#members@User:beto (relation tuples, parser)
_this this.related.viewers.includes(ctx.subject)
computed_userset this.permits.edit(ctx): “A permission can call another permission defined on the same namespace” (un permiso puede llamar a otro permiso definido en el mismo espacio de nombres)
tuple_to_userset this.related.parents.traverse((p) => p.permits.view(ctx))
Unión, intersección, exclusión ||, &&, !
Zookie (§2.2, §2.4) Existen campos snaptoken en la API, pero cada uno está “not implemented yet and has no effect” (aún no implementado y sin efecto) (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) Ninguno en la API
Expand (§2.4.5) ExpandService.Expand (expand_service.proto)
Leopard (§3.2.4) Sin equivalente documentado
Spanner (§3.1) PostgreSQL, MySQL o CockroachDB; SQLite solo para desarrollo (guía de producción)

El ejemplo de referencia en OPL

La Figura 1 del artículo hace que los propietarios sean editores, los editores lectores, y los lectores de la carpeta padre lectores del documento (§2.3.1). En OPL, cada espacio de nombres es una clase: related declara las relaciones y los tipos de sujeto que aceptan, y permits contiene funciones que devuelven verdadero o falso para 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"> es el tipo de OPL para “los miembros de un grupo”, el userset del artículo. Las relaciones son siempre arrays porque “an object can have many subjects” (un objeto puede tener muchos sujetos) (referencia de OPL).

Las cinco tuplas del ejemplo de referencia, en la forma textual de Keto. Un sujeto escrito como User:anne es un subject set con una relación vacía; las tuplas de ejemplo de los mantenedores escriben así a los usuarios (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

¿Qué tupla y qué expresión de OPL deciden el acceso de cada persona al readme?

El ejemplo de referencia como tuplas de relación de KetoCinco tuplas de relación. User:anne está en owners de Doc:readme. User:beto está en members de Group:eng. Group:eng#members está en viewers de Doc:readme. Folder:A está en parents de Doc:readme. User:chen está en viewers de Folder:A. El camino de Chen a través de Folder:A está resaltado: lo resuelve traverse sobre parents.User:anneUser:betoUser:chenGroup:engFolder:ADoc:readmeownersmembersviewers(#members)viewersparents
Anne: owners → permits.edit → view. Beto: el subject set Group:eng#members. Chen: parents.traverse(p => p.permits.view). Discontinuo: un subject set.

Obsérvese que solo se almacenan las flechas. Cada paso que convierte a un propietario en lector, o a un lector de la carpeta en lector del documento, vive en las funciones permits y se ejecuta en el momento de la comprobación.

Arquitectura

¿Qué partes de un despliegue de Keto hablan con cuáles?

Despliegue de Ory Keto, según la documentaciónCada contenedor de Keto sirve por defecto una Read API en el puerto 4466 y una Write API en el puerto 4467. Los clientes expuestos al público solo llegan a la Read API, detrás de una pasarela. Su backend usa la Write API. Todos los contenedores comparten una base de datos SQL. Escalar significa añadir contenedores.Clientes víapasarela de APISu backendContenedor de KetoRead :4466 · Write :4467Contenedor de KetoRead :4466 · Write :4467Base de datos SQLsolo Read APIWrite + ReadSQLSQL
Amarillo: contenedores de Keto. Verde: la base de datos compartida. Azul: clientes. No se documenta tráfico entre contenedores.
  • Cada contenedor sirve una Read API (puerto predeterminado 4466), una Write API (4467) y una API de sintaxis de OPL (4469), cada una por HTTP y gRPC (esquema de configuración).
  • “A good practice is to not expose the Write API at all to the public internet” (una buena práctica es no exponer en absoluto la Write API a la internet pública), y “The Read API should also be protected” (la Read API también debe protegerse) (guía de producción).
  • Escalado: “There are no additional requirements for scaling when self-hosting Ory Keto, just spin up another container!” (no hay requisitos adicionales para escalar cuando se aloja Ory Keto por cuenta propia: ¡basta con levantar otro contenedor!) (misma guía). Los contenedores comparten la base de datos.

Consistencia

El zookie del artículo permite a un cliente pedir una comprobación “at a consistent snapshot no earlier than the given zookie” (en una instantánea consistente no anterior al zookie dado) (§2.4.4). La API protobuf de Keto recoge la misma idea en los nombres de sus campos: snaptoken en Check, Expand y ListRelationTuples, snaptokens en TransactRelationTuples, y un indicador latest para una comprobación de cambio de contenido. Todos estos campos están documentados como “not implemented yet and has no effect” (aún no implementado y sin efecto) (check_service.proto).

¿Qué ocurre hoy con un token que envía un cliente?

Campos snaptoken sin efectoEl servicio escribe una tupla con TransactRelationTuples; Keto la almacena en la base de datos SQL. La respuesta tiene un campo snaptokens, que no está implementado. Más tarde, el servicio envía un Check con un snaptoken; Keto ignora el campo, así que el token no da ninguna garantía de frescura.tiempoSu servicioKetoBase de datos SQLTransact: añadelector de Doc:readmefila escritasnaptokens:no implementadoCheck consnaptokenel campo notiene efecto
La forma de la API sigue el protocolo de zookies del artículo; el comportamiento aún no está ahí.

Obsérvese que la garantía que el artículo construye sobre los zookies, proteger el contenido del problema del “nuevo enemigo” (§2.2), depende por tanto de cómo se comporte la base de datos SQL subyacente. Las páginas de documentación de Keto consultadas aquí no dicen nada sobre la consistencia.

Diferencias con el artículo

  • Sin zookies. Los campos existen; el comportamiento, no (véase más arriba).
  • Sin Watch. La API v1alpha2 tiene servicios Check, Expand, Read, Write, Namespaces y Version, y un servicio de sintaxis de OPL aparte (opl/v1alpha1), pero ningún flujo de cambios (directorio de protos). El Watch del artículo alimenta los índices secundarios y Leopard (§2.4.3, §3.2.4).
  • Sin Leopard. No se documenta ningún índice de conjuntos desnormalizado.
  • Una sintaxis de lenguaje de programación. OPL es un subconjunto de TypeScript para que “users can get context help from their IDE” (los usuarios puedan obtener ayuda contextual de su IDE) (especificación de OPL). La Figura 1 del artículo escribe una configuración en una sintaxis de texto al estilo de protocol buffers (§2.3.1); el artículo no nombra el formato.
  • Almacenamiento SQL. Una base de datos SQL compartida en lugar de Spanner (§3.1).
  • Profundidad de la comprobación. Las solicitudes Check llevan un max_depth, “The maximum depth to search for a relation” (la profundidad máxima hasta la que buscar una relación) (check_service.proto).

Estado

  • Primera versión el 2018-11-13 (diseño anterior a Zanzibar); diseño de Zanzibar desde la v0.6.0-alpha.1 el 2021-04-07; OPL desde la v0.10.0-alpha.0 el 2022-09-27 (versiones).
  • Los números de versión cambiaron de esquema tras la v0.14.0 (2025-03-06): la siguiente versión fue la v25.4.0 (2025-11-07), después la v26.2.0 (2026-03-20), la última a 2026-11-13.
  • Último commit en la rama predeterminada: 2026-07-29. Unas 5.4k estrellas (API de GitHub, 2026-11-13).

Fuentes