[iOS-Foundation] Networking Auth

当发送 HTTPS 请求时，在握手阶段服务器可能要求客户端提供证书用来证明身份。或者在 HTTP 协议层，服务器可通过响应头WWW-Authenticate要求验证客户端身份。在使用 URL Loading System 发送网络请求时，当遇到上述情况时，系统会调用 URLSession 对象的代理的
URLSession:didReceiveChallenge:completionHandler:或
URLSession:task:didReceiveChallenge:completionHandler:方法。另外在 SSL/TLS 协议中，客户端在握手阶段验证服务器证书时，也会调用上述代理方法。

代理方法中的参数 challenge 是一个NSURLAuthenticationChallenge对象，该类封装了请求验证的信息。所以一般情况下，应用不需要自己创建该类型对象，只有在使用自定义协议时，则可能需要主动创建。

NSURLAuthenticationChallenge

NSURLAuthenticationChallenge 类中最重要的一个属性是protectionSpace，该属性是一个 NSURLProtectionSpace 的实例，一个NSURLProtectionSpace对象通过属性host、isProxy、port、protocol、proxyType和realm代表了请求验证的服务器端的范围。而NSURLProtectionSpace类的authenticationMethod属性则指明了服务端的验证方式，可能的值包括

NSURLAuthenticationMethodDefault
// 基本的 HTTP 验证，通过 NSURLCredential 对象提供用户名和密码。
NSURLAuthenticationMethodHTTPBasic
// 类似于基本的 HTTP 验证，摘要会自动生成，同样通过 NSURLCredential 对象提供用户名和密码。
NSURLAuthenticationMethodHTTPDigest
// 不会用于 URL Loading System，在通过 web 表单验证时可能用到。
NSURLAuthenticationMethodHTMLForm
NSURLAuthenticationMethodNegotiate
NSURLAuthenticationMethodNTLM
// 验证客户端的证书
NSURLAuthenticationMethodClientCertificate
// 指明客户端要验证服务端提供的证书
NSURLAuthenticationMethodServerTrust

除了protectionSpace，NSURLAuthenticationChallenge还包括以下几项属性：

• proposedCredential，从名字就可以看出，推荐的证书说明该属性是一个
  NSURLCredential对象。可能是根据protectionSpace，从
  [NSURLCredentialStorage sharedCredentialStorage]获取到的。也可能是之前验证失败的证书。如果是客户端要验证服务端提供的证书，则该属性代表了服务器提供的证书。
• failureResponse，指明上一次验证失败的NSURLResponse对象。
• previousFailureCount，之前尝试验证失败的次数。
• sender，实现NSURLAuthenticationChallengeSender协议的对象，一般是一个NSURLProtocol的实例，在老版本的NSURLConnection和NSURLDownload中，代理方法并不提供 completionHandler 参数，而是需要调用
  NSURLAuthenticationChallengeSender协议定义的相关方法。
• error，指明上一次验证失败的NSError对象。

NSURLSessionAuthChallengeDisposition

在NSURLSession的代理方法中执行相应的逻辑后，需调用代理方法的 block 参数 completionHandler，来通知系统如何处理验证。该 block 需要传入两个参数，NSURLSessionAuthChallengeDisposition类型的 disposition，说明处理的方式，另一个参数是对应的NSURLCredential对象。
NSURLSessionAuthChallengeDisposition可能的值包括：

// 指明通过另一个参数 credential 提供证书
NSURLSessionAuthChallengeUseCredential
// 相当于未执行代理方法，使用默认的处理方式，不使用参数 credential
NSURLSessionAuthChallengePerformDefaultHandling
// 拒绝该 protectionSpace 的验证，不使用参数 credential
NSURLSessionAuthChallengeRejectProtectionSpace
// 取消验证，不使用参数 credential
NSURLSessionAuthChallengeCancelAuthenticationChallenge

NSURLCredential

当 disposition 的值为 NSURLSessionAuthChallengeUseCredential时，需要提供一个 NSURLCredential 对象。可以创建3种类型的 Credential：

// 当 protectionSpace 的 authenticationMethod 的值为 NSURLAuthenticationMethodHTTPBasic 或 NSURLAuthenticationMethodHTTPDigest 时
+ credentialWithUser:password:persistence:
- initWithUser:password:persistence:
// 当 protectionSpace 的 authenticationMethod 的值为 NSURLAuthenticationMethodClientCertificate 时
+ credentialWithIdentity:certificates:persistence:
- initWithIdentity:certificates:persistence:
// 当 protectionSpace 的 authenticationMethod 的值为 NSURLAuthenticationMethodServerTrust 时
+ credentialForTrust:
- initWithTrust:

另外，可通过 NSURLCredentialStorage 管理。