在 Looker 中，管理員可以使用「管理 OAuth 用戶端」頁面，為外部應用程式管理以身分為基礎的 OAuth 2.0 存取權，不必建立 API 金鑰或使用 API Explorer。本文說明如何啟用預先設定的應用程式、註冊自訂 OAuth 用戶端，以及管理權杖撤銷作業。
「管理 OAuth 用戶端」頁面位於 Looker「管理」面板的「驗證」部分。提供集中式介面，可授予 Looker CLI、AI 代理 Model Context Protocol (MCP) 用戶端和商業智慧 (BI) 連接器等開發人員工具的存取權。
需求條件
如要存取及管理「管理 OAuth 用戶端」頁面，必須符合下列條件：
- Looker 執行個體必須由 Looker 代管。不支援客戶託管的 Looker 執行個體。
- 您必須具備 Looker 執行個體的管理員角色。
總覽
「管理 OAuth 用戶端」頁面會將用戶端應用程式分為兩個分頁：
- 應用程式庫：預先設定且由 Looker 管理的 OAuth 應用程式目錄，包括 AI 代理 Model Context Protocol (MCP) 用戶端、商業智慧 (BI) 連接器和開發人員工具。
- 自訂用戶端：管理介面，用於註冊及設定自訂 OAuth 用戶端應用程式，並提供可自訂的回呼重新導向 URI 和群組存取控管。
頁面頂端的搜尋列可讓您即時篩選兩個分頁中的應用程式。
「應用程式庫」分頁
「應用程式程式庫」分頁包含由 Looker 維護的預先設定 OAuth 用戶端。建議您先查看「應用程式庫」分頁，再建立自訂用戶端。如果想連結的工具已在程式庫中預先設定，您只要啟用即可，不必註冊新的自訂用戶端，除非您需要不同的重新導向 URI 或通訊埠。
應用程式庫包含預先設定的用戶端，可用於下列整合：
- AI 代理 MCP 用戶端：Cursor、VS Code、Claude Code、Claude Desktop、ChatGPT、Gemini CLI、Cline、Windsurf、Antigravity，以及 VS Code 的 Looker 擴充功能。
- 商業智慧 (BI) 連接器：連結試算表、數據分析、Tableau Desktop、Microsoft Power BI 和 Microsoft Excel。
- 開發人員工具：Looker CLI。
啟用及停用程式庫應用程式
應用程式庫中每個預先設定的用戶端應用程式都有「啟用」切換鈕：
- 啟用：啟用切換鈕，允許使用者透過 OAuth 從該用戶端應用程式驗證 Looker。
- 停用：停用切換鈕，即可封鎖該用戶端應用程式的授權要求。停用應用程式後，系統會立即撤銷並撤銷所有已核發給使用者的有效 OAuth 權杖。
每個預先設定的用戶端應用程式，其用戶端 ID 會顯示在對應的資料列中。您可以複製用戶端 ID，用於用戶端設定，但程式庫應用程式的用戶端 ID 無法變更。
與「BI 連接器」頁面同步
BI 連接器 (包括連結試算表、數據分析、Tableau Desktop、Microsoft Power BI 和 Microsoft Excel) 的啟用狀態，會在「管理 OAuth 用戶端」頁面和「BI 連接器」頁面之間自動同步：
- 在「管理 OAuth 用戶端」頁面變更商業智慧連接器切換鈕的啟用狀態後，「商業智慧連接器」頁面上的對應連接器切換鈕會自動更新。
- 在「BI 連接器」頁面變更 BI 連接器切換鈕的啟用狀態後，「管理 OAuth 用戶端」頁面上的狀態會自動更新。
重新導向 URI 和動態通訊埠設定
Looker 要求 OAuth 重新導向 URI 必須與註冊的值完全相符，且不支援萬用字元重新導向 URI。
- 標準 BI 連接器：使用預先設定、不可變更的重新導向 URI，與服務的官方驗證端點相符。
- AI 代理和 MCP 用戶端：部分 AI 工具在啟動 OAuth 重新導向時，預設會使用動態或臨時本機通訊埠 (例如 Claude Code 或 Cline)。為支援這些工具，Looker 會為每個程式庫用戶端預先註冊固定的預設通訊埠 (例如 Claude Code 和 Cline 的通訊埠
8080，或 Gemini CLI 的通訊埠7777)。
如要使用需要固定通訊埠的預先設定程式庫用戶端，請選擇下列其中一個選項：
- 設定用戶端使用預先註冊的靜態通訊埠：在用戶端應用程式設定或啟動旗標中，指定預先註冊的通訊埠 (例如使用
--callback-port 8080執行 Claude Code)。 - 註冊自訂用戶端：如要使用其他通訊埠或自訂回呼網址，請在「Custom Clients」分頁中，使用偏好的重新導向 URI 註冊新的用戶端。
「Custom Clients」(自訂用戶端) 分頁
在「自訂用戶端」分頁中，您可以註冊及管理自訂 OAuth 2.0 用戶端應用程式，用於內部工具、專屬整合項目，或應用程式庫中未提供的第三方應用程式。
註冊自訂 OAuth 用戶端
如要註冊新的自訂 OAuth 用戶端，請按照下列步驟操作：
- 在「管理面板」中，前往「Authentication」部分，然後選取「Manage OAuth 用戶端」。
- 選取「自訂用戶端」分頁標籤。
- 按一下 [Add New] (新增)。
- 在側邊面板中填寫下列欄位：
- 用戶端 ID：輸入應用程式的專屬字串 ID。用戶端 ID 不得開頭為
com.looker.，這是 Looker 代管應用程式的保留字。 - Client Name：輸入應用程式的描述性顯示名稱。
- 說明 (選填)：輸入簡短說明，解釋應用程式的用途。
- 重新導向 URI：輸入一或多個授權回呼 URI (例如
https://mycompany.com/oauth/callback或http://localhost:8080/callback)。您可以輸入多個重新導向 URI，支援不同環境或通訊埠。 - 「Restrict to Group ID」(僅限群組 ID) (選用)：輸入 Looker 使用者群組的數字 ID。如果指定數字 ID，只有該群組的使用者可以透過這個應用程式，授權及驗證 Looker。
- 用戶端 ID：輸入應用程式的專屬字串 ID。用戶端 ID 不得開頭為
- 按一下「Add」，建立自訂用戶端。
查看客戶詳細資料
如要查看任何自訂用戶端應用程式的詳細資訊，請按照下列步驟操作：
- 在「自訂用戶端」分頁中，按一下表格中用戶端資料列的 形箭號圖示。
- 側邊面板隨即開啟，顯示用戶端名稱、用戶端 ID、說明、授權重新導向 URI 的完整清單，以及群組 ID 限制 (如有設定)。
編輯自訂用戶端
如要更新現有的自訂 OAuth 用戶端應用程式，請按照下列步驟操作：
- 在「Custom Clients」分頁中，找到用戶端應用程式，然後按一下該列的「編輯」圖示 。
在編輯側邊面板中，視需要更新「Client Name」(用戶端名稱)、「Description」(說明)、「Redirect URIs」(重新導向 URI) 或「Restrict to Group ID」(限制為群組 ID) 欄位。
按一下 [Update] (更新)，儲存您所做的變更。
刪除自訂用戶端
如要移除自訂 OAuth 用戶端應用程式，請按照下列步驟操作：
- 在「自訂用戶端」分頁中，找到用戶端應用程式，然後按一下該列的「刪除」 (垃圾桶) 圖示 。
- 在確認對話方塊中點按「刪除」。
權杖撤銷和安全性
為維護連結應用程式的安全性，Looker 會自動強制撤銷權杖。如果管理員在「應用程式庫」或「自訂用戶端」分頁刪除自訂用戶端應用程式，或停用應用程式，Looker 會立即撤銷所有使用者在該應用程式中取得的有效 OAuth 更新權杖。與該應用程式相關聯的所有授權碼都會永久失效。
如果使用者或應用程式嘗試使用已撤銷的憑證連線，Looker 會拒絕授權，並傳回錯誤，指出找不到或未啟用 OAuth 用戶端。