Wiki source code of Настройка сервиса верификации по отпечаткам пальцев на базе контроллеров BioSmart

Last modified by superadmin on 2026/06/24 21:41

version	line-number	content
1.1	1	Контроллеры БОРЕЙ обеспечивают контроль доступа с функцией биометрической верификации по лицам и отпечаткам пальцев. Функциональность обеспечивает плагин биометрической верификации. При работе с сервисом верификации владельцев пропусков по отпечаткам пальцев в качестве сканеров отпечатков поддерживаются контроллеры Biosmart 4, Biosmart 5M производства «Прософт-Биометрикс» (планируется поддержка контроллера BioSmart ProxE), в качестве сервера верификации выступает компьютер под управления ОС Windows (рекомендуется версия 10 IoT) с установленной сервисной службой.
	2
	3	{{info}}
	4	В данном разделе приведена информация по настройке верификации на базе контроллеров BioSmart. Полная информация о возможностях биометрической верификации приведена в следующих разделах:
	5
	6	* ~[[[doc:borey3.Руководство администратора БОРЕЙ Н.Биометрия по лицам и отпечаткам пальцев.WebHome]]]
2.2	7	* ~[[[neyross.Настройка Платформы НЕЙРОСС.Настройка функций контроля доступа.Настройка биометрической верификации \| Биометрия по лицам и отпечаткам пальцев, термометрия.WebHome]]]
1.1	8	{{/info}}
	9
5.1	10	Общие сведения
1.1	11
5.1	12	Плагин биометрической верификации позволяет проводить двухфакторную идентификацию с биометрической верификацией владельцев карт по отпечаткам пальцев посредством с(%%)канеров отпечатков пальцев Biosmart 4, Biosmart 5M производства ООО «Прософт-Биометрикс», планируется поддержка модели Biosmart ProxE.
1.1	13
5.1	14	//Сервером верификации //выступает компьютер под управления ОС Windows с установленной «Службой НЕЙРОСС Интеграция» или АРМ НЕЙРОСС.
1.1	15
	16	Для первичной идентификации владельца пропуска на контроллере БОРЕЙ может использоваться:
	17
	18	1. Отдельный считыватель карт с Wiegand или 1-Wire-интерфейсом, с возможностью идентификации по карте и/или по пин-коду.
	19	1. Встроенный в контроллер BioSmart считыватель. Есть ограничение на тип используемых карт. Поддерживаются EM-Marine и Mifare. Подключение считывателя к Борей осуществляется по интерфейсу Wiegand.
	20
	21	(% style="text-align: left;" %)
	22	\\
	23
	24	(% style="text-align: left;" %)
	25	Порядок передачи данных в системе с биометрической верификацией
	26
	27	1. На считыватель БОРЕЙ предъявляется идентификатор (карта и/или пин-код).
