diff options
Diffstat (limited to 'webmentions_ssg/moderation_policy.py')
| -rw-r--r-- | webmentions_ssg/moderation_policy.py | 62 |
1 files changed, 62 insertions, 0 deletions
diff --git a/webmentions_ssg/moderation_policy.py b/webmentions_ssg/moderation_policy.py new file mode 100644 index 0000000..51e7995 --- /dev/null +++ b/webmentions_ssg/moderation_policy.py @@ -0,0 +1,62 @@ +# SPDX-FileCopyrightText: 2026 Dennis Fink <me+coding@dennisfink.me> +# +# SPDX-License-Identifier: BSD-3-Clause + +"""Admission policy for incoming Webmention source hostnames.""" + +import ipaddress + +import sqlalchemy as sa +from flask import current_app + +from .extensions import db +from .hostname import normalize_hostname +from .models.moderation import AllowedDomain, BlockedDomain + + +def domain_from_url(source: str) -> str | None: + """Extract and canonicalize the hostname without a network request.""" + try: + return normalize_hostname(source, from_url=True) + except ValueError: + return None + + +def has_matching_domain( + model: type[AllowedDomain | BlockedDomain], domain: str +) -> bool: + """Match the hostname itself and parent domains, never partial labels.""" + candidates = [domain] + # An IP address can only match itself, not a suffix of its textual form. + try: + ipaddress.ip_address(domain) + except ValueError: + parts = domain.split(".") + candidates.extend(".".join(parts[i:]) for i in range(1, len(parts))) + + return ( + db.session.scalar( + sa.select(model.id).where(model.domain.in_(candidates)).limit(1) + ) + is not None + ) + + +def rejection_reason(source: str) -> str | None: + """Return the reason a source cannot be received, or ``None`` if accepted. + + The blocklist always wins. In allowlist mode an empty allowlist rejects + every source. The database, not a stale per-worker cache, is consulted. + """ + if (domain := domain_from_url(source)) is None: + return "Invalid source hostname" + + if has_matching_domain(BlockedDomain, domain): + return "Source domain is blocked" + + if current_app.config["ALLOWLIST_ENABLED"] and not has_matching_domain( + AllowedDomain, domain + ): + return "Source domain is not allowlisted" + + return None |
