无线SDK+服务端接入适用于您自身已有手机APP应用,且希望通过该APP对用户进行线上认证的场景。

前置条件

您必须了解通过HTTP/HTTPS原生调用金融级实人认证服务接口时,构造请求签名的方法。具体内容请参见API签名机制。

操作步骤

您必须遵循以下步骤以接入 APP 认证方案:
  1. 开通账号和服务
  2. 添加认证场景
  3. 开通 OSS 空间并授权
  4. 无线 SDK + 服务端接入

开通账号和服务

您必须首先获得阿里云账号,并开通金融级实人认证服务后,才能使用该服务。

操作步骤:

  1. 前往阿里云官网注册账号。如果已有注册账号,请跳过此步骤。
  2. 对该账号进行企业实名认证。如果已经是企业账号,请跳过此步骤。
  3. 打开金融级实人认证产品页面,单击立即开通流量包套餐,开通金融级实人认证服务。
  4. 登录金融级实人认证控制台,获取AccessKey以调用API。您可以根据您的实际情况,采用主账号或采用RAM子账号进行相关业务的开发和管理:
    • 采用主账号进行相关业务的开发和管理。登录控制台并获取AccessKey 。要获取AccessKey,请访问AccessKey管理页面
    • 创建并授权RAM子账号进行相关业务的开发和管理。因为主账号具有所有云产品的访问和控制权限,一旦泄露将导致极大的安全风险,所以强烈建议您根据最小权限原则创建并使用RAM子账号来使用金融级实人认证服务。关于如何创建RAM子账号并进行相关操作,请参见 创建RAM 子账号并授权

添加认证场景

在金融级实人认证中,认证场景指您的用户使用实人认证产品的不同情境,例如登录、支付等。您可以添加一个或多个场景,并为不同的场景配置不同的认证方案。

操作步骤:

  1. 登录金融级实人认证控制台。
  2. 定位到接入与配置 > 场景列表页面。
  3. 单击添加场景1
  4. 添加认证场景页面,配置新增场景的基本信息。
  5. 单击提交,完成认证场景添加。
  6. 场景详情页面,获取对应的场景 ID

开通 OSS 空间并授权

金融级实人认证服务会将用户认证的图片上传到您的OSS空间,需要您开通OSS产品并授权实人认证系统为您创建用于存储人脸采集照片的空间。照片存储费用需要您自行承担。具体收费价格请参见OSS计费说明

  • 若您尚未开通OSS产品,您可以根据以下步骤完成开通:
    1. 进入控制台->接入与配置页面,选择任意已创建的认证场景。
    2. 在OSS开通授权指南页面,单击下方的第1步开通OSS按钮,在新开页面上开通OSS产品。

      注意:这里的页面状态更新目前有些慢,在页面打开后请稍等1-2秒钟。

      23
    3. 返回控制台页面,单击浮窗上的已完成按钮,等待页面状态更新,之后参照下方已开通 OSS 产品的说明继续操作。 完成开通oss
  • 若您已经开通OSS产品,请根据以下步骤完成授权:
    1. 您可以在控制台->接入与配置页面,选择任意已经创建的认证场景,并进入OSS开通授权指南页面,单击去授权按钮。
      说明

      此步骤必须主账号操作。

      4
    2. 页面会跳转OSS授权页面,单击同意授权按钮。同意授权
    3. 授权成功后,您可以在接入与配置->场景详情中查看已经授权的OSS Bucket地址。如下图所示:view OSS bucket

关于OSS空间的常见问题及解决办法,请参见OSS 空间相关问题

无线 SDK + 服务端接入

在您完成上述步骤后,您可以进行无线SDK+服务端接入,接入步骤如下:

  • 调用服务端初始化接口;
  • 调用接入客户端SDK;
  • 调用服务端查询接口。

您可以查看下方调用时序图以了解详细接入步骤。

调用时序图

sdk接入流程

系统调用时序说明:

序号 说明
1 初始化认证SDK。
2 APP调用认证SDK获取metaInfo。
3 认证SDK返回metaInfo。
4 APP向应用服务端发起认证请求并传递metaInfo。
5 应用服务端向阿里云服务端调用发起认证请求接口。
6 阿里云服务端返回CertifyId给应用服务端。
7 应用服务端将CertifyId传递给APP。
8 APP调用认证SDK。
9 认证SDK将用户提交的认证资料传递给阿里云服务端。
10 阿里云服务端根据资料判定认证结果。
11 阿里云服务端将认证结果返回给SDK。
12 SDK通过回调函数指引应用客户端获取认证状态。
13 APP向应用服务端查询认证状态。
14 应用服务端向阿里云服务端调用查询认证结果接口。
15 阿里云服务端将认证结果返回给应用服务端。

在您了解接入步骤后,便可以接入无线 SDK 和服务端。