Sumsub 活体检测与人证对比 Java Demo

最新推荐文章于 2025-10-15 13:13:06 发布
原创 最新推荐文章于 2025-10-15 13:13:06 发布 · 1.6k 阅读 · 14 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#java #开发语言 #活体检测 #人证对比

1. 简介

本项目提供了一个 Java Demo，用于演示如何与 Sumsub API 进行交互，以实现活体检测和人证对比功能。Sumsub 是一套身份验证和 KYC/AML 解决方案，可帮助企业验证用户身份并防范欺诈。

此 Demo 主要展示后端 API 的集成流程，包括：

  • 创建申请人 (Applicant)：在 Sumsub 系统中为您的用户创建一个唯一的申请人记录。
  • 获取访问令牌 (Access Token)：生成一个用于初始化 Sumsub WebSDK 或 MobileSDK 的访问令牌。客户端 SDK 负责采集用户的活体数据（如自拍照、视频）和身份证件图像。
  • 上传身份证件 (ID Document)：通过 API 上传用户的身份证件图像，用于后续的人脸比对和证件真实性校验。
  • 获取申请状态 (Applicant Status)：查询申请人的验证状态，了解活体检测和人证对比的结果。

重要提示：实际的活体检测（Liveness Check）和证件图像采集通常由前端的 Sumsub SDK（WebSDK 或 MobileSDK）完成。本 Demo 侧重于后端 API 如何配合 SDK 完成整个验证流程。

2. Demo代码

以下是 SumsubLivenessFaceMatchDemo.java 的核心代码。您可以从附件中下载完整的 Java 文件。

import com.fasterxml.jackson.databind.ObjectMapper;
import okhttp3.*;
import org.apache.commons.codec.binary.Hex;

import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;
import java.io.File;
import java.io.IOException;
import java.io.UnsupportedEncodingException;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.security.InvalidKeyException;
import java.security.NoSuchAlgorithmException;
import java.time.Instant;
import java.util.HashMap;
import java.util.Map;
import java.util.UUID;

public class SumsubLivenessFaceMatchDemo {

    // TODO: Replace with your Sumsub App Token and Secret Key
    // You can find them in your Sumsub dashboard: https://cockpit.sumsub.com/ -> Developers -> API tokens
    private static final String SUMSUB_APP_TOKEN = "YOUR_SUMSUB_APP_TOKEN"; // Example: sbx:uY0CgwELmgUAEYl4hNWxLngb.0wSeQeiYny4WEqmAAALEAik2qTC96fBad
    private static final String SUMSUB_SECRET_KEY = "YOUR_SUMSUB_SECRET_KEY"; // Example: Hej2ch7lkG2kTdiiiUDZFNs05Cilh5Gq

    private static final String SUMSUB_BASE_URL = "https://api.sumsub.com"; // For production, use https://api.sumsub.com. For sandbox, use https://api.cluster-test.sumsub.com

    private static final OkHttpClient client = new OkHttpClient();
    private static final ObjectMapper objectMapper = new ObjectMapper();

    public static void main(String[] args) throws IOException, InvalidKeyException, NoSuchAlgorithmException, InterruptedException {
        System.out.println("Sumsub Liveness and Face Match Demo");

        if ("YOUR_SUMSUB_APP_TOKEN".equals(SUMSUB_APP_TOKEN) || "YOUR_SUMSUB_SECRET_KEY".equals(SUMSUB_SECRET_KEY)) {
            System.err.println("Please replace YOUR_SUMSUB_APP_TOKEN and YOUR_SUMSUB_SECRET_KEY with your actual credentials.");
            return;
        }

        // Step 1: Create an Applicant
        String externalUserId = "java-demo-" + UUID.randomUUID().toString();
        String levelName = "basic-kyc-level"; 
        String applicantId = createApplicant(externalUserId, levelName);
        System.out.println("Applicant created with ID: " + applicantId + " and externalUserId: " + externalUserId);

        // Step 2: Generate an Access Token for SDK Initialization
        String accessToken = getAccessToken(externalUserId, levelName);
        System.out.println("Access Token for SDK: " + accessToken);
        System.out.println("Use this token to initialize Sumsub SDK (Web/Mobile) to perform liveness check.");

        // Step 3: Add an ID Document for Face Match
        File idDocumentFile = new File("id_document_front.jpg"); 
        if (!idDocumentFile.exists()) {
            idDocumentFile.createNewFile(); 
            System.out.println("Created a dummy file: " + idDocumentFile.getAbsolutePath() + ". Replace with a real ID document image.");
        }
        String imageId = addDocument(applicantId, idDocumentFile, "ID_CARD_FRONT");
        System.out.println("ID Document uploaded with imageId: " + imageId);
        System.out.println("After the user completes the liveness check via SDK and document is submitted, Sumsub will perform verification.");

        // Step 4: Get Applicant Verification Status
        System.out.println("Waiting for a few seconds before checking status (in a real scenario, use webhooks or poll appropriately)...");
        Thread.sleep(10000); 
        String applicantStatus = getApplicantStatus(applicantId);
        System.out.println("Applicant Status: " + applicantStatus);
        System.out.println("Check the Sumsub dashboard for detailed verification results including liveness and face match.");

        System.out.println("Demo finished. Remember to configure your verification levels in the Sumsub dashboard.");
    }

