ESET PROTECT On-Prem – Table des matières

Configurer ESET PROTECT On-Prem REST API

Suivez les étapes ci-dessous pour configurer ESET PROTECT On-Prem REST API :

1.Activez REST API en cliquant sur Plus > Paramètres.

IMPORTANT

•Assurez-vous d'ouvrir les ports de l'API dans votre pare-feu local.

•Pour utiliser l'REST API, le certificat homologue du serveur ESET PROTECT (qu'il soit utilisé comme certificat du serveur REST ou non) doit contenir localhost dans le champ Nom usuel/Hôte. Si le certificat homologue (serveur) ne répond pas à cette exigence, vous devez créer un nouveau certificat et modifier le certificat du serveur.

2.Attribuez aux utilisateurs de l'API l'ensemble d'autorisations pour API.

IMPORTANT

Le compte administrateur ne peut pas utiliser API.

3.Pour automatiser les interactions avec l'API ESET PROTECT On-Prem, vous pouvez utiliser le Swagger UI intégré (disponible à partir de la version 13.1 de ESET PROTECT On-Prem).

arrow_down_business Qu'est-ce que Swagger UI?

En parallèle, vous pouvez implémenter des appels de l'API vers votre application cliente REST (par exemple, Postman) ou utilisez la ligne de commande (curl).

Remarque

Le serveur REST fonctionne localement sur le serveur ESET PROTECT. Tu ne peux pas utiliser ESET Connect avec ESET PROTECT On-Prem REST API.

4.Exécutez la requête GetTokens pour effectuer une connexion au serveur REST : Dans Swagger UI, développez GetTokens > cliquez sur Essayer > fournissez les données correctes dans le corps de la requête et 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 accessToken. Vous pouvez ensuite utiliser le accessToken dans d'autres requêtes d'API comme jeton porteur (Authorization: Bearer). Dans Swagger UI, cliquez sur Autoriser > collez le accessToken > cliquez sur Autoriser. Vous pouvez exécuter d'autres appels, et Swagger UI inclut automatiquement le jeton d'autorisation dans chaque appel.

Remarque

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