Hallo zusammen,
ich habe kürzlich, zunächst für den eigenen Gebrauch, ein Programm zum Gestalten von Kartencovern entwickelt: Tonuino-Studio, kostenlos und Open Source (GPLv3). Ursprünglich war es auf den TonUINO gemünzt. Inzwischen bin ich aber auch ESPuino-Fan und würde das Programm gern der Community hier zur Verfügung stellen. Ein erster ESPuino-Modus liest schon die Karten aus dem Mediahub.
Dazu hatte ich mich mit Torsten ausgetauscht, und wir waren uns einig, dass es Sinn macht, das Ganze direkt größer zu denken: eine Schnittstelle, an die auch andere Werkzeuge andocken können, und dazu passend die Anmeldung am ESPuino. Hier meine Idee, ich bin gespannt auf eure Meinung.
Wie es heute ist
- Der ESPuino holt Manifest und Dateien ohne Anmeldung vom Hub. Das ist gewollt, Geräte können sich nicht einloggen.
- Die Weboberfläche des Hubs hat ein optionales Passwort.
- Der ESPuino selbst hat keine Anmeldung: Weboberfläche und REST-Schnittstelle sind für jeden im WLAN offen.
- Beim sicheren Löschen ruft der Hub
DELETE /rfidam ESPuino auf. - Externe Werkzeuge können heute nur die
db.jsonlesen oder die Weboberfläche fernsteuern.
Vorschlag 1: Eine kleine JSON-Schnittstelle im Hub
Unter /api/ lesend:
GET /api/info: Version der Schnittstelle, ob eine Anmeldung nötig istGET /api/devices: Geräte mit Alias und zuletzt aufgelegter KarteGET /api/cards: Karten, filterbar nach Gerät und Status
Schreibend:
POST /api/cards/<esp>/<karte>: Karte zuweisen, mit derselben Prüfung wie das Formular in der WeboberflächePOST /api/cards/<esp>/<karte>/verify: Größe und Prüfsumme der Dateien neu prüfen, z. B. nachdem ein Werkzeug Tags geändert hat
Typischer Ablauf: Karte auf den ESPuino legen, sie landet als neue Karte im Hub, am PC wählt man im Werkzeug das Album und weist zu. Extra-Hardware braucht man dafür nicht.
Der Gedanke dahinter: Zusatzfunktionen wie Cover, Druck, Import aus anderen Programmen oder Statistiken können als eigene Werkzeuge neben dem Hub entstehen und über diese Schnittstelle andocken. Der Hub selbst bleibt schlank, und Torsten muss nicht jede Idee in den Kern übernehmen und pflegen. Dafür muss die Schnittstelle stabil bleiben, deshalb gibt es von Anfang an eine Versionsnummer.
Für die Anmeldung würde ich ein eigenes API-Token vorschlagen, das man in den Hub-Einstellungen erzeugt und jederzeit widerrufen kann, nicht das Web-Passwort. Ist kein Hub-Passwort gesetzt, ist auch die Schnittstelle offen, wie der Rest des Hubs.
Bezug zu PR #4 von @tbaumann: Der PR zeigt schön, was mit dem Hub möglich ist, er baut den Kartendruck direkt in den Hub ein. Mit einer offenen Schnittstelle könnten solche Erweiterungen auch als eigenes Modul neben dem Hub laufen. Das hätte Vorteile für beide Seiten: Der Hub bleibt kleiner und leichter zu pflegen, und ein Modul kann sich in seinem eigenen Tempo weiterentwickeln, ohne auf einen Merge zu warten. Dafür müsste die Schnittstelle auch das können, was der Druckablauf braucht, z. B. Karten, die noch keine UID haben und erst später einer echten Karte zugeordnet werden. Deshalb würde ich die Schnittstelle gern zusammen mit Tilman zuschneiden. Die Prüfung einer Zuweisung, die er in _read_assignment auslagert, würde ich dafür direkt mitbenutzen, damit überall dieselben Regeln gelten.
Vorschlag 2: Optionale Anmeldung am ESPuino
- Standard bleibt aus, damit bestehende Geräte unverändert weiterlaufen.
- Wer ein Passwort setzt, schützt damit Weboberfläche und REST-Schnittstelle.
- Der Hub braucht dann für das sichere Löschen einen Zugang zum Gerät, z. B. ein Geräte-Token, das man im Hub beim Gerät hinterlegt.
- Abruf von Manifest und Dateien durch den ESPuino bleibt wie heute.
Passwort vergessen, ohne den NVS zu löschen
Ein paar Ideen, alle mit dem Grundsatz „wer das Gerät in der Hand hat, darf zurücksetzen“:
- Datei auf der SD-Karte: Liegt beim Start z. B.
reset-password.txtauf der Karte, löscht der ESPuino nur das Passwort und dann die Datei. Einfach, braucht aber Zugang zur SD-Karte (bei manchen Gehäusen umständlich). - Tastenkombination beim Einschalten: öffnet ein paar Minuten lang ein Fenster, in dem man ohne altes Passwort ein neues setzen kann. Ohne Werkzeug, aber die Kombination muss zu allen Tasten-Varianten passen.
- Admin-Karte: eine RFID-Karte, die man beim Einrichten festlegt. Aufgelegt erlaubt sie das Neusetzen. Passt gut zum ESPuino, hilft aber nicht, wenn die Karte weg ist.
Die Wege lassen sich auch kombinieren, z. B. Admin-Karte für den Alltag und die Datei auf der SD-Karte als Rückfallebene. Nach dem Motto: Wer seine Admin-Karte verschlampert, muss zur Strafe das Gehäuse aufschrauben. ![]()
Für den Hub ist das weniger kritisch: Er läuft im Container, das Passwort kann man zurücksetzen, indem man in der db.json den Eintrag password_hash löscht.
Fragen an euch
- Braucht ihr die Schnittstelle überhaupt, und fehlt euch darin etwas?
- Token für die Schnittstelle: einverstanden, oder lieber anders?
- Welche Art des Zurücksetzens oder welche Kombination passt am besten zu euren Boxen?
- @tbaumann: Wäre so eine Schnittstelle für deinen Druckablauf eine Option, und was müsste sie dafür können?
- Wer hätte Lust, mitzutesten?
Viele Grüße
Jochen

