Projekt:Türsteuerung: Unterschied zwischen den Versionen

Aktuelle Version vom 1. November 2024, 16:49 Uhr

Türsteuerung

Status	stable
Beschreibung	SSH Türöffnungssystem
Maintainer	silson
Git	https://git.un-hack-bar.de/UNHB/ssh-keys

keymaster.unhb[Bearbeiten | | Quelltext bearbeiten]

Ziel für SSH Anmeldung. Hier liegt ein kleine Bash-Skript /home/gatekeeper/door.sh welches anhand des aktuellen Usernames (open/close) eine Nachricht an das Homeassistant schickt um die Tür zu öffnen/zu schließen.

Zugang[Bearbeiten | | Quelltext bearbeiten]

SSH: credentials liegen im keepass

User hinzufügen[Bearbeiten | | Quelltext bearbeiten]

In dem Repo:

https://git.un-hack-bar.de/UNHB/ssh-keys

einfach eine entsprechende Zeile hinzufügen. Der Schlüssel wird dann automatisch innerhalb von 1-2 Minuten auf die VM im Space syncronisiert. Das Repo ist nur für Mitglieder zugänglich. Ggfs. wird also jemand mit Zugriff benötigt oder es muss erst noch ein passender Authentik Account angelegt werden.

user entfernen[Bearbeiten | | Quelltext bearbeiten]

Einfach die entsprechende Zeile löschen.

Tür öffnen[Bearbeiten | | Quelltext bearbeiten]

Via SSH-Client[Bearbeiten | | Quelltext bearbeiten]

mit wifi unhb.de verbinden
ssh open@keymaster.unhb öffnet die Tür
ssh close@keymaster.unhb schliesst die Tür

Das obige lässt sich mit div. SSH-Clients auch recht bequem für Android oder iOS als "Shortcut" anlegen.

Via Trigger-App[Bearbeiten | | Quelltext bearbeiten]

Aktuell funktioniert außerdem (unter Android): https://github.com/mwarning/trigger

Die App gibt es nicht im Android Playstore. Man kann die App aus dem fDroid-Store runterladen oder direkt die APK von der Homepage.

Einrichtung:

Neues Profil anlegen

Menü oben rechts "..." und dann "Neu" auswählen
Name: UN-Hack-Bar
Door Type: ssh
Require Wifi: Auswählen
Key-Pair: Auswählen
- ED25519 auswählen und "Erstellen"
- Pubkey aus dem Feld oben kopiere und wie weiter oben beschrieben ins GIT-Repo einfügen
Server Address: keymaster.unhb
Port: 22
Login Name: gatekeeper
Open Command: USER=open /home/gatekeeper/door.sh
Close Command: USER=close /home/gatekeeper/door.sh
SSIDs: unhb.de

Alternativ kann dieser QR Code gescannt werden (der Schritt mit dem SSH-Schlüsselpaar muss dann nachträglich gemacht werden):

Todo:

State Command: /home/pi/get_space_status.py

Matrix[Bearbeiten | | Quelltext bearbeiten]

Bei jedem öffnen/schließen wird eine Nachricht mit dem Namen für den verwendeten SSH Keys in den "Space Operation Center" Matrix-Kanal geschickt.

