system:spicedb@pt-BR

Ecossistema

SpiceDB

O banco de dados de código aberto da AuthZed para relacionamentos de autorização, lido à luz do artigo do Zanzibar.

Fatos verificados em Seções do artigo §2.1, §2.2, §2.3.1, §2.4, §3, §3.2.1, §3.2.4, §3.2.5

Mantenedor
AuthZed, Inc.
Licença
Apache-2.0
Linguagem
Go
Status
Ativo
Versão mais recente
v1.57.1 (2026-11-10)
Repositório
github.com/authzed/spicedb
Documentação
authzed.com/docs

O SpiceDB é um banco de dados de código aberto que armazena relacionamentos e responde a consultas de permissão sobre eles, no estilo do Zanzibar. É escrito em Go, licenciado sob Apache-2.0 e mantido pela AuthZed, Inc. (repositório). Sua primeira versão no GitHub, a v1.0.0, é datada de 2021-09-30. A AuthZed também vende serviços gerenciados e comerciais em torno dele; esses são identificados como tal abaixo. A maior parte das fontes desta página é documentação e blog da própria AuthZed.

Termos do artigo e termos do SpiceDB

No artigo No SpiceDB
Configuração de namespace (§2.3) Uma definition no schema (documentação do schema)
Tupla de relação object#relation@user (§2.1) Relationship resource#relation@subject, por exemplo document:readme#editor@user:emilia (relacionamentos)
_this (§2.3.1) Uma relation com seus tipos de sujeito permitidos; os relacionamentos armazenados para ela
computed_userset Nomear outra relação ou permissão dentro de uma expressão permission
tuple_to_userset A seta parent->view (alias parent.any(view))
union / intersection / exclusion + / & / -
Zookie (§2.4) ZedToken (consistência)
Check (§2.4.4) CheckPermission, CheckBulkPermissions
Read (§2.4.1) ReadRelationships
Write (§2.4.2) WriteRelationships, DeleteRelationships
Watch (§2.4.3) Watch
Expand (§2.4.5) ExpandPermissionTree
Fora da API do artigo LookupResources, LookupSubjects, ImportBulkRelationships, ExportBulkRelationships
Leopard (§3.2.4) AuthZed Materialize, um serviço comercial para clientes do AuthZed Dedicated (documentação)
Spanner (§3) CockroachDB, Cloud Spanner, PostgreSQL, MySQL, memdb (repositórios de dados)

Os nomes da API vêm dos arquivos de protocolo da AuthZed: permission_service.proto e watch_service.proto.

O exemplo recorrente como schema

A Figura 1 do artigo torna os donos editores, os editores visualizadores, e os visualizadores da pasta pai visualizadores do documento (§2.3.1). No SpiceDB, relações armazenadas e permissões calculadas são declaradas separadamente: as linhas relation dizem quem pode ser escrito em um relacionamento, e as linhas permission dizem como o acesso é calculado.

definition user {}

definition group {
    relation member: user
}

definition folder {
    relation viewer: user | group#member
    permission view = viewer
}

definition doc {
    relation parent: folder
    relation owner: user
    relation editor: user | group#member
    relation viewer: user | group#member

    permission edit = owner + editor
    permission view = viewer + edit + parent->view
}

Os relacionamentos de Anne, Beto e Chen:

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

Quais relacionamentos armazenados levam cada pessoa a view sobre o readme?

O exemplo recorrente como relacionamentos do SpiceDBCinco relacionamentos. user:anne é owner de doc:readme. user:beto é member de group:eng, e group:eng#member é viewer de doc:readme. user:chen é viewer de folder:A, e folder:A é parent de doc:readme. O caminho de Chen por folder:A até o readme está destacado: é a seta parent->view.user:anneuser:betouser:chengroup:engfolder:Adoc:readmeownermemberviewer(eng#member)viewerparent
Cada seta é um relacionamento armazenado. Anne chega a view por meio de edit (owner), Beto pelo grupo e Chen pela seta destacada parent->view.

Observe que nenhum relacionamento menciona view ou edit: ambos são permissões, calculadas a partir do schema no momento da verificação, assim como as regras de reescrita do artigo são calculadas em vez de armazenadas (§2.3.1).

Arquitetura