    private static String createApplicant(String externalUserId, String levelName) throws IOException, NoSuchAlgorithmException, InvalidKeyException {
        String path = "/resources/applicants";
        String method = "POST";
        long ts = Instant.now().getEpochSecond();
        Map<String, String> queryParams = new HashMap<>();
        queryParams.put("levelName", levelName);
        Map<String, Object> requestBodyMap = new HashMap<>();
        requestBodyMap.put("externalUserId", externalUserId);
        String requestBodyJson = objectMapper.writeValueAsString(requestBodyMap);
        Request request = buildRequest(method, path, ts, queryParams, RequestBody.create(requestBodyJson, MediaType.parse("application/json")));
        try (Response response = client.newCall(request).execute()) {
            if (!response.isSuccessful()) throw new IOException("Unexpected code " + response + " " + response.body().string());
            Map<String, Object> responseMap = objectMapper.readValue(response.body().string(), Map.class);
            return (String) responseMap.get("id");
        }
    }

    private static String getAccessToken(String externalUserId, String levelName) throws IOException, NoSuchAlgorithmException, InvalidKeyException {
        String path = "/resources/accessTokens";
        String method = "POST";
        long ts = Instant.now().getEpochSecond();
        Map<String, String> queryParams = new HashMap<>();
        queryParams.put("userId", externalUserId);
        queryParams.put("levelName", levelName);
        Request request = buildRequest(method, path, ts, queryParams, null);
        try (Response response = client.newCall(request).execute()) {
            if (!response.isSuccessful()) throw new IOException("Unexpected code " + response + " " + response.body().string());
            Map<String, Object> responseMap = objectMapper.readValue(response.body().string(), Map.class);
            return (String) responseMap.get("token");
        }
    }

    private static String addDocument(String applicantId, File file, String idDocType) throws IOException, NoSuchAlgorithmException, InvalidKeyException {
        String path = "/resources/applicants/" + applicantId + "/info/idDoc";
        String method = "POST";
        long ts = Instant.now().getEpochSecond();
        RequestBody requestBody = new MultipartBody.Builder()
                .setType(MultipartBody.FORM)
                .addFormDataPart("metadata", "{"idDocType": "" + idDocType + "", "country": "GBR"}")
                .addFormDataPart("content", file.getName(), RequestBody.create(file, MediaType.parse("image/jpeg")))
                .build();
        Request request = buildRequest(method, path, ts, null, requestBody);
        try (Response response = client.newCall(request).execute()) {
            if (!response.isSuccessful()) throw new IOException("Unexpected code " + response + " " + response.body().string());
            Map<String, Object> responseMap = objectMapper.readValue(response.body().string(), Map.class);
            return (String) responseMap.get("imageId");
        }
    }

    private static String getApplicantStatus(String applicantId) throws IOException, NoSuchAlgorithmException, InvalidKeyException {
        String path = "/resources/applicants/" + applicantId + "/requiredIdDocsStatus";
        String method = "GET";
        long ts = Instant.now().getEpochSecond();
        Request request = buildRequest(method, path, ts, null, null);
        try (Response response = client.newCall(request).execute()) {
            if (!response.isSuccessful()) throw new IOException("Unexpected code " + response + " " + response.body().string());
            return response.body().string();
        }
    }

