ESET PROTECT On-Prem

Sin conexión | Trabajar en línea

ESET PROTECT On-Prem – Tabla de contenido

# Configurar la REST API de ESET PROTECT On-Prem

Copiar la URL del artículo actual Compartir por correo electrónico

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

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

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

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

¿Qué es Swagger UI?

Swagger UI es un marco de código abierto que ayuda a los desarrolladores a diseñar, compilar, documentar y consumir servicios web RESTful. Con Swagger UI, puede probar las llamadas API a través de una página web: 1.Habilite Swagger UI en la configuración de ESET PROTECT Server. 2.Se puede acceder a la instalación integrada habilitada de Swagger UI en https://localhost:9443/swagger. Reemplace localhost por el nombre del servidor o la dirección IP si es necesario. Swagger UI proporciona llamadas API prefabricadas completas. Solo necesita cambiar los valores de los parámetros en las llamadas.
|  | Swagger UI solo está disponible en inglés.

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

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

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

˄˅