近期公司的 App 要接入指紋支付,整體流程算順利,但中間確實踩到幾個坑,整理如下。

展開這個 framework,主要能看到幾個標頭檔:

LocalAuthentication.framework - LAContext.h - LAError.h - LAPublicDefines.h - LocalAuthentication.h
LocalAuthentication.h 沒什麼好說的,就是兩行 import,把 LAContext.h 與 LAError.h 暴露出來給開發者使用。
顧名思義,這裡放的是各類預先定義好的巨集,會被 LAContext.h 引用:
// Policies #define kLAPolicyDeviceOwnerAuthenticationWithBiometrics 1 #define kLAPolicyDeviceOwnerAuthentication 2 // Options #define kLAOptionUserFallback 1 #define kLAOptionAuthenticationReason 2 // Error codes #define kLAErrorAuthenticationFailed -1 #define kLAErrorUserCancel -2 #define kLAErrorUserFallback -3 #define kLAErrorSystemCancel -4 #define kLAErrorPasscodeNotSet -5 #define kLAErrorTouchIDNotAvailable -6 #define kLAErrorTouchIDNotEnrolled -7 #define kLAErrorTouchIDLockout -8 #define kLAErrorAppCancel -9 #define kLAErrorInvalidContext -10 // Error domain #define kLAErrorDomain "com.apple.LocalAuthentication"
基本上就是把上面的巨集搬進列舉裡,註解寫得很清楚:
typedef NS_ENUM(NSInteger, LAError) {
LAErrorAuthenticationFailed, // 驗證資訊錯誤,也就是指紋不符
LAErrorUserCancel, // 使用者主動取消
LAErrorUserFallback, // 使用者點了「輸入密碼」
LAErrorSystemCancel, // 被系統取消,例如切到別的 App
LAErrorPasscodeNotSet, // 使用者未設定密碼
LAErrorTouchIDNotAvailable, // 裝置不支援 Touch ID
LAErrorTouchIDNotEnrolled, // 尚未錄入任何指紋
LAErrorTouchIDLockout, // 錯誤次數過多,已被鎖定
LAErrorAppCancel, // 驗證途中被其他 App 中斷
LAErrorInvalidContext // 驗證請求本身有誤
};
要在專案裡用 Touch ID,靠的就是這個類別。最醒目的是 LAPolicy 列舉:
typedef NS_ENUM(NSInteger, LAPolicy) {
LAPolicyDeviceOwnerAuthenticationWithBiometrics, // 僅用指紋驗證(iOS 8 起)
LAPolicyDeviceOwnerAuthentication // 指紋或密碼皆可(iOS 9 起)
};
差別在 WithBiometrics 與否:前者只接受指紋;後者在指紋錯誤兩次或系統鎖定後,會直接跳出密碼輸入介面。若你的產品定位是「必須本人驗證」,選前者;若重視使用者不被卡住,後者體驗更友善。
以下三個是實例方法,所以必須先建立物件才能呼叫:
LAContext *context = [[LAContext alloc] init];
// 檢查目前裝置是否可用 Touch ID,回傳 BOOL,不會跳出驗證框
- (BOOL)canEvaluatePolicy:(LAPolicy)policy error:(NSError * __autoreleasing *)error;
// 真正發起驗證,會跳出系統驗證框
- (void)evaluatePolicy:(LAPolicy)policy
localizedReason:(NSString *)localizedReason
reply:(void(^)(BOOL success, NSError * __nullable error))reply;
// 使這個 context 失效
- (void)invalidate;
evaluatePolicy 的三個參數分別是:政策列舉、顯示給使用者看的驗證理由(localizedReason 會直接出現在系統彈窗上,值得好好寫)、以及帶有 success 與 error 的回呼 block。
首次 Touch ID 樣式
錯誤後的 Touch ID 樣式
LACredentialType、LAAccessControlOperation 這組 API 從 NS_AVAILABLE(10_11, 9_0) 可看出需 iOS 9 以上,屬於較新的能力,用途是在 Touch ID 驗證之外再加一層應用層加密:
typedef NS_ENUM(NSInteger, LACredentialType) {
LACredentialTypeApplicationPassword = 0, // 目前僅有「應用密碼」一種,以 UTF-8 字串傳入
};
- (BOOL)setCredential:(nullable NSData *)credential type:(LACredentialType)type;
- (BOOL)isCredentialSet:(LACredentialType)type;
- (void)evaluateAccessControl:(SecAccessControlRef)accessControl
operation:(LAAccessControlOperation)operation
localizedReason:(NSString *)localizedReason
reply:(void(^)(BOOL success, NSError * __nullable error))reply;
typedef NS_ENUM(NSInteger, LAAccessControlOperation) {
LAAccessControlOperationCreateItem, // 建立加密項目
LAAccessControlOperationUseItem, // 使用加密項目
LAAccessControlOperationCreateKey, // 建立加密金鑰
LAAccessControlOperationUseKeySign // 使用金鑰簽章
};
@property (nonatomic, nullable, copy) NSString *localizedFallbackTitle; @property (nonatomic, nullable, copy) NSString *localizedCancelTitle; // iOS 10 才有 @property (nonatomic, nullable) NSNumber *maxBiometryFailures; // iOS 9 起廢棄 @property (nonatomic, nullable, readonly) NSData *evaluatedPolicyDomainState; @property (nonatomic) NSTimeInterval touchIDAuthenticationAllowableReuseDuration;
· localizedFallbackTitle:設定驗證彈窗上「輸入密碼」按鈕的文字。
· localizedCancelTitle:設定「取消」按鈕的文字,iOS 10 才可用。
· maxBiometryFailures:最大指紋嘗試次數。標記為 NS_DEPRECATED_IOS(8_3, 9_0),iOS 9 以上已無法使用。
· evaluatedPolicyDomainState:可偵測指紋資料庫是否變動(新增或刪除指紋)。
· touchIDAuthenticationAllowableReuseDuration:類似支付寶的行為——驗證成功後按 Home 回桌面,在設定時間內再次進入免驗證。預設 0 秒,最長可設 5 分鐘。
iOS 9 之前沒有 LAErrorTouchIDLockout 這個錯誤,預設錯誤 5 次後,第 6 次驗證會自動跳出密碼介面。
iOS 9 之後,指紋被鎖定時若要立刻叫出密碼介面,必須改用 LAPolicyDeviceOwnerAuthentication 重新發起驗證。另外,只要使用者輸入過螢幕鎖定密碼,指紋鎖定狀態就會解除。
iOS 8 錯誤 5 次鎖定後,第 6 次需密碼
支付寶與微信對鎖定的處理方式不同
前者只用來「檢查環境是否支援」,不會跳出驗證框;後者才會真正叫出系統驗證介面。別把兩者搞混,否則會出現「只是想檢查一下,結果跳出驗證框」的窘境。
預設首次驗證只有「取消」按鈕;錯誤一次之後才會出現 fallback(輸入密碼)按鈕。若不希望顯示,可將 localizedFallbackTitle 設為空字串 @""。
設為 @"" 後不顯示
設為「驗證登錄密碼」
localizedCancelTitle 是 iOS 10 才開放的,舊版本無法修改取消按鈕文字。
從呼叫 API 到系統驗證框真正出現,中間約需 2 秒左右,這是正常現象。支付寶與微信之所以在啟動時顯示 HUD,正是為了填補這段空白、緩解使用者等待時的焦慮。
還有一個關鍵細節:驗證完成後必須切回主執行緒再做後續處理,否則你會遇到「驗證成功了,UI 卻要等 4、5 秒才更新」的怪現象。
微信支付的 HUD 顯示
Demo 的 HUD 顯示
[SVProgressHUD show];
LAContext *context = [[LAContext alloc] init]; // 建議用 init 而非 new,確保屬性正常初始化
context.localizedFallbackTitle = @""; // 不顯示 fallback 按鈕
[context evaluatePolicy:LAPolicyDeviceOwnerAuthenticationWithBiometrics
localizedReason:@"請驗證已有指紋"
reply:^(BOOL success, NSError * _Nullable error) {
[SVProgressHUD dismiss];
// HUD 消失需約 0.15 秒,預留一點餘量再往下走
dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(0.3 * NSEC_PER_SEC)),
dispatch_get_main_queue(), ^{
if (success) {
NSLog(@"指紋識別成功");
dispatch_async(dispatch_get_main_queue(), ^{ /* 成功後的操作 */ });
}
if (error) {
NSLog(@"指紋識別失敗:%@", error);
dispatch_async(dispatch_get_main_queue(), ^{ /* 失敗後的操作 */ });
}
});
}];
Touch ID 的驗證彈窗屬於系統級,其 UIWindowLevel 高於 App 內部任何視窗,應用程式無法覆蓋它。要注意的是,這個彈窗出現與消失時,App 會收到:
- (void)applicationWillResignActive:(UIApplication *)application; - (void)applicationDidBecomeActive:(UIApplication *)application;
這意味著你的 App 會「假裝」自己被切到背景又切回來。如果你的程式在這兩個回呼裡做了什麼(例如統計 session、鎖定畫面),很可能會被 Touch ID 誤觸。實作時記得把這個情況排除掉。
蘋果官方文件的說法是:只有在 canEvaluatePolicy:error: 對生物特徵政策成功,或 evaluatePolicy:localizedReason:reply: 完成一次成功的 Touch ID 驗證之後,這個屬性才會回傳值,否則回傳 nil。
換句話說:當使用者新增或刪除指紋後,你成功驗證一次,evaluatedPolicyDomainState 就會回傳一個 NSData 物件;否則為 nil。不過要注意——這個資料只告訴你「變動過了」,不會告訴你「變成什麼樣」。它是一個不透明的結構,只能拿來跟上次的值做比較。
依此原理,就能在每次使用指紋時比對指紋庫是否變動,並做出對應處理(例如強制要求重新輸入密碼)。

以上就是本文的全部內容,希望能對大家有所幫助。