CLARYEL PerimetroProjekt zur Diskussion
Technisches Dokument · 3 von 3

Softwarelösung

Home Assistant auf dem lokalen Server: eine App für jedes Telefon, jedes Tablet oder den Browser, Zugänge mit beschränkten Rechten und Warnungen, die auch bei stummgeschaltetem Telefon ankommen.

Home AssistantAndroid · iPhone · BrowserRechte je RolleKritische WarnungenAlles lokal, verschlüsselt, keine Cloud
1

Was wir aus unserem Stack gewählt haben und warum

Von dem Stack, der bereits auf unserem lokalen Server läuft, werden nur wenige Elemente benötigt. Der Rest — KI-Analyse, verschlüsseltes Archiv, Videoaufnahmen — bleibt außerhalb von Home Assistant.

  1. 1

    Home Assistant

    Die zentrale Stelle des Systems: Sie empfängt die Perimeterereignisse, verwaltet die Benutzer und ihre Rechte und sendet die Warnungen an die Telefone. Freie Software, läuft lokal auf unserem Server.

  2. 2

    MQTT (Mosquitto)

    Der lokale Nachrichtenkanal zwischen den Feldknoten (ESP32), der KI-Analyse und Home Assistant. Die Ereignisse werden als kurze Textnachrichten ohne Bilder übertragen.

  3. 3

    NUT (UPS-Status)

    Bringt den Zustand der unterbrechungsfreien Stromversorgung in Home Assistant: Ein Stromausfall oder ein sich entladender Akku wird sofort zu einer technischen Warnung.

  4. 4

    Home Assistant Companion App

    Der offizielle Client für Android und iPhone/iPad: Mit ihm kommen die Warnungen an und das freigegebene Dashboard wird geöffnet.

  5. 5

    WireGuard

    Der im Projekt bereits vorgesehene geschützte Kanal für die Verbindung: Wo nötig, erlaubt er die Nutzung der App auch außerhalb des Gebäudes, ohne Cloud-Abonnements.

Bleibt außerhalb von Home Assistant: KI-Analyse, verschlüsseltes Archiv und Videoaufnahmen bleiben auf dem Server, und die App kann sie nicht anzeigen.
2

Schema: vom Server zu den Clients, Rollen und Rechten

Feldpunkt

Kamera oder Wi-Fi-CSI-Module mit Signalisierung

Lokaler Server

KI-Analyse, Verschlüsselung, Archiv, UPS und Datenbackup

Home Assistant

Ereignisse, Benutzer, Rechte, Warnungen

Clients

Eine App oder der Browser

  • Android
  • iPhone / iPad
  • Browser (Computer)
  • Tablet

Rollen und Rechte

Jeder sieht nur, was freigegeben ist

  • Technischer Administrator
  • Beauftragte Person
  • Bewohner

Home Assistant erhält nur das Ereignis (Text, Uhrzeit, Zaunabschnitt): keine Fotos und kein Video. Was nicht in Home Assistant ist, ist in der App nicht zu sehen.

3

Ein Client für jedes Gerät

Der Client ist die offizielle App Home Assistant Companion oder einfach der Browser: Wählen Sie, was Sie haben.

  • Android

    App Home Assistant Companion aus dem App-Store: Warnungen, freigegebenes Dashboard, Schnellaktionen.

  • iPhone und iPad

    App Home Assistant Companion für iOS und iPadOS: Warnungen, auch kritische, und freigegebenes Dashboard.

  • Browser am Computer

    Es genügt, die Adresse von Home Assistant zu öffnen: keine Installation.

  • Tablet

    App oder Browser; mit einem eigenen Benutzer kann es als feste Wandtafel hängen bleiben, z. B. im Eingangsbereich.

Der Zugang erfolgt im lokalen Netz des Gebäudes oder außerhalb des Gebäudes über den geschützten WireGuard-Kanal. Ein Abonnement für Home Assistant Cloud ist nicht nötig.
4

Zugang mit beschränkten Rechten

Jeder meldet sich mit eigenem Benutzernamen und Passwort an (mit Zwei-Faktor-Verifizierung, falls aktiviert) und sieht nur, was für seine Rolle freigegeben ist. Die folgenden Rollen sind ein Vorschlag zur Diskussion.

  • Administrator von Home Assistant

    Technischer Administrator

    Konfiguriert das System, die Benutzer und die Automatisierungen. Wenige Konten, mit Zwei-Faktor-Verifizierung; der Zugriff kann auf das lokale Netz beschränkt werden.

  • Benutzer ohne Administratorrechte

    Beauftragte Person

    Erhält die Alarme mit Aktionsschaltflächen zur Bestätigung des Ereignisses. Für die Bilder des Archivs gilt das den benannten Personen vorbehaltene Verfahren mit Zugriffsprotokoll.

  • Benutzer ohne Administratorrechte

    Bewohner

    Erhält die Warnungen (nur Text) und sieht ein freigegebenes Dashboard mit dem Systemstatus. Kein Zugriff auf Kamera, Archiv oder Einstellungen.

Wer was darfTechnischer AdministratorBeauftragte PersonBewohner
Alarmwarnungen erhalten
Den Systemstatus sehen (freigegebenes Dashboard)
Das Ereignis mit den Aktionsschaltflächen bestätigen
Bilder des Archivs sehen (nur benannte Personen, mit Protokoll)
Die Empfängerliste und die Warneinstellungen verwalten
Einstellungen, Benutzer und Automatisierungen ändern

