# 设置 Qlik Cloud 访问

在部署到 Qlik Cloud 之前，租户管理员必须启用 API 密钥生成并为用户帐户分配正确的角色。

## 启用 API 密钥访问

执行以下操作：

1. 在“管理”活动中心，转到 管理用户 > 权限。
2. 创建自定义角色（例如，API 密钥管理器）。
3. 展开 功能和操作 > 开发者 并将 管理 API 密钥 设置为 `Allowed`。
4. 保存角色。
5. 前往用户，并将该角色分配给需要 API 访问权限的用户。
6. 如果用户拥有已弃用的开发者角色，请移除该角色。

分配角色后，每个用户都可以生成 API 密钥。

要生成 API 密钥，请前往 个人资料 > API 密钥，然后点击 生成新密钥。复制并安全地存储密钥。密钥仅显示一次。

## 在个人空间中启用应用程序创建

要在个人空间中创建应用程序，需要私人分析内容创建者角色。

执行以下操作：

1. 在管理控制台，转到用户。
2. 将 私有分析内容创建者 角色分配给用户。

当部署到共享空间而非个人空间时，用户必须拥有目标空间上的可编辑权限。

## 内联身份验证

当同时提供 `--qlikTenantUrl` 和 `--qlikApiKey` 时（或等效的 环境 变量 `QV2QS_QLIK_TENANT_URL` 和 `QV2QS_QLIK_API_KEY`），QV2QS 会直接进行身份验证，而无需创建或读取 qlik-cli 上下文文件。API 密钥作为持有者令牌注入到每个 qlik-cli 调用中，并且不写入磁盘。

这种方法推荐用于：

* CI/CD 流水线，其中预先创建上下文会增加一个额外的步骤。
* 多租户自动化，其中多个并发调用针对不同的租户。每个进程都在内存中携带自己的凭据，因此没有共享的上下文文件会发生冲突。
* 合作伙伴集成，它们以编程方式调用 QV2QS，并且每次请求使用不同的凭据。

```
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output ^
  --qlikTenantUrl https://my-tenant.us.qlikcloud.com ^
  --qlikApiKey eyJhbG... ^
  --qsAppName "Sales" --autoBinary --reload --plain
```

信息注释

当同时提供 `--qlikTenantUrl` 和 `--qlikApiKey` 时，`--setupQlikAuth` 标志不是必需的。

## 了解更多

* [身份验证](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/getting-started/authentication.htm)
* [部署到 Qlik Cloud](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/index.htm)
* [空间定位](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/space-targeting.htm)
* [常见工作流 — 编程用法](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/command-line-interface/common-workflows.htm#programmatic-usage-cicd)