    private static Request buildRequest(String method, String path, long ts, Map<String, String> queryParams, RequestBody body) throws NoSuchAlgorithmException, InvalidKeyException, UnsupportedEncodingException {
        HttpUrl.Builder urlBuilder = HttpUrl.parse(SUMSUB_BASE_URL + path).newBuilder();
        if (queryParams != null) {
            for (Map.Entry<String, String> entry : queryParams.entrySet()) {
                urlBuilder.addQueryParameter(entry.getKey(), entry.getValue());
            }
        }
        HttpUrl url = urlBuilder.build();
        Request.Builder requestBuilder = new Request.Builder().url(url);
        if (body != null && ("POST".equals(method) || "PATCH".equals(method) || "PUT".equals(method))) {
            requestBuilder.method(method, body);
        } else if ("GET".equals(method)) {
            requestBuilder.get();
        } else {
            requestBuilder.method(method, null);
        }
        String signature = createSignature(ts, method, path, queryParams, body != null ? bodyToString(body) : null);
        requestBuilder.addHeader("X-App-Token", SUMSUB_APP_TOKEN);
        requestBuilder.addHeader("X-App-Access-Sig", signature);
        requestBuilder.addHeader("X-App-Access-Ts", String.valueOf(ts));
        requestBuilder.addHeader("Accept", "application/json");
        return requestBuilder.build();
    }

    private static String createSignature(long ts, String httpMethod, String httpPath, Map<String, String> httpQuery, String httpBody) throws NoSuchAlgorithmException, InvalidKeyException, UnsupportedEncodingException {
        StringBuilder queryStringBuilder = new StringBuilder();
        if (httpQuery != null && !httpQuery.isEmpty()) {
            for (Map.Entry<String, String> entry : httpQuery.entrySet()) {
                 if (queryStringBuilder.length() > 0) {
                    queryStringBuilder.append("&");
                }
                queryStringBuilder.append(URLEncoder.encode(entry.getKey(), StandardCharsets.UTF_8.name()));
                queryStringBuilder.append("=");
                queryStringBuilder.append(URLEncoder.encode(entry.getValue(), StandardCharsets.UTF_8.name()));
            }
        }
        String fullPath = httpPath;
        if (queryStringBuilder.length() > 0) {
            fullPath += "?" + queryStringBuilder.toString();
        }
        String dataToSign = ts + httpMethod.toUpperCase() + fullPath + (httpBody != null ? httpBody : "");
        Mac mac = Mac.getInstance("HmacSHA256");
        SecretKeySpec secretKeySpec = new SecretKeySpec(SUMSUB_SECRET_KEY.getBytes(StandardCharsets.UTF_8), "HmacSHA256");
        mac.init(secretKeySpec);
        byte[] hmacSha256 = mac.doFinal(dataToSign.getBytes(StandardCharsets.UTF_8));
        return Hex.encodeHexString(hmacSha256);
    }

    private static String bodyToString(final RequestBody request) {
        try {
            final okio.Buffer buffer = new okio.Buffer();
            if (request != null) request.writeTo(buffer);
            else return "";
            return buffer.readUtf8();
        } catch (final IOException e) {
            return "did not work";
        }
    }
}

3. 使用说明

3.1 配置凭证

在运行 Demo 之前，您需要将代码中的占位符替换为您的真实 Sumsub 凭证：

  • YOUR_SUMSUB_APP_TOKEN：您的 Sumsub App Token。
  • YOUR_SUMSUB_SECRET_KEY：您的 Sumsub Secret Key。

您可以在 Sumsub 后台的 “Developers” → “API tokens” 部分找到这些凭证。

3.2 配置验证级别 (Verification Level)

确保您在 Sumsub 后台配置了一个验证级别 (例如，代码中使用的 basic-kyc-level)，并且该级别包含了以下检查步骤：

  • Selfie (自拍照/活体检测)
  • ID Document (身份证件，例如身份证、护照等)

3.3 准备身份证件图像

Demo 中包含上传身份证件的步骤。请准备一张身份证件的正面照片（例如 id_document_front.jpg），并将其放置在 Demo 项目的根目录下，或者修改代码中的文件路径。

3.4 添加依赖库

运行此 Java Demo 需要以下依赖库：

  • OkHttp: 用于发送 HTTP 请求与 Sumsub API 进行通信。
  • Jackson Databind: 用于处理 JSON 数据的序列化和反序列化。
  • Apache Commons Codec: 用于在生成 API 请求签名时进行 Hex 编码。

您可以通过 Maven 或 Gradle 将这些依赖添加到您的项目中。

Maven (pom.xml):

