En esta página

Uso seguro de las herramientas de desarrollo de Qt

Consejos para ejecutar las herramientas de desarrollo de Qt de forma segura.

Descripción general

El marco Qt incluye un completo conjunto de herramientas para desarrollar aplicaciones Qt: interfaces de usuario para el sistema de compilación, como qmake y qt-cmake; compiladores y generadores, como Meta-Object Compiler (moc), User Interface Compiler (uic), Resource Compiler (rcc), Qt Shader Baker (qsb), y los generadores de código para descripciones de interfaces, como el compilador de «Qt Remote Objects » (repc) o el compilador XML de «Qt D-Bus » (qdbusxml2cpp); herramientas de QML como qmllint y el compilador de tipos de QML; importadores de recursos; y herramientas de implementación como windeployqt, macdeployqt y androiddeployqt. Para ver la lista completa, consulta Herramientas y utilidades.

La mayoría de las herramientas son herramientas de línea de comandos que convierten archivos de entrada en archivos de salida, y se ejecutan como parte del sistema de compilación de un proyecto. Otras herramientas se ejecutan en segundo plano, por ejemplo, para proporcionar autocompletado de código o comprobación de sintaxis en un IDE.

Esta página explica el modelo de seguridad de las herramientas de desarrollo proporcionadas y cómo utilizarlas de forma segura. Forma parte del Modelo de Seguridad Compartida de Qt, que describe cómo se reparten las responsabilidades de seguridad entre los desarrolladores de aplicaciones, Qt y los operadores o fabricantes de dispositivos.

Modelo de seguridad de las herramientas para desarrolladores

Las herramientas están diseñadas para procesar de forma eficiente archivos de entrada complejos. Aunque comprueban la validez general de los datos de entrada, no están diseñadas para protegerse contra entradas creadas con fines maliciosos ni para gestionarlas. Por lo tanto, se da por supuesto que los datos de entrada son fiables.

En lo que respecta al Modelo de Seguridad Compartida de Qt, las herramientas de desarrollo y los proyectos que procesan se encuentran claramente dentro del ámbito de responsabilidad del desarrollador. Qt es responsable de la integridad de las herramientas que distribuye; tú eres responsable únicamente de proporcionarles entradas en las que confíes.

Por qué es importante

Dado que las herramientas actúan sobre los datos de entrada sin considerarlos hostiles, un proyecto malicioso o mal formado puede causar daños durante el desarrollo, la configuración o la compilación, incluso antes de que se ejecute la aplicación resultante.

En concreto, las herramientas:

  • Leen archivos. El sistema de compilación puede leer archivos que se encuentren fuera del directorio del proyecto, ya sea a través de rutas absolutas o relativas (recorrido de rutas).
  • Escriben archivos. Las rutas de salida se derivan de los datos de entrada. Esto puede provocar que se escriban archivos fuera del directorio de salida previsto o que se sobrescriban archivos existentes.
  • Invocan procesos externos. Los front-ends de compilación y algunos generadores ejecutan compiladores, scripts u otros ejecutables. Una entrada no fiable puede influir en qué programas se ejecutan y con qué argumentos.
  • Generar código que posteriormente se compila y se ejecuta. Muchas herramientas generan código C++, QML u otros fuentes que pasan a formar parte de tu aplicación. Una entrada manipulada puede influir en el resultado generado y, por lo tanto, en el código que finalmente acaba en la aplicación Qt o en el dispositivo.

La consecuencia práctica es que compilar un proyecto no fiable puede dar lugar a la ejecución de código arbitrario en su máquina de compilación, con sus privilegios y con acceso a todo lo que contenga ese entorno, como credenciales, claves de firma o código fuente. Esto puede exponer sus datos privados, comprometer su máquina y, en última instancia, comprometer la aplicación o el dispositivo que está compilando y, por lo tanto, a todos sus usuarios.

Este riesgo no se debe únicamente a las herramientas de Qt. Al configurar un proyecto con CMake, un popular sistema de compilación para C++, permites que el proyecto ejecute programas locales en rutas arbitrarias (execute_process()) o que recupere recursos de red sin comprobaciones adicionales (móduloFetchContent ). Esta es también la razón por la que los IDE a veces muestran advertencias antes de configurar proyectos; véase, por ejemplo, «Workspace Trust» de Visual Studio Code.

Recomendaciones

  • Abre y compila únicamente proyectos en los que confíes. No configures ni compiles proyectos procedentes de una fuente desconocida o en la que no confíes, del mismo modo que no ejecutarías scripts de origen desconocido.
  • Aísla las compilaciones no fiables. Si debes trabajar con un proyecto en el que no confías plenamente, hazlo en un entorno aislado, como un contenedor o una máquina virtual. Ejecuta la compilación con privilegios mínimos y sin acceso a secretos, credenciales o claves de firma.
  • Limita el acceso a la red durante la compilación. Intenta que las compilaciones sean totalmente locales. Si un proyecto necesita acceder a un recurso remoto para compilarse, esto no solo puede causar problemas de disponibilidad —como que tu máquina de compilación quede bloqueada por el servidor remoto si lo satura con solicitudes—, sino que también constituye otro vector de ataque que puede comprometer el entorno de compilación y el resultado de la misma.
  • Obtén Qt de una fuente de confianza. Instala Qt y sus herramientas únicamente a través de canales oficiales, y manténlas actualizadas para recibir las correcciones de seguridad. Consulta Seguridad en Qt.
  • Mantén la fiabilidad del entorno de compilación. Asegúrate de que, por ejemplo, los directorios de tu ` PATH ` y las herramientas a las que apuntan sean fiables, de modo que las herramientas de desarrollo no ejecuten archivos ejecutables inesperados.

Ámbito

Esta página trata sobre las herramientas de desarrollo en tiempo de compilación que se ejecutan en su propio equipo. El marco Qt también incluye herramientas con diferentes modelos de amenaza:

  • Herramientas orientadas al usuario que este puede instalar y ejecutar en un sistema de usuario final, como Qt Linguist, Qt Widgets Designer y Qt Assistant. Consulte las páginas del manual correspondientes para obtener orientación sobre seguridad en relación con dichas herramientas.
  • Herramientas auxiliares que se inician de forma indirecta mediante bibliotecas u otras herramientas. Dado que tanto la herramienta como su mecanismo de inicio forman parte de la superficie de ataque, estas merecen una atención especial.

Para obtener orientación general sobre el procesamiento de datos procedentes de fuentes no fiables en tiempo de ejecución, véase «Manejo de datos no fiables».

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.