[iOS-Foundation] Networking Authentication

當(dāng)發(fā)送 HTTPS 請(qǐng)求時(shí),在握手階段服務(wù)器可能要求客戶端提供證書用來證明身份。或者在 HTTP 協(xié)議層,服務(wù)器可通過響應(yīng)頭WWW-Authenticate要求驗(yàn)證客戶端身份。在使用 URL Loading System 發(fā)送網(wǎng)絡(luò)請(qǐng)求時(shí),當(dāng)遇到上述情況時(shí),系統(tǒng)會(huì)調(diào)用 URLSession 對(duì)象的代理的
URLSession:didReceiveChallenge:completionHandler:
URLSession:task:didReceiveChallenge:completionHandler:方法。另外在 SSL/TLS 協(xié)議中,客戶端在握手階段驗(yàn)證服務(wù)器證書時(shí),也會(huì)調(diào)用上述代理方法。

代理方法中的參數(shù) challenge 是一個(gè)NSURLAuthenticationChallenge對(duì)象,該類封裝了請(qǐng)求驗(yàn)證的信息。所以一般情況下,應(yīng)用不需要自己創(chuàng)建該類型對(duì)象,只有在使用自定義協(xié)議時(shí),則可能需要主動(dòng)創(chuàng)建。

NSURLAuthenticationChallenge

NSURLAuthenticationChallenge 類中最重要的一個(gè)屬性是protectionSpace,該屬性是一個(gè) NSURLProtectionSpace 的實(shí)例,一個(gè)NSURLProtectionSpace對(duì)象通過屬性host、isProxy、port、protocolproxyTyperealm代表了請(qǐng)求驗(yàn)證的服務(wù)器端的范圍。而NSURLProtectionSpace類的authenticationMethod屬性則指明了服務(wù)端的驗(yàn)證方式,可能的值包括

NSURLAuthenticationMethodDefault
// 基本的 HTTP 驗(yàn)證,通過 NSURLCredential 對(duì)象提供用戶名和密碼。
NSURLAuthenticationMethodHTTPBasic
// 類似于基本的 HTTP 驗(yàn)證,摘要會(huì)自動(dòng)生成,同樣通過 NSURLCredential 對(duì)象提供用戶名和密碼。
NSURLAuthenticationMethodHTTPDigest
// 不會(huì)用于 URL Loading System,在通過 web 表單驗(yàn)證時(shí)可能用到。
NSURLAuthenticationMethodHTMLForm
NSURLAuthenticationMethodNegotiate
NSURLAuthenticationMethodNTLM
// 驗(yàn)證客戶端的證書
NSURLAuthenticationMethodClientCertificate
// 指明客戶端要驗(yàn)證服務(wù)端提供的證書
NSURLAuthenticationMethodServerTrust

除了protectionSpace,NSURLAuthenticationChallenge還包括以下幾項(xiàng)屬性:

  • proposedCredential,從名字就可以看出,推薦的證書說明該屬性是一個(gè)
    NSURLCredential對(duì)象??赡苁歉鶕?jù)protectionSpace,從
    [NSURLCredentialStorage sharedCredentialStorage]獲取到的。也可能是之前驗(yàn)證失敗的證書。如果是客戶端要驗(yàn)證服務(wù)端提供的證書,則該屬性代表了服務(wù)器提供的證書。
  • failureResponse,指明上一次驗(yàn)證失敗的NSURLResponse對(duì)象。
  • previousFailureCount,之前嘗試驗(yàn)證失敗的次數(shù)。
  • sender,實(shí)現(xiàn)NSURLAuthenticationChallengeSender協(xié)議的對(duì)象,一般是一個(gè)NSURLProtocol的實(shí)例,在老版本的NSURLConnectionNSURLDownload中,代理方法并不提供 completionHandler 參數(shù),而是需要調(diào)用
    NSURLAuthenticationChallengeSender協(xié)議定義的相關(guān)方法。
  • error,指明上一次驗(yàn)證失敗的NSError對(duì)象。

NSURLSessionAuthChallengeDisposition

NSURLSession的代理方法中執(zhí)行相應(yīng)的邏輯后,需調(diào)用代理方法的 block 參數(shù) completionHandler,來通知系統(tǒng)如何處理驗(yàn)證。該 block 需要傳入兩個(gè)參數(shù),NSURLSessionAuthChallengeDisposition類型的 disposition,說明處理的方式,另一個(gè)參數(shù)是對(duì)應(yīng)的NSURLCredential對(duì)象。
NSURLSessionAuthChallengeDisposition可能的值包括:

// 指明通過另一個(gè)參數(shù) credential 提供證書
NSURLSessionAuthChallengeUseCredential
// 相當(dāng)于未執(zhí)行代理方法,使用默認(rèn)的處理方式,不使用參數(shù) credential
NSURLSessionAuthChallengePerformDefaultHandling
// 拒絕該 protectionSpace 的驗(yàn)證,不使用參數(shù) credential
NSURLSessionAuthChallengeRejectProtectionSpace
// 取消驗(yàn)證,不使用參數(shù) credential
NSURLSessionAuthChallengeCancelAuthenticationChallenge

NSURLCredential

當(dāng) disposition 的值為 NSURLSessionAuthChallengeUseCredential時(shí),需要提供一個(gè) NSURLCredential 對(duì)象??梢詣?chuàng)建3種類型的 Credential:

// 當(dāng) protectionSpace 的 authenticationMethod 的值為 NSURLAuthenticationMethodHTTPBasic 或 NSURLAuthenticationMethodHTTPDigest 時(shí)
+ credentialWithUser:password:persistence:
- initWithUser:password:persistence:
// 當(dāng) protectionSpace 的 authenticationMethod 的值為 NSURLAuthenticationMethodClientCertificate 時(shí)
+ credentialWithIdentity:certificates:persistence:
- initWithIdentity:certificates:persistence:
// 當(dāng) protectionSpace 的 authenticationMethod 的值為 NSURLAuthenticationMethodServerTrust 時(shí)
+ credentialForTrust:
- initWithTrust:

另外,可通過 NSURLCredentialStorage 管理。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容