No description
Find a file
Jesko Anschütz dd3ec070f7 Security-Review + Phase 6: CSRF, Rate-Limiting, Tenant-Isolation, Screenshot, Ansible
### Security-Fixes (K1–K6, W1–W4, W7, N1, N5–N6, V1, V5–V7)
- K1: CSRF-Schutz via Double-Submit-Cookie (httpapi/csrf.go + csrf_helpers.go)
- K2: requireScreenAccess() in allen manage-Handlern (Tenant-Isolation)
- K3: Tenant-Check bei DELETE /api/v1/media/{id}
- K4: requirePlaylistAccess() + GetByItemID() für JSON-API Playlist-Routen
- K5: Admin-Passwort nur noch als [gesetzt] geloggt
- K6: POST /api/v1/screens/register mit Pre-Shared-Secret (MORZ_INFOBOARD_REGISTER_SECRET)
- W1: Race Condition bei order_index behoben (atomare Subquery in AddItem)
- W2: Graceful Shutdown mit 15s Timeout auf SIGTERM/SIGINT
- W3: http.MaxBytesReader (512 MB) in allen Upload-Handlern
- W4: err.Error() nicht mehr an den Client
- W7: Template-Execution via bytes.Buffer (kein partial write bei Fehler)
- N1: Rate-Limiting auf /login (5 Versuche/Minute pro IP, httpapi/ratelimit.go)
- N5: Directory-Listing auf /uploads/ deaktiviert (neuteredFileSystem)
- N6: Uploads nach Tenant getrennt (uploads/{tenantSlug}/)
- V1: Upload-Logik konsolidiert in internal/fileutil/fileutil.go
- V5: Cookie-Name als Konstante reqcontext.SessionCookieName
- V6: Strukturiertes Logging mit log/slog + JSON-Handler
- V7: DB-Pool wird im Graceful-Shutdown geschlossen

### Phase 6: Screenshot-Erzeugung
- player/agent/internal/screenshot/screenshot.go erstellt
- Integration in app.go mit MORZ_INFOBOARD_SCREENSHOT_EVERY Config

### UX: PDF.js Integration
- pdf.min.js + pdf.worker.min.js als lokale Assets eingebettet
- Automatisches Seitendurchblättern im Player

### Ansible: Neue Rollen
- signage_base, signage_server, signage_provision erstellt
- inventory.yml und site.yml erweitert

### Konzept-Docs
- GRUPPEN-KONZEPT.md, KAMPAGNEN-AKTIVIERUNG.md, MONITORING-KONZEPT.md
- PROVISION-KONZEPT.md, TEMPLATE-EDITOR.md, WATCHDOG-KONZEPT.md

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-23 21:06:35 +01:00
ansible Security-Review + Phase 6: CSRF, Rate-Limiting, Tenant-Isolation, Screenshot, Ansible 2026-03-23 21:06:35 +01:00
compose Tenant-Feature Phase 6: Session-Cleanup, Docker-Env, Security-Fixes, Doku 2026-03-23 19:39:39 +01:00
docs Security-Review + Phase 6: CSRF, Rate-Limiting, Tenant-Isolation, Screenshot, Ansible 2026-03-23 21:06:35 +01:00
player Security-Review + Phase 6: CSRF, Rate-Limiting, Tenant-Isolation, Screenshot, Ansible 2026-03-23 21:06:35 +01:00
server Security-Review + Phase 6: CSRF, Rate-Limiting, Tenant-Isolation, Screenshot, Ansible 2026-03-23 21:06:35 +01:00
.gitignore Tenant-Feature Phase 1+2: Auth-Fundament + Login-Flow + UX-Textverbesserung 2026-03-23 15:46:14 +01:00
.golangci.yml Richte revive auf den Repo-Stil aus 2026-03-22 17:56:47 +01:00
API-MQTT-VERTRAG.md Dokumentiere ersten HTTP-Statuspfad fuer den Agenten 2026-03-22 17:43:08 +01:00
CLAUDE.md CLAUDE.md: Projektregeln für Doku-Pflege und Team-Workflow 2026-03-23 20:24:26 +01:00
DATENMODELL.md Erweitere Planung um Templates und Provisionierung 2026-03-22 13:06:31 +01:00
DEVELOPMENT.md Dokumentation: Security-Features und Upload-Konsolidierung (Phase 6) 2026-03-23 21:01:47 +01:00
LINTER-FINDINGS.md Dokumentiere aktuellen Linter-Stand 2026-03-22 17:53:32 +01:00
Makefile Integriere golangci-lint in den Entwicklungsablauf 2026-03-22 17:53:24 +01:00
MORZ-InfoScreen-Landscape.png Baue Ebene 1: Player-UI, Kiosk-Display und vollstaendiges Ansible-Deployment 2026-03-22 22:34:16 +01:00
MORZ-InfoScreen-Portrait.png Baue Ebene 1: Player-UI, Kiosk-Display und vollstaendiges Ansible-Deployment 2026-03-22 22:34:16 +01:00
PLAN.md Erweitere Planung um Templates und Provisionierung 2026-03-22 13:06:31 +01:00
README.md Doku-Sync: README, TODO, DEVELOPMENT und API-Docs auf Implementierungsstand nachgezogen 2026-03-23 09:55:36 +01:00
TECH-STACK.md Erweitere Planung um Templates und Provisionierung 2026-03-22 13:06:31 +01:00
TODO.md Security-Review + Phase 6: CSRF, Rate-Limiting, Tenant-Isolation, Screenshot, Ansible 2026-03-23 21:06:35 +01:00