@@ Zeile 1: / Zeile 1: @@
-{{Projekt|proj_name=Tuersteuerung|proj_status=stable|proj_image=door.jpg|beschreibung=homematik Tuerschlossantrieb samt Steuerung und Benutzerverwaltung|maint=smash|git=https://git.un-hack-bar.de/UNHB/}}
+{{Projekt|proj_name=Türsteuerung|proj_status=stable|proj_image=door.jpg|beschreibung=SSH Türöffnungssystem|maint=silson|git=https://git.un-hack-bar.de/UNHB/ssh-keys}}
-== door.unhb ==
-homegear installation, oeffnet und schliesst die tuer zum space, updated spaceapi
+== keymaster.unhb ==
+Ziel für SSH Anmeldung. Hier liegt ein kleine Bash-Skript /home/gatekeeper/door.sh welches anhand des aktuellen Usernames (open/close) eine Nachricht an das Homeassistant schickt um die Tür zu öffnen/zu schließen.
 === Zugang ===
 * SSH: credentials liegen im keepass
-* filesystem ist ro, bei aenderungen vorher ''sudo mount -o remount,rw /'' und danach natuerlich ''sudo mount -o remount,ro /''
-* Tuer schliessen: user open/close via ssh pubkey
-=== user hinzufuegen ===
+=== User hinzufügen ===
-* per ssh auf door.unhb verbinden
-* sudo add_dooruser.sh ausfuehren
+In dem Repo:
-* usernamen & ssh pubkey eingeben
+* https://git.un-hack-bar.de/UNHB/ssh-keys
+einfach eine entsprechende Zeile hinzufügen. Der Schlüssel wird dann automatisch innerhalb von 1-2 Minuten auf die VM im Space syncronisiert. Das Repo ist nur für Mitglieder zugänglich. Ggfs. wird also jemand mit Zugriff benötigt oder es muss erst noch ein passender Authentik Account angelegt werden.
 === user entfernen ===
-* user manuell aus /etc/ssh/authorized_keys entfernen
+Einfach die entsprechende Zeile löschen.
+=== Tür öffnen ===
+==== Via SSH-Client ====
-=== tuer oeffnen ===
-==== via ssh client ====
 * mit wifi unhb.de verbinden
-* ssh open@door.unhb oeffnet die tuer
+* ssh open@keymaster.unhb öffnet die Tür
-* ssh close@door.unhb schliesst die tuer
+* ssh close@keymaster.unhb schliesst die Tür
-==== via app ====
+Das obige lässt sich mit div. SSH-Clients auch recht bequem für Android oder iOS als "Shortcut" anlegen.
-Aktuell funktioniert (fuer Android): https://github.com/mwarning/trigger
+==== Via Trigger-App ====
+Aktuell funktioniert außerdem (unter Android): https://github.com/mwarning/trigger
+Die App gibt es nicht im Android Playstore. Man kann die App aus dem fDroid-Store runterladen oder direkt die APK von der Homepage.
+Einrichtung:
+Neues Profil anlegen
+* Menü oben rechts "..." und dann "Neu" auswählen
+* Name: UN-Hack-Bar
 * Door Type: ssh
-* Host: door.unhb
+* Require Wifi: Auswählen
+* Key-Pair: Auswählen
+** ED25519 auswählen und "Erstellen"
+** Pubkey aus dem Feld oben kopiere und wie weiter oben beschrieben ins GIT-Repo einfügen
+* Server Address: keymaster.unhb
 * Port: 22
-* User: keymaster
+* Login Name: gatekeeper
-* Open Command: USER=open /home/pi/door.sh
+* Open Command: USER=open /home/gatekeeper/door.sh
-* Close Command: USER=close /home/pi/door.sh
+* Close Command: USER=close /home/gatekeeper/door.sh
-* State Command: /home/pi/get_space_status.py
 * SSIDs: unhb.de
-== mqtt ==
+Alternativ kann dieser QR Code gescannt werden (der Schritt mit dem SSH-Schlüsselpaar muss dann nachträglich gemacht werden):
-saemtliche schliessvorgaenge werden via mqtt geloggt und ausgeloest
+[[File:Unhb-door-qr.png|250px]]
-'''relevante topics:'''
-* /unhb/..../set/
+Todo:
-* /unhb/..../get/
+* State Command: /home/pi/get_space_status.py
+== Matrix ==
+Bei jedem öffnen/schließen wird eine Nachricht mit dem Namen für den verwendeten SSH Keys in den "Space Operation Center" Matrix-Kanal geschickt.
 [[Kategorie:Projekt]]