2.1	28	1. Контроллер БОРЕЙ по предъявленной карте находит запись владельца пропуска и проверяет наличие шаблонов отпечатков пальцев. При отсутствии шаблонов формируется отказ доступа. При наличии — отправляет эти данные Серверу верификации, работающему под ОС Windows. находит в своей базе данных шаблоны отпечатков отправляет эти данные Серверу верификации («Службе НЕЙРОСС Интеграция» или НЕЙРОСС АРМ) вместе с информацией о «привязанном» к точке доступа контроллере BioSmart.
1.1	29	1. Сервер верификации начинает управление контроллером BioSmart: отправляет команду на считывание отпечатка и инициирует получение результата считывания (отпечатка).
	30	1. По получению отпечатка Сервер верификации осуществляет сверку с шаблонами, полученными от контроллера БОРЕЙ, и, если находится совпадение, — отправляет в БОРЕЙ положительный ответ, не находится — отрицательный.
	31	1. БОРЕЙ принимает решение о разрешении или запрете доступа.
	32
	33	== {{id name="НастройкасервисаверификациипоотпечаткампальцевнабазеконтроллеровBioSmart-Подготовкакнастройке"/}}Подготовка к настройке ==
	34
	35	Для обеспечения совместной работы Платформы НЕЙРОСС, контроллера БОРЕЙ, Сервера верификации и контроллеров BioSmart, перед началом настройки сервиса верификации необходимо проверить, что каждый из узлов удовлетворяет перечисленным ниже требованиям, и, при необходимости, — выполнить рекомендуемые действия.
	36
	37	\|=(((
	38	Узел
	39	)))\|=(((
	40	Порядок проверки
	41	)))
	42	\|(((
	43	Платформа НЕЙРОСС
	44	)))\|(((
5.1	45	1. Лицензия включает требуемое количество пропусков с биометрическими данными ~[[[ui.Параметры узла.Основные параметры.Просмотр параметров и обновление лицензии.WebHome]]]. В противном случае требуется приобрести лицензию ~[[[neyross.Лицензирование \| Платформа НЕЙРОСС.WebHome]]];
	46	1. Настроена «облачная» учётная запись с правами Общее конфигурирование ~[[[neyross.Настройка Платформы НЕЙРОСС.Управление пользователями.WebHome]]].
1.1	47	)))
	48	\|(((
5.1	49	Контроллер БОРЕЙ
1.1	50	)))\|(((
	51	(((
5.1	52	1. Подключен считыватель карт. Схема подключения считывателя, в том числе, — встроенного в контроллер BioSmart, — приведена в справочнике монтажника ~[[[doc:borey3.Справочник монтажника БОРЕЙ Н.Схемы внешних подключений БОРЕЙ Н.WebHome]]].
	53	1. Настроены параметры точек доступа ~[[[ui.Параметры узла.Точки доступа.WebHome]]].
	54	1. Настроена сетевая доступность контроллера БОРЕЙ и Платформы НЕЙРОСС, узлы принадлежат одному домену ~[[[ui.Параметры узла.Подключение к сети.WebHome]]]. Статус узлов в разделе [[ui.Сеть.WebHome]] — [Норма];
	55	1. Настроены [[параметры даты и времени>>ui.Параметры узла.Дата и время.WebHome]], нет расхождения времени: рекомендуется настроить автоматическую синхронизацию по IP-адресу Платформы НЕЙРОСС;
1.1	56	1. (((
5.1	57	Посредством [[neyross.АРМ НЕЙРОСС Доступ.WebHome]] введены данные владельцев пропусков, включая отпечатки пальцев. Ввод отпечатков пальцев в Платформу НЕЙРОСС осуществляется посредством [[дактилоскопического сканера Futronic FS80H или сканера Biosmart>>neyross.Настройка Платформы НЕЙРОСС.Настройка функций контроля доступа.Настройка функции сканирования отпечатков пальцев.WebHome]]. \\
1.1	58
	59	{{info}}
8.1	60	Ввод данных также возможен посредством [[ПАК Интеграция>>integration.WebHome]]/[[ITRIUM>>itrium.WebHome]] с помощью [[Драйвера устройств BioSmart>>attach:itrium.PDF-документы.WebHome@Driver_BioSmart.pdf]], при этом может использоваться любой контроллер BioSmart.
1.1	61	{{/info}}
	62	)))
	63	1. (((
5.1	64	Данные пропусков c Платформы НЕЙРОСС загружены в контроллер БОРЕЙ: выполнена [[синхронизация данных>>ui.Сеть.Синхронизация данных.WebHome]]. Также для загрузки «облачных» учётных записей в БОРЕЙ, необходимо проверить, что узлы синхронизированы по типу данных «Общий ресурс». \\
1.1	65
	66	{{info}}
5.1	67	Процедура синхронизации данных является точкой начала отслеживания изменений между узлами. В дальнейшем синхронизация будет проводиться автоматически.
1.1	68	{{/info}}
	69	)))
	70	)))
	71	)))
	72	\|(((
	73	Контроллер Biosmart
	74	)))\|(((
	75	1. Настроены сетевые параметры контроллера.
5.1	76	1. В случае использования для первичной идентификации лица считывателя карт, встроенного в контроллер Biosmart, включите режим bypass: при включении этого режима доступна передача ID proximity карты, не зарегистрированной в базе ПО BioSmart-studio, на контроллер БОРЕЙ/ЯРС через wiegand-выход контроллера BioSmart.
1.1	77	)))
	78
	79	\\
	80
	81	== {{id name="НастройкасервисаверификациипоотпечаткампальцевнабазеконтроллеровBioSmart-Выборсервераверификации"/}}Выбор сервера верификации ==
	82
	83	В качестве сервера верификации требуется использовать компьютер, работающий под управлением операционной системы Windows.
	84
	85	Требования к серверу верификации:
	86
	87	1. Работа СТРОГО под управлением операционной системы Windows. Рекомендуемая версия: 10 IoT. Эти требования обусловлены необходимостью поддержки SDK от компании BioSmart. Возможно использование сервера в виртуальной среде.
	88	1. Установка всех обновлений ОС Windows.
	89	1. Установка Microsoft Visual C++ 2013 Redistributable (x86) и VisualCppRedist_AIO_x86_x64 или всех последних обновлений.
	90	1. Круглосуточная сетевая доступность для контроллера БОРЕЙ и считывателя BioSmart.
	91
	92	{{info}}
	93	В целях оптимизации программные средства интеграции со считывателями BioSmart могут поставляться отдельно в виде «Службы НЕЙРОСС Интеграция», а также включены в комплекс программ АРМ НЕЙРОСС.
	94	{{/info}}
	95
