Tổng quan Flash Liveness SDK
Flash Liveness SDK hỗ trợ xác thực khuôn mặt bằng camera, gửi dữ liệu liveness lên backend và trả kết quả về ứng dụng host. SDK có thể dùng cho hai nhóm flow chính:
- Live check: xác thực người dùng hiện tại có phải người thật và khớp với dữ liệu backend hay không.
- Register face: đăng ký ảnh khuôn mặt ban đầu nếu business flow của đối tác yêu cầu.
Thông tin tích hợp cần chuẩn bị
| Thông tin | Bắt buộc | Ghi chú |
|---|
appId | Có | Mã ứng dụng/đối tác do backend cấp |
baseURL/url | Có | Base URL API liveness |
publicKey | Có | Public key dùng cho mã hóa/xác thực request |
privateKey | Có | Private key dùng cho ký request |
| GitHub token/SSH key | Có | Dùng để tải package private từ GitHub Packages hoặc private repo |
| Custom headers/params | Tùy flow | Ví dụ Authorization, customerId, clientTransactionId |
| Camera permission | Có | App host phải khai báo và xin quyền trước khi mở SDK |
Ma trận nền tảng
| Nền tảng | Version | Cách cài đặt | Yêu cầu tối thiểu |
|---|
| Android native | 1.7.23 | Maven/GitHub Packages | Android minSdk 24, Java 17 khuyến nghị |
| iOS native | 1.4.8 | CocoaPods private git tag | iOS 13.0+, thiết bị thật |
| Flutter | 1.6.14 | Git dependency | Flutter >=3.38.5 <4.0.0, Dart ^3.10.4 |
Quy tắc xử lý lifecycle
- Chỉ start liveness sau khi SDK đã được setup/init thành công.
- Không truyền
applicationContext cho flow Android mở camera bằng Activity; dùng Activity hiện tại.
- Với iOS, tạo detector sau khi
previewView đã có layout ổn định và giữ strong reference tới detector.
- Khi màn hình bị đóng, app cần dừng hoặc release camera session theo API của từng nền tảng.
- Với Flutter, đặt
FlashLivenessLiveCheckView trong màn hình riêng full-screen hoặc gần full-screen.
Quy ước bảo mật
- Không commit token GitHub,
privateKey hoặc credential backend vào repository.
- Không bật log debug chi tiết trên production.
- Nếu app cần truyền header xác thực, ưu tiên lấy token ngắn hạn từ backend của đối tác.
- Với khóa RSA nhiều dòng, thống nhất format với backend trước khi triển khai production.