<dependencies>
    <dependency>
        <groupId>com.squareup.okhttp3</groupId>
        <artifactId>okhttp</artifactId>
        <version>4.9.3</version> <!-- 建议使用较新稳定版本 -->
    </dependency>
    <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-databind</artifactId>
        <version>2.13.3</version> <!-- 建议使用较新稳定版本 -->
    </dependency>
    <dependency>
        <groupId>commons-codec</groupId>
        <artifactId>commons-codec</artifactId>
        <version>1.15</version> <!-- 建议使用较新稳定版本 -->
    </dependency>
</dependencies>

Gradle (build.gradle):

dependencies {
    implementation 'com.squareup.okhttp3:okhttp:4.9.3' // 建议使用较新稳定版本
    implementation 'com.fasterxml.jackson.core:jackson-databind:2.13.3' // 建议使用较新稳定版本
    implementation 'commons-codec:commons-codec:1.15' // 建议使用较新稳定版本
}

3.5 运行 Demo

配置完成后，您可以编译并运行 SumsubLivenessFaceMatchDemo.java。Demo 将依次执行创建申请人、获取访问令牌、上传证件和查询状态等操作，并在控制台输出相关信息。

4. 注意事项

  • 错误处理：本 Demo 为了简洁，对错误处理部分进行了简化。在生产环境中，请务必添加更完善的错误捕获和处理机制。
  • Webhooks：为了及时获取验证状态的更新，推荐在生产环境中使用 Sumsub 的 Webhook 功能，而不是依赖轮询。
  • 安全性：妥善保管您的 SUMSUB_SECRET_KEY，不要将其硬编码到客户端应用程序或公开的代码仓库中。
  • API 文档：有关 Sumsub API 的更多详细信息，请参阅 Sumsub 官方 API 文档.
