跳轉到

OAuth 用戶端 ID

說明如何使用 OAuth 2.0 認證模式來存取 U-Office Force X OpenAPI。

適用情境

情境 說明
AI Agent 整合 (MCP-Server) 您的 AI Agent 需要代表使用者操作 U-Office Force X，例如：查詢待辦、簽核表單等。詳見 MCP-Server 開發手冊。
第三方系統整合 外部系統需要以「使用者身分」存取 U-Office Force X 資源，而非以「系統身分」（API Key 模式）。

API Key vs OAuth

  • API Key 模式：適合「系統對系統」的整合，以固定身分呼叫 API。了解更多
  • OAuth 模式：適合「代表使用者」操作，需要使用者授權。

1. 註冊應用程式並取得憑證

在使用 OAuth 之前，您需要先在 U-Office Force X 系統中註冊應用程式，取得 Client ID 和 Client Secret。

權限提醒

設定需要具有 公司管理員 權限。

操作步驟：

  1. 登入 U-Office Force X，從右上角的頭像切換為「管理員」。
  2. 點選左邊選單的「系統管理」>「金鑰管理」。
  3. 點擊「新增金鑰」按鈕。
  4. 填寫 Client 名稱，並選擇「開放授權金鑰 (OAuth)」類型。
  5. 點擊「自動產生」按鈕以產生金鑰 (Client Secret)。
  6. 新增「重新導向 URL (Redirect URI)」— 這是授權完成後，系統會將使用者導回的網址。
  7. 設定「授權範圍 (Scopes)」— 根據您的應用需求選擇適當的權限。
  8. 點擊「儲存」完成註冊。

下一步