用途:按官方参考实现对 https://api.sumsub.com 的认证请求签名与发送。
主要能力:说明所需凭据 SUMSUB_APP_TOKEN、SUMSUB_SECRET_KEY 与 SUMSUB_BASE;给出三个必要请求头(X-App-Token、X-App-Access-Ts、X-App-Access-Sig);定义签名串为 ts + 大写HTTP方法 + 含查询的路径 + 原始body字节,用 secret 做 HMAC-SHA256 取小写十六进制;提供签名与 curl 辅助脚本、多语言官方示例位置,并说明 multipart/form-data(如 idDoc 照片上传)需对完整原始体逐字节签名,Content-Type 中的 boundary 必须与所签字节一致;还说明生成 SDK access token 的常见后续调用。
使用方式:从沙箱仪表盘生成令牌与密钥,写入环境变量或 .claude/settings.local.json;用 ${CLAUDE_SKILL_DIR}/scripts/sumsub_curl.sh GET '/resources/applicants/-/count' 快速验证,200 表示签名正确。缺失凭据时应停止询问,不得编造占位符。
限制:仅可使用沙箱令牌,拒绝生产令牌;令牌与密钥仅创建时显示一次,无恢复流程;要求 HTTPS;时间戳需为秒级且与 Sumsub 时钟相差在 ±60 秒内;令牌锁定其生成环境。正文未提供的收费、价格等信息暂未提供。