ESET PROTECT On-Prem

Hors ligne | Accéder en ligne

ESET PROTECT On-Prem – Sommaire

# Configurer l'REST API ESET PROTECT On-Prem

Copier l'URL de l'article actuel Partager par e-mail

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

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

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

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

Qu'est-ce qu'Swagger UI ?

Swagger UI est un framework open source qui permet aux développeurs de concevoir, de créer, de documenter et d'utiliser des services web RESTful. À l'aide de Swagger UI, vous pouvez tester les appels API via une page web : 1.Activez Swagger UI dans les paramètres ESET PROTECT Server. 2.L'interface Swagger UI intégrée activée est accessible à l'adresse https://localhost:9443/swagger. Remplacez localhost par le nom du serveur ou l'adresse IP si nécessaire. Swagger UI fournit des appels API précréés complets. Il vous suffit de modifier les valeurs des paramètres dans les appels.
|  | Swagger UI n'est disponible qu'en anglais.

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

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

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

˄˅