ESET PROTECT On-Prem

Offline | Prejsť do režimu online

ESET PROTECT On-Prem – Obsah

# Nastavenie ESET PROTECT On-Prem REST API

Skopírovať odkaz na aktuálny článok Odoslať e‑mailom

Nastavte ESET PROTECT On-Prem REST API podľa nasledujúcich krokov:

1.V časti Viac > Nastavenia zapnite REST API.

|  | •Uistite sa, že sú v lokálnom firewalle otvorené porty API. •Aby bolo možné používať REST API, partnerský certifikát pre ESET PROTECT Server (bez ohľadu na to, či sa používa ako certifikát servera REST alebo nie) musí obsahovať localhost v poli Spoločný názov/Hostiteľ. Ak partnerský certifikát (servera) nespĺňa túto požiadavku, vytvorte nový certifikát a zmeňte certifikát servera.

2.Priraďte používateľom API súbor povolení API.

|  | Účet správcu nemôže používať API.

3.Na automatizáciu interakcií s ESET PROTECT On-Prem API môžete použiť integrovaný nástroj Swagger UI (k dispozícii od verzie ESET PROTECT On-Prem 13.1).

Čo je Swagger UI?

Swagger UI je aplikačný rámec s otvoreným zdrojovým kódom, ktorý pomáha vývojárom navrhovať, vytvárať, dokumentovať a využívať webové služby RESTful. Pomocou nástroja Swagger UI môžete otestovať volania API prostredníctvom webovej stránky: 1.V nastaveniach ESET PROTECT Servera zapnite Swagger UI. 2.Aktivovaný integrovaný nástroj Swagger UI je dostupný na https://localhost:9443/swagger. V prípade potreby nahraďte localhost názvom servera alebo IP adresou. Swagger UI poskytuje kompletné, vopred pripravené volania API. Stačí zmeniť hodnoty parametrov vo volaniach.
|  | Swagger UI je k dispozícii len v angličtine.

Alternatívne môžete implementovať volania API do svojej klientskej aplikácie REST (napr. Postman) alebo použite príkazový riadok (curl).

|  | REST Server beží lokálne na ESET PROTECT Serveri. Nie je možné súčasne používať ESET Connect a ESET PROTECT On-Prem REST API.

4.Odošlite požiadavku GetTokens na prihlásenie na server REST. V nástroji Swagger UI rozbaľte GetTokens, kliknite na Try it out, zadajte správne údaje do tela požiadavky a kliknite na Execute.

Metóda | POST
Funkcia | getTokens
URL | https://protect_server:9443/GetTokens
Telo | { "username" : "api", "password" : "Admin.12345678", "grant_type" : "password" }

5.Odpoveď vráti accessToken. Následne môžete použiť accessToken v ďalších požiadavkách API ako prístupový token (Authorization: Bearer). V nástroji Swagger UI kliknite na Authorize, vložte accessToken a kliknite na Authorize. Môžete vykonať ďalšie volania, pričom Swagger UI automaticky zahrnie autorizačný token do každého z nich.

|  | Pozrite si tiež príklady volaní API a zoznam všetkých volaní API, ktoré sú k dispozícii v rámci ESET PROTECT On-Prem.

˄˅