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

上次更新日期：2026/10/9

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 服务器。

管理 CIMD 连接

将现有 DCR 连接切换为 CIMD 不是就地升级。断开客户端应用程序中的现有连接，然后使用 CIMD 重新连接以创建单独的 CIMD 连接。租户管理员必须从 OAuth 客户端列表中手动删除旧的 DCR 客户端。在此之前，这两条客户记录都存在。

删除 CIMD 连接会移除您租户的连接配置，并撤销该客户端在您租户中的令牌。其他租户使用的共享 CIMD 客户端未被删除。

Qlik Cloud 每 24 小时获取并验证一次 CIMD 元数据文档，并且仅当文档发生更改时才更新存储的元数据。

此注册方法基于不断演进的 OAuth 标准，因此客户端应用程序中的设置详细信息可能会随时间发生变化。

有关元数据文档模式和协议的信息，请参阅 Qlik 开发者门户上的 OAuth 客户端 ID 元数据文档。

识别 CIMD 客户端

在 Administration 活动中心中，OAuth 客户端列表以 Source 值为 CIMD 标识 CIMD 客户端。有关 createdByType 值的 API 详细信息以及 来源 与 客户端类型 之间的区别，请参阅 管理来自供应商的多个注册。