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

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 伺服器](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/QlikMCP/Connecting-Qlik-MCP-server.htm)。

## 管理 CIMD 連線

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

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

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

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

如需中繼資料文件結構描述與通訊協定的相關資訊，請參閱 Qlik 開發人員入口網站上的 [OAuth 用戶端 ID 中繼資料文件](https://qlik.dev/authenticate/oauth/oauth-client-id-metadata-documents/)。

## 識別 CIMD 用戶端

在 管理 活動中心中，OAuth 用戶端清單會識別 Source 值為 `CIMD` 的 CIMD 用戶端。如需 `createdByType` 值的 API 詳細資訊，以及 來源 和 用戶端類型 之間的差異，請參閱 [管理來自廠商的多重註冊](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/oauth-dynamic-client-registration.htm#ManagingVendors)。