postkit 0.1.0

PostgreSQL-native authentication and authorization SDK

postkit

PostgreSQL-native authentication and authorization SDK.

Installation

pip install postkit

Usage

import psycopg
from postkit.authz import AuthzClient
from postkit.authn import AuthnClient

conn = psycopg.connect("postgresql://...")
cursor = conn.cursor()

# Authorization
authz = AuthzClient(cursor, namespace="my-app")
authz.grant("admin", resource=("repo", "api"), subject=("user", "alice"))
if authz.check("alice", "read", ("repo", "api")):
    print("Access granted")

# Authentication
authn = AuthnClient(cursor, namespace="my-app")
user_id = authn.create_user("[e-mail]", password_hash="argon2...")
session_id = authn.create_session(user_id, token_hash="sha256...")

Requirements

• PostgreSQL 14+
• The postkit SQL schema installed in your database

See the main repository for SQL installation instructions.