DEV MESSAGE: Fastbase is currently still in development and in its current state is unfit for production. Check back again for updates.
Role-based Access Contral (RBAC) via Firebase idtoken
authententication using FastAPI and SQLModel.
Documentation: https://enchance.github.io/fastbase/class/fastbase/
pip install fastbase
or
poetry add fastbase
Fastbase assumes a headless setup using a frontend such as React, Angular, etc.
- API Endpoints: Managed by FastAPI
- Authentication: Managed by Firebase Auth
- Authorization: Managed by Fastbase
- Database ORM: SQLModel
- Authentication happens in the frontend (JS) using the official Firebase JS package. An
idtoken
will be generated if successful. - Insert this token in your
Authorization
header (Bearer <idtoken>
) when hitting restricted APIs. - Upon reaching the server the
idtoken
is verified.
To follow
To follow
Your required User
model. Optional models include TaxonomyMod
and OptionMod
which should be extended if you want
to use them. Add any additional fields you need.
from fastbase.models import UserMod, TaxonomyMod, OptionMod
# Required
class User(UserMod, table=True):
__tablename__ = 'auth_user'
# Add any fields and methods you need
# Optional
class Taxonomy(TaxonomyMod, table=True):
__tablename__ = 'app_taxonomy'
# Add any fields and methods you need
# Optional
class Option(OptionMod, table=True):
__tablename__ = 'app_option'
# Add any fields and methods you need
Initialize Fastbase
from sqlalchemy.ext.asyncio import create_async_engine
from fastapi import FastAPI
from fastbase import Fastbase
from contextlib import asynccontextmanager
from .models import User
# .env file
DATABASE_URL = 'postgresql+asyncpg:https://user:password@localhost:5432/dbname'
# DB engine
engine = create_async_engine(DATABASE_URL, echo=True, pool_size=10)
@asynccontextmanager
async def lifespan(_: FastAPI):
"""Insert in lifespan events on start: https://fastapi.tiangolo.com/advanced/events/"""
fbase = Fastbase()
fbase.initialize(engine=engine, user_model=User)
print('RUNNING')
yield
print('STOPPED')