Keycards und Smartphoneschlüssel

Wie es funktioniert

Mit Librescoot lässt sich der Roller per NFC auf- und abschließen. Halte eine kompatible Karte an den Leser am Dashboard. Physische Karten werden anhand ihrer festen UID erkannt; ein angelerntes Android-Smartphone authentifiziert sich mit einer signierten Challenge.

Librescoot unterstützt:

• Beliebige NFC-Karten als Keycard nutzen
• Keine Obergrenze bei der Anzahl der Keycards
• Master-Keycards können neue Karten ohne CLI-Zugriff anlernen
• Export und Import der physischen Keycard-Liste für Backups
• Android-Smartphones als Schlüssel mit NFC-Kartenemulation und signierter Authentifizierung
• Namen für Karten und Smartphones, die auf dem Roller gespeichert und in App und Dashboard angezeigt werden

Keycards einrichten

Bei einer Neuinstallation mit dem empfohlenen Installer lernst du deine Karten schon im Installer an – siehe Handbuch: Erste Schritte. Am Roller selbst kann eine Anlernkarte weitere Nutzerkarten ohne Werkzeug anlernen. Die lsc-Befehle unten sind der Rückfallweg für Setups ohne Anlernkarte oder Installer.

Android-Smartphone als Schlüssel verwenden

Auf einem Android-Smartphone mit NFC und Host Card Emulation öffnest du in der Librescoot-App Keycards und wählst Set up / show phone key. Halte danach eine vorhandene Anlernkarte an den Roller, um den Anlernmodus zu starten, dann das entsperrte Smartphone an den Leser und zum Speichern nochmals die Anlernkarte. Bei späteren Versuchen müssen Display und NFC eingeschaltet und das Smartphone entsperrt sein. Doppelte Auflegeversuche werden abgewiesen. Vor dem Anlernen eines Smartphones muss eine Anlernkarte eingerichtet sein.

Der Smartphoneschlüssel ist an den Android Keystore des Geräts gebunden. Nach einer Neuinstallation der App oder dem Verlust des Schlüssels musst du den alten Fingerabdruck vom Roller entfernen und einen neuen Schlüssel anlernen. Das Entsperren per NFC funktioniert unabhängig von BLE; zum Auflisten und Entfernen verbindet sich die App per BLE.

Keycards und Smartphones verwalten

Mit der lsc-CLI verwaltest du deine Keycards:

lsc keycard list               # Alle autorisierten Keycards anzeigen
lsc keycard add <uid>          # Keycard hinzufügen
lsc keycard remove <uid>       # Keycard entfernen
lsc keycard add-master <uid>   # Master-Keycard hinzufügen
lsc keycard export cards.json  # Für Backup exportieren
lsc keycard import cards.json  # Aus Backup importieren

Diese lsc-Befehle verwalten UIDs physischer Karten. Der Export enthält die UIDs physischer Karten. Neue Nutzerkarten kannst du mit einer Anlernkarte direkt am Dashboard anlernen: Anlernkarte zum Starten auflegen, neue Karten auflegen und zum Speichern die Anlernkarte nochmals auflegen. Doppelte Auflegeversuche im Anlernmodus werden abgewiesen.

Bei einem Roller mit Keycard-Protokoll v2 kann die App registrierte Smartphones auflisten und entfernen sowie Nutzerkarten, Anlernkarten und Smartphones benennen. Namen werden auf dem Roller als Anzeigetexte gespeichert und haben Vorrang vor lokal gespeicherten App-Namen. Das Dashboard gruppiert die Schlüssel und markiert die zuletzt verwendete physische Nutzerkarte. Die Verwaltung von Smartphones und Namen setzt keycard=2 auf dem Roller und in der App voraus. Zum Entfernen des letzten Entsperrschlüssels ist eine ausdrückliche Bestätigung erforderlich.