Convert Figma logo to code with AI

authzed logospicedb

Open Source, Google Zanzibar-inspired permissions database to enable fine-grained authorization for customer applications

4,924
264
4,924
106

Top Related Projects

4,774

Open Source (Go) implementation of "Zanzibar: Google's Consistent, Global Authorization System". Ships gRPC, REST APIs, newSQL, and an easy and granular permission language. Supports ACL, RBAC, and other access models.

17,484

An authorization library that supports access control models like ACL, RBAC, ABAC in Golang: https://discord.gg/S5UjpzGZjN

9,505

Open Policy Agent (OPA) is an open source, general-purpose policy engine.

3,467

Oso is a batteries-included framework for building authorization in your application.

1,112

Warrant is a highly scalable, centralized authorization service based on Google Zanzibar. Use it to define, enforce, query, and audit application authorization and access control.

4,433

An open-source authorization as a service inspired by Google Zanzibar, designed to build and manage fine-grained and scalable authorization systems for any application.

Quick Overview

SpiceDB is an open-source, Google Zanzibar-inspired database system for managing application permissions. It provides a flexible, scalable, and performant solution for implementing fine-grained authorization in modern applications, allowing developers to define and enforce complex access control policies.

Pros

  • Implements the battle-tested Google Zanzibar model for authorization
  • Highly scalable and performant, suitable for large-scale applications
  • Provides a flexible schema language for defining relationships and permissions
  • Offers client libraries in multiple programming languages

Cons

  • Steep learning curve for developers unfamiliar with relationship-based authorization
  • Requires additional infrastructure setup compared to simpler authorization methods
  • May be overkill for small applications with simple permission requirements
  • Limited ecosystem and community support compared to more established solutions

Code Examples

  1. Defining a schema:
definition user {}

definition document {
    relation viewer: user
    relation editor: user
    relation owner: user

    permission view = viewer + editor + owner
    permission edit = editor + owner
    permission delete = owner
}
  1. Checking permissions:
allowed, err := client.CheckPermission(ctx, &v1.CheckPermissionRequest{
    Resource: &v1.ObjectReference{
        ObjectType: "document",
        ObjectId:   "doc1",
    },
    Permission: "view",
    Subject: &v1.SubjectReference{
        Object: &v1.ObjectReference{
            ObjectType: "user",
            ObjectId:   "user1",
        },
    },
})
  1. Writing relationships:
_, err := client.WriteRelationships(ctx, &v1.WriteRelationshipsRequest{
    Updates: []*v1.RelationshipUpdate{
        {
            Operation: v1.RelationshipUpdate_OPERATION_CREATE,
            Relationship: &v1.Relationship{
                Resource: &v1.ObjectReference{
                    ObjectType: "document",
                    ObjectId:   "doc1",
                },
                Relation: "viewer",
                Subject: &v1.SubjectReference{
                    Object: &v1.ObjectReference{
                        ObjectType: "user",
                        ObjectId:   "user1",
                    },
                },
            },
        },
    },
})

Getting Started

  1. Install SpiceDB:

    docker pull authzed/spicedb
    
  2. Run SpiceDB:

    docker run -p 50051:50051 authzed/spicedb serve --grpc-preshared-key "somerandomkey"
    
  3. Install a client library (e.g., Go):

    go get github.com/authzed/authzed-go
    
  4. Connect to SpiceDB and start using it in your application:

    import (
        "github.com/authzed/authzed-go/v1"
        "github.com/authzed/authzed-go/v1/client"
    )
    
    c, err := client.NewClient(
        "localhost:50051",
        client.WithInsecure(),
        client.WithPresharedKey("somerandomkey"),
    )
    

Competitor Comparisons

4,774

Open Source (Go) implementation of "Zanzibar: Google's Consistent, Global Authorization System". Ships gRPC, REST APIs, newSQL, and an easy and granular permission language. Supports ACL, RBAC, and other access models.

Pros of Keto

  • More extensive documentation and guides
  • Broader ecosystem integration with other Ory projects
  • Supports multiple storage backends (SQL, in-memory)

