一、前言

在数字化浪潮席卷各行各业的今天，线上身份核验已经成为互联网业务合规运营的关键一环。从金融开户、网约车司机认证，到直播平台的主播实名、电商平台的支付验证，几乎每一个涉及资金或敏感信息的线上场景，都需要一套可靠的身份核验机制来回答三个核心问题：这个人是不是一个真实存在的人？这个人的身份信息是否与本人一致？这个操作是否由本人知情并自愿完成？阿里云实人认证服务正是为了解决这些场景应运而生的产品体系。

然而不少开发者在初次接触阿里云实人认证产品时，往往会被其较为庞杂的产品家族所困扰。实人认证、增强版实人认证、金融级实人认证这些名称之间究竟有什么区别？为什么有的叫eKYC有的叫活体检测？不同的接入方式如App SDK、H5网页、纯服务端API之间应该如何选择？本文将从零开始，系统梳理阿里云实人认证产品的全貌，并提供从开通、配置到代码落地的完整实操指南，帮助开发者少走弯路，快速完成身份核验能力的集成。

需要先登录阿里云控制台，点击：阿里云控制台

二、产品家族梳理与选型指南

在开始对接之前，首先需要搞清楚阿里云实人认证产品家族的整体架构。目前阿里云在身份核验领域提供了多款产品，但其中真正在售、功能持续更新的是金融级实人认证。旧版的实人认证和增强版实人认证均已停止售卖，功能也已收敛，建议新接入的业务统一使用金融级实人认证系列产品。

金融级实人认证产品在算法支持方面更为全面，支持眨眼活体、多动作活体、炫彩反光活体以及声纹活体等多种检测手段，同时还支持App SDK、PC或移动端H5网页、纯服务端API、支付宝小程序等多种接入方式。而旧版实人认证仅支持眨眼动作活体，在安全效果、个人隐私数据保护以及认证通过率方面，金融级版本均有显著提升，目前已广泛应用于互联网娱乐社交、政务、出行等行业。

金融级实人认证家族下主要包含以下几种核心产品方案，开发者需要根据自身业务场景进行选择：

三、开通服务与前置准备

3.1 开通金融级实人认证服务

接入实人认证服务的第一步是开通服务。具体操作步骤如下：

3.2 获取AccessKey

AccessKey是调用阿里云API的身份凭证，由AccessKeyId和AccessKeySecret组成。访问AccessKey管理页面，获取或创建所需的AccessKey。强烈建议使用RAM子账号的AccessKey而非主账号，以降低密钥泄露的风险。

3.3 创建RAM子账号并授权

为了安全调用实人认证API，需要创建RAM子账号并授予相应权限：

3.4 添加认证场景

认证场景是实人认证服务的核心配置单元，每个场景可以独立配置认证方案、活体检测方式、是否保存人脸图片等参数。在金融级实人认证控制台中，点击添加认证场景，根据业务需求填写场景名称、选择认证方案（如实人认证方案、活体人脸验证方案等），并配置相应的认证参数。

四、接入方式详解

阿里云金融级实人认证支持多种接入方式，主要包括App（SDK）接入、H5网页接入和纯服务端API接入三大类。开发者需要根据自身业务形态和技术栈选择合适的接入方式。

4.1 App（SDK）接入

App（SDK）接入适用于自身已有手机App应用，且希望通过该App对用户进行线上认证的场景。这种接入方式用户体验最佳，活体检测效果也最好，是大多数移动端业务的首选方案。

4.1.1 接入流程时序

App（SDK）接入的完整流程如下：

4.1.2 服务端代码示例（Java）

以下是一个完整的Java服务端实现示例，涵盖初始化认证和查询认证结果两个核心接口。

首先，在项目的pom.xml中添加依赖：

服务端初始化接口调用示例：

查询认证结果接口调用示例：

4.1.3 服务端代码示例（Python）

Python开发者可以使用阿里云官方提供的Python SDK：

4.1.4 Android客户端集成示例

Android客户端需要集成阿里云提供的认证SDK。以下是一个简化的集成示例：

4.2 H5网页接入

H5网页接入适用于在浏览器或内嵌WebView中实现实人认证功能的场景。这种接入方式无需安装App，用户通过浏览器访问H5页面即可完成认证，适合PC端业务或没有App的轻量级场景。

4.2.1 接入流程

H5网页接入的流程与App SDK接入类似，区别在于客户端侧使用Web SDK而非原生SDK：

4.2.2 H5前端代码示例