零信任架构实战：基于天远运营商三要素简版V即时版查询构建自动化电子投保实名核验网关

破解电子投保实名核验痛点：从离线人工回访到权威数据直连

在大型保险集团的数字化展业体系中，互联网意健险、车险自助续保及寿险电子投保业务对投保人真实身份与通讯号码归属一致性的合规确认有着严格的监管要求。根据银保监相关实名制管理规范，保险机构在承保出单前必须确保投保人姓名、身份证件号码与所留存的手机号码完成实名绑定核验，以确保后续电子保单送达、现金价值变更通知及犹豫期双录回访能够触达投保人本人。在传统作业模式下，许多分支机构依赖代理人线下收集证件照片、内勤人员事后电话抽检或人工比对实名截图。这种依赖人工核查的流程不仅拉长了核保出单的响应链路，导致高并发促销期间保单积压，而且在面对投保人误填家属号码、使用非本人实名登记的边缘号码或填报信息偏差时，难以在缴费承保前实现毫秒级的即时校验。

为了消除核保前置环节的信息盲区，架构团队可将天远运营商三要素简版V即时版查询接口集成至 Spring Boot 核心承保前置微服务中。在获得投保人线上明示授权的前提下，承保服务只需传入投保人填写的 mobile_no（手机号）、id_card（身份证号）与 name（姓名）三项核心入参，即可通过加密通道直连权威运营商数据集完成实时比对。接口解密后的响应报文不仅返回核心的 result（验证结果状态码：0 一致、1 不一致、2 无记录）与 order_no（核验订单流水号），还同步穿透返回 channel（所属运营商通道：cmcc 移动、cucc 联通、ctcc 电信、gdcc 广电）以及由身份证号合规解析出的 sex（性别）、birthday（生日）与 address（籍贯）。这些多维结构化字段既能为投保人通讯实名制提供客观依据，又能与保险精算引擎中的被保人周岁年龄、性别费率因子及异地投保属地规则进行交叉印证。

将实名核验动作以标准化微服务组件的形式无缝嵌入保险核心系统的保单生效前置管道，能够让承保工作流在发起保费扣划前自动完成高可靠的身份对齐。这不仅省去了繁琐的人工补件审核，还能基于实时核验状态动态分流正常出单、补充人脸活体复核与人工核保队列，保障保险核心业务的高效顺畅流转。

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

1. 核心参数与加密配置

• 接口地址 : https://api.tianyuanapi.com/api/v1/YYSYH6F3 (需在 URL 附加 ?t=13位时间戳)
• 请求方式 : POST
• 请求头 :
  • Access-Id: 账号的 Access-Id (必填)
  • Content-Type: application/json
• 关键入参 :
  • mobile_no: 投保人待核验手机号码，数据类型为 string（必填）
  • id_card: 投保人 18 位二代居民身份证号码，数据类型为 string（必填）
  • name: 投保人真实中文姓名，数据类型为 string（必填）
• 鉴权与加密机制 : 使用账户的 16 进制 Access Key 作为密钥，采用 AES-128 算法的 CBC 模式。每次请求需动态生成 16 字节的 IV（初始化向量），并配合 PKCS7 填充，最终将 IV 与密文拼接后进行 Base64 编码放入请求体 data 字段中。

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

以下为可直接嵌入保险集团核心承保前置微服务（基于 JDK 11+ 标准 HttpClient 与 Jackson）的完整生产级调用代码。在 Java 标准加密库中，AES/CBC/PKCS5Padding 在 16 字节块大小下与 PKCS7 填充标准完全等价，代码内置了 16 进制密钥转换、动态随机 IV 拼接与响应报文逆向拆解逻辑：

package com.insurance.underwriting.gateway.client;

import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
import com.fasterxml.jackson.annotation.JsonProperty;
import com.fasterxml.jackson.databind.ObjectMapper;

import javax.crypto.Cipher;
import javax.crypto.spec.IvParameterSpec;
import javax.crypto.spec.SecretKeySpec;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
import java.security.SecureRandom;
import java.time.Duration;
import java.util.Arrays;
import java.util.Base64;
import java.util.LinkedHashMap;
import java.util.Map;

