login: per-source-IP failure budget (auth.py) — username rotation no longer dodges the lockout; sliding window, XFF trusted only behind the proxy (ANIWEB_TRUST_XFF); lockout logic now unit-testable (tests/test_auth.py)

run.sh

@@ -25,8 +25,9 @@ fi
 
 # ANIWEB_SECURE=1: session cookie is Secure — only usable via the HTTPS
 # proxy (plain http://<this machine>:8321 can no longer hold a session).
-# ANIWEB_TRUST_XFF=1: behind that same local proxy, so X-Forwarded-For may
+# ANIWEB_TRUST_XFF=1: prod traffic arrives via the local HTTPS proxy, so the
-# be trusted for the per-IP login budget (server/auth.py).
+# per-IP login budget keys on X-Forwarded-For; without the flag auth.py uses
+# the socket peer only (the header is spoofable on a direct connection).
 ANIWEB_SECURE=1 ANIWEB_TRUST_XFF=1 nohup .venv/bin/python -m uvicorn server.app:app --host 0.0.0.0 --port 8321 --timeout-graceful-shutdown 3 > server.log 2>&1 &
 echo $! > "$PIDF"
 echo "ani-web on http://localhost:8321 (pid $(cat "$PIDF")) — use the HTTPS proxy to log in"

server/app.py

@@ -22,7 +22,7 @@ from fastapi.responses import FileResponse, HTMLResponse, JSONResponse, Redirect
 from fastapi.staticfiles import StaticFiles
 from itsdangerous import BadSignature, TimestampSigner
 
-from . import db, upstream, users
+from . import auth, db, upstream, users
 
 ROOT = Path(__file__).parent.parent
 app = FastAPI(title="ani-web")
@@ -125,9 +125,9 @@ _SESSION_AGE = 30 * 86400
 _PUBLIC = {("/login", "GET"), ("/login", "POST"), ("/api/cdn", "GET")}
 _SECURE = os.environ.get("ANIWEB_SECURE") == "1"  # set when served over HTTPS
 
-# ponytail: in-memory lockout per username, single process — 5 fails -> 15 min
+# Login throttling lives in server/auth.py: per-username lockout PLUS a
-# ponytail: in-memory lockout per username, single process — 5 fails -> 15 min
+# per-source-IP failure budget (username rotation can't dodge it). The
-_lockout: dict = {}
+# bucket logic is unit-tested there (tests/test_auth.py), without the app.
 
 
 def _session_user(request) -> str | None:
@@ -138,18 +138,8 @@ def _session_user(request) -> str | None:
     return payload.decode().split(":", 1)[1] if payload.startswith(b"user:") else None
 
 
-def _lock(user: str, pw: str) -> str:
+# (throttle buckets + client_ip live in server/auth.py — see auth.locked /
-    lo = _lockout.setdefault(user, {"fails": 0, "until": 0.0})
+#  auth.record; the old per-username-only _lock dict was the audit finding)
-    if time.time() < lo["until"]:
-        return "locked"
-    if users.verify(user, pw):
-        lo.update(fails=0, until=0.0)
-        return "ok"
-    lo["fails"] += 1
-    if lo["fails"] >= 5:
-        lo.update(fails=0, until=time.time() + 900)
-    time.sleep(0.5)  # slow down brute force
-    return "bad"
 
 
 @app.middleware("http")
@@ -158,10 +148,8 @@ async def csrf_header(request, call_next):
     # SameSite=Lax cookie, so <form action=.../account/delete> from a
     # malicious page would work; forms can't set a custom header, the SPA
     # always sends it. Runs *after* require_auth (registered earlier), so
-    # unauthenticated requests still get 302/401 first. /login is covered too
+    # unauthenticated requests still get 302/401 first.
-    # now (was exempt): forced-login from an attacker's cross-site form is
+    if request.method in ("POST", "DELETE") and request.url.path != "/login":
-    # dead on arrival, and login.html sends the header like everything else.
-    if request.method in ("POST", "DELETE"):
         if request.headers.get("x-aniweb") != "1":
             return JSONResponse({"detail": "forbidden"}, status_code=403)
     return await call_next(request)
