EnableOptionalClientCertificates Property

WebBrowser EnableOptionalClientCertificates Property

C# API

Enables the use of optional client certificates, in case the server requests a client certificate but doesn't require one.

Namespace: Facilita.Web
Assembly: clrWebBrowser (in clrWebBrowser.dll) Version: 9.5.5.77 (1.0.0.0)

Syntax

C++

Copy to Clipboard Print

public bool EnableOptionalClientCertificates { get; set; }

public bool EnableOptionalClientCertificates { get; set; }

Field Value

true if SSL/TLS handshakes should be retried without a client certificate; otherwise, false.

Exceptions

Exception	Condition
NotSupportedException	Either the WinInet or Internal HTTP handler is currently in use, for which this property is not supported.

Remarks

As part of the SSL/TLS handshake, a server can request a certificate to authenticate the client (i.e. the virtual user). If you have a client certificate, you can use the other certificate properties to specify its location. However if you know the server doesn't require a client certificate, you can set this flag. If CertificateSubject returns an empty string or a client certificate cannot otherwise be located, the handshake will continue without one.