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

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