mirror of
https://github.com/Kitware/CMake.git
synced 2026-01-06 05:40:54 -06:00
file(DOWNLOAD/UPLOAD): Verify TLS server certificate by default
If the connection fails in a way that might be a certificate error, and verification was enabled by the new default, mention environment variable `CMAKE_TLS_VERIFY` in the diagnostic to help users that were relying on the old behavior turn off server certificate verification in their environment. Fixes: #23608
This commit is contained in:
@@ -813,8 +813,15 @@ Transfer
|
||||
|
||||
``TLS_VERIFY <ON|OFF>``
|
||||
Specify whether to verify the server certificate for ``https://`` URLs.
|
||||
The default is to *not* verify. If this option is not specified, the
|
||||
value of the :variable:`CMAKE_TLS_VERIFY` variable will be used instead.
|
||||
If this option is not specified, the value of the
|
||||
:variable:`CMAKE_TLS_VERIFY` variable or :envvar:`CMAKE_TLS_VERIFY`
|
||||
environment variable will be used instead.
|
||||
If neither is set, the default is *on*.
|
||||
|
||||
.. versionchanged:: 3.31
|
||||
The default is on. Previously, the default was off.
|
||||
Users may set the :envvar:`CMAKE_TLS_VERIFY` environment
|
||||
variable to ``0`` to restore the old default.
|
||||
|
||||
.. versionadded:: 3.18
|
||||
Added support to ``file(UPLOAD)``.
|
||||
@@ -827,9 +834,7 @@ Transfer
|
||||
.. versionadded:: 3.18
|
||||
Added support to ``file(UPLOAD)``.
|
||||
|
||||
For ``https://`` URLs CMake must be built with OpenSSL support. ``TLS/SSL``
|
||||
certificates are not checked by default. Set ``TLS_VERIFY`` to ``ON`` to
|
||||
check certificates.
|
||||
For ``https://`` URLs CMake must be built with SSL/TLS support.
|
||||
|
||||
Additional options to ``DOWNLOAD`` are:
|
||||
|
||||
|
||||
Reference in New Issue
Block a user