Android APIs
public abstract class

ClientCertRequest

extends Object
java.lang.Object
   ↳ android.webkit.ClientCertRequest

Class Overview

ClientCertRequest: The user receives an instance of this class as a parameter of onReceivedClientCertRequest(WebView, ClientCertRequest). The request includes the parameters to choose the client certificate, such as the host name and the port number requesting the cert, the acceptable key types and the principals. The user should call one of the class methods to indicate how to deal with the client certificate request. All methods should be called on UI thread. WebView caches the proceed(PrivateKey, X509Certificate[]) and cancel() responses in memory and uses them to handle future client certificate requests for the same host/port pair. The user can clear the cached data using clearClientCertPreferences(Runnable).

Summary

Public Constructors
ClientCertRequest()
Public Methods
abstract void cancel()
Cancel this request.
abstract String getHost()
Returns the host name of the server requesting the certificate.
abstract String[] getKeyTypes()
Returns the acceptable types of asymmetric keys (can be null).
abstract int getPort()
Returns the port number of the server requesting the certificate.
abstract Principal[] getPrincipals()
Returns the acceptable certificate issuers for the certificate matching the private key (can be null).
abstract void ignore()
Ignore the request for now.
abstract void proceed(PrivateKey privateKey, X509Certificate[] chain)
Proceed with the specified private key and client certificate chain.
[Expand]
Inherited Methods
From class java.lang.Object

Public Constructors

public ClientCertRequest ()

Added in API level 21

Public Methods

public abstract void cancel ()

Added in API level 21

Cancel this request. Remember the user's choice and use it for future requests.

public abstract String getHost ()

Added in API level 21

Returns the host name of the server requesting the certificate.

public abstract String[] getKeyTypes ()

Added in API level 21

Returns the acceptable types of asymmetric keys (can be null).

public abstract int getPort ()

Added in API level 21

Returns the port number of the server requesting the certificate.

public abstract Principal[] getPrincipals ()

Added in API level 21

Returns the acceptable certificate issuers for the certificate matching the private key (can be null).

public abstract void ignore ()

Added in API level 21

Ignore the request for now. Do not remember user's choice.

public abstract void proceed (PrivateKey privateKey, X509Certificate[] chain)

Added in API level 21

Proceed with the specified private key and client certificate chain. Remember the user's positive choice and use it for future requests.