Внимание! Опубликована информация об уязвимости в некоторых версиях Агента администрирования для Windows и Сервера администрирования для Windows. Обновите затронутые версии компонентов до новой версии по инструкции.

Скопировано

02 ноября 2026

ID 181969

Параметры установки Web Console

Развернуть всё | Свернуть всё

Для установки Сервера Web Console на устройства с операционными системами Linux необходимо создать файл ответов (файл .json), который содержит параметры подключения Web Console к Серверу администрирования. Вам нужно назвать этот файл ksc-web-console-setup.json и расположить его в директории /etc/ksc-web-console-setup.json.

Набор параметров файла ответов зависит от версии Сервера администрирования, к которому подключено приложение Web Console.

Сервер администрирования версии 16 и выше
Сервер администрирования версии 16 и выше включает в себя компонент Identity and Access Manager (IAM), который обеспечивает доменную аутентификацию с единым входом (SSO) в Web Console. Для подключения Web Console к Серверу администрирования файл ответов должен содержать параметры взаимодействия с IAM-компонентом, даже если вы не используете единый вход (SSO).

Пример файла ответов для установки приложения Web Console, которое будет подключаться к Серверу администрирования версии 16 и выше. В этом примере Web Console и Сервер администрирования установлены на разных устройствах:

{

"address": "ksc-web-console.example.com",

"port": 8080,

"defaultLangId": 1049,

"enableLog": true,

"trusted": {

"Administration Server v16": {

"iamHost": "ksc16.example.com",

"iamOAuthPort": 4444,

"iamProxyPort": 9050,

"iamCertPath": "/var/opt/kaspersky/klnagent_srv/iam/main_certificate.pem",

"iamPATPath": "/var/opt/kaspersky/klnagent_srv/iam/initial_token.txt",

"kscPort": 13299,

"kscCertPath": "/var/opt/kaspersky/klnagent_srv/1093/cert/klserver.cer"

}

},

"acceptEula": true,

"certPath": "/root/server.crt",

"keyPath": "/root/key-without-passphrase.pem",

"webConsoleAccount": "Group1:User1",

"managementServiceAccount": "Group1:User2",

"serviceWebConsoleAccount": "Group1:User3",

"pluginAccount": "Group1:User4",

"natsMessageQueueAccount": "Group1:User6"

}
Сервер администрирования версии 15.4 и выше
Сервер администрирования версии 15.4 и ниже поддерживает только аутентификацию с использованием имени и пароля внутреннего пользователя или доменного пользователя.

Пример файла ответов для установки приложения Web Console, которое будет подключаться к Серверу администрирования версии 15.4 и ниже:

{

"address": "ksc-web-console.example.com",

"port": 8080,

"defaultLangId": 1049,

"enableLog": true,

"trusted": {

"Administration Server v15.4": {

"kscHost": "ksc.example.com",

"kscPort": 13299,

"kscCertPath": "/var/opt/kaspersky/klnagent_srv/1093/cert/klserver.cer"

}

},

"acceptEula": true,

"certPath": "/root/server.crt",

"keyPath": "/root/key-without-passphrase.pem",

"webConsoleAccount": "Group1:User1",

"managementServiceAccount": "Group1:User2",

"serviceWebConsoleAccount": "Group1:User3",

"pluginAccount": "Group1:User4",

"natsMessageQueueAccount": "Group1:User6"

}

Параметры webConsoleAccount, managementServiceAccount, serviceWebConsoleAccount, pluginAccount, natsMessageQueueAccount, certPath и keyPath необязательные. Вы можете не указывать эти параметры в файле ответов.

Если вы хотите использовать пользовательский сертификат, укажите параметры certPath и keyPath. Если вы не укажете параметры или укажете только один, веб-браузер будет сообщать вам, что ваше подключение не защищено.

Из соображений безопасности не рекомендуется указывать параметры webConsoleAccount, managementServiceAccount, serviceWebConsoleAccount, pluginAccount и natsMessageQueueAccount.
Если вы решили указать эти параметры, убедитесь, что настраиваемые учетные записи пользователей принадлежат к одной и той же группе безопасности. Если эти параметры не указаны, установщик Web Console создает группу безопасности по умолчанию, а затем создает в этой группе учетные записи пользователей с именами по умолчанию.
Параметры webConsoleAccount, managementServiceAccount, serviceWebConsoleAccount, pluginAccount и natsMessageQueueAccount невозможно использовать отдельно друг от друга: укажите значения либо для всех этих параметров, либо ни для одного.

