# Проверка подлинности

QV2QS аутентифицируется в Qlik Cloud через контексты qlik-cli. Контекст — это именованная конфигурация аутентификации, которая хранит URL-адрес клиента Qlik Cloud и ключ 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.
* Пользовательский интерфейс — Введите URL-адрес клиента и ключ API на шаге аутентификации Qlik Cloud. Мастер проверяет подключение, прежде чем продолжить.

Аргументы аутентификации включают `--qlikContext`, `--qlikTenantUrl`, `--qlikApiKey`, и `--setupQlikAuth`. Полный список см. в [Справочнике аргументов](https://help.qlik.com/ru-RU/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm).

## Обновление истекшего ключа API

Ключи API Qlik Cloud истекают по истечении срока, настроенного администратором клиента. Чтобы заменить просроченный ключ, выполните одно из следующих действий:

* Перезапустите `QV2QS.exe --setupQlikAuth` и введите новый ключ API при появлении запроса.
* Передайте `--qlikApiKey <NEW_KEY>` в любой команде преобразования (без `--qlikTenantUrl`). QV2QS обновляет сохраненный контекст автоматически. Если предоставлены как `--qlikTenantUrl`, так и `--qlikApiKey`, используется встроенная аутентификация, и контекст не обновляется.
* Установите `QV2QS_QLIK_API_KEY` переменную среды новым ключом.

## Узнать больше

* [Настройка доступа к Qlik Cloud](https://help.qlik.com/ru-RU/migration/Content/Qv2qsMigration/getting-started/setting-up-qlik-cloud-access.htm)
* [Развертывание в Qlik Cloud](https://help.qlik.com/ru-RU/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/index.htm)