ESET PROTECT On-Prem – 目录

设置 ESET PROTECT On-Prem REST API

请按照以下步骤设置 ESET PROTECT On-Prem REST API：

1.在更多 > 设置中启用 REST API。

重要信息

•确保打开本地防火墙中的 API 端口。

•要使用 REST API，ESET PROTECT 服务器的对等证书（无论是否用作 REST 服务器证书）的常用名/主机字段中必须包含 localhost。如果对等（服务器）证书不满足此要求，请创建新证书并更改服务器证书。

2.为 API 用户分配 API 权限集。

重要信息

管理员帐户无法使用 API。

3.要自动与 ESET PROTECT On-Prem API 交互，您可以使用内置 Swagger UI（自 ESET PROTECT On-Prem 版本 13.1 起可用）。

arrow_down_business Swagger UI 是什么？

或者，您可以实现对 REST 客户端应用程序的 API 调用（例如 Postman），或者您可以使用命令行 (curl)。

注意

REST 服务器在 ESET PROTECT 服务器上本地运行。 不能将 ESET Connect 与 ESET PROTECT On-Prem REST API 配合使用。

4.执行用于登录 REST 服务器的 GetTokens 请求：在 Swagger UI 中，展开 GetTokens > 单击试用 > 在请求正文中提供正确的数据，然后单击执行。

方法

POST

函数

getTokens

URL

https://protect_server:9443/GetTokens

正文

{

"username" : "api",

"password" : "Admin.12345678",

"grant_type" : "password"

}

5.响应将返回 accessToken。您随后可以在其他 API 请求中使用 accessToken 作为持有者令牌 (Authorization: Bearer)。在 Swagger UI 中，单击授权 > 粘贴 accessToken > 单击授权。您可以执行其他调用，Swagger UI 会自动在每个调用中包含授权令牌。

注意

另请参阅 API 调用示例以及 ESET PROTECT On-Prem 中的所有 API 调用的列表。