ESET PROTECT On-Prem – Sommaire

Configurer l'REST API ESET PROTECT On-Prem

Pour configurer l'REST API ESET PROTECT On-Prem, procédez comme suit :

1.Activez l'REST API dans Plus > Paramètres.

IMPORTANT

•Veillez à ouvrir les ports API dans votre pare-feu local.

•Pour utiliser REST API, le certificat homologue d'ESET PROTECT Server (qu'il soit utilisé ou non comme certificat de serveur REST) doit contenir localhost dans le champ Nom commun/Hôte. Si le certificat homologue (serveur) ne répond pas à cette exigence, créez un nouveau certificat et remplacez le certificat serveur.

2.Attribuez aux utilisateurs API le jeu d'autorisations API.

IMPORTANT

Le compte Administrateur ne peut pas utiliser l'API.

3.Pour automatiser les interactions avec l'ESET PROTECT On-Prem API ESET PROTECT On-Prem, vous pouvez utiliser l'interface Swagger UIintégrée (disponible depuis ESET PROTECT On-Prem version 13.1).

arrow_down_business Qu'est-ce qu'Swagger UI ?

Vous pouvez aussi implémenter des appels API à votre application cliente REST (par exemple, Postman) ou vous pouvez utiliser la ligne de commande (curl).

Remarque

Le serveur REST s'exécute localement sur ESET PROTECT Server. Vous ne pouvez pas utiliser ESET Connect avec l'REST API ESET PROTECT On-Prem.

4.Exécutez la requête GetTokens pour vous connecter au serveur REST : Dans l'interface Swagger UI, développez GetTokens, cliquez sur Essayer, fournissez des données correctes dans le corps de la demande, puis cliquez sur Exécuter.

Méthode

POST

Fonction

getTokens

URL

https://protect_server:9443/GetTokens

Corps

{

"username" : "api",

"password" : "Admin.12345678",

"grant_type" : "password"

}

5.La réponse renvoie le jeton accessToken. Vous pouvez ensuite utiliser accessToken dans d'autres requêtes API comme jeton du porteur (Authorization: Bearer). Dans l'interface Swagger UI, cliquez sur Autoriser >, collez le jeton accessToken, puis cliquez sur le bouton Autoriser. Vous pouvez effectuer d'autres appels. Swagger UI inclut automatiquement le jeton d'autorisation dans chaque appel.

Remarque

Voir aussi les exemples d'appels API et la liste de tous les appels API disponibles dans ESET PROTECT On-Prem.