Como uma implantação do SpiceDB responde a uma verificação? A AuthZed descreve o SpiceDB como “fundamentally a gRPC service” (fundamentalmente um serviço gRPC) com um gateway HTTP opcional (publicação sobre a arquitetura, 2021-11-17). Um nó divide uma requisição em perguntas menores e as encaminha a outros nós, um processo que ele chama de dispatch; cada nó mantém “an in-memory cache of permissions queries it has resolved in the past” (um cache em memória das consultas de permissão que resolveu no passado) (documentação de desempenho). Um hash consistente envia “the same (sub-)requests to the same server” (as mesmas (sub)requisições ao mesmo servidor) (publicação sobre a arquitetura). Todos os nós compartilham um único repositório de dados. O Materialize, se usado, pré-computa permissões escolhidas, e o SpiceDB “can dispatch sub-queries to Materialize” (pode despachar subconsultas ao Materialize) (documentação de desempenho).

Arquitetura do SpiceDBUm cliente da aplicação envia CheckPermission a um de três nós do SpiceDB. Os nós despacham sub-requisições entre si, roteadas por hashing consistente. Os três nós leem e escrevem em um único repositório de dados compartilhado (CockroachDB, Spanner, PostgreSQL ou MySQL). Um consumidor de Watch recebe de um nó do SpiceDB um stream de alterações. O AuthZed Materialize, um serviço comercial, observa o repositório de dados, lê snapshots periódicos dele e responde às subconsultas que o SpiceDB lhe despacha.Aplicação(cliente gRPC / HTTP)NóSpiceDBNóSpiceDBNóSpiceDBRepositório de dadosCockroachDB · SpannerPostgreSQL · MySQLConsumidorde WatchAuthZed Materialize(comercial)CheckPermissiondispatchdispatchleituras / escritasWatchalterações, snapshotssubconsultas
Amarelo: servidores. Verde: o repositório de dados compartilhado. Azul: clientes. Tracejado: o caminho comercial opcional do Materialize.

Compare com a Figura 2 do artigo (§3): ali, os aclservers também distribuem trabalho a outros servidores do cluster, mas o armazenamento é sempre o Spanner, o Watch é servido por watchservers separados que acompanham um changelog, e o Leopard lê snapshots offline além do Watch. O SpiceDB não tem um tipo de servidor de watch separado na documentação citada aqui; Watch é um RPC do mesmo serviço.

Consistência: ZedTokens e zookies

A AuthZed chama o ZedToken de “the SpiceDB equivalent of Google Zanzibar’s Zookie concept which protects users from the New Enemy Problem” (o equivalente no SpiceDB do conceito de Zookie do Google Zanzibar, que protege os usuários do problema do novo inimigo) (documentação de consistência). As escritas retornam um (written_at), e as verificações também (checked_at). Uma requisição pode escolher um de quatro modos:

Modo O que pede Análogo no artigo
minimize_latency O que o servidor conseguir responder mais rápido Sem zookie: “a reasonably recent snapshot” (um snapshot razoavelmente recente) (§2.4.1)
at_least_as_fresh + ZedToken Um snapshot não mais antigo que o token Um zookie em uma verificação ou leitura (§2.2, §2.4)
at_exact_snapshot + ZedToken Exatamente o snapshot do token Um zookie de leitura reutilizado para obter “the same snapshot as a previous read” (o mesmo snapshot de uma leitura anterior) (§2.4.1)
fully_consistent Os dados mais recentes Nenhum análogo direto; a verificação de alteração de conteúdo do artigo é avaliada no snapshot mais recente (§2.4.4)

No CockroachDB, a documentação adverte que fully_consistent “does not guarantee read-after-write consistency” (não garante consistência de leitura após escrita), porque os relógios dos nós podem diferir em até o max_offset do cluster; ela recomenda, em vez disso, um ZedToken com at_least_as_fresh (documentação de consistência).

fully_consistent é o padrão para WriteRelationships, DeleteRelationships, ReadSchema e WriteSchema; minimize_latency é o padrão para todas as demais APIs (documentação de consistência).

Como um ZedToken impede que Chen, removido da pasta A antes da edição, veja o readme editado?

