ESET PROTECT On-Prem

Offline | Onlinemodus

ESET PROTECT On-Prem – Inhaltsverzeichnis

# ESET PROTECT On-Prem REST API einrichten

URL des aktuellen Artikels kopieren Per E-Mail teilen

Gehen Sie wie folgt vor, um die ESET PROTECT On-Prem REST API einzurichten:

1.Aktivieren Sie die REST API unter Mehr > Einstellungen.

|  | •Öffnen Sie die Ports für die API in Ihrer lokalen Firewall. •Um den REST API nutzen zu können, muss das Peer-Zertifikat für den ESET PROTECT-Server (unabhängig davon, ob es als REST Serverzertifikat verwendet wird oder nicht) localhost im Feld AllgemeinerName/Host enthalten. Wenn das Peer-Zertifikat (Serverzertifikat) diese Anforderung nicht erfüllt, erstellen Sie ein neues Zertifikat und tauschen Sie das Serverzertifikat aus.

2.Weisen Sie den API Benutzern den API Berechtigungssatz zu.

|  | Das Administratorkonto kann die API nicht verwenden.

3.Um die Interaktion mit dem ESET PROTECT On-Prem API zu automatisieren, können Sie die integrierte Swagger UI nutzen (verfügbar seit der ESET PROTECT On-Prem-Version 13.1).

Was ist Swagger UI?

Swagger UI ist ein Open-Source-Framework, das Entwicklern dabei hilft, RESTful-Webdienste zu entwerfen, zu erstellen, zu dokumentieren und zu nutzen. Mit dem Swagger UI können Sie die API-Aufrufe über eine Webseite testen: 1.Aktivieren Sie Swagger UI in den Servereinstellungen des ESET PROTECT -Servers. 2.Die Aktivierung der integrierten Funktion Swagger UI ist unter https://localhost:9443/swagger verfügbar. Ersetzen Sie localhost bei Bedarf durch den Servernamen oder die IP-Adresse. Swagger UI bietet komplette, vorgefertigte API-Aufrufe an. Sie müssen lediglich die Parameterwerte in den Aufrufen ändern.
|  | Swagger UI ist nur auf Englisch verfügbar.

Alternativ können Sie API-Aufrufe in Ihrer REST Client-Anwendung (z. B. Postman) implementieren oder die Befehlszeile (curl) verwenden.

|  | Der REST Server wird lokal auf dem ESET PROTECT Server ausgeführt. ESET Connect kann nicht mit der ESET PROTECT On-Prem REST API verwendet werden.

4.Führen Sie die GetTokens-Anfrage aus, um sich beim REST Server anzumelden: Erweitern Sie im Swagger UI GetTokens > klicken Sie auf Ausprobieren >, geben Sie korrekte Daten im Anfragetext ein und klicken Sie auf Ausführen.

Methode | POST
Funktion | getTokens
URL | https://protect_server:9443/GetTokens
Körper | { "username" : "api", "password" : "Admin.12345678", "grant_type" : "password" }

5.Die Antwort sendet das accessToken. Anschließend können Sie das accessToken in anderen API-Anfragen als Bearer-Token verwenden (Authorization: Bearer). Klicken Sie im Swagger UI auf Authorisieren > fügen Sie den accessToken ein > klicken Sie auf Autorisieren. Sie können weitere Aufrufe ausführen, und Swagger UI fügt bei jedem Aufruf automatisch das Token für die Autorisierung hinzu.

|  | Siehe auch die Beispiele für API-Aufrufe und die Liste aller API-Aufrufe in ESET PROTECT On-Prem.

˄˅