從這篇開始記錄的都算是實戰累積了,都是日常開發中沉澱下來的東西。
我的建議是:先把基礎工具類放進專案,後續的開發效率會呈指數級增長。 如果你在專心做功能開發時才發現缺了一大堆常用工具,不僅打斷思路,還會拖慢整體節奏。
當然,專案初期不可能把所有工具都準備齊全,只能依個人經驗判斷哪些值得提前投入。好工匠必須有好的工具箱,而且要持續優化它。
1. 在 base 目錄下建立 Utilities 資料夾作為工具箱,並建立 Utilities.h 標頭檔,在 PrefixHeader.pch 中引入它。
2. 先建立三個 NSObject 子類別作為工具類:StringHelper、ImageHelper、EncryptionHelper,並加入 Utilities.h 的引入清單。
3. 在 base 目錄下再建立 Categories 與 Libraries 兩個結構,分別存放分類與類庫。
4. 我進一步把類庫分為第三方類庫與自建類庫。

目前記錄了 Base64 編解碼、MD2/MD4/MD5/SHA1/SHA224/SHA256/SHA384/SHA512 雜湊,以及 AES 與 DES 的加解密。
這裡使用 Google 的 GTMBase64 類庫,因此把它放進第三方庫目錄。
該類庫的程式碼中使用了 autorelease 把物件加入自動釋放池,在 ARC 專案中需要處理。有兩種做法:一是把用到這類寫法的程式碼清掉;二是在專案 Target → Build Phases → Compile Sources 中找到 GTMBase64.m,雙擊後在右側輸入框填入 -fno-objc-arc,把這個檔案排除在 ARC 管理之外。
在 EncryptionHelper.m 中引入 GTMBase64.h 後,即可實作:
+ (NSString *)base64EncodeWithString:(NSString *)string {
NSData *data = [string dataUsingEncoding:NSUTF8StringEncoding];
NSString *result = [GTMBase64 stringByEncodingData:data];
return result;
}
+ (NSString *)decodeBase64WithString:(NSString *)string {
NSData *data = [GTMBase64 decodeString:string];
NSString *result = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
return result;
}
因為不可逆(可以理解為無數多解的二元一次方程),所以只有加密算法可記錄:
+ (NSString *)MD5SumWithString:(NSString *)string {
NSData *data = [string dataUsingEncoding:NSUTF8StringEncoding];
uint8_t buffer[CC_MD5_DIGEST_LENGTH];
CC_MD5(data.bytes, (CC_LONG)data.length, buffer);
// 以下註解程式碼與上述加密等效
// data = [data MD5Sum];
// Byte *buffer = (Byte *)data.bytes;
NSMutableString *result = [NSMutableString stringWithCapacity:CC_MD5_DIGEST_LENGTH * 2];
for (int i = 0; i < CC_MD5_DIGEST_LENGTH; i++) {
[result appendFormat:@"%02x", buffer[i]];
}
return result;
}
幾點說明:
A. 字串轉 NSData 的正確寫法。 看到很多開發者用這種方式轉換:
const char *cstr = [string cStringUsingEncoding:NSUTF8StringEncoding]; NSData *data = [NSData dataWithBytes:cstr length:string.length];
我不建議這樣寫。實測結果是:當字串只含英文字母、數字、符號時沒問題;但一旦包含中文,string.length 取到的長度就會出錯——因為一個中文字元轉成 NSData 之後佔的位元組數大於 1,於是這段程式碼會導致中文轉換後內容被截斷。
建議改用:
NSData *data = [string dataUsingEncoding:NSUTF8StringEncoding];
B. MD2、MD4、SHA1、SHA224、SHA256、SHA384、SHA512 等算法,只需把範例中的 CC_MD5_DIGEST_LENGTH 與 CC_MD5 換成對應名稱即可。
C. 註解那段的效果與前兩行一致,但需要引入分類 NSData+CommonCrypto.h。
D. data.bytes 可以強轉為 (Byte *) 或 (char *)。
E. result 字串的預留長度是 CC_MD5_DIGEST_LENGTH * 2,因為 buffer 元素型別是 uint8_t(即 unsigned char),格式化時以 16 進制顯示兩位,所以長度為兩倍。
F. %02x 佔位符表示以 16 進制顯示兩位,不足兩位時左邊補 0。
加密流程:string → data → AES/DES 加密 → base64 編碼 → string;解密則是完全相反的順序。
+ (NSString *)AES256EncryptedString:(NSString *)string usingKey:(NSString *)key {
NSData *data = [string dataUsingEncoding:NSUTF8StringEncoding];
NSData *encryptedData = [data AES256EncryptedDataUsingKey:key error:nil];
NSData *base64Data = [GTMBase64 encodeData:encryptedData];
NSString *result = [[NSString alloc] initWithData:base64Data encoding:NSUTF8StringEncoding];
// 其他等效寫法
// const char *buffer = (char *)base64Data.bytes;
// result = [[NSString alloc] initWithCString:buffer encoding:NSUTF8StringEncoding];
// result = [[NSString alloc] initWithBytes:base64Data.bytes
// length:base64Data.length
// encoding:NSUTF8StringEncoding];
return result;
}
+ (NSString *)decryptedAES256String:(NSString *)string usingKey:(NSString *)key {
NSData *base64Data = [string dataUsingEncoding:NSUTF8StringEncoding];
NSData *decryptedData = [GTMBase64 decodeData:base64Data];
NSData *data = [decryptedData decryptedAES256DataUsingKey:key error:nil];
NSString *result = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
return result;
}
這裡另外加了一個分類 NSData+CommonCrypto 並在 EncryptionHelper.m 中引入,它提供了 AES 與 DES 的加解密實作,有興趣可以細看。
GitHub:https://github.com/ALongWay/AESCrypt-ObjC
補充:
A. AES 加密方法中,生成 result 字串列舉了三種方式,可依情境挑選。
B. DES 加密只需把 AES256EncryptedDataUsingKey 換成 DESEncryptedDataUsingKey。
C. DES 解密只需把 decryptedAES256DataUsingKey 換成 decryptedDESDataUsingKey。
NSString *message = @"測試各種加密解密方法abc123+=/"; NSString *key = @"xyz123這是key"; NSString *base64Msg = [EncryptionHelper base64EncodeWithString:message]; NSString *decodeMsg = [EncryptionHelper decodeBase64WithString:base64Msg]; NSString *md5Msg = [EncryptionHelper MD5SumWithString:message]; NSString *sha1Msg = [EncryptionHelper SHA1HashWithString:message]; NSString *sha256Msg = [EncryptionHelper SHA256HashWithString:message]; NSString *aes256Msg = [EncryptionHelper AES256EncryptedString:message usingKey:key]; NSString *decryptedAESMsg = [EncryptionHelper decryptedAES256String:aes256Msg usingKey:key]; NSString *desMsg = [EncryptionHelper DESEncryptedString:message usingKey:key]; NSString *decryptedDESMsg = [EncryptionHelper decryptedDESString:desMsg usingKey:key];
2016-09-08 17:46:43.505 base[7128:9029057] message:測試各種加密解密方法abc123+=/; key:xyz123這是key 2016-09-08 17:46:43.506 base[7128:9029057] base64Msg:5rWL6K+V5ZCE56eN5Yqg5a+G6Kej5a+G5pa55rOVYWJjMTIzKz0v 2016-09-08 17:46:43.506 base[7128:9029057] decodeMsg:測試各種加密解密方法abc123+=/ 2016-09-08 17:46:43.506 base[7128:9029057] md5Msg:55d86b31f8cf9b3007a303664237fc8d 2016-09-08 17:46:43.506 base[7128:9029057] sha1Msg:1465c756f0eb64c7cccf175022a84ecd82f8faae 2016-09-08 17:46:43.506 base[7128:9029057] sha256Msg:297050d60416bbf0a84856fc9986a2bbe8a528a75377f7e1b011c4971c884a02 2016-09-08 17:46:43.506 base[7128:9029057] aes256Msg:seDPZ6RLHavklYxJOP9uMc7QoOZXZ8DASp6YHoe40B+6QkZ9Xhtn+Ecx5tPqakor 2016-09-08 17:46:43.506 base[7128:9029057] decryptedAESMsg:測試各種加密解密方法abc123+=/ 2016-09-08 17:46:43.506 base[7128:9029057] desMsg:uXGaL4ChwSJt5HoD+gU9T/9L8K4eCVFEg5MyzivJRQxBRhAvfTou2Q== 2016-09-08 17:46:43.507 base[7128:9029057] decryptedDESMsg:測試各種加密解密方法abc123+=/
base 專案已更新:git@github.com:ALongWay/base.git
Base64 是編碼,不是加密。 它可以被任何人直接還原,只用來處理二進位資料的 textual 表示,不具備任何安全性。若目的是保護資料,必須搭配真正的加密算法。
MD5 與 SHA 家族不適合存密碼。 這些雜湊設計目的是快速,正好和「難以暴力破解」相反。要存使用者密碼,請用 CCCrypt 之後迭代加鹽,或使用專門的 KDF 演算法。
AES 的 IV 不能固定。 範例中的 AESCrypt-ObjC 是為了簡化而省略了 IV 管理,正式環境必須每次加密都產生隨機 IV 並與密文一起保存,否則相同明文會產生相同密文,容易被 Pattern 分析。
金鑰不要硬編碼在 App 內。 iOS 的執行檔是可以被逆向的,任何寫死在本地的金鑰都應視為已外洩。敏感資料的加解密金鑰建議由伺服器下發,並存入 Keychain 而非 NSUserDefaults。
DES 已不安全。 56 位元金鑰在現代硬體下可在極短時間內破解,僅適用於對接必須相容的舊系統。新專案請一律使用 AES。