DoorLine Key

Externe Code-Auswertung

Neben den lokal hinterlegten Benutzern kann die DoorLine Key Zutrittscodes an ein anderes System zur Auswertung übergeben. Damit lassen sich Codes im Smart Home verwalten — zum Beispiel Einmalcodes, Codes aus einer Buchungssoftware oder Codes mit Regeln, die über Zeitprofile und Zeiträume hinausgehen.

image-20260805-083425.png

Funktionsweise

  1. Ein Code wird am Tastenfeld eingegeben und mit der Bestätigungstaste abgeschlossen.

  2. Das Gerät prüft zuerst die lokale Benutzerliste. Bei einem Treffer wird der Code wie gewohnt lokal ausgewertet und die hinterlegten Aktionen werden ausgeführt.

  3. Nur wenn kein lokaler Benutzer passt, gibt das Gerät die Eingabe als Ereignis über die Geräte-API an den externen Auswerter weiter.

  4. Der externe Auswerter entscheidet und löst seinerseits die gewünschte Aktion aus — zum Beispiel das Schalten eines Relais über die Geräte-API.

Die lokale Benutzerverwaltung bleibt also aktiv. Beide Wege lassen sich nebeneinander betreiben.

Einrichtung

  1. In der Weboberfläche „Einstellungen → System → Tastatur" öffnen.

  2. „Externe Code-Auswertung (Geräte-API)" auf „Ein" setzen.

  3. Am Seitenende „Speichern" auswählen.

  4. Im auswertenden System eine WebSocket-Verbindung zum Gerät aufbauen und auf die Keypad-Ereignisse reagieren (siehe „REST- und WebSocket-API").

Verhalten weitergereichter Eingaben

Merkmal

Verhalten

Fehlversuchszähler

wird nicht erhöht

Sperre nach 5 Fehleingaben

greift nicht

Akustische Rückmeldung durch das Gerät

erfolgt nicht

Rückmeldung an die Person vor der Tür

übernimmt der externe Auswerter

Für weitergereichte Codes entfällt der geräteseitige Schutz gegen systematisches Durchprobieren. Das auswertende System muss diesen Schutz übernehmen — zum Beispiel durch eine eigene Zählung der Fehlversuche und eine zeitweise Sperre. Ohne solche Maßnahmen lässt sich ein Code unbegrenzt oft erraten.

Der externe Auswerter ist nur über das Netzwerk erreichbar. Bei einem WLAN-Ausfall werden keine Eingaben weitergereicht; ausschließlich extern verwaltete Codes gewähren dann keinen Zutritt. Für einen netzunabhängigen Zutritt mindestens einen lokalen Benutzer mit der Berechtigung „Immer" und einer Relais-Aktion anlegen (siehe Kapitel „4. Konfiguration").

Abgrenzung zu den HTTP-Aktionen

HTTP-Aktionen (Webhooks)

Externe Code-Auswertung

Der Code ist lokal hinterlegt.

Der Code ist dem Gerät unbekannt.

Das Gerät entscheidet über den Zutritt und meldet ihn nur weiter.

Das Drittsystem entscheidet über den Zutritt.

Fehlversuchszähler und Sperre greifen.

Fehlversuchszähler und Sperre greifen nicht.

Das Gerät quittiert akustisch.

Die Rückmeldung übernimmt das Drittsystem.