Intel® 端點管理助理（EMA）應用程式介面（API）指南

Intel® EMA API 指南為 IT 管理員與開發者提供了關於 Intel® 端點管理助理（Intel® EMA）應用程式介面（API）的概要。

PDF 文件為開發者提供了關於Intel® EMA 應用程式介面（API）的一般資訊。以下兩個 HTML 檔案包含了關於個別 API URI（如描述與參數）的詳細資訊。 Latestswagger.html 包含總是指向最新釋出版本的 API 路徑。此外，還提供了第 9 版 API 的 URI 詳細檔案 V9swagger.html。要查看這些詳細的 API URI 資訊，請 下載 所需的 HTML 檔案並在瀏覽器 中開啟 （Chrome 使用效果最佳）。

更多 Intel EMA API 細節：
Intel® 端點管理助理（Intel® EMA）API 是一組程式介面，設計用以讓開發者與 IT 管理員與 Intel® EMA 互動。此 API 促進終端設備的管理與監控，自動化管理工作，並將 Intel® EMA 功能整合至其他軟體解決方案中。

必修環境：
® Intel EMA 伺服器必須安裝並執行。
需要適當的 API 存取權限與憑證。

主要特色與能力：

裝置管理：
遠端管理與監控終端裝置。
自動化：自動化管理工作，如軟體更新、裝置重啟及設定變更。
整合：將 Intel® EMA 功能整合到其他軟體解決方案與工作流程中。
安全性：透過認證與授權機制安全管理裝置。

使用案例：
自動化裝置配置：自動配置並配置新裝置。
遠端故障排除：遠端診斷並解決終端裝置的問題。
軟體部署：自動化軟體更新與修補程式的部署。
合規監控：確保裝置符合組織政策與標準。

開始：

軟體需求：
® Intel EMA 伺服器必須安裝並執行。
存取權限：需要適當的 API 存取權限與憑證。這些權限在 Swagger JSON 檔案中有詳細說明。
API 金鑰產生：從 Intel® EMA 主控台產生 API 金鑰。
設定：設定網路設定並確保 Intel® EMA 伺服器可存取。

認證與安全性：

代幣認證：
使用使用者名稱及相關密碼登入 Intel® EMA 伺服器帳號。
Active Directory 認證：使用 Active Directory 的憑證。只有在 Intel® EMA 安裝 Windows* 網域認證模式，且® Intel EMA 伺服器加入 Active Directory 網域時，才能使用。
用戶端憑證認證：設計用於 Intel EMA 伺服器的 API 存取®。你需要在 Intel® EMA 伺服器上建立客戶端憑證帳號和客戶端秘密。
Microsoft* Entra 認證：於 Intel® EMA 1.9.0 引入，允許使用 Azure Active Directory（稱為 Microsoft Entra）對 Intel® EMA 網頁介面進行認證。

安全最佳實務：
使用 HTTPS：傳輸過程中的資料加密時務必使用 HTTPS。
最低權限：授予 API 使用者最低必要的權限。
密碼雜湊：請勿將密碼儲存在明文檔案中。

錯誤處理與故障排除：

常見錯誤代碼：
400 錯誤請求：輸入參數無效。
401 未授權：認證憑證無效或缺失。
404 未找到：資源未找到。
500 內部伺服器錯誤：伺服器遇到意外狀況。

故障排除建議：
檢查 API 金鑰：確保 API 金鑰有效且具備必要的權限。
驗證輸入：確認輸入參數正確且格式正確。
網路問題：確保用戶端與 Intel® EMA 伺服器間沒有網路連線問題。