CLARYEL PerimetroProjekt för diskussion
Tekniskt dokument · 3 av 3

Programvarulösning

Home Assistant på den lokala servern: en app för vilken telefon, surfplatta eller webbläsare som helst, åtkomst med begränsade rättigheter och varningar som når fram även när telefonen är på ljudlöst.

Home AssistantAndroid · iPhone · webbläsareRättigheter per rollKritiska varningarAllt lokalt, krypterat, inget moln
1

Vad vi valde ur vår stack, och varför

Av den stack som redan körs på vår lokala server behövs få delar. Resten — AI-analys, krypterat arkiv, filmer — stannar utanför Home Assistant.

  1. 1

    Home Assistant

    Systemets enda centrum: tar emot perimeterhändelserna, hanterar användarna och deras rättigheter, skickar varningarna till telefonerna. Fri programvara, körs lokalt på vår server.

  2. 2

    MQTT (Mosquitto)

    Den lokala meddelandekanalen mellan fältnoderna (ESP32), AI-analysen och Home Assistant. Händelserna färdas som korta textmeddelanden, utan bilder.

  3. 3

    NUT (UPS-status)

    För in den avbrottsfria strömförsörjningens status i Home Assistant: ett strömavbrott eller ett batteri som laddas ur blir genast en teknisk varning.

  4. 4

    Appen Home Assistant Companion

    Den officiella klienten för Android och för iPhone/iPad: med den kommer varningarna fram och den godkända instrumentpanelen öppnas.

  5. 5

    WireGuard

    Den skyddade kanal som projektet redan planerar för förbindelsen: där det behövs gör den det möjligt att använda appen även utanför byggnaden, utan molnabonnemang.

Stannar utanför Home Assistant: AI-analys, krypterat arkiv och filmer stannar på servern och appen kan inte visa dem.
2

Schema: från servern till klienterna, rollerna och rättigheterna

Fältpunkt

Kamera eller Wi-Fi CSI-moduler, med signalering

Lokal server

AI-analys, kryptering, arkiv, UPS och databackup

Home Assistant

Händelser, användare, rättigheter, varningar

Klienter

En app eller webbläsaren

  • Android
  • iPhone / iPad
  • Webbläsare (dator)
  • Surfplatta

Roller och rättigheter

Alla ser bara det som är godkänt

  • Teknisk administratör
  • Utsedd person
  • Boende

Home Assistant tar bara emot händelsen (text, tid, staketsträcka): inga foton eller video. Det som inte finns i Home Assistant syns inte i appen.

3

En klient för vilken enhet som helst

Klienten är den officiella appen Home Assistant Companion eller helt enkelt webbläsaren: välj det du har.

  • Android

    Appen Home Assistant Companion från appbutiken: varningar, godkänd instrumentpanel, snabbåtgärder.

  • iPhone och iPad

    Appen Home Assistant Companion för iOS och iPadOS: varningar, även kritiska, och godkänd instrumentpanel.

  • Webbläsare på dator

    Det räcker att öppna adressen till Home Assistant: ingen installation.

  • Surfplatta

    App eller webbläsare; med en egen användare kan den sitta kvar på väggen som fast panel, till exempel i entrén.

Åtkomst sker i byggnadens lokala nät eller, utanför byggnaden, via den skyddade WireGuard-kanalen. Inget abonnemang på Home Assistant Cloud behövs.
4

Åtkomst med begränsade rättigheter

Alla loggar in med eget användarnamn och lösenord (med tvåstegsverifiering, om den är aktiverad) och ser bara det som godkänts för deras roll. Rollerna nedan är ett förslag att diskutera.

  • Administratör för Home Assistant

    Teknisk administratör

    Konfigurerar systemet, användarna och automationerna. Få konton, med tvåstegsverifiering; åtkomsten kan tillåtas bara från det lokala nätet.

  • Användare utan administratörsrättigheter

    Utsedd person

    Tar emot larmen med åtgärdsknappar för att bekräfta händelsen. För bilderna i arkivet gäller det förfarande som är förbehållet utsedda personer, med åtkomstlogg.

  • Användare utan administratörsrättigheter

    Boende

    Tar emot varningarna (bara text) och ser en godkänd instrumentpanel med systemstatus. Ingen åtkomst till kameran, arkivet eller inställningarna.

Vem som får göra vadTeknisk administratörUtsedd personBoende
Ta emot larmvarningar
Se systemstatus (godkänd instrumentpanel)
Bekräfta händelsen med åtgärdsknapparna
Se bilderna i arkivet (bara utsedda personer, med logg)
Hantera mottagarlistan och varningsinställningarna
Ändra inställningar, användare och automationer

