Nedap AEOS Documentatie

1.Doelstelling #

Dit document is bedoeld om systeembeheerders te instrueren over het synchroniseren van een XPressEntry-systeem met het Nedap AEOS toegangscontrolesysteem.

Algemene volgorde van bewerkingen

  1. AEOS SOAP API en SocketInterface instellen (voor evenementen)
  2. Dit omvat doorgaans het aanmaken van een gebruikersaccount of inloggegevens binnen dat systeem
  3. Stel lezers / panelen / enz. In een ander systeem in om gebeurtenissen te ontvangen, indien beschikbaar voor gegevensbeheer
  4. Schakel Data Manager-synchronisatie in vanuit XPressEntry.
  5. Initiële gegevenssynchronisatie en setup XPressEntry-gegevens
  6. Stel XPressEntry Handheld Readers in
  7. Scan gegevens op kaartlezer en valideer functionaliteit

2.AEOS instellen om te synchroniseren met XPressEntry #

Aangenomen wordt dat AEOS op een server is geïnstalleerd. XPressEntry is getest met AEOS versie 2019.1.4. Neem voor integraties in andere versies van AEOS contact op met Telaeris en Nedap om de compatibiliteit te bevestigen.

AEOS moet de SOAP-interface hebben geïnstalleerd.

AEOS Blauw

1. Selecteer tijdens de installatie (setup) van de AEOS-software SOAP WebService in het venster Selecteer de gewenste opties voor het AEOS-toepassingsvenster. Als AEOS al is geïnstalleerd, voer dan de installatie opnieuw uit en verander geen instellingen behalve de selectie van de SOAP WebService.

2. Schakel in AEOS SOAP in de systeemeigenschappen in.

een. ga naar Beheer> Onderhoud> Instellingen> Systeemeigenschappen.

b. Schakel het selectievakje SOAP WebService in (44.15).

c. Klik OK.

d. Start de AEOS-applicatieserverservice opnieuw (zie 6.2).

AEOS Klassiek

1. Koop licentie-optie 8019223.

2. Activeer tijdens de installatie (setup) van de AEOS-software optie 8019223 SOAP WebService.

Volg de instructies uit sectie 1 in de geïnstalleerde "AEOS_WebService_E.pdf" in de AEOS doc-directory.

Zorg ervoor dat poort 8443 (standaard instelbaar in aeos.properties) om de API in te schakelen en 8035 (standaard instelbaar in aeos.properties) beschikbaar zijn vanaf de XPressEntry-server.

3.Maak een gebruikersaccount aan in AEOS #

Maak een gebruikersaccount aan in AEOS voor API-toegang. Deze gebruiker moet de minimaal vereiste toegang hebben om gegevens te synchroniseren met XPressEntry.

Over het algemeen moet het in alle tabellen kunnen zoeken.

Het heeft ook de toestemming nodig: Administratie, Integraties, AEOS WebService, Externe oproepen.

Bovendien moet voor evenementen de gebruikersrol toegang hebben tot de volgende functies:

  • De functie 'Configuratie, socketverbinding, opdrachten'stelt de gebruiker die inlogt via de socketverbinding in staat om commando's naar AEOS te sturen.
  • De functie 'Configuratie, Socketconnection, Events'stelt de gebruiker die inlogt via de socketverbinding in staat om de gebeurtenissen van AEOS op te halen.

4.Stel AEOS-lezers en toegangsniveaus in #

Stel de ingangen en autorisaties in het AEOS-systeem in. Dit kan doorgaans worden uitgesteld tot een latere datum, maar het is fijn om te hebben voordat u begint met het synchroniseren van gegevens.

5.Schakel Data Manager-synchronisatie in XPressEntry in #

Ga vanuit de hoofdtoepassing XPressEntry naar Extra -> Instellingen

  1. Selecteer Gegevensbeheer in de lijst aan de linkerkant
  2. Schakel het selectievakje "Enable Data Manager" in
  3. Selecteer NEDAP als Type
  4. Klik op de knop "Setup Data Manager"

BELANGRIJKE OPMERKING: Na elke wijziging op de NEDAP-instellingenpagina of de Data Manager-weergave, MOET u op Opslaan klikken om deze toe te passen.


Data Manager Setup-pagina

Hiermee gaat u naar het NEDAP Data Manager Setup Form.

AEOS / NEDAP-instellingenpagina

Uitleg van AEOS-opties

server: De DNS-naam of het IP-adres van het AEOS-systeem

Haven: Dit is doorgaans 8443

Gebruiker: Gebruikersnaam in AEOS voor de SOAP-oproepen

Wachtwoord: Het wachtwoord voor die gebruikersnaam

Socket-poort: Voor evenementen is dit de socketpoort (meestal 8035)

Toegang tot evenementen: Dit zijn de geldige toegangsgebeurtenissen die we bekijken om te bepalen of een kaarthouder de faciliteit heeft betreden.

Schakel gebruikersoproep in: Houd dit aangevinkt tenzij je een klein systeem hebt. Houd het gewoon gecontroleerd.

Pagina grootte: Het aantal records op elk oproepverzoek.

Wijs automatisch gebieden aan deuren toe: Vink dit aan als u de “Outside Area” en “Inside Area” wilt toewijzen aan deuren wanneer we het juiste gebied niet kunnen bepalen vanuit AEOS.

Buitenruimte: Het gebied dat is toegewezen aan de buitenkant van de deur.

Binnengebied: Het gebied dat is toegewezen aan de binnenkant van de deur.

Om te testen of de SOAP-API werkt, klikt u op 'Test Connect'

Je zou een reactie moeten verwachten als “Verbindingssucces! AEOS VERSION ”in het Status veld onderaan het formulier.

