Hoe μFR Nano Online Log en Access Control Mode in te schakelen?

Digital Logic Ltd. / Knowledge base / Hoe μFR Nano Online Log en Access Control Mode in te schakelen?

Hoe μFR Nano Online Log en Access Control Mode in te schakelen?

μFR Nano Online Log en toegangscontrolemodus #

Hoe schakel ik de logmodus in? #

Log in op de μFR Online Log and Access Control Module Online WEB configurator GUI.
Schakel de hoofdmodus in als deze nog niet is ingeschakeld.
Klik op de optie Opslaan en opnieuw opstarten om de wijzigingen toe te passen.

uFR Online log- en toegangscontrolemodus1

Logboekmodus inschakelen (alleen zichtbaar nadat de mastermodus is ingeschakeld)

uFR Online log- en toegangscontrolemodus 2

Hoe de toegangscontrolemodus in te schakelen? #

Log in op de μFR Online Log and Access Control Module Online WEB configurator GUI.
Schakel de logmodus in.
Schakel de toegangscontrolemodus in (alleen beschikbaar als de logboekmodus eerder is ingeschakeld).
Schakel μFR Online uit vanaf de voeding
Sluit het toegangscontrolebord aan.
μFR Online inschakelen vanaf de voeding

uFR Online schakelt log- en toegangscontrolemodus in

De toegangscontrolemodus moet worden ingeschakeld voordat de toegangscontrolekaart wordt aangesloten.

Extra opties voor toegangscontrolemodus #

Relaispulstijd: hoeveel milliseconden relaisuitgangen blokgolfpuls
Relaispulsfrequentie: Blokgolfuitgangsfrequentie in Hz
Relais pulsvermogen: Blokgolf uitgangsvermogen (duty cycle)
Relais actieve tijd: hoeveel milliseconden om de output hoog te houden na een blokgolfpuls

uFR Online log en toegangscontrole modus 4

Gebruiksvoorbeelden #

In deze sectie worden twee primaire use case-scenario's beschreven.

Logmodus zonder toegangscontrole #

Schakel de logboekmodus in en zorg ervoor dat de toegangscontrolemodus is uitgeschakeld.

Navigeer naar het gedeelte logboekmodus en klik op de knop Bewerken.
Voer de host-URL van de logserver in.
Klik op de knop Opslaan.
Klik op de knop Opslaan en opnieuw opstarten.
De logmodus is nu klaar voor gebruik.

De onderstaande tabel beschrijft welke kaarten zijn toegestaan of geweigerd op basis van zwarte of witte lijst.

Scenario	Toegestaan / Geweigerd
Blanco zowel, de witte lijst als de zwarte lijst	Alle kaarten zijn toegestaan
Witte lijst leeg en zwarte lijst niet leeg	Alle kaarten behalve de kaarten op de zwarte lijst zijn toegestaan
Witte lijst niet leeg en zwarte lijst leeg	Alleen kaarten op de witte lijst zijn toegestaan
Zowel de witte lijst als de zwarte lijst zijn niet leeg	Alleen kaarten op de witte lijst die niet op de zwarte lijst staan, zijn toegestaan
Exclusieve witte lijst ingeschakeld	Alleen kaarten op de witte lijst die niet op de zwarte lijst staan, zijn toegestaan (in de pro-modus zijn alleen bedrijfskaarten op de witte lijst toegestaan, behalve op de zwarte lijst)
Als een kaart is toegestaan, piept de lezer één keer en wordt het groene lampje ingeschakeld. Als een kaart wordt geweigerd, piept de lezer niet en wordt het rode lampje ingeschakeld.

Logmodus met toegangscontrole #

Schakel de logboekmodus in en zorg ervoor dat de toegangscontrolemodus is ingeschakeld.

Navigeer naar het gedeelte logboekmodus en klik op de knop Bewerken.
Voer de host-URL van de logserver in.
Klik op de knop Opslaan.
Klik op de knop Opslaan en opnieuw opstarten.
De logmodus met toegangscontrole is nu klaar voor gebruik.

Scenario	Toegestaan/Geweigerd
Lege witte lijst en zwarte lijst	Alle kaarten worden geweigerd (in de pro-modus zijn alle bedrijfskaarten toegestaan)
Witte lijst leeg en zwarte lijst niet leeg	Alle kaarten worden geweigerd (in de pro-modus zijn alle bedrijfskaarten toegestaan, behalve op de zwarte lijst)
Witte lijst niet leeg en zwarte lijst leeg	Alleen kaarten op de witte lijst zijn toegestaan (in de pro-modus zijn alle bedrijfskaarten toegestaan, behalve op de zwarte lijst)
Zowel de witte lijst als de zwarte lijst zijn niet leeg	Alleen kaarten op de witte lijst die niet op de zwarte lijst staan, zijn toegestaan (in de pro-modus zijn alle bedrijfskaarten toegestaan, behalve op de zwarte lijst)
Exclusieve witte lijst ingeschakeld	Alleen kaarten op de witte lijst die niet op de zwarte lijst staan, zijn toegestaan (in de pro-modus zijn alleen bedrijfskaarten op de witte lijst toegestaan, behalve op de zwarte lijst)
Als een kaart is toegestaan, piept de lezer één keer en wordt het groene lampje ingeschakeld. Ook zal het toegangscontrolebord een relais activeren, één keer piepen en de externe LED-ring inschakelen. Als een kaart wordt geweigerd, piept de lezer niet en wordt het rode lampje ingeschakeld. Ook zal het toegangscontrolebord de externe LED-ring inschakelen.