2.1	96	Таким образом, если в организации есть рабочие места операторов с установленным АРМ НЕЙРОСС, работающие под управлением операционной системы Windows, включённые круглосуточно, вы можете использовать любой из этих рабочих мест в качестве сервера верификации.
1.1	97
2.1	98	{{error}}
	99	ВАЖНО
1.1	100
2.1	101
	102	{{/error}}
	103
5.1	104	В случае отсутствия рабочего места с требуемыми параметрами, выделите отдельный сервер и выполните настройку сервера верификации ~[[[#Порядок настройки сервера верификации>>doc:\|\|anchor="НастройкасервисаверификациипоотпечаткампальцевнабазеконтроллеровBioSmart-Порядокнастройкисервераверификации"]]].
2.1	105
1.1	106	== {{id name="НастройкасервисаверификациипоотпечаткампальцевнабазеконтроллеровBioSmart-Порядокнастройкисервераверификации"/}}Порядок настройки сервера верификации ==
	107
5.1	108	1. Выделите компьютер, работающий под управлением операционной системы Windows, который будет выступать в качестве сервера верификации, удовлетворяющий требованиям подраздела ~[[[#Выбор сервера верификации>>doc:\|\|anchor="НастройкасервисаверификациипоотпечаткампальцевнабазеконтроллеровBioSmart-Выборсервераверификации"]]].
	109	1. Вручную разрешить входящие подключения для порта 7887, используемого «Службой НЕЙРОСС Интеграция» или «Службой НЕЙРОСС АРМ».
1.1	110	1. (((
5.1	111	Скачайте инсталлятор «Службы НЕЙРОСС Интеграция» или АРМ НЕЙРОСС. Ссылка для скачивания доступна с IP-адреса Платформы НЕЙРОСС ~[[[ui.Параметры узла.Накопители и файлы.Дистрибутивы.WebHome]]].\\
1.1	112
	113	{{info}}
5.1	114	Ссылка для скачивания доступна с версии 20.10 Платформы НЕЙРОСС. При использовании предыдущих версий, либо работы в автономном режиме, обратитесь к представителю компании ИТРИУМ с требованием предоставления файла {{code language="none"}}NeyrossIntergationSetup.exe.{{/code}}(%%)
1.1	115	{{/info}}
	116
2.1	117	{{error}}
	118	ВАЖНО
	119
	120	Не используйте обе службы одновременно.
	121	{{/error}}
	122
1.1	123	(% class="auto-cursor-target" style="color: rgb(23,43,77);" %)\\
	124	)))
5.1	125	1. Запустите на выполнение файл {{code language="none"}}NeyrossIntergationSetup.exe{{/code}}.
	126	1. Прочитайте условия лицензионного соглашения и в случае согласия подтвердите их принятие. Нажмите (% style="text-align: left;" %)Далее.
1.1	127	[[image:attach:NeyrossIntergationSetup1.png]]\\
5.1	128	1. Согласитесь с выбором папки установки или нажмите на Обзор и укажите другую папку. Нажмите Далее.
1.1	129	[[image:attach:NeyrossIntergationSetup2.png]]\\
5.1	130	1. Нажмите Установить.
1.1	131	[[image:attach:NeyrossIntergationSetup3.png]]
	132	\\
5.1	133	1. Будет выполнена установка службы. Нажмите Завершить.
1.1	134	[[image:attach:NeyrossIntergationSetup4.png]]
5.1	135	1. Проверьте доступность порта 7887 для «Службы НЕЙРОСС Интеграция».
1.1	136
5.1	137	== {{id name="НастройкасервисаверификациипоотпечаткампальцевнабазеконтроллеровBioSmart-Порядокнастройкисервиса"/}}Порядок настройки сервиса(%%) ==
1.1	138
2.2	139	1. Авторизуйтесь на узле БОРЕЙ под «облачной» учётной записью с правами общего конфигурирования ~[[[ui.Пользователи, роли и права.WebHome]]].
5.1	140	1. Перейдите к разделу настройки плагинов ~[[[ui.Параметры узла.Плагины.WebHome]]]. Найдите в списке установленных плагинов требуемый и нажмите на кнопку Настроить.
1.1	141	[[image:attach:neyross_bio_conf1.png]]
	142	1. (((
5.1	143	В отобразившемся окне задайте общие параметры плагина, затем перейдите к вкладке Точки доступа, установите флаг для точки/точек, которые планируется использовать для доступа с верификацией отпечатков пальцев, настройте параметры точек доступа. Описание полей представлено в таблице ниже. По окончании процедуры настройки нажмите на кнопку Сохранить.
1.1	144	[[image:attach:neyross_bio_conf2_fingers.png\|\|width="495"]] [[image:attach:neyross_bio_conf3_fingers.png\|\|width="480"]]\\
	145
	146	{{info}}
	147	Поле Режим работы информационное. Плагин лицензируется на работу в определённом режиме. Поле Точки доступа для верификации отображает число точек доступа, настроенных на верификацию отпечатков, а также общее число точек доступа, доступных по лицензии. Поле Допустимое время расхождения не используется в настройках верификации отпечатков пальцев. В поле Статус связи с сервером отображается текущее состояние связи с сервером верификации. В поле Статус в настройках точки доступа отображается статус связи с контроллером Biosmart.
	148	{{/info}}
	149
	150	Параметры плагина
	151
6.1	152	\|=(((
1.1	153	Поле
6.1	154	)))\|=(((
1.1	155	Диапазон значений
6.1	156	)))\|=(((
1.1	157	Комментарий
	158	)))
	159	\|=(% colspan="3" style="width: 1762.0px;" %)(((
	160	Вкладка Общее
	161	)))
6.1	162	\|(((
1.1	163	Сервер верификации
6.1	164	)))\|(((
1.1	165	IP-адрес:порт
6.1	166	)))\|(((
1.1	167	(((
5.1	168	Выберите (% style="text-align: left;" %)Ввод адреса и порта вручную и укажите IP-адрес сервера верификации и порт (% style="text-align: left;" %)7887 в разные поля, отделенные двоеточием.
1.1	169	)))
	170	)))
6.1	171	\|(((
1.1	172	Таймаут взаимодействия, мс
6.1	173	)))\|(((
1.1	174	Целое число, рекомендуемый диапазон 8000 — 10000
6.1	175	)))\|(((
1.1	176	(((
	177	Период времени, в течение которого ожидается ответ от сервера верификации о результате верификации. Если по истечению времени ответ не получен, верификация считается неуспешной, решение о разрешении или запрете доступа принимается на основе текущего режима верификации: при мягком режиме доступ разрешается, при жёстком — доступ запрещается.
	178
	179	{{error}}
	180	ВАЖНО
	181
5.1	182	Указанный интервал отсчитывается от сигнала считывателя. В указанный промежуток пользователь должен успеть приложить палец. При низкой скорости сетевого соединения или долгой подготовке пользователя к процедуре сканирования увеличьте временной интервал до 10 000 мс.
1.1	183	{{/error}}
	184	)))
	185	)))
	186	\|=(% colspan="3" style="width: 1762.0px;" %)(((
	187	Вкладка Точки доступа
	188	)))
6.1	189	\|(((
1.1	190	Мягкий режим
6.1	191	)))\|(((
1.1	192	Да/Нет, логическое поле
6.1	193	)))\|(((
1.1	194	По умолчанию установлено в Нет, это означает, что при отсутствии положительного решения от сервера верификации, формируется отказ доступа. Использование «мягкого» режима рекомендуется в целях тестирования сервиса и/или использования функции видеоверификации и подтверждения доступа оператором.
	195	)))
6.1	196	\|(((
1.1	197	Модель считывателя
6.1	198	)))\|(((
1.1	199	(% style="text-align: left;" %)
	200	* BioSmart 5M
	201	* BioSmart4
	202	* BioSmart ProxE (временно не поддерживается)
6.1	203	)))\|(((
5.1	204	Выберите из раскрывающегося списка модель используемого контроллера.
1.1	205	)))
6.1	206	\|(((
1.1	207	IP-адрес устройства
6.1	208	)))\|(((
1.1	209	IP-адрес
6.1	210	)))\|(((
1.1	211	Введите IP-адрес контроллера BioSmart, используемого для считывания отпечатков пальцев при верификации владельца пропуска.
	212	)))
6.1	213	\|(((
1.1	214	Сетевой порт устройства
6.1	215	)))\|(((
1.1	216	Номер порта, целое число
6.1	217	)))\|(((
1.1	218	Введите порт, по которому осуществляется обмен данными с контроллером BioSmart. По умолчанию используется 20002.
	219	)))
6.1	220	\|(((
1.1	221	Серийный номер устройства
6.1	222	)))\|(((
1.1	223	Целое число
6.1	224	)))\|(((
1.1	225	Введите серийный номер контроллера BioSmart.
	226	)))
6.1	227	\|(((
5.1	228	Номер входа подключения считывателя
6.1	229	)))\|(((
1.1	230	Целое число
6.1	231	)))\|(((
1.1	232	Номер входа, на который подключен считыватель (0-5). Временно не используется.
	233	)))
	234	)))
	235
	236	== {{id name="НастройкасервисаверификациипоотпечаткампальцевнабазеконтроллеровBioSmart-НастройкауровнядостоверностисравнениябиометрическихшаблоновBiosmart"/}}Настройка уровня достоверности сравнения биометрических шаблонов Biosmart ==
	237
	238	{{info}}
	239	С версии версии 3.3.0 SDK BioSmart появилась возможность настройки строгости идентификации. Новую версию АРМ НЕЙРОСС и «Службы НЕЙРОСС Интеграция» можно скачать из веб-интерфейса Платформы НЕЙРОСС, начиная с версии 20.10.
	240	{{/info}}
	241
5.1	242	В предыдущей версии SDK уровень строгости идентификации эталонного и сканированного шаблонов отпечатков пальцев (%%)был достаточно высоким (уровень NORMAL), что повышало вероятность ошибочного отказа в доступе при низком качестве полученных отпечатков пальцев. Новая версия позволяет настроить порог, при котором отпечаток считается достоверным. Порог снижен согласно рекомендациям BioSmart (уровень LOW).
1.1	243
	244	{{error}}
	245	ВАЖНО
	246
5.1	247	Так как в текущем алгоритме доступа используется двухфакторная идентификация, и отпечаток пальца является вторым признаком подтверждения личности владельца, снижение уровня строгости не должно существенным образом повышать вероятность ошибочного предоставления доступа,(%%) однако решение о минимально-приемлемом уровне достоверности должен принимать администратор, выполняющий настройку системы на объекте.
1.1	248	{{/error}}
	249
5.1	250	Файл конфигурации config.conf(%%)
1.1	251
5.1	252	Настройка уровня достоверности осуществляется в конфигурационном файле config.conf, который должен быть создан и помещён в папку установки службы.
1.1	253
5.1	254	По умолчанию папкой установки является:
1.1	255
5.1	256	для АРМ НЕЙРОСС
1.1	257
3.1	258	{{code language="java"}}
1.1	259	c:\Program Files (x86)\Neyross\neyross-workstation\UltimaWorkstationService\
	260	{{/code}}
	261
	262	(% class="auto-cursor-target" style="color: rgb(51,51,51);" %)для Службы НЕЙРОСС Интеграция
	263
3.1	264	{{code language="java"}}
1.1	265	c:\Program Files (x86)\Neyross\neyross-integration\
	266	{{/code}}
	267
5.1	268	Создайте в требуемой директории файл со следующим содержимым:
1.1	269
3.1	270	{{code language="java"}}
1.1	271	services : [
	272	{
	273	service : "/biosmart/",
	274
	275	config : {matching_level:0},
	276
	277	enabled : "true"
	278	}
	279	]
	280	{{/code}}
	281
5.1	282	, где matching_level — параметр, определяющий порог совпадения биометрических данных, полученных в процессе идентификации, с биометрическим шаблоном, хранящимся в базе данных; опциональная настройка, уровень достоверности; порог идентификации, соответствующие ему вероятность ошибочного предоставления доступа (FAR) и вероятность ложного отказа в доступе (FRR).
1.1	283
5.1	284	Задайте значение matching_level согласно таблице ниже.
1.1	285
	286	\|=(((
	287	Порог идентификации
	288	)))\|=(((
	289	FAR
	290	)))\|=(((
	291	Значение matching_level
	292	)))\|=(((
	293	config.conf
	294	)))
	295	\|(((
	296	Максимальный (HIGHEST)
	297	)))\|(((
	298	1e-8
	299	)))\|(((
	300	1
	301	)))\|(((
	302	{matching_level:1}
	303	)))
	304	\|(((
	305	Повышенный (HIGH)
	306	)))\|(((
	307	1e-7
	308	)))\|(((
	309	2
	310	)))\|(((
	311	{matching_level:2}
	312	)))
	313	\|(((
	314	Нормальный (NORMAL)
	315	)))\|(((
	316	1e-6
	317	)))\|(((
	318	0
	319	)))\|(((
	320	{matching_level:0}
	321	)))
	322	\|(((
	323	Пониженный (LOW)
	324	)))\|(((
	325	1e-5
	326	)))\|(((
	327	3 (значение по умолчанию, согласно рекомендации Biosmart)
	328	)))\|(((
	329	{matching_level:3}
	330	)))
	331	\|(((
	332	Минимальный (LOWEST)
	333	)))\|(((
	334	1e-4
	335	)))\|(((
	336	4
	337	)))\|(((
	338	{matching_level:4}
	339	)))
	340
	341	{{info}}
	342	ПОДСКАЗКА
	343
	344	При использовании порога, заданного по умолчанию ({matching_level:3}, LOW) дополнительных действий не требуется, файл конфигурации не обязателен.
	345	{{/info}}