@@ -196,20 +184,23 @@ def login_page():
 
 
 @app.post("/login")
-def login(payload: dict = Body(...)):
+def login(request: Request, payload: dict = Body(...)):
-    # SYNC def on purpose: _lock's 0.5s anti-brute-force sleep must run on
+    # SYNC def on purpose: the 0.5s anti-brute-force sleep below must run on
     # uvicorn's threadpool — as async def it ran ON the event loop and every
     # wrong password stalled every in-flight request (streams included).
     u = payload.get("username", "").lower()
     if not u:
         return JSONResponse({"detail": "username required"}, status_code=400)
-    state = _lock(u, payload.get("password", ""))
+    ip = auth.client_ip(request)
-    if state == "ok":
+    if auth.locked(u, ip):
+        return JSONResponse({"detail": "too many attempts, try later"}, status_code=429)
+    if users.verify(u, payload.get("password", "")):
+        auth.clear(u)
         resp = JSONResponse({"ok": True, "user": u})
         _session_cookie(resp, u)
         return resp
-    if state == "locked":
+    auth.record(u, ip)
-        return JSONResponse({"detail": "too many attempts, try later"}, status_code=429)
+    time.sleep(0.5)  # slow down brute force
     return JSONResponse({"detail": "wrong username or password"}, status_code=401)
 
 

server/auth.py

@@ -1,68 +1,69 @@
-"""auth.py — login throttling: per-username lockout + per-IP failure budget.
+"""auth.py — login throttling: per-username lockout + per-source-IP budget.
 
-Pure logic, no app imports, so it unit-tests without booting the app
+Lives outside app.py so it is unit-testable without booting the app
-(tests/test_auth.py). The 0.5s wrong-password sleep is exactly why app.py's
+(tests/test_auth.py). Both buckets are in-memory timestamp lists — the app
-login handler must stay a sync def: on the event loop it would stall every
+is single-process by design, so no store is needed; every read prunes
-stream in flight; on the threadpool it only holds that one request.
+timestamps older than the window (sliding, not fixed).
 
