Authentifizierung

Letzte Aktualisierung: 14.10.2026

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.

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
• Bereitstellen in Qlik Cloud