# SPDX-License-Identifier: AGPL-3.0-or-later # Copyright (C) 2026 Jonas Lorenz IT-Dienstleistungen # # Dieses Synapse-Modul ist freie Software: Sie koennen es unter den # Bedingungen der GNU Affero General Public License, Version 3 oder (nach # Ihrer Wahl) jeder spaeteren Fassung, weitergeben und veraendern. Es wird # OHNE JEDE GEWAEHRLEISTUNG bereitgestellt. Der Lizenztext und dieser # Quelltext stehen auf der Seite /open-source-lizenzen jeder AlarmPunkt- # Installation (Abschnitt "Chat-Server"). # # Warum AGPL: Das Modul laeuft im Prozess von Synapse (AGPL-3.0-or-later) # und bildet mit ihm ein Gesamtwerk (Betreiber 15.11.2026; # compliance/06_licenses.md, Nr. 19). """ Einladungen nur innerhalb der Organisation. (Rang 2-5 A2-14, 31.10.2026) Ein Synapse-Modul (user_may_invite). Es laesst eine Person nur Personen einladen, mit denen sie einen Raum des Dienstkontos teilt - also Menschen aus ihrer eigenen Organisation. Einladungen des Dienstkontos und anderer Konten (Alarmmonitore, @apmonitor) laufen durch. ====================================================================== WARUM ====================================================================== Auf einem Homeserver stehen mehrere Organisationen, und jede Kennung @ap ist zu erraten. Bis hierher konnte eine Person der einen Wehr eine Person der Nachbarwehr in einen selbst angelegten Raum einladen - deren Client nahm an, und der echte Name stand im Mitgliedsereignis (NV-49, SEC-075). Der Server tritt seit S-13 nicht mehr fuer Fremde bei (matrixEingeladeneBeitreten()), die Apps nehmen seit A2-14 nur noch Einladungen aus der eigenen Personenliste an; dieses Modul nimmt die Einladung selbst gar nicht erst an. Organisationsuebergreifende Raeume sind nicht gewollt (Betreiber, 31.10.2026). ====================================================================== WORAN ES DIE ORGANISATION ERKENNT ====================================================================== Synapse kennt keine Organisationen. Was es kennt: die Raeume, die das Dienstkonto von AlarmPunkt anlegt - je Organisation und Gruppe, gefuellt vom Raumabgleich (bin/matrix-raeume.php) mit genau den Personen, die dort Chatrecht haben. Teilen Einladender und Eingeladener einen solchen Raum, gehoeren sie zur selben Organisation. Sonst: abgewiesen. Eingeladen zaehlt wie beigetreten - auf BEIDEN Seiten (Betreiber, 01.11.2026). Der Raumabgleich laedt nur ein; wer die Einladungen seiner Organisation noch nicht angenommen hat, gehoert trotzdem dazu und darf dort einladen. Bis dahin zaehlten bei der einladenden Person nur beigetretene Raeume, und sie konnte niemanden einladen, auch nicht aus der eigenen Wehr (gemessen in der Testumgebung, 31.10.2026). Wer in keinem Raum des Dienstkontos steht, hat kein Chatrecht - ihn einzuladen hiesse, einer Person zu schreiben, die nie liest. ====================================================================== WENN ES NICHT ENTSCHEIDEN KANN ====================================================================== Fehlt Synapse die interne Schnittstelle, ueber die das Modul die Raeume eines Kontos liest (andere Fassung), laesst es die Einladung durch und schreibt das LAUT ins Protokoll von Synapse. Ein Modul, das jede Einladung abweist, legte den ganzen Chat still - Gruppen liessen sich nicht mehr anlegen. Die zweite und dritte Sperre (Server, Apps) bleiben. """ import logging from typing import Any, Dict, Optional, Set from synapse.module_api import NOT_SPAM, ModuleApi try: from synapse.module_api.errors import Codes ABGEWIESEN: Any = Codes.FORBIDDEN except Exception: # aeltere Fassung: bool wird noch verstanden ABGEWIESEN = False logger = logging.getLogger(__name__) class EinladungNurInDerOrganisation: def __init__(self, config: Dict[str, Any], api: ModuleApi): self._api = api self._dienstkonto = str(config.get("dienstkonto", "")) self._servername = self._dienstkonto.split(":", 1)[1] if ":" in self._dienstkonto else "" self._ersteller: Dict[str, Optional[str]] = {} if self._dienstkonto == "": raise ValueError("alarmpunkt_einladung: 'dienstkonto' fehlt in der Konfiguration") api.register_spam_checker_callbacks(user_may_invite=self.user_may_invite) @staticmethod def parse_config(config: Dict[str, Any]) -> Dict[str, Any]: return config or {} def _ist_person(self, kennung: str) -> bool: """@ap: - eine Person von AlarmPunkt.""" lokal, _, server = kennung.lstrip("@").partition(":") return server == self._servername and lokal.startswith("ap") and lokal[2:].isdigit() async def _ersteller_von(self, raum: str) -> Optional[str]: if raum not in self._ersteller: zustand = await self._api.get_room_state(raum, [("m.room.create", "")]) ereignis = zustand.get(("m.room.create", "")) self._ersteller[raum] = ereignis.sender if ereignis is not None else None return self._ersteller[raum] async def _raeume(self, kennung: str) -> Set[str]: """Beigetretene UND eingeladene Raeume eines Kontos.""" speicher = getattr(self._api, "_store", None) if speicher is None or not hasattr(speicher, "get_rooms_for_user"): raise RuntimeError("Synapse liefert die Raeume eines Kontos nicht (_store.get_rooms_for_user)") raeume = set(await speicher.get_rooms_for_user(kennung)) if hasattr(speicher, "get_invited_rooms_for_local_user"): for eintrag in await speicher.get_invited_rooms_for_local_user(kennung): raeume.add(getattr(eintrag, "room_id", eintrag)) return raeume async def user_may_invite(self, inviter: str, invitee: str, room_id: str) -> Any: # Nur Personen sind eingeschraenkt; das Dienstkonto und die # Konten der Alarmmonitore laden ein, was AlarmPunkt geprueft hat. if inviter == self._dienstkonto or not self._ist_person(inviter): return NOT_SPAM if not self._ist_person(invitee): return NOT_SPAM try: gemeinsam = (await self._raeume(inviter)) & (await self._raeume(invitee)) for raum in gemeinsam: if await self._ersteller_von(raum) == self._dienstkonto: return NOT_SPAM except Exception as fehler: logger.error( "AlarmPunkt: LAUT - Einladung %s -> %s nicht pruefbar (%s) - durchgelassen", inviter, invitee, fehler, ) return NOT_SPAM logger.warning( "AlarmPunkt: Einladung %s -> %s in %s abgewiesen - keine gemeinsame Organisation", inviter, invitee, room_id, ) return ABGEWIESEN