ESET PROTECT On-Prem

Автономний режим | Підключитися до Інтернету

ESET PROTECT On-Prem – Зміст

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

Скопіювати URL-адресу поточної статті Поділитись електронною поштою

Щоб налаштувати 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 і новіших версій).

Що таке 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 з 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.

˄˅