Files
aurum/backend/tests/test_cors.py
technosexual b045d378f0 fix(security): stop granting every origin credentialed access to the API (#5)
`AURUM_CORS_ORIGINS` defaults to `*`, and the middleware was configured with
`allow_credentials=True`. Starlette does not answer that combination with a
literal `*` — it echoes back whatever `Origin` the caller sent and adds
`Access-Control-Allow-Credentials: true`, so any page open in the same
browser can call the instance, with the user's Basic Auth attached, and read
the response:

    GET /api/accounts   Origin: https://evil.example
    -> Access-Control-Allow-Origin: https://evil.example
       Access-Control-Allow-Credentials: true

That undercuts the README's advice that leaving Basic Auth off is fine while
the instance is only reachable from localhost: reachable-from-localhost
includes every website the user visits.

Nothing in the shipped setup is cross-origin. Compose serves the UI and the
API from the same nginx, and the Vite dev server proxies `/api`
(frontend/vite.config.ts), so neither deployment nor development needs CORS
at all. The default is therefore empty — no cross-origin access — and the
middleware is only installed when origins are configured deliberately.

An explicit `*` is still honoured for a genuinely public read-only setup, but
never together with credentials, which is what the spec intends `*` to mean
anyway.
2026-08-30 18:11:09 +03:00

38 lines
1.5 KiB
Python

"""CORS defaults.
The README tells self-hosters that leaving basic auth off is fine as long as
the instance is only reachable from localhost. That promise only holds if a
random page open in the same browser can't call the API on their behalf —
which is what these tests pin down.
"""
from httpx import AsyncClient
from app.core.config import Settings
EVIL = "https://evil.example"
async def test_a_foreign_origin_is_never_echoed_back(client: AsyncClient):
"""Starlette answers a credentialed wildcard by echoing whatever Origin
asked, which is what makes the wildcard dangerous rather than merely
permissive — the answer must be `*` or nothing, never the caller's own
origin."""
resp = await client.get("/accounts", headers={"Origin": EVIL})
assert resp.headers.get("access-control-allow-origin") != EVIL
async def test_credentials_are_not_granted_to_every_origin(client: AsyncClient):
"""With allow-credentials, a page the user visits can call the instance
with their Basic Auth attached and read the response."""
resp = await client.get("/accounts", headers={"Origin": EVIL})
assert resp.headers.get("access-control-allow-credentials") != "true"
def test_shipped_default_allows_no_cross_origin_access():
"""Nothing in the shipped setup needs CORS: compose serves UI and API
from one origin, and the Vite dev server proxies /api. So the default
should be closed, not `*`."""
assert Settings.model_fields["cors_origins"].default == ""