Merk op dat dit de Socket-verbinding voor gebeurtenissen niet controleert.

Socket-evenementen

Als u van plan bent AEOS Events in XPressEntry te krijgen, moet u de optie "Watch Tables via Software Events" inschakelen. Wanneer u op "Opslaan" klikt in de Data Manager-weergave, zou u iets soortgelijks als het volgende in het logboek moeten zien:

DEBUG: MSG: Reactie: bevestiging = aan;

INFO: TCP-client verbonden

DEBUG: MSG: Status: verbonden met AEOS-versie 2019.1.4 gebouwd op 2019-09-10

INFO: Beginnen met kijken naar tafels

Activiteitstypen:

U kunt ervoor kiezen om volledige activiteiten van deze evenementen te krijgen of alleen bezettingsupdates voor uw kaarthouders.

Om volledige activiteiten te krijgen, vinkt u in de Data Manager-weergave de “Pull DataManager Activities into XPressEntry” aan.

Om alleen bezetting te krijgen, vinkt u de optie "Pull DataManager Occupancy" aan.

Als de bezetting u niets kan schelen, vink dan geen van beide aan en vink de optie "Tafels via software-evenementen bekijken" niet aan.

6.Initiële gegevenssynchronisatie en setup XPressEntry-gegevens #

De volgende stap is het synchroniseren van de gegevens uit AEOS en het instellen van intervallen voor synchronisatie. Hieronder vindt u uitleg voor elk type synchronisatie

Volledige synchronisatie:

Dit synchroniseert alle gegevens van het AEOS-systeem. Dit omvat kaarthouders, tokens, bezoekers en contractanten. Het moet ook foto-informatie voor kaarthouders bevatten.

Dit omvat ook alle gegevens van de gedeeltelijke synchronisatie.

Gedeeltelijke synchronisatie:

Dit synchroniseert de volgende tabellen die voor overhead worden gebruikt:

Zones

Lezers

Deuren

BadgeTypen

groepen

Groeps- / lezer-toewijzingen

Bezettingssynchronisatie:

Als de optie "Pull DataManager Occupancy" is ingeschakeld, worden de kaarthouders gesynchroniseerd met hun huidige locatie uit AEOS.

Activiteitssynchronisatie:

Synchroniseert de gebeurtenissen van AEOS. Dit is alleen van toepassing als de optie "Pull DataManager Activities into XPressEntry" is aangevinkt.

Gegevenstoewijzingen

Hier definiëren we welke tabellen in AEOS naar welke tabellen in XPressEntry verwijzen

AEOS

XPRESSENTRY

Persoon / Bezoeker / Aannemer

Gebruikers

Token

Badges

Ingang

Deur

Access Point

Lezer

7.XPressEntry Handheld-lezers / deuren #

XPressEntry handheld-authenticatie wordt gedaan door twee tabellen. Lezers en deuren.

Er zijn drie soorten lezers in XPressEntry:

  1. De serverlezer - wordt gebruikt om badge-activiteiten van de server toe te wijzen. Dit zal waarschijnlijk "Serverlezer: COMPUTERNAAM" heten en een GUID van 20-22 tekens hebben.
  2. Lezers - Logische lezers die worden gebruikt om toegangsbeheerbevoegdheden van externe systemen toe te wijzen. In het geval van AEOS moeten ze overeenkomen met ingangen
  3. Handhelds - Dit zijn de fysieke handheld-apparaten. Dit zijn meestal een Android-apparaat of apparaat. Deze hebben een GUID op basis van de fysieke machine.

Deuren worden door handhelds gebruikt om dynamisch machtigingen aan een apparaat toe te wijzen. Standaard is het de gebruiker toegestaan ​​om van deur te wisselen vanaf het apparaat. De apparaten gebruiken de machtigingen voor de “Externe in / uitlooplezers” die aan de deur zijn toegewezen om te bepalen of de kaarthouder toestemming heeft om naar de lezer te scannen.

Voor AEOS zullen vervoerders die bij een Entree mogen komen, bij de bijbehorende deuren komen.

Het laatste stuk dat we voor XPressEntry in kaart moeten brengen, zijn de gebieden / lezers voor elke deur. Om dit te doen, moet u mogelijk de instelling 'Bewerken van externe gegevens toestaan' inschakelen

We kunnen dan de deurgebieden / lezers toewijzen vanuit de XPressEntry Add / Edit Info-interface

Als alle ingangen van / naar hetzelfde gebied gaan, of als de bezetting er niet toe doet in uw opstelling, kunt u de optie "Automatisch gebieden aan deuren toewijzen" kiezen op de AEOS Data Manager Setup-pagina.

Raadpleeg het volgende document voor meer informatie over het instellen van het handheld-apparaat en het synchroniseren met de XPressEntry Service:

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

8.Stel XPressEntry in om badge-activiteiten naar AEOS te pushen #

AEOS heeft een InterfaceServer-objectconfiguratie nodig om Events te kunnen ontvangen.

 

Zorg ervoor dat het selectievakje 'Gebeurtenis genereren toegestaan' is ingeschakeld.

Elke interfaceserver kan slechts één identificatietype bedienen. Zorg ervoor dat het geselecteerde identificatietype de juiste prefix heeft uit de volgende tabel:

 

Merk op dat voor sommige generieke typen, 0000 hier de juiste waarde is.

 

De gebruikersnaam/het wachtwoord voor deze InterfaceServer kan anders zijn dan die voor de rest van de API, dus dubbelcheck. Het is standaard nedap / nedap.

Zorg ervoor dat de Data Manager-optie "Push XPressEntry-activiteiten naar Data Manager" is ingeschakeld.

 

Stel Bewerken voor