ตรวจสอบใบหน้าจริงแบบ Active

SDK ให้ผู้ใช้ทำท่าแบบสุ่มสามท่าบนอุปกรณ์ แล้วส่งเซลฟี่ที่ดีที่สุดไปยัง Face Active Liveness API ซึ่งส่งผลตัดสินที่ลงนามด้วย HMAC-SHA256 กลับมา คิด 1 IC ต่อเซสชันที่สรุปผลแล้ว

เรียกใช้

Flutter

import 'package:iapp_ekyc_sdk/iapp_ekyc_sdk.dart';

final client = IappEkycClient(apiKey: 'YOUR_API_KEY');

final liveness = await ActiveLivenessView.start(context, client: client);

if (liveness.verdict.passed) {
  // ส่ง liveness.verdict + liveness.signature ไปยังแบ็กเอนด์ของคุณ
  // ตรวจสอบ HMAC ที่นั่น แล้วดำเนินการต่อด้วยการลงทะเบียน
}

Web

import { IappEkyc } from '@iapp-technology/ekyc-sdk';

const ekyc = new IappEkyc({ apiKey: 'YOUR_API_KEY' });

const liveness = await ekyc.startActiveLiveness({
  mount: document.getElementById('ekyc-mount'),
});

if (liveness.verdict.passed) {
  // ส่ง liveness.verdict + liveness.signature ไปยังแบ็กเอนด์ของคุณเพื่อตรวจสอบ
}

iOS

// iOS (Swift; Objective-C ก็รองรับ)
let config = IappEkycConfig(apiKey: "YOUR_API_KEY", flow: .activeLiveness)
IappEkycSdk.present(from: self, config: config) { result in
    // ตรวจสอบ verdictJSON + signature บนแบ็กเอนด์ของคุณก่อนที่จะเชื่อถือ `passed`
}

Android

// Android (Kotlin; Java ก็รองรับ)
ekyc.launch(IappEkycRequest.ActiveLiveness(config))

React Native

// React Native
<IappEkycFlow flow="activeLiveness" apiKey="YOUR_API_KEY"
  onResult={handleResult} onError={handleError} onCancel={close} />

วิธีติดตั้ง: เริ่มต้นใช้งาน สำหรับ Flutter และ Web ส่วน wrapper แบบ native และสิทธิ์ใช้กล้องดูที่ iOS, Android & React Native

ผลลัพธ์

ผลลัพธ์มี verdict และ signature ที่มาจากเซิร์ฟเวอร์ ส่วนผลที่ได้บนอุปกรณ์ใช้แค่แสดงผลบนหน้าจอ

เชื่อเฉพาะผลตัดสินที่ลงนามแล้ว

ไคลเอนต์ที่ถูกดัดแปลงปลอมผลการทำท่าบนอุปกรณ์ได้ backend ของคุณต้องคำนวณ HMAC-SHA256(secret, canonicalJSON(verdict)) ใหม่แล้วเทียบกับ signature ก่อนเชื่อ verdict.passed ดู ตัวอย่างการตรวจลายเซ็น

เซสชันทำงานอย่างไร

• ล็อกใบหน้า: ต้องมีใบหน้าตรงเพียงหน้าเดียว ใหญ่และอยู่กลางกรอบพอ และนิ่งก่อนเริ่มทำท่า
• ท่าที่ต้องทำ: สุ่มสามท่าไม่ซ้ำกันจากกะพริบตา หันซ้าย หันขวา และยิ้ม การกะพริบต้องหลับแล้วลืมตา การหันต้องได้มุม yaw อย่างน้อย 18° แล้วกลับมาตรงกลาง การยิ้มต้องยิ้มค้างไว้
• เริ่มท่าใหม่: ถ้าใบหน้าหลุดกรอบ มีใบหน้าที่สองเข้ามา หรือเปลี่ยนคน ท่าปัจจุบันจะเริ่มใหม่ ถ้าเริ่มใหม่หลายครั้งหรือหมดเวลา เซสชันจะไม่ผ่าน
• เซลฟี่: ทุกเฟรมที่คมชัด หน้าตรง และลืมตา จะได้คะแนนจากความคมชัดและขนาดใบหน้า เฟรมที่ดีที่สุดจะถูกส่งไปยังเซิร์ฟเวอร์
• ผลตัดสิน: เซิร์ฟเวอร์ตรวจบันทึกการทำท่า ตรวจเซลฟี่ซ้ำด้วย passive liveness แล้วลงนามผลตัดสิน

ข้อกำหนดฉบับเต็มอยู่ใน ซอร์สโค้ดของ SDK