ESET PROTECT On-Prem – Obsah

Nastavení ESET PROTECT On-Prem REST API

Nastavte ESET PROTECT On-Prem REST API podle následujících kroků:

1.REST API Zapnete v sekci Další > Nastavení.

Důležité

•Na lokáním firewallu otevřete porty pro API.

•Aby bylo možné používat REST API, partnerský certifikát pro ESET PROTECT Server (bez ohledu na to, zda se používá jako certifikát serveru REST nebo ne) musí obsahovat localhost v poli Obecný název/Hostitel. Pokud klientský certifikát (serveru) nesplňuje tento požadavek, vytvořte nový certifikát a změňte certifikát serveru.

2.Přiřaďte uživatelům API sadu oprávnění pro API.

Důležité

Účet administrátora nemůže používat API.

3.K automatizaci interakcí s ESET PROTECT On-Prem API můžete použít integrovaný nástroj Swagger UI (k dispozici od verze ESET PROTECT On-Prem 13.1).

arrow_down_business Co je Swagger UI?

Případně můžete ve své klientské aplikaci REST implementovat volání typu API (například Postman) nebo můžete použít příkazový řádek (curl).

Poznámka

Server REST běží lokálně na ESET PROTECT Serveru. Nemůžete použít ESET Connect s ESET PROTECT On-Prem REST API.

4.Proveďte požadavek naGetTokens pro přihlášení k serveru REST: V nástroji Swagger UI rozbalte GetTokens, klikněte na Try it out, zadejte správné údaje do těla požadavku a klikněte na Execute.

Způsob

POST

Funkce

getTokens

URL

https://protect_server:9443/GetTokens

Tělo

{

"username" : "api",

"password" : "Admin.12345678",

"grant_type" : "password"

}

5.Odpověď vrátí accessToken. Následně můžete použít accessToken v dalších požadavcích na API jako je token na doručitele (Authorization: Bearer). V nástroji Swagger UI klikněte na Authorize, vložte accessToken a klikněte na Authorize. Můžete provést další volání, přičemž Swagger UI automaticky zahrne autorizační token do každého z nich.

Poznámka

Viz také příklady volání API a seznam všech volání API dostupných v ESET PROTECT On-Prem.