Appearance
AWS KYC 全链路内部接口整理(divs-orch)
来源:mint-capability-hub/divs-orch/docs(2026-10 版)。divs-orch(身份核验与供应商编排子系统)将 AWS 能力封装为内部 HTTP 接口,统一从 dgip-cp 读取 Collection、Region、阈值与凭证配置,调用方不传 AWS 参数。
接口总览
| 内部接口 | 底层 AWS API | 能力标识 | 说明 |
|---|---|---|---|
POST /internal/v1/liveness-sessions | Rekognition CreateFaceLivenessSession | 活体 | 创建活体会话,有效期 180s |
POST /internal/v1/liveness-results | GetFaceLivenessSessionResults | 活体 | 查询活体结果,含 referenceImage |
POST /internal/v1/selfie-compares | Rekognition CompareFaces | 比对 | 多供应商公共接口,按 CP 配置路由 |
POST /internal/v1/face-indexes | Rekognition IndexFaces | IDENTITY.FACE_ENROLLMENT | 开户人脸入库(新增) |
POST /internal/v1/face-searches | Rekognition SearchFacesByImage | IDENTITY.FACE_DUPLICATE_SEARCH | 人脸查重(新增) |
POST /internal/v1/ocr-extracts | Textract AnalyzeDocument | 场景 KYC.OCR_EXTRACT | 证件 OCR(新增) |
KYC 推荐全链路
text
SearchFacesByImage(无重复)
→ CompareFaces + OCR + 其他校验
→ 开户成功
→ IndexFaces(入库)
→ 保存本地绑定 → 激活账户完整时序:CreateFaceLivenessSession → App 活体采集 → GetFaceLivenessSessionResults(includeReferenceImage=true) → SearchFacesByImage → CompareFaces + OCR → 开户成功后 IndexFaces。
人脸入库(IndexFaces)
- 入库时机:活体检测 + 身份比对 + 开户审批全部完成后;只存活体参考图,禁止存证件头像 / 普通自拍。
- 图片来源:本地表
divs_aws_liveness_session.referenceImageBase64,调用方不能传图(image/imageBase64显式不支持)。 - AWS 请求:
MaxFaces=1(防一图多脸)、QualityFilter=HIGH(CP 配置)、ExternalImageId= 稳定 Mint 账户标识。 - 本地绑定:
mint_face_binding表(mint_account_id + status=ACTIVE唯一 → 一人一张有效开户人脸;aws_face_id + collection_id唯一)。 - 幂等:同 userId 已有有效绑定返回
ALREADY_INDEXED,不重复入库。 - 一致性:AWS 成功但本地绑定失败不得返回最终成功,需补偿任务清理孤儿 FaceId。
- 隔离:生产 / SIT / 开发使用不同 Collection(如
mint-sit-face);AWS 只存特征向量不存原图。
人脸查重(SearchFacesByImage)
- 阈值:
FaceMatchThreshold=95.0(CP 配置,禁止逐笔覆盖)、MaxFaces=5。 - 关键语义:
bizRtnCode=000000只代表检索调用成功,是否重复看faceMatches。 - 判定流程:
faceMatches非空 → 取最高similarity的 FaceId → 查本地FaceId ↔ Mint 账户绑定表 → 命中他人有效账户 → 拒绝重复开户或转人工;命中当前申请账户 → 幂等重试。 - 注意:不能只看 AWS 分数,必须结合本地绑定表;
confidence(检测置信度)≠similarity(相似度);查重不能替代 OCR / 身份查询 / 活体。
Textract OCR(肯尼亚 G2/G3 身份证)
- 判代(本地 Tesseract):G2 / G3 标签计分,某代 ≥5 分且领先另一代 ≥3 分才判代,否则 UNKNOWN(降级不阻断)。
- 问题集:G2 13 问 / G3 16 问 / UNKNOWN 20 问并集;Textract 每批 ≤15 问自动分批;CP
queriesG2/queriesG3可覆盖。 - 统一输出:固定 16 字段 alias(idNumber、fullNames、dateOfBirth、sex、placeOfIssue、dateOfIssue、placeOfBirth、county、division、location、subLocation、mrz + G2 独有 serialNumber + G3 独有 nationality / dateOfExpiry / subCounty),二代三代同构,未识别为 null。
- 质量前置:证件长边 ≥1500px(护照 ≥2200px)、600kB–10MB,不达标不调第三方(
2004 IMAGE_QUALITY)。 - 防伪预检:几何 / 结构 / 正反面匹配(
2005)、复制粘贴篡改检测(2006 COPY_MOVE_SUSPECTED)。 - 置信度:默认阈值 70(CP 可调);<70 返回
2003 LOW_CONFIDENCE但仍返回已提取字段;建议 ≥90 直接用、70–90 人工复核。
活体 + 比对要点
- 活体两段式:建会话(180s / threshold=90)→ App SDK 采集 → 后端轮询结果;
confidenceScore ≥ 90由上游判定,divs-orch 不下结论。 - 比对接口
comparisonImageType:ID_PHOTO证件头像 /PORTRAIT人像照 /DOCUMENT完整证件;livenessProof支持SESSION_ID(复用活体会话)或IMAGES。 bizRtnCode:000000成功调用供应商 /TIMEOUT超时可重试 /999999CP 配置不可用;核验结论不影响 bizRtnCode。
WeRPC 对应关系(divs-orch 已注册)
| Service ID | Handler | 对应内部接口 |
|---|---|---|
03200006 | LivenessSessionHandler | liveness-sessions |
03300004 | LivenessResultHandler | liveness-results |
12300014 | FaceCompareHandler | selfie-compares |
03200004 | OcrSessionHandler | Didit OCR 会话(备选通道) |
03300002 | OcrDecisionHandler | Didit OCR 决策(备选通道) |