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

Редактировал(а) admin 2026/09/01 15:38

version	line-number	content
1.1	1	Платформа НЕЙРОСС в версии 20.36 обеспечивает работу с видеорегистраторами (видеосерверами) SecurOS (Секурос) производства компании IIS (Интеллектуальные системы безопасности). Функциональность доступна в редакциях SecurOS Monitoring & Control Center, SecurOS Enterprise, SecurOS Premium.
	2
7.4	3	== {{id name="ИнтеграцияSecurOS(ISS)-Общиесведения"/}}Общие сведения ==
1.1	4
	5	Платформа НЕЙРОСС обеспечивает взаимодействие с видеорегистраторами SecurOS по протоколам ONVIF и REST-API.
	6
	7	\\
	8
	9	ONVIF
	10
	11	Просмотр «живого» видео и видеоархива осуществляется по протоколу ONVIF без необходимости установки плагина и дополнительных лицензий, требуются только лицензии на медиаисточники. При этом поддерживаются стандартные процедуры работы, в том числе переключение препозиций, экспорт видеоархива во «внешний» файл или импорт видеоархива на видеорегистратор НЕЙРОСС. Особенности работы по ONVIF приведены в таблице ниже.
	12
	13	\|=(((
	14	Функция
	15	)))\|=(((
	16	Комментарий
	17	)))
	18	\|(((
	19	Просмотр «живого» видео
	20	)))\|(((
	21	Без ограничений
	22	)))
	23	\|(((
	24	Просмотр видеоархива
	25	)))\|(((
7.4	26	Проигрывание видеоархива возможно только на скорости 1x и выше: 2x, 4x, 8x, 16x, 32x, 64x. Не поддерживаются дробные: 0,5x и отрицательные: -4x, -2x, -1x (проигрывание в обратном направлении) скорости.
1.1	27	)))
	28	\|(((
	29	Экспорт и импорт видеоархива
	30	)))\|(((
	31	SecurOS не поддерживает режим ASAP, поэтому экспорт архива c SecurOS осуществляется более медленно, чем экспорт архива, записанного непосредственно видеорегистратором НЕЙРОСС. Возможен импорт медиаданных на видеорегистратор НЕЙРОСС.
	32	)))
	33	\|(((
	34	PTZ-управление
	35	)))\|(((
	36	(((
4.1	37	Платформа НЕЙРОСС обеспечивает движение PTZ по абсолютным координатам, вычитывание препозиций, настроенных в конфигурации SecurOS, и выполнение команд перехода к препозиции.
1.1	38
	39	{{error}}
	40	Создание и удаление препозиций средствами Платформы НЕЙРОСС не поддерживается со стороны SecurOS.
	41	{{/error}}
	42	)))
	43	)))
	44
	45	\\
	46
	47	REST API
	48
7.4	49	Отслеживание состояний камер, получение событий видеоаналитики и передача команд управления на видеорегистратор SecurOS осуществляется по REST API посредством «Плагина интеграции с SecurOS», устанавливаемого непосредственно на Платформу НЕЙРОСС, требуется лицензия на использование плагина. Функции плагина приведены в таблице ниже.
1.1	50
	51	\|=(((
	52	Функция
	53	)))\|=(((
	54	Комментарий
	55	)))
	56	\|(((
	57	Мониторинг состояния медиаисточников
	58	)))\|(((
	59	(((
7.4	60	Обеспечивается контроль наличия связи, статус записи и статус охраны:
1.1	61
	62	* есть запись / нет записи
	63	* есть тревога / нет тревоги
	64	* на охране / снят с охраны
	65	* есть связь / нет связи
	66	)))
	67	)))
	68	\|(((
	69	Мониторинг состояния узла SecurOS
	70	)))\|(((
4.1	71	Обеспечивается подключение к Health Monitor API и вычитывание текущих проблем. Открытая проблема приводит к появлению соответствующего события и перехода элемента сервера в состояние [Тревога]. Если закрыты все проблемы, элемент переходит в состояние [Норма]. Также обеспечивается контроль состояния связи с сервером.
1.1	72	)))
	73	\|(((
	74	Отправка команд управления
	75	)))\|(((
	76	(((
	77	Поддержана отправка следующих команд:
	78
	79	* Начало записи
	80	* (((
	81	Остановка записи
	82
	83	{{error}}
4.1	84	Для управления записью камеры необходимо в настройках SecurOS задать режим записи По команде. Станет доступным начало записи и остановка записей, начатых по команде Платформы НЕЙРОСС. Остановка записей, начатых на самом видеосервере SecurOS, не поддерживается со стороны SecurOS.
1.1	85	{{/error}}
	86	)))
	87	* Постановка на охрану
	88	* Снятие с охраны
	89
	90	{{info}}
4.1	91	Для успешного выполнения команд необходимо, чтобы у пользователя SecurOS, под которым добавляется узел и авторизуется плагин, были права на управление.
1.1	92	{{/info}}
	93	)))
	94	)))
	95	\|(((
	96	Получение событий видеоаналитики
	97	)))\|(((
	98	Обеспечивается работа с событиями аналитики как от встроенного детектора движения, так и от модуля аналитики Tracking Kit 3. Плагин преобразовывает получаемые от SecurOS события на язык Платформы НЕЙРОСС. Далее события обрабатываются стандартным образом: отображаются в ленте событий АРМ НЕЙРОСС Центр, по ним могут быть настроены задачи на запись, сценарии обработки и любая другая функциональность.
	99	)))
	100
