μFR Nano Online Log и режим контроля доступа #
Как включить режим ведения журнала? #
- Войдите в μFR Online Log and Access Control Module Online WEB configurator GUI.
- Включите главный режим , если он еще не включен.
- Выберите параметр Сохранить и перезапустить, чтобы применить изменения.
- Включить режим журнала (отображается только после включения основного режима)
Как включить режим контроля доступа? #
- Войдите в μFR Online Log and Access Control Module Online WEB configurator GUI.
- Включите режим журнала.
- Включите режим управления доступом (доступен только в том случае, если режим журнала ранее был включен).
- Отключение μFR Online от блока питания
- Подключите плату контроля доступа.
- Включите μFR Online от блока питания
Режим контроля доступа должен быть включен до подключения платы контроля доступа.
Дополнительные опции режима контроля доступа #
- Время импульса реле: сколько миллисекунд релейного выхода квадратного волнового импульса
- Частота импульсов реле: выходная частота квадратной волны в Гц
- Мощность импульса реле: выходная мощность квадратной волны (рабочий цикл)
- Активное время реле: сколько миллисекунд должно оставаться на выходе высоким после импульса квадратной волны
Использование кейсов #
В этом разделе описываются два основных сценария использования.
-
Режим ведения журнала без контроля доступа #
Включите режим ведения журнала и убедитесь, что режим управления доступом отключен.
- Перейдите в раздел режима журнала и нажмите кнопку Изменить.
- Введите URL-адрес узла сервера журналов.
- Нажмите кнопку Сохранить.
- Нажмите кнопку Сохранить и перезапустить.
- Режим журнала готов к использованию.
В приведенной ниже таблице будет описано, какие карты разрешены или запрещены на основе черного или белого списка.
Сценарий |
Разрешено / Запрещено |
Пустые как белый, так и черный списки |
Все карты разрешены |
Белый список пустой и черный список не пустой |
Разрешены все карты, кроме занесенных в черный список |
Белый список не пустой и черный список пустой |
Разрешены только карты из белого списка |
Белый и черный списки не являются пустыми |
Разрешены только карты из белого списка, не включенные в черный список |
Эксклюзивный белый список включен |
Разрешены только карты из белого списка, которые не входят в черный список (в режиме pro разрешены только карты компании, занесенные в белый список, кроме черного списка) |
Если карта разрешена, считыватель подаст звуковой сигнал один раз, и зеленый свет будет включен. Если карта отклонена, считыватель не будет подавать звуковой сигнал, и красный свет будет включен. |
-
Режим ведения журнала с контролем доступа #
Включите режим журнала и убедитесь, что включен режим управления доступом.
- Перейдите в раздел режима журнала и нажмите кнопку Изменить.
- Введите URL-адрес узла сервера журналов.
- Нажмите кнопку Сохранить.
- Нажмите кнопку Сохранить и перезапустить.
- Режим журнала с контролем доступа теперь готов к использованию.
Сценарий |
Разрешено/Запрещено |
Пустые как белые, так и черные списки |
Все карты запрещены (в режиме pro разрешены все карты компании) |
Белый список пустой и черный список не пустой |
Все карты запрещены (в режиме pro все карты компании разрешены, кроме черного списка) |
Белый список не пустой и черный список пустой |
Разрешены только карты из белого списка (в режиме pro разрешены все карты компании, кроме черных) |
Белый и черный списки не являются пустыми |
Разрешены только карты из белого списка, которые не входят в черный список (в режиме pro разрешены все карты компании, кроме черных) |
Эксклюзивный белый список включен |
Разрешены только карты из белого списка, которые не входят в черный список (в режиме pro разрешены только карты компании, занесенные в белый список, кроме черного списка) |
Если карта разрешена, считыватель подаст звуковой сигнал один раз, и зеленый свет будет включен. Также плата контроля доступа сработает реле, один раз подаст звуковой сигнал и включит внешнее светодиодное кольцо. Если карта отклонена, считыватель не будет подавать звуковой сигнал, и красный свет будет включен. Также плата контроля доступа включит внешнее светодиодное кольцо. |
В приведенной ниже таблице будет описано, какие карты разрешены или запрещены на основе черного или белого списка.
Как подключить плату контроля доступа? #
Существует также готовый кабель для подключения μFR Online и платы контроля доступа.
ПРИМЕЧАНИЕ: Режим контроля доступа должен быть включен до подключения платы управления, в противном случае звуковой сигнал будет включен все время.
Формат журнала в считывателе #
Все события журнала хранятся в удобочитаемом формате JSON.
Пример журнала, хранящегося в μFR Online reader:
{"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 |
Описание |
Журнала |
Главный родительский узел, содержащий события журнала |
Id |
Уникальный идентификатор события журнала с автоматическим увеличением |
Uid |
Уникальный идентификатор карты |
Pid |
Удостоверение личности. Доступно только в режиме Pro |
Время |
Регистрация даты и времени события в формате UTC |
Дельта |
Разница во времени между двумя событиями журнала |
Тип |
Всегда 0, зарезервировано для будущего использования |
читатель |
1, если внутренний считыватель считывал плату, или 2, если внешний |
Статус |
|
Формат белого/черного списка в считывании #
Белый и черный списки хранятся в удобочитаемом формате JSON.
Пример белого списка, хранящегося в μFR Online reader:
{ "белый список":[“11223344”, “AABBCCDD”], "метка времени":1660492955 } |
|
Имя ключа/узла JSON |
Описание |
белый список |
Узел, содержащий UID из белого списка в формате, разделенном запятыми. |
метка времени |
Сохраненная в настоящее время метка времени белого списка |
Пример черного списка, хранящегося в μFR Online reader:
{ "черный список":[“11223344”, “AABBCCDD”], "метка времени":1660492955 } |
|
Имя ключа/узла JSON |
Описание |
Черного списка |
Узел, содержащий UID из черного списка в формате, разделенном запятыми. |
метка времени |
В настоящее время хранится метка времени черного списка |
Блок-схема режима ведения журнала и управления доступом #
В режиме журнала и контроля доступа есть два основных события.
-
Событие чтения карты #
-
Синхронизация считывателя/сервера (каждые 60 секунд) #
Протоколы запроса и ответа HTTP(S) сервера #
-
Протокол событий в реальном времени #
События в реальном времени отправляются на сервер в удобочитаемом формате JSON. Пример запроса события в реальном времени от читателя к серверу:
HTTP-запрос считывателя к серверу |
|
{ "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 |
Описание |
РТЭ |
Родительский узел, содержащий событие реального времени |
Дополнительные сведения о дочернем узле RTE см. в формате журнала чтения |
|
whitelist_timestamp |
Текущая метка времени белого списка, хранящаяся в считывателе |
blacklist_timestamp |
Текущая метка времени черного списка, хранящаяся в считывателе |
Серийные номера, IP-адреса и версии встроенного ПО считывателей отправляются в заголовке HTTP POST как «OSN», «SN1», «SN2», «IP», «FW», «FW1», «FW2» |
Http-ответ сервера считывающему устройству |
|
{ "last_id":79, "время":1660636893, "черный список":[«AABBCCDD»], "blacklist_timestamp":1660636882, "белый список":[«11223344»], "whitelist_timestamp":1660636882, "update_fw":[«2.8.2», «5.0.71», «5.0.70»] } |
|
Имя ключа/узла JSON |
Описание |
last_id |
Последний идентификатор события журнала, хранящегося на сервере. Считыватель отправит все события журнала, идентификатор которых превышает last_id |
Время |
Необязательный. Если отправляется метка времени сервера, считыватель синхронизирует внутреннее время RTC с серверным временем |
Черного списка |
Необязательный. Если отправляется черный список сервера, читатель заменит сохраненный в настоящее время черный список на вновь полученный. |
blacklist_timestamp |
Этот параметр является обязательным, если отправляется черный список. читатель заменит сохраненный в данный момент blacklist_timestamp на вновь полученный. |
белый список |
Необязательный. Если отправляется белый список сервера, читатель заменит сохраненный в данный момент белый список вновь полученным. |
blacklist_timestamp |
Этот параметр является обязательным, если отправляется белый список. читатель заменит сохраненный в данный момент whitelist_timestamp на вновь полученный. |
update_fw |
Этот параметр является необязательным. Содержит запросы на обновление прошивки считывателя. Если этот параметр отправлен, считыватель запустит процедуру обновления прошивки. Первый элемент содержит прошивку μFR Online, второй содержит считыватель UART1, а третий содержит считыватель UART2. Если элемент array представляет собой пустую строку, обновление не будет запущено. |
-
Протокол регистрации событий #
События журнала отправляются на сервер в удобочитаемом формате JSON.
Пример запроса события в реальном времени от читателя к серверу:
HTTP-запрос считывателя к серверу |
|
{ "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 |
Описание |
Журнала |
Родительский узел, содержащий массив событий журнала |
Для получения дополнительных сведений о журнале, дочернем узле прочитайте в формате журнала в считывателе |
Событие журнала будет отправляться всякий раз, когда от сервера поступает параметр "last_id" (ответ на событие в реальном времени или ответ на синхронизацию считывателя/сервера).
-
Протокол синхронизации считывателя/сервера #
События журнала отправляются на сервер в удобочитаемом формате JSON.
Пример запроса события в реальном времени от читателя к серверу:
HTTP-запрос считывателя к серверу |
|
{ "whitelist_timestamp":1660636882, "blacklist_timestamp":1660636882 } |
|
Имя ключа/узла JSON |
Описание |
blacklist_timestamp |
Текущая метка времени черного списка в считывателе |
whitelist_timestamp |
Текущая метка времени белого списка в считывателе |
PHP и MySQL серверный скрипт #
Существуют готовые скрипты PHP и MySQL, которые могут быть размещены на сервере. Он предназначен для простой реализации серверной части режима ведения журнала и доступа. Он может обрабатывать события в режиме реального времени, события журналов и запросы на синхронизацию считывающего сервера.
-
Структура базы данных MySql #
Таблица "событий" |
|
Имя столбца |
Описание столбца |
Id |
Уникальный код события журнала |
Uid |
UID карты |
Pid |
Личный идентификатор. Может использоваться для идентификации одного и того же пользователя с помощью нескольких пользовательских интерфейсов карт |
Время |
Метка времени события |
Дельта |
Разница во времени между двумя событиями |
Тип |
Всегда 0, зарезервировано для будущего использования |
Статус |
Статус события |
ОСН |
Серийный номер μFR Online |
сн1 |
Внутренний подключенный серийный номер nfc-считывателя μFR |
сн2 |
Внешний подключенный считыватель μFR NFC, серийный номер |
читатель |
|
РТЭ |
|
таблица "читатели" |
|
Имя столбца |
Описание столбца |
ОСН |
Серийный номер μFR Online |
дескриптор |
μFR Онлайн считыватель дескриптор. Значение по умолчанию пусто |
сн2 |
Внешний подключенный серийный номер считывателя NFC μFR |
whitelist_on_server |
Метка времени последнего измененного белого списка на сервере. Автоматическое обновление с помощью триггера user_after_update |
whitelist_in_reader |
Метка времени белого списка, хранящегося в считывателе. Автоматически обновляется по протоколу HTTP POST, отправленному читатель |
blacklist_on_server |
Метка времени последнего изменения черного списка на сервере. Автоматическое обновление с помощью триггера user_after_update |
blacklist_in_reader |
Метка времени черного списка, хранящегося в считывателе. Автоматически обновляется по протоколу HTTP POST, отправленному читатель |
Ip |
Метка времени черного списка, хранящегося в считывателе. Автоматически обновляется по протоколу HTTP POST, отправленному читатель |
online_firmware |
Текущая версия прошивки μFR Online. Автоматически обновляется по протоколу HTTP POST, отправленному читатель |
reader1_firmware |
Текущий μFR в версии прошивки UART1. Автоматически обновляется по протоколу HTTP POST, отправленному читатель |
reader2_firmware |
Текущий μFR в версии прошивки UART2. Автоматически обновляется по протоколу HTTP POST, отправленному читатель |
requested_online_firmware |
Если это поле заполнено и отличается от online_firmware, читателю будет отправлен запрос на обновление |
requested_reader1_firmware |
Если это поле заполнено и отличается от reader1_firmware, читателю будет отправлен запрос на обновление. |
requested_reader2_firmware |
Если это поле заполнено и отличается от reader2_firmware, читателю будет отправлен запрос на обновление. |
Новые читатели автоматически добавляются к каждому событию чтения. Например, если новое средство чтения подключено к сети и задан URL-адрес узла режима журнала, новое средство чтения будет динамически добавляться при первой отправке события. **Не добавляйте считыватели вручную |
Таблица "пользователей" |
|
Имя столбца |
Описание столбца |
Uid |
Уникальный идентификатор карты |
Pid |
Удостоверение личности. Может использоваться для идентификации одного и того же пользователя с помощью нескольких пользовательских интерфейсов карт |
Описание |
Описание пользователя. Может быть использован, например. , чтобы задать имя и фамилию. |
изображение |
Двоичное отформатированное изображение пользователя |
*ON123456 |
Пример считывателя μFR Online с серийным номером ON123456. Это поле используется для внесения в белый или черный список текущих пользователей на этом устройстве чтения. |
*ON654321 |
Пример считывателя μFR Online с серийным номером ON654321. Это поле используется для внесения в белый или черный список текущих пользователей на этом устройстве чтения. |
Новые читатели автоматически добавляются к каждому событию чтения. Например, если к сети подключено новое средство чтения и задан URL-адрес узла режима журнала, новое средство чтения будет динамически добавляться при первой отправке события в виде нового столбца. Если добавляется новое средство чтения. *Примеры считывателей. **Не добавляйте считыватели вручную. |
Таблица "debug_log" |
|
Имя столбца |
Описание столбца |
Id |
Уникальный идентификатор отладки |
ОСН |
Серийный номер μFR Online |
Журнала |
Необработанные данные POST, отправляемые с устройства чтения на сервер или с сервера на считыватель |
Время |
Метка времени текущего сервера |
направление |
FROM_SERVER — FROM_READER ответа HTTP-сервера — Запрос читателя HTTP |
Таблица журнала отладки заполняется только в том случае, если в скрипте PHP включен флаг "DEBUG" |
-
Блок-схема скрипта PHP #