身份验证
上次更新日期：2026/10/14QV2QS 通过 qlik-cli 上下文认证到 Qlik Cloud。上下文是一种命名的身份验证配置，用于存储一个 Qlik Cloud 租户 URL 和一个 API 密钥。QV2QS 随附的可执行文件内置了 qlik-cli。QV2QS 将上下文存储在其独立的 位置 (%LOCALAPPDATA%\QV2QS\qlik-cli\.qlik\contexts.yml)，与默认的 qlik-cli 配置分开。现有的 qlik-cli 安装不受影响。
身份验证方法
身份验证可以通过三种方式设置：
- 交互式设置 — 运行
QV2QS.exe --setupQlikAuth。QV2QS 列出任何现有上下文，提示输入上下文名称（或选择），然后提示输入租户 URL 和 API 密钥。出于安全考虑，API 密钥输入已隐藏。QV2QS 创建或更新上下文并验证连接。 - CLI 参数 — 在命令行上传递
--qlikTenantUrl和--qlikApiKey。QV2QS 内联认证，无需创建或修改上下文文件。凭据直接注入到每个 API 调用中，并且不写入磁盘。这是 CI/CD 流水线和一次性转换最简单的方法。另外，仅传递--qlikApiKey以更新激活的 qlik-cli 上下文中的密钥。 - 用户界面 — 在 Qlik Cloud 身份验证 步骤中输入租户 URL 和 API 密钥。向导在继续之前验证连接。
身份验证参数包括--qlikContext、--qlikTenantUrl、--qlikApiKey和--setupQlikAuth。有关完整列表，请参阅参数参考。
更新已过期的 API 密钥
Qlik Cloud API 密钥会在租户管理员配置的期限后过期。要替换已过期的密钥，请执行以下操作之一：
- 重新运行
QV2QS.exe --setupQlikAuth并在提示时输入新的 API 密钥。 - 在任何转换命令上，传入
--qlikApiKey <NEW_KEY>(不带--qlikTenantUrl)。QV2QS 自动更新存储的上下文。如果同时提供了--qlikTenantUrl和--qlikApiKey，则使用内联身份验证，并且不会更新任何上下文。 - 将
QV2QS_QLIK_API_KEY环境变量设置为新密钥。