summaryrefslogtreecommitdiffstats
path: root/src/webengine
diff options
context:
space:
mode:
authorAllan Sandfeld Jensen <allan.jensen@qt.io>2018-11-23 13:26:50 +0100
committerAllan Sandfeld Jensen <allan.jensen@qt.io>2018-11-27 20:45:47 +0000
commitba816f1f5cd5ddb7f5cba32d0c9816bb439dffba (patch)
tree86d3925d90f9f4d03256bf5b8906f6eaa4ee8deb /src/webengine
parentbd34017fdd17a1044bd645c68386fda29ab77d0d (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.qdoc18
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