ESET PROTECT On-Prem

Не в сети | Переход в сетевой режим

ESET PROTECT On-Prem – Содержание

# Настройка 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?

Swagger UI — это платформа с открытым исходным кодом, которая помогает разработчикам проектировать, создавать, документировать и использовать веб-службы RESTful. С помощью Swagger UI можно протестировать вызовы API через веб-страницу: 1.Включите Swagger UI в настройках сервера ESET PROTECT. 2.Включенное встроенное средство Swagger UI доступно по адресу https://localhost:9443/swagger. При необходимости замените localhost именем сервера или IP-адресом. Swagger UI предоставляет готовые вызовы API. В вызовах нужно только изменить значения параметров.
|  | Средство 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.

˄˅