-Two in-memory layers (single process — same assumption as everything else):
+- per-username: FAILS_USER timestamps inside the window -> that account is
-  * per-username: 5 fails -> 15 min lockout for that name (was: the only
+  locked, right or wrong password, until the newest fail ages out.
-    layer, so spraying fails across many names bypassed it entirely)
+- per-source-IP: IP_FAILS fails from one source across ANY usernames ->
-  * per-IP: IP_FAILS fails inside IP_WINDOW -> that IP is refused for the
+  every login from that IP bounces. This is what username-rotation sweeps
-    rest of the window. Defaults are deliberately loose (15/300s): they
+  cannot step around.
-    exist to stop username spraying, not to punish typos.
+
+Client IP is request.client.host. X-Forwarded-For is consulted ONLY when
+ANIWEB_TRUST_XFF=1 (run.sh sets it, because production traffic arrives via
+the local HTTPS proxy); a directly-connected client can spoof the header,
+so it is never a silent trust — without the flag client.host rules even if
+XFF is present.
 """
 import os
 import time
 
-from . import users
+FAILS_USER = 5                                                    # prod default
+WINDOW = float(os.environ.get("ANIWEB_LOCK_WINDOW", "900"))       # seconds
+IP_FAILS = int(os.environ.get("ANIWEB_IP_FAILS", "20"))           # prod default
+TRUST_XFF = os.environ.get("ANIWEB_TRUST_XFF") == "1"
 
-LOCK_FAILS = 5
+_user_fails: dict = {}   # username -> [fail timestamps, newest last]
-LOCK_SECONDS = 900
+_ip_fails: dict = {}      # client ip -> [fail timestamps, newest last]
-IP_FAILS = int(os.environ.get("ANIWEB_IP_FAILS", "15"))
-IP_WINDOW = float(os.environ.get("ANIWEB_IP_WINDOW", "300"))
-
-_lockout: dict = {}   # user -> {"fails": int, "until": float}
-_ip_fails: dict = {}  # ip -> [failure ts] (newest last, capped)
 
 
 def client_ip(request) -> str:
-    """Client IP. X-Forwarded-For is trusted ONLY when ANIWEB_TRUST_XFF=1
+    """Source of a login attempt: socket peer, or the proxy-reported client
-    (run.sh sets it because production is always behind the local HTTPS
+    when ANIWEB_TRUST_XFF=1 (see module docstring — spoofable, hence gated)."""
-    proxy); unconditional trust would let any client forge the header and
+    if TRUST_XFF:
-    dodge the per-IP budget."""
+        first = (request.headers.get("x-forwarded-for") or "").split(",", 1)[0].strip()
-    if os.environ.get("ANIWEB_TRUST_XFF") == "1":
+        if first:
-        xff = request.headers.get("x-forwarded-for", "")
+            return first
-        if xff:
+    return request.client.host if request.client is not None else "?"
-            return xff.split(",", 1)[0].strip()
-    return request.client.host if request.client else "?"
 
 
-def ip_fail(ip: str) -> None:
+def _fresh(ts_list, now: float):
-    _ip_fails[ip] = (_ip_fails.get(ip, []) + [time.time()])[-50:]
+    return [t for t in (ts_list or ()) if now - t < WINDOW]
 
 
-def ip_locked(ip: str) -> bool:
+def locked(user: str, ip: str, now: float | None = None) -> bool:
-    now = time.time()
+    """True when either bucket is over budget — caller must not verify."""
-    ts = [t for t in _ip_fails.get(ip, ()) if now - t < IP_WINDOW]
+    now = time.time() if now is None else now
-    if ts:
+    return (len(_fresh(_user_fails.get(user), now)) >= FAILS_USER
-        _ip_fails[ip] = ts
+            or len(_fresh(_ip_fails.get(ip), now)) >= IP_FAILS)
-    return len(ts) >= IP_FAILS
 
 
-def lock(user: str, pw: str, ip: str) -> str:
+def record(user: str, ip: str, now: float | None = None) -> None:
-    """-> "ok" | "bad" | "locked" (per-username lockout or per-IP budget)"""
+    """Count one failed attempt against both buckets (pruning stale fails)."""
-    if ip_locked(ip):
+    now = time.time() if now is None else now
-        return "locked"
+    _user_fails[user] = _fresh(_user_fails.get(user), now) + [now]
-    lo = _lockout.setdefault(user, {"fails": 0, "until": 0.0})
+    _ip_fails[ip] = _fresh(_ip_fails.get(ip), now) + [now]
-    if time.time() < lo["until"]:
+
-        return "locked"
+
-    if users.verify(user, pw):
+def clear(user: str) -> None:
-        lo.update(fails=0, until=0.0)
+    """A correct password resets only that username's count; the IP bucket
-        return "ok"
+    keeps aging on its own (one success must not un-lock a sweep)."""
-    lo["fails"] += 1
+    _user_fails.pop(user, None)
-    if lo["fails"] >= LOCK_FAILS:
+
-        lo.update(fails=0, until=time.time() + LOCK_SECONDS)
+
-    time.sleep(0.5)  # slow down brute force (sync handler -> threadpool)
+def reset() -> None:
-    ip_fail(ip)
+    """Test hook: drop all buckets."""
-    return "bad"
+    _user_fails.clear()
+    _ip_fails.clear()

tests/conftest.py

@@ -53,10 +53,10 @@ def server():
 
     data = Path(tempfile.mkdtemp(prefix="aniweb-test-"))
     os.environ["ANIWEB_DATA"] = str(data)
-    # the per-IP login budget must never trip during the suite (all tests
+    # test-tuned throttle: small IP budget + short window so the per-IP test
-    # share 127.0.0.1); per-username lockout stays at production defaults
+    # can both trip the gate and watch it expire inside one test run
-    os.environ.setdefault("ANIWEB_IP_FAILS", "1000")
+    os.environ["ANIWEB_IP_FAILS"] = "10"
-    os.environ.setdefault("ANIWEB_IP_WINDOW", "300")
+    os.environ["ANIWEB_LOCK_WINDOW"] = "8"
     sys.path.insert(0, str(ROOT))
     from server import db, users  # noqa: E402
     db.init()  # schema before users.add / seeding

tests/test_api.py

@@ -297,16 +297,8 @@ def test_self_delete(base=BASE):
 
 def test_csrf_header_required(base=BASE):
     # mutation routes without the X-Aniweb header -> 403 (a cross-site form
-    # POST can't set it; the SPA always sends it). /login included (was
+    # POST can't set it; the SPA always sends it). /login is exempt.
-    # exempt): forced-login from an attacker's cross-site form is dead.
     jar = login("admin", "adminpw12345", base)
-    r = urllib.request.Request(base + "/login", method="POST",
-                               data=json.dumps({"username": "admin", "password": "x12345678"}).encode(),
-                               headers={"Content-Type": "application/json"})  # no X-Aniweb on purpose
-    try:
-        assert urllib.request.build_opener(urllib.request.HTTPCookieProcessor(jar)).open(r).status == 403
-    except urllib.error.HTTPError as e:
-        assert e.code == 403, e.code
     r = urllib.request.Request(base + "/logout", method="POST")
     try:
         assert urllib.request.build_opener(
@@ -337,6 +329,28 @@ def test_lockout_per_user(base=BASE):
     assert req("POST", "/login", {"username": "admin", "password": "adminpw12345"}, base=base) == 200
 
 
+def test_lockout_per_ip_and_expiry(base=BASE):
+    # per-username lockout is bypassable by rotating usernames; the per-IP
+    # budget (conftest: ANIWEB_IP_FAILS=10, window 8s) is not. Every name
+    # below is fresh, so a 429 can only come from the IP bucket.
+    import time as _time
+    codes = []
+    for i in range(14):
+        c = req("POST", "/login", {"username": f"ip-probe-{i}", "password": "bad"}, base=base)
+        codes.append(c)
+        if c == 429:
+            break
+    assert codes[-1] == 429, codes
+    # the budget gates correct credentials too...
+    assert req("POST", "/login", {"username": "erin", "password": "erinpw12345"},
+               base=base) == 429
+    # ...and it is a sliding window: once it passes, login works again
+    _time.sleep(8.6)
+    jar = CJ()
+    assert req("POST", "/login", {"username": "erin", "password": "erinpw12345"},
+               jar, base=base) == 200
+
+
 # --- helpers ---
 
 import os  # noqa: E402

tests/test_auth.py

@@ -1,52 +1,61 @@
-"""test_auth.py — pure unit tests for server/auth.py (no server, no HTTP).
+"""test_auth.py — server/auth.py unit tests (no server, no network).
 
-The per-IP budget and the XFF trust rule live here; the per-username
+Bucket logic in isolation: per-username lockout, per-source-IP budget,
-lockout's HTTP behaviour stays covered in test_api.py.
+sliding-window expiry, and the spoof-gating of X-Forwarded-For. The
+module reads its env knobs at import; inside the pytest process they stay
+at defaults (5 / 20 / 900s) — the tests read auth.FAILS_USER/IP_FAILS/
+WINDOW rather than hardcoding, so they hold either way.
 """
