Files
praxis/server/auth/routes.py
T
Praxis CI ec397f2c65 docs(milestone): complete v0.5-live-assist — v0.1.13 tagged, milestone release, merged to main
v0.5 (Live Assist — on-the-job voice companion) milestone complete.
4 phases: P0 (pre-execution, v0.1.10) → P1 (assist core + guardrail,
v0.1.11) → P2 (integration + tech-debt + NFR, v0.1.12) → P3 (final
review + ship, v0.1.13 = milestone release).

16/16 REQs covered (3 ASSIST + 4 NFR + 9 IDEATE). 4 v0.6 backlog.
469 tests passed, 0 failed. 1 P0 fixed (guardrail processor safety).
8 P1+ flagged for v0.6. 8 v0.4 P1+ tech-debt addressed.
G-049 + G-067 grill MUSTs resolved. ESCALATION-01 (PIPEDA) OPEN for
human legal review before assist surface go-live.

---ci---
project: praxis
phase: 3
milestone: v0.5
status: complete
requirements:
  covered: [REQ-ASSIST-01, REQ-ASSIST-02, REQ-ASSIST-03, REQ-NFR-ASSIST-01, REQ-NFR-ASSIST-02, REQ-NFR-ASSIST-03, REQ-NFR-ASSIST-04, REQ-IDEATE-01, REQ-IDEATE-02, REQ-IDEATE-03, REQ-IDEATE-04, REQ-IDEATE-05, REQ-IDEATE-06, REQ-IDEATE-07, REQ-IDEATE-08, REQ-IDEATE-09]
  partial: []
---/ci---
2026-08-04 22:35:56 +00:00

125 lines
4.1 KiB
Python

"""Auth route handlers — login, logout, me (TASK-03-05, D-041, D-056, D-057).
APIRouter(prefix="/api/operator") with:
POST /login — rate-limited 5/min (TASK-03-03), NOT auth-gated.
POST /logout — auth-gated (Depends(current_operator)).
GET /me — auth-gated (React route guard — D-057).
Stateless cookies (D-056): logout clears the server-side session; the
client also clears its cookie. No sessions table.
"""
from __future__ import annotations
import asyncio
from fastapi import APIRouter, Depends, HTTPException, Request, status
from pydantic import BaseModel
from server.auth.dependencies import current_operator
from server.auth.models import Operator
from server.auth.passwords import hash_password, needs_rehash, verify_password
from server.auth.rate_limit import rate_limit_login
router = APIRouter(prefix="/api/operator", tags=["operator-auth"])
class LoginBody(BaseModel):
username: str
password: str
class OperatorOut(BaseModel):
id: str
username: str
display_name: str | None
role: str = "operator"
class LoginResponse(BaseModel):
operator: OperatorOut
class MeResponse(BaseModel):
operator: OperatorOut
class OkResponse(BaseModel):
ok: bool = True
def _operator_out(op: Operator) -> OperatorOut:
return OperatorOut(
id=op.id,
username=op.username,
display_name=op.display_name,
role=op.role,
)
@router.post("/login", response_model=LoginResponse)
@rate_limit_login()
async def login(body: LoginBody, request: Request) -> LoginResponse:
"""Rate-limited login (5/min per IP — D-041).
On success: sets `request.session["operator_id"]` (signed cookie via
SessionMiddleware) + updates last_login_at. On needs_rehash → rehash +
update the store. On failure → 401 (no cookie set).
"""
pg_store = getattr(request.app.state, "pg_store", None)
if pg_store is None:
raise HTTPException(
status_code=status.HTTP_503_SERVICE_UNAVAILABLE,
detail="operator tier unavailable (no Postgres)",
)
row = await pg_store.get_operator_by_username(body.username)
if row is None or not row.get("is_active"):
raise HTTPException(
status_code=status.HTTP_401_UNAUTHORIZED,
detail="invalid credentials",
)
# TASK-12-04 (P1+ #1): offload argon2id verification to a thread so the
# ~100-300ms hashing duration does not block the event loop. R-AUTH-02:
# acceptable for single-operator pilot, but offloading is low-effort +
# correct for any future multi-operator load.
if not await asyncio.to_thread(verify_password, row["password_hash"], body.password):
raise HTTPException(
status_code=status.HTTP_401_UNAUTHORIZED,
detail="invalid credentials",
)
op_id = str(row["id"])
request.session["operator_id"] = op_id
await pg_store.update_last_login(op_id)
if needs_rehash(row["password_hash"]):
# Offload the rehash too (same ~100-300ms blocking concern).
new_hash = await asyncio.to_thread(hash_password, body.password)
async with pg_store.pool.acquire() as conn:
await conn.execute(
"UPDATE operators SET password_hash = $1 WHERE id = $2",
new_hash, op_id,
)
return LoginResponse(
operator=OperatorOut(
id=op_id,
username=row["username"],
display_name=row.get("display_name"),
role=row.get("role", "operator"),
)
)
@router.post("/logout", response_model=OkResponse)
async def logout(request: Request, op: Operator = Depends(current_operator)) -> OkResponse:
# Stateless (D-056): clearing the server session invalidates the signed
# cookie's payload; the client also clears its cookie.
request.session.clear()
return OkResponse(ok=True)
@router.get("/me", response_model=MeResponse)
async def me(op: Operator = Depends(current_operator)) -> MeResponse:
"""React route guard endpoint (D-057). 200 → render; 401 → redirect."""
return MeResponse(operator=_operator_out(op))
__all__ = ["router"]