認証
最終更新日時: 2026/10/14QV2QS は 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が含まれます。完全なリストについては、引数リファレンスを参照してください。
期限切れのAPIキーを更新する
Qlik Cloud API キーは、テナント管理者が設定した期間が経過すると有効期限が切れます。期限切れのキーを交換するには、次のいずれかを実行します。
QV2QS.exe --setupQlikAuthを再実行し、求められたら新しいAPIキーを入力してください。- 任意の変換コマンドで
--qlikApiKey <NEW_KEY>を渡す（--qlikTenantUrlなし）。QV2QS は格納されたコンテキストを自動的に更新します。両方の--qlikTenantUrlと--qlikApiKeyが指定されている場合、インライン認証が使用され、コンテキストは更新されません。 - 新しいキーに
QV2QS_QLIK_API_KEY環境変数を設定します。