Nedap AEOS Dokumentation

1.Zweck #

Dieses Dokument soll Systemadministratoren anweisen, wie ein XPressEntry-System mit dem Nedap AEOS-Zugriffskontrollsystem synchronisiert wird.

Gesamtreihenfolge

  1. AEOS SOAP API und SocketInterface einrichten (für Ereignisse)
  2. Dies umfasst normalerweise das Erstellen eines Benutzerkontos oder von Anmeldeinformationen in diesem System
  3. Richten Sie Readers / Panels / etc in einem anderen System so ein, dass Ereignisse empfangen werden, sofern diese für den Datenmanager verfügbar sind
  4. Aktivieren Sie die Data Manager-Synchronisierung über XPressEntry.
  5. Erste Datensynchronisation und Einrichtung XPressEntry-Daten
  6. Richten Sie XPressEntry-Handlesegeräte ein
  7. Scannen Sie Daten auf dem Kartenleser und überprüfen Sie die Funktionalität

2.Einrichten von AEOS für die Synchronisierung mit XPressEntry #

Es wird davon ausgegangen, dass AEOS auf einem Server installiert ist. XPressEntry wurde mit AEOS Version 2019.1.4 getestet. Für Integrationen in andere Versionen von AEOS wenden Sie sich bitte an Telaeris und Nedap, um die Kompatibilität zu bestätigen.

Bei AEOS muss die SOAP-Schnittstelle installiert sein.

AEOS Blau

1. Wählen Sie während der Installation der AEOS-Software (Setup) SOAP WebService im Fenster Wählen Sie die gewünschten Optionen für das AEOS-Anwendungsfenster aus. Wenn das AEOS bereits installiert ist, führen Sie das Setup einfach erneut aus und ändern Sie keine Einstellungen außer der Auswahl des SOAP-Webdienstes.

2. Aktivieren Sie in AEOS SOAP in den Systemeigenschaften.

ein. Gehen Sie zu Administration> Wartung> Einstellungen> Systemeigenschaften.

b. Aktivieren Sie das Kontrollkästchen SOAP WebService (44.15).

c. OK klicken.

d. Starten Sie den AEOS-Anwendungsserverdienst neu (siehe 6.2).

AEOS-Klassiker

1. Kaufen Sie die Lizenzoption 8019223.

2. Aktivieren Sie während der Installation (Setup) der AEOS-Software die Option 8019223 SOAP WebService.

Befolgen Sie die Anweisungen aus Abschnitt 1 in der installierten Datei „AEOS_WebService_E.pdf“ im AEOS-Dokumentverzeichnis.

Stellen Sie sicher, dass Port 8443 (standardmäßig in aeos.properties einstellbar) zum Aktivieren der API und 8035 (standardmäßig in aeos.properties einstellbar) vom XPressEntry-Server verfügbar sind.

3.Erstellen Sie ein Benutzerkonto in AEOS #

Erstellen Sie in AEOS ein Benutzerkonto für den API-Zugriff. Dieser Benutzer sollte über den erforderlichen Mindestzugriff verfügen, um Daten mit XPressEntry zu synchronisieren.

Im Allgemeinen muss es in der Lage sein, alle Tabellen zu durchsuchen.

Es benötigt auch die Berechtigung: Administration, Integrationen, AEOS WebService, Externe Aufrufe.

Darüber hinaus muss die Benutzerrolle für Ereignisse Zugriff auf die folgenden Funktionen haben:

  • Die Funktion 'Konfiguration, Socketconnection, Befehle'ermöglicht dem Benutzer, der sich über die Socket-Verbindung anmeldet, Befehle an AEOS zu senden.
  • Die Funktion 'Konfiguration, Socketconnection, Ereignisse'ermöglicht dem Benutzer, der sich über die Socket-Verbindung anmeldet, die Ereignisse von AEOS abzurufen.

4.Richten Sie AEOS-Leser und Zugriffsebenen ein #