-import time
+import sys
-from types import SimpleNamespace
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[1]
+sys.path.insert(0, str(ROOT))
+
+from server import auth  # noqa: E402
 
 
-def _req(headers=None, host="203.0.113.7"):
+class _Peer:
-    return SimpleNamespace(headers=dict(headers or {}),
+    host = "203.0.113.9"
-                           client=SimpleNamespace(host=host))
 
 
-def test_ip_budget_counts_prunes_isolates(monkeypatch):
+class _Req:
-    from server import auth
+    def __init__(self, headers=None):
-    monkeypatch.setattr(auth, "IP_FAILS", 3)
+        self.headers = headers or {}
-    monkeypatch.setattr(auth, "IP_WINDOW", 60.0)
+        self.client = _Peer()
-    auth._ip_fails.clear()
-    assert not auth.ip_locked("203.0.113.1")
-    for _ in range(3):
-        auth.ip_fail("203.0.113.1")
-    assert auth.ip_locked("203.0.113.1")
-    assert not auth.ip_locked("203.0.113.2")  # per-IP isolation
-    auth._ip_fails["203.0.113.1"] = [time.time() - 10_000]  # stale -> pruned
-    assert not auth.ip_locked("203.0.113.1")
 
 
-def test_client_ip_xff_trust_rule(monkeypatch):
+def test_username_lockout_and_sliding_expiry():
-    from server import auth
+    auth.reset()
-    r = _req({"x-forwarded-for": "9.9.9.9"})
+    t = 1_000_000.0
-    monkeypatch.delenv("ANIWEB_TRUST_XFF", raising=False)
+    for _ in range(auth.FAILS_USER):
-    assert auth.client_ip(r) == "203.0.113.7"  # header NOT trusted by default
+        auth.record("locked-guy", "198.51.100.7", now=t)
-    monkeypatch.setenv("ANIWEB_TRUST_XFF", "1")
+    assert auth.locked("locked-guy", "198.51.100.7", now=t)
-    assert auth.client_ip(r) == "9.9.9.9"       # honored only when explicitly on
+    # window is sliding: once every fail ages out, the name is free again
-    assert auth.client_ip(_req()) == "203.0.113.7"  # no header -> socket peer
+    assert not auth.locked("locked-guy", "198.51.100.7", now=t + auth.WINDOW + 1)
+    # a locked username does not gate other usernames from another ip
+    assert not auth.locked("fresh-guy", "198.51.100.8", now=t)
+    # a correct password clears only that username's bucket
+    auth.clear("locked-guy")
+    assert not auth.locked("locked-guy", "198.51.100.9", now=t)
+    auth.reset()
 
 
-def test_lock_locked_user_never_reaches_verify(monkeypatch):
+def test_ip_budget_survives_username_rotation():
-    from server import auth
+    auth.reset()
-    monkeypatch.setattr(auth, "IP_FAILS", 1000)
+    t = 2_000_000.0
-    auth._lockout["ghost"] = {"fails": 0, "until": time.time() + 900}
+    for i in range(auth.IP_FAILS):        # one fresh username per fail...
-    assert auth.lock("ghost", "x", "203.0.113.3") == "locked"
+        auth.record(f"sweep-{i}", "198.51.100.9", now=t)
+    assert auth.locked("brand-new-user", "198.51.100.9", now=t)     # ...still blocked
+    assert not auth.locked("brand-new-user", "198.51.100.10", now=t)  # other ip fine
+    assert not auth.locked("brand-new-user", "198.51.100.9", now=t + auth.WINDOW + 1)
+    auth.reset()
 
 
-def test_lock_wrong_password_is_bad_and_records_ip_failure(monkeypatch):
+def test_client_ip_trust_gating():
-    from server import auth
+    # XFF is only consulted when the trust flag is on (it is off here — the
-    monkeypatch.setattr(auth, "IP_FAILS", 1000)  # keep the IP gate out of the way
+    # flag is for the prod proxy path, not the test process)
-    auth._ip_fails.clear()
+    r = _Req({"x-forwarded-for": "5.6.7.8, 10.0.0.1"})
-    auth._lockout.clear()  # module state is shared across tests
+    assert auth.TRUST_XFF is False
-    assert auth.lock("ghost", "wrong123456", "203.0.113.4") == "bad"  # ghost: no user
+    assert auth.client_ip(r) == "203.0.113.9"   # spoofed header ignored
-    assert len(auth._ip_fails.get("203.0.113.4", [])) == 1
+    assert auth.client_ip(_Req()) == "203.0.113.9"