Wie die Beschränkung erreicht wird

  • Benutzer ohne Administratorrechte haben keinen Zugriff auf die Einstellungen und können weder Benutzer noch Geräte, Automatisierungen oder Dashboards verwalten.
  • Jedes Dashboard kann den Administratoren vorbehalten werden; den Bewohnern wird ein eigenes, freigegebenes Dashboard zugewiesen.
  • Für jeden Benutzer kann der Zugriff nur aus dem lokalen Netz erlaubt und die Zwei-Faktor-Verifizierung aktiviert werden.
  • Jedes Gerät lässt sich trennen, indem sein Zugriffstoken im Profil gelöscht wird; das Konto eines Benutzers kann deaktiviert werden.
  • Die stärkste Grenze ist konzeptionell: Home Assistant bietet in der Oberfläche keine Berechtigungen pro Entität, daher gelangen nur freigegebene Informationen hinein (Alarmereignis, Systemstatus, UPS-Status). Bilder und Archiv bleiben draußen.
5

Warnungen, die auch bei stummgeschaltetem Telefon ankommen

Bei einer gefährlichen Verletzung des Perimeters wird die Warnung als kritisch gesendet: Mit der unten beschriebenen Konfiguration klingelt sie auch bei stummgeschaltetem Telefon und aktivem „Nicht stören“, also auch dann, wenn alle eingehenden Anrufe blockiert sind (zum Beispiel nachts).

Sperrbildschirm
03:12
Telefon stummgeschaltetNicht stören aktiv
ALARMKritische Warnung

Achtung! Im überwachten Zaunabschnitt wurde eine Person erkannt.

iPhone
Sperrbildschirm
03:12
Telefon stummgeschaltetNicht stören aktiv
ALARMalarm_stream

Achtung! Im überwachten Zaunabschnitt wurde eine Person erkannt.

Android

Beispiel für die Einstellung (aus der offiziellen Dokumentation von Home Assistant Companion)

iPhone und iPad: kritische Warnung

  • Kritische Warnungen (Critical Alerts) von iOS erscheinen oben auf dem Sperrbildschirm über allen anderen Benachrichtigungen und ertönen auch bei aktivem „Nicht stören“ oder stummgeschaltetem iPhone.
  • Sie können außerdem die Häufigkeitsgrenzen der App-Benachrichtigungen überschreiten.

1× Einmalig: In den iOS-Einstellungen der App Home Assistant Benachrichtigungen erlauben, einschließlich kritischer Warnungen.

data:
  push:
    sound:
      name: "default"
      critical: 1
      volume: 1.0

Android: hohe Priorität und Alarmkanal

  • Mit hoher Priorität und Lebensdauer 0 kommt die Benachrichtigung sofort an, auch wenn das Telefon ruht oder der Bildschirm lange aus ist.
  • Über den Audiostrom „Wecker“ (alarm stream) klingelt das Telefon auch im Stumm- oder Vibrationsmodus.

1× Einmalig: In den Systemeinstellungen der App den Alarmkanal öffnen und erlauben, „Nicht stören“ zu umgehen (standardmäßig umgeht er es nicht).

data:
  ttl: 0
  priority: high
  channel: alarm_stream

Was zu beachten ist

  • Die Warnung ist so ausgelegt, dass sie auch bei stummgeschaltetem Telefon ankommt, eine absolute Zustellung lässt sich aber nicht versprechen: Das Telefon muss eingeschaltet und erreichbar sein (Datennetz oder Wi-Fi), und die einmalige Konfiguration muss auf jedem Telefon vorgenommen werden.
  • Die Nachricht ist reiner Text, ohne Fotos, Videos oder personenbezogene Daten.
  • In der Regel läuft der Versand an das Telefon über die Push-Benachrichtigungsinfrastruktur von Apple oder Google, wie bei jeder App. Im lokalen Netz des Gebäudes steht außerdem die lokale Zustellung (Local Push) über WebSocket zur Verfügung, ohne Umweg über Apple oder Google.
  • Wir empfehlen eine regelmäßige Prüfwarnung, um rechtzeitig zu bemerken, wenn ein Telefon die Warnungen nicht mehr erhält.
6

Nicht nur der Perimeter: weitere wichtige Warnungen

Derselbe Kanal kann auch andere wichtige Nachrichten mit unterschiedlichen Dringlichkeitsstufen übermitteln. Klingelton und Priorität werden für jede Stufe festgelegt.

  • Kritisch

    Gefährliche Verletzung des Perimeters: klingelt immer, auch bei stummgeschaltetem Telefon.

  • Dringend (technisch)

    Stromausfall oder sich entladender UPS-Akku, Verlust der Verbindung zum Feldpunkt, Server nicht erreichbar.

  • Informativ

    Ungewöhnliche Temperatur oder Feuchtigkeit oder Wasserleck im Gehäuse, weitere mit dem Kondominium vereinbarte Nachrichten. Dürfen stumm bleiben.

Auf iOS überwindet die Stufe „kritisch“ sogar die Stummschaltung, „time-sensitive“ (dringend) überwindet die Fokus-Modi, „passiv“ weckt nicht einmal den Bildschirm.

Alles lokal, verschlüsselt, ohne Cloud

Analyse, Archiv und Zugänge bleiben auf dem lokalen Server, verschlüsselt und ohne Cloud-Dienste. Bei Alarm wird der Zugriff auf das Archiv sofort geschlossen, und die Aufnahmen des Ereignisses sind gegen Änderung und Löschung geschützt, wie im Projekt beschrieben.

✉

Fragen oder Anmerkungen?

Schreiben Sie uns: Wir antworten gern. Sie können auch das Projektformular nutzen.

Zum Projektformular

Projektdokument zur Besprechung mit den Bewohnern und der Verwaltung des Kondominiums: Die Umsetzung ist erst nach den erforderlichen Genehmigungen möglich.