7.4	101	== {{id name="ИнтеграцияSecurOS(ISS)-Лицензионнаяполитика"/}}Лицензионная политика ==
1.1	102
7.48	103	Функция управления камерами видеосервера SecurOS лицензируется. Проверьте наличие требуемых лицензий ~[[[Просмотр параметров и обновление лицензии>>doc:ui.node.basic.license-update.WebHome]]]. В противном случае требуется приобрести лицензии ~[[[Лицензирование Платформы НЕЙРОСС>>doc:neyross.licensing.WebHome]]].
1.1	104
	105	\|=(((
	106	Тип узла
	107	)))\|=(((
	108	Лицензия
	109	)))\|=(((
	110	Комментарий
	111	)))
	112	\|(% rowspan="2" %)(((
	113	Платформа НЕЙРОСС
	114	)))\|(((
	115	Количество медиаканалов
	116	)))\|(((
4.1	117	Лицензия должна включать требуемое количество медиаканалов.
1.1	118	)))
	119	\|(((
	120	Плагин интеграции с SecurOS
	121	)))\|(((
4.1	122	Возможность передачи команд управления камерам видеосервера SecurOS
1.1	123	)))
	124
	125	\\
	126
7.4	127	== {{id name="ИнтеграцияSecurOS(ISS)-НастройкаSecurOS"/}}Настройка SecurOS ==
1.1	128
7.4	129	=== {{id name="ИнтеграцияSecurOS(ISS)-БазоваянастройкаSecurOS"/}}Базовая настройка SecurOS ===
1.1	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	На вкладке Общие задайте настройки согласно таблице ниже. Сохраните изменения.
	140
5.1	141	\|=(((
1.1	142	Параметр
5.1	143	)))\|=(((
1.1	144	Комментарий
	145	)))
5.1	146	\|(((
1.1	147	RTSP-сервер
5.1	148	)))\|(((
1.1	149	Выберите из раскрывающегося списка значение Встроенный.
	150	)))
5.1	151	\|(((
1.1	152	Протокол
5.1	153	)))\|(((
1.1	154	Выберите из раскрывающегося списка значение HTTP.
	155	)))
5.1	156	\|(((
1.1	157	Порт
5.1	158	)))\|(((
1.1	159	Укажите номер незанятого порта. По этому порту происходит взаимодействие видеосервера с Платформой НЕЙРОСС. Диапазон возможных значений: [1; 65535].
	160	)))