/**
 * 大型保险集团电子投保人实名认证与保单生效前置核验客户端
 * 对接接口：运营商三要素简版V即时版查询 (YYSYH6F3)
 */
public class PolicyholderTelecomVerifyClient {

    private static final String BASE_URL = "https://api.tianyuanapi.com/api/v1/YYSYH6F3";
    private static final String CIPHER_ALGORITHM = "AES/CBC/PKCS5Padding";
    private static final int IV_LENGTH_BYTES = 16;

    private final String accessId;
    private final byte[] accessKeyBytes;
    private final HttpClient httpClient;
    private final ObjectMapper objectMapper;
    private final SecureRandom secureRandom;

    public PolicyholderTelecomVerifyClient(String accessId, String hexAccessKey) {
        this.accessId = accessId;
        this.accessKeyBytes = hexStringToByteArray(hexAccessKey);
        if (this.accessKeyBytes.length != 16) {
            throw new IllegalArgumentException("Access Key 转换后必须严格为 16 字节 (128 位)");
        }
        this.httpClient = HttpClient.newBuilder()
                .connectTimeout(Duration.ofSeconds(3))
                .build();
        this.objectMapper = new ObjectMapper();
        this.secureRandom = new SecureRandom();
    }

    /**
     * 执行投保人手机三要素即时核验与精算基础属性提取
     *
     * @param mobileNo 投保人预留手机号
     * @param idCard   投保人身份证号
     * @param name     投保人姓名
     * @return 解密后的三要素核验结果与人口学属性实体
     */
    public PolicyholderVerifyResult verifyPolicyholder(String mobileNo, String idCard, String name) throws Exception {
        // 1. 组装承保实名核验明文入参
        Map<String, String> payloadMap = new LinkedHashMap<>();
        payloadMap.put("mobile_no", mobileNo);
        payloadMap.put("id_card", idCard);
        payloadMap.put("name", name);
        String plainJson = objectMapper.writeValueAsString(payloadMap);

        // 2. AES-128-CBC 加密并拼接 16 字节动态 IV 后进行 Base64 编码
        String encryptedData = encryptPayload(plainJson);

        // 3. 构建外层请求体 {"data": "xxxx(base64)"}
        String requestBody = objectMapper.writeValueAsString(Map.of("data", encryptedData));

        // 4. 拼接 13 位毫秒级时间戳参数并发起 POST 请求
        long timestamp = System.currentTimeMillis();
        URI endpointUri = URI.create(BASE_URL + "?t=" + timestamp);

        HttpRequest httpRequest = HttpRequest.newBuilder()
                .uri(endpointUri)
                .timeout(Duration.ofSeconds(5))
                .header("Access-Id", this.accessId)
                .header("Content-Type", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(requestBody, StandardCharsets.UTF_8))
                .build();

        HttpResponse<String> response = httpClient.send(httpRequest, HttpResponse.BodyHandlers.ofString(StandardCharsets.UTF_8));
        if (response.statusCode() != 200) {
            throw new IllegalStateException("核验网关 HTTP 响应异常，状态码: " + response.statusCode());
        }

        // 5. 解析外层公共响应参数
        OuterGatewayResponse outerResponse = objectMapper.readValue(response.body(), OuterGatewayResponse.class);
        if (outerResponse.getData() == null || outerResponse.getData().isBlank()) {
            throw new IllegalStateException(String.format(
                    "上游核验未返回加密业务体, code=%d, message=%s, transaction_id=%s",
                    outerResponse.getCode(), outerResponse.getMessage(), outerResponse.getTransactionId()));
        }

        // 6. 解密 data 字段，还原投保人核验详情与籍贯/生日/性别信息
        String decryptedJson = decryptPayload(outerResponse.getData());
        PolicyholderVerifyResult verifyResult = objectMapper.readValue(decryptedJson, PolicyholderVerifyResult.class);
        verifyResult.setTransactionId(outerResponse.getTransactionId());
        return verifyResult;
    }

