Intel® Endpoint Management Assistant （Intel® EMA） 應用程式開發介面 （API） 指南

Intel® EMA API 指南為 IT 管理員和開發人員提供了有關 Intel® Endpoint Management Assistant （Intel® EMA） 應用程式開發介面 （API） 的概述。

PDF 文件為開發人員提供有關英特爾® EMA 應用程式開發介面 （API） 的一般資訊。個別 API URI 的詳細資訊 （例如描述和參數） 包含在下列兩個 HTML 檔案中。 Latestswagger.html 包含一律指向最新發行 API 版本的 API 路徑。此外，也提供第 9 版 API URI 詳細資料檔 V9swagger.html。若要檢視此詳細的 API URI 資訊， 請下載 所需的 HTML 檔案並在瀏覽器中 開啟 它（Chrome 效果最佳）。

其他英特爾 EMA API 詳細資訊：
英特爾®端點管理助手 （Intel® EMA） API 是一組編程接口，旨在允許開發人員和 IT 管理員與英特爾® EMA 交互。此 API 有助於端點設備的管理和監控，自動執行管理任務，並將英特爾® EMA 功能整合到其他軟體解決方案中。

所需環境：
必須安裝並運行 Intel® EMA 服務器。
需要適當的 API 存取權限和認證。

主要特性和功能：

設備管理：
遠端管理和監控端點裝置。
自動化：自動執行管理任務，例如軟體更新、裝置重新啟動和配置變更。
整合：將英特爾® EMA 功能整合到其他軟體解決方案和工作流程中。
安全性：透過身份驗證和授權機制安全地管理裝置。

應用案例：
自動設備配置：自動配置和配置新設備。
遠端故障排除：遠端診斷和解決端點裝置上的問題。
軟體部署：自動部署軟體更新和修補程式。
合規性監控：確保設備符合組織政策和標準。

開始使用：

軟體需求：
必須安裝並運行 Intel® EMA 服務器。
存取權限：需要適當的 API 存取權限和憑證。這些權限在 Swagger JSON 檔案中詳細概述。
API 金鑰產生：從英特爾® EMA 控制台產生 API 金鑰。
配置：配置網路設定並確保英特爾® EMA 伺服器可存取。

身份驗證和安全：

令牌認證：
使用 Intel® EMA 伺服器帳戶的使用者名稱和相關聯密碼。
Active Directory 驗證：使用 Active Directory 中的認證。只有在 Intel® EMA 安裝時，可以使用 Windows* 網域驗證模式，且 Intel® EMA 伺服器已加入 Active Directory 網域。
客戶端憑證身份驗證：專為對英特爾® EMA 伺服器的 API 存取而設計。您需要在 Intel® EMA 伺服器上建立用戶端認證帳戶和用戶端密碼。
Microsoft* Entra 驗證：在 Intel® EMA 1.9.0 中引入，允許使用 Azure Active Directory （稱為 Microsoft Entra） 對 Intel® EMA Web 介面進行驗證。

安全最佳實踐：
使用 HTTPS：始終使用 HTTPS 加密傳輸中的資料。
最低權限：授予 API 使用者最低限度的必要權限。
密碼雜湊：不要將密碼儲存在明文檔案中。

錯誤處理和故障排除：

常見錯誤代碼：
400 錯誤要求：輸入參數無效。
401 未授權：驗證認證無效或遺失。
404 找不到：找不到資源。
500 內部伺服器錯誤：伺服器遇到非預期的情況。

故障排除提示：
檢查 API 金鑰：確保 API 金鑰有效並具有必要的權限。
驗證輸入：驗證輸入參數是否正確且格式正確。
網路問題：確保用戶端和英特爾® EMA 伺服器之間沒有網路連線問題。