# 配置 OAuth 客户端 ID 元数据文档

OAuth 客户端 ID 元数据文档 (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-CN/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 客户端

在 Administration 活动中心中，OAuth 客户端列表以 Source 值为 `CIMD` 标识 CIMD 客户端。有关 `createdByType` 值的 API 详细信息以及 来源 与 客户端类型 之间的区别，请参阅 [管理来自供应商的多个注册](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/oauth-dynamic-client-registration.htm#ManagingVendors)。