Türschloss/Client-Einrichtung: Difference between revisions

Latest revision as of 19:41, 7 April 2024

Vorgehen

Suche dir aus, welchen SSH-Client du für das Türschloss verwenden willst.
- Unter Clients gibt es detaillierte Anleitungen für einige Clients. Die Liste ist aber nicht abschliessend.
Richte den Client (gemäss Anleitung oder nach eigenem Ermessen) ein.
Teile dem Vorstand deine(n) SSH Public Key(s) mit und warte auf Rückmeldung, dass die Keys hinzugefügt wurden.
Teste das Öffnen und Schliessen mit dem neu eingerichteten Client.

Clients

Eine Liste an Clients für unser Türschloss. Die Liste darf gerne mit weiteren Anleitungen ergänzt werden.

Grundsätzlich sollten alle SSH-Clients funktionieren, die SSH-Keys und nicht-interaktive Sessions unterstützen.

Linux/BSD/macOS...

OpenSSH

Key erzeugen: ssh-keygen -t ed25519 -C "username@device" -f ~/.ssh/id_ed25519_cccbasel_door
Sende den Inhalt der Datei ~/.ssh/id_ed25519_cccbasel_door.pub an den Vorstand

Füge folgende Konfiguration in die Datei ~/.ssh/config hinzu:

Host door
  HostName door.lan.kabelsalat.ch
  IdentityFile ~/.ssh/id_ed25519_cccbasel_door

Verwendung:
- Öffnen
  - ssh open@door oder
  - ssh door@door open
- Abschliessen
  - ssh close@door oder
  - ssh door@door close
- Statusabfrage
  - ssh status@door oder
  - ssh door@door status

Windows

OpenSSH

Ist ab Windows 10 von Haus aus mit dabei. Bedienung gleich wie bei Linux.

PuTTY

Der wohl bekannteste SSH-Client für Windows: https://putty.org/ Die GUI ist etwas mühsam, PLink geht evtl. etwas besser (siehe weiter unten).

Das Programm puttygen starten.
(1) Key-Typ auswählen.
(2) Generate klicken und Entropie erzeugen.
(3) Einen aussagekräftigen Kommentar setzen. Sollte deinen Nick beinhalten.
(4) Den Private Key in einer Datei speichern.
(5) Den Public Key kopieren und dem Vorstand mitteilen.
Das Programm putty starten.
(1) Im Menü nach Connection/Data navigieren.
(2) Als Username open setzen.
(1) Im Menü nach Connection/SSH/Auth/Credentials navigieren.
(2) Das eben erzeugte SSH-Keyfile laden.
(1) Im Menü nach Session navigieren.
(2) Als Hostname door.lan.kabelsalat.ch eingeben.
(3) Der Verbindung einen Namen geben.
(4) Die Verbindung speichern.
(1) Im Menü nach Connection/Data navigieren.
(2) Als Username close setzen.
(1) Im Menü nach Session navigieren.
(2) Der Verbindung zum Schliessen einen anderen Namen geben.
(3) Die Verbindung speichern.
Fertig. Mit Doppelklick auf die gespeicherten Verbindung kann die Tür geöffnet oder abgeschlossen werden.

PLink

PLink ist das Kommandozeilen-Äquivalent von PuTTY und Teil der PuTTY-Installation.

Mit puttygen ein SSH-Keypair erzeugen (analog zu PuTTY)
CLI-Verwendung:
- Öffnen: plink -batch -i privkey.ppk open@door.lan.kabelsalat.ch
- Abschliessen: plink -batch -i privkey.ppk close@door.lan.kabelsalat.ch

Tipp: Die beiden plink-Kommandozeilen lassen sich zum schnellen Zugriff als Windows-Verknüpfungen ablegen (Rechtsklick auf Desktop, neue Verknüpfung)

Android

Trigger

Der am besten geeignete Android-Client. Gibt's hier:

F-Droid
GitHub-Release
Google Play Store (App wurde Anfang 2024 von Google gelöscht, Neuveröffentlichung ist geplant.)

Setup:

«Scan QR-Code» auswählen.
Diesen QR-Code hier scannen.
«Key Pair» auswählen.
«Create», dann «Export Public Key», dann «OK» auswählen.
«Save» auswählen.
Fertig. Den SSH-Key (im Clipboard) z.B. via Matrix-Client dem Vorstand zukommen lassen.

ConnectBot

Funktioniert aktuell (2024-03) nicht.

PR mit einem Fix ist offen: https://github.com/connectbot/connectbot/pull/1384

...

Termius

Nicht open-source
Google Play Store: https://play.google.com/store/apps/details?id=com.server.auditor.ssh.client

Anleitung: Sollte in etwa gleich sein wie iOS.

iOS

Termius

App Store: https://apps.apple.com/us/app/termius-terminal-ssh-client/id549039908

