設定 OAuth 用戶端 ID 中繼資料文件

上次更新：2026/10/9

OAuth Client ID Metadata Documents (CIMD) 可讓相容的用戶端應用程式使用 HTTPS 中繼資料文件 URL 作為 OAuth 用戶端 ID。Qlik Cloud 會在用戶端連線時從該 URL 擷取用戶端中繼資料。

當用戶端同時支援 CIMD 與 OAuth 動態用戶端註冊 (DCR) 時，CIMD 是首選的註冊方式。CIMD 不需要於租用戶中啟用 DCR，且用戶端應用程式會提供自己的中繼資料文件。

先決條件和限制

必要條件：

• 您是 Qlik Cloud 中的租用戶管理員。

• 您的用戶端應用程式支援 CIMD。

CIMD 具有下列限制：

• CIMD 支援 none 和 private_key_jwt 用戶端驗證方法。它不支援 client_secret。

• CIMD 用戶端一律使用 必要 同意。無論發布狀態為何，您都無法將同意方法變更為 受信任。

• CIMD 不支援機器對機器 (M2M) 或服務對服務連線。針對 M2M 整合，請使用手動建立的 Web OAuth 用戶端。

與 CIMD 連線

在支援 CIMD 的用戶端應用程式中啟動連線。用戶端提供其中繼資料文件 URL，而 Qlik Cloud 會從該 URL 擷取中繼資料。

首次連線需要租用戶管理員的核准。接著便會為該租用戶核准此連線，而後續使用者在使用參照相同 CIMD 文件 URL 的應用程式時，即可使用相同的已核准用戶端身分識別進行驗證。每位使用者仍使用自己的 Qlik Cloud 帳戶、角色和權限進行驗證。提供者可以針對不同的應用程式使用不同的中繼資料文件 URL。

CIMD 連線的初始預設範圍為 user_default、mcp:execute 和 offline_access。租用戶管理員可以在核准後編輯允許的範圍。如果您從 CIMD 連線中移除所有範圍，該連線將沒有任何存取權限。它不會退回至初始預設範圍。

如需特定提供者的連線程序，請參閱 連線至 Qlik MCP 伺服器。

管理 CIMD 連線

將現有的 DCR 連線切換至 CIMD 並非就地升級。中斷用戶端應用程式中的現有連線，然後使用 CIMD 重新連線以建立獨立的 CIMD 連線。租用戶管理員必須手動從 OAuth 用戶端清單中刪除舊的 DCR 用戶端。在此之前，這兩筆客戶記錄都會存在。

刪除 CIMD 連線會移除您租用戶的連線設定，並撤銷該用戶端在您租用戶中的權杖。其他租戶使用的共用 CIMD 用戶端不會被刪除。

Qlik Cloud 每 24 小時擷取並驗證 CIMD 中繼資料文件，且僅在文件有變更時更新儲存的中繼資料。

此註冊方法是以持續演進的 OAuth 標準為基礎，因此您用戶端應用程式中的設定詳細資料可能會隨時間變更。

如需中繼資料文件結構描述與通訊協定的相關資訊，請參閱 Qlik 開發人員入口網站上的 OAuth 用戶端 ID 中繼資料文件。

識別 CIMD 用戶端

在 管理 活動中心中，OAuth 用戶端清單會識別 Source 值為 CIMD 的 CIMD 用戶端。如需 createdByType 值的 API 詳細資訊，以及 來源 和 用戶端類型 之間的差異，請參閱 管理來自廠商的多重註冊。