ESET PROTECT On-Prem

Off-line | Vai on-line

ESET PROTECT On-Prem – Indice

# Configura ESET PROTECT On-Prem REST API

Copia l’URL dell’articolo corrente Invia tramite e-mail

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

1.Abilita REST API in Più > Impostazioni.

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

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

Cos’è Swagger UI?

Swagger UI è un framework open-source che aiuta gli sviluppatori a progettare, creare, documentare e utilizzare servizi web RESTful. Utilizzando il modulo Swagger UI, è possibile testare le chiamate API tramite una pagina web: 1.Abilitare Swagger UI nelle Impostazioni di ESET PROTECT Server. 2.Il modulo integrato abilitato Swagger UI è accessibile all’indirizzo https://localhost:9443/swagger. Sostituire localhost con il nome del server o l’indirizzo IP, se necessario. Swagger UI fornisce chiamate API pronte all’uso complete. È sufficiente modificare i valori dei parametri nelle chiamate.
|  | Swagger UI è disponibile solo in lingua inglese.

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

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

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

˄˅