n8n-Zugang ueber lokalen SSH-Tunnel wiederherstellen und dokumentieren [skip ci]

This commit is contained in:
Lars committed 2026-10-27 20:52:38 +01:00
1 parent f80c0f9f3b
commit 4186872b3f
2 files changed
+18 -2

No files matched your search

+15 -1
View File
@@ -90,11 +90,25 @@ ## 6. Erledigt / offen im Testbetrieb
- **E-Mail im Testbetrieb** einschalten (§5a): Versandweg SMTP + Passwort; Betriebsart steht auf Testbetrieb mit Testadresse lars@stommer.com.
- **Scheduler-Auslöser:** Lars hat am 27.10.2026 im Strato-Kundenbereich als kleinstes Intervall stündliche Ausführung festgestellt. Das genügt nicht für den vorgesehenen Kalenderimport alle fünf Minuten. Deshalb ist ein externer minütlicher Aufruf vorgesehen; kein zusätzlicher stündlicher Strato-Scheduler für dieselbe Instanz.
Auf dem bestehenden Pi läuft n8n **2.7.5**. Die 29 vorhandenen Workflows wurden auf einen bereits vorhandenen FewoPortal-/stommer.info-Aufruf geprüft; keiner gefunden. Die tokenfreie Vorlage [scripts/n8n-fewo-scheduler.json](../scripts/n8n-fewo-scheduler.json) ist gegen die installierten Schedule- und HTTP-Node-Schemata geprüft. Sie ruft jede volle Minute `https://stommer.info/automation/scheduler` auf. Laravel führt die jeweils fälligen Aufgaben aus, einschließlich aktiver Kalenderimporte alle fünf Minuten; auch die anderen in `routes/console.php` definierten Aufgaben werden dadurch zeitgesteuert ausgeführt.
Der Header `Authorization: Bearer <FEWO_SCHEDULER_TOKEN>` liegt nach ausdrücklicher Freigabe in der verschlüsselten n8n-Zugangsdatenverbindung **FewoPortal Scheduler (stommer.info)** vom Typ **Header Auth**, Feldname `Authorization`. Der [zugehörige Workflowentwurf](https://privat.stommer.com:5678/workflow/23581e4b70324812) ist angelegt; die gespeicherte verschlüsselte Form und die korrekte Zuordnung wurden lesend bestätigt. Die Repository-Vorlage enthält nur eine Platzhalterreferenz. Token weder in die Workflow-Datei noch in eine URL oder das Repository schreiben. Erfolgreiche Ausführungsdaten werden nicht dauerhaft gespeichert; HTTP-Fehler bleiben Fehler.
Der Header `Authorization: Bearer <FEWO_SCHEDULER_TOKEN>` liegt nach ausdrücklicher Freigabe in der verschlüsselten n8n-Zugangsdatenverbindung **FewoPortal Scheduler (stommer.info)** vom Typ **Header Auth**, Feldname `Authorization`. Der [zugehörige Workflowentwurf](http://localhost:15678/workflow/23581e4b70324812) ist angelegt; die gespeicherte verschlüsselte Form und die korrekte Zuordnung wurden lesend bestätigt. Die Repository-Vorlage enthält nur eine Platzhalterreferenz. Token weder in die Workflow-Datei noch in eine URL oder das Repository schreiben. Erfolgreiche Ausführungsdaten werden nicht dauerhaft gespeichert; HTTP-Fehler bleiben Fehler.
Der separat freigegebene einmalige manuelle Workflow-Test hat am **27.10.2026 um 20:42:47 Uhr MEZ** eine gültige authentifizierte JSON-Antwort des Schedulers erhalten. Für den parallelen CLI-Test wurde ausschließlich im Testprozess ein anderer lokaler Task-Broker-Port verwendet; die laufende n8n-Instanz wurde nicht neu gestartet. Der Test lag außerhalb einer Fünf-Minuten-Marke und führte deshalb keinen Kalenderimport aus. Lesend um 20:43 bestätigt: Kanal 1 importfähig, letzter erfolgreicher Import weiterhin 19:21:17 Uhr; Kanal 2 Import ausgeschaltet. Der Workflow bleibt unveröffentlicht. Das ist ein Nachweis der Workflow-Verbindung, noch kein Nachweis regelmäßiger automatischer Kalenderimporte.
**Nächster Schritt:** Workflow in der n8n-Oberfläche öffnen und **Veröffentlichen / Publish** wählen. Danach mindestens zwei aufeinanderfolgende automatische Kalenderimporte im Sync-Protokoll nachweisen und den Status hier aktualisieren. Die [n8n-CLI-Dokumentation](https://github.com/n8n-io/n8n-docs/blob/main/docs/deploy/host-n8n/configure-n8n/use-the-command-line.md) verlangt nach CLI-Veröffentlichung einen Neustart; Veröffentlichung in der Oberfläche vermeidet diesen zusätzlichen Neustart. Tokenfreier lokaler Nachweis: `storage/app/private/n8n-scheduler/setup-result.json` (Git-ignoriert).
- Bankdaten, Vertrags- und AGB-Texte, Rechtstexte prüfen.
### Zugang zur n8n-Oberfläche (27.10.2026)
n8n läuft auf dem Pi unter `http://192.168.2.49:5678`; Container und Oberfläche wurden mit HTTP 200 geprüft. Auf diesem Port ist kein TLS eingerichtet: Ein HTTPS-Verbindungsversuch an den internen n8n-Port scheitert mit `WRONG_VERSION_NUMBER`. Die in n8n hinterlegte `N8N_EDITOR_BASE_URL=https://privat.stommer.com:5678` wurde zunächst als Workflowlink übernommen, ist jedoch kein nachgewiesen funktionierender HTTPS-Zugang. Die Einstellung einer Editoradresse richtet selbst kein TLS ein. Der öffentliche Aufruf auf Port 5678 lief bei der Prüfung in eine Zeitüberschreitung.
Für den aktuellen Arbeitsplatz wurde ein nur an `127.0.0.1:15678` gebundener SSH-Tunnel zum Pi eingerichtet. Zugang: **http://localhost:15678**, [Scheduler-Workflow](http://localhost:15678/workflow/23581e4b70324812). HTTP-Antworten für Oberfläche, Anmeldung und Workflowroute geprüft; Lars hat die erfolgreiche Anmeldung mit seinem bestehenden Konto bestätigt. Die Verbindung vom Rechner zum Pi wird durch SSH verschlüsselt. Die Secure-Cookie-Einstellung bleibt eingeschaltet, Serverkonfiguration und n8n-Container wurden für diese Zugangslösung nicht verändert oder neu gestartet.
Die lokalen Links gelten nur auf dem Rechner mit laufendem Tunnel. Nach dessen Beendigung beziehungsweise einem Rechnerneustart lässt sich der Zugang in einer lokalen SSH-Sitzung wiederherstellen:
```sh
ssh -N -L 127.0.0.1:15678:127.0.0.1:5678 -o ExitOnForwardFailure=yes pi
```
Ein dauerhafter öffentlicher HTTPS-Zugang ist damit nicht repariert. Dafür sind die tatsächlich verwendete öffentliche Adresse, deren Weiterleitung und TLS-Terminierung zu klären. n8n beschreibt dafür [TLS am Reverse Proxy oder Zertifikate direkt an n8n](https://github.com/n8n-io/n8n-docs/blob/main/docs/deploy/host-n8n/configure-n8n/security/set-up-ssl.md). Durch diese Diagnose wurden keine Zertifikate, Weiterleitungen oder n8n-Anmeldedaten geändert.
### Fotos aus dem alten WordPress übernehmen
Die Auswahl (39 aktuelle Fotos: Wohnung, Garten/Terrasse/Luftbilder, Umgebung – ohne Theme-Platzhalter, Logos, Vorschaugrößen und veraltete Einrichtung) mit Kategorie und Bildbeschreibung steht in [database/data/wordpress-photos.csv](../database/data/wordpress-photos.csv). Der Import **liest** die Dateien nur aus dem WordPress-Ordner (dort wird nichts verändert), legt Original + WebP-Größen in `shared/storage/app/public` ab und überspringt bereits importierte Fotos (wiederholbar):
+3 -1
View File
@@ -4,7 +4,9 @@ # Projektstand
> Dieses Dokument ist der Einstieg für jede neue Arbeitssitzung. Bitte bei größeren Änderungen fortschreiben (Abschnitte „Fertig“, „Offen“, „Nächste Schritte“).
**Externer Scheduler als n8n-Entwurf eingerichtet (27.10.2026):** Strato bietet laut Lars minimal stündliche Cron-Ausführung. Für den Kalenderimport alle fünf Minuten wird ein externer minütlicher Auslöser benötigt. In der vorhandenen n8n-Instanz 2.7.5 auf dem Pi wurde nach ausdrücklicher Freigabe der [Workflow „FewoPortal Scheduler (stommer.info)“](https://privat.stommer.com:5678/workflow/23581e4b70324812) angelegt und der vorhandene Scheduler-Token als Header-Auth-Zugangsdaten übernommen; verschlüsselte Speicherung und Zuordnung lesend bestätigt. Tokenfreie [Workflowvorlage](../scripts/n8n-fewo-scheduler.json), JSON und installierte Node-Schemata geprüft. Der separat freigegebene einmalige Test über den tatsächlichen Workflow war erfolgreich: authentifizierte Scheduler-Antwort vom **27.10. um 20:42:47 Uhr MEZ**. Außerhalb einer Fünf-Minuten-Marke wurde dabei kein Kalenderimport ausgeführt; kein zusätzlicher Kalenderabgleich durch die Prüfung erzwungen. **Entwurf nach dem Test weiterhin unveröffentlicht, automatischer Betrieb noch nicht aktiv.** Nächster Schritt: in der n8n-Oberfläche veröffentlichen und mindestens zwei aufeinanderfolgende automatische Importläufe im Sync-Protokoll nachweisen. Details in [BETRIEB.md §6](BETRIEB.md#6-erledigt--offen-im-testbetrieb); tokenfreier lokaler Nachweis Git-ignoriert unter `storage/app/private/n8n-scheduler/setup-result.json`.
**n8n-Oberfläche wieder zugänglich (27.10.2026):** n8n läuft durchgehend; Port 5678 bietet intern HTTP, keinen direkten HTTPS-Zugang. Die zuvor aus der Konfiguration übernommene öffentliche HTTPS-Adresse war als Zugangslink nicht funktionsfähig. Temporären SSH-Tunnel ausschließlich an `127.0.0.1:15678` eingerichtet; http://localhost:15678 und Workflowroute mit HTTP 200 geprüft. **Lars bestätigt die erfolgreiche Anmeldung.** Serverkonfiguration, Zertifikate, n8n-Konten und Secure-Cookie-Einstellung unverändert. Der Tunnel gilt nur auf diesem Arbeitsplatz und solange er läuft; dauerhafter öffentlicher HTTPS-Zugang bleibt ungeklärt. Lokale Workflowlinks unten setzen diesen Tunnel voraus. Wiederherstellung und Diagnose: [BETRIEB.md](BETRIEB.md#zugang-zur-n8n-oberfläche-27102026).
**Externer Scheduler als n8n-Entwurf eingerichtet (27.10.2026):** Strato bietet laut Lars minimal stündliche Cron-Ausführung. Für den Kalenderimport alle fünf Minuten wird ein externer minütlicher Auslöser benötigt. In der vorhandenen n8n-Instanz 2.7.5 auf dem Pi wurde nach ausdrücklicher Freigabe der [Workflow „FewoPortal Scheduler (stommer.info)“](http://localhost:15678/workflow/23581e4b70324812) angelegt und der vorhandene Scheduler-Token als Header-Auth-Zugangsdaten übernommen; verschlüsselte Speicherung und Zuordnung lesend bestätigt. Tokenfreie [Workflowvorlage](../scripts/n8n-fewo-scheduler.json), JSON und installierte Node-Schemata geprüft. Der separat freigegebene einmalige Test über den tatsächlichen Workflow war erfolgreich: authentifizierte Scheduler-Antwort vom **27.10. um 20:42:47 Uhr MEZ**. Außerhalb einer Fünf-Minuten-Marke wurde dabei kein Kalenderimport ausgeführt; kein zusätzlicher Kalenderabgleich durch die Prüfung erzwungen. **Entwurf nach dem Test weiterhin unveröffentlicht, automatischer Betrieb noch nicht aktiv.** Nächster Schritt: in der n8n-Oberfläche veröffentlichen und mindestens zwei aufeinanderfolgende automatische Importläufe im Sync-Protokoll nachweisen. Details in [BETRIEB.md §6](BETRIEB.md#6-erledigt--offen-im-testbetrieb); tokenfreier lokaler Nachweis Git-ignoriert unter `storage/app/private/n8n-scheduler/setup-result.json`.
**Visuelle iCal-Regelengine bereitgestellt (27.10.2026):** Echte Kalenderanalyse mit Originalfeldern, Beispielen, Häufigkeiten und Textpräfixen; Regeleditor mit UND/ODER, Literalvergleichen, Priorität und einfacher Textextraktion; Live-Vorschau, getrennte Entwurfs-/Aktivierungsstufen und Neuauswertung vorhandener Einträge ohne neue IDs oder Termine. Fachliche Führungskandidaten unterstützen die persönliche Zuordnung, ohne automatische Datumszusammenführung. Exportzuordnung nach SUMMARY/DESCRIPTION/LOCATION und ausdrückliche Namensfreigabe je Zielkanal. Originale und Interpretation verschlüsselt gespeichert. **409 Feature-Tests / 1935 Assertions lokal erfolgreich, darunter 32 neue Fälle; Pint und Pipeline 4669 erfolgreich.** Additive Migration `2026_10_27_183425_add_ical_analysis_rules_and_event_metadata` in MariaDB-Batch 18, Serverrevision/Release bestätigt. Reale FeWo-direkt-Analyse: **38 Ereignisse, 9 Portalreservierungen, 29 Sperren**, davon 11 zukünftig (3 Reservierungen, 8 Sperren). Beide Regeln als normale Daten aktiviert; 11 vorhandene Einträge ohne geänderte IDs, UIDs, Termine oder Zuordnungen neu klassifiziert. Ostseeklar-Export HTTP 200 mit 11 Ereignissen, davon 3 mit freigegebenen Namensbestandteilen in SUMMARY/DESCRIPTION; Export-IDs/-Zeiträume identisch. **Nutzerbeobachtung: Ostseeklar zeigt weiterhin nur „Belegt“ und bietet für importierte Einträge keine Detailansicht; die gewünschte Namensanzeige ist bisher nicht erreicht.** Eine Prüfung der Textübernahme über Eintragsdetails entfällt; die Unterstützung durch den Portalimporter ist noch zu klären. Weitere GET-Abrufe mit HTTP 200/live sind protokolliert, lassen sich anhand der Clientkennung aber nicht sicher Ostseeklar zuordnen. Ursache und Verarbeitung der Textfelder im Zielportal bleiben offen; keine persönliche Portalbestätigung gesetzt. Browserwerkzeug nicht startbar, daher keine zusätzliche echte Browser-Sichtprüfung behauptet. [Bedienung, Datenabgleich und Grenzen](architecture/ical-regelengine.md). Praktischer Nachweis ohne Namen/Token lokal Git-ignoriert: `storage/app/private/ical-regelengine/real-practical-result.json`.