java 人脸活体检测_人脸识别活体检测测试案例
weixin_35125164的博客
02-28 1390
最近好多人找我要关于人脸识别活体检测的案例，今天正好有空我就更新一下，先解释一下活体，顾名思义就是看看是否是活人在测检(大白话解说)，用技术上的话也就是看看当前操作者是否是在用照片或者其他方法来操作，比如我们的人脸识别，人脸登陆(想要了解的可以点击这里)，存在一个最大的问题就是，当张三来登陆的时候如果张三本人登陆成功没有问题，要是张三拿着李四的照片来进行登陆，这也能登陆成功的话就是个最大的bug了...
java联合sdk实现活体检测和认证对比
05-16
通过上述文件的组织和配置，开发者可以构建起一个完整的项目框架，进而集成sumsub SDK，实现活体检测与用户认证对比的业务逻辑。在集成过程中，开发者需要注意对权限的控制、异常情况的处理、以及用户反馈机制的设计...
shiro之身份验证 （二） 身份认证流程（*）
weixin_42408447的博客
11-17 629
流程如下： 1.首先调用Subject.login(token)进行登录，其会自动委托给Security Manager，调用之前必须通过SecurityUtils. setSecurityManager()设置； 2.SecurityManager负责真正的身份验证逻辑；它会委托给Authenticator进行身份验证； 3.Authenticator才是真正的身份验证者，Shiro API中核心的身份认证入口点，此处可以自定义插入自己的实现； 4.Authenticator可能会委托给相应的Authe.
中国公民身份证号码校验
沾边的博客
02-10 1501
中国公民身份证号码校验，行政区划代码
从sumsub获取用户图片
qq_37106501的博客
02-19 1212
从sumsub获取用户图片
Sumsub 是什么？一文带你了解！
weixin_45588393的博客
11-29 1054
Sumsub 通过先进的技术，帮助各个行业在不同国家和地区实现快速、高效的身份验证和合规管理。 11 月 20 日至 21 日，全球流量大会（GTC2024）首次在上海成功举办。这场汇聚国内多家跨境出海领域企业、行业协会、行业媒体的行业盛会，在为期两天的日程里迎来了超 15000 的参展观众，线上直播全网累计播放超 10W。 回顾两日大会，优阅达作为受邀参展商，携手全球领先的身份验证和反欺诈解决方案提供商 Sumsub，在 B18 展位上展示了针对跨境出海企业的创新解决方案，吸引了众多与会者的关注。
Sumsub Java Web Demo 技术文档
callback_CSDN的博客
05-16 1377
该项目是一个基于 Spring Boot 框架构建的 Java Web 应用程序，其核心目标是演示如何与 Sumsub 用户验证服务进行集成。应用程序采用经典的三层架构模式，即表现层（前端静态资源）、业务逻辑层（Controller 和 Service）以及数据访问/模型层（Model）。这种分层结构有助于代码的模块化、可维护性和可测试性。前端通过静态 HTML、CSS 和 JavaScript 文件提供用户交互界面，用户可以通过此界面触发后端API调用。
Java开发基于seetaface6人脸识别（活体检测）的封装源码.zip
04-08
【资源说明】 1、该资源包括项目的全部源码，下载可以直接使用！ 2、本项目适合作为计算机、数学、电子信息等专业的课程设计、期末大作业和毕设项目，作为...Java开发基于seetaface6人脸识别（活体检测）的封装源码.zip
包含人脸识别与活体检测功能的 demo 展示
09-11
值得注意的是，随着技术的应用越来越广泛，对于人脸识别与活体检测技术的伦理和隐私问题也引起了人们的关注。用户对于个人数据的隐私保护要求不断提高，因此在设计和实施这些技术时，开发者和运营者需要充分考虑到...
虹软的人脸识别V1.2、人证对比、活体检测封装
09-11
虹软的人脸识别V1.2、人证对比、活体检测封装版为用户提供了强大的人脸识别能力，其广泛的应用场景和简便的操作方式使其成为当前市场上非常有竞争力的产品。这款封装版的推出，也显示了虹软公司在生物识别领域的深厚...
集成方案 | 利用 Sumsub 验证平台为跨境企业打造无缝 KYC 体验，满足合规要求
weixin_45588393的博客
05-26 1130
👉 随着系统的稳定运行和数据的积累，你可利用 Sumsub 的分析工具，评估验证流程的效率和准确性，发现优化空间，持续提升系统表现。作为全球领先的 KYC/AML 解决方案提供商，Sumsub 提供了功能强大的一站式验证平台，让企业能在单个仪表板中处理用户验证、企业验证和交易监控，同时有效防范欺诈风险。无论你是需要验证全球用户身份的金融科技企业，还是寻求简化企业客户注册的 B2B 平台，或是希望防范交易欺诈的支付服务商，Sumsub 都能提供满足你需求的身份验证解决方案。
12.synchronized加在方法上
weimin821的博客
10-11 620
synchronized加在方法上，以及所谓的线程8锁
Java学习——非空注解
qq_24992377的博客
10-11 1788
非空注解对比与使用建议 本文对比了三种常用非空注解的特点和适用场景： @NothingNullByDefault：自定义注解，适用范围最广（类级别），涵盖字段、方法和参数，保留策略为CLASS级别。 @ParametersAreNonnullByDefault：JSR-305标准注解，专注于方法参数的非空约束，保留策略为RUNTIME。 @MethodsReturnNonnullByDefault：常见于MC生态，针对方法返回值的非空约束，保留策略为RUNTIME。 使用建议： 选择注解应考虑项目需求（参数
Spring boot 2中常见数据访问类型详解
最新发布
2501_91373349的博客
10-15 527
本文将围绕 Spring Boot 2 版本（以 2.7.x 为主），深入讲解如何进行高效、稳定的数据库访问，涵盖多种主流技术栈，并结合实际案例，帮助开发者全面掌握 Spring Boot 中的数据持久化方案。log.hg6v.pro-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 控制台打印 SQL。-d '{"name":"张三","age":25,"email.qi5v.pro":"zhangsan@example.com"}'
编程与数学 03-007 《看潮资源管理器》项目开发 05 数据设计
明月看潮生的博客
10-15 210
本文给出《看潮资源管理器》后台六张核心表的结构脚本，包括所有者、存储器、文件夹、文件、用户及数据词典，列明主键、默认值与约束，为后续开发与数据维护提供基线。
SpringBoot的IOC和DI学习
月亮不会奔向你，但我会，不远万里
10-15 587
1.IOC 是 “让容器管理对象” 的思想，通过@Repository、@Service等注解将对象交给 Spring 容器控制；2. DI 是 IOC 的实现手段，通过@Autowired等方式自动注入依赖，解决对象间的耦合问题。3. 代码中，容器管理UserDao、UserService、UserController的创建，并通过依赖注入自动组装它们的关系，最终实现了 “开发者只关注业务逻辑，不关心对象创建和依赖管理” 的目标。
java中length 加括号 vs 不加括号的完整总结
m0_63695860的博客
10-11 729
【代码】java中length 加括号 vs 不加括号的完整总结。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

故事很腻i

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值