关于 sumsub-check-permissions
此 Skill 查询 Sumsub 租户已启用的权限并返回权限映射，帮助调用方在准备或提交 API 写入前检查访问资格。
主要功能
- 01获取租户已启用的权限
- 02返回权限键及说明标签
- 03请求出错时停止后续流程
- 04在 API 写入前进行功能门控
适用场景
- 01检查租户是否可使用视频身份验证
- 02构建 KYC 载荷前核验权限
- 03缺少所需权限时避免写入
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/sumsub-check-permissions确认已加载。
附带文件scripts/check_permissions.sh
详细介绍
检查权限
返回租户获准使用的权益，以便调用方在发起任何 API 写入操作前控制功能是否可用。
身份验证 — App Token + 密钥（仅限沙盒）
此技能会调用公开的 Sumsub API，并按照
身份验证参考文档为每个请求签名。
完整的工作原理说明见 sumsub-api-auth
技能 — 如果遇到 401 Invalid signature，请阅读该说明。
⚠️ 仅限沙盒 Token。 此处不要接受或使用生产环境的 App Token。 如果用户提供了生产环境 Token，请拒绝并让他们在 https://cockpit.sumsub.com/checkus/devSpace/appTokens 生成一组沙盒 Token 和密钥（先将工作区切换为 Sandbox，然后点击 Create）。Token 和密钥只会显示一次 — 请在关闭对话框前复制两者。辅助脚本 会强制执行此限制 — 不接受以
sbx:开头的 Token。
| 变量 | 示例 |
|---|---|
SUMSUB_APP_TOKEN | sbx:... — 从控制面板获取的沙盒 App Token。 |
SUMSUB_SECRET_KEY | 创建 Token 时显示一次的配对密钥。 |
SUMSUB_BASE | 可选。默认为 https://api.sumsub.com。 |
用法
运行脚本并解析结果：
bash ${CLAUDE_SKILL_DIR}/scripts/check_permissions.sh
输出：原始 Sumsub 响应正文，后接 HTTP <code>。
成功（HTTP 200）：
{"allowedChecks": {"REUSABLE_KYC_SDK": "Reusable KYC via API/SDK: ...", "VIDEO_IDENT": "Video Identification: ..."}}
HTTP 200
错误（非 200）：
{"description":"Unauthorized","errorName":"...","correlationId":"..."}
HTTP 401
allowedChecks— 权限键到易读标签的映射，包含此租户已启用的所有权益。allowedChecks中作为键出现的权限键，即为获准使用的权益。
调用方应如何使用
如果 HTTP 状态码不是 200，立即停止 — 向用户显示错误正文，不要继续操作。
成功收到响应后，检查 allowedChecks 中是否包含所需的 BackgroundCheckTarget 键。如果没有，立即停止 — 不要构建或 POST 负载。告知用户缺少哪项权益，并说明需要联系其 CSM 或 Sumsub 支持团队以启用该权益。
权益 → 功能映射（键示例）：
| 功能 | 所需权益 |
|---|---|
E_KYC 文档集 | E_KYC_TARGET |
PROOF_OF_RESIDENCE 文档集 | POA |
E_SIGN 文档集 | E_SIGN_TARGET |
deviceIntelligenceSettings.enabled: true | DEVICE_INTELLIGENCE |
QUESTIONNAIRE 评分 | QUESTIONNAIRE_SCORING |
QUESTIONNAIRE 附件 | QUESTIONNAIRE_ATTACHMENT |
| NFC 芯片读取 | NFC |
| 视频身份验证会话 | VIDEO_IDENT |
| 通过 SDK 进行可复用 KYC | REUSABLE_KYC_SDK |
| 已知人脸搜索 | KNOWN_FACE_SEARCH |
| AML / 监控名单步骤 | WATCHLISTS |