ESET PROTECT On-Prem

Offline | Przejdź do trybu online

ESET PROTECT On-Prem – Spis treści

# Konfiguracja ESET PROTECT On-Prem REST API

Skopiuj adres URL bieżącego artykułu Udostępnij przez e-mail

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.

|  | •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.

|  | 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).

Co to jest Swagger UI?

Swagger UI to rozwiązanie typu open source ułatwiające programistom projektowanie, budowanie, dokumentowanie i użytkowanie usług sieciowych RESTful. Za pomocą interfejsu Swagger UI możesz przetestować wywołania interfejsu API za pośrednictwem strony internetowej: 1.Włącz Swagger UI w ustawieniach serwera ESET PROTECT. 2.Włączony wbudowany Swagger UI jest dostępny pod adresem https://localhost:9443/swagger. W razie potrzeby zastąp wartość localhost nazwą serwera lub adresem IP. Swagger UI pozwala przeprowadzić pełne, wstępnie przygotowane wywołania interfejsu API. Wystarczy zmienić wartości parametrów w wywołaniach.
|  | Interfejs Swagger UI jest dostępny wyłącznie w języku angielskim.

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

|  | 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.

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

˄˅