Richten Sie die Eingänge und Berechtigungen im AEOS-System ein. Dies kann normalerweise bis zu einem späteren Zeitpunkt verzögert werden, ist jedoch hilfreich, bevor Sie mit der Synchronisierung von Daten beginnen.

5.Aktivieren Sie die Data Manager-Synchronisierung in XPressEntry #

Gehen Sie in der Hauptanwendung von XPressEntry zu Extras -> Einstellungen

  1. Wählen Sie in der Liste links Datenmanager aus
  2. Aktivieren Sie das Kontrollkästchen "Datenmanager aktivieren"
  3. Wählen Sie NEDAP als Typ
  4. Klicken Sie auf die Schaltfläche "Setup Data Manager"

WICHTIGER HINWEIS: Nach jeder Änderung auf der NEDAP-Setup-Seite oder in der Datenmanager-Ansicht MÜSSEN Sie auf Speichern klicken, damit sie angewendet wird.


Data Manager-Setup-Seite

Hiermit gelangen Sie zum NEDAP Data Manager-Setup-Formular.

AEOS / NEDAP-Setup-Seite

Erläuterung der AEOS-Optionen

Server: Der DNS-Name oder die IP-Adresse des AEOS-Systems

Hafen: Dies ist normalerweise 8443

Mitglied: Benutzername in AEOS für die SOAP-Aufrufe

Passwort: Das Passwort für diesen Benutzernamen

Steckdosenanschluss: Bei Ereignissen ist dies der Socket-Port (normalerweise 8035).

Zugriff auf Ereignisse: Dies sind die gültigen Zugriffsereignisse, mit denen wir prüfen, ob ein Karteninhaber die Einrichtung betreten hat.

Aktivieren Sie User Paging: Lassen Sie dies überprüft, es sei denn, Sie haben ein winziges System. Lass es einfach überprüfen.

Seitenformat: Die Anzahl der Datensätze bei jeder Paging-Anforderung.

Bereiche automatisch Türen zuweisen: Aktivieren Sie diese Option, wenn Sie möchten, dass den Türen „Außenbereich“ und „Innenbereich“ zugewiesen werden, wenn wir von AEOS nicht den richtigen Bereich ermitteln können.

Außenbereich: Der Bereich außerhalb der Tür.

Innenbereich: Der Bereich, der der Innenseite der Tür zugeordnet ist.

Um zu testen, ob die SOAP-API funktioniert, klicken Sie auf "Test Connect".

Sie sollten eine Antwort wie „Verbindungserfolg! AEOS VERSION “im Feld Status am unteren Rand des Formulars.

Beachten Sie, dass dadurch die Socket-Verbindung nicht auf Ereignisse überprüft wird.

Socket-Ereignisse

Wenn Sie AEOS-Ereignisse in XPressEntry integrieren möchten, müssen Sie die Option "Tabellen über Softwareereignisse überwachen" aktivieren. Wenn Sie in der Datenmanageransicht auf "Speichern" klicken, sollte im Protokoll Folgendes angezeigt werden:

DEBUG: MSG: Antwort: Bestätigung = ein;

INFO: TCP-Client verbunden

DEBUG: MSG: Status: Verbunden mit AEOS Version 2019.1.4, erstellt am 2019

INFO: Starten des Betrachtens von Tabellen

Aktivitätsarten:

Sie können wählen, ob Sie vollständige Aktivitäten aus diesen Veranstaltungen oder nur Belegungsaktualisierungen für Ihre Karteninhaber erhalten möchten.

Um vollständige Aktivitäten zu erhalten, aktivieren Sie in der Datenmanageransicht die Option "DataManager-Aktivitäten in XPressEntry ziehen".

Aktivieren Sie die Option "DataManager-Belegung abrufen", um nur die Belegung zu erhalten.

Wenn Sie sich nicht für die Belegung interessieren, aktivieren Sie auch nicht die Option "Tabellen über Softwareereignisse überwachen".

