零信任架构实战：基于海宇活体识别V步骤1构建自动化考前活体认证网关

破解在线资格考试考前核验痛点：从人工视频巡考签到到动态活体采集凭证直连

在在线职业资格认证考试、企业内训定级考核及远程技能测评平台中，确保"应试考生确系报名本人且处于真实物理摄像头前"是维护考试公平性与证书公信力的核心前提。传统的远程监考系统多依赖考生在开考前上传静态近期免冠照，或由监考老师通过多人视频会议室逐一人工核对准考证。在数千人同时开考的并发高峰期，人工视频核验不仅耗时长、容易造成考场开考延误，而且静态照片与普通视频流也难以有效识别预录视频重放或虚拟摄像头流注入等非真实应试行为。

在获得应试考生明确授权的前提下，PHP 在线考试门户系统可通过接入活体识别V步骤1接口，在试卷解锁前构建标准化的动态活体认证前置关卡。考试后端只需将考生的考前核验回跳地址（return_url）经 AES-128-CBC 加密后发起请求，对返回的加密报文解密后即可实时获取有效期为 2 小时的唯一采集凭证（token）与专属 H5 活体采集网关地址（url）。随后，PHP 服务端可根据考试安全等级灵活组装采集端控制参数------例如配置复合头部与局部动作样式（style）、开启随机闪光防摄像头劫持检测（antiCameraHack）、启用云端大模型活体算法（backLiveOn），并将 returnUrlIncludeToken 显式设为 false 以防凭证在浏览器地址栏泄露，从而为后续步骤的结果查询与人像核身提供安全可靠的会话基础。

将活体识别V步骤1封装为 PHP 考务微服务的准入初始化模块后，在线监考平台即可实现"考生点击进入考场---后端下发一次性活体采集会话---终端完成随机动作与光线活体校验---回调解锁加密试卷"的自动化合规闭环，在保障严肃考纪的同时显著提升大规模并发开考的入场流转效率。

一、 PHP 加密通信集成：构建高可用审核管道

1. 核心参数与加密配置

接口地址 : https://api.haiyudata.com/api/v1/IVYZX5QJ (需在 URL 附加 ?t=13位时间戳)
请求方式 : POST
请求头 :
- Access-Id: 账号的 Access-Id (必填)
- Content-Type: application/json
关键入参 :
- return_url: 请求回调地址，考生在前端完成活体动作采集后浏览器自动回跳的考场门户地址（加密请求体中必填）
- style: 采集端重定向动作样式参数，支持 1（4个头部动作随机选一 + 2个局部动作随机选一并随机组合）和 2（眨眼、张嘴2个局部动作随机选一）（获取 url 后前端跳转选填）
- antiCameraHack: 是否开启闪光防摄像头劫持检测，通过随机性屏幕闪光校验视频是否为实时物理采集，默认 false（获取 url 后前端跳转选填）
- returnUrlIncludeToken: 跳转到 returnUrl 后是否携带 token 参数，建议主动设置为 false 防止 token 暴露在浏览器 URL 中，默认 true（获取 url 后前端跳转选填）
鉴权与加密机制 : 使用账户的 16 进制 Access Key 作为密钥，采用 AES-128 算法的 CBC 模式。每次请求需动态生成 16 字节的 IV（初始化向量），并配合 PKCS7 填充，最终将 IV 与密文拼接后进行 Base64 编码放入请求体 data 字段中。

2. 标准化调用代码 (PHP)

以下提供一套适用于 PHP 8.x 在线职业资格考试系统的考前活体认证初始化服务类。代码完整实现了 return_url 的 AES-128-CBC 加密请求、响应 token 与 url 解密提取，以及面向严肃考场防替考需求的 H5 采集跳转链接安全构建：

php 复制代码

<?php

declare(strict_types=1);

namespace OnlineExamPortal\Proctoring\Liveness;

use InvalidArgumentException;
use RuntimeException;

