Kofax Mobile SDK API Reference
Instance Methods | List of all members
<kfxKUTCertificateValidatorDelegate> Protocol Reference

This protocol defines methods that your delegate object may implement for custom certificate pinning logic. More...

#import <kfxKUTCertificateValidatorDelegate.h>

Inheritance diagram for <kfxKUTCertificateValidatorDelegate>:

Instance Methods

(void) - certificateValidatorForURLSession:didReceiveChallenge:completionHandler:
 Requests credentials from the delegate in response to an authentication request from the remote server. More...
 

Detailed Description

This protocol defines methods that your delegate object may implement for custom certificate pinning logic.

The methods of this protocol notify your delegate with messages related to certificate validation.

Method Documentation

- (void) certificateValidatorForURLSession: (NSURLSession *)  session
didReceiveChallenge: (NSURLAuthenticationChallenge *)  challenge
completionHandler: (void(^)(NSURLSessionAuthChallengeDisposition disposition, NSURLCredential *credential))  completionHandler 
optional

Requests credentials from the delegate in response to an authentication request from the remote server.

This method is a wrapper around following method of NSURLSessionTaskDelegate

  • (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didReceiveChallenge:(NSURLAuthenticationChallenge *)challenge completionHandler:(void (^)(NSURLSessionAuthChallengeDisposition disposition, NSURLCredential *credential))completionHandler

Refer to an Apple Foundation Framework documentation for more details.

Responding on this client may customize Certificate Pinning logic.

Parameters
sessionThe session containing the task whose request requires authentication.
challengeAn object that contains the request for authentication.
completionHandlerA handler that your delegate method must call. Its parameters are:
  • disposition One of several constants that describes how the challenge should be handled.
  • credential The credential that should be used for authentication if disposition is NSURLSessionAuthChallengeUseCredential; otherwise, NULL.

Use NSURLSessionAuthChallengePerformDefaultHandling as disposition for default handling for the challenge as though this delegate method were not implemented. The provided credential parameter is ignored.

Implementation of this method is optional, but expected for security reason.


The documentation for this protocol was generated from the following file:
Untitled Document © 2018 Kofax, Inc. All rights reserved. Use is subject to license terms.