当前位置：首页 > news >正文

H5考试场景下腾讯云人脸核身全流程实战

news 2026/4/24 14:45:05

1. 为什么在线考试需要人脸核身？

在线考试作弊一直是教育行业头疼的问题。去年我参与过一个公务员考试系统的开发，监考老师反馈说抓到过有人替考——考生A注册账号，实际考试时却让成绩更好的考生B来操作电脑。这种作弊手段在传统考场很容易识别，但在线上环境中就变得隐蔽得多。

人脸核身技术正好能解决这个问题。它通过对比考生实时拍摄的面部图像与身份证照片，确保"账号注册人=实际考试人"。腾讯云的人脸核身服务特别适合H5场景，因为：

无需安装APP：考生用手机浏览器就能完成验证
活体检测防伪：能识别照片、视频、面具等伪造手段
秒级响应：平均验证时间在2秒内完成

实际测试中，我们发现在4G网络环境下，从点击验证到返回结果的全流程平均耗时仅3.8秒，这对考试场景的流畅性至关重要。

2. 接入前的准备工作

2.1 开通腾讯云人脸核身服务

第一次使用时，需要先登录腾讯云控制台（https://console.cloud.tencent.com/）。在搜索框输入"人脸核身"，选择"人脸核身·基础版"服务。这里有个小技巧：新用户通常有1万次的免费调用额度，足够中小型考试系统做前期测试。

开通时需要特别注意两个配置项：

业务场景：选择"教育-在线考试"
核验模式：建议选"姓名+身份证号+人脸比对"

我曾经踩过一个坑：有次选择了"仅人脸比对"模式，结果发现无法绑定考生身份信息，导致核验通过后也无法关联到具体考生。后来不得不重新走审核流程修改配置，耽误了三天时间。

2.2 获取必要的API密钥

在访问管理页面，你需要获取三个关键参数：

SecretId：相当于API的用户名
SecretKey：相当于API的密码
RuleId：业务规则ID（在控制台的人脸核身页面生成）

建议为考试系统单独创建一组密钥，并设置权限策略为"QcloudFaceIDFullAccess"。这样即使密钥泄露，黑客也无法操作你其他云服务资源。

3. 后端接口开发实战

3.1 鉴权接口实现

核心代码结构如下，我简化了异常处理部分方便理解：

// 配置类 @Data @Configuration public class TencentCloudConfig { @Value("${tencent.cloud.secretId}") private String secretId; @Value("${tencent.cloud.secretKey}") private String secretKey; @Value("${tencent.cloud.ruleId}") private String ruleId; } // 服务类 @Service @RequiredArgsConstructor public class FaceVerifyService { private final TencentCloudConfig config; public DetectAuthResponse startVerify(String name, String idCard) { Credential cred = new Credential(config.getSecretId(), config.getSecretKey()); HttpProfile httpProfile = new HttpProfile(); httpProfile.setEndpoint("faceid.tencentcloudapi.com"); ClientProfile clientProfile = new ClientProfile(); clientProfile.setHttpProfile(httpProfile); FaceidClient client = new FaceidClient(cred, "ap-guangzhou", clientProfile); DetectAuthRequest req = new DetectAuthRequest(); req.setRuleId(config.getRuleId()); req.setName(name); req.setIdCard(idCard); req.setRedirectUrl("https://yourdomain.com/callback"); return client.DetectAuth(req); } }

这里有几个容易出错的点：

Endpoint配置：一定要用"faceid.tencentcloudapi.com"，我最初用了地域节点导致连接超时
RedirectUrl：必须是备案过的域名，且需要提前在控制台配置白名单
超时设置：考试场景建议将HttpProfile的setConnTimeout设为10秒

3.2 结果回调处理

腾讯云会在核验完成后POST通知到你的回调地址，建议用如下方式验证签名：

public boolean verifySignature(String sign, String requestBody) { String secretKey = config.getSecretKey(); Mac hmac = Mac.getInstance("HmacSHA1"); hmac.init(new SecretKeySpec(secretKey.getBytes(), "HmacSHA1")); byte[] hash = hmac.doFinal(requestBody.getBytes()); String localSign = Base64.getEncoder().encodeToString(hash); return sign.equals(localSign); }

处理回调时要注意：

先验证签名防止伪造请求
业务处理要幂等（相同bizToken多次回调只处理一次）
记录原始请求日志，方便后期审计

4. 前端H5集成指南

4.1 核身流程触发

当考生点击"开始考试"按钮时，前端需要先检查本次考试是否需要人脸核验：

async function startExam() { const examConfig = await getExamConfig(); if (examConfig.requireFaceVerify) { // 获取核身授权 const authRes = await fetch('/api/face-auth', { method: 'POST', body: JSON.stringify({ examId: '123', name: '张三', idCard: '110101199003072396' }) }); // 跳转腾讯云核身页面 window.location.href = authRes.url; } else { loadExamContent(); } }

实际项目中我们发现iOS的Safari浏览器有时会拦截跳转，解决方案是改用window.open()并添加noopener属性：

const newWindow = window.open(authRes.url, '_blank', 'noopener=yes');

4.2 核验结果处理

腾讯云核验完成后会跳转回你指定的RedirectUrl，并带上bizToken参数。前端需要这样处理：

// 在回调页面 const urlParams = new URLSearchParams(window.location.search); const bizToken = urlParams.get('bizToken'); if (bizToken) { // 轮询核验结果 const checkResult = async () => { const res = await fetch(`/api/face-result?token=${bizToken}`); if (res.verified) { // 核验通过，跳转考试页面 window.location.href = `/exam?token=${res.examToken}`; } else { // 每2秒检查一次 setTimeout(checkResult, 2000); } }; checkResult(); }

这里有个性能优化点：建议后端对核验结果做缓存，避免前端频繁查询时重复调用腾讯云接口。