system:permify@es

Ecosistema

Permify

Un servicio de autorización de código abierto modelado según Zanzibar, ahora propiedad de FusionAuth y con licencia AGPL-3.0, con un lenguaje de esquema, snap tokens y un almacén de datos PostgreSQL.

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

Mantenedor
FusionAuth (acquisition announced 2025-11-20)
Licencia
AGPL-3.0 (Apache-2.0 until 2025-05-12)
Lenguaje
Go
Estado
Activo
Última versión
v1.7.6 (2026-11-05)
Repositorio
github.com/Permify/permify
Documentación
fusionauth.io/permify-docs

Permify es un servicio de autorización escrito en Go. Su documentación lo llama “an open-source authorization service for creating fine-grained and scalable authorization systems” (un servicio de autorización de código abierto para crear sistemas de autorización de grano fino y escalables), “inspired by Google’s consistent, global authorization system, Google Zanzibar” (inspirado en el sistema de autorización global y consistente de Google, Google Zanzibar) (documentación de Permify). Los tipos de entidad y sus relaciones se describen en el Permify Schema, las relaciones se escriben como tuplas y se pregunta a un servidor, mediante gRPC o HTTP, si un sujeto tiene un permiso.

La adquisición de Permify por FusionAuth se anunció el 2025-11-20 (anuncio de Permify, anuncio de FusionAuth). FusionAuth llama ahora al producto “FusionAuth FGA by Permify” (entrada de soporte de FusionAuth), y la documentación está en fusionauth.io/permify-docs. La entrada de Permify afirma que “The core Permify project remains open source and will continue to live on GitHub.” (El proyecto central de Permify sigue siendo de código abierto y seguirá en GitHub.)

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

Cada fila nombra un concepto del artículo y lo más parecido que documenta Permify. Cuando Permify no tiene nada comparable, la celda lo indica.

En el artículo En Permify
Configuración del espacio de nombres (§2.3) Un bloque entity en el Permify Schema, con relation, permission (o su sinónimo action), attribute y rule (modeling)
Tupla de relación object#relation@user (§2.1) Relational tuple entity#relation@subject, por ejemplo doc:readme#owner@user:anne (storing data)
_this Las tuplas almacenadas de una relation; un permiso las incluye nombrando la relación
computed_userset Nombrar otra relación u otro permiso de la misma entidad, como edit dentro de view = viewer or edit
tuple_to_userset Recorrido con punto a través de una relación, como parent.view
Unión, intersección, exclusión or, and, not
Zookie (§2.2, §2.4) Snap token, el campo snap_token (snap tokens)
Check (§2.4.4) Permission.Check, más BulkCheck (service.proto)
Read (§2.4.1) Data.ReadRelationships, más ReadAttributes
Write (§2.4.2) Data.Write, WriteRelationships, Delete, DeleteRelationships
Watch (§2.4.3) Watch.Watch, un flujo del servidor (Watch operations)
Expand (§2.4.5) Permission.Expand
Leopard (§3.2.4) Sin equivalente documentado
Spanner (§3.1) PostgreSQL, o un motor en memoria (el predeterminado en la configuración) (configuration)

Permify tiene además llamadas de búsqueda que el artículo no describe: LookupEntity, LookupSubject y SubjectPermission.

El ejemplo de referencia en Permify Schema

La Figura 1 del artículo da a los documentos tres relaciones concéntricas: los propietarios son editores, los editores son lectores y los lectores de la carpeta padre son lectores del documento (§2.3.1). Este es ese modelo con los tipos del ejemplo de referencia, en Permify Schema.

entity user {}

entity group {
    relation member @user
}

entity folder {
    relation viewer @user @group#member

    permission view = viewer
}

entity doc {
    relation parent @folder
    relation owner @user
    relation editor @user @group#member
    relation viewer @user @group#member

    permission edit = owner or editor
    permission view = viewer or edit or parent.view
}

@group#member permite que una relación contenga un userset: “todos los que son miembros de este grupo”. parent.view sigue la relación parent hasta la carpeta y evalúa allí el permiso view de la carpeta; la documentación afirma que “The same traversal rule applies to both relation.userset and relation.permission” (la misma regla de recorrido se aplica tanto a relation.userset como a relation.permission) (modeling).

