Исходный код вики Считывание QR-кодов

Версия 12.4 от admin на 2026/09/21 17:56

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