iOS 系統庫已內建常用的加解密與摘要演算法,介面為 C 語言形式,主要分佈在以下標頭:
#include <CommonCrypto/CommonCryptor.h> // 對稱加解密 #include <CommonCrypto/CommonDigest.h> // 摘要演算法 #include <CommonCrypto/CommonHMAC.h> // HMAC #include <CommonCrypto/CommonKeyDerivation.h> // 金鑰推導 #include <CommonCrypto/CommonSymmetricKeywrap.h> // 金鑰封裝
其中第一類包含 AES、DES 與已廢棄的 RC4;第二類則包含 MD5、SHA 等摘要演算法。本文聚焦最常被使用的 AES、MD5 與 SHA。
AES 適用於「需要保密、但日後又要解密」的場景,加解密使用同一把金鑰,依金鑰長度分為 128、192、256 三級。金鑰越長安全性越高、效能越低,依實際業務的安全需求取捨即可。由於加密對象多為字串、結果也多以字串保存,因此包裝成 Objective-C 分類時,參數與回傳值都設計為 NSString 最為順手。
-(NSString *)aes256_encrypt:(NSString *)key {
const char *cstr = [self cStringUsingEncoding:NSUTF8StringEncoding];
NSData *data = [NSData dataWithBytes:cstr length:self.length];
// 對數據進行加密
char keyPtr[kCCKeySizeAES256 + 1];
bzero(keyPtr, sizeof(keyPtr));
[key getCString:keyPtr maxLength:sizeof(keyPtr) encoding:NSUTF8StringEncoding];
NSUInteger dataLength = [data length];
size_t bufferSize = dataLength + kCCBlockSizeAES128;
void *buffer = malloc(bufferSize);
size_t numBytesEncrypted = 0;
CCCryptorStatus cryptStatus = CCCrypt(
kCCEncrypt, kCCAlgorithmAES,
kCCOptionPKCS7Padding | kCCOptionECBMode,
keyPtr, kCCKeySizeAES256, NULL,
[data bytes], dataLength,
buffer, bufferSize, &numBytesEncrypted);
if (cryptStatus == kCCSuccess) {
NSData *result = [NSData dataWithBytesNoCopy:buffer length:numBytesEncrypted];
return [result base64EncodedStringWithOptions:NSDataBase64Encoding64CharacterLineLength];
}
return nil;
}
-(NSString *)aes256_decrypt:(NSString *)key {
NSData *data = [[NSData alloc] initWithBase64EncodedData:
[self dataUsingEncoding:NSASCIIStringEncoding]
options:NSDataBase64DecodingIgnoreUnknownCharacters];
char keyPtr[kCCKeySizeAES256 + 1];
bzero(keyPtr, sizeof(keyPtr));
[key getCString:keyPtr maxLength:sizeof(keyPtr) encoding:NSUTF8StringEncoding];
NSUInteger dataLength = [data length];
size_t bufferSize = dataLength + kCCBlockSizeAES128;
void *buffer = malloc(bufferSize);
size_t numBytesDecrypted = 0;
CCCryptorStatus cryptStatus = CCCrypt(
kCCDecrypt, kCCAlgorithmAES,
kCCOptionPKCS7Padding | kCCOptionECBMode,
keyPtr, kCCKeySizeAES256, NULL,
[data bytes], dataLength,
buffer, bufferSize, &numBytesDecrypted);
if (cryptStatus == kCCSuccess) {
NSData *result = [NSData dataWithBytesNoCopy:buffer length:numBytesDecrypted];
return [[NSString alloc] initWithData:result encoding:NSUTF8StringEncoding];
}
return nil;
}
int main(int argc, const char * argv[]) {
@autoreleasepool {
NSString *plainText = @"O57W05XN-EQ2HCD3V-LPJJ4H0N-ZFO2WHRR";
NSString *key = @"12345678901234561234567890123456";
NSString *cryptText = [plainText aes256_encrypt:key];
NSLog(@"cryptText:\n%@", cryptText);
NSString *newPlainText = [cryptText aes256_decrypt:key];
NSLog(@"newPlainText:%@", newPlainText);
}
return 0;
}
要靈活使用 AES,必須理解工作模式、初始向量與填充方式這幾個概念,跨平台互通時尤其重要。
kCCAlgorithmAES128 只是歷史命名,數值與 kCCAlgorithmAES 相同。摘要演算法的特性是單向不可逆、運算速度快。
把任意非空明文映射為 32 位元十六進位字串,常用於數字簽章與複雜加密系統中的完整性校驗。單獨使用時因撞庫風險而安全性偏低,正式系統應搭配加鹽或改用更強的演算法。
- (NSString *)md5HexDigest {
const char *cstr = [self cStringUsingEncoding:NSUTF8StringEncoding];
unsigned char result[CC_MD5_DIGEST_LENGTH];
CC_MD5(cstr, (unsigned int)strlen(cstr), result);
NSMutableString *output = [NSMutableString stringWithCapacity:CC_MD5_DIGEST_LENGTH * 2];
for (int i = 0; i < CC_MD5_DIGEST_LENGTH; i++)
[output appendFormat:@"%02x", result[i]];
return output;
}
這裡以十六進位字串呈現結果,也可以依需求改為 Base64 或其他編碼。
SHA 依輸出長度分為多種版本,透過 CC_SHA256_DIGEST_LENGTH 等常數設定即可,依對長度的要求選擇。
- (NSString *)sha256HexDigest {
const char *cstr = [self cStringUsingEncoding:NSUTF8StringEncoding];
NSData *data = [NSData dataWithBytes:cstr length:self.length];
uint8_t digest[CC_SHA256_DIGEST_LENGTH];
CC_SHA256(data.bytes, (unsigned int)data.length, digest);
NSMutableString *output = [NSMutableString stringWithCapacity:CC_SHA256_DIGEST_LENGTH * 2];
for (int i = 0; i < CC_SHA256_DIGEST_LENGTH; i++)
[output appendFormat:@"%02x", digest[i]];
return output;
}
CommonKeyDerivation 提供的 PBKDF2 等金鑰推導方式。iOS 的 CommonCrypto 已經覆蓋了絕大多數日常加密需求,難點不在 API 而在「參數選對」:模式、填充、金鑰長度、編碼方式,任何一項與對端不一致就會解密失敗。跨平台對接前,建議先用線上工具驗證一組測試向量。若想快速上手,也可考慮 Keychain 保存憑證、以 CryptoSwift 等成熟庫取代裸 API。