/**
 * 在线职业资格考试平台 - 考前活体识别V步骤1（采集凭证初始化与安全跳转构建）服务类
 */
class ExamLivenessStepOneService
{
    private const API_ENDPOINT = 'https://api.haiyudata.com/api/v1/IVYZX5QJ';
    private const CIPHER_ALGO  = 'AES-128-CBC';
    private const IV_LENGTH    = 16;

    // 考场活体动作复杂度等级
    public const STYLE_COMPOUND_HEAD_AND_LOCAL = '1'; // 摇头/点头/左转/右转(4选1) + 眨眼/张嘴(2选1) 随机组合
    public const STYLE_QUICK_LOCAL_ONLY        = '2'; // 眨眼/张嘴(2选1) 轻量核验

    private string $accessId;
    private string $accessKeyBinary;
    private int $timeoutSeconds;

    /**
     * @param string $accessId     海宇账号 Access-Id
     * @param string $accessKeyHex 32位16进制字符串格式的 Access Key (128位密钥)
     * @param int    $timeout      HTTP 请求超时时间（秒）
     */
    public function __construct(string $accessId, string $accessKeyHex, int $timeout = 8)
    {
        $cleanHex = trim($accessKeyHex);
        if (strlen($cleanHex) !== 32 || !ctype_xdigit($cleanHex)) {
            throw new InvalidArgumentException('Access Key 必须为 32 位有效的 16 进制字符串（16 字节）。');
        }

        $binaryKey = hex2bin($cleanHex);
        if ($binaryKey === false || strlen($binaryKey) !== 16) {
            throw new InvalidArgumentException('Access Key 二进制转换失败。');
        }

        $this->accessId        = trim($accessId);
        $this->accessKeyBinary = $binaryKey;
        $this->timeoutSeconds  = $timeout;
    }

    /**
     * AES-128-CBC 加密：生成 16 字节随机 IV + PKCS7 填充密文 -> 拼接后 Base64 编码
     */
    private function encryptPayload(array $payload): string
    {
        $plaintext = json_encode($payload, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_THROW_ON_ERROR);
        $iv        = random_bytes(self::IV_LENGTH);

        $ciphertext = openssl_encrypt(
            $plaintext,
            self::CIPHER_ALGO,
            $this->accessKeyBinary,
            OPENSSL_RAW_DATA,
            $iv
        );

        if ($ciphertext === false) {
            throw new RuntimeException('请求参数 AES-128-CBC 加密失败: ' . openssl_error_string());
        }

        return base64_encode($iv . $ciphertext);
    }

    /**
     * AES-128-CBC 解密：Base64 解码 -> 提取前 16 字节 IV -> 解密密文并移除 PKCS7 填充
     */
    private function decryptPayload(string $encryptedBase64): array
    {
        $decoded = base64_decode($encryptedBase64, true);
        if ($decoded === false || strlen($decoded) <= self::IV_LENGTH) {
            throw new RuntimeException('响应 data 字段 Base64 解码失败或密文长度不足。');
        }

        $iv         = substr($decoded, 0, self::IV_LENGTH);
        $ciphertext = substr($decoded, self::IV_LENGTH);

        $decryptedJson = openssl_decrypt(
            $ciphertext,
            self::CIPHER_ALGO,
            $this->accessKeyBinary,
            OPENSSL_RAW_DATA,
            $iv
        );

        if ($decryptedJson === false) {
            throw new RuntimeException('响应报文 AES-128-CBC 解密失败: ' . openssl_error_string());
        }

        $result = json_decode($decryptedJson, true, 512, JSON_THROW_ON_ERROR);
        return is_array($result) ? $result : [];
    }

    /**
     * 初始化考生考前活体采集会话（步骤1），生成带防替考策略的前端采集跳转地址
     *
     * @param string $examSessionId 考场会话唯一标识（用于回跳关联，避免在 URL 暴露 token）
     * @param string $baseReturnUrl 考试门户回跳基准地址
     * @param bool   $isHighStakes  是否为高保密等级统考（开启闪光防劫持与云端大模型）
     * @return array{
     *     token: string,
     *     raw_collect_url: string,
     *     full_redirect_url: string,
     *     transaction_id: string,
     *     expires_in_seconds: int
     * }
     */
    public function initCandidateLivenessSession(
        string $examSessionId,
        string $baseReturnUrl,
        bool $isHighStakes = true
    ): array {
        // 1. 在 return_url 中仅绑定考场内部流水号，将核心 token 保存在服务端 Redis/Session 中
        $separator      = str_contains($baseReturnUrl, '?') ? '&' : '?';
        $safeReturnUrl  = sprintf('%s%sexam_session_id=%s', $baseReturnUrl, $separator, rawurlencode($examSessionId));

        // 2. 加密组装请求体 data
        $encryptedData = $this->encryptPayload(['return_url' => $safeReturnUrl]);
        $requestBody   = json_encode(['data' => $encryptedData], JSON_THROW_ON_ERROR);

        // 3. 构造附加 13 位毫秒级时间戳的请求 URL
        $timestampMs = (int) round(microtime(true) * 1000);
        $requestUrl  = sprintf('%s?t=%d', self::API_ENDPOINT, $timestampMs);

        // 4. 发起 HTTPS POST 请求
        $ch = curl_init($requestUrl);
        curl_setopt_array($ch, [
            CURLOPT_POST           => true,
            CURLOPT_POSTFIELDS     => $requestBody,
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_TIMEOUT        => $this->timeoutSeconds,
            CURLOPT_CONNECTTIMEOUT => 3,
            CURLOPT_SSL_VERIFYPEER => true,
            CURLOPT_HTTPHEADER     => [
                'Content-Type: application/json',
                'Access-Id: ' . $this->accessId,
            ],
        ]);

        $rawResponse = curl_exec($ch);
        $httpCode    = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
        $curlError   = curl_error($ch);
        curl_close($ch);

        if ($rawResponse === false) {
            throw new RuntimeException(sprintf('活体识别步骤1网关通信失败: %s', $curlError));
        }

        $outerResponse = json_decode((string) $rawResponse, true, 512, JSON_THROW_ON_ERROR);
        $apiCode       = (int) ($outerResponse['code'] ?? -1);
        $transactionId = (string) ($outerResponse['transaction_id'] ?? '');

        if ($httpCode !== 200 || empty($outerResponse['data'])) {
            throw new RuntimeException(sprintf(
                '活体识别步骤1返回异常 (HTTP %d, Code: %d, Message: %s, 流水号: %s)',
                $httpCode,
                $apiCode,
                $outerResponse['message'] ?? '未知错误',
                $transactionId
            ));
        }

        // 5. 解密响应 data 获取 token 与采集基础 url
        $innerData     = $this->decryptPayload((string) $outerResponse['data']);
        $token         = (string) ($innerData['token'] ?? '');
        $rawCollectUrl = (string) ($innerData['url'] ?? '');

        if ($token === '' || $rawCollectUrl === '') {
            throw new RuntimeException('解密后的响应报文中缺失有效的 token 或 url 字段。');
        }

        // 6. 组装面向在线考场防替考场景的 H5 采集端控制参数
        $collectQueryParams = [
            'style'                 => $isHighStakes
                ? self::STYLE_COMPOUND_HEAD_AND_LOCAL
                : self::STYLE_QUICK_LOCAL_ONLY,
            'actionMutex'           => 'true',  // 开启严格动作互斥校验
            'antiCameraHack'        => $isHighStakes ? 'true' : 'false', // 高等级考试开启随机闪光防摄像头劫持
            'foreLiveOn'            => 'true',  // 开启前端小模型活体预检
            'backLiveOn'            => $isHighStakes ? 'true' : 'false', // 高等级考试开启云端大模型复核
            'showSuccess'           => 'false', // 采集成功后不停留，直接平滑回跳考场拆封试卷
            'showFail'              => 'true',  // 采集失败时显示具体原因（如光线过暗、动作未到位）辅助考生调整
            'hideGuidePage'         => 'false', // 保留考前引导页提醒考生正对镜头
            'title'                 => '考前本人活体核验', // 自定义页面标题（不超过32字符）
            'enableH5CompatibleModel' => 'true', // H5 不支持预检时允许降级调用原生相机录制
            'returnUrlIncludeToken' => 'false', // 强制设为 false，防止 token 在浏览器地址栏暴露
        ];

        $urlConnector    = str_contains($rawCollectUrl, '?') ? '&' : '?';
        $fullRedirectUrl = $rawCollectUrl . $urlConnector . http_build_query($collectQueryParams);

        return [
            'token'              => $token,
            'raw_collect_url'    => $rawCollectUrl,
            'full_redirect_url'  => $fullRedirectUrl,
            'transaction_id'     => $transactionId,
            'expires_in_seconds' => 7200, // token 有效期为 2 小时（7200秒）
        ];
    }
}

// ============================================================================
// 在线资格考试门户 - 考生开考前初始化活体采集调用示例
// ============================================================================
if (PHP_SAPI === 'cli' && basename(__FILE__) === basename($_SERVER['SCRIPT_FILENAME'])) {
    $accessId  = getenv('HAIYU_ACCESS_ID') ?: 'your_access_id_here';
    $accessKey = getenv('HAIYU_ACCESS_KEY') ?: '0123456789abcdef0123456789abcdef';

    try {
        $livenessService = new ExamLivenessStepOneService($accessId, $accessKey);

        // 示例：注册会计师/职业资格模拟考考生（准考证会话 EXAM_2026_99812）点击"开始考试"
        $sessionData = $livenessService->initCandidateLivenessSession(
            examSessionId: 'EXAM_2026_99812',
            baseReturnUrl: 'https://exam.example.edu.cn/portal/proctor/callback',
            isHighStakes: true
        );

        // 生产环境中：将 $sessionData['token'] 存入 Redis 并绑定 EXAM_2026_99812，设置 TTL=7200 秒
        echo "[考前活体认证初始化成功] 网关流水号: {$sessionData['transaction_id']}\n";
        echo "服务端安全缓存凭证(token): {$sessionData['token']} (有效期: {$sessionData['expires_in_seconds']}秒)\n";
        echo "引导考生前端跳转采集地址: {$sessionData['full_redirect_url']}\n";
    } catch (\Throwable $e) {
        error_log('[ExamProctor] 考生考前活体步骤1初始化失败: ' . $e->getMessage());
    }
}

3. 终端快捷验证 (cURL)

在集成调试阶段，研发人员可使用如下 cURL 命令向接口端点发送加密后的 return_url 载荷，验证凭证发放链路是否正常：

bash 复制代码

curl -X POST "https://api.haiyudata.com/api/v1/IVYZX5QJ?t=1727522222000" \
  -H "Content-Type: application/json" \
  -H "Access-Id: YOUR_ACTUAL_ACCESS_ID" \
  -d '{
    "data": "8mP2qR5tV7xZ0bC3dF6gH9jL1nQ4sU7wY0aB3cE6fH9iK2mO5pR8sU1vX4yZ7aB0cD=="
  }'

二、核心活体初始化数据解析与业务映射

活体识别V步骤1涉及"后端加密请求获取凭证"与"前端携带策略参数跳转采集"两个紧密衔接的数据阶段。以下为完整字段解析及在线远程监考平台的业务映射表：

字段分类	字段名	类型	必填/返回	详细说明与在线考试监考平台配置建议
加密请求入参	`return_url`	`string`	必填	采集完成后的前端回跳地址。建议拼接考场内部会话号（如 `?exam_session_id=xxx`）以便考生回跳后恢复答题上下文。
公共响应参数	`code` / `message`	`int` / `string`	必返	外层网关状态码与描述信息。
公共响应参数	`transaction_id`	`string`	必返	本次活体初始化请求流水号，建议与考生准考证号关联写入监考审计日志。
解密业务响应	`token`	`string`	必返	核心采集与查询凭证：有效期为 2 个小时。在此有效期内，应用侧可发起采集请求（重复采集触发的结果会被忽略）及后续步骤的结果查询。
解密业务响应	`url`	`string`	必返	H5 活体采集基础地址：后端可在此地址后附加下述采集策略参数，并引导考生客户端跳转。
采集跳转参数	`actionLiveParam`	`varchar`	选填	自定义动作序列，英文逗号分隔（如 `LookLeft,OpenMouth`），默认无需传参，由 `style` 控制随机生成。
采集跳转参数	`style`	`varchar`	选填	动作样式： • `1`：从摇头、点头、左转头、右转头 4 个头部动作随机选 1 个 + 从眨眼、张嘴 2 个局部动作随机选 1 个并随机排序（推荐正式统考使用） • `2`：仅从眨眼和张嘴 2 个局部动作中随机选 1 个（适合随堂小测或考中抽检）
采集跳转参数	`actionMutex`	`Boolean`	选填	是否检查动作互斥，默认 `false`。正式考试建议设为 `true`，防范考生胡乱做动作蒙混过关。
采集跳转参数	`antiCameraHack`	`Boolean`	选填	闪光防摄像头劫持检测，默认 `false`。设为 `true` 时通过屏幕随机闪光校验视频是否为实时采集（对考场环境光线有一定要求，适合高规格资格认证考试）。
采集跳转参数	`foreLiveOn`	`Boolean`	选填	是否开启前端小模型活体算法（资源消耗小、速度快，客户端运行），默认 `true`。
采集跳转参数	`backLiveOn`	`Boolean`	选填	是否开启云端大模型活体算法（服务器端深度校验，适合严肃防替考场景），默认 `false`。
采集跳转参数	`showSuccess` / `showFail`	`Boolean`	选填	是否展示采集成功页（默认 `false`）与失败原因诊断页（默认 `true`）。保持默认即可让通过者秒回考场、未通过者获知具体调整建议。
采集跳转参数	`hideGuidePage`	`Boolean`	选填	是否隐藏引导页，默认 `false`（不隐藏）。首次考前核验建议保留引导页，考中二次复核可设为 `true`。
采集跳转参数	`title`	`varchar`	选填	采集页面标题文本，最长 32 个字符，默认 `"活体人脸采集"`，可定制为 `"考前本人活体核验"`。
采集跳转参数	`enableH5CompatibleModel`	`Boolean`	选填	默认 `true`（H5 环境不支持算法预检时自动启用原生相机录制视频）；若设为 `false` 则需考生手动复制 URL 至其他环境。为保障考生移动端兼容性建议保持 `true`。
采集跳转参数	`returnUrlIncludeToken`	`Boolean`	选填	安全关键参数：回跳 `returnUrl` 时是否在 URL 中携带 `token`。因历史遗留默认值为 `true`，但强烈建议在生产考务系统中主动设为 `false` ，避免考生通过浏览器历史记录或抓包篡改、泄露 `token`。

技术提示 ：在远程监考平台日志与考务工单系统中记录考生认证流水时，请严格执行敏感个人信息（PII）脱敏规范。对考生准考证关联的身份证号、手机号及姓名进行掩码处理（如手机号记录为 138****0000，身份证号记录为 310104**********12），且切勿将解密后的 token 明文打印在前端控制台或公开 URL 查询字符串中。

三、场景化应用：让核验数据赋能合规闭环

在现代在线职业资格考试与远程监考系统中，合理组合活体识别V步骤1的凭证机制与采集端策略参数，能够针对不同考试阶段实现精细化的合规审查：

