# Authentifizierung

QV2QS authentifiziert sich bei Qlik Cloud über qlik-cli-Kontexte. Ein Kontext ist eine benannte Authentifizierungskonfiguration, die eine Qlik Cloud Mandanten-URL und einen API-Schlüssel speichert. QV2QS wird mit qlik-cli ausgeliefert, das in der ausführbaren Datei gebündelt ist. QV2QS speichert Kontexte an einem eigenen isolierten Standort (`%LOCALAPPDATA%\QV2QS\qlik-cli\.qlik\contexts.yml`), getrennt von der Standardkonfiguration von qlik-cli. Eine bestehende qlik-cli-Installation ist nicht betroffen.

## Authentifizierungsmethoden

Die Authentifizierung kann auf drei Arten eingerichtet werden:

* Interaktive Einrichtung — Ausführen `QV2QS.exe --setupQlikAuth`. QV2QS listet alle vorhandenen Kontexte auf, fordert zur Eingabe eines Kontextnamens (oder zur Auswahl) auf und fordert dann eine Mandanten-URL und einen API-Schlüssel an. Die API-Schlüssel-Eingabe ist aus Sicherheitsgründen ausgeblendet. QV2QS erstellt oder aktualisiert den Kontext und validiert die Verbindung.
* CLI-Argumente — Übergeben Sie `--qlikTenantUrl` und `--qlikApiKey` in der Befehlszeile. QV2QS authentifiziert Inline, ohne eine Kontextdatei zu erstellen oder zu ändern. Zugangsdaten werden direkt in jeden API-Aufruf injiziert und nicht auf die Festplatte geschrieben. Dies ist die einfachste Methode für CI/CD-Pipelines und einmalige Konvertierungen. Alternativ übergeben Sie `--qlikApiKey` allein, um den Schlüssel im aktiven qlik-cli-Kontext zu aktualisieren.
* Benutzeroberfläche — Geben Sie die Mandanten-URL und den API-Schlüssel im Schritt Qlik Cloud Authentifizierung ein. Der Assistent validiert die Verbindung, bevor er fortfährt.

Authentifizierungsargumente umfassen `--qlikContext`, `--qlikTenantUrl`, `--qlikApiKey` und `--setupQlikAuth`. Die vollständige Liste finden Sie unter [Argumentreferenz](https://help.qlik.com/de-DE/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm).

## Aktualisieren eines abgelaufenen API-Schlüssels

Qlik Cloud API-Schlüssel laufen nach dem vom Mandantenadministrator konfigurierten Zeitraum ab. Um einen abgelaufenen Schlüssel zu ersetzen, führen Sie einen der folgenden Schritte aus:

* Führen Sie `QV2QS.exe --setupQlikAuth` erneut aus und geben Sie den neuen API-Schlüssel ein, wenn Sie dazu aufgefordert werden.
* Übergeben Sie `--qlikApiKey <NEW_KEY>` bei jedem Konvertierungsbefehl (ohne `--qlikTenantUrl`). QV2QS aktualisiert den gespeicherten Kontext automatisch. Wenn sowohl `--qlikTenantUrl` als auch `--qlikApiKey` bereitgestellt werden, wird die Inline-Authentifizierung verwendet und kein Kontext aktualisiert.
* Setzen Sie die `QV2QS_QLIK_API_KEY` Umgebungsvariable auf den neuen Schlüssel.

## Mehr erfahren

* [Einrichtung des Qlik Cloud-Zugriffs](https://help.qlik.com/de-DE/migration/Content/Qv2qsMigration/getting-started/setting-up-qlik-cloud-access.htm)
* [Bereitstellen in Qlik Cloud](https://help.qlik.com/de-DE/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/index.htm)