    /**
     * AES-128-CBC 加密：随机生成 16 字节 IV，拼接 [IV + 密文] 后转 Base64
     */
    private String encryptPayload(String plainText) throws Exception {
        byte[] iv = new byte[IV_LENGTH_BYTES];
        secureRandom.nextBytes(iv);

        Cipher cipher = Cipher.getInstance(CIPHER_ALGORITHM);
        SecretKeySpec keySpec = new SecretKeySpec(this.accessKeyBytes, "AES");
        IvParameterSpec ivSpec = new IvParameterSpec(iv);
        cipher.init(Cipher.ENCRYPT_MODE, keySpec, ivSpec);

        byte[] cipherBytes = cipher.doFinal(plainText.getBytes(StandardCharsets.UTF_8));
        byte[] combined = new byte[iv.length + cipherBytes.length];
        System.arraycopy(iv, 0, combined, 0, iv.length);
        System.arraycopy(cipherBytes, 0, combined, iv.length, cipherBytes.length);

        return Base64.getEncoder().encodeToString(combined);
    }

    /**
     * AES-128-CBC 解密：Base64 解码后提取前 16 字节作为 IV，解密剩余字节
     */
    private String decryptPayload(String base64CipherText) throws Exception {
        byte[] combined = Base64.getDecoder().decode(base64CipherText);
        if (combined.length <= IV_LENGTH_BYTES) {
            throw new IllegalArgumentException("加密响应数据长度不足 16 字节，无法提取 IV");
        }

        byte[] iv = Arrays.copyOfRange(combined, 0, IV_LENGTH_BYTES);
        byte[] cipherBytes = Arrays.copyOfRange(combined, IV_LENGTH_BYTES, combined.length);

        Cipher cipher = Cipher.getInstance(CIPHER_ALGORITHM);
        SecretKeySpec keySpec = new SecretKeySpec(this.accessKeyBytes, "AES");
        IvParameterSpec ivSpec = new IvParameterSpec(iv);
        cipher.init(Cipher.DECRYPT_MODE, keySpec, ivSpec);

        byte[] plainBytes = cipher.doFinal(cipherBytes);
        return new String(plainBytes, StandardCharsets.UTF_8);
    }

    /**
     * 将 32 位 16 进制字符串转换为 16 字节数组
     */
    private static byte[] hexStringToByteArray(String hex) {
        String cleanHex = hex.trim();
        int len = cleanHex.length();
        byte[] data = new byte[len / 2];
        for (int i = 0; i < len; i += 2) {
            data[i / 2] = (byte) ((Character.digit(cleanHex.charAt(i), 16) << 4)
                    + Character.digit(cleanHex.charAt(i + 1), 16));
        }
        return data;
    }

    /**
     * 手机号脱敏辅助方法：保留前3后4，防止日志泄露投保人隐私
     */
    private static String maskMobile(String mobile) {
        if (mobile == null || mobile.length() != 11) {
            return "****";
        }
        return mobile.substring(0, 3) + "****" + mobile.substring(7);
    }

    @JsonIgnoreProperties(ignoreUnknown = true)
    public static class OuterGatewayResponse {
        private int code;
        private String message;
        @JsonProperty("transaction_id")
        private String transactionId;
        private String data;

        public int getCode() { return code; }
        public void setCode(int code) { this.code = code; }
        public String getMessage() { return message; }
        public void setMessage(String message) { this.message = message; }
        public String getTransactionId() { return transactionId; }
        public void setTransactionId(String transactionId) { this.transactionId = transactionId; }
        public String getData() { return data; }
        public void setData(String data) { this.data = data; }
    }

    @JsonIgnoreProperties(ignoreUnknown = true)
    public static class PolicyholderVerifyResult {
        private String transactionId;
        @JsonProperty("order_no")
        private String orderNo;
        private String result;
        private String desc;
        private String channel;
        private String sex;
        private String birthday;
        private String address;

        public boolean isConsistent() {
            return "0".equals(this.result);
        }

        public String getTransactionId() { return transactionId; }
        public void setTransactionId(String transactionId) { this.transactionId = transactionId; }
        public String getOrderNo() { return orderNo; }
        public void setOrderNo(String orderNo) { this.orderNo = orderNo; }
        public String getResult() { return result; }
        public void setResult(String result) { this.result = result; }
        public String getDesc() { return desc; }
        public void setDesc(String desc) { this.desc = desc; }
        public String getChannel() { return channel; }
        public void setChannel(String channel) { this.channel = channel; }
        public String getSex() { return sex; }
        public void setSex(String sex) { this.sex = sex; }
        public String getBirthday() { return birthday; }
        public void setBirthday(String birthday) { this.birthday = birthday; }
        public String getAddress() { return address; }
        public void setAddress(String address) { this.address = address; }
    }

