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？

或者，您可以實作 API 呼叫到您的 REST 用戶端應用程式 (例如，Postman)，或者使用指令列 (curl)。

注意

REST 伺服器會在 ESET PROTECT 伺服器上以本機方式執行。 您無法將 ESET Connect 搭配 ESET PROTECT On-Prem REST API 使用。

4.執行 GetTokens 請求以登入 REST 伺服器：在 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 呼叫清單。