建立並管理 OAuth 用戶端
上次更新:2026-11-10OAuth 是用於授權和委派的安全性通訊協定。這允許第三方應用程式存取 API 資源,不必揭露最終使用者認證。OAuth 用戶端可請求授權代碼、交換以獲得存取 Token,並使用 Token 以透過 API 存取 Qlik Cloud 內容。
OAuth 用戶端類型
OAuth 用戶端是 Web 應用程式或軟體,這代表使用者請求存取 Qlik Cloud 中的資源。OAuth 定義兩個用戶端類型:公用用戶端和機密用戶端,以保護應用程式 (用戶端) 和授權伺服器 (Qlik Cloud) 之間的授權。
Qlik Cloud 支援傳統 Web (伺服器端) 應用程式的機密用戶端,和適合使用特定授權流程之原生和單頁應用程式的公用用戶端。
關於客戶端類型的官方 OAuth 2.0 規範,請參閱RFC 6749 第 2.1 節:OAuth 2.0 用戶端類型
公用用戶端
公用用戶端是不使用用戶端密碼的應用程式,因為這不會維護所需認證的機密性。在 Qlik Cloud 中,這些包括前端應用程式,例如具有內嵌分析或需要使用者驗證之 Qlik Sense 中的自訂視覺化延伸的單頁應用程式 (SPA)。
機密用戶端
機密用戶端可以安全地儲存用戶端 ID 和用戶端密碼,並用來透過授權伺服器進行驗證。這些用戶端可以存取受保護的資源,因為他們擁有用戶端密碼。
範例:Web 應用程式,與 Qlik Cloud API 有安全後端互動,以管理使用者存取權限或安排資料重新整理任務。
OAuth 授權流程
Qlik 支援兩種授權流程 (授予類型):
-
授權代碼流程:適用於機密用戶端。
-
使用證明金鑰進行代碼交換 (PKCE) 的授權代碼流程:適用於公用用戶端。
授權代碼流程
此流程由未公開原始程式碼的伺服器端應用程式使用。這涉及使用授權代碼交換存取 Token,並使用用戶端密碼進行驗證。使用此流程的 Web 應用程式必須是伺服器端,因為用戶端密碼會在 Token 交換期間傳遞至授權伺服器。
如需更多關於授權碼流程的資訊,請參閱官方 OAuth 2.0 文件:授權碼流程
使用 PKCE 的授權代碼流程
原生和單頁應用程式無法安全地儲存用戶端密碼,因為其原始程式碼可以在瀏覽器中反向組譯或檢查。PKCE 要求使用代碼驗證器取得存取 Token,藉此增強安全性。
如需更多關於使用 PKCE 進行授權的資訊,請參閱官方 OAuth 2.0 文件:搭配程式碼交換證明金鑰 (PKCE) 的授權碼流程
OAuth 範圍和權限
OAuth 範圍定義授予 OAuth 用戶端應用程式的存取層級。例如,存取 Token 可以允許完整存取資源或將其限制為唯讀存取。在 Qlik Cloud 中,範圍可控制用戶端對於可用功能和資源的存取權限。如果沒有範圍,用戶端就無法存取任何資源。
API 憑證提供對 Qlik Cloud 的直接程式設計存取,且不限於使用者介面中可用的工作流程。請使用最低權限原則來指派角色與 OAuth 範圍。處理服務帳戶與 API 憑證時,應採取與管理員憑證相同等級的謹慎態度。如需詳細資訊,請參閱 API 存取控制與信任邊界。
可用的 OAuth 範圍
下表列出了可用的範圍及其相關權限:
建立 OAuth 用戶端
租用戶管理員可在 OAuth 頁面上的 管理 活動中心管理 OAuth 用戶端。透過 OAuth 用戶端,您可以整合用戶端應用程式與 Qlik Cloud 以便安全存取資源。
OAuth 用戶端設定方法
您可以透過下列其中一種方式設定 OAuth 用戶端:
-
手動用戶端設定 (靜態註冊):直接在您的租用戶中建立並維護用戶端定義。當您想在設定期間完全控制用戶端設定時,請使用此方法。
-
動態用戶端註冊 (DCR):允許相容的應用程式根據租用戶層級的 DCR 設定,動態註冊 OAuth 用戶端。詳情請參閱 設定 OAuth 動態用戶端註冊。
OAuth 用戶端限制
適用以下限制:
-
每個用戶端最多 5 個重新導向 URL。
-
每個用戶端最多允許 5 個來源。
-
每個用戶端最多有 5 個用戶端密碼。
-
每個租用戶最多有 200 個 OAuth 用戶端。
建立 OAuth 用戶端的步驟
請執行下列動作:
-
在 管理 活動中心內,前往 OAuth。
-
按一下新建。
-
選取用戶端類型:
-
Web 適用於機密用戶端。
-
單頁應用程式或原生適用於公用用戶端。
-
匿名內嵌適用於公用用戶端。
-
-
在對話方塊中,輸入 OAuth 用戶端的名稱。
-
也可以選擇新增說明。
-
選擇要授予 OAuth 用戶端的權限。瀏覽清單或使用搜尋欄位來尋找權限。
提示備註使用 所有 和 已變更 按鈕,以檢視所有權限,或僅檢視已變更的權限。 -
為 OAuth 用戶端應用程式輸入一個或多個重新導向 URL (最多 5 個)。然後按一下新增以將重新導向 URL 新增至允許清單。
-
重新導向 URL 可在驗證並授予權限後,讓授權伺服器將使用者的瀏覽器傳送至用戶端應用程式。例如,https://www.exampleapp.com/oauth/callback,其中 /oauth/callback 處理來自 OAuth 提供者的驗證回撥。
-
只有在 URL 屬於重新導向 URL 的允許清單時,Qlik Cloud 才會在成功授權之後,將使用者重新導向回到應用程式。
-
URL 必須以 https:// 開頭,除非網域為 localhost,在此情況下,可以使用 http:// 為開頭。原生應用程式也可以使用應用程式特定連結格式,例如 exampleapp://。
-
-
對於 Web 或單頁應用程式用戶端類型,請指定一個或多個允許的來源 (最多 5 個)。
-
只有在 URL 新增至允許的來源清單時,才會授予應用程式的存取權限。
-
-
對於 Web 用戶端類型,您可以啟用以下選項之一,以實現無需使用者互動的自動化系統存取:
-
允許機器對機器 (M2M):無需使用者參與即可實現系統到系統的通訊。
-
允許 M2M 使用者模擬:允許您的應用程式代表使用者進行驗證,並在驗證過程中以他們的身分行事。
-
-
對於用戶端類型Web,請在驗證方法下選取一個或兩個選項:
-
用戶端密碼 (預設)
-
私密金鑰 JWT,一個更安全的選項,可使用公私密鑰對驗證用戶端而非共用密碼。
-
當您選取私密金鑰 JWT時,公開金鑰欄位會出現。輸入您的第三方應用程式的公開金鑰,格式為 JSON Web Key (JWK)。私密金鑰會留在您的應用程式中,以簽署 JWT。如需更多關於公開金鑰格式的資訊,請參閱Qlik 開發人員入口網站上的 建立用於簽署 JWT 的公開/私密金鑰組。
資訊備註公開金鑰取決於您的識別提供者的要求。如果您的第三方應用程式的公開金鑰是不同的格式,請使用第三方工具將其轉換為 JWK。
-
-
-
按一下建立。
-
按一下複製到剪貼簿以儲存用戶端 ID 和用戶端密碼以供之後使用。安全儲存用戶端密碼。
資訊備註公用用戶端沒有用戶端密碼。 -
按一下完成。
管理 OAuth 用戶端
有些廠商會動態註冊多個 OAuth 用戶端,每個使用者各一個。Qlik 建議使用 OAuth 用戶端 ID 中繼資料文件 (CIMD) 以減少多次註冊。有關此行為的詳情,請參閱 管理來自供應商的多筆註冊。
識別 DCR 和 CIMD 用戶
DCR 和 CIMD 用戶與手動建立的用戶有以下幾種區分方式:
-
在 管理 中,OAuth 用戶端清單會顯示 來源 欄。DCR 用戶的來源值為 DCR,CIMD 用戶的來源值為 CIMD,而手動建立的用戶的來源值為 User。
-
API 回應包含一個 createdByType 欄位,其值設定為 dcr (適用於 DCR 用戶端)、cimd (適用於 CIMD 用戶端),以及 user (適用於手動建立的用戶端)。
-
對於 CIMD 客戶,客戶 ID 是由 LLM 客戶提供的中繼資料文件 URL。
來源 說明 OAuth 用戶端是如何註冊的。用戶端類型 顯示 OAuth 用戶端模型,例如 原生 或 網頁。例如,Claude 顯示為 原生,這是一個公開用戶端,而 ChatGPT 顯示為 網路,這是一個機密用戶端。公開和機密描述應用程式如何驗證自身。他們沒有說明使用者資料是公開還是機密,而且使用者仍然使用自己的帳戶登入。
特定使用情況下的 OAuth 用戶端
對於 OAuth 用戶端使用情況,請參考下列資源:
-
Qlik 開發人員入口網站上的 OAuth 概述:OAuth 使用案例和不同 OAuth 類型的概述。
-
設定 OAuth 動態用戶端註冊: 配置租用戶層級設定,用於 OAuth 動態用戶端註冊。
-
設定 OAuth 用戶端 ID 中繼資料文件: 設定並管理 CIMD 連線。
-
為 Microsoft Office 建立 Qlik 增益集的 OAuth 用戶端:設定 OAuth 用戶端以安裝 Qlik 的 Microsoft Excel 增益集。
-
為應用程式內容的匿名內嵌建立 OAuth 用戶端:建立 OAuth 用戶端以啟用對內嵌應用程式內容的匿名存取。
-
Qlik 程式碼 租用戶管理員核准 (OAuth 同意):對於使用適用於 Visual Studio Code 的 Qlik 程式碼 延伸的組織,租用戶管理員必須提供 OAuth 同意,之後 OAuth 用戶端會自動顯示在 管理 活動中心中,其他使用者即可透過該延伸登入租用戶。
為 Microsoft Office 建立 Qlik 增益集的 OAuth 用戶端
需要 OAuth 用戶端設定才能安裝 Microsoft Office 的 Qlik 增益集。增益集由報告開發人員用來準備 報告範本,以便搭配 Qlik Cloud 進行應用程式內報告。
為了讓 OAuth 在增益集運作,需要使用以下所示的確切設定來設定 OAuth 用戶端。
請執行下列動作:
-
在Qlik Cloud中,按一下左上角的
。
-
選取 管理。
-
前往 OAuth。
-
按一下新建。
-
在用戶端類型下拉式功能表中,選取單頁應用程式。將會顯示更多欄位。
-
插入名稱。描述為選填。
-
至少應選取核取方塊,以納入 user_default 範圍。您可以在設定中納入其他範圍,但沒有 user_default,安裝將無法運作。
請參閱 可用的 OAuth 範圍 瞭解每個可用範圍的完整描述。
-
在新增重新導向 URL 欄位中,插入 Qlik Cloud 租用戶的 URL,接著插入此固定字串:/office-add-ins/oAuthLoginSuccess.html
結果應如下所示:https://<tenant or alias hostname>.<region>.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html。例如:http://example-company-123.us.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html
-
按一下新增。
-
在新增允許來源欄位中,插入租用戶 URL,並按一下新增。
-
按一下建立。
-
就會顯示複製用戶端 ID 視窗。您可以選擇將用戶端 ID 複製到剪貼簿,或按一下完成以關閉視窗。
建立 OAuth 用戶端後,從 XML 活動中心取得更新後的資訊清單 管理 連結。前往 設定 頁面,並選取 電子郵件與報告 索引標籤。在 Qlik 適用於 Microsoft Office 的增益集 區段中,取得可用來部署和安裝增益集的連結。
如需更多關於產生資訊清單檔案以及部署並安裝增益集的資訊,請參閱:
為應用程式內容的匿名內嵌建立 OAuth 用戶端
若要使用 qlik-embed 內嵌應用程式內容以進行匿名存取,您需要建立專門為此使用情況設計之類型的 OAuth 用戶端。
請執行下列動作:
-
在 管理 活動中心內,前往 OAuth 區段。
-
按一下新建。
-
在用戶端類型下拉式功能表中,選取匿名內嵌。
-
輸入 OAuth 用戶端的名稱和描述 (選填)。
-
在允許的來源之下,輸入您需要授權的每個來源。這些網域將存取 Qlik Cloud 租用戶,以擷取內嵌分析的資訊。
插入每個 URL 後,按一下新增。
-
完成後,按一下建立。
-
按一下複製到剪貼簿以儲存用戶端 ID 以供之後使用。應用程式內容透過 qlik-embed 內嵌時將會需要。
-
按一下完成。
編輯 OAuth 用戶端
您可以重新命名 OAuth 用戶端、更新說明或管理重新導向 URL。
請執行下列動作:
- 在 管理 活動中心內,前往 OAuth。
- 找到您要編輯的 OAuth 用戶端。
- 按一下
然後選取編輯。
- 按需要修改 OAuth 用戶端選項。
- 按一下儲存。
刪除 OAuth 用戶端
若您不再需要 OAuth 用戶端或要撤銷存取權限,可以刪除 OAuth 用戶端。
如果您的租用戶有許多 OAuth 用戶端,請在 OAuth 用戶端清單中使用篩選功能,以依廠商或命名模式尋找用戶端,選取相符的用戶端,並大量刪除它們。
請執行下列動作:
-
在 管理 活動中心內,前往 OAuth。
-
選取您要移除的一個或多個 OAuth 用戶端,然後按一下刪除。
- 確認刪除。
發佈 OAuth 用戶端
OAuth 用戶端最初會繫結至建立這些 OAuth 用戶端的租用戶。但是,您可以設定一個 OAuth 用戶端,以供相同區域內的多個租用戶共用。這讓第三方應用程式可以在不同的 Qlik Cloud 租用戶中使用相同的用戶端 ID。
應用程式擁有者可以輪換密碼並更新設定而沒有透過租用戶管理員互動。租用戶管理員不需要管理認證或瞭解已發佈用戶端的任何設定詳細資訊。
若要允許其他租用戶連線至 OAuth 用戶端,您必須發佈。
請執行下列動作:
- 在 管理 活動中心內,前往 OAuth。
- 找到您要發佈的 OAuth 用戶端。
- 按一下用戶端旁邊的
然後選取發佈。
- 按一下發佈以確認。
一旦發佈了 OAuth 用戶端,其他租用戶就可供外部使用。使用者造訪使用此 OAuth 用戶端的外部網站時,會向他們提示輸入租用戶主機名稱和使用者認證,除非使用者已經有作用中的 SaaS 工作階段。
初始登入需要租用戶管理員的同意。一旦獲得核准,OAuth 用戶端就會出現在租用戶的 管理 活動中心。
同意方法
預設情況下,Qlik Cloud 在驗證時會提示使用者同意。若要簡化流程,尤其是對於受信任的應用程式,您可以將同意方法設為「受信任」,即可略過同意提示。
您有兩個同意選項:
-
必需:OAuth 用戶端每次要求新的範圍時會向使用者提示同意。此方法可確保每個存取層級都有明確的使用者核准。
-
受信任:不會向使用者提示同意。此選項僅適用於未發佈的用戶端。對於已發佈的用戶端,同意方法永遠是必需,以維護多個租用戶的安全性。
變更同意方法
若要變更 OAuth 用戶端的同意方法,請執行下列操作:
- 在 管理 活動中心內,前往 OAuth。
- 在 OAuth 用戶端上,按一下
並選取變更同意方法。
- 選取必需或受信任,然後按一下變更同意方法。
檢視並複製 OAuth 設定
在 管理 活動中心的 OAuth 區段,選取檢視 OAuth 設定以顯示 Qlik Cloud 租用戶的驗證詳細資訊。這將顯示包含 OAuth 端點和設定的程式碼片段,以及您可以複製以用於外部應用程式的 URL。
您可以使用此設定來整合 Qlik Cloud 與第三方應用程式、自動化 API 存取或設定內嵌分析的驗證。
管理用戶端密碼
如果用戶端密碼外洩或您的安全性政策要求定期更新,則可能需要新增或移除密碼。為了避免停機,您可以新增多個用戶端密碼 (最多 5 個)、更新用戶端應用程式,然後移除舊密碼。
新增用戶端密碼
請執行下列動作:
- 在 管理 活動中心內,前往 OAuth。
- 找到 OAuth 用戶端。
- 按一下
然後選取管理密碼。
- 按一下產生新的用戶端密碼。
-
複製用戶端密碼和用戶端 ID,並安全儲存。
資訊備註您之後無法存取用戶端密碼。 - 按一下關閉。
移除用戶端密碼
請執行下列動作:
- 在 管理 活動中心內,前往 OAuth。
- 找到 OAuth 用戶端。
- 按一下
然後選取管理密碼。
- 按一下用戶端密碼旁邊的
。
- 按一下關閉。
更多關於 OAuth 用戶端
Next steps: Building OAuth client applications
在 Qlik Cloud 註冊 OAuth 用戶端後,您可以建置 OAuth 用戶端應用程式以存取 Qlik Cloud 內容。在您的應用程式中使用相關聯的用戶端 ID 和用戶端密碼。
如需逐步指導,請參閱 Qlik 開發人員入口網站的 OAuth 概述區段中的教學課程。這些教學課程介紹如何使用熱門的程式化語言建立用戶端應用程式。
全組織的 OAuth 用戶端
除了租用戶專屬的 OAuth 用戶端之外,您還可以使用全組織的 OAuth 用戶端。身為服務帳戶擁有者 (SAO),您可以建立及管理這些用戶端。全組織的 OAuth 用戶端可提供存取您訂閱中所有租用戶的租用戶資訊。
如需詳細資訊,請參閱 在 My Qlik 中管理 OAuth 用戶端。