Настройка REST API ESET PROTECT On-Prem

Скопировать URL-адрес текущей статьи Поделиться по электронной почте

Ниже приведены инструкции о том, как настроить REST API ESET PROTECT On-Prem.

1.Включите REST API в разделе Дополнительно > Настройки.

•Обязательно откройте порты, используемые API, в локальном файерволе.

•Чтобы использовать REST API, сертификат узла для сервера ESET PROTECT (независимо от того, используется ли он как сертификат сервера REST или нет) должен содержать строку localhost в поле Обычное имя/Хост. Если сертификат узла (сервера) не соответствует этому требованию, создайте новый сертификат и измените сертификат сервера.

2.Назначьте пользователям API набор разрешений для API.

Учетная запись администратора не может использовать API.

3.Чтобы автоматизировать взаимодействие с API ESET PROTECT On-Prem, можно использовать встроенное средство Swagger UI (доступное в ESET PROTECT On-Prem с версии 13.1).

Что такое Swagger UI?

Кроме того, можно реализовать вызовы API к клиентскому приложению REST (например, Postman) или использовать командную строку (curl).

Сервер REST работает локально на сервере ESET PROTECT. Вы не можете использовать ESET Connect с REST API ESET PROTECT On-Prem.

4.Выполните запрос GetTokens для авторизации на сервере REST: В Swagger UI разверните GetTokens > щелкните Попробовать > введите правильные данные в тексте запроса и щелкните Выполнить.

Способ	POST
Функция	getTokens
URL-адрес	https://protect_server:9443/GetTokens
Тело	{ "username" : "api", "password" : "Admin.12345678", "grant_type" : "password" }

5.Ответ возвращает accessToken. Впоследствии вы можете использовать accessToken в других запросах API как токен носителя (Authorization: Bearer). В Swagger UI щелкните Авторизовать > вставьте accessToken > щелкните Авторизовать. Вы можете выполнять другие вызовы, и Swagger UI автоматически добавляет токен авторизации в каждый вызов.

См. также примеры вызовов API и список всех вызовов API, доступных в ESET PROTECT On-Prem.

˄˅