Show TOC

CertificateProvider protocolLocate this document in the navigation structure

Certificate providers need to implement this interface. Describes methods that will be called by the Logon component during registration.

@protocol CertificateProvider <NSObject>

All members of CertificateProvider, including inherited members.

Method Description
-(void) getCertificate:(id<CertificateProviderDelegate>) delegate; Invoked during the registration, when MAFLogonManager needs a client certificate and a CertificateProvider instance is set.
-(BOOL) getStoredCertificate:(SecIdentityRef*)secIdentityRef error:(NSError**)anError; Sync method for getting the stored client certificate. Do not present a UI here. Call this method only when registration is complete:
  • After locking secure store
  • On application start, if secure store is not locked
-(NSError*) deleteStoredCertificate; CertificateProvider implementation deletes the stored certificate when called. Invoked in these cases:
  • During application unregistration.
  • During application registration: if any successful registration occurred in the past, this call ensures that the previously used certificate will be deleted.
  • When a DataVault is deleted due to too many failed attempts.
  • The certificate becomes invalid, and the application developer calls refreshCertificate method on the Public API of MAFLogonManager.

Returns yes if the certificate was successfully deleted, or there is no certificate. Otherwise, returns no and an error message.