# 設定 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 金鑰會以 Bearer Token 的形式注入到每個 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-TW/migration/Content/Qv2qsMigration/getting-started/authentication.htm)
* [部署至 Qlik Cloud](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/index.htm)
* [空間目標鎖定](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/space-targeting.htm)
* [常見工作流程 — 程式化使用](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/command-line-interface/common-workflows.htm#programmatic-usage-cicd)