ESET PROTECT On-Prem

Sin conexión | Establecer conexión

ESET PROTECT On-Prem – Índice

# Configurar ESET PROTECT On-Prem REST API

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

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

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

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

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

¿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. Usando Swagger UI, puede probar las llamadas API a través de una página web: 1.Active Swagger UI en la configuración de ESET PROTECT Server. 2.Se puede acceder a Swagger UI integrado activado en https://localhost:9443/swagger. Sustituya localhost por el nombre o la dirección IP del servidor si es necesario. Swagger UI proporciona llamadas API prefabricadas completas. Solo tiene que cambiar los valores de los parámetros en las llamadas.
|  | Swagger UI solo está disponible en inglés.

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

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

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

˄˅