Das Interface ekey bionyx nimmt Benachrichtigungen von ekey entgegen, z. B. erkannte Finger oder Zutrittsereignisse. Auf diese Meldungen reagieren Sie mit einem ekey-Trigger. Das Interface arbeitet als Server: ekey muss die Meldungen aktiv an die Box senden.
Voraussetzungen
- Eine ekey-Installation, die Benachrichtigungen an eine URL senden kann.
- Erreichbarkeit der Box: über den Proxy (
https://<Boxname>.x2.energy/<URL>) oder direkt im internen Netz (http://<IP>/<URL>). - Die aus der ekey-App exportierte Parameterdatei.
So gehen Sie vor
- Legen Sie ein Interface vom Typ ekey bionyx an. URL und Access-Token werden zufällig vorbelegt.
- Behalten Sie die vorgegebene URL bei und tragen Sie diese in der ekey-App als Ziel ein.
- Tragen Sie das Access-Token in der ekey-App ein. Stellen Sie als Gültigkeitsdauer
3122064000ein (entspricht 99 Jahren), damit es nicht abläuft. Sonst müssen Sie es von Hand erneuern. - Laden Sie über ekey Upload die Parameterdatei aus der ekey-App hoch. Dadurch lernt das Interface die Geräte und Benutzer kennen.
- Speichern Sie das Interface.
- Richten Sie einen ekey-Trigger ein und wählen Sie dort dieses Interface.
Felder
| Feld | Bedeutung | Hinweis |
|---|---|---|
| Name, Kommentar | Bezeichnung und Notiz | Standardfelder aller Interfaces |
| Optionen | Checkbox Deaktiviert | |
| Logging-Stufe | Umfang der Log-Einträge | Standard «Warn» |
| URL | Adresse, unter der das Interface Meldungen empfängt | Beim Anlegen zufällig erzeugt (/ekey/…). Muss mit / beginnen, darf nicht damit enden, nur URL-taugliche Zeichen, nicht von einem anderen Interface verwendet |
| Access-Token | Autorisiert eingehende Meldungen, ähnlich einem Passwort | Beim Anlegen zufällig erzeugt. Ist das Feld leer, wird nicht geprüft |
| ekey Upload | Liest die exportierte Parameterdatei ein | Neu hochladen, wenn in der ekey-App Benutzer oder Geräte geändert wurden. Die Datei muss Geräte oder Benutzer enthalten |
| Erlaube unbekannte Geräte | Lässt Geräte zu, die nicht in der Parameterdatei stehen | Standard: aus. Nicht empfohlen |
| Erlaube unbekannte Benutzer | Lässt Benutzer zu, die nicht in der Parameterdatei stehen | Standard: aus. Nicht empfohlen |
Zusätzlich zeigt die Oberfläche die aus der Datei übernommenen Geräte und Benutzer.
Hinweise und Grenzen
- Die zufällige URL ist eine erste Hürde: Ohne sie lassen sich keine gefälschten Meldungen senden. Ersetzen Sie URL und Token daher nicht durch leicht erratbare Werte.
- Wer unbekannte Geräte oder Benutzer zulässt, senkt die Sicherheit. Die Oberfläche warnt davor.
- Der Status «grün» heißt bei diesem Interface nur, dass kein Fehler erkennbar ist. Es wartet auf Meldungen von ekey.
- Das Interface unterstützt keine Channels. Meldungen kommen als Ereignisse an das System, nicht als Channel-Werte.