ESET PROTECT On-Prem – Spis treści

Konfiguracja ESET PROTECT On-Prem REST API

Postępuj zgodnie z poniższymi krokami, aby skonfigurować ESET PROTECT On-Prem REST API:

1.Włącz REST API w sekcji Więcej > Ustawienia.

WAŻNE

•Pamiętaj, aby otworzyć porty API w swojej lokalnej zaporze.

•Aby korzystać z interfejsu REST API, certyfikat równorzędny serwera ESET PROTECT (niezależnie od tego, czy jest on używany jako serwer REST) musi zawierać ciąg localhost w polu Common name/Host. Jeśli certyfikat równorzędny (serwera) nie spełnia tego wymogu, utwórz nowy certyfikat i zmień certyfikat serwera.

2.Przypisz użytkownikom API zestaw uprawnień do API.

WAŻNE

Konto administratora nie może używać API.

3.Aby zautomatyzować interakcje API ESET PROTECT On-Prem, możesz użyć wbudowanego interfejsu Swagger UI (dostępny w ESET PROTECT On-Prem od wersji 13.1).

arrow_down_business Co to jest Swagger UI?

Ewentualnie możesz zaimplementować wywołania interfejsu API w aplikacji klienckiej REST (na przykład Postman) lub użyć wiersza poleceń (curl).

Uwaga

Serwer REST działa lokalnie na serwerze ESET PROTECT. Nie możesz użyć ESET Connect z ESET PROTECT On-Prem REST API.

4.Wykonaj żądanie GetTokens w celu zalogowania się na serwer REST: W interfejsie Swagger UI rozwiń sekcję GetTokens > kliknij Try it out (Wypróbuj) > podaj poprawne dane w treści żądania i kliknij Execute (Wykonaj).

Metoda

POST

Funkcja

getTokens

Adres URL

https://protect_server:9443/GetTokens

Treść

{

"username" : "api",

"password" : "Admin.12345678",

"grant_type" : "password"

}

5.Odpowiedź zwraca accessToken. Następnie możesz użyć accessToken w innych żądaniach API jako tokena okaziciela (Authorization: Bearer). W interfejsie Swagger UI kliknij Authorize (Autoryzuj) > wklej accessToken > kliknij Authorize (Autoryzuj). Możesz realizować inne wywołania, a Swagger UI automatycznie uwzględni token autoryzacji w każdym z nich.

Uwaga

Zobacz także przykłady wywołań API oraz listę wszystkich wywołań API dostępne w ESET PROTECT On-Prem.