验证挑战和TLS链验证 <- URL会话编程指南

NSURLRequest对象经常遇到验证挑战,或者从其他连接的服务器请求证书。当请求遇到验证挑战的时候,NSURLSession类会通知它的委托,以便它们能够相应的执行。

重要:URL加载系统的类一般不调用它们的委托来处理请求挑战,除非服务器的响应包含WWW-Authenticate头部。其他的验证类型,例如代理验证和TLS信任验证,不需要此头部。

决定如何响应一个验证挑战

如果会话任务请求验证,并且没有有效的证书可用,作为请求URL的一部分或者共享的NSURLCredentialStorage,它会创建一个验证挑战。它首先发送URLSession:task:didReceiveChallenge:completionHandler: 到它的任务委托来处理该验证挑战。如果任务委托没有响应这个消息,该任务会发送URLSession:task:didReceiveChallenge:completionHandler:给它的会话委托来处理这个认证挑战。

为了继续连接,委托由三个选项:

  • 提供验证证书。
  • 尝试无证书连接。
  • 取消验证挑战。

为了帮助确定正确的操作过程,传递给该方法的NSURLAuthenticationChallenge实例包含关于触发该验证挑战的信息、对挑战进行的尝试次数、任何之前尝试的证书、请求证书的NSURLProtectionSpace、以及挑战的发送者。

如果验证挑战之前已经有验证但验证失败(例如,如果用户改变了密码或服务器),你可以通过调用验证挑战中的hproposedCredential来获取尝试的证书。然后该委托把这些证书通过弹出对话框显示给用户。

调用验证挑战的previousFailureCount,返回之前验证尝试的总次数,包括了不同验证协议的尝试。该委托可以抱这些信息提供给用户,已确定之前提供的证书是否失败,或者限制验证尝试次数。

响应验证挑战

以下三种方法是对URLSession:didReceiveChallenge:completionHandler: 或 URLSession:task:didReceiveChallenge:completionHandler:委托方法的响应。

提供证书

要想尝试验证,应用程序应该使用验证信息创建NSURLCredential对象,该验证信息应该符合服务器的要求。你可以通过在提供验证挑战的保护空间中调用authenticationMethod确定服务器的验证方法。NSURLCredential支持一些验证方法:

  • HTTP基础验证(NSURLAuthenticationMethodHTTPBasic)需要用户名和密码。提示用户提供必要的信息,并且使用credentialWithUser:password:persistence:创建NSURLCredential对象。
  • HTTP摘要验证(NSURLAuthenticationMethodHTTPDigest),类似基础验证,需要用户名和密码。(该摘要是自动生成的。)提示用户提供必要的信息,并使用credentialWithUser:password:persistence:创建NSURLCredential对象。
  • 客户端证书验证(NSURLAuthenticationMethodClientCertificate)要求系统身份和所有必要的证书通过服务器进行身份验证。使用credentialWithIdentity:certificates:persistence:创建NSURLCredential对象。
  • 服务器信任验证(NSURLAuthenticationMethodServerTrust)需要由验证挑战的保护空间提供信任(trust)。使用credentialForTrust:创建NSURLCredential对象。

在你创建了NSURLCredential对象之后,使用提供的完成处理程序代码块把这个对象传递给验证挑战的发送者。

无证书连接

如果委托选择不向验证挑战提供证书,它可以尝试无验证的继续连接。把下面值之一传递给完成处理程序代码块:

  • NSURLSessionAuthChallengePerformDefaultHandling处理请求,就像委托不提供委托方法来处理挑战一样。
  • NSURLSessionAuthChallengeRejectProtectionSpace拒绝挑战。根据服务器响应允许的验证类型,URL加载类或许调用这个委托方法不止一次,以获取额外的保护空间。
取消连接

通过给提供的完成处理程序代码块传递NSURLSessionAuthChallengeCancelAuthenticationChallenge,委托也可以选择取消验证挑战。

验证样例

代码清单4-1 展示了,通过创建NSURLCredential实例响应挑战。该实例使用通过应用程序的首选项提供的用户名和密码创建。如果该验证之前失败,它会取消认证挑战并通知用户。

代码清单 4-1 使用URLSession:didReceiveChallenge:completionHandler:委托方法的示例

- (void)URLSession:(NSURLSession *)session

didReceiveChallenge:(NSURLAuthenticationChallenge *)challenge

  completionHandler:(void (^)(NSURLSessionAuthChallengeDisposition disposition, NSURLCredential * __nullable credential))completionHandler

{

    if ([challenge previousFailureCount] == 0) {

        NSURLCredential *newCredential = [NSURLCredential credentialWithUser:[self preferencesName]

                                                                    password:[self preferencesPassword]

                                                                 persistence:NSURLCredentialPersistenceNone];

        completionHandler(NSURLSessionAuthChallengeUseCredential, newCredential);

    } else {

        // Inform the user that the user name and password are incorrect

        completionHandler(NSURLSessionAuthChallengeCancelAuthenticationChallenge, nil);

    }

}
func urlSession(_ session: URLSession, didReceive challenge: URLAuthenticationChallenge, completionHandler: (URLSession.AuthChallengeDisposition, URLCredential?) -> Void) {

    guard challenge.previousFailureCount == 0 else {

        challenge.sender?.cancel(challenge)

        // Inform the user that the user name and password are incorrect

        completionHandler(.cancelAuthenticationChallenge, nil)

        return

    }

    

    let proposedCredential = URLCredential(user: self.preferencesName, password: self.preferencesPassword, persistence: .none)

    completionHandler(.useCredential, proposedCredential)

}

如果验证挑战没有被会话或任务委托处理,且证书不可用或使用它们验证失败,continueWithoutCredentialForAuthenticationChallenge消息会通过底层的实现发送。

执行自定义的TLS链验证

在NSURL系列API中,TLS链验证通过app验证委托方法处理,而不是提供验证用户(或app)的证书给服务器。App会在TLS握手期间检查服务器提供的证书,然后告诉URL加载系统是否应该接受或拒绝这些证书。

如果你需要以非标准的方式执行链验证(例如,为测试接收一个特定的自签名证书),app必须实现URLSession:didReceiveChallenge:completionHandler: 或 URLSession:task:didReceiveChallenge:completionHandler:委托方法。如果两者都实现,则会话级别的方法负责处理验证。

在你的验证处理委托方法中,你应该检查挑战保护空间是否有NSURLAuthenticationMethodServerTrust的验证类型,如果有,从保护空间获取serverTrust信息。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,772评论 6 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,458评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,610评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,640评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,657评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,590评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,962评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,631评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,870评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,611评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,704评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,386评论 4 319
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,969评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,944评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,179评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,742评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,440评论 2 342

推荐阅读更多精彩内容

  • 你可以用两种方式使用NSURLSession API:系统提供的委托或自定义的委托。通常情况下,如果app由下面的...
    raingu24阅读 410评论 0 2
  • NSURLSession及其相关的类提供了通过HTTP下载内容的API。这个类提供了丰富的委托方法来支持验证、以及...
    raingu24阅读 711评论 0 0
  • 概述 NSURLSession类和其相关的类提供了下载内容的API.此类提供了丰富的代理方法集合以支持验证并且在应...
    Mob_Developer阅读 2,253评论 0 0
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,590评论 18 139
  • 《黄昏》 文/白传英 我走向你的时候 天空已黎明 在你的霞光里 我快乐地前行 耳边是十里春风 里面包裹着我的...
    白清风阅读 98评论 0 0