Узлы НЕЙРОСС предоставляют кроссплатформенный интерфейс настройки, мониторинга и управления, построенный на технологиях HTTP, JSON, REST и websocket.
НЕЙРОСС HTTP API – единый для всех узлов НЕЙРОСС инструмент для двустороннего взаимодействия с внешними информационными системами (ВИС).
В качестве интегрируемой системы может выступать прикладное программное средство, приложение, программа, выполняющая функции по назначению, и в своих бизнес-процессах использующая данные сети НЕЙРОСС и возможности управления.
Для интеграции с внешними информационными системами в части функций системы контроля и управления доступом (СКУД) предназначен плагин НЕЙРОСС ВИС. Плагин обеспечивает:
[Интеграция с «внешними» информационными системами (ВИС)]
Плагин реализует HTTP-API, позволяющее:
Плагин обеспечивает передачу и получение авторизованных HTTP-запросов, лицензируется по количеству точек доступа НЕЙРОСС, доступных для управления из «внешней» информационной системы.
Описание HTTP API может быть предоставлено при условии подписания соглашения о неразглашении, в котором обязательно указывается цель использования API и объект применения. Описание API предоставляется на условиях «как есть» ("as is"), и его предоставление не подразумевает, что компания ИТРИУМ берет на себя обязательства по технической поддержке разработки. В случае, если такая поддержка необходима, она может быть предоставлена на основании отдельного возмездного договора об оказании информационно-консультационных услуг. |
В таблице ниже перечислены разделы документации по НЕЙРОСС HTTP API.
Общая информация | |
Модель данных | Общее описание структуры данных в НЕЙРОСС |
Протокол взаимодействия | Общее описание порядка использования HTTP-API для взаимодействия с НЕЙРОСС |
HTTP-API: Общее | |
Авторизация | Порядок авторизации для получения доступа к HTTP-сервисам |
Сетевые узлы | Получение сведений об узлах в сети НЕЙРОСС |
Функциональные элементы | Получение сведений обо всех функциональных элементах в составе узла НЕЙРОСС |
HTTP-API: СКУД | |
Пропуска | Создание, изменение, удаление пропусков |
Владельцы пропусков | Создание, изменение, удаление владельцев пропусков |
Уровни доступа | Получение списка уровней доступа, зарегистрированных в системе |
Точки доступа | Получение списка точек доступа (для последующей привязки событий доступа) |
События доступа | Получение в реальном времени событий (событий доступа) |
Верификация лиц (клиент) | Биометрическая верификация лиц через внешний сервис; при наличии плагина НЕЙРОСС-FC |
HTTP-API: ОТС | |
Зоны охранной сигнализации | Получение списка зон охранной сигнализации, зарегистрированных в системе; управление зонами |
Разделы охранной сигнализации | Получение списка разделов охранной сигнализации, зарегистрированных в системе; управление разделами |
SOAP-API: Общее | |
Журнал событий | Получение событий из журнала узла НЕЙРОСС |
Низкоуровневое API | |
Импорт / экспорт ресурсов | Описание низкоуровневого протокола загрузки в узлы НЕЙРОСС полного набора данных (пропусков и пр.) |
Контрольная сумма | Описание специального режима работы контроллера, при котором выполняется расчёт контрольной суммы пропусков во встроенной базе данных Описание способа активации указанного режима, алгоритма формирования контрольной суммы и HTTP-API получения значения контрольной суммы |
Инструкция по использованию НЕЙРОСС HTTP API на примере создания шаблонов отчётов приведена в разделе [ultima-reports-api:1.4.2]. |
Узлы НЕЙРОСС реализуют основные Onvif®-сервисы в рамках профиля Onvif® Profile C и могут быть интегрированы в смежные системы в рамках данных спецификаций.
ONVIF – организация, разрабатывающая набор профайлов стандартных открытых протоколов интеграции (в основном видео). 99% представленных на рынке IP-камер поддерживают ONVIF.
Узлы НЕЙРОСС обеспечивают автоматическое обнаружение всех узлов сети, поддерживающих ONVIF. Обмен сообщениями между узлами НЕЙРОСС осуществляется также в форме ONVIF-извещений в формате XML-сообщений. Протокол информационного взаимодействия, построенный в соответствии ONVIF Profile C, позволяет узлам НЕЙРОСС также взаимодействовать со средствами IP-видеонаблюдения, пожарной сигнализации, автоматики и систем жизнеобеспечения без специализированных программных средств.
Modbus — открытый коммуникационный протокол, который широко применяется в промышленности для организации связи между электронными устройствами. Существуют реализации протокола для интерфейсов RS-232, RS-485 (Modbus RTU) и TCP/IP (Modbus TCP). Протокол поддерживается большинством разработчиков оборудования. Интеграция смежных систем в НЕЙРОСС может осуществляться:
В настоящее время реализована интеграция следующего оборудования:
Болид ИСО Орион [Мониторинг и управление ОРИОН (БОЛИД)]
Под заказ возможна интеграция другого оборудования.
В системах безопасности важно контролировать техническое состояние серверов, источников бесперебойного питания и показания датчиков, сетевую нагрузку, отслеживать занятость и процент битых секторов жестких дисков, объём оперативной памяти, падения служб и доступность веб-интерфейсов. Оптимальный способ для решения таких задач — сервер Zabbix. Zabbix — бесплатное программное обеспечение с открытым исходным кодом; предоставляется документация на русском языке, форум техподдержки, готовые шаблоны для мониторинга множества типов оборудования и программных средств, возможно автоматическое обнаружение узлов. Многие производители оборудования предоставляют шаблоны для интеграции в Zabbix.
Сбор данных с узлов (хостов) может осуществляться с помощью Zabbix-агентов, которые устанавливаются на хосты и работают в режиме демона. Это мощный механизм проверок, однако информацию с устройства можно получить при помощи других интерфейсов: SNMP-агент, JMX и IPMI. Если задать одновременно несколько интерфейсов, будет выполнен поиск доступных у узла сети в следующем порядке: Агент→SNMP→JMX→IPMI, — и узел будет связан с первым подходящим ему интерфейсом. Также доступны проверки через SSH, Telnet, HTTP, ODBS и другие.
Мы в Платформе НЕЙРОСС реализовали интеграцию с сервером Zabbix: вычитывание группы сетевых узлов (хостов) и работа с ними, как с элементами НЕЙРОСС: просмотр метрик хостов, получение событий об изменении триггеров в ленте событий АРМ НЕЙРОСС Центр, просмотр элементов данных. Достаточно указать IP-адрес сервера Zabbix, логин и пароль пользователя, разместить элементы на плане объекта и раздать права на мониторинг. Инструкция приведена в разделе [Мониторинг серверов и сетей: интеграция с Zabbix (агент, SNMP, JMX, IPMI)]. |
Часто на объекте или в обслуживающей организации контролируется техническое состояние серверов и сетевого оборудования независимо от Платформы НЕЙРОСС. При этом бывает удобно получать дополнительно инвентаризационные данные по Платформе НЕЙРОСС или уведомления о важных событиях.
Мы сформировали шаблон для узлов Платформы НЕЙРОСС, который позволяет получать следующие данные:
Инструкция приведена в разделе []. |
Передача на сервер Zabbix перечисленных данных осуществляется с помощью PUSH-запроса.
API – описание способов, которыми одна система программа может взаимодействовать с другой.
Плагин интеграции — это независимый программный модуль, предназначенный для расширения функционала Платформы НЕЙРОСС и контроллеров БОРЕЙ. В настоящее время реализованы плагины интеграции следующего оборудования/сервисов:
Узлы НЕЙРОСС (например, контроллеры БОРЕЙ, ЯРС) позволя.ют изменять логику своей работы (алгоритмов доступа, охранной сигнализации) с помощью пользовательских сценариев на языке Lua.
С помощью скриптов автоматизации можно:
Скрипт автоматизации должен быть написан на языке Lua. Подробная информация приведена в руководстве разработчика. Загрузка сценариев осуществляется через веб-интерфейс контроллера в разделе [Плагины].
Стандартные протоколы OPС, SNMP
Интеграция оборудования и сервисов по протоколам OPC и SNMP в НЕЙРОСС осуществляются посредством узлов ПАК Интеграция / ITRIUM, которые являются полноправными узлами сети НЕЙРОСС.
ПАК Интеграция / ITRIUM могут выступать в качестве:
Для обеспечения взаимодействия ITRIUM / ПАК Интеграция с другими узлами НЕЙРОСС необходимо настроить «Службу НЕЙРОСС» и опубликовать элементы, мониторинг и управление которыми следует осуществлять из сети НЕЙРОСС [Представление (публикация) элементов ITRIUM / ПАК Интеграция в НЕЙРОСС]. |
Интеграция оборудования с помощью соответствующего драйвера интеграции осуществляется посредством узла ПАК Интеграция.
ПАК Интеграция обеспечивает работу следующих драйверов:
Перечень компонентов ПАК Интеграция приведён в разделе [Компоненты].
Для обеспечения взаимодействия ПАК Интеграция с другими узлами НЕЙРОСС необходимо настроить «Службу НЕЙРОСС» и обозначить элементы, мониторинг состояний и управление которыми следует осуществлять из сети НЕЙРОСС [Представление (публикация) элементов ITRIUM / ПАК Интеграция в НЕЙРОСС]. |