Интеграция SecurOS (ISS)

1

Платформа НЕЙРОСС в версии 20.36 обеспечивает работу с видеорегистраторами (видеосерверами) SecurOS (Секурос) производства компании IIS (Интеллектуальные системы безопасности). Функциональность доступна в редакциях SecurOS Monitoring & Control Center, SecurOS Enterprise, SecurOS Premium.

2

3

== {{id name="ИнтеграцияSecurOS(ISS)-Общиесведения"/}}Общие сведения ==

4

5

Платформа НЕЙРОСС обеспечивает взаимодействие с видеорегистраторами SecurOS по протоколам ONVIF и REST-API.

\\

**ONVIF**

Просмотр «живого» видео и видеоархива осуществляется по протоколу ONVIF без необходимости установки плагина и дополнительных лицензий, требуются только лицензии на медиаисточники. При этом поддерживаются стандартные процедуры работы, в том числе переключение препозиций, экспорт видеоархива во «внешний» файл или импорт видеоархива на видеорегистратор НЕЙРОСС. Особенности работы по ONVIF приведены в таблице ниже.

|=(((

Функция

)))|=(((

Комментарий

)))

|(((

Просмотр «живого» видео

)))|(((

Без ограничений

)))

|(((

Просмотр видеоархива

)))|(((

Проигрывание видеоархива возможно только на скорости 1x и выше: 2x, 4x, 8x, 16x, 32x, 64x. Не поддерживаются дробные: 0,5x и отрицательные: -4x, -2x, -1x (проигрывание в обратном направлении) скорости.

27

)))

28

|(((

29

Экспорт и импорт видеоархива

30

)))|(((

31

SecurOS не поддерживает режим ASAP, поэтому экспорт архива c SecurOS осуществляется более медленно, чем экспорт архива, записанного непосредственно видеорегистратором НЕЙРОСС. Возможен импорт медиаданных на видеорегистратор НЕЙРОСС.

)))

|(((

PTZ-управление

)))|(((

(((

Платформа НЕЙРОСС обеспечивает движение PTZ по абсолютным координатам, вычитывание препозиций, настроенных в конфигурации SecurOS, и выполнение команд перехода к препозиции.

38

39

40

Создание и удаление препозиций средствами Платформы НЕЙРОСС не поддерживается со стороны SecurOS.

)))

)))

\\

**REST API**

Отслеживание состояний камер, получение событий видеоаналитики и передача команд управления на видеорегистратор SecurOS осуществляется по REST API посредством «Плагина интеграции с SecurOS», устанавливаемого непосредственно на Платформу НЕЙРОСС, требуется лицензия на использование плагина. Функции плагина приведены в таблице ниже.

|=(((

Функция

)))|=(((

Комментарий

)))

|(((

Мониторинг состояния медиаисточников

58

)))|(((

59

(((

60

Обеспечивается контроль наличия связи, статус записи и статус охраны:

61

62

* есть запись / нет записи

63

* есть тревога / нет тревоги

64

* на охране / снят с охраны

65

* есть связь / нет связи

)))

)))

|(((

Мониторинг состояния узла SecurOS

70

)))|(((

71

Обеспечивается подключение к Health Monitor API и вычитывание текущих проблем. Открытая проблема приводит к появлению соответствующего события и перехода элемента сервера в состояние [Тревога]. Если закрыты все проблемы, элемент переходит в состояние [Норма]. Также обеспечивается контроль состояния связи с сервером.

72

)))

73

|(((

74

Отправка команд управления

75

)))|(((

76

(((

77

Поддержана отправка следующих команд:

* Начало записи

* (((

Остановка записи

Для управления записью камеры необходимо в настройках SecurOS задать режим записи **По команде**. Станет доступным начало записи и остановка записей, начатых по команде Платформы НЕЙРОСС. Остановка записей, начатых на самом видеосервере SecurOS, не поддерживается со стороны SecurOS.

85

86

)))

87

* Постановка на охрану

* Снятие с охраны

Для успешного выполнения команд необходимо, чтобы у пользователя SecurOS, под которым добавляется узел и авторизуется плагин, были права на управление.

)))

)))

