全部产品
Search
文档中心

ID Verification:设备助手独立接入指引

更新时间:Sep 17, 2026

设备助手是实人认证(ID Verification)产品的轻量化替代方案,适用于无法完整集成实人认证服务的业务场景。该方案基于通义文本大模型,对认证环境的设备风险进行深度分析,实现潜在风险的独立检测。

接入概述

重要
  • 接入设备助手方案需满足以下前置条件:业务方需具备成熟的人脸识别算法,以及完善的风险策略运营体系。建议在接入前与商务经理沟通,评估业务场景与方案的匹配度。

  • 设备助手方案可识别不同客户端的设备风险。各客户端平台对系统运行环境及权限的要求存在差异,具体配置要求请查阅对应客户端接入文档中的“使用须知”章节。

设备助手方案的整体业务流程为:客户端采集设备信息并上报至服务端进行风险识别,业务方通过服务端查询接口获取详细的设备风险标签。

接入该方案需同时构建应用服务端(以下简称“服务端”)与客户端。具体交互逻辑可参考下方时序图。

image

设备助手方案的整体业务流程分为以下两个阶段:

  • 第一阶段(采集上报):仅在客户端执行。SDK 将自动与设备助手服务端建立通信并完成信息上报,因此需确保客户端具备访问阿里云服务器的网络权限。

  • 第二阶段(结果获取与业务处理):需结合服务端完成。服务端调用查询接口获取风险检测结果,执行相应业务逻辑后,将最终处理结果返回至客户端。

若业务同时接入非阿里云人脸服务,在客户端发起调用时需遵循以下时序规范:

  • 初始化时机1:建议在用户进入认证引导页或更早阶段调用 SDK 初始化接口,确保在人脸认证启动前完成环境准备。

  • Token 获取时机2:建议在用户完成所有刷脸动作后调用 getDeviceToken 接口,且与初始化操作保持至少 3 秒的时间间隔。

调用 getDeviceToken 接口时需传入 bizId(本次刷脸认证的唯一标识),用于将设备令牌与业务认证记录绑定。服务端查询风险结果时可通过传入 bizId 验证匹配关系,确保检测结果与业务场景的一致性。