# 驗證

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-TW/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-TW/migration/Content/Qv2qsMigration/getting-started/setting-up-qlik-cloud-access.htm)
* [部署至 Qlik Cloud](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/index.htm)