跳到主要内容

iApp eKYC SDK 正式发布——面向 Flutter 与网页端的免费开源身份验证方案

· 5 分钟阅读
Kobkrit Viriyayudhakorn
Kobkrit Viriyayudhakorn
CEO @ iApp Technology

iApp eKYC——证件自动拍摄与面部活体检测

今天，我们正式发布 iApp eKYC SDK——一款基于 Apache-2.0 许可证、面向 Flutter 与网页端的免费开源 SDK，它将我们久经实战检验的 eKYC API 转化为完整的、开箱即用的身份验证体验。与此同时，我们还推出一款全新的 API 产品：面部主动活体检测（Face Active Liveness Detection），其返回的判定结果带有加密签名，您的后端可独立验证。

👉 立即在浏览器中体验：iapp.co.th/ekyc-demo——无需安装、无需注册即可观看实际效果。

为什么需要 SDK？​

多年来，我们的 eKYC API 一直服务于银行、保险公司与金融科技企业——但每一位客户都不得不重复构建同样棘手的客户端组件：摄像头控制、证件取景、模糊画面过滤、活体挑战交互。在第一次调用 API 之前，就要投入数月的开发工作。

iApp eKYC SDK 将上述全部能力打包提供，并针对真实的泰国证件进行了调优，完全免费。您只需提供 API 密钥，其余交给 SDK——仅为实际发生的 API 调用付费。

真正可靠的证件自动拍摄​

只需将摄像头对准证件，SDK 便会完成所有判断：

  • 支持六种证件——泰国身份证（正面与背面）、泰国驾照、护照、银行存折，以及带签名的身份证复印件。
  • 稍作稳定，即刻拍摄——SDK 在引导框中检测到证件后，等待短暂稳定即自动拍摄，无需快门按钮。
  • 按证件类型显示的引导图——屏幕上展示每种证件的示意图（照片位置、芯片、国旗、MRZ），帮助用户一次对准。
  • 快门效果与定格预览——上传过程中，用户可以清楚看到实际提交的图像。
  • 空画面安全保护——只有当证件真正进入画面时拍摄管线才会启动，人脸、桌面或空白墙壁都不会触发误提交。

其背后是一条经受真实环境考验的 OpenCV 处理管线：反光、身份证背面浅淡的激光刻印文字、以及手持证件贴近画面边缘等情况均可应对。

全新产品：面部主动活体检测​

被动活体检测仅分析单张自拍照，而主动活体检测能够证明镜头前确实有一位配合操作的真人：SDK 在设备端发出随机挑战动作——眨眼、向左转头、向右转头、微笑——并通过设备端人脸关键点进行跟踪（内置自适应眨眼检测，佩戴眼镜亦可使用），选出最清晰的正面帧，连同完整的挑战日志一并提交。

服务器随后使用通过 iBeta PAD Level 1 认证的防伪引擎复核自拍照，并返回签名判定结果：

  • HMAC-SHA256 签名覆盖整个判定结果——被篡改的客户端无法伪造"通过"结论
  • 自拍照的 SHA-256 值包含在签名数据内，将图像与判定结果绑定
  • 挑战日志校验可识别重放或伪造的会话
  • 每次请求 1 IC，检测完成即计费，无论判定结果为通过或不通过

更简单的人脸比对与被动活体检测​

SDK 还为现有人脸 API 提供了一步到位的辅助方法：captureFace() 从摄像头自动抓拍正面自拍照，verifyFaces() / checkPassiveLiveness() 负责提交——非常适合双人脸比对或单张照片防伪场景。

约十行代码即可集成​

<script src="https://iapp.co.th/sdk/ekyc-sdk.umd.js"></script>
<script>
  const ekyc = new IappEkyc.IappEkyc({ apiKey: 'YOUR_API_KEY' });
  const result = await ekyc.captureDocument({
    mount: document.getElementById('camera'),
    documentType: 'thaiIdFront',
    locale: 'zh',
  });
  console.log(result.raw); // 结构化的身份证字段
</script>

偏好 npm？执行 npm install @iapp-technology/ekyc-sdk 即可。移动端方面，Flutter 包提供完全一致的 API。界面内置泰语、英语与中文，并配有可定制的浅蓝主题。

费用几何？​

SDK 完全免费——API 按量计费，无最低消费：

API价格
泰国身份证 OCR（正面 / 背面）1.25 / 0.75 IC 每页
护照 OCR0.75 IC 每页
人脸比对0.3 IC 每次请求
面部被动活体检测0.3 IC 每次请求
面部主动活体检测（签名判定结果）1 IC 每次请求

一次完整的开户流程——证件 OCR + 主动活体检测 + 人脸比对——仅需 2.55 IC，约 ฿3.2。新账户可获赠 50 IC 免费额度，足以完成约 19 次完整验证，且无需信用卡。

立即开始​

  1. 观看实际效果： 实时演示
  2. 阅读文档： SDK 入门指南
  3. 获取代码： github.com/iapp-technology/iapp-ekyc-sdk
  4. 创建免费 API 密钥： iapp.co.th/register

我们打造这款 SDK 的初衷，是让泰国应用集成银行级身份验证只需一个下午，而非一个季度。欢迎您的 Star、Issue 与 Pull Request。