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