Ekey --> Plan44 --> Digitalstrom

Derk

Guten Abend,

das Ekey Net Light System sendet bei Erkennen von jedem autorisierten und nicht autorisierten Finger, der über einen der Ekey-Terminals gezogen wird, eine UDP Nachricht ins Netzwerk. Der Ekey CV Lan Converter ist dafür zuständig. Er hat eine IP Adresse, aber keine Weboberfläche o.ä. Man kann ihn mittels einer Software konfigurieren und die Empfänger-IP des Ziels des UDP Requests eintragen. Auch kann man den Port definieren. Standardmäßig gibt Ekey Port 56000 vor.

Jede Nachricht von Ekey enthält Informationen wie "Welches Terminal", "Welcher User", "Welcher Finger", "autorisiert ja / nein" etc.

Wie könnte man dies in der P44 abfangen und verarbeiten?

Ich sah bereits dies hier in der Dokumentation, möchte aber auch jetzt nicht "wild" irgendetwas in meinem Plan44 globalen Skript Bereich eintragen:

var s = udpsocket("127.0.0.1", 4242, true, true);
on (s.message()) as msg
{
log('Nachricht auf UDP-Port 4242: '+string(msg))
}

In einem ersten Schritt will ich überhaupt erst Mal sehen, wie die gesendeten Informationen von Ekey aufgebaut sind. Danach könnte man dann entscheiden, wie das am besten ins DS System überführt wird.

Beste Grüße

luz

Derk Wie könnte man dies in der P44 abfangen und verarbeiten?
Ich sah bereits dies hier in der Dokumentation [...]

Genau, mit udpsocket() kann man auf UDP-Nachrichten lauschen kann und/oder selber welche absetzen.
Das Beispiel aus der Doku kann gut ins Mainscript übernommen werden, ausser loggen tut es nichts. Die erste Frage ist dann, auf welchen Port sendet das Ekey? Und sendet es gezielt an eine IP-Adresse, oder Broadcast?
Um Broadcasts zu sehen, muss bei udpsocket() noch ein drittes true als Argument übergeben werden, s. Doku.

Dann müsste man herausfinden, was genau der Ekey sendet. Ich könnte mir vorstellen, dass bei einem eher sicherheitsrelevanten Gerät das auch irgendwie verschlüsselt ist. Da könnte es dann komplizierter werden...

Derk

Es sendet an eine IP Adresse. Da würde ich nun die Plan44 hinterlegen. Allerdings verstehe ich leider nicht, wozu ich im Socket eine IP-Adresse hinterlegen soll. Oder soll das die IP Adresse des absendenden Geräts, also des Ekeys, sein?

Beste Grüße

luz

Derk Allerdings verstehe ich leider nicht, wozu ich im Socket eine IP-Adresse hinterlegen soll.

Das ist die IP-Adresse, an den der Socket selber UDP-Pakete senden würde, wenn Sie die send()-Methode verwenden würden. Für einen reinen Empfänger ist die nicht relevant, deshalb steht im Beispiel 127.0.0.1 (localhost).

Derk

Hm, das Log gibt nun bei einem erfolgreichen Finger "Script log: Nachricht auf UDP-Port 56000: \x03" aus. Laut Doku von Ekey ist X03 aber lediglich der erste Teil eines Arrays.

Hier in dem Video wird das ab Minute 10 erklärt: https://www.youtube.com/watch?v=esKHt5e0IPk

luz

Dann sind das wohl Binärdaten. Nach dem \x03 folgt vermutlich ein \x00, das die String-Anzeige terminiert.
Damit mans lesen kann, einfach hex() verwenden:

log('Nachricht auf UDP-Port 4242: '+hex(msg, ','))

Derk

Ok, das funktioniert und führt zu

Script log: Nachricht auf UDP-Port 56000: 03,00,00,00,01,00,00,00,AF,04,9E,53,38,30,31,35,37,30,32,35,31,37,31,31,39,39,01,00,65,00,00,00,04,00,00,00,30,30,30,30,30,30,30,30,30,30,30,30,30,30,30,30,32,30,32,32,30,32,30,33,20,32,33,32,31,34,39,00,00,00,00,00

Ich werde in den nächsten Tagen mal sezieren, was das bedeutet. Und dann kann man daraus wahrscheinlich relativ einfach etwas Sinnvolles zaubern. Vielleicht schaffe ich das sogar selbst - zumindest bis zu einem gewissen Grad. Ich werde es mal versuchen und dann die Ergebnisse hier aufzeigen.

Wenn ich den Ekey Lan Converter von "rare" auf "net" umstelle, folgt statt der obigen Zeichenfolge dies hier:

31,5F,30,30,30,31,30,31,5F,34,5F,38,30,31,35,37,30,31,39,31,37,30,39,32,38,5F,30,30,30,30,30,31.

Edit: Ok, das ist ein ASCII Code. Der löst auf zu 1_000101_4_80157019170928_000001. Das entspricht wiederum schon ziemlich genau der Tabelle in dem Handbuch von Ekey (Anhang). Image description . Der Unterschied im letzten Teil ist wohl auf die Abweichung der Protokolle zurückzuführen. Ich verwende "net" statt "home". Ekey Support ist bezüglich des Unterschieds angefragt. Home ist bei mir nicht verfügbar.

Frage: Kann die Plan44 Hexadezimal in ASCII umcodieren? Gibt es eine fertige Funktion dafür?

Sobald dies möglich ist, kann man anhand des Unterstrichs die einzelnen Teile des Strings auslesen und dann zerlegt verwerten. Das ist dann nicht mehr so schwierig, denke ich. Wobei ich auch noch eine Funktion zum Zerlegen des Strings brauche. Das wird vermutlich substr(string, from [, count]) sein, oder?

luz

Derk

Derk Kann die Plan44 Hexadezimal in ASCII umcodieren?

Ja, das ist das Gegenteil von hex(), die Funktion heisst binary().

Wenn der Input von binary ein Hex-String ist, der eine Reihe von ASCII-Zeichen repräsentiert, dann ist das Resultat diese ASCII-Zeichen. Die Funktion heisst aber binary(), weil ein Hex-Input eben auch "Zeichen" ausserhalb von ASCII repräsentieren kann, und deshalb u.U. zu nicht-druckbaren, eben binary Strings führen kann.

hex('ABC')
// ergibt '414243'
binary('414243')
// ergibt 'ABC'
var b = binary('41004243')
// ergibt direkt ausgeduckt nur 'A', weil das 0 beim Ausdrucken den String beendet (terminiert).
substr(b,2)
// ergibt 'BC'
// denn das B und C ist immer noch vorhanden, nur halt _hinter_ dem 0
// hier wird es aus dem String herausgepflückt, so ist es wieder sichtbar

Derk Das wird vermutlich substr(string, from [, count]) sein, oder?

Genau 😀

Derk

Okay, das bringt mich schon mal einen Schritt weiter. Die Funktion

var Ekey1 = udpsocket("127.0.0.1", 56000, true, true);
on (Ekey1.message()) as msg1
{
log('Nachricht auf UDP-Port 56000: '+binary(string(hex(msg1))))
}
liefert die korrekt kodierte Zeichenkette, die man nun verarbeiten kann :-) Aber natürlich nur, wenn der Lan Converter von Ekey auf "Net" steht und nicht auf "rare"

Derk

Das Log gibt nun also z.B. aus:

Script log: Nachricht auf UDP-Port 56000: 1_000101_4_80157019170928_000001 für einen autorisierten Finger und z.B. Script log: Nachricht auf UDP-Port 56000: 1_000000_1_80157019170928_000001 für einen nicht autorisierten Finger. Dabei sind für uns eigentlich bloß drei Datenteile von Interesse. Nämlich der durch unterstriche getrennte zweite Ausdruck (und davon auch bloß die letzten drei Ziffern; in dem Fall 101). Das ist die User-ID. Die einstellige Zahl im dritten Ausdruck ist der genutzte Finger [hier 4; was dem linken Zeigefinger entspricht]. Die lange Ziffernkette danach ist die ID des Fingerscanners und dient somit der Identifikation, welcher Fingerscanner genutzt wurde. Der Rest ist irrelevant. Nächster Step ist nun das Zerlegen dieses Ausdrucks in diese Teile und dann das Hinterlegen, was was ist. :-)

Edit: Folgenden Code habe ich dafür nun gebastelt:

var EkeyUDPMessage = udpsocket("127.0.0.1", 56000, true, true);
on (EkeyUDPMessage.message()) as msg1
{
  var Code = string(msg1)
  
  log('Nachricht auf UDP-Port 56000: '+Code)
  var EkeyUser = substr(Code,5,3)
  var EkeyFinger = substr(Code,9,1)
  var EkeyFingerprint = substr(Code,11,14)
  log('EkeyUser = ' +EkeyUser)
  log('EkeyFinger = ' +EkeyFinger)
  log('EkeyFingerprint = ' +EkeyFingerprint)
}

Das gibt nun die korrekten Werte einzeln aus.

Als nächstes muss das nun verarbeitet werden für entsprechende Devices in DS. Da mache ich mir erst mal konzeptionelle Gedanken.