El ejemplo de referencia son cinco tuplas:

doc:readme#owner@user:anne
group:eng#member@user:beto
doc:readme#viewer@group:eng#member
doc:readme#parent@folder:A
folder:A#viewer@user:chen

¿Qué tuplas almacenadas y qué reglas dan a cada una de las tres personas acceso al readme?

El ejemplo de referencia como relaciones de PermifyCinco relaciones. user:anne es owner de doc:readme. user:beto es member de group:eng. group:eng#member es viewer de doc:readme. folder:A es parent de doc:readme. user:chen es viewer de folder:A. El camino de Chen al readme a través de la carpeta A está resaltado: lo resuelve la regla parent.view.user:anneuser:betouser:chengroup:engfolder:Adoc:readmeownermemberviewer (#member)viewerparent
Anne ve a través de owner → edit → view, Beto a través del userset del grupo, Chen a través de parent.view. Discontinuo: un userset, no un único usuario.

Obsérvese que la flecha de folder:A al readme es una tupla almacenada (doc:readme#parent@folder:A), mientras que el paso que va del acceso de Chen a la carpeta hasta el readme no se almacena en ninguna parte: el parent.view del esquema lo calcula en el momento de la comprobación, como hace tuple_to_userset en el artículo.

Arquitectura

¿Cómo se reparten el trabajo los servidores de Permify y dónde residen las tuplas?

Despliegue de Permify, según la documentaciónUn servicio llama a los pods de Permify mediante gRPC en el puerto 3478 o HTTP en el puerto 3476. En modo distribuido, los pods forman un anillo de hashing consistente, de modo que una solicitud cuyo hash corresponde al pod 2 se responde desde la caché Ristretto local del pod 2. Ambos pods leen y escriben en PostgreSQL, que puede configurarse con conexiones separadas de escritura y de lectura. Un consumidor de Watch mantiene un flujo con un pod.Su servicioConsumidor de WatchPod 1 de Permifycaché localPod 2 de Permifycaché localPostgreSQLescritura + lecturaCheck, Writeanillo de hashSQLSQLflujo de Watch
Amarillo: servidores de Permify. Verde: el almacén de datos. Azul: clientes. El anillo es opcional (modo distribuido).

Las piezas, cada una según la documentación:

  • Los servidores escuchan por defecto en el puerto HTTP 3476 y en el puerto gRPC 3478 (configuration). La sección de base de datos acepta URI separadas de writer y reader.
  • Cada pod mantiene una caché Ristretto local del proceso con los resultados de las comprobaciones; “there is no shared cache layer” (no hay capa de caché compartida) (cache).
  • Con distributed.enabled, los pods asignan cada solicitud a un anillo de hashing consistente, de modo que “subsequent API calls with the same hash will retrieve the response from the instance 2, regardless of which instance that API called from” (las llamadas posteriores a la API con el mismo hash obtendrán la respuesta de la instancia 2, sea cual sea la instancia desde la que se llamó a la API). Un circuit breaker detiene las llamadas a la base de datos mientras está caída.
  • PostgreSQL almacena las tuplas con MVCC: Permify crea “a separate database snapshot for each write and delete operation” (una instantánea de base de datos separada para cada operación de escritura y de eliminación), y un recolector de basura opcional elimina las versiones antiguas.
  • Cada flujo de Watch “opens a long-lived connection with a continuous polling loop against the database” (abre una conexión de larga duración con un bucle de sondeo continuo contra la base de datos) (Watch operations).

Consistencia

El snap token de Permify cumple el papel del zookie. Un Write lo devuelve; el cliente lo almacena con el recurso y lo devuelve como snap_token en las comprobaciones posteriores. La documentación lo describe como “a token that consists of an encoded timestamp” (un token que consiste en una marca de tiempo codificada), que se compara en las comprobaciones de acceso “to ensure that the snapshot of the access control is at least as fresh as the resource timestamp” (para garantizar que la instantánea del control de acceso sea al menos tan reciente como la marca de tiempo del recurso) (snap tokens). Es la garantía del artículo para una comprobación que lleva un zookie: “a consistent snapshot no earlier than” (una instantánea consistente no anterior al) zookie dado (§2.4.4).

¿Cómo llega a ver un cambio de compartición una comprobación hecha después de él?

Ida y vuelta del snap tokenEl servicio escribe la tupla doc:readme#viewer@group:eng#member. Permify la registra en una nueva transacción en PostgreSQL y devuelve un snap token. El servicio almacena el token con el readme. Una comprobación posterior de Beto sobre el readme envía el token, y Permify evalúa la comprobación en una instantánea no más antigua que el token, así que la nueva tupla viewer es visible.tiempoSu servicioPermifyPostgreSQLsnap_tokenWrite: eng#memberve el readmeData.Writenueva transacciónregistradadevuelvesnap_tokenguarda el tokencon el readmeCheck beto view+ snap_tokeninstantánea no másantigua que el token
El token viaja con el contenido, como el zookie del artículo (§2.2).

Obsérvese el comportamiento sin token. El artículo permite a Zanzibar “choose a reasonably recent snapshot, possibly offering a lower-latency response” (elegir una instantánea razonablemente reciente, lo que posiblemente ofrezca una respuesta de menor latencia) (§2.4.1). Permify, en cambio, lee el ID de la última transacción de su tabla transactions y evalúa en esa instantánea; el resultado se guarda en caché con una clave que contiene ese ID (snap tokens). La clave de caché es check_{tenant_id}_{schema_version}:{snapshot_token}:{check_request} (cache), así que una escritura nueva produce claves nuevas en lugar de invalidar las antiguas.

Diferencias con el artículo

  • Atributos y reglas. El Permify Schema añade attribute y rule para comprobaciones basadas en atributos, como permission view = check_ip_range(ip_range) or admin (modeling). Las reescrituras de Zanzibar solo operan sobre tuplas (§2.3.1).
  • Tuplas contextuales. Las relaciones “dynamically added to permission request operations” (añadidas dinámicamente a las operaciones de solicitud de permisos) se evalúan junto con las almacenadas y nunca se escriben (contextual tuples).
  • Inquilinos. Un servicio Tenancy crea, lista y elimina inquilinos (service.proto); el artículo no tiene el concepto de inquilino.
  • Almacenamiento. PostgreSQL con instantáneas MVCC, en lugar de Spanner, cuyo mecanismo TrueTime asigna una marca de tiempo a cada escritura de ACL (§2.2, §3.1). La caché distribuida funciona “across availability zones (within an AWS region)” (entre zonas de disponibilidad, dentro de una región de AWS) (cache).
  • Sin índice desnormalizado. El artículo responde a las comprobaciones de grupos profundamente anidados con Leopard (§3.2.4). Permify documenta caché de resultados y hashing consistente, no un índice de conjuntos.
  • Búsquedas. LookupEntity y LookupSubject responden a preguntas de “qué recursos” y “qué sujetos” que la API del artículo no cubre.

Estado

  • Primera versión v0.0.0-alpha1 el 2022-08-03; la última, v1.7.6, el 2026-11-05; último commit en la rama predeterminada el 2026-11-10; unas 6.0k estrellas (versiones, API de GitHub, 2026-11-13).
  • Licencia: el archivo LICENSE se sustituyó por el texto de Apache-2.0 el 2023-02-14 (commit 97285f9) y por el texto de AGPL-3.0 el 2025-05-12, en un commit titulado “docs: update license” (commit 26912d9). Antes de eso, en 2022, el archivo contenía el texto de Apache-2.0 (2022-07-14), luego GPL-3.0 (2022-08-25) y luego AGPL-3.0 (2022-08-26) (historial de LICENSE).
  • Propiedad: adquirido por FusionAuth, anunciado el 2025-11-20 en el blog de Permify (entrada); la página del anuncio de FusionAuth no muestra fecha (entrada). Ambas son del proveedor.
  • La documentación se trasladó de docs.permify.co a fusionauth.io/permify-docs.

Fuentes