ESET PROTECT On-Prem – Inhaltsverzeichnis

ESET PROTECT On-Prem REST API einrichten

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

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

Wichtig

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

Wichtig

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

arrow_down_business Was ist Swagger UI?

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

Hinweis

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.

Hinweis

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