Autenticación

Última actualización: 14/10/2026

QV2QS se autentica en Qlik Cloud a través de contextos de qlik-cli. Un contexto es una configuración de autenticación con nombre que almacena una URL de inquilino de Qlik Cloud y una clave de API. QV2QS se envía con qlik-cli integrado en el ejecutable. QV2QS guarda los contextos en su propia ubicación aislada (%LOCALAPPDATA%\QV2QS\qlik-cli\.qlik\contexts.yml), separada de la configuración predeterminada de qlik-cli. Una instalación existente de qlik-cli no se ve afectada.

Métodos de autenticación

La autenticación se puede configurar de tres maneras:

• Configuración interactiva — Ejecute QV2QS.exe --setupQlikAuth. QV2QS enumera cualquier contexto existente, solicita un nombre de contexto (o selección), luego solicita una URL de inquilino y una clave de API. La entrada de la clave API está oculta por seguridad. QV2QS crea o actualiza el contexto y valida la conexión.
• Argumentos de CLI — Pasar --qlikTenantUrl y --qlikApiKey en la línea de comandos. QV2QS se autentica en línea sin crear ni modificar un archivo de contexto. Las credenciales se inyectan directamente en cada llamada a la API y no se escriben en el disco. Este es el método más sencillo para pipelines de CI/CD y conversiones puntuales. Alternativamente, pasa --qlikApiKey solo para actualizar la clave en el contexto activo de qlik-cli.
• Interfaz de usuario — Introduzca la URL del inquilino y la clave de API en el paso de autenticación de Qlik Cloud. El asistente valida la conexión antes de continuar.

Los argumentos de autenticación incluyen --qlikContext, --qlikTenantUrl, --qlikApiKey y --setupQlikAuth. Para ver la lista completa, consulte Referencia de argumentos.

Actualización de una clave de API caducada

Las claves de API de Qlik Cloud caducan después del período configurado por el administrador del inquilino. Para reemplazar una clave caducada, realice una de las siguientes acciones:

• Vuelve a ejecutar QV2QS.exe --setupQlikAuth e introduce la nueva clave de API cuando se te solicite.
• Pase --qlikApiKey <NEW_KEY> en cualquier comando de conversión (sin --qlikTenantUrl). QV2QS actualiza el contexto almacenado automáticamente. Si se proporcionan tanto --qlikTenantUrl como --qlikApiKey, se utiliza la autenticación en línea y no se actualiza ningún contexto.
• Establezca la QV2QS_QLIK_API_KEY variable de entorno a la nueva clave.

Más información

• Configuración del acceso a Qlik Cloud
• Implementación en Qlik Cloud