ESET PROTECT On-Prem – Índice

Configurar ESET PROTECT On-Prem REST API

Siga estos pasos para configurar ESET PROTECT On-Prem REST API:

1.Active REST API en Más > Configuración.


IMPORTANTE

Asegúrese de abrir los puertos de API en su cortafuegos local.

Para utilizar REST API, el certificado de par de ESET PROTECT Server (tanto si se utiliza como certificado de servidor REST como si no) debe contener localhost en el campo Nombre común/Cliente. Si el certificado de par (Server) no cumple este requisito, cree un nuevo certificado y cambie el certificado de Server.

2.Asigne a los usuarios de API el conjunto de permisos de API.


IMPORTANTE

La cuenta de administrador no puede utilizar la API.

3.Para automatizar las interacciones con ESET PROTECT On-Prem API, puede utilizar Swagger UI integrado (disponible desde ESET PROTECT On-Prem versión 13.1).

arrow_down_business ¿Qué es Swagger UI?

También puede implementar las llamadas API en su aplicación cliente de REST (por ejemplo, Postman) o usar la línea de comandos (curl).


Nota

El servidor de REST se ejecuta localmente en ESET PROTECT Server. No puede usar ESET Connect con ESET PROTECT On-Prem REST API.

4.Ejecute la solicitud GetTokens para iniciar sesión en el servidor de REST: En Swagger UI, expanda GetTokens > haga clic en Pruébelo > proporcione los datos correctos en el cuerpo de la solicitud y haga clic en Ejecutar.

Método

POST

Función

getTokens

URL

https://protect_server:9443/GetTokens

Cuerpo

{

"username" : "api",

"password" : "Admin.12345678",

"grant_type" : "password"

}

5.La respuesta devuelve accessToken. Posteriormente, puede usar accessToken en otras solicitudes de API como token de portador (Authorization: Bearer). En Swagger UI, haga clic en Autorizar > pegue accessToken > haga clic en Autorizar. Puede ejecutar otras llamadas, y Swagger UI incluye automáticamente el token de autorización en cada llamada.


Nota

Consulte también los ejemplos de llamadas API y la lista de todas las llamadas API disponibles en ESET PROTECT On-Prem.