6.Erste Datensynchronisation und Einrichtung XPressEntry-Daten #

Der nächste Schritt besteht darin, die Daten von AEOS zu synchronisieren und Intervalle für die Synchronisation einzurichten. Nachfolgend finden Sie Erläuterungen zu den einzelnen Synchronisierungstypen

Vollständige Synchronisierung:

Dadurch werden alle Daten aus dem AEOS-System synchronisiert. Dies schließt Karteninhaber, Token, Besucher und Auftragnehmer ein. Es sollte auch Bildinformationen für Karteninhaber enthalten.

Dies umfasst auch alle Daten aus der Teilsynchronisierung.

Teilweise Synchronisierung:

Dadurch werden die folgenden Tabellen synchronisiert, die für den Overhead verwendet werden:

Zones

Leser

Türen

Abzeichentypen

Gruppen

Gruppen- / Reader-Zuordnungen

Belegungssynchronisierung:

Wenn die Option "DataManager-Belegung ziehen" aktiviert ist, werden die Karteninhaber mit ihrem aktuellen Standort von AEOS synchronisiert.

Aktivitätssynchronisierung:

Synchronisiert die Ereignisse von AEOS. Dies gilt nur, wenn die Option "DataManager-Aktivitäten in XPressEntry ziehen" aktiviert ist.

Datenzuordnungen

Hier definieren wir, welche Tabellen in AEOS welchen Tabellen in XPressEntry zugeordnet sind

AEOS

XPRESSENTRY

Person / Besucher / Auftragnehmer

Benutzer

Zeichen

Abzeichen

Eingang

Tür

Access Point

Leser

7.XPressEntry Handlesegeräte / -türen #

Die XPressEntry-Handheld-Authentifizierung erfolgt über zwei Tabellen. Leser und Türen.

In XPressEntry gibt es drei Arten von Lesern:

  1. Der Server Reader - wird verwendet, um Badge-Aktivitäten vom Server zuzuweisen. Dies wird wahrscheinlich als "Server Reader: COMPUTER NAME" bezeichnet und hat eine 20-22-stellige GUID.
  2. Lesegeräte - Logische Lesegeräte, mit denen Zugriffssteuerungsberechtigungen von externen Systemen zugewiesen werden. Im Fall von AEOS sollten sie den Eingängen entsprechen
  3. Handhelds - Dies sind die physischen Handheld-Geräte. Dies sind normalerweise Android oder Geräte. Diese haben eine GUID, die auf der physischen Maschine basiert.

Türen werden von Handhelds verwendet, um Berechtigungen für ein Gerät dynamisch zuzuweisen. Standardmäßig darf der Benutzer Türen vom Gerät aus wechseln. Die Geräte verwenden die Berechtigungen für die der Tür zugewiesenen „External Entry / Exit Readers“, um festzustellen, ob der Karteninhaber die Berechtigung zum Scannen am Reader hat.

Für AEOS sind Spediteure, die an einem Eingang zugelassen sind, an den entsprechenden Türen zugelassen.

Das letzte Stück, das wir für XPressEntry abbilden müssen, sind die Bereiche / Leser für jede Tür. Dazu müssen Sie möglicherweise die Einstellung "Bearbeiten externer Daten zulassen" aktivieren.

Wir können dann die Türbereiche / Leser über die XPressEntry-Oberfläche zum Hinzufügen / Bearbeiten von Informationen zuweisen

Wenn alle Eingänge zu / von demselben Bereich gehen oder wenn die Belegung in Ihrem Setup keine Rolle spielt, können Sie auf der Seite AEOS Data Manager Setup die Option „Bereiche automatisch Türen zuweisen“ auswählen.

Weitere Informationen zum Einrichten des Handheld-Geräts und zum Synchronisieren mit dem XPressEntry-Dienst finden Sie im folgenden Dokument:

https://telaeris.com/documentation/xpressentry/android/

Vorschlagen Bearbeiten