Установка программы с REST API
Для управления программой через REST API нужно установить Kaspersky Endpoint Security c поддержкой REST API. Если вы управляете Kaspersky Endpoint Security через REST API, управлять программой с помощью Kaspersky Security Center невозможно.
Подготовка к установке программы с поддержкой REST API
Для безопасной работы Kaspersky Endpoint Security с REST-клиентом вам нужно настроить идентификацию запросов. Для этого вам нужно установить сертификат и в дальнейшем подписывать полезные данные каждого запроса.
Для создания сертификата вы можете использовать, например, OpenSSL.
Пример:
|
Используйте алгоритм шифрования RSA и размер ключа 2048 бит и более.
В результате вы получите сертификат cert.pem
и закрытый ключ key.pem
.
Установка программы с поддержкой REST API
Чтобы установить Kaspersky Endpoint Security c поддержкой REST API, выполните следующие действия:
- Запустите интерпретатор командной строки cmd от имени администратора.
- Перейдите в папку, в которой расположен дистрибутив Kaspersky Endpoint Security версии 11.2.0 или выше.
- Установите Kaspersky Endpoint Security со следующими параметрами:
RESTAPI=1
RESTAPI_User=<Имя пользователя>
Имя пользователя для управления программой через REST API. Введите имя пользователя в формате
<DOMAIN>\<UserName>
(например,RESTAPI_User=COMPANY\Administrator
). Вы можете управлять программой через REST API только под этой учетной записью. Для работы с REST API вы можете выбрать только одного пользователя.RESTAPI_Port=<Порт>
Порт для обмена данными. Необязательный параметр. По умолчанию выбран порт 6782.
RESTAPI_Certificate=<Путь к сертификату>
Сертификат для идентификации запросов (например,
RESTAPI_Certificate=C:\cert.pem
).Вы можете установить сертификат после установки программы или обновить сертификат после истечения срока действия.
Как установить сертификат для идентификации запросов REST API
AdminKitConnector=1
Управление программой с помощью систем администрирования. По умолчанию управление разрешено.
Также вы можете задать параметры работы с REST API с помощью файла setup.ini.
Пример:
setup_kes.exe /pEULA=1 /pPRIVACYPOLICY=1 /pKSN=1 /pALLOWREBOOT=1 /pAdminKitConnector=1 /pRESTAPI=1 /pRESTAPI_User=COMPANY\Administrator /pRESTAPI_Certificate=C:\cert.pem /s
В результате вы сможете управлять программой через REST API. Для проверки работы откройте документацию REST API с помощью GET-запроса.
Пример:
|
Если вы установили программу с поддержкой REST API, Kaspersky Endpoint Security автоматически создает в параметрах Веб-Контроля разрешающее правило доступа к веб-ресурсам Служебное правило для REST API. Это правило нужно для обеспечения постоянного доступа REST-клиента к Kaspersky Endpoint Security. Например, если вы ограничили доступ пользователя к веб-ресурсам, это не повлияет на управление программой через REST API. Мы рекомендуем не удалять правило и не изменять параметры правила Служебное правило для REST API. Если вы удалили правило, Kaspersky Endpoint Security восстановит правило после перезапуска программы.