FastAPI and SAML Integration

FastAPI

pyenv activate fastapi_saml
poetry install

cp .env_sample .env # fill in
fastapi dev main.py # dev
python main.py # prod

Multiple user management with PIDs:

./run.sh # run `python main.py` with nohup and records PID
./stop.sh # uses recorded PID to stop `python main.py`
./restart.sh # stop.sh if we need to and then run.sh

SAML Workflow

Project layout

fastapi_saml/
├── main.py                # Entry point, app initialization
├── dependencies.py        # Shared dependencies (like require_auth)
├── config.py              # Configuration (SAML_SETTINGS, etc.)
├── routers/
│   ├── __init__.py
│   ├── saml.py            # All SAML routes
│   ├── protected.py       # Protected routes
│   └── public.py          # Public routes (if you have many)
└── utils/
    ├── __init__.py
    └── saml_helpers.py    # SAML helper functions