你可以把 Keychain 想成一個 Dictionary:所有資料都以 key-value 的形式存放,並支援 add、update、get、delete 四種操作。
對每個 App 來說,Keychain 有兩個存取區域——私有區與公共區。私有區就是一個 sandbox,你在這裡存的任何東西,其他 App 都看不到。若要把資料放進公共區,必須先宣告公共區的名稱,官方文件稱之為 keychain access group。宣告方式是新增一份 plist 檔(檔名自訂),內容大致如下:

其中 "yourAppID.com.yourCompany.whatever" 就是你要取的公共區名稱;除了 whatever 這段可以自由命名,其餘欄位都必須如實填寫。這份檔案的路徑還要設定到 Project → Build Setting → Code Signing Entitlements,否則公共區不會生效。設定完成後,必須用正式憑證簽章編譯才能通過,不然 Xcode 會直接跳出 code signing 錯誤。
換句話說,蘋果的設計只允許「同一家公司的產品」共用 Keychain 資料,其他公司的 App 無法存取你公司的 Keychain。
iOS 的 Keychain 服務提供了一種安全保存機密資料的方式,例如密碼、序號、憑證等。每個 App 都有獨立的 Keychain 儲存空間。相比 NSUserDefaults 或一般檔案儲存,Keychain 的安全性更高;而且 Keychain 裡的資料不會因為 App 被刪除而消失,所以使用者重裝 App 之後,先前的資料仍然可用。
要在 App 裡使用 Keychain,需要匯入 Security.framework,操作介面宣告在 SecItem.h 裡。直接呼叫 SecItem.h 的方法雖然可行,但程式碼相當繁瑣。為了省事,社群有幾個封裝好的工具類,這裡介紹兩個我用過的。
這是 Apple 官方範例 GenericKeychain 中的封裝類。從官網下載該專案後,只要把 KeychainItemWrapper.h 與 KeychainItemWrapper.m 複製到自己的專案,並匯入 Security.framework 即可。
// 初始化一個用來保存帳號的 KeychainItemWrapper
KeychainItemWrapper *wrapper = [[KeychainItemWrapper alloc]
initWithIdentifier:@"Account Number"
accessGroup:@"YOUR_APP_ID_HERE.com.yourcompany.AppIdentifier"];
// 保存帳號
[wrapper setObject:@"<帳號>" forKey:(id)kSecAttrAccount];
// 保存密碼
[wrapper setObject:@"<帳號密碼>" forKey:(id)kSecValueData];
// 取出密碼
NSString *password = [wrapper objectForKey:(id)kSecValueData];
// 清空設定
[wrapper resetKeychainItem];
這裡有個地雷要注意:setObject:forKey: 的 forKey 參數必須是 Security.framework 的 SecItem.h 中已定義好的常數,若自行給字串當 key,程式會直接崩潰。
另一個選擇,提供在 iOS Keychain 中安全存放密碼的工具,專案位址為 https://github.com/ldandersen/scifihifi-iphone/tree/master/security 。使用步驟如下:
1. 匯入 Security.framework。
2. 引入標頭檔 SFHFKeychainUtils.h。
3. 存入密碼:
[SFHFKeychainUtils storeUsername:@"dd" andPassword:@"aa"
forServiceName:SERVICE_NAME updateExisting:1 error:nil];
[SFHFKeychainUtils deleteItemForUsername:@"dd"
andServiceName:SERVICE_NAME error:nil];
4. 取出密碼:
NSString *passWord = [SFHFKeychainUtils getPasswordForUsername:@"dd"
andServiceName:SERVICE_NAME error:nil];
最後提醒一句:Keychain 適合用來存少量、必須持久的機密資料,不該拿來放大量的快取內容。若要進一步提高防護等級,可搭配 kSecAttrAccessible 系列選項,決定資料在裝置鎖定時是否仍可被讀取。