Вы можете установить Web Console на том же устройстве, что и Сервер администрирования, или на другом устройстве. Если приложение Web Console установлено на другом устройстве, адрес Web Console (параметр address) и адрес Сервера администрирования (параметр iamHost или kscHost) отличаются. Если приложение Web Console установлено на одном устройстве с Сервером администрирования, эти параметры имеют одинаковые значения.

Значение iamHost должно совпадать с адресом IAM, указанным при установке Сервера администрирования. Для получения указанного адреса IAM выполните следующую команду на устройстве с установленным Сервером администрирования:

grep "iam_address:" /var/opt/kaspersky/klnagent_srv/iam/iam_config.yaml

Рекомендуется указывать номера портов больше 1024. Если вы хотите, чтобы приложение Web Console работало на портах ниже 1024, после установки вам нужно выполнить следующую команду:

sudo setcap 'cap_net_bind_service=+ep' /var/opt/kaspersky/ksc-web-console/node

Если у вас нет утилиты setcap, вы можете ее установить.

Команды для установки setcap

При установке Web Console на устройство с операционной системой Альт Linux необходимо указать номер порта, отличный от 8080, так как порт 8080 используется операционной системой.

В таблице ниже описаны параметры, которые можно указать в файле ответов.

Параметры установки Web Console на устройствах с операционными системами Linux

Параметр

Описание

Доступные значения

address

Адрес устройства (FQDN или имя устройства), на котором установлено приложение Web Console (обязательный параметр).

Если вы устанавливаете Web Console на Сервер Kaspersky Security Center, используйте адрес, который вы указали при установке Kaspersky Security Center Linux.

Если вы устанавливаете Web Console на другое устройство, укажите адрес устройства (FQDN или имя устройства), который будет использоваться браузером для подключения к Серверу Web Console.

Строковое значение.

Например: "ksc.example.com"

port

Порт, используемый Web Console для приема подключений от веб-браузеров (обязательный).

Числовое значение.

Рекомендуемое значение – 8080 (за исключением операционной системы Альт Linux).

defaultLangId

Язык пользовательского интерфейса (по умолчанию 1033).

При необходимости вы можете сменить язык интерфейса Web Console.

Числовой код языка:

Немецкий: 1031
Английский: 1033
Испанский: 1034
Испанский (Мексика): 2058
Французский: 1036
Итальянский: 1040
Японский: 1041
Казахский: 1087
Польский: 1045
Португальский (Бразилия): 1046
Русский: 1049
Турецкий: 1055
Упрощенный китайский: 2052
Традиционный китайский: 1028

Если значение не указано, используется английский язык (en-US).

enableLog

Включение или выключение журнала трассировки Web Console.

Рекомендуется изменять значение параметра по умолчанию только по запросу специалиста Службы технической поддержки "Лаборатории Касперского".

Логическое значение:

true – ведение журнала включено.
false – ведение журнала выключено (выбрано по умолчанию).

trusted

Список адресов доверенных Серверов администрирования, к которым может подключаться Web Console. Вы можете добавить несколько Серверов администрирования разных версий в список доверенных серверов.

Для Сервера администрирования версии 16 и выше:

имя Сервера администрирования, которое будет отображаться в окне входа.
iamHost – адрес (FQDN или имя устройства) Сервера администрирования, который включает IAM-компонент (начиная с Kaspersky Security Center Linux версии 16) и к которому подключается Web Console.
Значение iamHost должно совпадать с адресом IAM, указанным при установке Сервера администрирования. Для получения указанного адреса IAM выполните следующую команду на устройстве с установленным Сервером администрирования:

grep "iam_address:" /var/opt/kaspersky/klnagent_srv/iam/iam_config.yaml
iamOAuthPort – порт, который используется для обмена токенами аутентификации по протоколу аутентификации OpenID Connect (значение по умолчанию – 4444). Этот порт используется как для связи между Сервером Web Console и Сервером администрирования, так и между браузером (используется с Web Console) и Сервером администрирования.
iamProxyPort – порт, который используется для подключения Сервера Web Console к Серверу администрирования (значение по умолчанию – 9050).
iamCertPath – это путь к IAM-сертификату. IAM-сертификат создается автоматически при первом запуске Сервера администрирования. Сертификат хранится на устройстве, на котором установлен Сервер администрирования. Путь по умолчанию к сертификату: /var/opt/kaspersky/klnagent_srv/iam/main_certificate.pem. Самоподписанный IAM-сертификат обновляется автоматически.
iamPATPath – путь к токену, который используется для регистрации Web Console в качестве OAuth-клиента в IAM. Этот файл создается автоматически при первом запуске Сервера администрирования. Токен хранится на устройстве, на котором установлен Сервер администрирования. Путь по умолчанию к токену: /var/opt/kaspersky/klnagent_srv/iam/initial_token.txt. Токен действует бессрочно и не требует ротации.
kscPort – порт, который используется для подключения Web Console к Серверу администрирования по OpenAPI (значение по умолчанию – 13299).
kscCertPath – путь к сертификату Сервера администрирования. Сертификат хранится на устройстве, на котором установлен Сервер администрирования. Путь по умолчанию к сертификату: /var/opt/kaspersky/klnagent_srv/1093/cert/klserver.cer.

