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

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