ESET PROTECT On-Prem

離線 | 上線

ESET PROTECT On-Prem – 目錄

# 設定 ESET PROTECT On-Prem REST API

複製目前文章 URL 透過電子郵件分享

請依照以下步驟設定 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 起可以使用)。

什麼是 Swagger UI？

Swagger UI 是一個開放原始碼框架，協助開發人員設計、建置、記錄及使用 RESTful Web 服務。使用 Swagger UI，您可以透過網頁測試 API 呼叫： 1.在 ESET PROTECT 伺服器設定中啟用 Swagger UI。 2.啟用的內建 Swagger UI 可在 https://localhost:9443/swagger 進行存取。如有需要，可以將 localhost 取代為伺服器名稱或 IP 位址。 Swagger UI 提供完整的預製 API 呼叫。您僅需要變更呼叫中的參數值。
|  | 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 呼叫清單。

˄˅