aboutsummaryrefslogtreecommitdiff
path: root/webmentions_ssg/views
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--webmentions_ssg/views.py454
-rw-r--r--webmentions_ssg/views/__init__.py16
-rw-r--r--webmentions_ssg/views/admin.py217
-rw-r--r--webmentions_ssg/views/endpoint.py150
-rw-r--r--webmentions_ssg/views/session.py93
5 files changed, 476 insertions, 454 deletions
diff --git a/webmentions_ssg/views.py b/webmentions_ssg/views.py
deleted file mode 100644
index 5b563f0..0000000
--- a/webmentions_ssg/views.py
+++ /dev/null
@@ -1,454 +0,0 @@
-# SPDX-FileCopyrightText: 2026 Dennis Fink <me+coding@dennisfink.me>
-#
-# SPDX-License-Identifier: BSD-3-Clause
-
-"""Provide routes for authentication and Webmention administration."""
-
-import hashlib
-import secrets
-import uuid
-from datetime import UTC, datetime, timedelta
-from typing import Any, cast
-
-import sqlalchemy as sa
-import sqlalchemy.exc as sa_exc
-from flask import (
- Blueprint,
- Response,
- abort,
- current_app,
- flash,
- redirect,
- render_template,
- request,
- url_for,
-)
-from flask.typing import ResponseReturnValue
-from flask_limiter.util import get_remote_address
-from flask_login import current_user, login_required, login_user, logout_user
-from sqlalchemy.engine import CursorResult
-from sqlalchemy.orm import selectinload
-
-from . import CSRF, LIMITER, forms
-from . import DATABASE as db
-from .models import ReceivedWebmention, SentWebmention, Source, User
-from .tasks.receiver import verify_webmention
-from .tasks.scanner import manual_scan_sources
-from .tasks.sender import send_webmention
-from .url_digest import received_url_digest
-from .url_security import is_safe_next_url
-
-root_page = Blueprint("root", __name__)
-
-DUMMY_USER = User(username=secrets.token_urlsafe())
-DUMMY_USER.password = secrets.token_urlsafe()
-
-
-def login_username_limit_key() -> str:
- """Group submitted usernames across IPs without storing raw account names."""
- username = request.form.get("username", "").strip().casefold()
- if not username:
- # A missing username must not put all clients into one global bucket.
- return f"missing-username:{get_remote_address()}"
- digest = hashlib.sha256(username.encode("utf-8")).hexdigest()
- return f"username:{digest}"
-
-
-@root_page.route("/")
-def index() -> ResponseReturnValue:
- """
- Redirect to the received Webmentions view.
-
- :return: Redirect response to the received Webmentions view.
- """
- return redirect(url_for("root.received"))
-
-
-@root_page.route("/login", methods=["GET", "POST"])
-@LIMITER.limit(
- lambda: current_app.config["LOGIN_USERNAME_RATE_LIMIT"],
- key_func=login_username_limit_key,
- methods=["POST"],
- error_message="Too many login attempts. Please try again later.",
-)
-@LIMITER.limit(
- lambda: current_app.config["LOGIN_RATE_LIMIT"],
- methods=["POST"],
- error_message="Too many login attempts. Please try again later.",
-)
-def login() -> ResponseReturnValue:
- """
- Authenticate a user and start a login session.
-
- Authenticated users are redirected to the application index. After a
- successful login, the user is redirected to the requested local URL when
- provided.
-
- :return: Rendered login page or redirect response.
- """
- if current_user.is_authenticated:
- return redirect(url_for("root.index"))
-
- form = forms.LoginForm()
-
- if form.validate_on_submit():
- user = db.session.scalar(
- sa.select(User).where(User.username == form.username.data)
- )
-
- user_exists = user is not None
-
- if user is None:
- user = DUMMY_USER
-
- if (
- form.password.data is None
- or not user.check_password(form.password.data)
- or not user_exists
- ):
- flash("Invalid username or password", "danger")
- return redirect(url_for("root.login"))
- login_user(user)
-
- next_url = request.args.get("next")
- if not next_url or not is_safe_next_url(next_url):
- next_url = url_for("root.index")
- return redirect(next_url)
-
- return render_template("login.html", form=form)
-
-
-@root_page.route("/logout", methods=("POST",))
-@login_required
-def logout() -> ResponseReturnValue:
- """
- End the current user's login session.
-
- :return: Redirect response to the application index.
- """
- logout_user()
- return redirect(url_for("root.index"))
-
-
-@root_page.route("/received")
-@login_required
-def received() -> ResponseReturnValue:
- """
- Display received Webmentions.
-
- :return: Rendered page containing the paginated received Webmentions.
- """
- webmentions = db.paginate(
- sa.select(ReceivedWebmention).order_by(ReceivedWebmention.uuid.desc()),
- per_page=25,
- )
-
- return render_template(
- "received.html",
- title="Received Webmentions",
- webmentions=webmentions,
- action_form=forms.AdminActionForm(),
- )
-
-
-@root_page.post("/received/<uuid:identifier>/delete")
-@login_required
-def delete_received_webmention(identifier: uuid.UUID) -> ResponseReturnValue:
- """
- Delete a received Webmention.
-
- :param identifier: Identifier of the Webmention to delete.
- :return: Redirect response to the received Webmentions view.
- """
- form = forms.AdminActionForm()
-
- if not form.validate_on_submit():
- return abort(400)
-
- webmention = db.session.get(ReceivedWebmention, identifier)
-
- if webmention is None:
- return abort(404)
-
- db.session.delete(webmention)
- db.session.commit()
-
- flash(f"Webmention {webmention.uuid} deleted.", "success")
-
- return redirect(
- url_for("root.received", page=request.args.get("page", 1, type=int))
- )
-
-
-@root_page.post("/received/<uuid:identifier>/reverify")
-@login_required
-def reverify_received_webmention(identifier: uuid.UUID) -> ResponseReturnValue:
- """
- Queue a received Webmention for reverification.
-
- The Webmention status is reset before a new verification task is queued.
-
- :param identifier: Identifier of the Webmention to reverify.
- :return: Redirect response to the received Webmentions view.
- """
- form = forms.AdminActionForm()
-
- if not form.validate_on_submit():
- return abort(400)
-
- webmention = db.session.get(ReceivedWebmention, identifier)
-
- if webmention is None:
- return abort(404)
-
- webmention.status = "received"
- webmention.failure_reason = None
- webmention.recovery_attempts = 0
-
- db.session.commit()
-
- verify_webmention(identifier)
-
- flash(f"Webmention {webmention.uuid} queued for reverification.", "success")
-
- return redirect(
- url_for("root.received", page=request.args.get("page", 1, type=int))
- )
-
-
-@root_page.route("/sent")
-@login_required
-def sent() -> ResponseReturnValue:
- """
- Display sources with sent Webmentions.
-
- :return: Rendered page containing the paginated source list.
- """
- sources = db.paginate(
- sa.select(Source)
- .options(selectinload(Source.sent_webmentions))
- .order_by(Source.last_seen_at.desc()),
- per_page=25,
- )
- return render_template(
- "sent.html",
- title="Sent Webmentions",
- sources=sources,
- action_form=forms.AdminActionForm(),
- )
-
-
-@root_page.post("/sent/rescan")
-@login_required
-def rescan_sent_sources() -> ResponseReturnValue:
- """
- Queue a manual scan of sent Webmention sources.
-
- :return: Redirect response to the sent Webmentions view.
- """
- form = forms.AdminActionForm()
- if form.validate_on_submit():
- manual_scan_sources()
- flash("Source rescan queued.", "success")
- return redirect(url_for("root.sent"))
-
-
-@root_page.route("/sent/<uuid:source_identifier>")
-@login_required
-def sent_source(source_identifier: uuid.UUID) -> ResponseReturnValue:
- """
- Display the sent Webmentions associated with a source.
-
- :param source_identifier: Identifier of the source to display.
- :return: Rendered source details page.
- """
- source = db.session.scalar(
- sa.select(Source).where(Source.uuid == source_identifier)
- )
-
- if source is None:
- return abort(404)
-
- webmentions = db.paginate(
- sa.select(SentWebmention)
- .where(SentWebmention.source_id == source.uuid)
- .order_by(SentWebmention.target, SentWebmention.uuid),
- per_page=25,
- )
-
- return render_template(
- "sent_source.html",
- title="Sent Webmentions",
- source=source,
- webmentions=webmentions,
- action_form=forms.AdminActionForm(),
- )
-
-
-@root_page.post("/sent/<uuid:source_identifier>/<uuid:webmention_identifier>/resend")
-@login_required
-def resend_sent_webmention(
- source_identifier: uuid.UUID, webmention_identifier: uuid.UUID
-) -> ResponseReturnValue:
- """
- Queue an outgoing Webmention to be sent again.
-
- The current desired source revision is reopened for processing so the
- sender task does not treat the Webmention as already completed. Historical
- successful-send fields are preserved, while result fields from the previous
- attempt are cleared.
-
- :param source_identifier: Identifier of the source owning the Webmention.
- :param webmention_identifier: Identifier of the sent Webmention to resend.
- :return: Redirect response to the source details view.
- """
- form = forms.AdminActionForm()
-
- if not form.validate_on_submit():
- return abort(400)
-
- webmention = db.session.get(SentWebmention, webmention_identifier)
-
- if webmention is None or webmention.source_id != source_identifier:
- return abort(404)
-
- # Reopen the existing desired revision instead of inventing a new source
- # revision. send_webmention() otherwise exits when this revision has already
- # been processed.
- webmention.processed_revision = None
- webmention.attempt_count = 0
- webmention.next_retry_at = None
- webmention.status = None
- webmention.failure_reason = None
- webmention.endpoint = None
- webmention.response_status = None
- webmention.status_url = None
-
- db.session.commit()
-
- send_webmention(webmention_identifier)
-
- flash(f"Webmention {webmention.uuid} queued for resend.", "success")
-
- return redirect(url_for("root.sent_source", source_identifier=source_identifier))
-
-
-@root_page.post("/endpoint")
-@LIMITER.limit(
- lambda: current_app.config["ENDPOINT_GLOBAL_RATE_LIMIT"],
- key_func=lambda: "all-clients",
-)
-@LIMITER.limit(lambda: current_app.config["ENDPOINT_RATE_LIMIT"])
-@CSRF.exempt
-def endpoint() -> ResponseReturnValue:
- """
- Receive and queue a Webmention for verification.
-
- Existing Webmentions with the same source and target are reset for
- reverification. Concurrent insertion of the same Webmention is handled by
- retrieving and updating the row created by the competing request.
-
- :return: HTTP 201 response with the Webmention status URL in the
- ``Location`` header, or validation errors with HTTP 400.
- """
- form = forms.EndpointForm(meta={"csrf": False})
-
- if not form.validate_on_submit():
- return form.errors, 400
-
- source = cast(str, form.source.data)
- target = cast(str, form.target.data)
-
- url_digest = received_url_digest(source, target)
- webmention = db.session.execute(
- sa.select(ReceivedWebmention).where(ReceivedWebmention.url_digest == url_digest)
- ).scalar_one_or_none()
-
- # A SHA-256 collision must never cause an unrelated Webmention to be overwritten.
- if webmention is not None and (webmention.source, webmention.target) != (
- source,
- target,
- ):
- return {"error": "Webmention URL fingerprint conflict"}, 409
-
- should_verify = False
-
- if webmention is None:
- identifier = uuid.uuid7()
-
- webmention = ReceivedWebmention(uuid=identifier, source=source, target=target)
-
- db.session.add(webmention)
-
- try:
- db.session.commit()
- should_verify = True
- except sa_exc.IntegrityError:
- db.session.rollback()
-
- # Another request may have inserted the same source/target pair
- # after our SELECT but before our COMMIT.
- webmention = db.session.execute(
- sa.select(ReceivedWebmention).where(
- ReceivedWebmention.url_digest == url_digest
- )
- ).scalar_one_or_none()
- if webmention is None or (webmention.source, webmention.target) != (
- source,
- target,
- ):
- return {"error": "Webmention URL fingerprint conflict"}, 409
-
- else:
- now = datetime.now(UTC)
- cutoff = now - timedelta(
- seconds=current_app.config["ENDPOINT_REVERIFY_COOLDOWN_SECONDS"]
- )
-
- # Atomic conditional update: only one concurrent request can reopen an expired verification.
- result = cast(
- CursorResult[Any],
- db.session.execute(
- sa.update(ReceivedWebmention)
- .where(
- ReceivedWebmention.uuid == webmention.uuid,
- ReceivedWebmention.updated_at <= cutoff,
- )
- .values(
- status="received",
- failure_reason=None,
- recovery_attempts=0,
- updated_at=now,
- )
- .execution_options(synchronize_session=False)
- ),
- )
- should_verify = result.rowcount == 1
- db.session.commit()
-
- identifier = webmention.uuid
-
- if should_verify:
- verify_webmention(identifier)
-
- status_url = url_for("root.status", identifier=str(identifier), _external=True)
-
- return Response(status=201, headers={"Location": status_url})
-
-
-@root_page.route("/status/<uuid:identifier>")
-def status(identifier: uuid.UUID) -> ResponseReturnValue:
- """
- Display the verification status of a received Webmention.
-
- :param identifier: Identifier of the Webmention to display.
- :return: Rendered Webmention status page.
- """
- webmention = db.session.get(ReceivedWebmention, identifier)
-
- if webmention is None:
- return abort(404)
-
- return render_template(
- "status.html", title="Webmention status", webmention=webmention
- )
diff --git a/webmentions_ssg/views/__init__.py b/webmentions_ssg/views/__init__.py
new file mode 100644
index 0000000..91966d4
--- /dev/null
+++ b/webmentions_ssg/views/__init__.py
@@ -0,0 +1,16 @@
+# SPDX-FileCopyrightText: 2026 Dennis Fink <me+coding@dennisfink.me>
+#
+# SPDX-License-Identifier: BSD-3-Clause
+
+"""Register all views under the historic root Blueprint."""
+
+from flask import Blueprint
+
+root_page = Blueprint("root", __name__)
+
+
+def register_routes() -> Blueprint:
+ """Import task-backed view handlers after Huey initialization and return the Blueprint."""
+ from . import admin, endpoint, session # noqa: F401
+
+ return root_page
diff --git a/webmentions_ssg/views/admin.py b/webmentions_ssg/views/admin.py
new file mode 100644
index 0000000..46e3b18
--- /dev/null
+++ b/webmentions_ssg/views/admin.py
@@ -0,0 +1,217 @@
+# SPDX-FileCopyrightText: 2026 Dennis Fink <me+coding@dennisfink.me>
+#
+# SPDX-License-Identifier: BSD-3-Clause
+
+"""Authenticated incoming and outgoing Webmention management."""
+
+import uuid
+
+import sqlalchemy as sa
+from flask import abort, flash, redirect, render_template, request, url_for
+from flask.typing import ResponseReturnValue
+from flask_login import login_required
+from sqlalchemy.orm import selectinload
+
+from .. import forms
+from ..extensions import DATABASE as db
+from ..models import ReceivedWebmention, SentWebmention, Source
+from ..tasks.receiver import verify_webmention
+from ..tasks.scanner import manual_scan_sources
+from ..tasks.sender import send_webmention
+from . import root_page
+
+
+@root_page.route("/received")
+@login_required
+def received() -> ResponseReturnValue:
+ """
+ Display received Webmentions.
+
+ :return: Rendered page containing the paginated received Webmentions.
+ """
+ webmentions = db.paginate(
+ sa.select(ReceivedWebmention).order_by(ReceivedWebmention.uuid.desc()),
+ per_page=25,
+ )
+
+ return render_template(
+ "received.html",
+ title="Received Webmentions",
+ webmentions=webmentions,
+ action_form=forms.AdminActionForm(),
+ )
+
+
+@root_page.post("/received/<uuid:identifier>/delete")
+@login_required
+def delete_received_webmention(identifier: uuid.UUID) -> ResponseReturnValue:
+ """
+ Delete a received Webmention.
+
+ :param identifier: Identifier of the Webmention to delete.
+ :return: Redirect response to the received Webmentions view.
+ """
+ form = forms.AdminActionForm()
+
+ if not form.validate_on_submit():
+ return abort(400)
+
+ webmention = db.session.get(ReceivedWebmention, identifier)
+
+ if webmention is None:
+ return abort(404)
+
+ db.session.delete(webmention)
+ db.session.commit()
+
+ flash(f"Webmention {webmention.uuid} deleted.", "success")
+
+ return redirect(
+ url_for("root.received", page=request.args.get("page", 1, type=int))
+ )
+
+
+@root_page.post("/received/<uuid:identifier>/reverify")
+@login_required
+def reverify_received_webmention(identifier: uuid.UUID) -> ResponseReturnValue:
+ """
+ Queue a received Webmention for reverification.
+
+ The Webmention status is reset before a new verification task is queued.
+
+ :param identifier: Identifier of the Webmention to reverify.
+ :return: Redirect response to the received Webmentions view.
+ """
+ form = forms.AdminActionForm()
+
+ if not form.validate_on_submit():
+ return abort(400)
+
+ webmention = db.session.get(ReceivedWebmention, identifier)
+
+ if webmention is None:
+ return abort(404)
+
+ webmention = webmention.reset_for_verification()
+
+ db.session.commit()
+
+ verify_webmention(identifier)
+
+ flash(f"Webmention {webmention.uuid} queued for reverification.", "success")
+
+ return redirect(
+ url_for("root.received", page=request.args.get("page", 1, type=int))
+ )
+
+
+@root_page.route("/sent")
+@login_required
+def sent() -> ResponseReturnValue:
+ """
+ Display sources with sent Webmentions.
+
+ :return: Rendered page containing the paginated source list.
+ """
+ sources = db.paginate(
+ sa.select(Source)
+ .options(selectinload(Source.sent_webmentions))
+ .order_by(Source.last_seen_at.desc()),
+ per_page=25,
+ )
+ return render_template(
+ "sent.html",
+ title="Sent Webmentions",
+ sources=sources,
+ action_form=forms.AdminActionForm(),
+ )
+
+
+@root_page.post("/sent/rescan")
+@login_required
+def rescan_sent_sources() -> ResponseReturnValue:
+ """
+ Queue a manual scan of sent Webmention sources.
+
+ :return: Redirect response to the sent Webmentions view.
+ """
+ form = forms.AdminActionForm()
+ if form.validate_on_submit():
+ manual_scan_sources()
+ flash("Source rescan queued.", "success")
+ return redirect(url_for("root.sent"))
+
+
+@root_page.route("/sent/<uuid:source_identifier>")
+@login_required
+def sent_source(source_identifier: uuid.UUID) -> ResponseReturnValue:
+ """
+ Display the sent Webmentions associated with a source.
+
+ :param source_identifier: Identifier of the source to display.
+ :return: Rendered source details page.
+ """
+ source = db.session.scalar(
+ sa.select(Source).where(Source.uuid == source_identifier)
+ )
+
+ if source is None:
+ return abort(404)
+
+ webmentions = db.paginate(
+ sa.select(SentWebmention)
+ .where(SentWebmention.source_id == source.uuid)
+ .order_by(SentWebmention.target, SentWebmention.uuid),
+ per_page=25,
+ )
+
+ return render_template(
+ "sent_source.html",
+ title="Sent Webmentions",
+ source=source,
+ webmentions=webmentions,
+ action_form=forms.AdminActionForm(),
+ )
+
+
+@root_page.post("/sent/<uuid:source_identifier>/<uuid:webmention_identifier>/resend")
+@login_required
+def resend_sent_webmention(
+ source_identifier: uuid.UUID, webmention_identifier: uuid.UUID
+) -> ResponseReturnValue:
+ """
+ Queue an outgoing Webmention to be sent again.
+
+ The current desired source revision is reopened for processing so the
+ sender task does not treat the Webmention as already completed. Historical
+ successful-send fields are preserved, while result fields from the previous
+ attempt are cleared.
+
+ :param source_identifier: Identifier of the source owning the Webmention.
+ :param webmention_identifier: Identifier of the sent Webmention to resend.
+ :return: Redirect response to the source details view.
+ """
+ form = forms.AdminActionForm()
+
+ if not form.validate_on_submit():
+ return abort(400)
+
+ webmention = db.session.get(SentWebmention, webmention_identifier)
+
+ if webmention is None or webmention.source_id != source_identifier:
+ return abort(404)
+
+ # Reopen the existing desired revision instead of inventing a new source
+ # revision. send_webmention() otherwise exits when this revision has already
+ # been processed.
+ webmention = webmention.reopen(
+ webmention.desired_revision, webmention.active, resend=True
+ )
+
+ db.session.commit()
+
+ send_webmention(webmention_identifier)
+
+ flash(f"Webmention {webmention.uuid} queued for resend.", "success")
+
+ return redirect(url_for("root.sent_source", source_identifier=source_identifier))
diff --git a/webmentions_ssg/views/endpoint.py b/webmentions_ssg/views/endpoint.py
new file mode 100644
index 0000000..1c2fe13
--- /dev/null
+++ b/webmentions_ssg/views/endpoint.py
@@ -0,0 +1,150 @@
+# SPDX-FileCopyrightText: 2026 Dennis Fink <me+coding@dennisfink.me>
+#
+# SPDX-License-Identifier: BSD-3-Clause
+
+"""Public Webmention endpoint and verification status view."""
+
+import uuid
+from datetime import UTC, datetime, timedelta
+from typing import Any, cast
+
+import sqlalchemy as sa
+import sqlalchemy.exc as sa_exc
+from flask import Response, abort, current_app, render_template, url_for
+from flask.typing import ResponseReturnValue
+from sqlalchemy.engine import CursorResult
+
+from .. import forms
+from ..extensions import CSRF, LIMITER
+from ..extensions import DATABASE as db
+from ..models import ReceivedWebmention, received_url_digest
+from ..tasks.receiver import verify_webmention
+from . import root_page
+
+
+def submit_received(source: str, target: str) -> tuple[uuid.UUID, bool] | None:
+ """Upsert a submission atomically and return (identifier, enqueue flag).
+
+ ``None`` means that the URL fingerprint matches a different source/target.
+ No background task is enqueued until the transaction is committed.
+ """
+ url_digest = received_url_digest(source, target)
+ webmention = db.session.execute(
+ sa.select(ReceivedWebmention).where(ReceivedWebmention.url_digest == url_digest)
+ ).scalar_one_or_none()
+
+ # A SHA-256 collision must never cause an unrelated Webmention to be overwritten.
+ if webmention is not None and (webmention.source, webmention.target) != (
+ source,
+ target,
+ ):
+ return None
+
+ should_verify = False
+
+ if webmention is None:
+ identifier = uuid.uuid7()
+ webmention = ReceivedWebmention(uuid=identifier, source=source, target=target)
+ db.session.add(webmention)
+
+ try:
+ db.session.commit()
+ should_verify = True
+ except sa_exc.IntegrityError:
+ db.session.rollback()
+
+ # Another request may have inserted the same source/target pair
+ # after our SELECT but before our COMMIT.
+ webmention = db.session.execute(
+ sa.select(ReceivedWebmention).where(
+ ReceivedWebmention.url_digest == url_digest
+ )
+ ).scalar_one_or_none()
+ if webmention is None or (webmention.source, webmention.target) != (
+ source,
+ target,
+ ):
+ return None
+
+ else:
+ now = datetime.now(UTC)
+ cutoff = now - timedelta(
+ seconds=current_app.config["ENDPOINT_REVERIFY_COOLDOWN_SECONDS"]
+ )
+
+ # Atomic conditional update: only one concurrent request can reopen an expired verification.
+ result = cast(
+ CursorResult[Any],
+ db.session.execute(
+ sa.update(ReceivedWebmention)
+ .where(
+ ReceivedWebmention.uuid == webmention.uuid,
+ ReceivedWebmention.updated_at <= cutoff,
+ )
+ .values(ReceivedWebmention.verification_reset_values(at=now))
+ .execution_options(synchronize_session=False)
+ ),
+ )
+ should_verify = result.rowcount == 1
+ db.session.commit()
+
+ return webmention.uuid, should_verify
+
+
+@root_page.post("/endpoint")
+@LIMITER.limit(
+ lambda: current_app.config["ENDPOINT_GLOBAL_RATE_LIMIT"],
+ key_func=lambda: "all-clients",
+)
+@LIMITER.limit(lambda: current_app.config["ENDPOINT_RATE_LIMIT"])
+@CSRF.exempt
+def endpoint() -> ResponseReturnValue:
+ """
+ Receive and queue a Webmention for verification.
+
+ Existing Webmentions with the same source and target are reset for
+ reverification. Concurrent insertion of the same Webmention is handled by
+ retrieving and updating the row created by the competing request.
+
+ :return: HTTP 201 response with the Webmention status URL in the
+ ``Location`` header, or validation errors with HTTP 400.
+ """
+ form = forms.EndpointForm(meta={"csrf": False})
+
+ if not form.validate_on_submit():
+ return form.errors, 400
+
+ source = cast(str, form.source.data)
+ target = cast(str, form.target.data)
+
+ result = submit_received(source, target)
+
+ if result is None:
+ return {"error": "Webmention URL fingerprint conflict"}, 409
+
+ identifier, should_verify = result
+
+ if should_verify:
+ verify_webmention(identifier)
+
+ status_url = url_for("root.status", identifier=str(identifier), _external=True)
+
+ return Response(status=201, headers={"Location": status_url})
+
+
+@root_page.route("/status/<uuid:identifier>")
+def status(identifier: uuid.UUID) -> ResponseReturnValue:
+ """
+ Display the verification status of a received Webmention.
+
+ :param identifier: Identifier of the Webmention to display.
+ :return: Rendered Webmention status page.
+ """
+ webmention = db.session.get(ReceivedWebmention, identifier)
+
+ if webmention is None:
+ return abort(404)
+
+ return render_template(
+ "status.html", title="Webmention status", webmention=webmention
+ )
diff --git a/webmentions_ssg/views/session.py b/webmentions_ssg/views/session.py
new file mode 100644
index 0000000..7bd8a10
--- /dev/null
+++ b/webmentions_ssg/views/session.py
@@ -0,0 +1,93 @@
+# SPDX-FileCopyrightText: 2026 Dennis Fink <me+coding@dennisfink.me>
+#
+# SPDX-License-Identifier: BSD-3-Clause
+
+"""Authentication and session routes."""
+
+import sqlalchemy as sa
+from flask import current_app, flash, redirect, render_template, request, url_for
+from flask.typing import ResponseReturnValue
+from flask_login import current_user, login_required, login_user, logout_user
+
+from .. import forms
+from ..auth import DUMMY_USER, is_safe_next_url, login_username_limit_key
+from ..extensions import DATABASE as db
+from ..extensions import LIMITER
+from ..models import User
+from . import root_page
+
+
+@root_page.route("/")
+def index() -> ResponseReturnValue:
+ """
+ Redirect to the received Webmentions view.
+
+ :return: Redirect response to the received Webmentions view.
+ """
+ return redirect(url_for("root.received"))
+
+
+@root_page.route("/login", methods=["GET", "POST"])
+@LIMITER.limit(
+ lambda: current_app.config["LOGIN_USERNAME_RATE_LIMIT"],
+ key_func=login_username_limit_key,
+ methods=["POST"],
+ error_message="Too many login attempts. Please try again later.",
+)
+@LIMITER.limit(
+ lambda: current_app.config["LOGIN_RATE_LIMIT"],
+ methods=["POST"],
+ error_message="Too many login attempts. Please try again later.",
+)
+def login() -> ResponseReturnValue:
+ """
+ Authenticate a user and start a login session.
+
+ Authenticated users are redirected to the application index. After a
+ successful login, the user is redirected to the requested local URL when
+ provided.
+
+ :return: Rendered login page or redirect response.
+ """
+ if current_user.is_authenticated:
+ return redirect(url_for("root.index"))
+
+ form = forms.LoginForm()
+
+ if form.validate_on_submit():
+ user = db.session.scalar(
+ sa.select(User).where(User.username == form.username.data)
+ )
+
+ user_exists = user is not None
+
+ if user is None:
+ user = DUMMY_USER
+
+ if (
+ form.password.data is None
+ or not user.check_password(form.password.data)
+ or not user_exists
+ ):
+ flash("Invalid username or password", "danger")
+ return redirect(url_for("root.login"))
+ login_user(user)
+
+ next_url = request.args.get("next")
+ if not next_url or not is_safe_next_url(next_url):
+ next_url = url_for("root.index")
+ return redirect(next_url)
+
+ return render_template("login.html", form=form)
+
+
+@root_page.route("/logout", methods=("POST",))
+@login_required
+def logout() -> ResponseReturnValue:
+ """
+ End the current user's login session.
+
+ :return: Redirect response to the application index.
+ """
+ logout_user()
+ return redirect(url_for("root.index"))