ESET PROTECT On-Prem – Зміст

Налаштування ESET PROTECT On-Prem REST API

Щоб налаштувати ESET PROTECT On-Prem REST API, виконайте наведені нижче дії.

1.Активуйте REST API у розділі Докладніше > Налаштування.

Важливі

•Обов’язково відкрийте порти API у своєму локальному брандмауері.

•Щоб використовувати REST API, сертифікат однорангового вузла для сервера ESET PROTECT (незалежно від того, чи використовується він як сертифікат сервера REST) має містити localhost в полі Загальна назва/Хост. Якщо сертифікат однорангового вузла (сервера) не відповідає цій вимозі, створіть новий сертифікат і змініть сертифікат сервера.

2.Призначте користувачам API набір дозволів API.

Важливі

API недоступний з облікового запису адміністратора.

3.Для автоматизації взаємодії з ESET PROTECT On-Prem API можна використовувати вбудований Swagger UI (доступний в ESET PROTECT On-Prem версії 13.1 і новіших версій).

arrow_down_business Що таке Swagger UI?

Окрім того, можна додати виклики API у клієнтську програму REST (наприклад, Postman) або скористатися командним рядком (curl).

Примітка

Сервер REST працює локально на сервері ESET PROTECT. Не можна використовувати ESET Connect з ESET PROTECT On-Prem REST API.

4.Щоб увійти на сервер REST, виконайте запит GetTokens. У Swagger UI розгорніть GetTokens і клацніть Try it out (Спробувати), укажіть правильні дані в тілі запиту й клацніть Виконати.

Метод

POST

Функція

getTokens

URL-адреса

https://protect_server:9443/GetTokens

Тіло

{

"username" : "api",

"password" : "Admin.12345678",

"grant_type" : "password"

}

5.Відповідь повертає accessToken. Потім ви можете використовувати accessToken в інших запитах API як маркер носія (Authorization: Bearer). У меню Swagger UI клацніть Authorize (Авторизувати), вставте accessToken і клацніть Авторизувати (Авторизувати). Можна здійснювати інші виклики, і Swagger UI автоматично додаватиме токен авторизації в кожен виклик.

Примітка

Див. також приклади викликів API і список усіх викликів API, доступних в ESET PROTECT On-Prem.