Info-Board Neu

Dieses Verzeichnis enthaelt die Planung und spaetere Umsetzung der neuen Info-Board-Plattform.

Die Trennung von /srv/docker/infoboard-netboot ist sinnvoll, damit:

  • die bestehende produktive Netboot-Struktur unangetastet bleibt
  • Planung, Prototypen und neue Deployments sauber getrennt sind
  • Server-, Player- und Ansible-Artefakte nicht mit Altbestand vermischt werden

Aktueller Stand

  • Architekturplan: PLAN.md
  • Umsetzungs-Todo: TODO.md
  • Datenmodell: DATENMODELL.md
  • Schema-Entwurf: docs/SCHEMA.md
  • API- und MQTT-Vertrag: API-MQTT-VERTRAG.md
  • Technologieentscheidungen: TECH-STACK.md
  • Entwicklungsleitfaden: DEVELOPMENT.md
  • Erste Dev-Testliste: docs/TEST-CHECKLIST-DEV.md
  • Template-/Kampagnenkonzept: docs/TEMPLATE-KONZEPT.md
  • layout_json fuer message_wall: docs/LAYOUT-JSON.md
  • Player-Agent-Lifecycle und Health-Modell: docs/PLAYER-AGENT-LIFECYCLE.md
  • Erster HTTP-Statuspfad fuer den Player-Agent: docs/PLAYER-STATUS-HTTP.md
  • Provisionierungskonzept: docs/PROVISIONIERUNGSKONZEPT.md
  • Player-Konzept: docs/PLAYER-KONZEPT.md
  • Server-Konzept: docs/SERVER-KONZEPT.md
  • Offene Architekturfragen: docs/OFFENE-ARCHITEKTURFRAGEN.md

Projektstruktur

  • docs/ fuer weitere Architektur- und Betriebsdokumente
  • server/ fuer Backend, Frontends und Compose-Dateien
  • player/ fuer Agent, UI und lokale Startlogik
  • ansible/ fuer Rollen, Inventories und Deployments
  • compose/ fuer Container-Definitionen und Stack-Bausteine
  • scripts/ fuer Hilfsskripte

Aktueller Implementierungsstand

Backend (server/backend/)

  • Vollstaendiges PostgreSQL-Backend mit Datenbank-Migrations
  • Store-Layer fuer Datenverwaltung
  • REST-API mit Endpunkten:
    • message_wall fuer Kampagnenausgabe
    • player/status fuer Player-Statusverwaltung
    • /manage/ API fuer Media-Upload, Playlist-Verwaltung und Vorlagen
    • /meta fuer Systemmetadaten
  • HTML-Statusseiten fuer Diagnose
  • Admin-UI mit Medien-Upload und Playlist-Management
  • Tenant-aware Architektur mit Lebenszyklusverwaltung

Player-Agent (player/agent/)

  • Funktionaler Go-Agent mit:
    • Selbstregistrierung beim Backend
    • Playlist-Rotation mit Heartbeat
    • Dateibasierter/env-basierter Konfiguration
    • Strukturierte Logs mit journald-Integration
    • Internes Health-Modell fuer Diagnosewerte
    • HTTP-Status-Reporter mit Lebenszyklusstatus
    • MQTT-Integration (optional) mit Authentifizierung
  • Binaries fuer Linux ARM64 vorhanden

Ansible-Automatisierung (ansible/)

  • Zwei funktionale Rollen:
    • signage_player: Agent-Deployment mit Systemd-Units, Tasks, Templates und Handlers
    • signage_display: Display-Kiosk-Setup mit Systemd-Units, Tasks, Templates und Handlers
  • Konfigurierbare Defaults und Host-Variablen
  • Unterstützung für Bildschirm-Setup mit Ansible-Anleitung

Infrastruktur (compose/)

  • Docker Compose Setup mit:
    • PostgreSQL-Datenbank
    • Mosquitto MQTT-Broker
    • Backend-Service Integration

Implementierte Features

  • DB-Migrations und Schema-Management
  • Media-Upload und Speicherverwaltung
  • Playlist-Management und Rotation
  • Player-Registrierung und Status-Tracking
  • Admin-UI für Screensetup
  • Ansible-automatisiertes Deployment auf Raspberry Pi
  • Kiosk-Display-Modus
  • MQTT-basierte Kommunikation
  • HTML-Diagnoseseiten