Android
Describes methods in the CertificateProvider and CertificateProviderListener.
In this section:
onGetCertificateSuccess Method
This method is called by certificate provider to asynchronously report the result for
the getCertificate method. onGetCertificateSuccess is
called after the certificate provider successfully obtains the x509KeyManager object. This
method is only used in the SAP Mobile Platform registration case, where
getCertificate is called.
onGetCertificateFailure Method
This method is called by the certificate provider to asynchronously report the result
for the getCertificate method. onGetCertificateFailure
is called when the certificate provider fails to get the certificate. This method is only
used in the SAP Mobile Platform registration case, where getCertificate
is called.
initialize Method
In the non-SAP Mobile Platform case, the initialize method is the
main method called by the Logon plugin to asynchronously get the client certificate from the
certificate provider (in the SAP Mobile Platform case, this method is not called and the
getCertificate method is called instead).
getCertificate Method
In the SAP Mobile Platform registration case, the getCertificate
method is the main method called by the Logon plugin to asynchronously get the client
certificate from the certificate provider (in the non-SAP Mobile Platform case, this method
is not called and the initialize method is called instead). The provided certificate is used
to authenticate the client with the server. For Android, the method expects the certificate
provider to provide an X509KeyManager object by calling the
onGetCertificateSuccess method on the provided
CertificateProviderListener callback object.
getStoredCertificate Method
The synchronous method to return the cached certificate from the certificate provider.
The certificate provider can cache the certificate once it successfully retrieves or
generates it. If there is no cached certificate, null can be returned.
deleteStoredCertificate Method
This function is called when the certificate provided by the provider no longer works to
authenticate against the server (for example, if the certificate is expired). This function
clears the cached certificate if there is one.
setParameters Method
The setParameters method is is not required to do anything. This
function is called with the Android Activity object, so that the provider can show UI if it
needs to.