現(xiàn)在大多數(shù)需要用戶校驗(yàn)的APP都會(huì)加上指紋校驗(yàn)蚂且，方便簡(jiǎn)潔隘梨。
應(yīng)用場(chǎng)景
該指紋應(yīng)用到交易場(chǎng)景中舌菜，類似于支付寶的支付密碼以及指紋密碼纷妆。因?yàn)槟壳疤O果指紋驗(yàn)證成功之后并不會(huì)返回任何信息场梆，因此驗(yàn)證需要服務(wù)端的配置墅冷，一下是應(yīng)用中指紋校驗(yàn)流程
指紋校驗(yàn)流程
關(guān)鍵代碼
1、自己創(chuàng)建vc或油，然后調(diào)用getFingerCode即可寞忿，參數(shù)needFinger代表是否立即進(jìn)行指紋校驗(yàn)，可以在viewDidLoad中調(diào)用
//
// USTouchIDManager.swift
// NewUstock
//
// Created by amus on 2017/4/11.
// Copyright ? 2017年. All rights reserved.
//
import Foundation
import LocalAuthentication
import Toast_Swift
import RxSwift
import KeychainAccess
open class USTouchIDManager: NSObject {
// public static let instance = USTouchIDManager() // 做成單例block會(huì)有問題
// 解綁類型： 綁定顶岸，解鎖, 解綁
enum TouchIDInputType: Int{
case bind
case unlock
case unbind
}
fileprivate static let kKeyChainService = "com.amus.touchid" // keychain service
fileprivate static let kAPPTouchIDCode = "kAPPTouchIDCode" // 保存在keychain中的
fileprivate static var isShowing = false // 指紋識(shí)別是否已經(jīng)顯示出來
public static var isSetCode: Variable<Bool> = Variable(false) // 是否設(shè)置
fileprivate var cryptFingerCode: String? = nil
fileprivate var unbindBlock: (() -> Void)?
public var validatedHandler: ((Bool) -> (Void))? // 指紋驗(yàn)證成功之后回調(diào)
public var pretendServerFingerCode = "bfd434_22ufddnf" // 假裝成后臺(tái)返回的腔彰，其實(shí)是應(yīng)該后臺(tái)返回的，與用戶相關(guān)
/// 單例辖佣、外部不允許創(chuàng)建
// override init() {
// super.init()
// }
/// 指紋是否可用
///
/// - Returns: 是否可用
public static func isTouchIDAvaraible() -> Bool {
let context = LAContext()
var authError: NSError? = nil
if context.canEvaluatePolicy(.deviceOwnerAuthenticationWithBiometrics, error: &authError) {
return true
} else {
guard let error = authError as? LAError else {
return true
}
return self.dealTouchErrorInfo(error: error)
}
}
/// 有可能被鎖定導(dǎo)致指紋不可用
///
/// - Parameter error: 類型
/// - Returns: 指紋是否可用
fileprivate static func dealTouchErrorInfo(error: LAError) -> Bool {
switch error.code {
case .passcodeNotSet,
.touchIDNotAvailable,
.touchIDNotEnrolled:
return false
default:
return true
}
}
/// 獲取指紋code霹抛，獲取之后根據(jù)參數(shù)進(jìn)行一次指紋綁定
/// 該方法的功能主要是返回后臺(tái)的指紋code，然后保存在keychain中
///
/// - Parameter needFinger: 獲取之后是否進(jìn)行指紋識(shí)別卷谈，默認(rèn)不進(jìn)行
public func getFingerCode(_ needFinger: Bool = false) {
// 網(wǎng)絡(luò)處理杯拐，這里做相關(guān)的描述
/*
1、獲取后臺(tái)的指紋code世蔗，一段與用戶相關(guān)的字符串編碼信息
2端逼、將獲取的code進(jìn)行md5加密
*/
let fingerCode = self.pretendServerFingerCode // 假裝后臺(tái)返回了
self.cryptFingerCode = USTouchIDManager.getCryptFingerCode(fingerCode)
if needFinger {
self.bindTouckID()
}
}
/// MARK: - 綁定指紋
func bindTouckID() {
guard let code = self.cryptFingerCode else {
return
}
if USTouchIDManager.isShowing {
return
}
let context = LAContext()
context.localizedFallbackTitle = ""
var authError: NSError? = nil
if context.canEvaluatePolicy(.deviceOwnerAuthenticationWithBiometrics, error: &authError) {
USTouchIDManager.isShowing = true
UI.topViewController()?.view.makeToastActivity(.center)
context.evaluatePolicy(.deviceOwnerAuthenticationWithBiometrics, localizedReason: "驗(yàn)證指紋", reply: { (success, error) in
USTouchIDManager.isShowing = false
DispatchQueue.main.async {
UI.topViewController()?.view.hideToastActivity()
if success {
self.bindFingerCode(pwd: "", fingerCode: code)
}
else {
UI.topViewController()?.view.hideToastActivity()
guard let error = error as? LAError else {
return
}
self.dealErrorInfo(error: error, type: .bind)
}
}
})
}
else {
guard let error = authError as? LAError else {
return
}
DispatchQueue.main.async {
self.dealErrorInfo(error: error, type: .bind)
}
}
}
/// 綁定指紋信息，這里需要跟后臺(tái)一起操作
///
/// - Parameters:
/// - pwd: 之前輸入的密碼
/// - fingerCode: 加密后的指紋code
public func bindFingerCode(pwd: String, fingerCode: String){
/*
1污淋、調(diào)用后臺(tái)接口顶滩，傳遞指紋驗(yàn)證之前的密碼驗(yàn)證，這一步也可以不要寸爆，還需要服務(wù)端返回的指紋code
2诲祸、后臺(tái)接口調(diào)用成功之后，將傳遞給后臺(tái)的fingerCode保存在keychain中
USTouchIDManager.saveFingerCode(fingerCode)
*/
UI.topViewController()?.view.makeToast("綁定成功")
}
/// MARK: - 驗(yàn)證指紋
/// 校驗(yàn)指紋解鎖
///
/// - Parameter code: 指紋code
public func validateTouchID(_ code: String) {
if USTouchIDManager.isShowing {
return
}
let context = LAContext()
context.localizedFallbackTitle = "交易密碼"
if #available(iOS 10.0, *) {
context.localizedCancelTitle = "取消"
}
var authError: NSError? = nil
if context.canEvaluatePolicy(.deviceOwnerAuthenticationWithBiometrics, error: &authError) {
USTouchIDManager.isShowing = true
UI.topViewController()?.view.makeToastActivity(.center)
context.evaluatePolicy(.deviceOwnerAuthenticationWithBiometrics, localizedReason: "驗(yàn)證指紋", reply: { (success, error) in
USTouchIDManager.isShowing = false
DispatchQueue.main.async {
UI.topViewController()?.view.hideToastActivity()
if success {
self.loginWithFingerCode(code)
}
else {
guard let error = error as? LAError else {
return
}
self.dealErrorInfo(error: error, type: .unlock)
}
}
})
}
else {
guard let error = authError as? LAError else {
return
}
DispatchQueue.main.async {
self.dealErrorInfo(error: error, type: .unlock)
}
}
}
/// 校驗(yàn)指紋而昨，更新tradeToken
///
/// - Parameter code: 指紋code
fileprivate func loginWithFingerCode(_ code: String) {
/*
1救氯、調(diào)用后臺(tái)接口，校驗(yàn)指紋
2歌憨、校驗(yàn)完成之后可以調(diào)用block着憨，這樣在調(diào)用改類的地方可以用block做一些事情
*/
UI.topViewController()?.view.makeToast("校驗(yàn)成功")
}
/// 指紋解綁成功回掉
///
/// - Parameter unbindBlock: block
public func unbindSuccess(_ unbindBlock: @escaping () -> Void) {
self.unbindBlock = unbindBlock
}
/// 解綁指紋， 可以使用交易密碼解綁 -- 該方法不再使用务嫡，使用密碼解綁
/// 這個(gè)方法可以不需要了甲抖，解綁指紋，直接使用其他方式心铃，可以是交易密碼准谚，也可以是直接點(diǎn)擊，也可以是手機(jī)號(hào)解綁
public func unbindTouchID() {
let context = LAContext();
context.localizedFallbackTitle = "交易密碼"
if #available(iOS 10.0, *) {
context.localizedCancelTitle = "取消"
}
var authError: NSError? = nil;
if context.canEvaluatePolicy(.deviceOwnerAuthenticationWithBiometrics, error: &authError) {
USTouchIDManager.isShowing = true
context.evaluatePolicy(.deviceOwnerAuthenticationWithBiometrics, localizedReason: "驗(yàn)證指紋", reply: { (success, error) in
USTouchIDManager.isShowing = false
DispatchQueue.main.async {
if success {
USTouchIDManager.clearFingerCode()
}
else {
guard let error = error as? LAError else {
return
}
self.dealErrorInfo(error: error, type: .unbind)
}
}
})
}
else {
guard let error = authError as? LAError else {
return
}
DispatchQueue.main.async {
self.dealErrorInfo(error: error, type: .unbind)
}
}
}
/// 處理指紋識(shí)別去扣，或者另一個(gè)按鈕的點(diǎn)擊
///
/// - Parameters:
/// - error: 錯(cuò)誤信息
/// - type: 指紋處理類型
@discardableResult
fileprivate func dealErrorInfo(error: LAError, type: TouchIDInputType = TouchIDInputType.unlock) -> Bool {
var flag = false
switch error.code {
case .authenticationFailed:
//SSLog("身份驗(yàn)證多次失敗: 因?yàn)橛脩粑茨芴峁┯行矸葑C件.")
self.dealAuthenticationFailed(type: type)
flag = true
case .userCancel:
//SSLog("身份驗(yàn)證被用戶取消: (例如: 點(diǎn)擊 [取消] 按鈕).")
flag = true
case .userFallback:
// 輸入密碼后續(xù)操作
// .deviceOwnerAuthenticationWithBiometrics 模式下點(diǎn)擊輸入密碼才會(huì)觸發(fā)此錯(cuò)誤
//SSLog("身份驗(yàn)證被取消: 因?yàn)橛脩粼?\"首次驗(yàn)證失敗后\" 的 \"第二次驗(yàn)證中\(zhòng)" 點(diǎn)擊了 [輸入密碼] 按鈕.")
//USTradePasswordAlertView().show()
// 這里會(huì)彈出指紋的輸入密碼（這個(gè)按鈕自定義的文字柱衔，操作也在這里自定義）
flag = true
case .systemCancel:
// SSLog("身份驗(yàn)證被系統(tǒng)取消: (例如: 另一個(gè)應(yīng)用程序準(zhǔn)備切換到前臺(tái)).")
flag = true
case .passcodeNotSet:
// SSLog("身份驗(yàn)證無(wú)法啟動(dòng): 因?yàn)闆]有在設(shè)備上設(shè)置密碼 (只有設(shè)置設(shè)備的鎖屏密碼, 才能開啟 Touch ID).")
break
case .touchIDNotAvailable:
// SSLog("身份驗(yàn)證無(wú)法啟動(dòng): 因?yàn)?Touch ID 不可用 (例如: Touch ID 損壞、設(shè)備沒有指紋識(shí)別硬件模塊...).")
break
case .touchIDNotEnrolled:
// SSLog("身份驗(yàn)證無(wú)法啟動(dòng): 因?yàn)闆]有設(shè)置指紋.")
break
case .touchIDLockout:
// SSLog("身份驗(yàn)證失敗: 因?yàn)槎啻螄L試失敗, Touch ID 被鎖定, 需要通過驗(yàn)證鎖屏密碼來重新啟用 Touch ID.")
self.dealTouchIDLockout(type: type)
flag = true
case .appCancel:
// SSLog("身份驗(yàn)證被 App 取消")
flag = true
default:
flag = true
}
return flag
}
/// 處理指紋失敗三次或者多次的情況
///
/// - Parameter type: 進(jìn)行指紋操作的類型
fileprivate func dealAuthenticationFailed(type: TouchIDInputType = .unlock) {
switch type {
case .bind, .unbind:
break
case .unlock:
// 指紋驗(yàn)證多次失敗處理
// USTradePasswordAlertView().show()
break
}
}
/// 處理指紋鎖定需要手機(jī)密碼的情況，密碼輸入成功唆铐，也算指紋成功（這里可以自己處理）
fileprivate func dealTouchIDLockout(type: TouchIDInputType = .unlock) {
switch type {
case .bind, .unbind:
let action1 = UIAlertAction(title: "取消", style: .cancel, handler: nil)
let alert: UIAlertController = UIAlertController(title: "Touch ID 被鎖定", message: "Touch ID 已經(jīng)被鎖定哲戚，請(qǐng)去設(shè)置中打開Touch ID", preferredStyle: .alert)
alert.addAction(action1)
UI.topViewController()?.us.present(alert)
case .unlock:
let action1 = UIAlertAction(title: "取消", style: .cancel, handler: nil)
let action2 = UIAlertAction(title: "交易密碼", style: .default, handler: { (action) in
// 交易密碼的處理，touchid鎖定之后艾岂，需要其他的方式解鎖
})
let alert = UIAlertController(title: "Touch ID 被鎖定", message: "Touch ID 已經(jīng)被鎖定顺少，請(qǐng)去設(shè)置中打開Touch ID或者輸入密碼", preferredStyle: .alert)
alert.addAction(action1)
alert.addAction(action2)
UI.topViewController()?.us.present(alert)
break
}
}
}
// MARK: - 指紋相關(guān)操作
extension USTouchIDManager {
/// 根據(jù)給定的code獲取md5加密后的code
///
/// - Parameter originCode: 原始code
/// - Returns: 加密后的code
fileprivate static func getCryptFingerCode(_ originCode: String) -> String? {
guard let cryptoCode = Utils.password(originCode) else {
UI.topViewController()?.view.makeToast("請(qǐng)勿在密碼中添加特殊字符")
return nil
}
return cryptoCode
}
/// 獲取保存在本地的指紋code，已經(jīng)md5加密
///
/// - Returns: 指紋code
public static func getKeychainFingerCode() -> String? {
let keychain = Keychain(service: kKeyChainService)
return keychain[kAPPTouchIDCode]
}
/// 使用md5加密后保存在keychain之中的fingercode
///
/// - Parameter code: 加密后的fingerCode
public static func saveFingerCode(_ code: String) {
let keychain = Keychain(service: kKeyChainService)
keychain[kAPPTouchIDCode] = code
self.isSetCode.value = true
}
/// 清除用戶指紋信息
public static func clearFingerCode() {
let keychain = Keychain(service: kKeyChainService)
keychain[kAPPTouchIDCode] = nil
self.isSetCode.value = false
}
}
注意事項(xiàng)
1王浴、iOS指紋識(shí)別采用的是3+2驗(yàn)證脆炎，第一次驗(yàn)證未通過，允許用戶設(shè)置一個(gè)確定按鈕氓辣，確定按鈕可以用來輸入自己的交易密碼腕窥，也可以調(diào)用系統(tǒng)的解鎖密碼。如果5次都輸入失敗筛婉，iOS10不會(huì)彈出系統(tǒng)解鎖密碼輸入界面簇爆，需要手動(dòng)再調(diào)用一次指紋。我這邊的處理是直接彈出自己的交易密碼爽撒。
