Skip to Content
Version 3.3 by admin on 2026/06/17 20:53
Show last authors
1 НЕЙРОСС предоставляет широкий выбор инструментов интеграции. Интеграция предназначена для обеспечения мониторинга состояний и передачи команд управления между программными и аппаратными средствами «сторонних» производителей и НЕЙРОСС.
2
3 [[image:attach:ui.Параметры узла.WebHome@content.png||thumbnail="true" height="10"]] Содержание:
4
5 {{toc depth="2"/}}
6
7 == {{id name="Инструментыинтеграции-НЕЙРОССHTTPAPI"/}}НЕЙРОСС HTTP API ==
8
9 Узлы НЕЙРОСС предоставляют кроссплатформенный интерфейс настройки, мониторинга и управления, построенный на технологиях HTTP, JSON, REST и websocket.
10
11 **НЕЙРОСС HTTP API** – единый для всех узлов НЕЙРОСС инструмент для двустороннего взаимодействия с внешними информационными системами (ВИС).
12
13 В качестве интегрируемой системы может выступать прикладное программное средство, приложение, программа, выполняющая функции по назначению, и в своих бизнес-процессах использующая данные сети НЕЙРОСС и возможности управления.
14
15 === {{id name="Инструментыинтеграции-ПлагинНЕЙРОССВИС"/}}Плагин НЕЙРОСС ВИС ===
16
17 Для интеграции с внешними информационными системами в части функций системы контроля и управления доступом (СКУД) предназначен плагин НЕЙРОСС ВИС. Плагин обеспечивает:
18
19 * **Управление данными владельцев и пропусков** — создание, изменение владельцев и пропусков с загрузкой данных из ВИС в НЕЙРОСС и наоборот, — из НЕЙРОСС в ВИС.
20 * **Удалённый СКУД** — инициирование транзакций доступа из ВИС в НЕЙРОСС на конкретной ТД и уведомление ВИС от НЕЙРОСС о результате транзакции.
21
22 ~[[[Интеграция с «внешними» информационными системами (ВИС)>>doc:neyross.Настройка Платформы НЕЙРОСС.Инструменты интеграции.Интеграция с «внешними» информационными системами (ВИС).WebHome]]]
23
24 Плагин реализует HTTP-API, позволяющее:
25
26 1. Получить из НЕЙРОСС список всех уровней доступа, разрешенных «внешней» системе (УД ВИС);
27 1. Получить из НЕЙРОСС список всех точек доступа ВИС, которые которые указаны хотя бы в одном УД ВИС (ТД ВИС);
28 1. Получить из НЕЙРОСС список всех владельцев пропусков, которым назначен хотя бы один УД ВИС (пропуска ВИС);
29 1. Создавать новых владельцев пропусков ВИС;
30 1. Инициировать из ВИС транзакцию доступа владельцев пропусков ВИС через ТД ВИС.
31
32 Плагин обеспечивает передачу и получение авторизованных HTTP-запросов, лицензируется по количеству точек доступа НЕЙРОСС, доступных для управления из «внешней» информационной системы.
33
34 === {{id name="Инструментыинтеграции-ПолныйHTTPAPI"/}}Полный HTTP API ===
35
36 {{info}}
37 Описание HTTP API может быть предоставлено при условии подписания соглашения о неразглашении, в котором обязательно указывается цель использования API и объект применения. Описание API предоставляется на условиях «как есть» ("as is"), и его предоставление не подразумевает, что компания ИТРИУМ берет на себя обязательства по технической поддержке разработки. В случае, если такая поддержка необходима, она может быть предоставлена на основании отдельного возмездного договора об оказании информационно-консультационных услуг.
38 {{/info}}
39
40 В таблице ниже перечислены разделы документации по НЕЙРОСС HTTP API.
41
42 |(% colspan="2" %)(((
43 **Общая информация**
44 )))
45 |(((
46 Модель данных
47 )))|(((
48 Общее описание структуры данных в НЕЙРОСС
49 )))
50 |(((
51 Протокол взаимодействия
52 )))|(((
53 Общее описание порядка использования HTTP-API для взаимодействия с НЕЙРОСС
54 )))
55 |(% colspan="2" %)(((
56 **HTTP-API: Общее**
57 )))
58 |(((
59 Авторизация
60 )))|(((
61 Порядок авторизации для получения доступа к HTTP-сервисам
62 )))
63 |(((
64 Сетевые узлы
65 )))|(((
66 Получение сведений об узлах в сети НЕЙРОСС
67 )))
68 |(((
69 Функциональные элементы
70 )))|(((
71 Получение сведений обо всех функциональных элементах в составе узла НЕЙРОСС
72 )))
73 |(% colspan="2" %)(((
74 **HTTP-API: СКУД**
75 )))
76 |(((
77 Пропуска
78 )))|(((
79 Создание, изменение, удаление пропусков
80 )))
81 |(((
82 Владельцы пропусков
83 )))|(((
84 Создание, изменение, удаление владельцев пропусков
85 )))
86 |(((
87 Уровни доступа
88 )))|(((
89 Получение списка уровней доступа, зарегистрированных в системе
90 )))
91 |(((
92 Точки доступа
93 )))|(((
94 Получение списка точек доступа (для последующей привязки событий доступа)
95 )))
96 |(((
97 События доступа
98 )))|(((
99 Получение в реальном времени событий (событий доступа)
100 )))
101 |(((
102 Верификация лиц (клиент)
103 )))|(((
104 Биометрическая верификация лиц через внешний сервис; при наличии плагина НЕЙРОСС-FC
105 )))
106 |(% colspan="2" %)(((
107 **HTTP-API: ОТС**
108 )))
109 |(((
110 Зоны охранной сигнализации
111 )))|(((
112 Получение списка зон охранной сигнализации, зарегистрированных в системе; управление зонами
113 )))
114 |(((
115 Разделы охранной сигнализации
116 )))|(((
117 Получение списка разделов охранной сигнализации, зарегистрированных в системе; управление разделами
118 )))
119 |(% colspan="2" %)(((
120 **SOAP-API: Общее**
121 )))
122 |(((
123 Журнал событий
124 )))|(((
125 Получение событий из журнала узла НЕЙРОСС
126 )))
127 |(% colspan="2" %)(((
128 **Низкоуровневое API**
129 )))
130 |(((
131 Импорт / экспорт ресурсов
132 )))|(((
133 Описание низкоуровневого протокола загрузки в узлы НЕЙРОСС полного набора данных (пропусков и пр.)
134 )))
135 |(((
136 Контрольная сумма
137 )))|(((
138 Описание специального режима работы контроллера, при котором выполняется расчёт контрольной суммы пропусков во встроенной базе данных
139
140 Описание способа активации указанного режима, алгоритма формирования контрольной суммы и HTTP-API получения значения контрольной суммы
141 )))
142
143 {{info}}
144 Инструкция по использованию НЕЙРОСС HTTP API на примере создания шаблонов отчётов приведена в разделе ~[[[doc:neyross.Настройка Платформы НЕЙРОСС.Настройка функций подготовки отчётов.Руководство разработчика | Отчёты.ultima-reports-api\:1\.4\.2.WebHome]]].
145 {{/info}}
146
147 == {{id name="Инструментыинтеграции-SOAP,стандартныепрофайлыONVIF"/}}SOAP, стандартные профайлы ONVIF ==
148
149 Узлы НЕЙРОСС реализуют основные Onvif®-сервисы в рамках профиля Onvif® Profile C и могут быть интегрированы в смежные системы в рамках данных спецификаций.
150
151 **ONVIF **– организация, разрабатывающая набор профайлов стандартных открытых протоколов интеграции (в основном видео). 99% представленных на рынке IP-камер поддерживают ONVIF.
152
153 Узлы НЕЙРОСС обеспечивают автоматическое обнаружение всех узлов сети, поддерживающих ONVIF. Обмен сообщениями между узлами НЕЙРОСС осуществляется также в форме ONVIF-извещений в формате XML-сообщений. Протокол информационного взаимодействия, построенный в соответствии ONVIF Profile C, позволяет узлам НЕЙРОСС также взаимодействовать со средствами IP-видеонаблюдения, пожарной сигнализации, автоматики и систем жизнеобеспечения без специализированных программных средств.
154
155 == {{id name="Инструментыинтеграции-СтандартныйпротоколModbus"/}}Стандартный протокол Modbus ==
156
157 Modbus — открытый коммуникационный протокол, который широко применяется в промышленности для организации связи между электронными устройствами. Существуют реализации протокола для интерфейсов RS-232, RS-485 (Modbus RTU) и TCP/IP (Modbus TCP). Протокол поддерживается большинством разработчиков оборудования. Интеграция смежных систем в НЕЙРОСС может осуществляться:
158
159 * по протоколу Modbus RTU с помощью дополнительного коммуникационного модуля и программного модуля (плагина) к контроллеру доступа БОРЕЙ; физическое подключение шины Modbus осуществляется к разъёму RS-485 или RS-232 контроллера ~[[[doc:borey3.Комплекты интеграции.WebHome]]];
160 * по протоколу Modbus TCP с помощью дополнительного программного модуля (плагина) к Платформе НЕЙРОСС.
161
162 В настоящее время реализована интеграция следующего оборудования:
163
164 * Болид ИСО Орион ~[[[doc:neyross.Настройка Платформы НЕЙРОСС.Настройка функций мониторинга и реагирования.Интеграция смежных систем по протоколу MODBUS.Мониторинг и управление ОРИОН (БОЛИД).WebHome]]]
165 * AHI Carrier GST на базе панелей GST-IFP8-RU ~[[[doc:neyross.Настройка Платформы НЕЙРОСС.Настройка функций мониторинга и реагирования.Интеграция смежных систем по протоколу MODBUS.Мониторинг GST (AHI Carrier).WebHome]]]
166 * ТД Рубеж RUBEZH R3
167 * ГК Сигма Система пожарной сигнализации Рубеж-08 ~[[[doc:neyross.Настройка Платформы НЕЙРОСС.Настройка функций мониторинга и реагирования.Интеграция смежных систем по протоколу MODBUS.Мониторинг и управление Рубеж-08 (Сигма).WebHome]]]
168
169 Под заказ возможна интеграция другого оборудования.
170
171 == {{id name="Инструментыинтеграции-Zabbix"/}}Zabbix ==
172
173 === {{id name="Инструментыинтеграции-Мониторингсерверовисетей(интерфейсы:Zabbix-агент,SNMP,JMX,IPMI,SSH,Telnet,HTTP,ODBS)изПлатформыНЕЙРОСС"/}}Мониторинг серверов и сетей (интерфейсы: Zabbix-агент, SNMP, JMX, IPMI, SSH, Telnet, HTTP, ODBS) из Платформы НЕЙРОСС ===
174
175 В системах безопасности важно контролировать техническое состояние серверов, источников бесперебойного питания и показания датчиков, сетевую нагрузку, отслеживать занятость и процент битых секторов жестких дисков, объём оперативной памяти, падения служб и доступность веб-интерфейсов. Оптимальный способ для решения таких задач — сервер Zabbix. [[Zabbix >>url:https://www.zabbix.com/ru||shape="rect"]]— бесплатное программное обеспечение с открытым исходным кодом; предоставляется документация на русском языке, форум техподдержки, [[готовые шаблоны>>url:https://www.zabbix.com/ru/integrations||shape="rect"]] для мониторинга множества типов оборудования и программных средств, возможно автоматическое обнаружение узлов. Многие производители оборудования предоставляют шаблоны для интеграции в Zabbix.
176
177 Сбор данных с узлов (хостов) может осуществляться с помощью Zabbix-агентов, которые устанавливаются на хосты и работают в режиме демона. Это мощный механизм проверок, однако информацию с устройства можно получить при помощи других интерфейсов: SNMP-агент, JMX и IPMI.  Если задать одновременно несколько интерфейсов, будет выполнен поиск доступных у узла сети в следующем порядке: Агент→SNMP→JMX→IPMI, — и узел будет связан с первым подходящим ему интерфейсом. Также доступны проверки через SSH, Telnet, HTTP, ODBS и другие.
178
179 {{info}}
180 Мы в Платформе НЕЙРОСС реализовали интеграцию с сервером Zabbix: вычитывание группы сетевых узлов (хостов) и работа с ними, как с элементами НЕЙРОСС: просмотр метрик хостов, получение событий об изменении триггеров в ленте событий АРМ НЕЙРОСС Центр, просмотр элементов данных. Достаточно указать IP-адрес сервера Zabbix, логин и пароль пользователя, разместить элементы на плане объекта и раздать права на мониторинг. Инструкция приведена в разделе ~[[[doc:neyross.Настройка Платформы НЕЙРОСС.Настройка функций мониторинга и реагирования.Мониторинг серверов и сетей\: интеграция с Zabbix (агент, SNMP, JMX, IPMI).WebHome]]].
181 {{/info}}
182
183 === {{id name="Инструментыинтеграции-ШаблондляполученияинвентаризационныхданныхисобытийПлатформыНЕЙРОССизZabbix"/}}Шаблон для получения инвентаризационных данных и событий Платформы НЕЙРОСС из Zabbix ===
184
185 Часто на объекте или в обслуживающей организации контролируется техническое состояние серверов и сетевого оборудования независимо от Платформы НЕЙРОСС. При этом бывает удобно получать дополнительно инвентаризационные данные по Платформе НЕЙРОСС или уведомления о важных событиях.
186
187 {{info}}
188 Мы сформировали шаблон для узлов Платформы НЕЙРОСС, который позволяет получать следующие данные:
189
190 * Имя сервера Платформы НЕЙРОСС,
191 * Модель,
192 * Версия программных средств Платформы НЕЙРОСС
193 * Производитель
194 * Статус задач на запись - данный элемент данных содержит два триггера: ошибка записи, более 9 ошибок записи за последние 10 минут.
195
196 Инструкция приведена в разделе [].
197 {{/info}}
198
199
200 Передача на сервер Zabbix перечисленных данных осуществляется с помощью PUSH-запроса.
201
202 == {{id name="Инструментыинтеграции-API«сторонних»производителей"/}}API «сторонних» производителей ==
203
204 **API** – описание способов, которыми одна система программа может взаимодействовать с другой.
205
206 * Интеграция с терминалом распознавания лиц Hikvision
207 * Интеграция с системой распознавания автомобильных номеров Автомаршал
208 * Интеграция с системой биометрической идентификации BioSmart
209 * и другие
210
211 == {{id name="Инструментыинтеграции-Плагины"/}}Плагины ==
212
213 Плагин интеграции — это независимый программный модуль, предназначенный для расширения функционала Платформы НЕЙРОСС и контроллеров БОРЕЙ.
214
215 Перечень плагинов приведен в разделе ~[[[Плагины>>doc:ui.Параметры узла.Плагины.WebHome]]].
216
217 == {{id name="Инструментыинтеграции-LUA-скрипты"/}}LUA - скрипты ==
218
219 Узлы НЕЙРОСС (например, контроллеры БОРЕЙ, ЯРС) позволя.ют изменять логику своей работы (алгоритмов доступа, охранной сигнализации) с помощью пользовательских сценариев на языке Lua.
220
221 С помощью (% style="text-align:left" %)//скриптов автоматизации// можно:
222
223 * изменить или полностью заменить «заводскую» логику работы продукта, например, — алгоритм шлюзового доступа;
224 * реализовать логику сопряжения со внешней информационной системой по протоколу HTTP;
225 * управлять исполнительными устройствами по заданному алгоритму.
226
227 Скрипт автоматизации должен быть написан на [[языке Lua>>url:http://www.lua.org/||rel="nofollow" shape="rect" style="text-align: left;" class="external-link"]]. Подробная информация приведена в [[руководстве разработчика>>doc:ui.Руководство по скриптам Lua.WebHome]]. Загрузка сценариев осуществляется через веб-интерфейс контроллера в разделе ~[[[doc:ui.Параметры узла.Плагины.WebHome]]].
228
229 == Стандартные протоколы OPС, SNMP ==
230
231 Интеграция оборудования и сервисов по протоколам OPC и SNMP в НЕЙРОСС осуществляются посредством узлов ПАК Интеграция / ITRIUM, которые являются полноправными узлами сети НЕЙРОСС.
232
233 ПАК Интеграция / ITRIUM могут выступать в качестве:
234
235 * **OPC-клиента SCADA-системы**
236 ~[[[Драйвер OPC-сервера ~| OPC-клиент>>url:https://support.itrium.ru/x/5QAkCw||shape="rect"]]] позволяет использовать оборудование, работающее с OPC-серверами в стандартах OPC DA (Data Access) и OPC AE (Alarms & Events).
237 * **OPC-сервера**
238 ~[[[Драйвер SCADA ~| OPC-сервер>>url:https://support.itrium.ru/x/xwAlCw||shape="rect"]]] обеспечивает подключение к любой SCADA-системе, передачу в SCADA-систему событий и команд управления в виде переменных (тегов). Драйвер поддерживает стандарт OPC Data Access 2.05a.
239 * **SNMP-клиента**
240 ~[[[Драйвер SNMP-клиент>>url:https://support.itrium.ru/x/dAAkO||shape="rect"]]] позволяет получать данные от любых устройств, поддерживающих протокол SNMP (Simple Network Management Protocol).
241 * **SNMP-сервера**
242 ~[[[Драйвер SNMP ~| SNMP-сервер>>url:https://support.itrium.ru/x/cQAkO||shape="rect"]]] предназначен для изменения значений свойств элементов НЕЙРОСС по протоколу SNMP средствами программ сторонних производителей. Возможно использование любого SNMP-браузера.
243
244 {{info}}
245 Для обеспечения взаимодействия ITRIUM / ПАК Интеграция с другими узлами НЕЙРОСС необходимо настроить «Службу НЕЙРОСС» и опубликовать элементы, мониторинг и управление которыми следует осуществлять из сети НЕЙРОСС ~[[[doc:neyross.Настройка Платформы НЕЙРОСС.Инструменты интеграции.Представление (публикация) элементов ITRIUM ПАК Интеграция в НЕЙРОСС.WebHome]]].
246 {{/info}}
247
248 == Проприетарные протоколы ==
249
250 === {{id name="Инструментыинтеграции-Apollo,Biosmart,Pandora,Болид,Parsec,СигмаИС"/}}Apollo, Biosmart, Pandora, Болид, Parsec, Сигма ИС ===
251
252 Интеграция оборудования с помощью соответствующего драйвера интеграции осуществляется посредством узла ПАК Интеграция.
253
254 ПАК Интеграция обеспечивает работу следующих драйверов:
255
256 * [[Драйвер AAN (Apollo)>>url:https://support.itrium.ru/x/DgBcD||shape="rect"]]
257 * [[Драйвер BioSmart>>url:https://support.itrium.ru/x/iAAkO||shape="rect"]]
258 * [[Драйвер PLC-сервера Pandora>>url:https://support.itrium.ru/x/owAkO||shape="rect"]]
259 * [[Драйвер ИСО Орион (Болид)>>url:https://support.itrium.ru/x/BIBdD||shape="rect"]]
260 * [[Драйвер панелей Парсек (Parsec)>>url:https://support.itrium.ru/x/fwAkO||shape="rect"]]
261 * [[Драйвер Рубеж-08 (Сигма ИС)>>url:https://support.itrium.ru/x/LIDID||shape="rect"]]
262
263 Перечень компонентов ПАК Интеграция приведён в разделе ~[[[Компоненты>>url:https://support.itrium.ru/x/WgAkO||shape="rect"]]].
264
265 {{info}}
266 Для обеспечения взаимодействия ПАК Интеграция с другими узлами НЕЙРОСС необходимо настроить «Службу НЕЙРОСС» и обозначить элементы, мониторинг состояний и управление которыми следует осуществлять из сети НЕЙРОСС ~[[[doc:neyross.Настройка Платформы НЕЙРОСС.Инструменты интеграции.Представление (публикация) элементов ITRIUM ПАК Интеграция в НЕЙРОСС.WebHome]]].
267 {{/info}}