    public static void main(String[] args) {
        // 生产环境中请从 KMS 或配置中心注入凭证
        String accessId = System.getenv().getOrDefault("TY_ACCESS_ID", "INS_PROD_ACCESS_ID");
        String hexKey = System.getenv().getOrDefault("TY_ACCESS_KEY_HEX", "0123456789abcdef0123456789abcdef");

        PolicyholderTelecomVerifyClient client = new PolicyholderTelecomVerifyClient(accessId, hexKey);
        String sampleMobile = "13800138000";
        try {
            PolicyholderVerifyResult res = client.verifyPolicyholder(sampleMobile, "11010119900307251X", "张伟");
            System.out.printf("投保核验完成 -> 手机号:%s, 订单号:%s, 状态码:%s(%s), 运营商:%s, 性别:%s, 生日:%s, 籍贯:%s%n",
                    maskMobile(sampleMobile), res.getOrderNo(), res.getResult(), res.getDesc(),
                    res.getChannel(), res.getSex(), res.getBirthday(), res.getAddress());
        } catch (Exception e) {
            System.err.println("电子投保前置实名核验调用异常: " + e.getMessage());
        }
    }
}

3. 终端快捷验证 (cURL)

在承保微服务上线前的联调阶段，运维或开发人员可通过以下 curl 命令快速验证网关连通性与密文载荷交互是否正常：

# 1. 生成当前 13 位毫秒级时间戳
TIMESTAMP=$(python3 -c 'import time; print(int(time.time() * 1000))')

# 2. 发送经过 AES-128-CBC 加密并拼接 16 字节 IV 的 Base64 数据载荷
curl -X POST "https://api.tianyuanapi.com/api/v1/YYSYH6F3?t=${TIMESTAMP}" \
  -H "Access-Id: YOUR_INSURANCE_ACCESS_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "data": "5Zq8xL2P9kR1vN4mB7cQ0wE3rT6yU8iO1pA4sD7fG0hJ2kL5zX8cV1bN4mM7qW9e=="
  }'

核心实名与人口学数据解析与业务映射

在电子投保前置微服务解密 data 响应密文后，会获得包含实名验证结论、运营商归属通道及投保人基础人口学属性的 JSON 结构。以下为各返回字段与保险核心承保系统的详细映射说明：

字段名	类型	枚举/格式说明	保险核心承保系统业务映射与处理策略
order_no	string	平台唯一核验订单号	写入保单承保轨迹表（t_policy_audit_trace），与外层 transaction_id 共同构成监管合规抽检与计费对账凭证。
result	string	0: 一致（收费） 1: 不一致（收费） 2: 无记录（不收费）	核心准入决策因子：0 直接放行进入保费代扣与电子保单签发；1 触发前置准入校验提醒，引导投保人更换本人实名手机号；2 转入云端活体人脸识别或银联卡四要素辅助核身通道。
desc	string	验证结果文本描述	用于核保后台工单展示（注意：面向 C 端投保页面应映射为友好的引导文案，避免直接暴露底层核验细节）。
channel	string	cmcc: 中国移动 cucc: 中国联通 ctcc: 中国电信 gdcc: 中国广电	驱动短信网关路由策略：根据投保人所属运营商（含新兴的 gdcc 广电号段）动态选择高到达率直连短信通道下发电子保单链接与验证码。
sex	string	投保人性别（如 男 / 女）	与投保单填写的性别字段及精算费率表入参自动比对，防范前端传参不一致导致的保费试算偏差。
birthday	string	投保人出生日期	核心精算核校因子：用于二次复核投保人是否满足成年投保资格（年满 18 周岁），以及投保人与被保人为同一人时的投保年龄档位。
address	string	身份证归属籍贯信息	辅助互联网保险异地展业合规评估，结合投保时常驻城市判断是否属于保司具备经营资质的销售区域。

