# 华为人证核身
华为人证核身连接器通过用户的身份证信息、人脸图片，与权威数据库进行比对，进而实现身份验证，包含"人证核身标准版"、"人证核身证件版"两个执行动作。
#### 连接参数
华为人证核身连接器使用IAM认证，连接参数说明如[表1]所示。
 表1连接参数说明 
| 名称   | 必填 | 说明                                                                                                      | 示例值/默认值     |
|:---|:---|:---|:---|
| 连接名称 | 是  | 设置连接名称。                                                                                                 | 华为人证核身的连接   |
| 描述   | 否  | 对于连接的信息描述说明。                                                                                            | description |
| 租户名  | 是  | IAM用户所属账号信息。了解[账号与IAM用户的关系](https://support.huaweicloud.com/productdesc-iam/iam_01_0023.html#section2)。 | domain      |
| 用户名  | 是  | IAM用户名。                                                                                                 | name        |
| 密码   | 是  | IAM用户的登录密码。                                                                                             | -           |
| 区域   | 是  | 服务所属区域。                                                                                                 | cn-north-4  |
   
#### 人证核身标准版
使用姓名、身份证号码、人脸图像三要素进行身份匹配核验。
- 输入参数 用户配置人证核身标准版执行动作，相关参数说明如[表2]所示。
   表2人证核身标准版输入参数说明 
  | 参数        | 必填 | 说明                                                                    |
  |:---|:---|:---|
  | 用户自定义请求ID | 是  | 唯一标识此次请求的ID，用户自定义，不超过64位。                                             |
  | 姓名        | 是  | 被验证人的姓名。                                                              |
  | 身份证号码     | 是  | 被验证人的身份证号码。                                                           |
  | 人脸照片      | 是  | 人像图像数据，使用base64编码。要求base64编码后大小不超过4MB。图像各边的像素大小在300到4000px之间，支持JPG格式。 |
     
  
- 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表3]。
   表3人证核身标准版输出参数说明 
  | 参数        | 说明                   |
  |:---|:---|
  | 请求ID      | 请求ID。                |
  | 调用结果      | 调用结果。                |
  | 子服务名称     | 子服务名称。               |
  | 成功的结果数量   | 成功的结果数量。             |
  | resp_data | 返回的响应结果。             |
  | 审核校验结果    | valid表示身份审核通过。       |
  | 审核校验信息    | 审核校验信息。              |
  | 审核校验代码    | 审核校验代码。              |
  | 人像相识度     | 人像相似度，取值范围\[0,100\]。 |
  | 身份证上识别的名称 | 身份证上识别的名称。           |
  | 身份证号      | 身份证号。                |
  | 性别        | 性别。                  |
  | 出生日期      | 出生日期。                |
  | 民族        | 民族。                  |
  | 地址        | 地址。                  |
  | 发证机关      | 发证机关。                |
  | 有效起始日期    | 有效起始日期。              |
  | 有效结束日期    | 有效结束日期。              |
     
  
 
#### 人证核身证件版
使用姓名、身份证号码二要素进行身份匹配核验。
- 输入参数 用户配置人证核身证件版执行动作，相关参数说明如[表4]所示。
   表4人证核身证件版输入参数说明 
  | 参数        | 必填 | 说明                                                                     |
  |:---|:---|:---|
  | 用户自定义请求ID | 是  | 唯一标识此次请求的ID，用户自定义，不超过64位。                                              |
  | 身份证图像     | 是  | 身份证图像数据，使用base64编码。要求base64编码后大小不超过4MB。图像各边的像素大小在300到8000px之间，支持JPG格式。 |
     
  
- 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表5]。
   表5人证核身证件版输出参数说明 
  | 参数        | 说明                      |
  |:---|:---|
  | 请求ID      | 请求ID。                   |
  | result    | 调用返回结果。                 |
  | 子服务名称     | 子服务名称。                  |
  | 成功的结果数量   | 成功的结果数量，与resp_data字段对应。 |
  | 响应结果      | 返回的响应结果。                |
  | 审核校验结果    | 审核校验结果，valid表示身份审核通过。   |
  | 审核校验信息    | 审核校验信息。                 |
  | 审核校验代码    | 审核校验代码。                 |
  | 身份证上识别的名称 | 身份证上识别的名称。              |
  | 身份证号      | 身份证号。                   |
  | 性别        | 性别。                     |
  | 出生日期      | 出生日期。                   |
  | 民族        | 民族。                     |
  | 地址        | 地址。                     |
  | 发证机关      | 发证机关。                   |
  | 有效起始日期    | 有效起始日期。                 |
  | 有效结束日期    | 有效结束日期。                 |