Cons of Keto

  • Less focus on performance optimization
  • More complex setup and configuration
  • Limited built-in support for fine-grained permissions

Code Comparison

SpiceDB uses a custom DSL for defining relationships:

definition user {}
definition document {
    relation viewer: user
    relation editor: user
    permission view = viewer + editor
}

Keto uses JSON for defining relationships:

{
  "namespace": "documents",
  "object": "file",
  "relation": "viewer",
  "subject": "user:john"
}

Both SpiceDB and Keto are open-source authorization systems designed to handle complex permission models. SpiceDB focuses on high performance and scalability, using a custom DSL for defining relationships. It's well-suited for large-scale applications with complex permission structures.

Keto, part of the Ory ecosystem, offers broader integration possibilities and more extensive documentation. It uses a JSON-based format for defining relationships and supports multiple storage backends, making it flexible for various deployment scenarios.

While SpiceDB excels in performance and fine-grained permissions, Keto provides a more accessible setup process and better integration with other identity and access management tools in the Ory suite.

17,484

An authorization library that supports access control models like ACL, RBAC, ABAC in Golang: https://discord.gg/S5UjpzGZjN

Pros of Casbin

  • More flexible and supports multiple access control models (ACL, RBAC, ABAC, etc.)
  • Extensive language support with official adapters for 15+ programming languages
  • Large and active community with frequent updates and contributions

Cons of Casbin

  • Steeper learning curve due to its flexibility and multiple model support
  • May require more configuration and setup for complex authorization scenarios
  • Performance can be impacted when dealing with large-scale authorization checks

Code Comparison

Casbin:

e := casbin.NewEnforcer("model.conf", "policy.csv")
sub := "alice"
obj := "data1"
act := "read"
if allowed := e.Enforce(sub, obj, act); allowed {
    // permit alice to read data1
}

SpiceDB:

client := spicedb.NewClient(...)
subject := zed.NewSubjectSet("user", "alice")
resource := zed.NewObjectSet("document", "data1")
permission := "read"
allowed, err := client.CheckPermission(ctx, subject, resource, permission)
if allowed {
    // permit alice to read data1
}

Both examples demonstrate basic permission checking, but Casbin's approach is more compact and relies on a configuration file, while SpiceDB uses a client-server model with a more verbose API.

9,505

Open Policy Agent (OPA) is an open source, general-purpose policy engine.

Pros of OPA

  • More flexible and general-purpose policy engine, suitable for a wide range of use cases beyond just authorization
  • Larger community and ecosystem, with extensive documentation and integrations
  • Declarative policy language (Rego) that's powerful and expressive

Cons of OPA

  • Steeper learning curve due to the complexity of Rego and its broad scope
  • Can be overkill for simpler authorization scenarios
  • Performance may be slower for large-scale authorization checks compared to SpiceDB

Code Comparison

SpiceDB uses a schema-based approach with relationship tuples:

definition user {}
definition document {
    relation viewer: user
    permission view = viewer
}

OPA uses Rego for policy definition:

package authz

default allow = false

allow {
    input.method == "GET"
    input.path == ["documents", doc_id]
    data.documents[doc_id].viewers[input.user]
}

Both systems offer powerful authorization capabilities, but SpiceDB is more focused on relationship-based access control, while OPA provides a more general-purpose policy engine that can be applied to various domains beyond authorization.

3,467

Oso is a batteries-included framework for building authorization in your application.

Pros of Oso

  • More flexible policy language (Polar) that supports complex rules and integrations
  • Easier to integrate with existing application code and data models
  • Provides libraries for multiple programming languages (Python, Ruby, Java, etc.)

Cons of Oso

  • Potentially slower performance for large-scale authorization checks
  • Less focus on distributed systems and high-throughput scenarios
  • Requires more custom implementation for advanced features like audit logging

Code Comparison

Oso (Polar language):

allow(user, "read", post) if
    user.role = "admin" or
    post.author = user;