Usando um ZedToken como um zookieA aplicação remove o acesso de visualização de Chen à pasta A com WriteRelationships. O SpiceDB confirma a escrita e retorna um ZedToken Z1 como written_at. A aplicação salva o novo conteúdo do readme junto com Z1. Mais tarde, uma verificação de Chen sobre o readme é enviada com at_least_as_fresh Z1. O SpiceDB a avalia em um snapshot não mais antigo que Z1, de modo que a remoção é vista e o acesso de Chen é negado.tempoAplicaçãoSpiceDBBanco da aplicaçãoWriteRelationshipswritten_at = Z1at_least_as_fresh Z1remove Chen de Aconfirmaguarda Z1salva readme + Z1conteúdo, Z1Chen pode ver?snapshot ≥ Z1negado
O token viaja com o conteúdo, como faz o zookie do artigo (§2.2). Sem ele, uma verificação minimize_latency poderia ser respondida a partir de um cache anterior à remoção.

No artigo, o zookie armazenado com o conteúdo vem de uma verificação de alteração de conteúdo (§2.2, §2.4.4). A documentação do SpiceDB diz que, quando um recurso muda, “a new ZedToken is either returned or it should be requested by performing a check with full consistency” (um novo ZedToken é retornado ou deve ser solicitado por meio de uma verificação com consistência total) (documentação de consistência), de modo que ambos os caminhos existem.

O Watch também usa ZedTokens: uma requisição pode começar a partir de optional_start_cursor, e cada resposta traz changes_through para retomar a partir dali, o que corresponde ao heartbeat zookie do artigo (§2.4.3) (watch_service.proto).

Diferenças em relação ao artigo

  • Armazenamento. O artigo armazena tudo no Spanner (§3.1). O SpiceDB tem repositórios de dados intercambiáveis: CockroachDB (“high throughput and/or multi-region”, alta vazão e/ou múltiplas regiões), Cloud Spanner, PostgreSQL (“single-region”, região única), MySQL (“Not recommended”, não recomendado) e memdb (desenvolvimento local e testes) (repositórios de dados).
  • Relações e permissões são separadas. O artigo associa uma reescrita de userset a uma relação (§2.3.1). O SpiceDB separa as relations armazenadas das permissions calculadas (schema).
  • Caveats. Relacionamentos podem carregar uma expressão CEL nomeada, associada no schema com with (por exemplo, relation viewer: user | user with ip_allowlist) (caveats). A tupla do artigo (§2.1) não tem esse campo.
  • Curingas. relation viewer: user | user:* permite uma concessão pública (schema). A gramática de tuplas do artigo tem um ID de usuário ou um userset (§2.1), sem curinga.
  • Seta de interseção. .all() exige que todo objeto relacionado conceda a permissão (schema). As três folhas de reescrita do artigo (§2.3.1) não têm essa forma.
  • Defasagem padrão. O artigo escolhe a defasagem padrão de forma adaptativa, a partir de estatísticas de leituras fora da zona (§3.2.1), e, separadamente, arredonda os timestamps de avaliação para cima “to a coarse granularity, such as one or ten seconds” (para uma granularidade grossa, como um ou dez segundos), de modo que as entradas de cache sejam compartilhadas (§3.2.5). O SpiceDB tem apenas o arredondamento: ele agrupa as revisões das requisições em janelas definidas por --datastore-revision-quantization-interval para que as entradas de cache possam ser reutilizadas; a AuthZed informa que “the default is 5s” (o padrão é 5 s) (publicação sobre cache de pontos quentes, 2023-05-10), o que corresponde a RevisionQuantization: 5 * time.Second no código-fonte.
  • APIs de consulta. LookupResources e LookupSubjects respondem a perguntas do tipo “quais recursos” e “quais sujeitos” (permission_service.proto). A API do artigo tem Read, Write, Watch, Check e Expand (§2.4).
  • Leopard. “AuthZed Materialize takes inspiration from the Leopard index component described in the Zanzibar paper” (o AuthZed Materialize se inspira no componente de índice Leopard descrito no artigo do Zanzibar) (documentação do Materialize). Ele faz parte da oferta paga da AuthZed, não do SpiceDB de código aberto: a documentação diz que seu recurso Accelerated Queries está “generally available to users of AuthZed Dedicated” (disponível de forma geral para usuários do AuthZed Dedicated).

Situação

Em 2026-11-13: ativo. Versão mais recente v1.57.1 em 2026-11-10, repositório não arquivado, cerca de 7,2 mil estrelas no GitHub, Apache-2.0 (repositório, versões).

A AuthZed também publica uma cópia anotada do artigo em zanzibar.tech (“Annotations © 2026 AuthZed, Inc. Zanzibar Paper © USENIX and original authors”).

Fontes