技术提示 ：在保险核心系统的全链路日志（如 ELK / SLS）及核保监控大盘中，严禁直接打印解密后的明文个人信息。建议在序列化日志前通过脱敏工具类将手机号格式化为 138****0000、身份证号格式化为 110101********251X；同时务必注意 result 为 "2"（无记录）时属于不计费状态，通常出现在新近携号转网或新入网未完成全网同步的号码场景，工程上不应将其简单视作身份不符直接退单，而应触发备选认证流程以挽留真实投保客户。

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

1. 百万医疗险与重疾险在线投保前置准入校验

在健康险互联网自营渠道中，投保人完成健康告知并进入保费支付前，承保前置微服务同步调用三要素核验接口。当返回 result="0"（一致）时，系统同时提取返回的 birthday 与 sex 字段，与前端保费试算器传入的被保人（本人投保场景）年龄、性别进行毫秒级一致性校验，确认无误后立即拉起支付收银台并生成正式电子保单。若返回 result="1"（不一致），说明投保人可能误填了配偶或父母名下的手机号码，系统在前端弹出温和提示："为保障您的保单权益及后续理赔通知精准送达，请填写投保人本人实名认证的手机号码"，引导用户即时修正；若用户确系特殊原因无法提供本人手机号，则引导其上传户口本关系证明并转入人工核保复核队列。

2. 寿险长期期交保单犹豫期电子回访与短信通道精准调度

长期寿险保单签发后，监管要求必须在犹豫期内完成100%有效的客户回访。借助核验接口返回的 channel 字段（cmcc、cucc、ctcc、gdcc），保司消息中台能够建立精细化的触达路由：对于识别为 gdcc（中国广电）或特定运营商的投保号码，系统自动将其调度至已完备配置对应运营商签名备案的专属直连网关通道，避免因跨网默认通道适配不佳导致电子保单下载链接或回访提醒短信丢失。同时，针对 result="2"（无记录，不收费）的新开卡用户，系统自动标记该保单需通过官方 App 站内信加智能语音外呼双通道并发回访，确保犹豫期回访达成率。

3. 车险批量续保与存量保单客户信息治理

在财产险公司的年度车险续保营销与存量保单数据治理工程中，部分历史承保数据存在投保人联系电话变更或早年录入不规范的情况。通过批处理调度服务对即将到期的续保清单进行前置三要素合规筛查，系统可将 result="0" 的高置信度客户直接推入"一键续保免验通道"，提升续保转化率；而对于核验返回 result="1" 的存量保单，系统则在续保专员的作业工作台中生成"联系方式待更新提醒"标签，指导坐席在联系客户确认续保方案时同步引导客户通过移动端完成实名手机号变更批改，消除后续理赔款项支付通知的履约隐患。

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

1. 隐私授权与最小必要合规留痕 ：根据《个人信息保护法》及保险行业实名查验规范，前端投保页面必须在显著位置展示《个人信息处理及实名核验授权书》。只有在投保人主动勾选同意后，后端微服务方可发起三要素核验调用，且必须在数据库中持久化记录用户勾选授权的时间戳、协议版本号、客户端 IP 以及本次调用的 order_no 与 transaction_id，确保监管审计可追溯。
2. 全链路密文传输与敏感字段脱敏存储 ：Access Key 严禁硬编码在业务源码或提交至 Git 仓库，应统一托管于企业级 KMS（密钥管理服务）或配置中心加密命名空间。对于接口返回的 sex、birthday、address 等人口学数据，落盘至承保数据库时应采用字段级应用层加密存储，内存使用完毕后避免在非安全缓存中长期驻留明文。
3. 高并发限流控制与降级熔断设计：在保险"开门红"或全民惠民保集中投保的高峰时段，核心承保网关应使用 Resilience4j 或 Sentinel 对外呼核验接口配置合理的 QPS 限流阈值与超时控制（建议连接超时 3 秒、读取超时 5 秒）。一旦遇到极端网络抖动触发熔断，系统不应直接中断投保人的投保流程，而应自动将保单置为"待实名复核（Pre-Underwriting Pending）"状态，通过异步消息队列（如 RocketMQ / Kafka）延迟重试核验或分流至短信验证码+人脸识别备用通道，实现业务连续性与风控合规性的平衡。