Для Сервера администрирования версии 15.4 и ниже:

имя Сервера администрирования, которое будет отображаться в окне входа.
kscHost – адрес (FQDN или имя устройства) Сервера администрирования, к которому подключается Web Console.
kscPort – порт OpenAPI, который используется для подключения Сервера Web Console к Серверу администрирования (значение по умолчанию – 13299).
kscCertPath – путь к сертификату Сервера администрирования. Сертификат хранится на устройстве, на котором установлен Сервер администрирования. Путь по умолчанию к сертификату: /var/opt/kaspersky/klnagent_srv/1093/cert/klserver.cer.

При установке Web Console на устройство, отличное от устройства Сервера администрирования, скопируйте файл сертификата Сервера администрирования (по пути, указанному в параметре kscCertPath), файл IAM-сертификата (по пути, указанному в параметре iamCertPath) и файл токена (по пути, указанному в параметре iamPATPath) с устройства, на котором установлен Сервер администрирования, на целевое устройство. Укажите локальный путь к этим файлам в файле ответов для установщика Web Console.

Секция файла JSON в следующем формате:

"trusted": {

"Administration Server v16": {

"iamHost": "ksc-iam.example.com",

"iamOAuthPort": 4444,

"iamProxyPort": 9050,

"iamCertPath": "/var/opt/kaspersky/klnagent_srv/iam/main_certificate.pem",

"iamPATPath": "/var/opt/kaspersky/klnagent_srv/iam/initial_token.txt",

"kscPort": 13299,

"kscCertPath": "/var/opt/kaspersky/klnagent_srv/1093/cert/klserver.cer"

"Administration Server v15.4": {

"kscHost": "ksc.example.com",

"kscPort": 13299,

"kscCertPath": "/var/opt/kaspersky/klnagent_srv/1093/cert/klserver.cer"

}

Вы можете указать любые имена Сервера администрирования вместо Administration Server v16 и Administration Server v15.4.

acceptEula

Принимаете ли вы условия Лицензионного соглашения. Файл, содержащий условия Лицензионного соглашения, загружается вместе с установочным файлом.

Логическое значение:

true – Я подтверждаю, что полностью прочитал(а), понимаю и принимаю условия и положения настоящего Лицензионного соглашения.
false – Я не принимаю условия Лицензионного соглашения (выбрано по умолчанию).

Если значение не указано, приложение установки Web Console отобразит Лицензионное соглашение и спросит, согласны ли вы принять условия Лицензионного соглашения.

certDomain

Если вы хотите сгенерировать новый самоподписанный сертификат, используйте этот параметр, чтобы указать FQDN для подключения браузера к Web Console.

Строковое значение.

certPath

Используйте этот параметр, чтобы указать путь к пользовательскому сертификату Web Console, который является доверенным в вашей инфраструктуре и соответствует требованиям к пользовательским сертификатам.

Вы можете указать только один закрытый ключ (keyPath) для одного сертификата или для цепочки сертификатов.

Строковое значение.

Зашифрованные сертификаты не поддерживаются Web Console.

На устройстве, на котором установлено приложение Web Console, укажите путь к файлу сертификата в формате кодирования PEM.

Например: /root/server.crt

keyPath

Используйте этот параметр, чтобы задать путь к закрытому ключу, связанному с пользовательским сертификатом Web Console, указанным в параметре certPath.

Строковое значение.

Файл с закрытым ключом не должен быть зашифрован.

На устройстве, на котором установлено приложение Web Console, укажите путь к файлу ключа в формате кодирования PEM.

Например: /root/key-without-passphrase.pem

webConsoleAccount

Имя учетной записи, под которой запущена служба Kaspersky Security Center Web Console.