Skip to content

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-sessionsRekognition CreateFaceLivenessSession活体创建活体会话,有效期 180s
POST /internal/v1/liveness-resultsGetFaceLivenessSessionResults活体查询活体结果,含 referenceImage
POST /internal/v1/selfie-comparesRekognition CompareFaces比对多供应商公共接口,按 CP 配置路由
POST /internal/v1/face-indexesRekognition IndexFacesIDENTITY.FACE_ENROLLMENT开户人脸入库(新增)
POST /internal/v1/face-searchesRekognition SearchFacesByImageIDENTITY.FACE_DUPLICATE_SEARCH人脸查重(新增)
POST /internal/v1/ocr-extractsTextract 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 超时可重试 / 999999 CP 配置不可用;核验结论不影响 bizRtnCode。

WeRPC 对应关系(divs-orch 已注册) ​

Service IDHandler对应内部接口
03200006LivenessSessionHandlerliveness-sessions
03300004LivenessResultHandlerliveness-results
12300014FaceCompareHandlerselfie-compares
03200004OcrSessionHandlerDidit OCR 会话(备选通道)
03300002OcrDecisionHandlerDidit OCR 决策(备选通道)