Сервис SferaMontitoring.BisSdkApi - это приложение для работы с API системы BIS. Так как API BIS SDK работает по технологии WCF, приложение SferaMontitoring.BisSdkApi может работать только на ОС Windows.


Установка SferaMontitoring.HtBisSdkApi

Рекомендуется устанавливать службу SferaMontitoring.BisSdkApi на той же машине, где находится BIS

  • для установки службы запустите с правами администратора установочный файл "SferaMontioring.BisSdkApi.{версия}.install.exe";

По умолчанию, интеграционное решение устанавливается в папку "C:\Integration\SferaMonitoring\SferaMonitoring.BisSdkApi".

  • нажмите на кнопку "Далее". Откроется окно для подтверждения установки;
  • нажмите на кнопку "Установить", после чего начнётся копирование файлов интеграционного решения;


  • для завершения установки нажмите кнопку "Завершить".


Настройка экземпляра службы 

Для работы службы SferaMonitoring.BisSdkApi необходимо настроить экземпляр службы. Для этого:

  • скопируйте файл "C:\Integration\SferaMonitoring\SferaMonitoring.BisSdkApi\Settings\_samples\BisSettingsSample.json" в папку "C:\Integration\SferaMonitoring\SferaMonitoring.BisSdkApi\Settings\Instances" ;

В папке "Instances" уже присутствует файл "BIS.json", если требуется только один экземпляр службы, то рекомендуется использовать его.

  • переименуйте скопированный файл BisSettingsSample.json в название инстанса;
  • перейдите в папку "C:\Integration\SferaMonitoring\SferaMonitoring.BisSdkApi\Setup";
  • откройте на редактирование файл "_install.bat" и измените в команде параметр "-instance:BIS" на -instance:{название инстанса};


Если используется только один экземпляр службы (по умолчанию "BIS"), то изменять "_install.bat" не требуется

  • запустите с правами администратора файл "_install.bat", после чего в системе появится новый экземпляр службы, с указанным инстансом;


Настройка SferaMonitoring.BisSdkApi

Для настройки, откройте на редактирование файл инстанса. Например, для инстанса "BIS" это будет "C:\Integration\SferaMonitoring\SferaMonitoring.BisSdkApi\Settings\Instances\BIS.json".

Описание настроек приведено в таблице 3.3.3.3.1.

Таблица 3.3.3.3.1 - Описание настроек инстанса 

ApiOptions

Настройки API

Значения по умолчанию, допустимые значения, примеры значений

Url

Точка доступа для подключения сервиса SferaMonitoring

"http://*:7001"

BisVersion

Версия сервера BIS. Поддерживаемые версии: 4.7, 4.9

Допустимые значения: "BIS47", "BIS49"

ClientServiceOptions

Настройки Client WCF-сервиса

ServiceAddress

Адрес WCF-сервиса

"net.tcp://BIS:27110/BisClientProxyInterfaces"

UserPrincipalName

UPN-имя учетной записи

"BIS\\MgtS-Service"

BisUsername

Имя оператора BIS

Пример: "HtMonitoring"

BisPassword

Пароль оператора BIS

Пример: "password"

LogonTimeoutSec

Допустимое время ожидания аутентификации, в секундах

10

AlarmServiceOptions

Настройки Alarm WCF-сервиса

ServiceAddress

Адрес WCF-сервиса.

Данный WFC-сервис не используется, значение можно оставить пустым

"net.tcp://BIS:27112/BisClientProxyInterfaces"

UserPrincipalName

UPN-имя учетной записи.

Данный WFC-сервис не используется, значение можно оставить пустым

"BIS\\MgtS-Service"

BindingOptions

Настройки TCP-соединения с BIS SDK (по умолчанию)

ImpersonatorOptions

Настройки имперсонации

UseImpersonation

Использовать ли имперсонацию при подключении к WCF-сервисам BIS

true, false

BisWindowsAccountName

Имя учетной записи Windows, для которой настроен доступ на сервере BIS

"MgtS-Service"

BisWindowsAccountPassword


Пароль

"password"

BisWindowsAccountDomain

Домен (если не указан, то в качестве домена используется имя компьютера, на котором запущено решение СФЕРА-Мониторинг)


MonitoringOptions

Настройки системы мониторинга

MonitoringAddress

Адрес для подключения к системе мониторинга

Формат адреса: "{IP адрес или доменное имя}: 55851"

Пример: "192.168.77.236:55851"

ProcessName

Имя процесса, которое будет отображаться в системе мониторинга. При использовании нескольких инстансов, в каждой настройке, в данное поле, необходимо ввести уникальное имя.

Пример: "BIS"



Имперсонация – ситуация, когда злоумышленник выдает себя за законного пользователя или службу, чтобы получить доступ к защищенной информации.


Запуск SferaMonitoring.BisSdkApi

  • откройте окно "Службы" (для этого нажмите Win+R и введите "services.msc")
  • для каждого экземпляра службы, найдите службу с названием SferaMonitoring.BisSdkApi${название инстанса}, кликните по ней правой кнопкой мыши и выберите команду "Запустить"

  • после запуска, проверьте лог "BisSdkService.log" для каждого инстанса (например "C:\Integration\SferaMonitoring\SferaMonitoring.BisSdkApi\Logs\BIS\BisSdkService.log"). В файле лога не должно быть ошибок. При успешном подключении к API BIS должна появится запись: "BIS SDK connection state changed: Connected".

для отслеживания работы сервиса можно использовать систему мониторинга iMon (см. раздел 5.1 Описание работы системы мониторинга iMon )




  • No labels