Сервис HtBisSdkApi SferaMontitoring.BisSdkApi - это приложение для работы с API системы BIS. Так как API BIS SDK работает по технологии WCF, приложение HtBisSdkApi SferaMontitoring.BisSdkApi может работать только на ОС Windows.
Установка SferaMontitoring.HtBisSdkApi
| Note |
|---|
Рекомендуется устанавливать службу HtBisSdkApi SferaMontitoring.BisSdkApi на той же машине, где находится BIS |
- для установки службы запустите с правами администратора установочный файл "HtBisSdkApiSferaMontioring.BisSdkApi.{версия}.install.exe";
По умолчанию, интеграционное решение устанавливается в папку "C:\Integration\SferaMonitoring\SferaMonitoring.ServiceBisSdkApi".
- нажмите на кнопку "Далее". Откроется окно для подтверждения установки;
- нажмите на кнопку "Установить", после чего начнётся копирование файлов интеграционного решения;
- для завершения установки нажмите кнопку "Завершить".
Настройка экземпляра службы
Для работы службы HtBisSdkApi SferaMonitoring.BisSdkApi необходимо настроить экземпляр службы. Для этого:
- скопируйте файл "C:\Integration\SferaMonitoring\HtBisSdkApiSferaMonitoring.BisSdkApi\Settings\_samples\BisSettingsSample.json" в папку "C:\Integration\SferaMonitoring\HtBisSdkApiSferaMonitoring.BisSdkApi\Settings\Instances" ;
| Note |
|---|
В папке "Instances" уже присутствует файл "BIS.json", если требуется только один экземпляр службы, то рекомендуется использовать его. |
- переименуйте скопированный файл BisSettingsSample.json в название инстанса;
- перейдите в папку "C:\Integration\SferaMonitoring\HtBisSdkApiSferaMonitoring.BisSdkApi\Setup";
- откройте на редактирование файл "_install.bat" и измените в команде параметр "-instance:BIS" на -instance:{название инстанса};
...
- запустите с правами администратора файл "_install.bat", после чего в системе появится новый экземпляр службы, с указанным инстансом;
Настройка SferaMonitoring.BisSdkApiНастройка HtBisSdkApi
Для настройки, откройте на редактирование файл инстанса. НапримерНапример, для инстанса "BIS" это будет "C:\Integration\SferaMonitoring\HtBisSdkApiSferaMonitoring.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" |
| Note |
|---|
Имперсонация – ситуация, когда злоумышленник выдает себя за законного пользователя или службу, чтобы получить доступ к защищенной информации. |
Запуск HtBisSdkApiSferaMonitoring.BisSdkApi
- откройте окно "Службы" (для этого нажмите Win+R и введите "services.msc")
- для каждого экземпляра службы, найдите службу с названием HtBisSdkApi$SferaMonitoring.BisSdkApi${название инстанса}, кликните по ней правой кнопкой мыши и выберите команду "Запустить"
- В файле лога не должно быть ошибок. При успешном подключении к API BIS должна появится запись: "BIS SDK connection state changed: Connected".
для отслеживания работы сервиса можно использовать систему мониторинга iMon (см. раздел раздел 5.1 Описание работы системы мониторинга iMon )
