En esta página

Qt HTTP Server Consideraciones de seguridad

Descripción general

Qt HTTP Server ofrece varios ajustes de configuración para ayudar a proteger una aplicación frente a situaciones de uso indebido, como solicitudes mal formadas o acceso no autorizado. Qt 6.10 incorporó varios ajustes de configuración de seguridad. Esta página resume las configuraciones recomendadas y explica cuándo y cómo utilizarlas.

Advertencia: No expongas Qt HTTP Server directamente a Internet. Qt HTTP Server no está protegido contra ataques basados en la red.

Instalaciones y configuraciones de red

A continuación se describen diferentes formas de configurar una red con un Qt HTTP Server.

Sin acceso a Internet

Lo ideal sería que no hubiera ningún tipo de acceso a Internet. Esta es la configuración más segura, pero a menudo se necesita acceso a Internet. Si Qt HTTP Server está vinculado a localhost o a un QLocalServer, no acepta conexiones procedentes de Internet. Si hay varios clientes conectados a 127.0.0.1, las conexiones se suman a las conexiones por host, lo que afecta a setMaximumConnectionsPerHost(). Por defecto, no hay establecido ningún límite de conexiones por host.

Asignación a QSslServer en Internet

Es posible, aunque no está admitido, vincular el servidor Qt HTTP Server a una dirección QSslServer que esté vinculada a una interfaz de red accesible desde Internet. A pesar de todas las opciones disponibles en QHttpServerConfiguration, esta configuración no está admitida porque Qt HTTP Server no cuenta con la seguridad suficiente.

Configuración de la aplicación

Si se utiliza un grupo de subprocesos, asegúrese de que no sea tan grande que el servidor no pueda gestionar solicitudes entrantes simultáneas que consuman muchos recursos. Aunque la llamada route() facilita el análisis de la URL en las solicitudes HTTP, es responsabilidad del desarrollador gestionar la validación de la entrada.

Qt HTTP Server Configuración de seguridad

Configura Qt HTTP Server a través de la clase QHttpServerConfiguration. Ajusta los límites en función de las capacidades de tu plataforma y de la configuración de red.

Límites de tasa

  • Configura el número máximo de solicitudes por segundo por dirección IP del cliente mediante setRateLimitPerSecond(). Por defecto, no hay límite de frecuencia. Cuando se supera el límite, el servidor responde con el código de estado 429 (Demasiadas solicitudes).
  • Configura el número máximo de conexiones simultáneas mediante ` setMaximumConnections()`. De forma predeterminada, no hay límite de conexiones. Cuando se supera el límite, el servidor responde con el código de estado 429 (Demasiadas solicitudes) y se cierra la conexión.
  • Configura el número máximo de conexiones simultáneas por IP de cliente mediante ` setMaximumConnectionsPerHost()`. Por defecto, no hay ningún límite. Cuando se supera el límite, el servidor responde con el código de estado 429 (Demasiadas solicitudes) y se cierra la conexión.

Límites de conexión

  • Configure el tiempo máximo de inactividad para las conexiones «keep-alive» mediante setKeepAliveTimeout(). De forma predeterminada, el tiempo de espera es de 15 segundos.

Listas de permitidos y de bloqueados

  • Configura la lista de subredes de clientes a las que se les permite acceder al servidor mediante ` setWhitelist()`. Por defecto, la lista de permitidos está vacía y se permite el acceso a todos los clientes. Si la lista de permitidos no está vacía, solo se aceptan las direcciones que figuran en ella. La lista de permitidos se comprueba antes que la lista de denegados.
  • Configura las subredes de clientes denegadas mediante ` setBlacklist()`. La lista de denegación solo se aplica cuando la lista de permitidos está vacía. Por defecto, la lista de denegación está vacía.

Límites de tamaño de las solicitudes

  • Configura el tamaño máximo de la URL mediante setMaximumUrlSize(). Si se supera el límite, el servidor responde con el código de estado HTTP 414 (Request-URI Too Long). El tamaño máximo predeterminado de la URL es de 64 KiB.
  • Configura el tamaño total máximo de todos los encabezados de las solicitudes HTTP mediante setMaximumTotalHeaderSize(). Si se supera el límite, el servidor responde con el código de estado HTTP 431 (Request Header Fields Too Large). El tamaño total predeterminado de los encabezados es de 64 KiB.
  • Configure el tamaño máximo de un único campo de encabezado HTTP mediante setMaximumHeaderFieldSize(). Si se supera el límite, el servidor responde con el código de estado HTTP 431 (Campos de encabezado de la solicitud demasiado grandes). El tamaño máximo predeterminado de un campo de encabezado es de 48 KiB.
  • Configure el número máximo de campos de encabezado HTTP por solicitud mediante setMaximumHeaderFieldCount(). Si se supera el límite, el servidor responde con el código de estado HTTP 431 (Campos de encabezado de la solicitud demasiado grandes). El número máximo predeterminado de campos de encabezado es 128.
  • Configura el tamaño máximo del cuerpo de la solicitud mediante setMaximumBodySize(). Si se supera el límite, el servidor responde con el código de estado HTTP 413 (Contenido demasiado grande). El tamaño máximo predeterminado del cuerpo es de 32 MiB.

Nota: Utilizasiempre las últimas actualizaciones de seguridad para Qt y todas las bibliotecas dependientes.

© 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.