做評論、留言這類需要身分驗證的功能時,後端往往要求在 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 身分的屬性字典,其中四個是一定要給的:
sso_tk,需與後端約定一致。/ 代表整個站台通用。把 Cookie 註冊進 sharedHTTPCookieStorage 之後,同一個 App 內所有走 NSURL 堆疊的連線都會自動帶上它,不必每個請求各寫一次。
api.example.com 卻把 Cookie 綁到 www.example.com。若要求跨子網域共用,可寫成 .example.com。NSHTTPCookieExpires(NSDate)或 NSHTTPCookieMaximumAge(秒數);兩者都不給就是 session cookie,App 結束後消失。NSHTTPCookieSecure 設定為 @"TRUE",讓 Cookie 只在加密連線中傳送。[[NSHTTPCookieStorage sharedHTTPCookieStorage] cookies] 印出目前所有 Cookie,或用 cookiesForURL: 確認某個網址實際會收到哪些。NSURLSessionConfiguration 的 HTTPCookieStorage 預設就是共享空間;只有在你刻意換成 nil 時才不會自動帶 Cookie。這套做法也常用於單點登入(SSO)情境:登入服務寫入 token Cookie 後,同一網域下的多個子服務就能共用同一份身分狀態。