|(((

Получение событий видеоаналитики

97

)))|(((

98

Обеспечивается работа с событиями аналитики как от встроенного детектора движения, так и от модуля аналитики Tracking Kit 3. Плагин преобразовывает получаемые от SecurOS события на язык Платформы НЕЙРОСС. Далее события обрабатываются стандартным образом: отображаются в ленте событий АРМ НЕЙРОСС Центр, по ним могут быть настроены задачи на запись, сценарии обработки и любая другая функциональность.

99

)))

100

101

== {{id name="ИнтеграцияSecurOS(ISS)-Лицензионнаяполитика"/}}Лицензионная политика ==

102

103

Функция управления камерами видеосервера SecurOS лицензируется. Проверьте наличие требуемых лицензий ~[[[Просмотр параметров и обновление лицензии>>doc:ui.node.basic.license-update.WebHome]]]. В противном случае требуется приобрести лицензии ~[[[Лицензирование Платформы НЕЙРОСС>>doc:neyross.licensing.WebHome]]].

|=(((

Тип узла

)))|=(((

Лицензия

)))|=(((

Комментарий

)))

|(% rowspan="2" %)(((

113

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

114

)))|(((

115

Количество медиаканалов

116

)))|(((

117

Лицензия должна включать требуемое количество медиаканалов.

118

)))

119

|(((

120

Плагин интеграции с SecurOS

121

)))|(((

122

Возможность передачи команд управления камерам видеосервера SecurOS

)))

\\

== {{id name="ИнтеграцияSecurOS(ISS)-НастройкаSecurOS"/}}Настройка SecurOS ==

128

129

=== {{id name="ИнтеграцияSecurOS(ISS)-БазоваянастройкаSecurOS"/}}Базовая настройка SecurOS ===

130

131

1. Выполните настройку видеосервера SecurOS согласно инструкции производителя, настройте видеоканалы.

132

1. Проверьте, что сервер SecurOS находится в одной подсети с сервером Платформы НЕЙРОСС. Это необходимо для обеспечения работы по ONVIF и REST API.

133

1. Проверьте настройки даты и времени на обоих серверах. Желательно настроить синхронизацию по одному NTP-серверу. В качестве NTP-сервера может выступать сервер Платформы НЕЙРОСС.

134

135

=== {{id name="ИнтеграцияSecurOS(ISS)-НастройкаONVIF-сервера"/}}Настройка ONVIF-сервера ===

136

137

В разделе **Интеграция и Автоматизация** настройте ONVIF-сервер:

138

139

На вкладке **Общие** задайте настройки согласно таблице ниже. Сохраните изменения.

|=(((

Параметр

)))|=(((

Комментарий

)))

|(((

RTSP-сервер

)))|(((

Выберите из раскрывающегося списка значение **Встроенный**.

)))

|(((

Протокол

)))|(((

Выберите из раскрывающегося списка значение **HTTP**.

)))

|(((

Порт

)))|(((

Укажите номер незанятого порта. По этому порту происходит взаимодействие видеосервера с Платформой НЕЙРОСС. Диапазон возможных значений: [1; 65535].

)))

|(((

Сетевой интерфейс

)))|(((

Список поля содержит все доступные сетевые интерфейсы, которые могут использоваться для подключения к ONVIF-серверу. Выберите требуемый IP-адрес. Подключение к ONVIF-серверу будет выполняться только

165

по выбранному IP-адресу.

166

)))

167

168

На вкладке **Встроенный RTSP-сервер** выберите камеры, которые должны быть доступны на Платформе НЕЙРОСС. Сохраните изменения.

169

170

[[image:attach:SecurOS_video_prp.png||width="900"]]

171

172

=== {{id name="ИнтеграцияSecurOS(ISS)-НастройкаREST-API-сервера"/}}Настройка REST-API-сервера ===

173

174

В разделе **Интеграция и Автоматизация** настройте **REST API**-сервер:

175

176

Задайте настройки согласно таблице ниже. Сохраните изменения.

|=(((

Параметр

)))|=(((

Комментарий

)))

|(((

Порт

)))|(((

(((

Номер порта SecurOS для взаимодействия с Платформой НЕЙРОСС по протоколу HTTP/HTTPS. Диапазон возможных значений: [1; 65535]. Значение по умолчанию: **8888**.

188

189

190

Порт 8888 используется Платформой НЕЙРОСС по умолчанию. В случае необходимости смены порта, откорректируйте значение параметра ##ultima.neyross.securos.apiPort##в файле конфигурации ##application.conf##(%%)на узле Платформа НЕЙРОСС.

)))

)))

|(((

Порт для

WebSocket

)))|(((

(((

Номер порта SecurOS для взаимодействия с Платформой НЕЙРОСС по протоколу WebSocket. Значение по умолчанию: **8080**.

200

201

202

Для взаимодействия по Websoket с Платформой НЕЙРОСС может использоваться ТОЛЬКО порт 8080.

)))

)))

[[image:attach:SecurOS_video_RESTAPIprp.png||width="660"]]

208

209

=== {{id name="ИнтеграцияSecurOS(ISS)-Режимзаписикамер"/}}Режим записи камер ===

210

211

Для камер, записью которых нужно управлять по команде с Платформы НЕЙРОСС, в поле **Режим записи** необходимо выбрать из раскрывающегося списка режим **По команде**.

212

213

214

Станет доступным начало записи и остановка записей, начатых по команде Платформы НЕЙРОСС. Остановка записей, начатых на самом видеосервере SecurOS, не поддерживается со стороны SecurOS.

215

216

217

(% class="auto-cursor-target" style="letter-spacing: 0.0px;" %)[[image:attach:SecurOS_cam_commands.png||width="900"]]

\\

=== {{id name="ИнтеграцияSecurOS(ISS)-ПользовательдлявзаимодействиясПлатформойНЕЙРОСС"/}}Пользователь для взаимодействия с Платформой НЕЙРОСС ===

222

223

Добавьте учетную запись пользователя, под именем которого будут выполняться команды камерам SecurOS из Платформы НЕЙРОСС. Эти данные будут указываться на сервере Платформы НЕЙРОСС при подключении видеосервера.

224

225

[[image:attach:SecurOS_userprp.png||width="730"]]

226

227

//Пример настройки пользователя secuser//

\\

Для созданной учётной записи задайте права.

232

233

234

Для пользователя ONVIF учитываются только права на управление камерами. Просмотр «живого» видео и видеоархива осуществляется независимо от заданных прав. Плагин работает с HTTP API SecurOS, используя для авторизации тот же логин и пароль, которые указываются в приложении **Сеть** при добавлении узла SecurOS. Однако с точки зрения SecurOS это разные сущности (пользователь API и пользователь Onvif); для корректной работы плагина в SecurOS должен быть заведён пользователь с тем же логином и паролем, что и пользователь Onvif, и иметь права управления.

235

236

237

Права пользователя настраиваются в соответствии с инструкцией производителя. Для удобства вы можете задать полный доступ к системе.

238

239

[[image:attach:SecurOS_user_rol.png||height="250"]]

240

241

//Пример настройки прав Full Access для пользователя secuser//

242

243

== {{id name="ИнтеграцияSecurOS(ISS)-НастройкаПлатформыНЕЙРОСС"/}}Настройка Платформы НЕЙРОСС ==

244

245

=== {{id name="ИнтеграцияSecurOS(ISS)-ДобавлениеONVIF-узла"/}}Добавление ONVIF-узла ===

246

247

Добавьте видеосервер SecurOS на Платформу НЕЙРОСС как ONVIF-медиаисточник согласно инструкции ~[[[Добавление ONVIF IP-камер, кодеров>>doc:ui.ui-network.ui-net-add-onvif.WebHome]]]. Используйте ручной режим. Задайте параметры подключения согласно таблице ниже. Нажмите на кнопку **Добавить**.

|=(((

Поле

)))|=(((

Комментарий

)))

