Hiện nay, việc xác thực bằng vân tay đã trở nên phổ biến khi việc thanh toán online đã quá quen thuộc với chúng ta.
Bài viết hôm nay mình cũng muốn hướng đến chủ đề này, làm cách nào để chúng ta có thể triển khai việc xác thực bằng vân tay trong Android, chỉ 4 bước cơ bản, chúng ta cùng bắt đầu nhé!
Bước 1: Thêm những quyền cho phép vào AndroidManifest.xml
1 2 3 4 5 6 7 8 9 10 11 | <span class="token operator"><</span>manifest xmlns<span class="token operator">:</span>android<span class="token operator">=</span><span class="token string">"http://schemas.android.com/apk/res/android"</span> <span class="token keyword">package</span><span class="token operator">=</span><span class="token string">"com.an.biometric"</span><span class="token operator">></span> <span class="token operator"><</span><span class="token operator">!</span><span class="token operator">--</span> Step <span class="token number">1</span><span class="token operator">:</span> Add the following permission to the app <span class="token operator">--</span><span class="token operator">></span> <span class="token operator"><</span>uses<span class="token operator">-</span>permission android<span class="token operator">:</span>name<span class="token operator">=</span><span class="token string">"android.permission.USE_BIOMETRIC"</span> <span class="token operator">/</span><span class="token operator">></span> <span class="token operator"><</span><span class="token operator">!</span><span class="token operator">--</span> Step <span class="token number">2</span><span class="token operator">:</span> This permission is depreciated in Android P <span class="token operator">--</span><span class="token operator">></span> <span class="token operator"><</span>uses<span class="token operator">-</span>permission android<span class="token operator">:</span>name<span class="token operator">=</span><span class="token string">"android.permission.USE_FINGERPRINT"</span> <span class="token operator">/</span><span class="token operator">></span> <span class="token operator"><</span><span class="token operator">/</span>manifest<span class="token operator">></span> |
Bước 2: Kiểm tra nếu thiết bị hỗ trợ xác thực sinh trắc học(Biometric authentication)
Chúng ta sẽ kiểm tra các điều kiện :
- Thiết bị đang chạy Android 6.0 trở lên
- Thiết bị có cảm biến vân tay
- Người dùng đã cấp cho ứng dụng của bạn quyền truy cập vào cảm biến vân tay.
- Người dùng đã đăng ký ít nhất một dấu vân tay trên thiết bị của họ.
Chúng ta có thể tạo một lớp Util để kiểm tra các điều kiện trên:
public class BiometricUtils {
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 | <span class="token keyword">public</span> <span class="token keyword">class</span> <span class="token class-name">BiometricUtils</span> <span class="token punctuation">{</span> <span class="token keyword">public</span> <span class="token keyword">static</span> <span class="token keyword">boolean</span> <span class="token function">isBiometricPromptEnabled</span><span class="token punctuation">(</span><span class="token punctuation">)</span> <span class="token punctuation">{</span> <span class="token keyword">return</span> <span class="token punctuation">(</span>Build<span class="token punctuation">.</span>VERSION<span class="token punctuation">.</span>SDK_INT <span class="token operator">>=</span> Build<span class="token punctuation">.</span>VERSION_CODES<span class="token punctuation">.</span>P<span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token punctuation">}</span> <span class="token comment">/* * Condition I: Check if the android version in device is greater than * Marshmallow, since fingerprint authentication is only supported * from Android 6.0. * Note: If your project's minSdkversion is 23 or higher, * then you won't need to perform this check. * * */</span> <span class="token keyword">public</span> <span class="token keyword">static</span> <span class="token keyword">boolean</span> <span class="token function">isSdkVersionSupported</span><span class="token punctuation">(</span><span class="token punctuation">)</span> <span class="token punctuation">{</span> <span class="token keyword">return</span> <span class="token punctuation">(</span>Build<span class="token punctuation">.</span>VERSION<span class="token punctuation">.</span>SDK_INT <span class="token operator">>=</span> Build<span class="token punctuation">.</span>VERSION_CODES<span class="token punctuation">.</span>M<span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token punctuation">}</span> <span class="token comment">/* * Condition II: Check if the device has fingerprint sensors. * Note: If you marked android.hardware.fingerprint as something that * your app requires (android:required="true"), then you don't need * to perform this check. * * */</span> <span class="token keyword">public</span> <span class="token keyword">static</span> <span class="token keyword">boolean</span> <span class="token function">isHardwareSupported</span><span class="token punctuation">(</span>Context context<span class="token punctuation">)</span> <span class="token punctuation">{</span> FingerprintManagerCompat fingerprintManager <span class="token operator">=</span> FingerprintManagerCompat<span class="token punctuation">.</span><span class="token function">from</span><span class="token punctuation">(</span>context<span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token keyword">return</span> fingerprintManager<span class="token punctuation">.</span><span class="token function">isHardwareDetected</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token punctuation">}</span> <span class="token comment">/* * Condition III: Fingerprint authentication can be matched with a * registered fingerprint of the user. So we need to perform this check * in order to enable fingerprint authentication * * */</span> <span class="token keyword">public</span> <span class="token keyword">static</span> <span class="token keyword">boolean</span> <span class="token function">isFingerprintAvailable</span><span class="token punctuation">(</span>Context context<span class="token punctuation">)</span> <span class="token punctuation">{</span> FingerprintManagerCompat fingerprintManager <span class="token operator">=</span> FingerprintManagerCompat<span class="token punctuation">.</span><span class="token function">from</span><span class="token punctuation">(</span>context<span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token keyword">return</span> fingerprintManager<span class="token punctuation">.</span><span class="token function">hasEnrolledFingerprints</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token punctuation">}</span> <span class="token comment">/* * Condition IV: Check if the permission has been added to * the app. This permission will be granted as soon as the user * installs the app on their device. * * */</span> <span class="token keyword">public</span> <span class="token keyword">static</span> <span class="token keyword">boolean</span> <span class="token function">isPermissionGranted</span><span class="token punctuation">(</span>Context context<span class="token punctuation">)</span> <span class="token punctuation">{</span> <span class="token keyword">return</span> ActivityCompat<span class="token punctuation">.</span><span class="token function">checkSelfPermission</span><span class="token punctuation">(</span>context<span class="token punctuation">,</span> Manifest<span class="token punctuation">.</span>permission<span class="token punctuation">.</span>USE_FINGERPRINT<span class="token punctuation">)</span> <span class="token operator">==</span> PackageManager<span class="token punctuation">.</span>PERMISSION_GRANTED<span class="token punctuation">;</span> <span class="token punctuation">}</span> <span class="token punctuation">}</span> |
Bước 3: Hiển thị BiometricPrompt dialog
Khi các điều kiện ở bước 2 đã được kiểm tra hoàn tất, chúng ta có thể kiểm tra phiên bản Android trong thiết bị có phải là Android P không ? vì BIometricPrompt dialog chỉ được hỗ trợ trong Android P
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | <span class="token annotation punctuation">@TargetApi</span><span class="token punctuation">(</span>Build<span class="token punctuation">.</span>VERSION_CODES<span class="token punctuation">.</span>P<span class="token punctuation">)</span> <span class="token keyword">private</span> <span class="token keyword">void</span> <span class="token function">displayBiometricPrompt</span><span class="token punctuation">(</span><span class="token keyword">final</span> BiometricCallback biometricCallback<span class="token punctuation">)</span> <span class="token punctuation">{</span> <span class="token keyword">new</span> <span class="token class-name">BiometricPrompt<span class="token punctuation">.</span>Builder</span><span class="token punctuation">(</span>context<span class="token punctuation">)</span> <span class="token punctuation">.</span><span class="token function">setTitle</span><span class="token punctuation">(</span>title<span class="token punctuation">)</span> <span class="token punctuation">.</span><span class="token function">setSubtitle</span><span class="token punctuation">(</span>subtitle<span class="token punctuation">)</span> <span class="token punctuation">.</span><span class="token function">setDescription</span><span class="token punctuation">(</span>description<span class="token punctuation">)</span> <span class="token punctuation">.</span><span class="token function">setNegativeButton</span><span class="token punctuation">(</span>negativeButtonText<span class="token punctuation">,</span> context<span class="token punctuation">.</span><span class="token function">getMainExecutor</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">,</span> <span class="token keyword">new</span> <span class="token class-name">DialogInterface<span class="token punctuation">.</span>OnClickListener</span><span class="token punctuation">(</span><span class="token punctuation">)</span> <span class="token punctuation">{</span> <span class="token annotation punctuation">@Override</span> <span class="token keyword">public</span> <span class="token keyword">void</span> <span class="token function">onClick</span><span class="token punctuation">(</span>DialogInterface dialogInterface<span class="token punctuation">,</span> <span class="token keyword">int</span> i<span class="token punctuation">)</span> <span class="token punctuation">{</span> biometricCallback<span class="token punctuation">.</span><span class="token function">onAuthenticationCancelled</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token punctuation">}</span> <span class="token punctuation">}</span><span class="token punctuation">)</span> <span class="token punctuation">.</span><span class="token function">build</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token punctuation">}</span> |
Sử dụng BiometricPrompt Builder, chúng ta có thể:
- setTitle () – Đặt tiêu đề để hiển thị (Bắt buộc)
- setSubtitle () – Đặt phụ đề để hiển thị (Tùy chọn)
- setDes mô tả () – Đặt mô tả để hiển thị (Tùy chọn)
- setNegativeButton () – Đặt văn bản cho nút phủ định (Bắt buộc). Bạn cũng phải cung cấp một phiên bản Executor và một trình nghe nhấp cho nút phủ định.
Lưu ý: Bạn có thể tùy chỉnh biểu tượng hoặc thông báo lỗi được sử dụng trong dialog.
Bước 4: Xử lý việc xác thực qua các hàm callback
Tiếp theo, chúng ta sử dụng BiometricPrompt.AuthenticationCallback để lắng nghe các sự kiện xác thực từ người dùng. Nó bao gồm 4 phương thức:
onAuthenticationSceeded
Hàm này sẽ được chạy vào khi dấu vân tay đã được khớp thành công với một trong những dấu vân tay đã đăng ký trên thiết bị, từ đó đối tượng sẽ được xác thực
onAuthenticationFails
Hàm này sẽ được chạy vào khi vân tay không khớp với bất kỳ dấu vân tay nào được đăng ký trên thiết bị, thì cuộc gọi lại này sẽ được kích hoạt.
onAuthenticationError
Hàm này sẽ được chạy vào khi gặp phải một lỗi không thể phục hồi và quá trình xác thực đã hoàn thành mà không thành công. Hàm được cung cấp một mã lỗi để xác định nguyên nhân lỗi, cùng với thông báo lỗi. Các loại mã lỗi khác nhau có thể xảy ra là:
- BIOMETRIC_ERROR_LOCKOUT HỌ Hoạt động đã bị hủy vì API bị khóa do quá nhiều lần thử.
- BIOMETRIC_ERROR_LOCKOUT_PERMANENT – Thao tác đã bị hủy vì BIOMETRIC_ERROR_LOCKOUT xảy ra quá nhiều lần.
- BIOMETRIC_ERROR_NOClickACE – Không thể hoàn tất thao tác vì không còn đủ dung lượng để hoàn thành thao tác.
- BIOMETRIC_ERROR_TIMEOUT – Hết giờ xảy ra do yêu cầu hiện tại đã chạy quá lâu.
- BIOMETRIC_ERROR_UNABLE_TO_PROCESS – Cảm biến không thể xử lý hình ảnh hiện tại.
- BIOMETRIC_ERROR_USER_CANCELED – Người dùng đã hủy thao tác.
- BIOMETRIC_ERROR_VENDOR – Nếu có những điều kiện không thuộc một trong các loại trên.
- BIOMETRIC_ERROR_NO_BIOMETRICS – Người dùng không có bất kỳ sinh trắc học nào được đăng ký trong thiết bị.
- BIOMETRIC_ERROR_CANCELED – Thao tác đã bị hủy vì cảm biến sinh trắc học không khả dụng.
- BIOMETRIC_ERROR_HW_NOT_PRESENT – Thiết bị không có cảm biến sinh trắc học.
- BIOMETRIC_ERROR_HW_UNAVAILABLE – Phần cứng thiết bị không khả dụng.
onAuthenticationHelp
Hàm này được gọi khi xảy ra lỗi không nghiêm trọng trong quá trình xác thực. Callback sẽ được cung cấp một mã trợ giúp để xác định nguyên nhân lỗi, cùng với thông báo trợ giúp. Các loại mã trợ giúp khác nhau có thể xảy ra là:
- BIOMETRIC_ACQUIRED_IMAGER_DIRTY – Hình ảnh sinh trắc học quá nhiễu do nghi ngờ bụi bẩn trên cảm biến.
- BIOMETRIC_ACQUIRED_INSUFFICIENT – Hình ảnh sinh trắc học quá ồn để xử lý. Điều này có thể là do nhiều lý do nhưng nhìn chung điều này là do hình ảnh không thể đọc được.
- BIOMETRIC_ACQUIRED_PARTIAL – Chỉ một hình ảnh sinh trắc học được phát hiện.
- BIOMETRIC_ACQUIRED_TOO_FAST – Hình ảnh sinh trắc học không đầy đủ vì người dùng di chuyển ngón tay quanh cảm biến quá nhanh.
- BIOMETRIC_ACQUIRED_TOO_SLOW – Không thể đọc được hình ảnh sinh trắc học do thiếu chuyển động từ người dùng xung quanh cảm biến.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 | <span class="token annotation punctuation">@RequiresApi</span><span class="token punctuation">(</span>api <span class="token operator">=</span> Build<span class="token punctuation">.</span>VERSION_CODES<span class="token punctuation">.</span>P<span class="token punctuation">)</span> <span class="token keyword">public</span> <span class="token keyword">class</span> <span class="token class-name">BiometricCallbackV28</span> <span class="token keyword">extends</span> <span class="token class-name">BiometricPrompt<span class="token punctuation">.</span>AuthenticationCallback</span> <span class="token punctuation">{</span> <span class="token keyword">private</span> BiometricCallback biometricCallback<span class="token punctuation">;</span> <span class="token keyword">public</span> <span class="token function">BiometricCallbackV28</span><span class="token punctuation">(</span>BiometricCallback biometricCallback<span class="token punctuation">)</span> <span class="token punctuation">{</span> <span class="token keyword">this</span><span class="token punctuation">.</span>biometricCallback <span class="token operator">=</span> biometricCallback<span class="token punctuation">;</span> <span class="token punctuation">}</span> <span class="token annotation punctuation">@Override</span> <span class="token keyword">public</span> <span class="token keyword">void</span> <span class="token function">onAuthenticationSucceeded</span><span class="token punctuation">(</span>BiometricPrompt<span class="token punctuation">.</span>AuthenticationResult result<span class="token punctuation">)</span> <span class="token punctuation">{</span> <span class="token keyword">super</span><span class="token punctuation">.</span><span class="token function">onAuthenticationSucceeded</span><span class="token punctuation">(</span>result<span class="token punctuation">)</span><span class="token punctuation">;</span> biometricCallback<span class="token punctuation">.</span><span class="token function">onAuthenticationSuccessful</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token punctuation">}</span> <span class="token annotation punctuation">@Override</span> <span class="token keyword">public</span> <span class="token keyword">void</span> <span class="token function">onAuthenticationHelp</span><span class="token punctuation">(</span><span class="token keyword">int</span> helpCode<span class="token punctuation">,</span> CharSequence helpString<span class="token punctuation">)</span> <span class="token punctuation">{</span> <span class="token keyword">super</span><span class="token punctuation">.</span><span class="token function">onAuthenticationHelp</span><span class="token punctuation">(</span>helpCode<span class="token punctuation">,</span> helpString<span class="token punctuation">)</span><span class="token punctuation">;</span> biometricCallback<span class="token punctuation">.</span><span class="token function">onAuthenticationHelp</span><span class="token punctuation">(</span>helpCode<span class="token punctuation">,</span> helpString<span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token punctuation">}</span> <span class="token annotation punctuation">@Override</span> <span class="token keyword">public</span> <span class="token keyword">void</span> <span class="token function">onAuthenticationError</span><span class="token punctuation">(</span><span class="token keyword">int</span> errorCode<span class="token punctuation">,</span> CharSequence errString<span class="token punctuation">)</span> <span class="token punctuation">{</span> <span class="token keyword">super</span><span class="token punctuation">.</span><span class="token function">onAuthenticationError</span><span class="token punctuation">(</span>errorCode<span class="token punctuation">,</span> errString<span class="token punctuation">)</span><span class="token punctuation">;</span> biometricCallback<span class="token punctuation">.</span><span class="token function">onAuthenticationError</span><span class="token punctuation">(</span>errorCode<span class="token punctuation">,</span> errString<span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token punctuation">}</span> <span class="token annotation punctuation">@Override</span> <span class="token keyword">public</span> <span class="token keyword">void</span> <span class="token function">onAuthenticationFailed</span><span class="token punctuation">(</span><span class="token punctuation">)</span> <span class="token punctuation">{</span> <span class="token keyword">super</span><span class="token punctuation">.</span><span class="token function">onAuthenticationFailed</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span> biometricCallback<span class="token punctuation">.</span><span class="token function">onAuthenticationFailed</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token punctuation">}</span> <span class="token punctuation">}</span> |
Kết luận
Như vậy với 4 bước cơ bản, chúng ta có thể triển khai việc xác thực đăng nhập bằng vân tay vào trong project của mình
Tài liệu tham khảo
https://proandroiddev.com/5-steps-to-implement-biometric-authentication-in-android-dbeb825aeee8