ESET PROTECT On-Prem – Indice

Configura ESET PROTECT On-Prem REST API

Segui i passaggi sottostanti per configurare ESET PROTECT On-Prem REST API:

1.Abilita REST API in Più > Impostazioni.


IMPORTANTE

Assicurati di aprire le porte API nel firewall locale.

Per utilizzare REST API, il certificato del computer per ESET PROTECT Server (utilizzato o meno come certificato di REST Server) deve contenere localhost nel campo Nome comune/Host. Se il certificato del computer (Server) non soddisfa questo requisito, creare un nuovo certificato e modificare il certificato del server.

2.Assegna agli utenti API il set di autorizzazioni API***.


IMPORTANTE

L’account Amministratore non può utilizzare le API.

3.Per automatizzare le interazioni con ESET PROTECT On-Prem API, è possibile utilizzare il modulo integrato Swagger UI (disponibile a partire da ESET PROTECT On-Prem versione 13.1).

arrow_down_business Cos’è Swagger UI?

In alternativa, è possibile implementare le chiamate API nell’applicazione REST Client (ad esempio, Postman) oppure utilizzare la riga di comando (curl).


Nota

REST Server è in esecuzione localmente su ESET PROTECT Server. Non puoi utilizzare ESET Connect con ESET PROTECT On-Prem REST API.

4.Esegui la richiesta GetTokens per effettuare l’autenticazione a REST Server: Nel modulo Swagger UI espandere GetTokens > fare clic su Prova > fornire i dati corretti nel corpo della richiesta e fare clic su Esegui.

Metodo

POST

Funzione

getTokens

URL

https://protect_server:9443/GetTokens

Corpo

{

"username" : "api",

"password" : "Admin.12345678",

"grant_type" : "password"

}

5.La risposta restituisce il valore accessToken. Successivamente puoi usare accessToken in altre richieste API come token di connessione (Authorization: Bearer). Nel modulo Swagger UI fare clic su Autorizza > incollare accessToken > fare clic su Autorizza. È possibile eseguire altre chiamate; il modulo Swagger UI include automaticamente il token di autorizzazione in ognuna di esse.


Nota

Vedi anche gli esempi di chiamate API e l’elenco di tutte le chiamate API disponibili in ESET PROTECT On-Prem.