Hur begränsningen uppnås

  • Användare utan administratörsrättigheter kommer inte åt Inställningarna och kan inte hantera användare, enheter, automationer och instrumentpaneler.
  • Varje instrumentpanel kan förbehållas administratörerna; de boende tilldelas en separat och godkänd instrumentpanel.
  • För varje användare kan åtkomst tillåtas bara från det lokala nätet och tvåstegsverifiering aktiveras.
  • Varje enhet kan kopplas bort genom att dess åtkomsttoken tas bort från profilen; en användares konto kan inaktiveras.
  • Den starkaste gränsen är konstruktionsmässig: Home Assistant erbjuder inga behörigheter per entitet i gränssnittet, därför kommer bara godkänd information in (larmhändelse, systemstatus, UPS-status). Bilder och arkiv stannar utanför.
5

Varningar som når fram även när telefonen är på ljudlöst

Vid ett farligt intrång i perimetern skickas varningen som kritisk: med den konfiguration som beskrivs nedan ringer den även när telefonen är på ljudlöst och med ”Stör ej” aktivt, alltså även när alla inkommande samtal är blockerade (till exempel på natten).

Låsskärm
03:12
Telefon på ljudlöstStör ej aktivt
LARMKritisk varning

Observera! En person har upptäckts på den övervakade staketsträckan.

iPhone
Låsskärm
03:12
Telefon på ljudlöstStör ej aktivt
LARMalarm_stream

Observera! En person har upptäckts på den övervakade staketsträckan.

Android

Exempel på inställning (ur den officiella dokumentationen för Home Assistant Companion)

iPhone och iPad: kritisk varning

  • Kritiska varningar (Critical Alerts) i iOS visas högst upp på låsskärmen ovanför alla andra notiser och ljuder även med ”Stör ej” aktivt eller med iPhone på ljudlöst.
  • De kan dessutom överskrida frekvensgränserna för appens notiser.

1× En gång: i iOS-inställningarna för appen Home Assistant tillåt notiser, inklusive kritiska varningar.

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

Android: hög prioritet och larmkanal

  • Med hög prioritet och livslängd 0 kommer notisen fram direkt, även om telefonen ligger stilla eller har haft skärmen släckt länge.
  • Med ljudströmmen ”väckarklocka” (alarm stream) ringer telefonen även i ljudlöst läge eller vibrationsläge.

1× En gång: i appens systeminställningar öppna larmkanalen och tillåt att den kringgår ”Stör ej” (som standard kringgår den inte).

data:
  ttl: 0
  priority: high
  channel: alarm_stream

Att tänka på

  • Varningen är utformad för att nå fram även när telefonen är på ljudlöst, men absolut leverans kan inte utlovas: telefonen måste vara påslagen och nåbar (datanät eller Wi-Fi) och engångskonfigurationen måste göras på varje telefon.
  • Meddelandet är enbart text, utan foton, video eller personuppgifter.
  • Normalt går sändningen till telefonen via Apples eller Googles infrastruktur för pushnotiser, som för vilken app som helst. I byggnadens lokala nät finns även lokal leverans (Local Push) via WebSocket, utan att gå via Apple eller Google.
  • Vi rekommenderar en periodisk kontrollvarning, för att i tid märka om en telefon inte längre tar emot varningarna.
6

Inte bara perimetern: andra viktiga varningar

Samma kanal kan också bära andra viktiga meddelanden, med olika brådskenivåer. Valet av ringsignal och prioritet görs för varje nivå.

  • Kritisk

    Farligt intrång i perimetern: ringer alltid, även när telefonen är på ljudlöst.

  • Brådskande (teknisk)

    Strömavbrott eller UPS-batteri som laddas ur, förlorad förbindelse med fältpunkten, servern onåbar.

  • Informativ

    Onormal temperatur eller fuktighet eller vattenläcka i lådan, andra meddelanden som överenskommits med föreningen. Får förbli ljudlösa.

I iOS går nivån ”kritisk” även förbi ljudlöst, ”time-sensitive” (brådskande) går förbi fokuslägena, ”passiv” väcker inte ens skärmen.

Allt lokalt, krypterat, utan moln

Analys, arkiv och åtkomst stannar på den lokala servern, i krypterad form och utan molntjänster. Vid larm stängs åtkomsten till arkivet omedelbart och händelsens inspelningar skyddas mot ändring och radering, som beskrivs i projektet.

✉

Frågor eller synpunkter?

Skriv till oss: vi svarar gärna. Du kan också använda projektets formulär.

Gå till projektets formulär

Projektdokument att diskutera med de boende och föreningens förvaltning: genomförandet är möjligt först efter nödvändiga godkännanden.