Изменения документа Считывание QR-кодов

Редактировал(а) admin 2026/09/21 18:18

От версии 1.2
отредактировано admin
на 2026/09/21 16:21
Изменить комментарий: Auto-saved during real-time collaboration
К версии 13.2
отредактировано admin
на 2026/09/21 18:11
Изменить комментарий: Auto-saved during real-time collaboration

Сводка

Подробности

Свойства страницы
Содержимое
... ... @@ -2,4 +2,135 @@
2 2  
3 3  == Общие сведения ==
4 4  
5 -Платформа НЕЙРОСС обеспечивает считывание QR-кодов. Поведение п
5 +Платформа НЕЙРОСС обеспечивает считывание QR-кодов. Передача информации из внешней системы посредством QR-кодов предпочтительна в ситуации наличия жестких сетевых ограничений и политик безопасности. Посредством QR-кода информация может быть передана из внешнего контура системы безопасности во внутренний без нарушения изоляции контуров друг от друга, тем самым нивелировав возможность взлома системы извне. Так например, может быть передана информация о владельце пропуска от внешней заявочной пропускной системы в АРМ НЕЙРОСС Доступ, исключив прямую передачу персональных данных.
6 +
7 +**Порядок действий**
8 +
9 +Для реализации возможности ввода данных владельца пропуска посредством считывания QR-кода вам потребуется:
10 +
11 +1. Настроить сканер QR-кодов для работы в режиме клавиатуры;
12 +1. Установить сервис обмена данными между физическим оборудованием (сканером QR-кодов) и веб-приложением Платформы НЕЙРОСС через протокол WebSocket;
13 +1. Настроить шаблон формы владельца пропуска с функционалом ввода данных с QR-кода.
14 +
15 +(% class="box infomessage" %)
16 +(((
17 +Проверка проводилась на сканере АТОЛ SB2108 Plus,  настроенном в режим работы «виртуальный последовательный порт USB».
18 +)))
19 +
20 +
21 +
22 +
23 +
24 +**Окружение**
25 +
26 +(% class="wikigeneratedid" %)
27 +Обеспечивается работа на рабочем месте АРМ НЕЙРОСС Доступ под управлением ОС семества Linux. Сервис считывания QR-кодов устанавливается непосредственно на рабочем месте оператора и работает локально.
28 +
29 +== Настройка сканера QR-кодов ==
30 +
31 +Порядок настройки зависит от используемого оборудования и осуществляется согласно инструкции производителя. Важно настроить работу сканера в режиме клавиатуры. Требуется поддержка передачи данных данных в формате vCard. Для проверки правильности настройки рекомендуется:
32 +
33 +1. Открыть любой текстовой редактор;
34 +1. Отсканировать QR-код;
35 +1. Проверить соответствие полученных данных образцу ниже.
36 +
37 +{{code}}
38 +BEGIN:VCARD
39 + VERSION:4.0
40 + FN:Иванов Иван Иванович
41 + N:Иванов Иван Иванович
42 + BDAY:1968-01-02
43 + BIRTHPLACE:гор. Ленинград
44 + TITLE:Грузчик Оператор Перронной Техники
45 + ADR:г Санкт-Петербург, р-н Фрунзенский, ул Будапештская, д 1 к 1, кв 1
46 + NALITY:RU
47 + ORG:ООО "ВОЗДУШНЫЕ ВОРОТА СЕВЕРНОЙ СТОЛИЦЫ"
48 + TEL:+79215555555
49 + X-PASSPORT-NUMBER:4013770000
50 + X-PASSPORT-ISSUED:2014-02-04
51 + X-PASSPORT-AUTHORITY:ТП № 139 ОУФМС России по Санкт-Петербургу и Ленинградской обл. в Центральном районе г. Санкт-Петербурга
52 +END:VCARD
53 +{{/code}}
54 +
55 +== Настройка сервиса COM-порта ==
56 +
57 +{{warning}}
58 +Сервис устанавливается и настраивается на компьютере, к которому подключен считыватель QR-кодов, и на котором установлено приложение АРМ НЕЙРОСС Доступ.
59 +{{/warning}}
60 +
61 +Сервис поставляется в виде dep-пакета.
62 +
63 +{{code}}
64 +neyross-com-to-websocket-1.0.79.deb
65 +{{/code}}
66 +
67 +Номер версии  может отличаться.
68 +
69 +Установите и запустите сервис. При работе в среде ОС Ubuntu используйте следующий набор команд:
70 +
71 +{{code}}
72 +sudo dpkg -i package_name.deb
73 +sudo systemctl enable com-to-websocket-service.service
74 +sudo systemctl start com-to-websocket-service.service
75 +sudo systemctl status com-to-websocket-service.service
76 +{{/code}}
77 +
78 +
79 +Настройка сервиса осуществляется посредством веб-интерфейса. доступном по порту## 3002##.
80 +
81 +Введите в адресной строке браузера:
82 +
83 +{{code}}
84 +localhost:3002
85 +{{/code}}
86 +
87 +Откроется окно интрерфейса.
88 +
89 + [[image:QR-reader-service.png||height="444" width="900"]]
90 +
91 +По умолчанию настройка сервиса не требуется, но при необходимости вы можете выполнить требуемые настройки.
92 +
93 +Настройки сохраняются в файле ##config.yaml ##в директории приложения:
94 +
95 +{{code}}
96 +usr/share/neyross-com-to-websocket/
97 +{{/code}}
98 +
99 +Формат файла приведен ниже.
100 +
101 +{{code language=" python"}}
102 +# Пример конфигурационного файла для com-to-websocket-service
103 +
104 +# Настройки COM-порта
105 +com:
106 + # Путь к COM-порту (для Linux: /dev/ttyACM0)
107 + port: /dev/ttyACM0
108 + # Скорость передачи данных (baud rate)
109 + baudrate: 115200
110 + # Таймаут чтения из COM-порта (в миллисекундах)
111 + timeout: 100
112 +
113 +# Настройки HTTP сервера
114 +server:
115 + # Хост, на котором будет запущен сервер
116 + # По умолчанию: 127.0.0.1 (только локальные подключения)
117 + # Для доступа с других машин: 0.0.0.0
118 + host: 127.0.0.1
119 + # Порт сервера
120 + port: "3002"
121 +{{/code}}
122 +
123 +(% class="box warningmessage" %)
124 +(((
125 +При изменении номера порта потребуется скорректировать шаблоны форм.
126 +)))
127 +
128 +== Настройка шаблонов формы владельца пропуска ==
129 +
130 + Шаблон формы поставляется в виде готового файла формата JSX. Загрузите полученный файл шаблона для требуемой группы пропусков ~[[[Готовый шаблон формы>>doc:neyross.setup.access-control.input-forms.form-template.WebHome]]].
131 +
132 +[[image:QR-form_template.png]]
133 +
134 +== Сканирование данных ==
135 +
136 +Запустите АРМ НЕЙРОСС Доступ.
QR-form_template.png
Автор
... ... @@ -1,0 +1,1 @@
1 +XWiki.admin
Размер
... ... @@ -1,0 +1,1 @@
1 +8.1 KB
Содержимое
QR-reader-service.png
Автор
... ... @@ -1,0 +1,1 @@
1 +XWiki.admin
Размер
... ... @@ -1,0 +1,1 @@
1 +44.7 KB
Содержимое

Платформа НЕЙРОСС