您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 訊息 >> iOS 相關資訊

iOS 網路請求怎麼帶 Cookie:把 token 塞進 NSHTTPCookie 的完整寫法

編輯:iOS 相關資訊

做評論、留言這類需要身分驗證的功能時,後端往往要求在 Cookie 中携带 token 才願意受理請求。若你用的是 NSURLConnection/NSURLSession 這套原生堆疊,不必自己動手拼 HTTP 標頭,只要把 token 包裝成 NSHTTPCookie 放進共享的 Cookie 儲存空間即可,後續所有請求都會自動附上。

程式碼

NSDictionary *properties = [NSDictionary dictionaryWithObjectsAndKeys:
        @"token",        NSHTTPCookieValue,   // token 的值
        @"sso_tk",       NSHTTPCookieName,    // token 的名稱
        @"/",            NSHTTPCookiePath,    // 作用路徑
        @"域名",          NSHTTPCookieDomain,  // 作用網域
        nil];

NSHTTPCookie *cookie_PD1 = [NSHTTPCookie cookieWithProperties:properties];

[[NSHTTPCookieStorage sharedHTTPCookieStorage] setCookie:cookie_PD1];

四個必要屬性

cookieWithProperties: 需要一組描述 Cookie 身分的屬性字典,其中四個是一定要給的:

  • NSHTTPCookieValue:token 實際的值。
  • NSHTTPCookieName:Cookie 的名稱,這裡是 sso_tk,需與後端約定一致。
  • NSHTTPCookiePath:Cookie 的有效路徑,寫 / 代表整個站台通用。
  • NSHTTPCookieDomain:Cookie 有效的網域,務必與請求的 host 相符,否則系統不會送出。

把 Cookie 註冊進 sharedHTTPCookieStorage 之後,同一個 App 內所有走 NSURL 堆疊的連線都會自動帶上它,不必每個請求各寫一次。

實務上的注意事項

  • 網域寫錯等於沒寫。最常見的失敗原因是 domain 與請求的 API 網域不一致,例如 API 在 api.example.com 卻把 Cookie 綁到 www.example.com。若要求跨子網域共用,可寫成 .example.com。
  • 需要指定有效期限的話,可在屬性字典中加上 NSHTTPCookieExpires(NSDate)或 NSHTTPCookieMaximumAge(秒數);兩者都不給就是 session cookie,App 結束後消失。
  • HTTPS 安全性可透過 NSHTTPCookieSecure 設定為 @"TRUE",讓 Cookie 只在加密連線中傳送。
  • 除錯方式:用 [[NSHTTPCookieStorage sharedHTTPCookieStorage] cookies] 印出目前所有 Cookie,或用 cookiesForURL: 確認某個網址實際會收到哪些。
  • 若改用 NSURLSession,記得 NSURLSessionConfiguration 的 HTTPCookieStorage 預設就是共享空間;只有在你刻意換成 nil 時才不會自動帶 Cookie。

這套做法也常用於單點登入(SSO)情境:登入服務寫入 token Cookie 後,同一網域下的多個子服務就能共用同一份身分狀態。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved