Узлы НЕЙРОСС предоставляют кроссплатформенный интерфейс настройки, мониторинга и управления, построенный на технологиях HTTP, JSON, REST и websocket.
НЕЙРОСС HTTP API – единый для всех узлов НЕЙРОСС инструмент для двустороннего взаимодействия со «сторонними» системами.
Описание 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-422, 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)]. |
API – описание способов, которыми одна система программа может взаимодействовать с другой.
Узлы НЕЙРОСС (например, контроллеры БОРЕЙ, ЯРС) позволяет изменять логику своей работы (алгоритмов доступа, охранной сигнализации) с помощью пользовательских сценариев на языке Lua.
С помощью скриптов автоматизации можно:
Скрипт автоматизации должен быть написан на языке Lua. Подробная информация приведена в руководстве разработчика. Загрузка сценариев осуществляется через веб-интерфейс контроллера в разделе [Плагины и скрипты].
Плагин интеграции — это независимый программный модуль, предназначенный для расширения функционала. Может поставляться в составе продукта (Платформа НЕЙРОСС, БОРЕЙ, ЯРС), но может быть загружен и установлен впоследствии. В настоящее время реализованы плагины интеграции следующего оборудования/сервисов:
Сканеры отпечатков пальцев Biosmart 4, Biosmart 5M, Biosmart ProxE производства «Прософт-Биометрикс» на базе БОРЕЙ/ЯРС, ближайшее время планируется поддержка модели Biosmart ProxE (средства верификации установлены на сервере НЕЙРОСС Интеграция);
Загрузка сценариев осуществляется через веб-интерфейс контроллера в разделе [Плагины и скрипты].
Интеграция оборудования и сервисов по протоколам OPC и SNMP в НЕЙРОСС осуществляются посредством узлов ПАК Интеграция / ITRIUM, которые являются полноправными узлами сети НЕЙРОСС.
ПАК Интеграция / ITRIUM могут выступать в качестве:
Для обеспечения взаимодействия ITRIUM / ПАК Интеграция с другими узлами НЕЙРОСС необходимо настроить «Службу НЕЙРОСС» и опубликовать элементы, мониторинг и управление которыми следует осуществлять из сети НЕЙРОСС [Представление (публикация) элементов ITRIUM / ПАК Интеграция в НЕЙРОСС]. |
Интеграция оборудования через поддержку проприетарных протоколов производителей и разработку соответствующего драйвера интеграции осуществляется посредством узлов ПАК Интеграция / ITRIUM.
ПАК Интеграция обеспечивает работу следующих драйверов:
Перечень компонентов ПАК Интеграция приведён в разделе [Компоненты].
Для обеспечения взаимодействия ITRIUM / ПАК Интеграция с другими узлами НЕЙРОСС необходимо настроить «Службу НЕЙРОСС» и опубликовать элементы, мониторинг и управление которыми следует осуществлять из сети НЕЙРОСС [Представление (публикация) элементов ITRIUM / ПАК Интеграция в НЕЙРОСС]. |