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