Seleccionar la pestaña
ESET PROTECT On-Prem – Tabla de contenido

Configurar la REST API de ESET PROTECT On-Prem

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

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


IMPORTANTE

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

Para usar REST API, el certificado de pares de ESET PROTECT Server (tanto si se usa como certificado del servidor REST o no) debe contener localhost en el campo Nombre común/Host. Si el certificado de pares (servidor) no cumple este requisito, cree un nuevo certificado y cambie el certificado del servidor.

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


IMPORTANTE

La cuenta de administrador no puede usar la API.

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

arrow_down_business ¿Qué es Swagger UI?

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


Nota

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

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 el accessToken. Posteriormente, puede usar el accessToken en otras solicitudes de API como un token portador (Authorization: Bearer). En Swagger UI, haga clic en Autorizar > pegue el accessToken > haga clic en Autorizar. Puede ejecutar otras llamadas, y Swagger UI incluye automáticamente el token de autorización en cada una.


Nota

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