SpiceDB (Relationship tuples):

user:alice#admin
post:123#author@user:bob
post:123#viewer@user:alice

Summary

Oso offers a more flexible and developer-friendly approach to authorization, making it easier to integrate with existing applications. SpiceDB, on the other hand, focuses on high-performance, scalable authorization for distributed systems. The choice between the two depends on specific project requirements, such as scalability needs, integration complexity, and the desired level of customization in authorization rules.

1,112

Warrant is a highly scalable, centralized authorization service based on Google Zanzibar. Use it to define, enforce, query, and audit application authorization and access control.

Pros of Warrant

  • Simpler setup and configuration process
  • Built-in user management and authentication features
  • Supports both API and SDK integration options

Cons of Warrant

  • Less mature project with fewer contributors
  • Limited documentation compared to SpiceDB
  • Fewer advanced features for complex authorization scenarios

Code Comparison

SpiceDB schema definition:

definition user {}

definition resource {
    relation viewer: user
    permission view = viewer
}

Warrant permission definition:

{
  "objectType": "resource",
  "relation": "viewer",
  "subject": {
    "objectType": "user",
    "objectId": "user123"
  }
}

Both projects aim to provide fine-grained authorization solutions, but they differ in their approach and feature set. SpiceDB focuses on a more flexible and powerful authorization model, while Warrant offers a simpler setup with built-in user management. SpiceDB uses a custom schema language for defining relationships, whereas Warrant uses JSON for permission definitions. SpiceDB may be better suited for complex, large-scale applications, while Warrant could be a good choice for smaller projects or those requiring quick integration of both authentication and authorization.

4,433

An open-source authorization as a service inspired by Google Zanzibar, designed to build and manage fine-grained and scalable authorization systems for any application.

Pros of Permify

  • More flexible schema definition with support for custom types and relations
  • Built-in support for multi-tenancy and data isolation
  • Easier integration with existing databases and data models

Cons of Permify

  • Less mature project with fewer production deployments
  • Smaller community and ecosystem compared to SpiceDB
  • Limited documentation and examples for advanced use cases

Code Comparison

Permify schema definition:

entity:
  user:
    relations:
      manager: user
  document:
    relations:
      owner: user
      viewer: user

SpiceDB schema definition:

definition user {}

definition document {
    relation viewer: user
    relation owner: user

    permission view = viewer + owner
    permission edit = owner
}

Both Permify and SpiceDB provide declarative ways to define authorization models, but Permify's schema is more flexible and allows for custom entity types. SpiceDB's schema is more concise and includes built-in permission definitions.

Permify offers a more adaptable approach for complex authorization scenarios, while SpiceDB provides a more opinionated and streamlined experience. The choice between the two depends on specific project requirements, existing infrastructure, and desired level of customization.

Convert Figma logo designs to code with AI

Visual Copilot

Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.

Try Visual Copilot

README

spicedb logo spicedb Logo

SpiceDB sets the standard for authorization that scales.

Scale with
Traffic • Dev Velocity • Functionality • Geography

release badge   docker pulls badge   built with Go badge   cii badge  

discord badge   twitter badge   linkedin badge

What is SpiceDB?

SpiceDB is a graph database purpose-built for storing and evaluating access control data.

As of 2021, broken access control became the #1 threat to the web. With SpiceDB, developers finally have the solution to stopping this threat the same way as the hyperscalers.

Why SpiceDB?

  • World-class engineering: painstakingly built by experts that pioneered the cloud-native ecosystem
  • Authentic design: mature and feature-complete implementation of Google's Zanzibar paper
  • Proven in production: 5ms p95 when scaled to millions of queries/s, billions of relationships
  • Global consistency: consistency configured per-request unlocks correctness while maintaining performance
  • Multi-paradigm: caveated relationships combine the best concepts in authorization: ABAC & ReBAC
  • Safety in tooling: designs schemas with real-time validation or validate in your CI/CD workflow
  • Reverse Indexes: queries for "What can subject do?", "Who can access resource?"