De onderstaande tabel beschrijft welke kaarten zijn toegestaan of geweigerd op basis van zwarte of witte lijst.

Hoe bekabel ik de toegangscontrolekaart? #

uFR Online log en toegangscontrole modus 5

Er is ook een vooraf gemaakte kabel voor het aansluiten van μFR Online en de toegangscontrolekaart.

OPMERKING: De toegangscontrolemodus moet zijn ingeschakeld voordat de besturingskaart wordt aangesloten, anders wordt pieper altijd ingeschakeld.

Indeling van het logboek in de lezer #

Alle logboekgebeurtenissen worden opgeslagen in een door mensen leesbare JSON-indeling.

Voorbeeld van het logboek dat is opgeslagen in de μFR Online-lezer:

{"log":[ {"id":1,"uid":"11223344","time":"2022-08-15 06:56:02","delta":16,"type":0,"reader":1,"status":0}, {"id":2,"uid":"AABBCCDD","time":"2022-08-15 06:56:04","delta":18,"type":0,"reader":1,"status":2} ]}
JSON-sleutel/knooppuntnaam	Beschrijving
.log	Hoofdknooppunt dat logboekgebeurtenissen bevat
Id	Unieke gebeurtenis-id voor logboekregistratie voor automatische verhoging
Uid	Unieke ID van de kaart
PID	Persoonlijke ID. Alleen beschikbaar in Pro-modus
tijd	Datum/tijd van gebeurtenis registreren in UTC-indeling
Delta	Tijdsverschil tussen twee logboekgebeurtenissen
Type	Altijd 0, gereserveerd voor toekomstig gebruik
lezer	1 als de interne lezer de kaart heeft gelezen of 2 als extern
Status	– Toegestane kaart – Geweigerde kaart – Kaart op de witte lijst – Kaart op de zwarte lijst – Pro-modus bedrijfskaart toegestaan – Pro-modus bedrijfskaart geweigerd

Indeling witte lijst/zwarte lijst in de lezer #

Whitelist en blacklist worden opgeslagen in door mensen leesbare JSON-indeling.

Voorbeeld van whitelist opgeslagen in μFR Online reader:

{ "witte lijst":[“11223344”, “AABBCCDD”], "tijdstempel":1660492955 }
JSON-sleutel/knooppuntnaam	Beschrijving
witte lijst	Een knooppunt dat UID's op de witte lijst bevat in door komma's gescheiden indeling
tijdstempel	Momenteel opgeslagen whitelist tijdstempel

Voorbeeld van een zwarte lijst die is opgeslagen in de μFR Online-lezer:

{ "zwarte lijst":[“11223344”, “AABBCCDD”], "tijdstempel":1660492955 }
JSON-sleutel/knooppuntnaam	Beschrijving
Zwarte lijst	Een knooppunt dat UID's op de zwarte lijst bevat in door komma's gescheiden indeling
tijdstempel	Momenteel opgeslagen tijdstempel op de zwarte lijst

Stroomdiagram voor logboek- en toegangscontrolemodus #

Er zijn twee hoofdgebeurtenissen in de log- en toegangscontrolemodus.

Kaartleesgebeurtenis #

uFR Online log- en toegangscontrolemodus 6

Reader/Server synchronisatie (elke 60 seconden) #

uFR Online log- en toegangscontrolemodus 7

HTTP(S)-serveraanvraag- en antwoordprotocollen #

Real-time gebeurtenisprotocol #

Real-time gebeurtenissen worden naar de server verzonden in door mensen leesbare JSON-indeling. Voorbeeld van een real-time gebeurtenisverzoek van een lezer naar een server:

HTTP(S)-aanvraag van Reader aan een server
{ "rte": [{ "id":83,pid":10,uid":"AABBCCDD","time":"2022-08-16 07:45:01","delta":89349,"type":0,"reader":1,"status":1 }], "whitelist_timestamp":1660492955, "blacklist_timestamp":1660492955 }
JSON-sleutel/knooppuntnaam	Beschrijving
RTE	Bovenliggend knooppunt dat real-time gebeurtenis bevat
Voor meer informatie over de RTE-indeling voor het onderliggende knooppunt lezen in reader-logboekindeling
whitelist_timestamp	Huidige in-reader opgeslagen whitelist tijdstempel
blacklist_timestamp	De huidige in-reader opgeslagen blacklist tijdstempel
Serienummers, IP-adressen en firmwareversies van lezers worden in de HTTP POST-header verzonden als "OSN", "SN1" "SN2", "IP", "FW", "FW1", "FW2"

