# 身份验证

QV2QS 通过 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`。有关完整列表，请参阅[参数参考](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm)。

## 更新已过期的 API 密钥

Qlik Cloud API 密钥会在租户管理员配置的期限后过期。要替换已过期的密钥，请执行以下操作之一：

* 重新运行 `QV2QS.exe --setupQlikAuth` 并在提示时输入新的 API 密钥。
* 在任何转换命令上，传入 `--qlikApiKey <NEW_KEY>` (不带 `--qlikTenantUrl`)。QV2QS 自动更新存储的上下文。如果同时提供了`--qlikTenantUrl`和`--qlikApiKey`，则使用内联身份验证，并且不会更新任何上下文。
* 将 `QV2QS_QLIK_API_KEY` 环境变量设置为新密钥。

## 了解更多

* [设置 Qlik Cloud 访问](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/getting-started/setting-up-qlik-cloud-access.htm)
* [部署到 Qlik Cloud](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/index.htm)