Tippe auf "New Host".
Setze ein Label (1), den Hostname "door.lan.kabelsalat.ch" (2) und den Username "open" (3). Tippe danach auf "Key" (4).
Tippe auf "New Key".
Lass alle Einstellungen so, wie sie sind, und tippe auf "Save".
Tippe lang auf den erzeugten Key (1) und wähle "Share" (2). Lass den geteilten Public Key dem Vorstand zukommen. Tippe danach erneut auf den Key, um ihn für den Host auszuwählen.
Zurück in der Host-Einrichtung: Tippe auf "Save".
Tippe lang auf den Host, und tippe im Kontextmenü auf "Duplicate".
Bearbeite die Kopie des Hosts, setze ein neues Label (1) und ändere den User auf "close" (2). Danach speichern (3).

Hinweis: Aus irgendeinem Grund löst Termius die öffnen/schliessen-Aktionen jeweils doppelt aus. Ist aber kein eigentliches Problem.

@@ Line 1: / Line 1: @@
+== Vorgehen ==
-Clients für unser [[Türschloss]].
+# Suche dir aus, welchen SSH-Client du für das Türschloss verwenden willst.
-== Android ==
+#* Unter [[#Clients|Clients]] gibt es detaillierte Anleitungen für einige Clients.  Die Liste ist aber nicht abschliessend.
+# Richte den Client (gemäss Anleitung oder nach eigenem Ermessen) ein.
+# Teile dem [[Kontakt#Vereinsvorstand|Vorstand]] deine(n) SSH Public Key(s) mit und warte auf Rückmeldung, dass die Keys hinzugefügt wurden.
+# Teste das Öffnen und Schliessen mit dem neu eingerichteten Client.
-=== Trigger ===
+== Clients ==
+Eine Liste an Clients für unser [[Türschloss]].
+Die Liste darf gerne mit weiteren Anleitungen ergänzt werden.
+Grundsätzlich sollten alle SSH-Clients funktionieren, die SSH-Keys und nicht-interaktive Sessions unterstützen.
+=== Linux/BSD/macOS... ===
+==== OpenSSH ====
+# Key erzeugen: <code>ssh-keygen -t ed25519 -C "username@device" -f ~/.ssh/id_ed25519_cccbasel_door</code>
+# Sende den Inhalt der Datei <code>~/.ssh/id_ed25519_cccbasel_door.pub</code> an den Vorstand
+# Füge folgende Konfiguration in die Datei <code>~/.ssh/config</code> hinzu:
+#: <syntaxhighlight lang="conf">
+Host door
+  HostName door.lan.kabelsalat.ch
+  IdentityFile ~/.ssh/id_ed25519_cccbasel_door
+</syntaxhighlight>
+# Verwendung:
+#* Öffnen
+#** <code>ssh open@door</code> oder
+#** <code>ssh door@door open</code>
+#* Abschliessen
+#** <code>ssh close@door</code> oder
+#** <code>ssh door@door close</code>
+#* Statusabfrage
+#** <code>ssh status@door</code> oder
+#** <code>ssh door@door status</code>
+=== Windows ===
+==== OpenSSH ====
+Ist ab Windows 10 von Haus aus mit dabei.  Bedienung gleich wie bei Linux.
+==== PuTTY ====
+Der wohl bekannteste SSH-Client für Windows: https://putty.org/
+Die GUI ist etwas mühsam, PLink geht evtl. etwas besser (siehe weiter unten).
+<gallery>
+File:Türschloss Putty Setup 1.png|Das Programm <code>puttygen</code> starten.<br>(1) Key-Typ auswählen.<br>(2) Generate klicken und Entropie erzeugen.<br>(3) Einen aussagekräftigen Kommentar setzen.  Sollte deinen Nick beinhalten.<br>(4) Den Private Key in einer Datei speichern.<br>(5) Den Public Key kopieren und dem Vorstand mitteilen.
+File:Türschloss Putty Setup 2.png|Das Programm <code>putty</code> starten.<br>(1) Im Menü nach <code>Connection</code>/<code>Data</code> navigieren.<br>(2) Als Username <code>open</code> setzen.
+File:Türschloss Putty Setup 3.png|(1) Im Menü nach <code>Connection</code>/<code>SSH</code>/<code>Auth</code>/<code>Credentials</code> navigieren.<br>(2) Das eben erzeugte SSH-Keyfile laden.
+File:Türschloss Putty Setup 4.png|(1) Im Menü nach <code>Session</code> navigieren.<br>(2) Als Hostname <code>door.lan.kabelsalat.ch</code> eingeben.<br>(3) Der Verbindung einen Namen geben.<br>(4) Die Verbindung speichern.
+File:Türschloss Putty Setup 5.png|(1) Im Menü nach <code>Connection</code>/<code>Data</code> navigieren.<br>(2) Als Username <code>close</code> setzen.
+File:Türschloss Putty Setup 6.png|(1) Im Menü nach <code>Session</code> navigieren.<br>(2) Der Verbindung zum Schliessen einen anderen Namen geben.<br>(3) Die Verbindung speichern.
+File:Türschloss Putty Setup 7.png|Fertig.  Mit Doppelklick auf die gespeicherten Verbindung kann die Tür geöffnet oder abgeschlossen werden.
+</gallery>
+==== PLink ====
+PLink ist das Kommandozeilen-Äquivalent von PuTTY und Teil der PuTTY-Installation.
+# Mit <code>puttygen</code> ein SSH-Keypair erzeugen (analog zu PuTTY)
+# CLI-Verwendung:
+#* Öffnen: <code>plink -batch -i privkey.ppk open@door.lan.kabelsalat.ch</code>
+#* Abschliessen: <code>plink -batch -i privkey.ppk close@door.lan.kabelsalat.ch</code>
+<gallery>
+File:Türschloss_PLink_Setup_1.png|Tipp: Die beiden plink-Kommandozeilen lassen sich zum schnellen Zugriff als Windows-Verknüpfungen ablegen (Rechtsklick auf Desktop, neue Verknüpfung)
+</gallery>
+=== Android ===
+==== Trigger ====
 Der am besten geeignete Android-Client.  Gibt's hier:
 * [https://f-droid.org/en/packages/com.example.trigger/ F-Droid]
 * [https://github.com/mwarning/trigger GitHub-Release]
+* [https://play.google.com/store/apps/details?id=app.door_trigger Google Play Store] (App wurde Anfang 2024 von Google gelöscht, [https://github.com/mwarning/trigger/issues/80#issuecomment-2028216204 Neuveröffentlichung ist geplant.])
-* (Aktuell kein Build im Google Play Store)
 Setup:
@@ Line 20: / Line 91: @@
 File:Türschloss_Trigger_Setup_6.png|Fertig.  Den SSH-Key (im Clipboard) z.B. via Matrix-Client dem Vorstand zukommen lassen.
 </gallery>
+==== ConnectBot ====
+Funktioniert aktuell (2024-03) nicht.
+PR mit einem Fix ist offen: https://github.com/connectbot/connectbot/pull/1384
+...
+==== Termius ====
+* '''Nicht open-source'''
+* Google Play Store: https://play.google.com/store/apps/details?id=com.server.auditor.ssh.client
+Anleitung: Sollte in etwa gleich sein wie iOS.
+=== iOS ===
+==== Termius ====
+App Store: https://apps.apple.com/us/app/termius-terminal-ssh-client/id549039908
+<gallery>
+File:Türschloss Termius Setup 1.png|Tippe auf "New Host".
+File:Türschloss Termius Setup 2.png|Setze ein Label (1), den Hostname "door.lan.kabelsalat.ch" (2) und den Username "open" (3).  Tippe danach auf "Key" (4).
+File:Türschloss Termius Setup 3.png|Tippe auf "New Key".
+File:Türschloss Termius Setup 4.png|Lass alle Einstellungen so, wie sie sind, und tippe auf "Save".
+File:Türschloss Termius Setup 5.png|Tippe lang auf den erzeugten Key (1) und wähle "Share" (2).  Lass den geteilten Public Key dem Vorstand zukommen.  '''Tippe danach erneut auf den Key''', um ihn für den Host auszuwählen.
+File:Türschloss Termius Setup 6.png|Zurück in der Host-Einrichtung: Tippe auf "Save".
+File:Türschloss Termius Setup 7.png|Tippe lang auf den Host, und tippe im Kontextmenü auf "Duplicate".
+File:Türschloss Termius Setup 8.png|Bearbeite die Kopie des Hosts, setze ein neues Label (1) und ändere den User auf "close" (2).  Danach speichern (3).
+</gallery>
+Hinweis: Aus irgendeinem Grund löst Termius die öffnen/schliessen-Aktionen jeweils doppelt aus.  Ist aber kein eigentliches Problem.

Türschloss/Client-Einrichtung: Difference between revisions

Latest revision as of 19:41, 7 April 2024

Contents

Vorgehen

Clients

Linux/BSD/macOS...

OpenSSH

Windows

OpenSSH

PuTTY

PLink

Android

Trigger

ConnectBot

Termius

iOS

Termius

Navigation menu

Türschloss/Client-Einrichtung: Difference between revisions

Latest revision as of 19:41, 7 April 2024

Vorgehen

Clients

Linux/BSD/macOS...

OpenSSH

Windows

OpenSSH

PuTTY

PLink

Android

Trigger

ConnectBot

Termius

iOS

Termius

Navigation menu

Search