μ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.
- Logboekmodus inschakelen (alleen zichtbaar nadat de mastermodus is ingeschakeld)
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
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
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? #
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 |
|
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 #
-
Reader/Server synchronisatie (elke 60 seconden) #
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 |
|
RTE |
|
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. Automatisch bijgewerkt door HTTP POST verzonden door lezer |
blacklist_on_server |
Tijdstempel van de laatst gewijzigde zwarte lijst op de server. Automatisch bijgewerkt door user_after_update trigger |
blacklist_in_reader |
Tijdstempel van zwarte lijst opgeslagen in de lezer. Automatisch bijgewerkt door HTTP POST verzonden door lezer |
Ip |
Tijdstempel van zwarte lijst opgeslagen in de lezer. Automatisch bijgewerkt door HTTP POST verzonden door lezer |
online_firmware |
Huidige μFR Online firmware versie. Automatisch bijgewerkt door HTTP POST verzonden door lezer |
reader1_firmware |
Huidige μFR op de UART1 firmware versie. Automatisch bijgewerkt door HTTP POST verzonden door lezer |
reader2_firmware |
Huidige μFR op de UART2 firmware versie. Automatisch bijgewerkt door HTTP POST verzonden door lezer |
requested_online_firmware |
Als dit veld is ingevuld en verschilt van online_firmware, wordt een updateverzoek naar de lezer verzonden |
requested_reader1_firmware |
Als dit veld is ingevuld en verschilt van reader1_firmware, wordt een updateverzoek naar de lezer verzonden |
requested_reader2_firmware |
Als dit veld is ingevuld en verschilt van reader2_firmware, wordt een updateverzoek naar de lezer verzonden |
Nieuwe lezers worden automatisch toegevoegd aan elk lezersevenement. Als er bijvoorbeeld een nieuwe lezer is verbonden met het netwerk en de host-URL van de logmodus is ingesteld, wordt de nieuwe lezer dynamisch toegevoegd wanneer een gebeurtenis voor het eerst wordt verzonden. **Voeg geen lezers handmatig toe |
Tabel "gebruikers" |
|
Naam van de kolom |
Beschrijving van de kolom |
Uid |
Unieke ID van de kaart |
PID |
Persoonlijke ID. Kan worden gebruikt om dezelfde gebruiker te identificeren met meerdere kaart-UID's |
beschrijving |
Beschrijving van de gebruiker. Kan worden gebruikt bv. om voor- en achternamen in te stellen. |
Afbeelding |
Binaire opgemaakte gebruikersafbeelding |
*OP123456 |
Voorbeeld van een μFR Online lezer met serienummer ON123456. Dit veld wordt gebruikt om huidige gebruikers op deze reader op de witte of zwarte lijst te zetten |
*ON654321 |
Voorbeeld van een μFR Online reader met serienummer ON654321. Dit veld wordt gebruikt om huidige gebruikers op deze reader op de witte of zwarte lijst te zetten |
Nieuwe lezers worden automatisch toegevoegd aan elk lezersevenement. Als er bijvoorbeeld een nieuwe lezer is verbonden met het netwerk en de host-URL van de logmodus is ingesteld, wordt de nieuwe lezer dynamisch toegevoegd wanneer een gebeurtenis voor het eerst als een nieuwe kolom wordt verzonden. Als er een nieuwe lezer wordt toegevoegd. *Voorbeeld lezers. **Voeg geen lezers handmatig toe. |
"debug_log" tafel |
|
Naam van de kolom |
Beschrijving van de kolom |
Id |
Unieke foutopsporings-id |
Osn |
μFR Online serienummer |
.log |
Onbewerkte POST-gegevens verzonden van lezer naar server of van server naar lezer |
tijd |
Huidige servertijdstempel |
richting |
FROM_SERVER – HTTP server response FROM_READER – HTTP reader request |
De logboektabel voor foutopsporing wordt alleen gevuld als de vlag "DEBUG" is ingeschakeld in het PHP-script |
-
PHP script flowchart #