From a95204b8d6d34df4f34f028c1380b584033f3516 Mon Sep 17 00:00:00 2001 From: Thomas Date: Sun, 1 Nov 2026 21:59:11 +0100 Subject: [PATCH] Umbau broekr auf client-id --- CMBNet/README_CMBNet.md | 37 +- CMBNet/cmbnet/admin/api.py | 7 +- CMBNet/cmbnet/ws/broker.py | 506 ++++++++++++++-------- CMBNet/cmbnet/ws/heartbeat.py | 10 +- CMBNet/cmbnet/ws/protocol.py | 8 +- CMBNet/cmbnet/ws/routes.py | 95 ++-- CMBNet/config.py | 11 +- CMBNet/static/js/reload_notice.js | 4 +- CMBNet/static/js/sw.js | 2 +- CMBNet/static/js/views/admin_dashboard.js | 9 +- CMBNet/static/js/views/dispatcher.js | 19 +- CMBNet/static/js/views/mobile.js | 21 +- CMBNet/templates/admin/dashboard.html | 3 +- CMBNet/templates/base.html | 46 +- doc/Websocket und Caddy.pdf | Bin 0 -> 77968 bytes doc/broker.md | 248 ++++++----- doc/prompt.txt | 11 + 17 files changed, 649 insertions(+), 388 deletions(-) create mode 100644 doc/Websocket und Caddy.pdf diff --git a/CMBNet/README_CMBNet.md b/CMBNet/README_CMBNet.md index 716a606..5dd8654 100644 --- a/CMBNet/README_CMBNet.md +++ b/CMBNet/README_CMBNet.md @@ -48,29 +48,34 @@ Clients den Header nicht selbst setzen können. ## WebSocket-Synchronisierung -Jeder Browser-Tab erzeugt eine Sitzungs-ID, die in `sessionStorage` gespeichert -wird und ein Neuladen übersteht. Nicht zustellbare Nachrichten mit Code >= 100 -werden beim Broker pro `(Mandant, Account, Sitzungs-ID)` gepuffert und bei der -nächsten WebSocket-Verbindung mit derselben ID ausgeliefert. +Jede Webview erzeugt beim Laden einmalig eine Client-ID. Sie wird bewusst nicht +in `sessionStorage` gespeichert: Ein Seiten-Reload erzeugt eine neue Client-ID +und damit eine neue Broker-Verbindung. Nicht zustellbare Nachrichten mit +Code >= 100 werden beim Broker pro `(Mandant, Client-ID)` gepuffert und bei der +nächsten WebSocket-Verbindung mit derselben Client-ID ausgeliefert. Mehrere +Clients desselben Accounts werden getrennt verwaltet und alle beliefert. -Die beiden Zeitfenster lassen sich über Umgebungsvariablen konfigurieren: +Die Zeitfenster lassen sich über Umgebungsvariablen konfigurieren: - `CMBNET_WS_QUEUE_MAX_AGE_MINUTES` (Default `15`): Maximales Alter einer - Sitzungs-Queue. Ältere Queues werden verworfen; beim nächsten Reconnect wird - stattdessen eine Code-99-Nachricht mit Hinweis auf die zu lange Unterbrechung - zugestellt. + Client-Queue. Ältere Queues werden verworfen; beim nächsten Reconnect mit + derselben Client-ID wird stattdessen eine Code-99-Nachricht mit Hinweis auf + die zu lange Unterbrechung zugestellt. +- `CMBNET_WS_CLIENT_RETENTION_MINUTES` (Default `60`): Wie lange eine nicht mehr + verbundene Webview samt Queue registriert bleibt, bevor der Broker sie + endgültig aufräumt. - `CMBNET_WS_GROUP_ONLINE_TIMEOUT_SECONDS` (Default `120`): Zeit ohne Code-2- Lebenszeichen, nach der eine Gruppe von `online` auf `unterwegs` wechselt. - `CMBNET_WS_DEBUG_MESSAGES` (Default `1`): schreibt jede beim Broker - eingehende Nachricht inklusive Absender, Code und ermitteltem Empfängerkreis - nach `logs/cmbnet-ws-YYYY-MM-DD.log`. Mit `0` lässt sich die Ausgabe - abschalten. + eingehende Nachricht inklusive Absender, Client-ID, Code und ermitteltem + Empfängerkreis nach `logs/cmbnet-ws-YYYY-MM-DD.log`. Mit `0` lässt sich die + Ausgabe abschalten. -Die Sitzungs-Queues liegen im Arbeitsspeicher des Broker-Prozesses. Sie -überstehen damit WebSocket-Unterbrechungen und Seiten-Reloads, nicht aber einen -Neustart des Servers. Der mobile Client puffert zusätzlich ausgehende -fachliche Nachrichten kurzzeitig lokal und sendet sie nach erfolgreicher -Authentifizierung automatisch nach. +Die Client-Queues liegen im Arbeitsspeicher des Broker-Prozesses. Sie +überstehen damit kurze WebSocket-Unterbrechungen, nicht aber einen +Seiten-Reload mit neuer Client-ID oder einen Neustart des Servers. Der mobile +Client puffert zusätzlich ausgehende fachliche Nachrichten kurzzeitig im +Speicher und sendet sie nach erfolgreicher Authentifizierung automatisch nach. Eine ausführliche Beschreibung des Protokolls, der Brokerlogik, der Nebenläufigkeit und der aktuellen Abweichungen steht in diff --git a/CMBNet/cmbnet/admin/api.py b/CMBNet/cmbnet/admin/api.py index 81059ec..a8a4c1d 100644 --- a/CMBNet/cmbnet/admin/api.py +++ b/CMBNet/cmbnet/admin/api.py @@ -359,17 +359,20 @@ def broker_status(**kwargs): """Status aktiver WebSocket-Verbindungen""" connections = broker.connections.get(g.tenant_id, {}) if hasattr(broker, 'connections') else {} result = [] - for account_id, conn in connections.items(): - account = db = get_db().execute( + for client_id, conn in connections.items(): + account_id = conn.get('account_id') + account = get_db().execute( 'SELECT id, name, role FROM accounts WHERE id = ? AND tenant_id = ?', (account_id, g.tenant_id) ).fetchone() if not account: continue entry = { + 'client_id': client_id, 'account_id': account['id'], 'account_name': account['name'], 'role': account['role'], + 'authenticated': broker.is_authenticated(g.tenant_id, client_id), 'group_id': None, 'group_alias': None } diff --git a/CMBNet/cmbnet/ws/broker.py b/CMBNet/cmbnet/ws/broker.py index 1fa17f2..2280611 100644 --- a/CMBNet/cmbnet/ws/broker.py +++ b/CMBNet/cmbnet/ws/broker.py @@ -25,6 +25,7 @@ Wichtige Regeln aus der Spezifikation: import json import re import time +import uuid from datetime import datetime, timedelta, timezone from threading import Lock from flask import current_app @@ -35,24 +36,34 @@ from cmbnet.ws.protocol import WSMessage class WebSocketBroker: def __init__(self): - # connections[tenant_id][account_id] = { + # connections[tenant_id][client_id] = { # 'ws': , + # 'account_id': , # 'role': , # 'group_id': , # } + # Eine Client-ID gehört genau zu einer Webview. Mehrere Clients + # desselben Accounts besitzen daher getrennte Einträge. self.connections = {} - # authenticated[tenant_id][account_id] = True + # authenticated[tenant_id][client_id] = True # Erst nach erfolgreichem Code-0-Handshake darf ein Client Nachrichten # über die Verbindung senden. self.authenticated = {} - # Nicht zustellbare Nachrichten werden pro Client-Sitzung gepuffert. - # Schlüssel: (tenant_id, account_id, session_id). - self.session_queues = {} - # Zuletzt bekannte Sitzungs-ID je Account. Sie erlaubt es, Nachrichten - # auch dann der richtigen Queue zuzuordnen, wenn gerade keine - # WebSocket-Verbindung besteht. - self.account_sessions = {} + # Nicht zustellbare Nachrichten werden pro Client gepuffert. + # Schlüssel: (tenant_id, client_id). + self.client_queues = {} + # client_accounts[(tenant_id, client_id)] = account_id + # Bleibt auch nach einem Verbindungsabbruch erhalten, damit weitere + # Nachrichten für denselben Client gepuffert werden können. + self.client_accounts = {} + # account_clients[(tenant_id, account_id)] = {client_id, ...} + # Wird für die Empfängerermittlung benötigt: Ein Account kann mehrere + # Clients gleichzeitig betreiben. + self.account_clients = {} + # disconnected_clients[(tenant_id, client_id)] = monotonic Zeitpunkt. + # Dient dem Aufräumen dauerhaft verlassener Webviews. + self.disconnected_clients = {} self.queue_lock = Lock() # Zeitpunkt des letzten Code-2-Pongs je Gruppe (monotonic). @@ -62,12 +73,16 @@ class WebSocketBroker: # ------------------------------------------------------------------ # Verbindungen und Authentifizierung # ------------------------------------------------------------------ - def register_connection(self, tenant_id, account_id, ws, role=None, group_id=None): - """Registriert eine neue, noch nicht authentifizierte Verbindung. + def register_connection(self, tenant_id, account_id, client_id, ws, role=None, group_id=None): + """Registriert eine neue, noch nicht authentifizierte Client-Verbindung. - Rolle und Gruppenzuordnung werden direkt mitgespeichert. Sie werden - später für die Empfängerermittlung und für das Cleanup benötigt. + Die Verbindung wird anhand der Client-ID verwaltet. Die Account-ID wird + mitgeführt, damit Empfänger weiterhin über Rollen und Gruppen ermittelt + werden können und ein Account mehrere Clients parallel betreiben kann. """ + if not client_id: + return False + db = get_db() account = db.execute( 'SELECT role FROM accounts WHERE id = ? AND tenant_id = ?', @@ -76,6 +91,13 @@ class WebSocketBroker: if not account: return False + # Eine Client-ID ist an den Account gebunden, der sie im Handshake + # verwendet hat. Ein Wechsel des Accounts unter derselben ID wäre ein + # Hinweis auf eine falsche bzw. manipulierte Zuordnung. + existing_account = self.client_accounts.get((tenant_id, client_id)) + if existing_account is not None and existing_account != account_id: + return False + if role is None: role = account['role'] @@ -91,24 +113,35 @@ class WebSocketBroker: ).fetchone() group_id = group['id'] if group else None - if tenant_id not in self.connections: - self.connections[tenant_id] = {} + connections = self.connections.setdefault(tenant_id, {}) + + # Eine neue Verbindung mit derselben Client-ID ersetzt eine eventuell + # noch registrierte alte Verbindung (z. B. nach einem schnellen + # Reconnect). + existing = connections.get(client_id) + if existing and existing.get('ws') is not ws: + try: + existing['ws'].close() + except Exception: + pass # Eine neue Verbindung muss den Token-Handshake erneut durchlaufen. - # Ein eventuell noch gesetzter Auth-Status einer älteren Verbindung - # desselben Accounts darf nicht übernommen werden. - authenticated = self.authenticated.get(tenant_id) - if authenticated: - authenticated.pop(account_id, None) + authenticated = self.authenticated.setdefault(tenant_id, {}) + authenticated.pop(client_id, None) - self.connections[tenant_id][account_id] = { + connections[client_id] = { 'ws': ws, + 'account_id': account_id, + 'client_id': client_id, 'role': role, 'group_id': group_id, - 'session_id': None, 'last_ping': datetime.now(), 'connected_at': time.monotonic(), 'last_pong_at': None, + # Ob diese Client-ID bereits vor diesem Handshake bekannt war. + # Nur dann bleibt ihre Queue auch bei einem fehlgeschlagenen + # erneuten Handshake erhalten. + 'known_client': existing_account is not None, # simple-websocket schreibt Nachrichten direkt auf den Socket. # Da Heartbeat, WebSocket-Routen und HTTP-ausgelöste Broadcasts # aus unterschiedlichen Threads senden können, müssen die Frames @@ -116,11 +149,15 @@ class WebSocketBroker: # Frames überlagern und der Browser meldet "Invalid frame header". 'send_lock': Lock() } + + self.client_accounts[(tenant_id, client_id)] = account_id + self.account_clients.setdefault((tenant_id, account_id), set()).add(client_id) + self.disconnected_clients.pop((tenant_id, client_id), None) return True - def send_to_connection(self, tenant_id, account_id, data): - """Sendet einen Frame thread-sicher an eine registrierte Verbindung.""" - conn = self._get_connection(tenant_id, account_id) + def send_to_connection(self, tenant_id, client_id, data): + """Sendet einen Frame thread-sicher an eine registrierte Client-Verbindung.""" + conn = self._get_connection(tenant_id, client_id) if not conn: return False @@ -138,17 +175,21 @@ class WebSocketBroker: # Schließen der Verbindung. return False - def is_authenticated(self, tenant_id, account_id): - """Prüft, ob eine Verbindung den Code-0-Handshake erfolgreich absolviert hat.""" - return self.authenticated.get(tenant_id, {}).get(account_id, False) + def is_authenticated(self, tenant_id, client_id): + """Prüft, ob ein Client den Code-0-Handshake erfolgreich absolviert hat.""" + return self.authenticated.get(tenant_id, {}).get(client_id, False) - def authenticate(self, tenant_id, account_id, token, session_id=None): - """Authentifiziert eine Verbindung anhand des Einmal-Tokens (Code 0). + def authenticate(self, tenant_id, account_id, client_id, token): + """Authentifiziert eine Client-Verbindung anhand des Einmal-Tokens (Code 0). - Die Sitzungs-ID stammt vom Client und bleibt auch nach einem Neuladen - erhalten. Sie ordnet die Verbindung einer eventuell vorhandenen - Nachrichten-Queue zu. + Die Client-ID wird pro Webview erzeugt und ordnet die Verbindung einer + eventuell vorhandenen Nachrichten-Queue zu. Nach einem Neuladen der + Seite entsteht eine neue Client-ID und damit bewusst eine neue Sitzung. """ + conn = self._get_connection(tenant_id, client_id) + if not conn or conn.get('account_id') != account_id: + return False + db = get_db() token_row = db.execute( 'SELECT * FROM ws_tokens WHERE token = ? AND tenant_id = ? ' @@ -176,67 +217,83 @@ class WebSocketBroker: db.execute('UPDATE ws_tokens SET used = 1 WHERE id = ?', (token_row['id'],)) db.commit() - session_id = self._normalize_session_id(session_id, account_id) - conn = self._get_connection(tenant_id, account_id) - if conn: - conn['session_id'] = session_id - if conn.get('role') == 'Gruppe' and conn.get('group_id'): - # Ein frisch verbundener Gruppen-Client erhält eine - # Zwei-Minuten-Kulanz, bis der erste Code-2-Pong eintrifft. - key = (tenant_id, conn['group_id']) - self.group_online_since[key] = time.monotonic() - self.account_sessions[(tenant_id, account_id)] = session_id + if conn.get('role') == 'Gruppe' and conn.get('group_id'): + # Ein frisch verbundener Gruppen-Client erhält eine + # Zwei-Minuten-Kulanz, bis der erste Code-2-Pong eintrifft. + key = (tenant_id, conn['group_id']) + self.group_online_since[key] = time.monotonic() - if tenant_id not in self.authenticated: - self.authenticated[tenant_id] = {} - self.authenticated[tenant_id][account_id] = True + self.authenticated.setdefault(tenant_id, {})[client_id] = True + self.client_accounts[(tenant_id, client_id)] = account_id + self.account_clients.setdefault((tenant_id, account_id), set()).add(client_id) + self.disconnected_clients.pop((tenant_id, client_id), None) - # Zuerst die für diese Sitzung gepufferten Nachrichten ausliefern. + # Zuerst die für diesen Client gepufferten Nachrichten ausliefern. # Wurde die Queue wegen Überschreitung der Maximalzeit verworfen, wird # stattdessen ausschließlich ein Code-99-Hinweis gesendet. - queued_messages, suppress_late_entries = self.restore_session_queue( - tenant_id, account_id, session_id + queued_messages, suppress_late_entries = self.restore_client_queue( + tenant_id, client_id ) # Nach erfolgreicher Authentifizierung dürfen die gespeicherten # Nachrichten der letzten 8 Stunden nachgeliefert werden. Bereits aus - # der Sitzungs-Queue zugestellte Nachrichten werden dabei ausgelassen. + # der Client-Queue zugestellte Nachrichten werden dabei ausgelassen. if not suppress_late_entries: self.send_late_entries( tenant_id, account_id, + client_id, skip_messages=queued_messages ) return True - def remove_connection(self, tenant_id, account_id, ws=None): - """Entfernt eine Verbindung. + def remove_connection(self, tenant_id, client_id, ws=None): + """Entfernt eine Client-Verbindung. - Wenn ein Account mehrere Tabs/Verbindungen öffnet, wird nur die - tatsächlich beendete Verbindung entfernt (ws-Vergleich), nicht die - zuletzt registrierte. + Die Client-ID bleibt mit ihrem Account und ihrer Queue registriert, bis + sie entweder zurückkehrt oder vom Aufräumjob verworfen wird. Dadurch + können kurze Unterbrechungen überbrückt werden, ohne andere Clients + desselben Accounts zu beeinflussen. """ connections = self.connections.get(tenant_id) - if connections and account_id in connections: - conn = connections[account_id] - if ws is None or conn.get('ws') is ws: - session_id = conn.get('session_id') - del connections[account_id] - # Nur wenn die tatsächlich beendete Verbindung die aktuelle - # war, darf auch der Authentifizierungsstatus entfernt werden. - authenticated = self.authenticated.get(tenant_id) - if authenticated and account_id in authenticated: - del authenticated[account_id] + if not connections or client_id not in connections: + return - # Ab dem Trennen beginnt die Lebenszeit der Sitzungs-Queue. - if session_id: - with self.queue_lock: - self._ensure_session_queue( - tenant_id, account_id, session_id - ) + conn = connections[client_id] + if ws is not None and conn.get('ws') is not ws: + return - def _get_connection(self, tenant_id, account_id): - return self.connections.get(tenant_id, {}).get(account_id) + was_authenticated = self.is_authenticated(tenant_id, client_id) + was_known_client = conn.get('known_client', True) + + del connections[client_id] + if not connections: + self.connections.pop(tenant_id, None) + + authenticated = self.authenticated.get(tenant_id) + if authenticated: + authenticated.pop(client_id, None) + if not authenticated: + self.authenticated.pop(tenant_id, None) + + if not was_authenticated and not was_known_client: + # Ein nie erfolgreich authentifizierter neuer Client hinterlässt + # keine Zuordnung, Queue oder Empfängerregistrierung. + account_id = self.client_accounts.pop((tenant_id, client_id), None) + self.client_queues.pop((tenant_id, client_id), None) + self.disconnected_clients.pop((tenant_id, client_id), None) + if account_id is not None: + clients = self.account_clients.get((tenant_id, account_id)) + if clients is not None: + clients.discard(client_id) + if not clients: + self.account_clients.pop((tenant_id, account_id), None) + return + + self.disconnected_clients[(tenant_id, client_id)] = time.monotonic() + + def _get_connection(self, tenant_id, client_id): + return self.connections.get(tenant_id, {}).get(client_id) def log_incoming(self, tenant_id, message, sender=None, recipients=None, note=None): """Schreibt eine Debugzeile für eine beim Broker eingehende Nachricht. @@ -260,19 +317,30 @@ class WebSocketBroker: (message.sender_id, tenant_id) ).fetchone() - sender_info = None - if sender is not None: - sender_info = self._get_sender_info(tenant_id, sender) + sender_info = ( + self._get_sender_info(tenant_id, sender) + if sender is not None else None + ) + sender_client_id = ( + getattr(message, '_sender_client_id', None) + or getattr(message, 'client_id', None) + ) + if sender_info is not None and sender_client_id: + sender_info['client_id'] = sender_client_id recipient_rows = [] for recipient_id in sorted(set(recipients or [])): - account = db.execute( - 'SELECT * FROM accounts WHERE id = ? AND tenant_id = ?', - (recipient_id, tenant_id) - ).fetchone() + account_id = self.client_accounts.get((tenant_id, recipient_id)) + account = None + if account_id is not None: + account = db.execute( + 'SELECT * FROM accounts WHERE id = ? AND tenant_id = ?', + (account_id, tenant_id) + ).fetchone() if account is None: recipient_rows.append({ - 'account_id': recipient_id, + 'client_id': recipient_id, + 'account_id': account_id, 'known': False, 'connected': False, 'authenticated': False @@ -280,6 +348,7 @@ class WebSocketBroker: continue info = self._get_sender_info(tenant_id, account) + info['client_id'] = recipient_id info['connected'] = bool(self._get_connection(tenant_id, recipient_id)) info['authenticated'] = self.is_authenticated(tenant_id, recipient_id) recipient_rows.append(info) @@ -297,7 +366,7 @@ class WebSocketBroker: 'code': message.code, 'sender': sender_info, 'receiver_id': message.receiver_id, - 'session_id': getattr(message, 'session_id', None), + 'client_id': sender_client_id, 'ts': message.ts, 'msg': payload, 'recipients': recipient_rows, @@ -314,21 +383,23 @@ class WebSocketBroker: pass # ------------------------------------------------------------------ - # Sitzungs-Queues + # Client-Queues # ------------------------------------------------------------------ @staticmethod - def _normalize_session_id(value, account_id): - """Validiert die vom Client gelieferte Sitzungs-ID. + def normalize_client_id(value, account_id=None): + """Validiert die vom Webview gelieferte Client-ID. - Ältere Clients senden noch keine ID. Für sie wird eine stabile - Ersatz-ID je Account gebildet, damit auch dort die Queue funktioniert. + Die Client-ID wird pro Seitenaufruf neu erzeugt. Ältere Clients, die + noch keine ID senden, erhalten eine eindeutige Ersatz-ID. Diese ist + bewusst nicht accountweit stabil, weil eine neue Verbindung ohne ID + nicht sicher derselben alten Webview zugeordnet werden kann. """ text = str(value or '').strip() if re.fullmatch(r'[A-Za-z0-9._:-]{8,128}', text): return text - return f'legacy-{account_id}' + return f'legacy-{account_id or 0}-{uuid.uuid4().hex}' - def _session_queue_max_age_seconds(self): + def _client_queue_max_age_seconds(self): minutes = current_app.config.get('WS_QUEUE_MAX_AGE_MINUTES', 15) try: minutes = float(minutes) @@ -336,10 +407,18 @@ class WebSocketBroker: minutes = 15 return max(0.0, minutes * 60) - def _ensure_session_queue(self, tenant_id, account_id, session_id, now=None): - """Liefert die Queue einer Sitzung und legt sie bei Bedarf an.""" - key = (tenant_id, account_id, session_id) - queue = self.session_queues.get(key) + def _client_retention_seconds(self): + minutes = current_app.config.get('WS_CLIENT_RETENTION_MINUTES', 60) + try: + minutes = float(minutes) + except (TypeError, ValueError): + minutes = 60 + return max(self._client_queue_max_age_seconds(), minutes * 60) + + def _ensure_client_queue(self, tenant_id, client_id, now=None): + """Liefert die Queue eines Clients und legt sie bei Bedarf an.""" + key = (tenant_id, client_id) + queue = self.client_queues.get(key) if queue is None: queue = { 'messages': [], @@ -347,33 +426,33 @@ class WebSocketBroker: 'expired': False, 'code99_only': False, 'code99_message': None, + 'account_id': self.client_accounts.get(key), } - self.session_queues[key] = queue + self.client_queues[key] = queue return queue - def _expire_session_queue(self, queue, now=None): + def _expire_client_queue(self, queue, now=None): """Verwirft zu alte Nachrichten und hinterlässt einen Code-99-Hinweis.""" if not queue or queue.get('code99_only') or queue.get('expired'): return now = now if now is not None else time.monotonic() - if now - queue.get('created_at', now) < self._session_queue_max_age_seconds(): + if now - queue.get('created_at', now) < self._client_queue_max_age_seconds(): return queue['messages'].clear() queue['expired'] = True - def _queue_undeliverable(self, tenant_id, account_id, message): - """Puffert eine nicht zustellbare Nachricht für die letzte Sitzung.""" + def _queue_undeliverable(self, tenant_id, client_id, message): + """Puffert eine nicht zustellbare Nachricht für einen Client.""" if message.code < 100 and message.code != 99: return - session_id = self.account_sessions.get((tenant_id, account_id)) - if not session_id: + if (tenant_id, client_id) not in self.client_accounts: return with self.queue_lock: - queue = self._ensure_session_queue(tenant_id, account_id, session_id) + queue = self._ensure_client_queue(tenant_id, client_id) now = time.monotonic() if message.code == 99: @@ -385,20 +464,46 @@ class WebSocketBroker: queue['expired'] = False return - self._expire_session_queue(queue, now) + self._expire_client_queue(queue, now) if queue.get('expired') or queue.get('code99_only'): return queue['messages'].append(message.to_json()) - def cleanup_session_queues(self): - """Markiert abgelaufene Sitzungs-Queues und verwirft deren Nachrichten.""" + def cleanup_client_queues(self): + """Räumt abgelaufene Client-Queues und verwaiste Webviews auf.""" now = time.monotonic() + retention = self._client_retention_seconds() with self.queue_lock: - for queue in self.session_queues.values(): - self._expire_session_queue(queue, now) + for queue in self.client_queues.values(): + self._expire_client_queue(queue, now) - def _session_queue_timeout_message(self): + for key, disconnected_at in list(self.disconnected_clients.items()): + tenant_id, client_id = key + if self._get_connection(tenant_id, client_id): + self.disconnected_clients.pop(key, None) + continue + if now - disconnected_at < retention: + continue + + queue = self.client_queues.get(key) + # Solange noch zustellbare Nachrichten warten, bleibt der + # Client registriert. Danach darf die verwaiste Webview + # inklusive Code-99-Tombstone verworfen werden. + if queue and not queue.get('expired') and not queue.get('code99_only'): + continue + + account_id = self.client_accounts.pop(key, None) + self.client_queues.pop(key, None) + self.disconnected_clients.pop(key, None) + if account_id is not None: + clients = self.account_clients.get((tenant_id, account_id)) + if clients is not None: + clients.discard(client_id) + if not clients: + self.account_clients.pop((tenant_id, account_id), None) + + def _client_queue_timeout_message(self): minutes = current_app.config.get('WS_QUEUE_MAX_AGE_MINUTES', 15) return WSMessage( sender_id=0, @@ -410,8 +515,8 @@ class WebSocketBroker: ) ).to_json() - def restore_session_queue(self, tenant_id, account_id, session_id): - """Liefert gepufferte Nachrichten einer wiedererkannten Sitzung aus. + def restore_client_queue(self, tenant_id, client_id): + """Liefert gepufferte Nachrichten eines wiedererkannten Clients aus. Rückgabe: (Menge der Roh-Nachrichten aus der Queue, Late-Entry-Sperre). Die Menge dient dazu, dieselben Nachrichten nicht zusätzlich als @@ -419,23 +524,23 @@ class WebSocketBroker: war oder nur noch eine Code-99-Nachricht enthielt. In diesem Fall darf keine zusätzliche Late-Entry-Historie mehr gesendet werden. """ - key = (tenant_id, account_id, session_id) + key = (tenant_id, client_id) now = time.monotonic() with self.queue_lock: - queue = self.session_queues.get(key) + queue = self.client_queues.get(key) if not queue: return set(), False - self._expire_session_queue(queue, now) + self._expire_client_queue(queue, now) if queue.get('code99_only'): - raw_message = queue.get('code99_message') or self._session_queue_timeout_message() - self.session_queues.pop(key, None) + raw_message = queue.get('code99_message') or self._client_queue_timeout_message() + self.client_queues.pop(key, None) send_only = True messages = [] elif queue.get('expired'): - raw_message = self._session_queue_timeout_message() - self.session_queues.pop(key, None) + raw_message = self._client_queue_timeout_message() + self.client_queues.pop(key, None) send_only = True messages = [] else: @@ -445,26 +550,26 @@ class WebSocketBroker: queue['messages'] = [] if send_only: - if raw_message and not self.send_to_connection(tenant_id, account_id, raw_message): + if raw_message and not self.send_to_connection(tenant_id, client_id, raw_message): # Verbindung ist bereits wieder weg: Queue für den nächsten # Versuch erhalten. with self.queue_lock: - self.session_queues.setdefault(key, queue) + self.client_queues.setdefault(key, queue) return set(), True unsent = [] for index, raw_message in enumerate(messages): - if not self.send_to_connection(tenant_id, account_id, raw_message): + if not self.send_to_connection(tenant_id, client_id, raw_message): unsent = messages[index:] break with self.queue_lock: - current = self.session_queues.get(key) + current = self.client_queues.get(key) if current is not None: if unsent: current['messages'] = unsent + current.get('messages', []) if not current.get('messages'): - self.session_queues.pop(key, None) + self.client_queues.pop(key, None) # Auch nicht zugestellte Queue-Nachrichten von den Late Entries # ausnehmen. Sie bleiben in der Queue und werden beim nächsten @@ -474,11 +579,12 @@ class WebSocketBroker: # ------------------------------------------------------------------ # Late Entry # ------------------------------------------------------------------ - def send_late_entries(self, tenant_id, account_id, skip_messages=None): + def send_late_entries(self, tenant_id, account_id, client_id, skip_messages=None): """Sendet gespeicherte Nachrichten (Code >= 1000) der letzten 8 Stunden. Es werden ausschließlich Nachrichten zugestellt, für die der Account - laut Protokoll berechtigt ist. Die Zustellung erfolgt chronologisch. + laut Protokoll berechtigt ist. Die Zustellung erfolgt chronologisch an + genau den Client, der sich gerade authentifiziert hat. Anschließend werden abgelaufene Nachrichten gelöscht. """ db = get_db() @@ -491,8 +597,8 @@ class WebSocketBroker: (tenant_id, cutoff) ).fetchall() - conn = self._get_connection(tenant_id, account_id) - if not conn: + conn = self._get_connection(tenant_id, client_id) + if not conn or conn.get('account_id') != account_id: return for msg_row in messages: @@ -508,7 +614,7 @@ class WebSocketBroker: ) if msg.to_json() in skip_messages: continue - self._send(tenant_id, account_id, msg) + self._send(tenant_id, client_id, msg) # Abgelaufene Nachrichten werden bei jeder Anmeldung aufgeräumt. self.cleanup_old_messages(tenant_id) @@ -590,14 +696,20 @@ class WebSocketBroker: # ------------------------------------------------------------------ # Nachrichtenverarbeitung # ------------------------------------------------------------------ - def route_message(self, tenant_id, message, apply_business=False): + def route_message(self, tenant_id, message, apply_business=False, client_id=None): """Wertet den Code aus, persistiert ggf. und stellt die Nachricht zu. ``apply_business`` wird nur für Nachrichten verwendet, die direkt über die WebSocket-Route eingehen. Serverintern erzeugte Nachrichten (z. B. aus der Admin-API) haben die Datenbank bereits aktualisiert und dürfen deshalb nicht ein zweites Mal angewendet werden. + + ``client_id`` ist die Verbindung, über die die Nachricht eingegangen + ist. Sie wird z. B. für den exakten Pong-Status der Webview benötigt. """ + if client_id: + message._sender_client_id = client_id + db = get_db() # Absender muss zum Mandanten gehören. Die Absender-ID wird in der @@ -638,7 +750,7 @@ class WebSocketBroker: # an Dispatcher-Views weitergeleitet und nicht gespeichert. Gleichzeitig # dient sie als Lebenszeichen der Gruppe. if code == 2: - self._record_client_pong(tenant_id, sender['id'], sender) + self._record_client_pong(tenant_id, sender['id'], sender, client_id) self._deliver(tenant_id, message, sender) return @@ -662,6 +774,22 @@ class WebSocketBroker: ) return + # Chat-Nachrichten dürfen nur von der jeweils vorgesehenen Rolle + # gesendet werden. Bei Code 2000 muss die Zielgruppe außerdem die + # eigene Gruppe des sendenden Accounts sein. + if code >= 1000: + allowed, reason = self._validate_chat_sender(tenant_id, message, sender) + if not allowed: + current_app.logger.warning( + 'WebSocket-Chatnachricht abgelehnt: code=%s sender=%s role=%s tenant=%s reason=%s', + code, sender['id'], sender['role'], tenant_id, reason + ) + self.log_incoming( + tenant_id, message, sender, recipients=[], + note=reason + ) + return + # Ab hier: fachliche Nachrichten (>= 100). # Zustandsänderungen, die ein Client per WebSocket meldet, werden vor # der Zustellung in der Datenbank persistiert. So sind sie auch nach @@ -681,8 +809,7 @@ class WebSocketBroker: message = self._prepare_message(tenant_id, message, sender) # Ab Code 1000 werden Nachrichten für die Late-Entry-Funktion - # gespeichert. Gespeichert wird die bereits aufbereitete Nachricht - # (bei Code 1100 inklusive Aliasname-Präfix). + # gespeichert. Gespeichert wird die bereits normalisierte Nachricht. if code >= 1000: self._persist_message(tenant_id, message) @@ -709,10 +836,10 @@ class WebSocketBroker: # ------------------------------------------------------------------ # Anwesenheit von Gruppen-Clients # ------------------------------------------------------------------ - def _record_client_pong(self, tenant_id, account_id, sender): + def _record_client_pong(self, tenant_id, account_id, sender, client_id=None): """Wertet ein Code-2-Lebenszeichen eines Clients aus.""" - conn = self._get_connection(tenant_id, account_id) - if conn: + conn = self._get_connection(tenant_id, client_id) if client_id else None + if conn and conn.get('account_id') == account_id: conn['last_pong_at'] = time.monotonic() if not sender or sender['role'] != 'Gruppe': @@ -1177,6 +1304,17 @@ class WebSocketBroker: except (TypeError, ValueError): message.receiver_id = group_id normalized['group_id'] = message.receiver_id + elif message.code == 2000: + # Auch Code 2000 muss die Zielgruppe explizit im Envelope und im + # Payload tragen. Sonst können weder Dispatcher-Ansichten noch + # Late Entries die Nachricht einer Gruppe zuordnen. + group_id = self._resolve_group_id(tenant_id, message, sender, payload) + if group_id is not None: + try: + message.receiver_id = int(group_id) + except (TypeError, ValueError): + message.receiver_id = group_id + normalized['group_id'] = message.receiver_id elif message.code == 1000: normalized['broadcast'] = True else: @@ -1186,68 +1324,82 @@ class WebSocketBroker: message.msg = json.dumps(normalized, ensure_ascii=False) return message - def _prepare_message(self, tenant_id, message, sender): - """Ergänzt Nachrichten um serverseitig abgeleitete Informationen.""" - db = get_db() - payload = self._payload(message) + def _validate_chat_sender(self, tenant_id, message, sender): + """Prüft Senderrolle und Gruppenzuordnung für Chat-Nachrichten.""" code = message.code + role = sender['role'] - if code >= 1000: - return self._normalize_chat_message(tenant_id, message, sender, payload) + if code in (1000, 1100): + if role != 'Dispatcher': + return False, f'Code {code} ist nur für Dispatcher erlaubt' + return True, None - if message.code == 1100: + if code == 2000: + if role != 'Gruppe': + return False, 'Code 2000 ist nur für Gruppen-Accounts erlaubt' + + payload = self._payload(message) group_id = self._resolve_group_id(tenant_id, message, sender, payload) - group = self._fetch_group(tenant_id, group_id) - message.receiver_id = group_id - if group: - alias = group['aliasname'] or str(group['id']) - prefix = f'{alias}: ' - text = message.msg if isinstance(message.msg, str) else json.dumps(message.msg) - if not text.startswith(prefix): - message.msg = prefix + text - return self._normalize_chat_message(tenant_id, message, sender, payload) + sender_group_id = self._get_sender_info(tenant_id, sender).get('group_id') + if group_id is None or sender_group_id is None: + return False, 'Gruppen-Account ist keiner Gruppe zugeordnet' - elif message.code == 2000: - group_id = self._resolve_group_id(tenant_id, message, sender, payload) - message.receiver_id = group_id - if isinstance(payload, dict): - if group_id and not payload.get('group_id'): - payload['group_id'] = group_id - message.msg = json.dumps(payload, ensure_ascii=False) - elif group_id: - message.msg = json.dumps( - {'group_id': group_id, 'text': message.msg}, - ensure_ascii=False - ) - return self._normalize_chat_message(tenant_id, message, sender, payload) + try: + if int(group_id) != int(sender_group_id): + return False, 'Code 2000 darf nur an die eigene Gruppe gesendet werden' + except (TypeError, ValueError): + return False, 'Ungültige Gruppen-ID für Code 2000' + return True, None + return True, None + + def _prepare_message(self, tenant_id, message, sender): + """Ergänzt Chat-Nachrichten um serverseitig abgeleitete Informationen.""" + if message.code >= 1000: + payload = self._payload(message) + return self._normalize_chat_message(tenant_id, message, sender, payload) return message def _deliver(self, tenant_id, message, sender): - """Stellt eine Nachricht an alle berechtigten, verbundenen Clients zu.""" + """Stellt eine Nachricht an alle berechtigten Clients zu.""" recipients = sorted(self._get_recipients(tenant_id, message, sender)) self.log_incoming(tenant_id, message, sender, recipients=recipients) - for recipient_id in recipients: - self._send(tenant_id, recipient_id, message) + for client_id in recipients: + self._send(tenant_id, client_id, message) - def _send(self, tenant_id, account_id, message): - """Sendet eine Nachricht oder puffert sie für die letzte Sitzung.""" + def _send(self, tenant_id, client_id, message): + """Sendet eine Nachricht an einen Client oder puffert sie für ihn.""" # Erst nach erfolgreicher Token-Authentifizierung dürfen Nachrichten # an einen Client zugestellt werden. - if not self.is_authenticated(tenant_id, account_id): - self._queue_undeliverable(tenant_id, account_id, message) + if not self.is_authenticated(tenant_id, client_id): + self._queue_undeliverable(tenant_id, client_id, message) return False - if self.send_to_connection(tenant_id, account_id, message.to_json()): + if self.send_to_connection(tenant_id, client_id, message.to_json()): return True - self._queue_undeliverable(tenant_id, account_id, message) + self._queue_undeliverable(tenant_id, client_id, message) return False + def _client_ids_for_accounts(self, tenant_id, account_ids): + """Expandiert Empfänger-Accounts auf alle bekannten Client-IDs.""" + client_ids = set() + for account_id in account_ids: + client_ids.update( + self.account_clients.get((tenant_id, account_id), ()) + ) + return client_ids + def _get_recipients(self, tenant_id, message, sender): - """Bestimmt den Empfängerkreis abhängig vom Nachrichtencode.""" + """Bestimmt den Empfängerkreis abhängig vom Nachrichtencode. + + Die fachliche Empfängerermittlung erfolgt weiterhin über Rollen und + Gruppen. Am Ende werden die gefundenen Accounts auf alle ihre bekannten + Clients expandiert, damit ein Account mehrere Webviews parallel + betreiben kann. + """ db = get_db() - recipients = set() + recipient_accounts = set() code = message.code payload = self._payload(message) @@ -1257,7 +1409,7 @@ class WebSocketBroker: f'SELECT id FROM accounts WHERE tenant_id = ? AND role IN ({placeholders})', (tenant_id, *roles) ).fetchall() - recipients.update(row['id'] for row in rows) + recipient_accounts.update(row['id'] for row in rows) def add_group_account(group_id): if not group_id: @@ -1267,10 +1419,10 @@ class WebSocketBroker: WHERE group_id = ? AND tenant_id = ?''', (group_id, tenant_id) ).fetchall() - recipients.update(row['account_id'] for row in rows) + recipient_accounts.update(row['account_id'] for row in rows) if code == 99: - # Alle verbundenen Clients des Mandanten müssen die Seite neu laden. + # Alle Clients des Mandanten müssen die Seite neu laden. add_accounts(('Gast', 'Beobachter', 'Gruppe', 'Dispatcher', 'Administrator')) elif code == 100: @@ -1329,7 +1481,7 @@ class WebSocketBroker: # Heartbeat-Antworten werden nur an Dispatcher-Views weitergegeben. add_accounts(('Dispatcher',)) - return recipients + return self._client_ids_for_accounts(tenant_id, recipient_accounts) def _persist_message(self, tenant_id, message): """Speichert Nachrichten mit Code >= 1000 für die Late-Entry-Funktion.""" diff --git a/CMBNet/cmbnet/ws/heartbeat.py b/CMBNet/cmbnet/ws/heartbeat.py index ecf1ba1..f12f020 100644 --- a/CMBNet/cmbnet/ws/heartbeat.py +++ b/CMBNet/cmbnet/ws/heartbeat.py @@ -71,16 +71,16 @@ class HeartbeatManager: # Nur authentifizierte Verbindungen erhalten einen Heartbeat. for tenant_id, connections in list(broker.connections.items()): - for account_id in list(connections): - if not broker.is_authenticated(tenant_id, account_id): + for client_id in list(connections): + if not broker.is_authenticated(tenant_id, client_id): continue - broker.send_to_connection(tenant_id, account_id, msg.to_json()) + broker.send_to_connection(tenant_id, client_id, msg.to_json()) - # Abgelaufene persistierte Nachrichten und Sitzungs-Queues löschen. + # Abgelaufene persistierte Nachrichten und Client-Queues löschen. if self.app is not None: try: with self.app.app_context(): - broker.cleanup_session_queues() + broker.cleanup_client_queues() broker.cleanup_old_messages() except Exception as exc: print(f'Heartbeat cleanup error: {exc}') diff --git a/CMBNet/cmbnet/ws/protocol.py b/CMBNet/cmbnet/ws/protocol.py index 72bbb55..4bef987 100644 --- a/CMBNet/cmbnet/ws/protocol.py +++ b/CMBNet/cmbnet/ws/protocol.py @@ -6,7 +6,7 @@ from datetime import datetime class WSMessage: - def __init__(self, sender_id=None, receiver_id=None, code=0, msg="", ts=None, session_id=None): + def __init__(self, sender_id=None, receiver_id=None, code=0, msg="", ts=None, client_id=None): self.sender_id = sender_id self.receiver_id = receiver_id self.code = code @@ -14,7 +14,7 @@ class WSMessage: self.ts = ts or int(datetime.now().timestamp() * 1000) # Nur für den Code-0-Handshake. Wird nicht an andere Clients # weitergegeben und deshalb auch nicht in to_dict() serialisiert. - self.session_id = session_id + self.client_id = client_id def to_dict(self): return { @@ -36,7 +36,9 @@ class WSMessage: code=data.get('code', 0), msg=data.get('msg', ''), ts=data.get('ts'), - session_id=data.get('session_id') + # Ältere Clients senden noch session_id. Sie werden übergangsweise + # als Client-ID akzeptiert. + client_id=data.get('client_id') or data.get('session_id') ) @classmethod diff --git a/CMBNet/cmbnet/ws/routes.py b/CMBNet/cmbnet/ws/routes.py index e638011..60049dc 100644 --- a/CMBNet/cmbnet/ws/routes.py +++ b/CMBNet/cmbnet/ws/routes.py @@ -3,8 +3,8 @@ WebSocket Routes Ablauf einer Verbindung: 1. Client verbindet sich mit //ws. -2. Client sendet Code 0 mit dem zuvor über die API geholten Einmal-Token - und seiner persistenten Sitzungs-ID. +2. Client sendet Code 0 mit dem zuvor über die API geholten Einmal-Token und + seiner Client-ID. Die Client-ID wird pro Webview erzeugt. 3. Erst nach erfolgreicher Prüfung dürfen fachliche Nachrichten gesendet werden. Vorher wird die Verbindung geschlossen. """ @@ -17,9 +17,16 @@ from cmbnet.ws.protocol import WSMessage def _parse_auth_payload(value): - """Liefert (Token, Sitzungs-ID) aus dem Code-0-Payload.""" + """Liefert (Token, Client-ID) aus dem Code-0-Payload. + + Ältere Clients senden statt ``client_id`` noch ``session_id``. Der + alte Schlüssel wird übergangsweise weiter akzeptiert. + """ if isinstance(value, dict): - return value.get('token'), value.get('session_id') + return ( + value.get('token'), + value.get('client_id') or value.get('session_id') + ) if isinstance(value, str): text = value.strip() @@ -29,7 +36,10 @@ def _parse_auth_payload(value): except (TypeError, ValueError): return None, None if isinstance(data, dict): - return data.get('token'), data.get('session_id') + return ( + data.get('token'), + data.get('client_id') or data.get('session_id') + ) return text, None return None, None @@ -52,10 +62,9 @@ def ws(ws, tenant): ws.close() return - # Verbindung registrieren, aber noch nicht als authentifiziert markieren. - if not broker.register_connection(tenant_id, account_id, ws): - ws.close() - return + # Die Verbindung wird erst mit dem Code-0-Handshake registriert. Vorher + # ist die Client-ID noch nicht bekannt. + client_id = None try: while True: @@ -74,43 +83,68 @@ def ws(ws, tenant): # Die Absender-ID stammt immer aus der Session und kann vom Client # nicht gefälscht werden. msg.sender_id = account_id + if client_id: + msg._sender_client_id = client_id - # Code 0: Authentifizierung über den Einmal-Token. + # Code 0: Authentifizierung über den Einmal-Token und Registrierung + # der Client-ID. if msg.code == 0: - token, session_id = _parse_auth_payload(msg.msg) - if not session_id: - session_id = getattr(msg, 'session_id', None) - if session_id: - msg.session_id = session_id - if not token or not broker.authenticate( - tenant_id, account_id, token, session_id - ): + if client_id: broker.log_incoming( - tenant_id, msg, recipients=[], - note='Code-0-Handshake fehlgeschlagen' - ) - current_app.logger.warning( - 'WebSocket-Authentifizierung fehlgeschlagen: tenant=%s account=%s', - tenant_id, account_id + tenant_id, msg, recipients=[client_id], + note='Code-0-Handshake nach bereits erfolgreicher Authentifizierung' ) ws.close() break + + token, requested_client_id = _parse_auth_payload(msg.msg) + if not requested_client_id: + requested_client_id = getattr(msg, 'client_id', None) + client_id = broker.normalize_client_id(requested_client_id, account_id) + msg.client_id = client_id + + if not token or not broker.register_connection( + tenant_id, account_id, client_id, ws + ): + broker.log_incoming( + tenant_id, msg, recipients=[], + note='Code-0-Registrierung fehlgeschlagen' + ) + current_app.logger.warning( + 'WebSocket-Registrierung fehlgeschlagen: tenant=%s account=%s client=%s', + tenant_id, account_id, client_id + ) + ws.close() + break + + if not broker.authenticate(tenant_id, account_id, client_id, token): + broker.log_incoming( + tenant_id, msg, recipients=[client_id], + note='Code-0-Handshake fehlgeschlagen' + ) + current_app.logger.warning( + 'WebSocket-Authentifizierung fehlgeschlagen: tenant=%s account=%s client=%s', + tenant_id, account_id, client_id + ) + ws.close() + break + broker.log_incoming( - tenant_id, msg, recipients=[account_id], + tenant_id, msg, recipients=[client_id], note='Code-0-Handshake erfolgreich' ) # Bestätigt dem Client den erfolgreichen Handshake. Erst jetzt # darf er gepufferte fachliche Nachrichten senden. broker.send_to_connection( tenant_id, - account_id, + client_id, WSMessage(sender_id=0, code=0, msg='authenticated').to_json() ) continue # Fachliche Nachrichten sind erst nach erfolgreicher # Authentifizierung erlaubt. - if not broker.is_authenticated(tenant_id, account_id): + if not client_id or not broker.is_authenticated(tenant_id, client_id): broker.log_incoming( tenant_id, msg, recipients=[], note='Nachricht vor Code-0-Authentifizierung' @@ -118,9 +152,12 @@ def ws(ws, tenant): ws.close() break - broker.route_message(tenant_id, msg, apply_business=True) + broker.route_message( + tenant_id, msg, apply_business=True, client_id=client_id + ) except Exception as exc: print(f'WebSocket error: {exc}') finally: - broker.remove_connection(tenant_id, account_id, ws) + if client_id: + broker.remove_connection(tenant_id, client_id, ws) diff --git a/CMBNet/config.py b/CMBNet/config.py index ec9282b..28fd221 100644 --- a/CMBNet/config.py +++ b/CMBNet/config.py @@ -19,11 +19,18 @@ class Config: WS_GROUP_ONLINE_TIMEOUT_SECONDS = int( os.environ.get('CMBNET_WS_GROUP_ONLINE_TIMEOUT_SECONDS', '120') ) - # Wie lange nicht zustellbare Nachrichten pro Client-Sitzung vorgehalten - # werden, bevor sie verworfen und durch einen Code-99-Hinweis ersetzt werden. + # Wie lange nicht zustellbare Nachrichten pro Client vorgehalten werden, + # bevor sie verworfen und durch einen Code-99-Hinweis ersetzt werden. WS_QUEUE_MAX_AGE_MINUTES = int( os.environ.get('CMBNET_WS_QUEUE_MAX_AGE_MINUTES', '15') ) + # Wie lange eine nicht mehr verbundene Webview samt Queue registriert + # bleibt, bevor sie vom Broker endgültig verworfen wird. Da die Client-ID + # bei jedem Neuladen neu erzeugt wird, verhindert dieser Wert, dass alte + # Webviews unbegrenzt Nachrichten ansammeln. + WS_CLIENT_RETENTION_MINUTES = int( + os.environ.get('CMBNET_WS_CLIENT_RETENTION_MINUTES', '60') + ) LATE_ENTRY_MAX_AGE_HOURS = int(os.environ.get('CMBNET_LATE_ENTRY_MAX_AGE_HOURS', '8')) # Ausführliche Broker-Debugausgabe für eingehende Nachrichten und den # ermittelten Empfängerkreis. Kann im Betrieb über die Umgebungsvariable diff --git a/CMBNet/static/js/reload_notice.js b/CMBNet/static/js/reload_notice.js index 3ad29a1..71d335a 100644 --- a/CMBNet/static/js/reload_notice.js +++ b/CMBNet/static/js/reload_notice.js @@ -128,7 +128,9 @@ ws.send(JSON.stringify({ code: 0, msg: data.token, - session_id: window.CMBNET_CLIENT_SESSION_ID || '' + client_id: window.CMBNET_CLIENT_ID + || window.CMBNET_CLIENT_SESSION_ID + || '' })); }); diff --git a/CMBNet/static/js/sw.js b/CMBNet/static/js/sw.js index 3717fd6..0461b24 100644 --- a/CMBNet/static/js/sw.js +++ b/CMBNet/static/js/sw.js @@ -5,7 +5,7 @@ * damit er sowohl die mobilen Views als auch die statischen Assets * kontrolliert. Der Cache-Name wird pro App-Wurzel gebildet. */ -const VERSION = 'cmbnet-pwa-v8'; +const VERSION = 'cmbnet-pwa-v9'; const BASE = new URL('./', self.location).href; const SHELL_CACHE = `${VERSION}-shell`; const TILE_CACHE = `${VERSION}-tiles`; diff --git a/CMBNet/static/js/views/admin_dashboard.js b/CMBNet/static/js/views/admin_dashboard.js index 67a1571..ef5fbe2 100644 --- a/CMBNet/static/js/views/admin_dashboard.js +++ b/CMBNet/static/js/views/admin_dashboard.js @@ -14,7 +14,7 @@ async function loadBrokerStatus() { if (!data.connections || data.connections.length === 0) { const row = document.createElement('tr'); const cell = document.createElement('td'); - cell.colSpan = 4; + cell.colSpan = 5; cell.textContent = 'Keine aktiven Verbindungen'; row.appendChild(cell); body.appendChild(row); @@ -22,6 +22,9 @@ async function loadBrokerStatus() { } for (const conn of data.connections) { const row = document.createElement('tr'); + const tdClient = document.createElement('td'); + tdClient.textContent = conn.client_id || '-'; + tdClient.title = conn.client_id || ''; const tdId = document.createElement('td'); tdId.textContent = conn.account_id; const tdName = document.createElement('td'); @@ -36,13 +39,13 @@ async function loadBrokerStatus() { } else { tdGroup.textContent = '-'; } - row.append(tdId, tdName, tdRole, tdGroup); + row.append(tdClient, tdId, tdName, tdRole, tdGroup); body.appendChild(row); } } catch (error) { console.error(error); const body = document.getElementById('brokerStatusBody'); - body.innerHTML = 'Fehler beim Laden'; + body.innerHTML = 'Fehler beim Laden'; } } diff --git a/CMBNet/static/js/views/dispatcher.js b/CMBNet/static/js/views/dispatcher.js index 3c34259..3a76ba3 100644 --- a/CMBNet/static/js/views/dispatcher.js +++ b/CMBNet/static/js/views/dispatcher.js @@ -2704,7 +2704,9 @@ async function connectWebSocket() { ws.send(JSON.stringify({ code: 0, msg: token, - session_id: window.CMBNET_CLIENT_SESSION_ID || '' + client_id: window.CMBNET_CLIENT_ID + || window.CMBNET_CLIENT_SESSION_ID + || '' })); dispatcherState.authenticated = true; setConnectionStatus('Verbunden', 'connected'); @@ -2928,7 +2930,10 @@ function handleStreetUpdate(message) { if (!street && payload.name) { street = dispatcherState.streets.find(item => item.name === payload.name); } - if (!street) return; + if (!street) { + console.warn('[WS] Code 100: Straße nicht im lokalen Zustand', payload); + return; + } if (STREET_STATES.includes(payload.state)) { street.state = payload.state; @@ -2951,7 +2956,10 @@ function handleGroupStateUpdate(message) { const payload = parsePayload(message.msg) || {}; const groupId = Number(payload.group_id ?? message.receiver_id); const group = dispatcherState.groupById.get(groupId); - if (!group) return; + if (!group) { + console.warn('[WS] Code 200: Gruppe nicht im lokalen Zustand', payload); + return; + } if (GROUP_STATES.includes(payload.state)) { group.state = payload.state; @@ -2963,7 +2971,10 @@ function handleGroupPositionUpdate(message) { const payload = parsePayload(message.msg) || {}; const groupId = Number(payload.group_id ?? message.receiver_id); const group = dispatcherState.groupById.get(groupId); - if (!group) return; + if (!group) { + console.warn('[WS] Code 300: Gruppe nicht im lokalen Zustand', payload); + return; + } const lat = Number(payload.lat); const lon = Number(payload.lon); diff --git a/CMBNet/static/js/views/mobile.js b/CMBNet/static/js/views/mobile.js index 959188d..07990df 100644 --- a/CMBNet/static/js/views/mobile.js +++ b/CMBNet/static/js/views/mobile.js @@ -1154,7 +1154,9 @@ function connectWebSocket() { ws.send(JSON.stringify({ code: 0, msg: token, - session_id: window.CMBNET_CLIENT_SESSION_ID || '' + client_id: window.CMBNET_CLIENT_ID + || window.CMBNET_CLIENT_SESSION_ID + || '' })); // Fallback für ältere Server, die noch keine Code-0-Bestätigung @@ -1326,7 +1328,9 @@ function parseFlexibleTimestamp(value) { function handleWs(event) { let message; try { message = JSON.parse(event.data); } catch(e) { return; } - + + console.debug('[WS RX]', message); + if (message.code === 0) { state.authenticated = true; flushWsOutbox(); @@ -1356,6 +1360,8 @@ function handleWs(event) { state.currentPolyline.setStyle({color: STREET_COLORS[street.state] || STREET_COLORS.unbearbeitet}); } buildStreetList(); + } else { + console.warn('[WS] Code 100: Straße nicht im lokalen Zustand', p); } } } catch(e) {} @@ -1365,12 +1371,17 @@ function handleWs(event) { const p = typeof message.msg === 'string' ? JSON.parse(message.msg) : message.msg; const gid = Number(p.group_id || message.receiver_id); const g = state.groupById.get(gid); - if (g && p.lat && p.lon) { - g.last_lat = p.lat; - g.last_lon = p.lon; + const lat = Number(p.lat); + const lon = Number(p.lon); + if (g && Number.isFinite(lat) && Number.isFinite(lon) + && p.lat !== null && p.lon !== null) { + g.last_lat = lat; + g.last_lon = lon; g.last_pos_ts = parseFlexibleTimestamp(p.ts) || Date.now(); g.last_pos_at = new Date(g.last_pos_ts).toISOString(); if (viewMode === 'mobile_dispatcher') showAllGroupPositions(); + } else if (!g) { + console.warn('[WS] Code 300: Gruppe nicht im lokalen Zustand', p); } } catch(e) {} } else if (message.code === 2000 || message.code === 1000 || message.code === 1100) { diff --git a/CMBNet/templates/admin/dashboard.html b/CMBNet/templates/admin/dashboard.html index 6dde38c..fe0249f 100644 --- a/CMBNet/templates/admin/dashboard.html +++ b/CMBNet/templates/admin/dashboard.html @@ -19,6 +19,7 @@ + @@ -26,7 +27,7 @@ - +
Client-ID Account-ID Account Rolle
Lade...
Lade...
diff --git a/CMBNet/templates/base.html b/CMBNet/templates/base.html index b6664e9..7a47c49 100644 --- a/CMBNet/templates/base.html +++ b/CMBNet/templates/base.html @@ -29,38 +29,26 @@ return clean ? base + '/' + clean : (base || '/'); }; - // Stabile ID pro Browser-Tab. Sie übersteht ein Neuladen und ordnet - // die WebSocket-Sitzung ihrer Nachrichten-Queue beim Broker zu. - (function initClientSessionId() { - const key = 'cmbnet:client-session:' + (window.CMBNET_TENANT || ''); - let sessionId = null; + // Jede Webview erhält beim Laden genau eine neue Client-ID. Sie wird + // bewusst nicht in sessionStorage gespeichert: Ein Neuladen erzeugt + // eine neue Webview und damit eine neue Broker-Verbindung. + (function initClientId() { + let clientId = null; - try { - sessionId = window.sessionStorage.getItem(key); - } catch (error) { - // sessionStorage kann in privaten Kontexten gesperrt sein. + if (window.crypto && typeof window.crypto.randomUUID === 'function') { + clientId = window.crypto.randomUUID(); + } else if (window.crypto && typeof window.crypto.getRandomValues === 'function') { + const bytes = new Uint8Array(16); + window.crypto.getRandomValues(bytes); + clientId = Array.from(bytes, value => value.toString(16).padStart(2, '0')).join(''); + } else { + clientId = 'client-' + Date.now().toString(36) + '-' + + Math.random().toString(36).slice(2, 12); } - if (!sessionId) { - if (window.crypto && typeof window.crypto.randomUUID === 'function') { - sessionId = window.crypto.randomUUID(); - } else if (window.crypto && typeof window.crypto.getRandomValues === 'function') { - const bytes = new Uint8Array(16); - window.crypto.getRandomValues(bytes); - sessionId = Array.from(bytes, value => value.toString(16).padStart(2, '0')).join(''); - } else { - sessionId = 'sess-' + Date.now().toString(36) + '-' + - Math.random().toString(36).slice(2, 12); - } - - try { - window.sessionStorage.setItem(key, sessionId); - } catch (error) { - // Dann gilt die ID nur für den aktuellen Seitenaufruf. - } - } - - window.CMBNET_CLIENT_SESSION_ID = sessionId; + window.CMBNET_CLIENT_ID = clientId; + // Übergangsweise für noch gecachte ältere Skripte. + window.CMBNET_CLIENT_SESSION_ID = clientId; })(); diff --git a/doc/Websocket und Caddy.pdf b/doc/Websocket und Caddy.pdf new file mode 100644 index 0000000000000000000000000000000000000000..f0024789ecbae8150d0c0f4f1488b7a4f1079a25 GIT binary patch literal 77968 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⋙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 z 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 Nz!$HwGSS?C_wOR*D2f08 literal 0 HcmV?d00001 diff --git a/doc/broker.md b/doc/broker.md index c2d125b..fb62c01 100644 --- a/doc/broker.md +++ b/doc/broker.md @@ -1,6 +1,6 @@ # Broker und WebSocket-Protokoll -Stand: 31.10.2026 +Stand: 01.11.2026 Dieses Dokument beschreibt das aktuelle WebSocket-Protokoll, die Aufgaben und den Ablauf des Brokers sowie die Stellen, an denen die Implementierung von der @@ -22,7 +22,7 @@ WebSocket-Clients eines Mandanten. Er - ordnet Nachrichten anhand ihres Codes einem Empfängerkreis zu, - wendet fachliche Zustandsänderungen für Straßen und Gruppen an, - persistiert Chat-Nachrichten für die spätere Nachlieferung, -- puffert nicht zustellbare Nachrichten pro Client-Sitzung, +- puffert nicht zustellbare Nachrichten pro Client-ID, - überwacht die Lebenszeichen der Gruppen. Die Web-APIs liefern den Clients unabhängig vom Broker den aktuellen @@ -30,7 +30,7 @@ Initialzustand. Der Broker ist damit nicht die einzige Quelle für den Zustand, sondern verteilt Änderungen und gleicht kurzfristige Verbindungsunterbrechungen aus. -## 2. Transport, Authentifizierung und Sitzung +## 2. Transport, Authentifizierung und Client-ID ### Endpoint @@ -57,7 +57,7 @@ Nach dem Öffnen der WebSocket-Verbindung sendet der Client Code 0: { "code": 0, "msg": "", - "session_id": "" + "client_id": "" } ``` @@ -65,22 +65,29 @@ Das Token wird vorher über `GET //api/auth/ws-token` geholt. Es ist mandanten- und accountgebunden, nur einmal verwendbar und standardmäßig eine Stunde gültig. -Die `session_id` wird pro Browser-Tab in `sessionStorage` erzeugt und bleibt -über ein Neuladen der Seite erhalten. Sie ordnet die Verbindung einer -Nachrichten-Queue zu. +Die `client_id` wird in `templates/base.html` bei jedem Laden einer Webview +einmalig erzeugt. Sie wird bewusst **nicht** in `sessionStorage` gespeichert: +Ein Neuladen erzeugt eine neue Webview und damit eine neue Broker-Verbindung. +Die Client-ID ist an den Account gebunden, der den Code-0-Handshake ausführt. +Mehrere Clients desselben Accounts erhalten getrennte Verbindungen und Queues. -Der Broker akzeptiert aus Kompatibilitätsgründen auch die ältere Objektform: +Der Broker akzeptiert aus Kompatibilitätsgründen auch die ältere Objektform und +den alten Schlüssel `session_id`: ```json { "code": 0, "msg": { "token": "", - "session_id": "" + "session_id": "" } } ``` +Fehlt eine gültige Client-ID vollständig, erzeugt der Broker eine eindeutige +Ersatz-ID (`legacy--`). Ein solcher Altclient kann nach einem +Reconnect keine frühere Queue wiedererkennen. + Nach erfolgreicher Prüfung antwortet der Server mit einer Code-0-Bestätigung: ```json @@ -155,10 +162,13 @@ fachliche Empfänger weitergeleitet. Der Broker prüft: 1. Existiert das Token für Mandant und Account? 2. Ist es noch nicht verwendet? 3. Ist es nicht abgelaufen? +4. Ist die Client-ID gültig und noch keinem anderen Account zugeordnet? -Danach wird das Token als verbraucht markiert, die Sitzungs-ID normalisiert und -der Account als authentifiziert registriert. Ohne gültigen Code 0 werden -fachliche Nachrichten nicht akzeptiert; die Verbindung wird geschlossen. +Danach wird das Token als verbraucht markiert, die Client-ID normalisiert und +die Verbindung als authentifiziert registriert. Ohne gültigen Code 0 werden +fachliche Nachrichten nicht akzeptiert; die Verbindung wird geschlossen. Da die +Registrierung erst mit Code 0 erfolgt, kennt der Broker vor dem Handshake noch +keine Client-ID. ### Code 1: Heartbeat @@ -170,7 +180,7 @@ authentifizierten Verbindungen: ``` Die Heartbeat-Routine läuft in einem Daemon-Timer. Sie räumt zusätzlich -abgelaufene Chat-Nachrichten und Sitzungs-Queues auf. +abgelaufene Chat-Nachrichten und Client-Queues auf. ### Code 2: Pong / Lebenszeichen @@ -211,13 +221,14 @@ Admin- und Dispatcher-Clients als mögliche Sender; diese lösen Code 99 aktuell Queue-Verhalten: -- Ist ein Client nicht erreichbar, wird Code 99 in seiner Sitzungs-Queue +- Ist ein Client nicht erreichbar, wird Code 99 in seiner Client-Queue gespeichert. - Eine gespeicherte Code-99-Nachricht leert alle älteren Queue-Nachrichten. - Danach werden keine weiteren Nachrichten in dieser Queue gepuffert (`code99_only`). -- Beim nächsten Reconnect wird ausschließlich diese Code-99-Nachricht - zugestellt. Late Entries werden in diesem Fall unterdrückt. +- Beim nächsten Reconnect mit derselben Client-ID wird ausschließlich diese + Code-99-Nachricht zugestellt. Late Entries werden in diesem Fall + unterdrückt. - Ist die Queue wegen Überschreitung der Maximalzeit abgelaufen, erzeugt der Broker eine Code-99-Nachricht mit Hinweis auf die zu lange Unterbrechung. @@ -298,19 +309,23 @@ die Nachricht als „Von -> An“ mit Zeitstempel und Text an. ### Code 1000: Broadcast Soll-Sender: Dispatcher. Empfänger: alle Dispatcher, Beobachter und alle -Gruppen. Die aktuelle Implementierung prüft die Senderrolle nicht. +Gruppen. Der Broker akzeptiert Code 1000 nur von Accounts mit der Rolle +`Dispatcher`; andere Rollen werden mit einer Warnung und einem Debug-Eintrag +abgewiesen. ### Code 1100: Nachricht an eine Gruppe Soll-Sender: Dispatcher. Empfänger: alle Dispatcher, Beobachter und die adressierte Gruppe. Der Broker ermittelt die Gruppen-ID aus `group_id`, -`receiver_id` oder dem Absender. Die aktuelle Implementierung prüft die -Senderrolle nicht. +`receiver_id` oder dem Absender und akzeptiert Code 1100 nur von Accounts mit +der Rolle `Dispatcher`. ### Code 2000: Nachricht aus einer Gruppe Soll-Sender: Gruppen-Account. Empfänger: alle Dispatcher, Beobachter und die -eigene Gruppe. Die aktuelle Implementierung prüft die Senderrolle nicht. +eigene Gruppe. Der Broker akzeptiert Code 2000 nur von Accounts mit der Rolle +`Gruppe`. Zusätzlich muss die aufgelöste Zielgruppe die eigene Gruppe des +Absenders sein; Nachrichten an eine fremde Gruppe werden abgewiesen. ## 7. Broker-Ablauf @@ -319,19 +334,30 @@ eigene Gruppe. Die aktuelle Implementierung prüft die Senderrolle nicht. `WebSocketBroker.connections` ist ein verschachteltes Dictionary: ```text -connections[tenant_id][account_id] = { - ws, role, group_id, session_id, +connections[tenant_id][client_id] = { + ws, account_id, client_id, role, group_id, last_ping, connected_at, last_pong_at, send_lock } ``` -Pro Account wird derzeit genau eine Verbindung gespeichert. Eine neue -Verbindung desselben Accounts überschreibt die alte Registrierung. +Eine Client-ID gehört genau zu einer Webview. Ein Account kann daher mehrere +Clients parallel betreiben. Eine neue Verbindung mit derselben Client-ID ersetzt +nur diese eine Verbindung; andere Clients desselben Accounts bleiben erhalten. -`authenticated[tenant_id][account_id]` speichert den Authentifizierungsstatus. +`authenticated[tenant_id][client_id]` speichert den Authentifizierungsstatus. Ohne erfolgreichen Code-0-Handshake werden keine fachlichen Nachrichten zugestellt. +Zusätzlich hält der Broker: + +- `client_accounts[(tenant_id, client_id)] = account_id`, +- `account_clients[(tenant_id, account_id)] = {client_id, ...}`, +- `disconnected_clients[(tenant_id, client_id)] = Zeitpunkt`. + +Diese Zuordnungen bleiben nach einem Verbindungsabbruch erhalten, damit +kurzfristige Reconnects ihre Queue wiederfinden. Dauerhaft verlassene Webviews +werden nach `WS_CLIENT_RETENTION_MINUTES` (Default 60 Minuten) aufgeräumt. + ### Empfängerermittlung `_get_recipients()` entscheidet anhand des Codes und der Absenderrolle: @@ -344,33 +370,36 @@ zugestellt. - Code 2000: Dispatcher, Beobachter und die eigene Gruppe, - Code 2: nur Dispatcher. -Die Empfänger werden als Account-IDs ermittelt. Gruppen-Accounts werden über -`group_accounts` aufgelöst. +Die fachlichen Empfänger werden weiterhin als Account-IDs ermittelt. +Gruppen-Accounts werden über `group_accounts` aufgelöst. Anschließend expandiert +`_client_ids_for_accounts()` jeden Empfänger-Account auf alle seine bekannten +Client-IDs. Damit erhalten auch mehrere Tabs/Webviews desselben Accounts die +Nachricht. ### Zustellung -`_deliver()` sendet die Nachricht an jeden ermittelten Empfänger. `_send()` -prüft zuerst die Authentifizierung: +`_deliver()` sendet die Nachricht an jeden ermittelten Client. `_send()` prüft +zuerst die Authentifizierung: - authentifiziert und Verbindung vorhanden: direkter Versand, - nicht authentifiziert oder Versand fehlgeschlagen: Eintrag in die - Sitzungs-Queue, sofern eine Sitzungs-ID bekannt ist. + Client-Queue, sofern die Client-ID bekannt ist. Der direkte Versand erfolgt pro Verbindung über einen `send_lock`. Dadurch werden Heartbeat, Route-Thread und HTTP-ausgelöste Broadcasts nicht gleichzeitig in denselben Socket schreiben. -### Sitzungs-Queues +### Client-Queues Queues werden unter dem Schlüssel ```text -(tenant_id, account_id, session_id) +(tenant_id, client_id) ``` -gespeichert. Die zuletzt bekannte Session-ID wird zusätzlich in -`account_sessions` gehalten, damit Nachrichten auch ohne aktive Verbindung der -richtigen Queue zugeordnet werden können. +gespeichert. Die Account-Zuordnung liegt in `client_accounts`. Sie bleibt auch +ohne aktive Verbindung bestehen, damit weitere Nachrichten für dieselbe Webview +gepuffert werden können. Eigenschaften: @@ -381,22 +410,28 @@ Eigenschaften: Verbindungsabbruch, - abgelaufene Queues werden geleert und als „Tombstone“ für den Code-99-Hinweis behalten, +- dauerhaft getrennte Clients werden nach `WS_CLIENT_RETENTION_MINUTES` + (Default 60 Minuten) samt Queue und Zuordnung entfernt, - Queues liegen ausschließlich im Arbeitsspeicher und überleben keinen Serverneustart, - es gibt derzeit keine feste Obergrenze für die Anzahl gepufferter Nachrichten. +Da die Client-ID bei jedem Neuladen neu erzeugt wird, erbt eine neu geladene +Webview keine Nachrichten-Queue der vorherigen Seite. Nicht persistierte +Code-100/200/300-Ereignisse werden in diesem Fall über den neu geladenen +Initialzustand abgedeckt; persistierte Chat-Nachrichten kommen als Late Entries. + ### Late Entries Nach erfolgreicher Authentifizierung sendet der Broker persistierte Chat-Nachrichten der letzten acht Stunden, für die der Account berechtigt ist. -Bereits aus der Sitzungs-Queue zugestellte Nachrichten werden dabei -übersprungen. +Bereits aus der Client-Queue zugestellte Nachrichten werden dabei übersprungen. Die aktuelle Implementierung sendet Late Entries bei **jeder** erfolgreichen -Authentifizierung, also auch bei einer bereits bekannten Sitzung. Die -Soll-Beschreibung sieht eine initiale Historiennachlieferung für neue -Websessions vor. Das kann bei Reconnects zu zusätzlichen Wiederholungen führen. +Authentifizierung. Bei einem Reconnect mit derselben Client-ID können dadurch +Nachrichten erneut ankommen, die bereits live zugestellt wurden. Bei einer neu +geladenen Webview mit neuer Client-ID ist die Nachlieferung dagegen gewollt. ### Heartbeat und Gruppenpräsenz @@ -408,28 +443,29 @@ prüft alle 15 Sekunden die Gruppenpräsenz. Bei fehlendem Pong wird eine Berücksichtigt sind: -- `queue_lock` schützt `session_queues` und die Queue-Übergänge. +- `queue_lock` schützt `client_queues` und die Queue-Übergänge. - `send_lock` pro Verbindung serialisiert alle ausgehenden Frames. - Timer laufen als Daemon-Threads. - SQLite-Zugriffe erfolgen pro Thread über die Flask-App-Kontexte. Nicht vollständig abgesichert sind: -- `connections` und `authenticated` werden ohne eigenen Lock gelesen und - geschrieben. Einzelne Dictionary-Operationen sind durch den GIL atomar, - zusammengesetzte Prüfungen und Ersetzungen sind es nicht. -- Eine neue Verbindung für denselben Account ersetzt die alte Registrierung, - ohne den alten Socket aktiv zu schließen. Der alte Socket kann bis zum - Client-seitigen Schließen weiter existieren; seine Route verwendet aber den - Account-Kontext der neuen Verbindung. -- `account_sessions`, `group_last_pong` und `group_online_since` werden ohne - eigenen Lock aktualisiert. +- `connections`, `authenticated`, `client_accounts` und `account_clients` + werden ohne eigenen Lock gelesen und geschrieben. Einzelne + Dictionary-Operationen sind durch den GIL atomar, zusammengesetzte Prüfungen + und Ersetzungen sind es nicht. +- Eine neue Verbindung mit derselben Client-ID ersetzt die alte Registrierung. + Der alte Socket wird dabei aktiv geschlossen; seine Route entfernt über den + `ws`-Vergleich nicht die neue Verbindung. +- `group_last_pong` und `group_online_since` werden ohne eigenen Lock + aktualisiert. - Zwischen Auth-Prüfung und tatsächlichem Senden kann eine Verbindung ersetzt werden. Dann kann eine Nachricht an die neue Verbindung gehen oder in der Queue landen. - Der Broker ist prozesslokal. Bei mehreren WSGI-Workern hat jeder Worker eigene Verbindungen und Queues. Eine HTTP-ausgelöste Benachrichtigung kann nur die Verbindungen des Workers erreichen, der den HTTP-Request bearbeitet. + Das ist die wichtigste verbleibende Einschränkung für den Mehrclient-Betrieb. ## 9. Debugausgabe @@ -465,19 +501,19 @@ tail -f CMBNet/logs/cmbnet-ws-$(date +%F).log Jede eingehende Nachricht wird mit folgenden Feldern protokolliert: - `code` -- `sender` mit Account-ID, Name, Rolle, Gruppen-ID und Gruppenalias +- `sender` mit Account-ID, Client-ID, Name, Rolle, Gruppen-ID und Gruppenalias - `receiver_id` -- `session_id` +- `client_id` der Absender-Webview - `ts` - `msg` (bei Code 0 redigiert) -- `recipients`: ermittelte Empfänger mit Name, Rolle, Gruppe, - `connected` und `authenticated` +- `recipients`: ermittelte Clients mit Client-ID, Account-ID, Name, Rolle, + Gruppe, `connected` und `authenticated` - `note`: Grund, falls die Nachricht ignoriert oder abgelehnt wurde Beispielzeile (gekürzt): ```text -2026-10-31 13:31:47.247 [TENANT:1] WS-IN {"code": 100, "sender": {"account_id": 10, "account_name": "gruppe", "role": "Gruppe", "group_id": 20, "group_alias": "G1"}, "receiver_id": null, "session_id": null, "ts": 1793449907246, "msg": "{\"name\": \"Weg\", \"state\": \"erledigt\", \"actor\": 10, \"street_id\": 30, \"group_id\": 20}", "recipients": [{"account_id": 10, "account_name": "gruppe", "role": "Gruppe", "group_id": 20, "group_alias": "G1", "connected": true, "authenticated": true}, {"account_id": 11, "account_name": "dispatcher", "role": "Dispatcher", "group_id": null, "group_alias": null, "connected": true, "authenticated": true}], "note": null} +2026-11-01 10:03:55.247 [TENANT:1] WS-IN {"code": 100, "sender": {"account_id": 10, "account_name": "gruppe", "role": "Gruppe", "group_id": 20, "group_alias": "G1", "client_id": "group-page-1"}, "receiver_id": null, "client_id": "group-page-1", "ts": 1793449907246, "msg": "{\"name\": \"Weg\", \"state\": \"erledigt\", \"actor\": 10, \"street_id\": 30, \"group_id\": 20}", "recipients": [{"client_id": "disp-page-1", "account_id": 11, "account_name": "dispatcher", "role": "Dispatcher", "group_id": null, "group_alias": null, "connected": true, "authenticated": true}, {"client_id": "group-page-1", "account_id": 10, "account_name": "gruppe", "role": "Gruppe", "group_id": 20, "group_alias": "G1", "connected": true, "authenticated": true}], "note": null} ``` Die Debugausgabe dokumentiert den **Soll-Empfängerkreis**. Ob der einzelne @@ -486,9 +522,9 @@ Versand tatsächlich erfolgreich war, ergibt sich erst aus dem anschließenden ## 10. Abweichungen zwischen Soll-Beschreibung und aktuellem Code -Die folgenden Punkte sind bei einer Weiterentwicklung zu beachten. Sie sind -bewusst als Ist-Zustand dokumentiert und nicht alle in diesem Schritt -funktional geändert. +Die folgenden Punkte sind bei einer Weiterentwicklung zu beachten. Mit +„behoben“ markierte Punkte beschreiben den korrigierten Stand; die übrigen +Punkte sind weiterhin offen. ### 10.1 Code 2 erreicht den Admin nicht @@ -514,49 +550,39 @@ erfolgt ausschließlich serverseitig über `notify_reload()` aus HTTP-Handlern. Das Ergebnis ist für die Clients identisch, der Übertragungsweg weicht aber von der Beschreibung ab. -### 10.4 Keine Rollenprüfung bei Chat-Codes +### 10.4 Rollenprüfung bei Chat-Codes (behoben) Soll: - Code 1000 und 1100: nur Dispatcher, - Code 2000: nur Gruppen-Account. -Ist: Jeder authentifizierte Account kann Code 1000, 1100 oder 2000 senden. Die -Empfängerermittlung ist korrekt, aber die Senderrolle wird nicht geprüft. +Der Broker prüft die Senderrolle jetzt in `_validate_chat_sender()`. Bei Code +2000 wird zusätzlich kontrolliert, dass die aufgelöste Zielgruppe die eigene +Gruppe des Absenders ist. Unberechtigte Nachrichten werden vor der Persistenz +und Zustellung mit einer Warnung und einem Debug-Eintrag abgewiesen. -### 10.5 Code 2000 verliert Gruppen-ID und Empfänger-ID +### 10.5 Code-2000-Normalisierung (behoben) -In `_prepare_message()` werden Nachrichten ab Code 1000 vorzeitig an -`_normalize_chat_message()` übergeben. Die anschließenden Zweige für Code 1100 -und 2000 sind dadurch nicht erreichbar. +`_normalize_chat_message()` setzt für Code 2000 jetzt sowohl +`message.receiver_id` als auch `group_id` im normalisierten Payload. Dadurch +können Dispatcher-Ansichten die Nachricht der Gruppe zuordnen, und Late Entries +werden nach einem Reconnect wieder an die eigene Gruppe zugestellt. -Folge für Code 2000: +Weiterhin offen ist die clientseitige Anzeige: -- `message.receiver_id` bleibt `null`. -- Das normalisierte Payload enthält kein `group_id`. -- Die Live-Zustellung an die Gruppe funktioniert nur, weil - `_resolve_group_id()` als Fallback die Gruppe des Absenders verwendet. -- Die Late-Entry-Prüfung `_is_allowed_for_client()` findet bei gespeicherten - Code-2000-Nachrichten weder `group_id` noch `receiver_id` und liefert für - Gruppen-Clients `False`. Code-2000-Nachrichten werden damit nach einem - Reconnect nicht als Late Entry an die eigene Gruppe nachgeliefert. -- Der Dispatcher-Client kann die Gruppenzuordnung nicht aus dem normalisierten - Payload lesen. `handleGroupChatMessage()` in - `static/js/views/dispatcher.js` ermittelt die Gruppe aus `payload.group_id` - oder `message.receiver_id`; beide fehlen, deshalb wird die Nachricht dort - verworfen. - In der Dispatcher-Ansicht wird Code 2000 nicht als Infodialog angezeigt. - Im Beobachter-Modus (`CMBNET_VIEW_MODE === 'observer'`) wird Code 2000 vollständig ignoriert, obwohl Beobachter zum Empfängerkreis gehören. -- Der mobile Gruppen-Client zeigt die Nachricht an, weil sein Filter eine - fehlende Gruppen-ID als „eigene Gruppe“ behandelt. Die Anzeige „An“ kann - dabei jedoch leer bleiben. +- Der mobile Gruppen-Client zeigt die Nachricht an; die neue `group_id` dient + dort der Filterung, während „An“ für Code 2000 weiterhin fest „Dispatcher“ + lautet. -### 10.6 Code 1100: Alias-Präfix ist toter Code +### 10.6 Code 1100: Alias-Präfix wird nicht angewendet -Der Code-1100-Zweig in `_prepare_message()` ist wegen des vorzeitigen -`code >= 1000`-Returns nicht erreichbar. Der dort vorgesehene Alias-Präfix -(`": "`) wird daher nicht angewendet. Der Alias ist weiterhin im +Der frühere Code-1100-Zweig in `_prepare_message()` war wegen des vorzeitigen +`code >= 1000`-Returns nicht erreichbar und wurde entfernt. Ein Alias-Präfix +(`": "`) wird daher weiterhin nicht gesetzt. Der Alias ist im normalisierten `sender`-Objekt enthalten. ### 10.7 Fehlende Namen bei Code 100/200/300 @@ -578,11 +604,11 @@ sollte der Broker den Zeitstempel auch für diese Codes setzen. ### 10.9 Late Entries bei jedem Reconnect `authenticate()` ruft `send_late_entries()` bei jeder erfolgreichen -Authentifizierung auf. Bei einer bereits bekannten Sitzung werden damit +Authentifizierung auf. Bei einem Reconnect mit derselben Client-ID werden damit persistierte Chat-Nachrichten erneut gesendet, auch wenn sie vor dem Verbindungsabbruch schon live zugestellt wurden. Die Clients haben teilweise eigene Deduplizierungsschlüssel, die das abfangen; der Broker selbst -unterscheidet nicht zwischen „neue Sitzung“ und „bekannte Sitzung“. +unterscheidet nicht zwischen „bekannte Client-ID“ und „neue Client-ID“. ### 10.10 Queue-Alter und Queue-Länge @@ -591,13 +617,13 @@ Verbindungsabbruch, kann aber bei einer Queue, die erst durch eine nicht zustellbare Nachricht entsteht, etwas später liegen. Es gibt keine Obergrenze für die Anzahl oder den Speicherbedarf der gepufferten Nachrichten. -### 10.11 Nur eine Verbindung pro Account +### 10.11 Mehrere Verbindungen pro Account (behoben) -`connections[tenant_id][account_id]` enthält genau eine Verbindung. Öffnet -derselbe Account mehrere Tabs, überschreibt der neue Tab die Registrierung. -Der alte Socket wird nicht aktiv geschlossen. Die Sitzungs-Queue ist zwar pro -Tab, aber die Verbindungsverwaltung und `account_sessions` kennen nur die -zuletzt registrierte Sitzung. +`connections[tenant_id][client_id]` enthält genau eine Client-Verbindung. +Mehrere Tabs bzw. Webviews desselben Accounts besitzen unterschiedliche +Client-IDs und damit getrennte Verbindungen und Queues. Eine neue Verbindung +mit derselben Client-ID ersetzt nur diese eine Verbindung; der alte Socket wird +dabei aktiv geschlossen. ### 10.12 Prozesslokaler Broker @@ -615,12 +641,13 @@ nutzt dies intern, um nach bereits erfolgter DB-Änderung ein Code-100/200-Event zu verteilen. Ein direkter WebSocket-Frame eines Administrators wird ebenfalls akzeptiert. -### 10.14 Queues nur bei bekannter Sitzung +### 10.14 Queues nur bei bekannter Client-ID -`_queue_undeliverable()` benötigt eine bekannte Sitzungs-ID in -`account_sessions`. War ein Account in diesem Broker-Prozess noch nie -authentifiziert, wird eine nicht zustellbare Nachricht nicht gepuffert. Nach -einem Serverneustart sind alle Sitzungszuordnungen leer. +`_queue_undeliverable()` benötigt eine dem Broker bekannte Client-ID in +`client_accounts`. Vor dem Code-0-Handshake und nach einem Serverneustart sind +keine Client-Zuordnungen vorhanden; Nachrichten werden dann nicht gepuffert. +Eine neu geladene Webview erhält stattdessen den aktuellen Initialzustand und +die persistierten Late Entries. ### 10.15 Broadcasts ohne Empfänger-ID @@ -639,18 +666,16 @@ erfolgt. ## 11. Empfohlene nächste Schritte -1. Code-2000-Normalisierung korrigieren: `receiver_id` und `group_id` vor dem - Normalisieren setzen und in das gespeicherte Payload aufnehmen. Danach die - Dispatcher- und Beobachter-Anzeige für Code 2000 prüfen. -2. Rollenprüfung für Code 1000/1100/2000 ergänzen. -3. Late Entries nur für neue Sitzungen oder mit einem serverseitigen +1. Late Entries nur für neue Client-IDs oder mit einem serverseitigen „zuletzt gesehen“-Zeitpunkt senden. -4. Code 2 zusätzlich an Administratoren verteilen oder einen separaten +2. Code 2 zusätzlich an Administratoren verteilen oder einen separaten Status-Endpoint für Pong-Überfälligkeit bereitstellen. -5. Zeitstempel für Code 100/200 und Chat-Nachrichten serverseitig setzen. -6. Verbindungsverwaltung für mehrere Tabs oder explizites Schließen der alten - Verbindung absichern. -7. Queue-Länge begrenzen und Queue-Verhalten bei mehreren Workern klären. +3. Zeitstempel für Code 100/200 und Chat-Nachrichten serverseitig setzen. +4. Queue-Länge begrenzen und Queue-Verhalten bei mehreren Workern klären. +5. Code 2000 im Beobachter-Modus und als Infodialog anzeigen. +6. Den prozesslokalen Broker durch einen gemeinsamen Message-Bus oder einen + einzelnen WebSocket-Worker ersetzen, falls mehrere WSGI-Worker betrieben + werden. ## 12. Debugausgabe und Tests @@ -664,4 +689,7 @@ eine Zeile erzeugt. Damit lässt sich nachvollziehen, ob eine Nachricht - und ob der Empfänger verbunden und authentifiziert war. Für automatisierte Tests können `WS_DEBUG_MESSAGES=0` gesetzt und die -bestehenden Queue- und WebSocket-E2E-Tests verwendet werden. +bestehenden Queue- und WebSocket-E2E-Tests verwendet werden. Die Tests decken +insbesondere zwei Clients desselben Accounts, die getrennte Zustellung von +Code 100/300, Reconnect mit derselben Client-ID sowie eine neue Client-ID nach +einem Reload ab. diff --git a/doc/prompt.txt b/doc/prompt.txt index 83e246e..5ede961 100644 --- a/doc/prompt.txt +++ b/doc/prompt.txt @@ -239,3 +239,14 @@ Erläutere, an welchen Stellen die Beschreibung vom aktuellen Code-Stand abweich Bau in die Software eine Debugausgabe für die beim Broker eingehenden Nachrichten ein einschließlich einer Ausgabe, an welche Clients diese weitergeleitet werden soll. ------8<----------------- + +Aktuell verwaltet der Broker die Verbindungen anhand des Mandanten und des Accounts. +Künftig soll der Broker Verbindungen statt anhand von Accounts anhand der Client-ID verwalten. +Ziel soll sein, dass ein Account auch mehrere Clients betreiben kann. +Dazu muss der Broker selbst umgebaut werden. +Die Client-ID wird in jedem Webview einmalig nach dem Laden generiert. Deshalb muss sie auch nicht im SessionStorage gespeichert werden. +Ich sehe jetzt, dass beispielsweise Code-300 Nachrichten vom Gruppen-Client an den Broker geschickt werden, sie aktualisieren aber nicht die Karte oder sonst ein Element im User Interface. +Gleiches gilt auch für Code-100. Werden diese Nachrichten nicht über den Broker an die anderen Cleints weitergeleitet? +Oder werden sie im Client verworfen? + +------8<-----------------