|(((

Адрес узла

)))|(((

(((

Введите адрес в формате:

259

260

261

[ip-адрес сервера SecurOS]:[порт]

262

263

264

Введите порт, указанный в поле **Порт** на этапе ~[[[#Настройка ONVIF-сервера>>doc:||anchor="ИнтеграцияSecurOS(ISS)-НастройкаONVIF-сервера"]]].

Например:

10.1.31.195:8090

)))

)))

|(((

Аутентификация

)))|(((

Выберите из раскрывающего списка **Требуется**. И введите данные учетной записи, созданной на этапе ~[[[#Пользователь для взаимодействия с Платформой НЕЙРОСС>>doc:||anchor="ИнтеграцияSecurOS(ISS)-ПользовательдлявзаимодействиясПлатформойНЕЙРОСС"]]].

277

)))

278

279

[[image:attach:SecurOS_add_node.png]]

\\

Дождитесь изменения статуса подключения на **норма**. Перечень статусов узлов приведен в разделе ~[[[Сеть>>doc:ui.ui-network.WebHome]]].

284

285

286

Если статус отличен от норма, вы ошиблись при вводе адреса или учетных данных пользователя, либо отсутствует сетевое соединение. Текущий статус позволит выявить причину ошибки. При неверных данных удалите узел и повторите добавление с корректными данными.

\\

=== {{id name="ИнтеграцияSecurOS(ISS)-Настройкамедиаисточников"/}}Настройка медиаисточников ===

292

293

После успешного добавления узла производится автоматическое вычитывание медиаисточников и их профилей.

294

295

296

При первом добавлении видеосервера, актуальный статус камер будет вычитан в течение минуты.

\\

Вы можете изменить названия медиаисточников, заданные автоматически, и настроить другие параметры.

302

303

~[[[ONVIF-медиаисточники>>doc:ui.node.ui-media-sources.ui-onvif-sources.WebHome]]]

304

305

=== {{id name="ИнтеграцияSecurOS(ISS)-Установкаплагина"/}}Установка плагина ===

306

307

Модуль интеграции с видеосерверами SecurOS поставляется в виде [[плагина>>doc:ui.node.plugins.WebHome]] — независимого программного модуля, предназначенного для расширения функционала. Установка плагина является стандартной процедурой и не зависит от предоставляемых функций. Перечень разработанных плагинов и порядок их установки приведён в разделе ~[[[Плагины>>doc:ui.node.plugins.WebHome]]].

308

309

310

Право использования функции указывается в параметрах лицензии. Дополнительная активация не требуется.

\\

== {{id name="ИнтеграцияSecurOS(ISS)-ФункцииПлатформыНЕЙРОСС"/}}Функции Платформы НЕЙРОСС ==

316

317

=== {{id name="ИнтеграцияSecurOS(ISS)-Просмотр«живого»видеоивидеорхива"/}}Просмотр «живого» видео и видеорхива ===

318

319

АРМ НЕЙРОСС видео обеспечивает просмотр «живого» видео ~[[[«Живое» видео>>doc:neyross.arm-video.live-video.WebHome]]] и видеорхива ~[[[Видеоархив>>doc:neyross.arm-video.video-archive.WebHome]]]. Видеоархив является внешним, поэтому отображается в виде голубой штриховки, полосатым.

320

321

=== {{id name="ИнтеграцияSecurOS(ISS)-Управлениекамерами"/}}Управление камерами ===

322

323

После установки плагина станут доступны команды управления камерами видеосервера SecurOS.

324

325

PTZ-управление, в том числе переключение препозиций, возможно в режиме просмотра «живого» видео АРМ НЕЙРОСС Видео ~[[[«Живое» видео>>doc:neyross.arm-video.live-video.WebHome]]].

326

327

Доступ к командам управления возможен:

328

329

1. Из интерфейса конфигурирования ~[[[Команды управления>>doc:ui.node.ui-elements.ui-element-commands.WebHome]]];

330

1. (((

331

Средствами пользовательского приложения [[АРМ НЕЙРОСС Центр>>doc:neyross.arm-center.WebHome]]

332

333

334

Предварительно необходимо нанести элементы **Камера** на план объекта ~[[[Настройка функций мониторинга и реагирования>>doc:neyross.setup.monitoring-setup.WebHome]]].

)))

Вы можете дополнительно разграничить права операторов на команды управления на стороне Платформы НЕЙРОСС через «белый» и «черный» списки ~[[[Права на мониторинг и управление (АРМ Центр)>>doc:neyross.setup.users.center-rights.WebHome]]].

340

341

342

[[image:attach:SecurOS_camera_commands.png]]

343

344

345

Для успешного выполнения команд необходимо, чтобы у пользователя SecurOS, под которым добавляется узел и авторизуется плагин, были права на управление. Вне зависимости от наличия прав, команды выдаются в списке доступных. Однако но если права не подразумевают выполнение команды, формируется ошибка:

346

347

348

Ошибка выполнения команды: не удалось выполнить команду Начать запись над SecurOS камерой [имя камеры]. Причина: у пользователя нет прав на выполнение команды.

=== {{id name="ИнтеграцияSecurOS(ISS)-ИконкимедиаисточниковвАРМЦентр"/}}Иконки медиаисточников в АРМ Центр ===

353

354

Вид иконки элемента Медиаисточник зависит от текущего состояния элемента, который выражен набором меток. Существует предустановленный набор иконок для стандартных комбинаций меток ~[[[Состояния элементов НЕЙРОСС: метки, иконки>>doc:ui.ui-element-states.WebHome]]] (норма, тревога, неисправность, потеря связи). При помощи редактора иконок вы можете изменить иконки для стандартных комбинаций, а также настроить «свои» иконки для собственных комбинаций меток.

355

356

~[[[Редактор иконок>>doc:ui.node.ui-elements.ui-elements-icon-editor.WebHome]]]

357

358

Ниже приведены примеры иконок.

|=(((

Иконка

)))|=(((

Метки

)))|=(((

Комментарий

)))

|(((

(((

[[image:attach:icons_camera_armed.png||thumbnail="true" height="32"]]

370

)))

371

)))|(((

372

МедиаИсточник, Норма, НаОхране

373

)))|(((

374

Медиаисточник на охране, запись не ведется.

)))

|(((

(((

[[image:attach:icons_camera_normal.png||thumbnail="true" height="33"]]

379

)))

380

)))|(((

381

Медиаисточник, Норма, БезОхраны

382

)))|(((

383

Медиаисточник не на охране, запись не ведется. Иконка включена в базовый набор.

)))

|(((

(((

[[image:attach:icons_camera_rec.png||thumbnail="true" height="32"]]

388

)))

389

)))|(((

390

МедиаИсточник, ЗаписьИдёт, СетевойУзел, МедиаИсточник

391

)))|(((

392

(((

393

Медиаисточник не на охране. запись ведется. В базовом наборе для данной комбинации меток используется другая иконка: [[image:attach:icons_camera_play.png||thumbnail="true" height="33"]]

)))

)))

|(((

(((

[[image:attach:icons_camera_rec_armed.png||thumbnail="true" height="32"]]

399

)))

400

)))|(((

401

МедиаИсточник, ЗаписьИдёт, НаОхране, МедиаИсточник

402

)))|(((

403

Медиаисточник на охране, запись ведется.

)))

|(((

(((

[[image:attach:icons_camera_alarm.png||thumbnail="true" height="32"]]

408

)))

409

)))|(((

410

НаОхране, ЗаписьИдёт, Тревога, МедиаИсточник

411

)))|(((

412

Получено тревожное событие видеоаналитики. По получению события завершения тревоги элемент Медиаисточник переходит в нормальное состояние.

413

)))

414

415

=== {{id name="ИнтеграцияSecurOS(ISS)-Событиявидеоаналитики"/}}События видеоаналитики ===

416

417

Плагин интеграции с SecurOS преобразовывает события видеоаналитики, получаемые от сервера SecurOS в стандартные события Платформы НЕЙРОСС: формирует ONVIF-события с метками Тревога, Видеоналитика. По этим событиям может быть настроены сценарии обработки инцидентов, события автоматики, в том числе отправка уведомлений по электронной почте и в мессенджеры, и любая другая функциональность.

418

419

[[image:attach:SecurOS_center_events.png||width="500"]]

Исходный код вики Интеграция SecurOS (ISS)