# 認証

QV2QS は qlik-cli コンテキストを介して Qlik Cloud に認証します。コンテキストとは、Qlik Cloud テナント URL および API キーを格納する名前付き認証構成です。QV2QS には、qlik-cli が実行可能ファイルにバンドルされて同梱されています。QV2QS は、デフォルトの qlik-cli 設定とは別に、独自の隔離された場所 (`%LOCALAPPDATA%\QV2QS\qlik-cli\.qlik\contexts.yml`) にコンテキストを格納します。既存のqlik-cliインストールは影響を受けません。

## 認証方法

認証は3つの方法で設定できます。

* 対話型セットアップ — 実行します。`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/ja-JP/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/ja-JP/migration/Content/Qv2qsMigration/getting-started/setting-up-qlik-cloud-access.htm)
* [Qlik Cloud へのデプロイ](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/index.htm)