Interface SelectClientCertificateCallback

All Superinterfaces:
AsyncCallback<SelectClientCertificateCallback.Params,SelectClientCertificateCallback.Action>, BrowserAsyncCallback<SelectClientCertificateCallback.Params,SelectClientCertificateCallback.Action>, BrowserCallback, Callback
All Known Implementing Classes:
DefaultSelectClientCertificateCallback, DefaultSelectClientCertificateCallback, DefaultSelectClientCertificateCallback

This callback is invoked when the web server requires authorization via SSL client certificate. To access the list of the available certificates in the system storage that match the server criteria you can use the SelectClientCertificateCallback.Params.certificates() method.

The SelectClientCertificateCallback.Params contains information about SSL authorization request.

You can use this callback to display a dialog with the list of the available certificates that allows the user to select the required certificate. Please note that it is not necessary to display a dialog in this callback.

Use the SelectClientCertificateCallback.Action.cancel() method to cancel the authorization.

Use the SelectClientCertificateCallback.Action.select(int) method to inform the browser to use the client certificate located by the passed index in the certificate list.

Use the SelectClientCertificateCallback.Action.select(ClientCertificate) method to inform the browser to use the specified client certificate.

You can construct a ClientCertificate instance from an existing X509Certificate instance using the corresponding Certificate.of(X509Certificate) method.

If the callback throws an exception, the SelectClientCertificateCallback.Action.cancel() method will be invoked.