Joining the Community

SpiceDB is a community project where everyone is invited to participate and feel welcomed. While the project has a technical goal, participation is not restricted to those with code contributions.

Learn

Contribute

CONTRIBUTING.md documents communication, contribution flow, legal requirements, and common tasks when contributing to the project.

You can find issues by priority: Urgent, High, Medium, Low, Maybe. There are also good first issues.

Our documentation website is also open source if you'd like to clarify anything you find confusing.

Getting Started

Installing the binary

Binary releases are available for Linux, macOS, and Windows on AMD64 and ARM64 architectures.

Homebrew users for both macOS and Linux can install the latest binary releases of SpiceDB and zed using the official tap:

brew install authzed/tap/spicedb authzed/tap/zed

Debian-based Linux users can install SpiceDB packages by adding a new APT source:

sudo apt update && sudo apt install -y curl ca-certificates gpg
curl https://pkg.authzed.com/apt/gpg.key | sudo apt-key add -
sudo echo "deb https://pkg.authzed.com/apt/ * *" > /etc/apt/sources.list.d/fury.list
sudo apt update && sudo apt install -y spicedb zed

RPM-based Linux users can install SpiceDB packages by adding a new YUM repository:

sudo cat << EOF >> /etc/yum.repos.d/Authzed-Fury.repo
[authzed-fury]
name=AuthZed Fury Repository
baseurl=https://pkg.authzed.com/yum/
enabled=1
gpgcheck=0
EOF
sudo dnf install -y spicedb zed

Running a container

Container images are available for AMD64 and ARM64 architectures on the following registries:

Docker users can run the latest SpiceDB container with the following:

docker run --rm -p 50051:50051 authzed/spicedb serve --grpc-preshared-key "somerandomkeyhere"

SpiceDB containers use Chainguard Images to ship the bare minimum userspace which is a huge boon to security, but can complicate debugging. If you want to execute a user session into a running SpiceDB container and install packages, you can use one of our debug images.

Appending -debug to any tag will provide you an image that has a userspace with debug tooling:

docker run --rm -ti --entrypoint sh authzed/spicedb:latest-debug

Containers are also available for each git commit to the main branch under ${REGISTRY}/authzed/spicedb-git:${COMMIT}.

Deploying to Kubernetes

Production Kubernetes users should be relying on a stable release of the SpiceDB Operator. The Operator enforces not only best practices, but orchestrates SpiceDB updates without downtime.

If you're only experimenting, feel free to try out one of our community-maintained examples for testing SpiceDB on Kubernetes:

kubectl apply -f https://raw.githubusercontent.com/authzed/examples/main/kubernetes/example.yaml

Developing your own schema

You can try both SpiceDB and zed entirely in your browser in the hosted Playground thanks to the power of WebAssembly. The Playground app is open source and can also be self-hosted.

If you don't want to start with the examples loadable from the Playground, you can follow a guide for developing a schema or review the the schema language design documentation.

Watch the SpiceDB primer video to get started with schema development:

SpiceDB Primer YouTube Thumbnail

Trying out the API

For debugging or getting started, we recommend installing zed, the official command-line client. The Playground also has a tab for experimenting with zed all from within your browser.

When it's time to write code, we recommend using one of the existing client libraries whether it's official or community-maintained.

Because every millisecond counts, we recommend using libraries that leverage the gRPC API for production workloads.

To get an understanding of integrating an application with SpiceDB, you can follow the Protecting Your First App guide or review API documentation on the Buf Registry or Postman.

Acknowledgements

SpiceDB is a community project fueled by contributions from both organizations and individuals. We appreciate all contributions, large and small, and would like to thank all those involved.

In addition, we'd like to highlight a few notable contributions:

  • github logo The GitHub Authorization Team for implementing and contributing the MySQL datastore
  • netflix logo The Netflix Authorization Team for sponsoring and being a design partner for caveats
  • equinix logo The Equinix Metal Team for sponsoring our benchmarking hardware