vienalatina/apps/board/tests/test_auth.py
Claude 6ac814475e
Add a members area: roles and an internal board
Everything on this site so far has been a file built from git. This is the
first component that runs code to answer a request and the first whose data
git does not hold, so the trade is stated in the README and the backup script
is not optional.

Roles are owner, admin and user. The owner is seeded once from BOARD_OWNER and
cannot be seeded again, because otherwise editing a compose file would be a
quieter way to take the top role than asking for it; ownership moves only by
transfer, inside the app. There is exactly one owner and a partial unique index
enforces it, so the invariant holds even when a handler is wrong. The owner is
beyond suspension and demotion by everyone, themselves included. Only the owner
makes admins; admins make users.

Sign-in goes through Gitea as a confidential OAuth client — the opposite of
Decap, which has to be public because it runs in the browser. The rule the
whole thing rests on is that a Gitea account is not a membership: entry needs
an active row in `members`, or every account on the instance is a member,
starting with the translations bot.

Admins can delete any post; nobody can edit anyone else's, admins included.
Taking a post down is visible to its author. Quietly rewriting it is not, and
an admin who could do that could leave a sentence attributed to someone who
never wrote it. The plan said admins could do both; this is the one place the
implementation departs from it.

Markdown renders with raw HTML disabled, which is the entire XSS defence and
the reason there is no sanitiser: the renderer emits only its own tags and
escapes the rest. The CSP carries no 'unsafe-inline', which makes an inline
onsubmit silently inert rather than broken, so the confirmation dialogs live in
a static file and a test fails any template that grows an inline handler.

GDPR is in scope rather than deferred: erasure removes the member row and moves
their authorship to a tombstone so the conversations around them still read,
and any member can download their own writing.

Verified: 63 checks pass, covering the membership gate, every role predicate, a
direct insert of a second owner being refused by the index, atomic ownership
transfer, CSRF, an offsite login redirect, script tags rendering as text, soft
deletes leaving both listings and exports, and the member screens rendering for
each role. Smoke-tested live: headers, both static assets, and the bare
/comunidad redirect that the Caddy matcher has to cover.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NizVpJ2dwzCbjCrTLCjeHn
2026-09-22 10:57:18 +00:00

105 lines
3.6 KiB
Python

"""Who gets in, and who does not."""
from __future__ import annotations
import pytest
from apps.board import gitea
PROTECTED = [
"/comunidad/",
"/comunidad/nuevo",
"/comunidad/miembros",
"/comunidad/miembros/nuevo",
"/comunidad/mis-datos",
]
@pytest.mark.parametrize("path", PROTECTED)
def test_anonymous_is_sent_to_login(client, path):
response = client.get(path)
assert response.status_code == 302
assert "/comunidad/login" in response.headers["Location"]
def _stub_gitea(monkeypatch, login):
monkeypatch.setattr(gitea, "exchange_code", lambda code, uri: "token")
monkeypatch.setattr(gitea, "fetch_user", lambda token: {
"login": login, "full_name": login.title(), "email": f"{login}@example.com",
})
def _callback(client, monkeypatch, login):
_stub_gitea(monkeypatch, login)
with client.session_transaction() as session:
session["oauth_state"] = "state123"
return client.get("/comunidad/auth/callback?code=abc&state=state123")
def test_a_gitea_account_is_not_a_membership(client, monkeypatch):
"""The single most important rule in the app: Gitea says who you are, the
members table says whether you belong. The translations bot has a perfectly
valid Gitea account and must not get in."""
response = _callback(client, monkeypatch, "vienalatina-translations")
assert response.status_code == 302
with client.session_transaction() as session:
assert "member_id" not in session
def test_member_signs_in(client, monkeypatch, make_member):
make_member("maria")
response = _callback(client, monkeypatch, "maria")
assert response.status_code == 302
with client.session_transaction() as session:
assert "member_id" in session
def test_suspended_member_cannot_sign_in(client, monkeypatch, make_member):
make_member("expulsada", active=0)
_callback(client, monkeypatch, "expulsada")
with client.session_transaction() as session:
assert "member_id" not in session
def test_suspension_takes_effect_on_the_next_request(client, db, make_member, sign_in):
"""The role is read per request, not cached in the cookie, so revoking
access does not wait for a session to expire."""
member_id = make_member("temporal")
sign_in(member_id)
assert client.get("/comunidad/").status_code == 200
db.execute("UPDATE members SET active = 0 WHERE id = ?", (member_id,))
assert client.get("/comunidad/").status_code == 302
def test_callback_rejects_a_mismatched_state(client, monkeypatch, make_member):
make_member("maria")
_stub_gitea(monkeypatch, "maria")
with client.session_transaction() as session:
session["oauth_state"] = "the-real-state"
client.get("/comunidad/auth/callback?code=abc&state=attacker-state")
with client.session_transaction() as session:
assert "member_id" not in session
def test_post_without_csrf_is_refused(client, make_member, sign_in):
sign_in(make_member("maria"))
response = client.post("/comunidad/nuevo", data={"title": "Hola", "body": "Texto"})
assert response.status_code == 400
def test_login_redirect_cannot_be_pointed_offsite(client, monkeypatch, make_member):
make_member("maria")
_stub_gitea(monkeypatch, "maria")
with client.session_transaction() as session:
session["oauth_state"] = "state123"
response = client.get(
"/comunidad/auth/callback?code=abc&state=state123&next=https://evil.example.com/"
)
assert "evil.example.com" not in response.headers["Location"]
def test_responses_say_do_not_index(client):
response = client.get("/comunidad/login")
assert response.headers["X-Robots-Tag"] == "noindex, nofollow"