Server HTTP(S) reactie op de lezer
{ "last_id":79, "tijd":1660636893, "blacklist":[“AABBCCDD”], "blacklist_timestamp":1660636882, "whitelist":[“11223344”], "whitelist_timestamp":1660636882, "update_fw":[“2.8.2”, “5.0.71”, “5.0.70”] }
JSON-sleutel/knooppuntnaam	Beschrijving
last_id	Gebeurtenis-id laatste logboek die op de server is opgeslagen. De lezer verzendt alle logboekgebeurtenissen met een ID die groter is dan last_id
tijd	Optionele. Als de tijdstempel van de server wordt verzonden, synchroniseert de lezer de interne RTC-tijd met een servertijd
Zwarte lijst	Optionele. Als een zwarte lijst van de server wordt verzonden, vervangt de lezer de momenteel opgeslagen zwarte lijst door een nieuw ontvangen lijst.
blacklist_timestamp	Deze parameter is verplicht als een zwarte lijst wordt verzonden. de lezer vervangt de momenteel opgeslagen blacklist_timestamp door een nieuw ontvangen parameter.
witte lijst	Optionele. Als een witte lijst van een server wordt verzonden, vervangt de lezer de momenteel opgeslagen witte lijst door een nieuw ontvangen lijst.
blacklist_timestamp	Deze parameter is verplicht als een witte lijst wordt verzonden. de lezer vervangt de momenteel opgeslagen whitelist_timestamp door een nieuw ontvangen parameter.
update_fw	Deze parameter is optioneel. Het bevat verzoeken om bij te werken in de firmware van de lezer. Als deze parameter wordt verzonden, activeert de lezer de firmware-updateprocedure. Het eerste element bevat μFR Online firmware, het tweede bevat de UART1 reader en het derde bevat de UART2 reader. Als het array-element een lege tekenreeks is, wordt de update niet geactiveerd.

Logboekgebeurtenisprotocol #

Logboekgebeurtenissen worden naar de server verzonden in een door mensen leesbare JSON-indeling.

Voorbeeld van een real-time gebeurtenisverzoek van een lezer naar een server:

HTTP(S)-aanvraag van Reader aan een server
{ "log": [{ "id":83,pid":10,uid":"AABBCCDD","time":"2022-08-16 07:45:01","delta":89349,"type":0,"reader":1,"status":1, "id":84,pid":10,uid":"AABBCCDD","time":"2022-08-16 07:45:01","delta":89349,"type":0,"reader":1,"status":1 }]}
JSON-sleutel/knooppuntnaam	Beschrijving
.log	Bovenliggend knooppunt dat een array met logboekgebeurtenissen bevat
Voor meer informatie over het logboek leest u de indeling van het logboek voor onderliggend knooppunt in de lezer

De gebeurtenis Log wordt verzonden wanneer de parameter "last_id" van de server wordt ontvangen (real-time event response of reader/server synchronization response).

Reader/Server synchronisatie protocol #

Logboekgebeurtenissen worden naar de server verzonden in een door mensen leesbare JSON-indeling.

Voorbeeld van een real-time gebeurtenisverzoek van een lezer naar een server:

HTTP(S)-aanvraag van Reader aan een server
{ "whitelist_timestamp":1660636882, "blacklist_timestamp":1660636882 }
JSON-sleutel/knooppuntnaam	Beschrijving
blacklist_timestamp	Huidige in-reader blacklist tijdstempel
whitelist_timestamp	Huidige tijdstempel op de witte lijst in de lezer

PHP en MySQL server script #

Er zijn vooraf gebouwde PHP- en MySQL-scripts die op de server kunnen worden gehost. Het is gemaakt om eenvoudig het server-side deel van de log- en toegangsmodus te implementeren. Het kan real-time gebeurtenissen, loggebeurtenissen en reader-serversynchronisatieverzoeken verwerken.

MySql database structuur #

Tabel "evenementen"
Naam van de kolom	Beschrijving van de kolom
Id	Unieke logboekgebeurtenis-id
Uid	Kaart UID
PID	Persoonlijke id. Kan worden gebruikt om dezelfde gebruiker te identificeren met meerdere kaart-UID's
tijd	Tijdstempel voor gebeurtenissen
Delta	Tijdsverschil tussen de twee gebeurtenissen
Type	Altijd 0, gereserveerd voor toekomstig gebruik
Status	Status van het evenement
Osn	μFR Online serienummer
SN1	Intern aangesloten μFR NFC-lezer serienummer
SN2	Extern aangesloten μFR NFC-lezer, serienummer
lezer	Als de kaart wordt gelezen door een interne lezer Als de kaart wordt gelezen door een externe lezer
RTE	– Als het evenement Real-time is – Als de gebeurtenis Log is

Tabel "lezers"

Naam van de kolom

Beschrijving van de kolom

Osn

μFR Online serienummer

Descriptor

μFR Online lezer descriptor. Standaard is leeg

SN2

Extern aangesloten μFR NFC-lezer serienummer

whitelist_on_server

Tijdstempel van de laatst gewijzigde witte lijst op de server. Automatisch bijgewerkt door user_after_update trigger

whitelist_in_reader

Tijdstempel van de witte lijst opgeslagen in de lezer.