diff options
author | Allan Sandfeld Jensen <allan.jensen@qt.io> | 2018-11-23 13:26:50 +0100 |
---|---|---|
committer | Allan Sandfeld Jensen <allan.jensen@qt.io> | 2018-11-27 20:45:47 +0000 |
commit | ba816f1f5cd5ddb7f5cba32d0c9816bb439dffba (patch) | |
tree | 86d3925d90f9f4d03256bf5b8906f6eaa4ee8deb /src/webengine | |
parent | bd34017fdd17a1044bd645c68386fda29ab77d0d (diff) |
Document client certificate feature
Change-Id: Id47a763642003f6056f1591e8ba7f82e255cd43e
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Reviewed-by: Michael BrĂ¼ning <michael.bruning@qt.io>
Diffstat (limited to 'src/webengine')
-rw-r--r-- | src/webengine/doc/src/qtwebengine-features.qdoc | 18 |
1 files changed, 18 insertions, 0 deletions
diff --git a/src/webengine/doc/src/qtwebengine-features.qdoc b/src/webengine/doc/src/qtwebengine-features.qdoc index 41d0581e5..1dce17e08 100644 --- a/src/webengine/doc/src/qtwebengine-features.qdoc +++ b/src/webengine/doc/src/qtwebengine-features.qdoc @@ -36,6 +36,7 @@ \list \li \l{Audio and Video Codecs} \li \l{Chromium DevTools} + \li \l{Client Certificates} \li \l{Drag and Drop} \li \l{Fullscreen} \li \l{HTML5 DRM} @@ -111,6 +112,23 @@ For more information, see \l {Qt WebEngine Debugging and Profiling}. + \section1 Client Certificates + + Some web servers, in particular many intranet sites, require the client to + authenticate itself with a certificate, called a \e {client certificate}. Qt WebEngine + will read the client certificates installed in the system settings in macOS and + Windows, and on Linux those installed into the NSS database. Certificates can + be installed into the NSS database using the \c pk12util tool. + + By default, QtWebEngine will not offer any client certificates to servers, as doing + so uniquely identifies the user and might violate privacy expectations. + + To activate support for client certificates, an application needs to listen to + the QWebEnginePage::selectClientCertificate signal and select one of the offered + certificates. For applications that can navigate to untrusted web sites, it is + recommended to always give the user a choice before uniquely identifying them + to a remote server. + \section1 Custom Schemes Qt WebEngine makes it possible for the application to define its own custom |