ESET PROTECT On-Prem

Hors ligne | Aller en ligne

ESET PROTECT On-Prem – Table des matières

# Configurer ESET PROTECT On-Prem REST API

Copier l'URL de l'article actuel Envoyer par courriel

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

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

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

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

Qu'est-ce que Swagger UI?

Swagger UI est un cadre de logiciel libre qui aide les développeurs à concevoir, construire, documenter et consommer des services Web RESTful. En utilisant Swagger UI, vous pouvez tester les appels d'API sur une page Web : 1.Activez Swagger UI dans les Paramètres du serveur ESET PROTECT. 2.Le Swagger UI intégré et activé est accessible à https://localhost:9443/swagger. Remplacez le localhost par le nom du serveur ou l'adresse IP si nécessaire. Swagger UI fournit des appels d'API préconçus complets. Il vous suffit de modifier les valeurs des paramètres dans les appels.
|  | Swagger UI est disponible uniquement en anglais.

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

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

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

˄˅