1. 严肃职业资格统考"考前 15 分钟"动态防替考准入

在国家级或行业级职业资格在线考试中，考生登录候考室后点击"解锁试卷"，PHP 后端立即调用活体识别V步骤1获取 token 与 url，并配置 style=1（头部+局部复合随机动作）、antiCameraHack=true（闪光防劫持）与 backLiveOn=true（云端大模型深度检测）：

当考生顺利完成随机动作与闪光采集并回跳至 return_url 时 ：后端通过内部 exam_session_id 从 Redis 取出预先缓存的 token 进入下一步核身比对，验证通过后立即下发试卷解密密钥。
当考生因环境光线过暗、镜头遮挡或未按提示完成互斥动作导致采集未通过时 ：由于开启了 showFail=true，采集界面会清晰提示具体原因（如"请勿遮挡面部"或"请移至光线均匀处"），引导考生现场调整后重新采集；若连续多次无法完成前端算法预检，系统则自动触发人工复核提醒，将该考生的视频流优先推送至巡考教师监控台进行一对一在线核验。

2. 长时在线考试"考中随机抽检"与切屏异常复核

对于长达 120~180 分钟的专业科目考试，部分违规行为发生在开考半小时后（如中途换人代答）。当监考客户端检测到考生出现高频切屏、双人同框或长时间离开画面等异常信号时，PHP 服务端可动态生成一个新的活体采集会话，并配置轻量级策略 style=2（仅眨眼或张嘴单一局部动作）、hideGuidePage=true（隐藏引导页）及 title=考中身份快速复核。考生仅需 3~5 秒即可完成无感动作确认并继续作答，既能实时确认当前答题人未发生变更，又最大限度减少了对正常考生答题思绪的干扰。

3. 偏远地区或老旧终端考生的 H5 兼容降级保障

在面向全国范围的技能等级认定考试中，部分考生使用的移动端 WebView 或老旧浏览器可能不支持 WebRTC 实时流预检算法。通过保持 enableH5CompatibleModel=true，当采集端检测到当前 H5 容器无法运行前端小模型（foreLiveOn）时，会自动平滑切换至原生相机录制短视频上传的兼容模式，避免考生因设备环境受限而无法进入考场，显著降低开考期间的技术客服求助率。

四、生产环境接入的安全与合规边界

围绕在线考试高并发、高安全等级的业务特性，PHP 研发团队在落地该接口时应重点落实以下三项安全与合规准则：

考前生物特征采集知情同意与最小化留存 ：在引导考生跳转至 url 进行人脸活体采集前，考试门户必须在候考页面显著位置展示《在线考试生物识别信息采集与防替考合规告知书》，经考生主动勾选同意后方可发起接口调用。采集凭证 token 仅用于当场考试的身份核验，考试结束后应及时清理临时会话缓存。
强制关闭 URL 凭证回传与服务端状态绑定 ：务必在拼接采集跳转地址时显式指定 returnUrlIncludeToken=false。PHP 后端应在步骤1解密拿到 token 的瞬间，将其存储在服务端高安全等级的 Redis 哈希结构中（Key 为加密签名的 exam_session_id，TTL 严格对齐接口 token 的 2 小时有效期），彻底杜绝前端通过伪造 URL 参数重放他人的活体通行凭证。
开考洪峰削峰填谷与凭证复用控制 ：由于同一场职业资格考试往往在整点（如上午 09:00）集中开考，瞬间并发请求极高。鉴于接口返回的 token 具备 2 小时有效期 ，考务系统可采用"候考期预分配"架构------允许考生在开考前 30 分钟进入候考室时即分批调用步骤1生成并缓存 token。若考生在采集过程中因网络抖动刷新页面，后端可直接下发缓存中尚未过期的 url 与 token，无需重复请求上游接口，同时结合说明中"2小时有效期内重复采集触发的结果会被忽略"的幂等特性，确保考场网关在高并发洪峰下依然稳定运行。