5.1	161	\|(((
1.1	162	Сетевой интерфейс
5.1	163	)))\|(((
1.1	164	Список поля содержит все доступные сетевые интерфейсы, которые могут использоваться для подключения к 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	Задайте настройки согласно таблице ниже. Сохраните изменения.
	177
5.1	178	\|=(((
1.1	179	Параметр
5.1	180	)))\|=(((
1.1	181	Комментарий
	182	)))
5.1	183	\|(((
1.1	184	Порт
5.1	185	)))\|(((
1.1	186	(((
	187	Номер порта SecurOS для взаимодействия с Платформой НЕЙРОСС по протоколу HTTP/HTTPS. Диапазон возможных значений: [1; 65535]. Значение по умолчанию: 8888.
	188
	189	{{info}}
7.2	190	Порт 8888 используется Платформой НЕЙРОСС по умолчанию. В случае необходимости смены порта, откорректируйте значение параметра ##ultima.neyross.securos.apiPort##в файле конфигурации ##application.conf##(%%)на узле Платформа НЕЙРОСС.
1.1	191	{{/info}}
	192	)))
	193	)))
5.1	194	\|(((
1.1	195	Порт для
	196	WebSocket
5.1	197	)))\|(((
1.1	198	(((
	199	Номер порта SecurOS для взаимодействия с Платформой НЕЙРОСС по протоколу WebSocket. Значение по умолчанию: 8080.
	200
	201	{{info}}
	202	Для взаимодействия по Websoket с Платформой НЕЙРОСС может использоваться ТОЛЬКО порт 8080.
	203	{{/info}}
	204	)))
	205	)))
	206
	207	[[image:attach:SecurOS_video_RESTAPIprp.png\|\|width="660"]]
	208
	209	=== {{id name="ИнтеграцияSecurOS(ISS)-Режимзаписикамер"/}}Режим записи камер ===
	210
4.1	211	Для камер, записью которых нужно управлять по команде с Платформы НЕЙРОСС, в поле Режим записи необходимо выбрать из раскрывающегося списка режим По команде.
1.1	212
	213	{{error}}
	214	Станет доступным начало записи и остановка записей, начатых по команде Платформы НЕЙРОСС. Остановка записей, начатых на самом видеосервере SecurOS, не поддерживается со стороны SecurOS.
	215	{{/error}}
	216
	217	(% class="auto-cursor-target" style="letter-spacing: 0.0px;" %)[[image:attach:SecurOS_cam_commands.png\|\|width="900"]]
	218
	219	\\
	220
	221	=== {{id name="ИнтеграцияSecurOS(ISS)-ПользовательдлявзаимодействиясПлатформойНЕЙРОСС"/}}Пользователь для взаимодействия с Платформой НЕЙРОСС ===
	222
	223	Добавьте учетную запись пользователя, под именем которого будут выполняться команды камерам SecurOS из Платформы НЕЙРОСС. Эти данные будут указываться на сервере Платформы НЕЙРОСС при подключении видеосервера.
	224
	225	[[image:attach:SecurOS_userprp.png\|\|width="730"]]
	226
	227	//Пример настройки пользователя secuser//
	228
	229	\\
	230
	231	Для созданной учётной записи задайте права.
	232
	233	{{info}}
4.1	234	Для пользователя ONVIF учитываются только права на управление камерами. Просмотр «живого» видео и видеоархива осуществляется независимо от заданных прав. Плагин работает с HTTP API SecurOS, используя для авторизации тот же логин и пароль, которые указываются в приложении Сеть при добавлении узла SecurOS. Однако с точки зрения SecurOS это разные сущности (пользователь API и пользователь Onvif); для корректной работы плагина в SecurOS должен быть заведён пользователь с тем же логином и паролем, что и пользователь Onvif, и иметь права управления.
1.1	235	{{/info}}
	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
7.59	247	Добавьте видеосервер SecurOS на Платформу НЕЙРОСС как ONVIF-медиаисточник согласно инструкции ~[[[Добавление ONVIF IP-камер, кодеров>>doc:ui.ui-network.ui-net-add-onvif.WebHome]]]. Используйте ручной режим. Задайте параметры подключения согласно таблице ниже. Нажмите на кнопку Добавить.
1.1	248
5.1	249	\|=(((
1.1	250	Поле
5.1	251	)))\|=(((
1.1	252	Комментарий
	253	)))
5.1	254	\|(((
1.1	255	Адрес узла
5.1	256	)))\|(((
1.1	257	(((
	258	Введите адрес в формате:
	259
2.1	260	{{code language="java"}}
1.1	261	[ip-адрес сервера SecurOS]:[порт]
	262	{{/code}}
	263
	264	Введите порт, указанный в поле Порт на этапе ~[[[#Настройка ONVIF-сервера>>doc:\|\|anchor="ИнтеграцияSecurOS(ISS)-НастройкаONVIF-сервера"]]].
	265
	266	Например:
	267
2.1	268	{{code language="java"}}
1.1	269	10.1.31.195:8090
	270	{{/code}}
	271	)))
	272	)))
5.1	273	\|(((
1.1	274	Аутентификация
5.1	275	)))\|(((
1.1	276	Выберите из раскрывающего списка Требуется. И введите данные учетной записи, созданной на этапе ~[[[#Пользователь для взаимодействия с Платформой НЕЙРОСС>>doc:\|\|anchor="ИнтеграцияSecurOS(ISS)-ПользовательдлявзаимодействиясПлатформойНЕЙРОСС"]]].
	277	)))
	278
	279	[[image:attach:SecurOS_add_node.png]]
	280
	281	\\
	282
7.57	283	Дождитесь изменения статуса подключения на норма. Перечень статусов узлов приведен в разделе ~[[[Сеть>>doc:ui.ui-network.WebHome]]].
1.1	284
	285	{{error}}
	286	Если статус отличен от норма, вы ошиблись при вводе адреса или учетных данных пользователя, либо отсутствует сетевое соединение. Текущий статус позволит выявить причину ошибки. При неверных данных удалите узел и повторите добавление с корректными данными.
	287	{{/error}}
	288
	289	\\
	290
	291	=== {{id name="ИнтеграцияSecurOS(ISS)-Настройкамедиаисточников"/}}Настройка медиаисточников ===
	292
	293	После успешного добавления узла производится автоматическое вычитывание медиаисточников и их профилей.
	294
	295	{{info}}
4.1	296	При первом добавлении видеосервера, актуальный статус камер будет вычитан в течение минуты.
1.1	297	{{/info}}
	298
	299	\\
	300
	301	Вы можете изменить названия медиаисточников, заданные автоматически, и настроить другие параметры.
	302
7.57	303	~[[[ONVIF-медиаисточники>>doc:ui.node.ui-media-sources.ui-onvif-sources.WebHome]]]
1.1	304
7.4	305	=== {{id name="ИнтеграцияSecurOS(ISS)-Установкаплагина"/}}Установка плагина ===
1.1	306
7.49	307	Модуль интеграции с видеосерверами SecurOS поставляется в виде [[плагина>>doc:ui.node.plugins.WebHome]] — независимого программного модуля, предназначенного для расширения функционала. Установка плагина является стандартной процедурой и не зависит от предоставляемых функций. Перечень разработанных плагинов и порядок их установки приведён в разделе ~[[[Плагины>>doc:ui.node.plugins.WebHome]]].
1.1	308
	309	{{info}}
	310	Право использования функции указывается в параметрах лицензии. Дополнительная активация не требуется.
	311	{{/info}}
	312
	313	\\
	314
	315	== {{id name="ИнтеграцияSecurOS(ISS)-ФункцииПлатформыНЕЙРОСС"/}}Функции Платформы НЕЙРОСС ==
	316
	317	=== {{id name="ИнтеграцияSecurOS(ISS)-Просмотр«живого»видеоивидеорхива"/}}Просмотр «живого» видео и видеорхива ===
	318
7.10	319	АРМ НЕЙРОСС видео обеспечивает просмотр «живого» видео ~[[[«Живое» видео>>doc:neyross.arm-video.live-video.WebHome]]] и видеорхива ~[[[Видеоархив>>doc:neyross.arm-video.video-archive.WebHome]]]. Видеоархив является внешним, поэтому отображается в виде голубой штриховки, полосатым.
1.1	320
	321	=== {{id name="ИнтеграцияSecurOS(ISS)-Управлениекамерами"/}}Управление камерами ===
	322
	323	После установки плагина станут доступны команды управления камерами видеосервера SecurOS.
	324
7.7	325	PTZ-управление, в том числе переключение препозиций, возможно в режиме просмотра «живого» видео АРМ НЕЙРОСС Видео ~[[[«Живое» видео>>doc:neyross.arm-video.live-video.WebHome]]].
1.1	326
	327	Доступ к командам управления возможен:
	328
7.57	329	1. Из интерфейса конфигурирования ~[[[Команды управления>>doc:ui.node.ui-elements.ui-element-commands.WebHome]]];
1.1	330	1. (((
7.10	331	Средствами пользовательского приложения [[АРМ НЕЙРОСС Центр>>doc:neyross.arm-center.WebHome]]
1.1	332
	333	{{info}}
7.23	334	Предварительно необходимо нанести элементы Камера на план объекта ~[[[Настройка функций мониторинга и реагирования>>doc:neyross.setup.monitoring-setup.WebHome]]].
1.1	335	{{/info}}
	336	)))
	337
	338	{{info}}
7.20	339	Вы можете дополнительно разграничить права операторов на команды управления на стороне Платформы НЕЙРОСС через «белый» и «черный» списки ~[[[Права на мониторинг и управление (АРМ Центр)>>doc:neyross.setup.users.center-rights.WebHome]]].
1.1	340	{{/info}}
	341
	342	[[image:attach:SecurOS_camera_commands.png]]
	343
	344	{{info}}
4.1	345	Для успешного выполнения команд необходимо, чтобы у пользователя SecurOS, под которым добавляется узел и авторизуется плагин, были права на управление. Вне зависимости от наличия прав, команды выдаются в списке доступных. Однако но если права не подразумевают выполнение команды, формируется ошибка:
1.1	346
7.2	347	{{code language="text"}}
1.1	348	Ошибка выполнения команды: не удалось выполнить команду Начать запись над SecurOS камерой [имя камеры]. Причина: у пользователя нет прав на выполнение команды.
	349	{{/code}}
	350	{{/info}}
	351
	352	=== {{id name="ИнтеграцияSecurOS(ISS)-ИконкимедиаисточниковвАРМЦентр"/}}Иконки медиаисточников в АРМ Центр ===
	353
7.61	354	Вид иконки элемента Медиаисточник зависит от текущего состояния элемента, который выражен набором меток. Существует предустановленный набор иконок для стандартных комбинаций меток ~[[[Состояния элементов НЕЙРОСС: метки, иконки>>doc:ui.ui-element-states.WebHome]]] (норма, тревога, неисправность, потеря связи). При помощи редактора иконок вы можете изменить иконки для стандартных комбинаций, а также настроить «свои» иконки для собственных комбинаций меток.
1.1	355
7.57	356	~[[[Редактор иконок>>doc:ui.node.ui-elements.ui-elements-icon-editor.WebHome]]]
1.1	357
	358	Ниже приведены примеры иконок.
	359
	360	\|=(((
	361	Иконка
	362	)))\|=(((
	363	Метки
	364	)))\|=(((
	365	Комментарий
	366	)))
	367	\|(((
	368	(((
	369	[[image:attach:icons_camera_armed.png\|\|thumbnail="true" height="32"]]
	370	)))
	371	)))\|(((
	372	МедиаИсточник, Норма, НаОхране
	373	)))\|(((
	374	Медиаисточник на охране, запись не ведется.
	375	)))
	376	\|(((
	377	(((
	378	[[image:attach:icons_camera_normal.png\|\|thumbnail="true" height="33"]]
	379	)))
	380	)))\|(((
	381	Медиаисточник, Норма, БезОхраны
	382	)))\|(((
	383	Медиаисточник не на охране, запись не ведется. Иконка включена в базовый набор.
	384	)))
	385	\|(((
	386	(((
	387	[[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"]]
	394	)))
	395	)))
	396	\|(((
	397	(((
	398	[[image:attach:icons_camera_rec_armed.png\|\|thumbnail="true" height="32"]]
	399	)))
	400	)))\|(((
	401	МедиаИсточник, ЗаписьИдёт, НаОхране, МедиаИсточник
	402	)))\|(((
	403	Медиаисточник на охране, запись ведется.
	404	)))
	405	\|(((
	406	(((
	407	[[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"]]