跳至主要内容

服務帳號與 API Key

服務帳號和 API Key 用於系統整合、連接器、MCP 客戶端、自動化任務和 AI Agent 工作流程。這類身分沒有使用者在鍵盤前操作,但應按生產身分管理,明確歸屬、scope、輪換和稽核要求。

身分流程​

適用場景​

場景用途
資料連接器使用受控憑據從批准的資料來源拉取或推送資料。
MCP 客戶端讓 AI 客戶端只發現並呼叫該 endpoint 切片允許的 FactVerse 工具。
AI Agent 工作流程擷取授權上下文、執行受治理工具,並用可追溯身分記錄動作。
企業自動化執行排程匯入、匯出、報表刷新或維修交接任務。
系統整合連接 EAM、CMMS、BMS、ERP、資料湖、文件服務或客戶入口。

申請資訊​

欄位範例
業務負責人對整合結果負責的團隊。
技術負責人對憑據存放、輪換和事件回應負責的團隊。
租戶和環境生產、預發布、私有雲或本地部署。
endpoint 或產品區域DFS 連接器、ECM 匯入、MCP 切片、AI Agent 工作流程或產品 API。
所需 scope讀取、寫入、計算、動作草稿、審核或產品專用 scope。
資料範圍租戶、站點、資產組、資料夾、資料集或工作流程範圍。
輪換策略定期輪換和緊急撤銷流程。

Scope 設計​

從能完成整合目標的最小 scope 開始。不要在無關系統或租戶之間共享同一個 Key。

決策項建議
租戶範圍一個 Key 對應一個租戶或部署範圍。
產品範圍DFS、ECM、MCP、AI 工作流程歸屬不同時,使用獨立 Key。
動作範圍唯讀 Key 與可寫入、審核、觸發動作或改配置的 Key 分開。
生命週期按計畫輪換;負責人變更或疑似外洩後立即輪換。
存放只存放在批准的密鑰管理或部署配置系統中。

驗證清單​

  1. 確認整合只能驗證到目標環境。
  2. 確認工具發現或 API 存取只返回預期能力。
  3. 啟用寫入或動作 scope 前,先完成唯讀測試。
  4. 確認寫入或動作測試能產生預期稽核記錄。
  5. 確認 Key 負責人、輪換負責人和撤銷路徑已記錄。
  6. 確認 Key 被移除或過期時,整合會安全失敗。