sumsub-api-auth — скилл для Claude Code: установка
Скилл подписывает запросы к Sumsub API через HMAC-SHA256 и помогает разбирать ошибки 401. Нужен для интеграций и разовых проверок.
npx skills add sumsub/agent-skills --skill sumsub-api-auth -a claude-codeЧто делает sumsub-api-auth
Скилл объясняет аутентификацию Sumsub API через App Token и секретный ключ. Он формирует заголовки X-App-Token, X-App-Access-Ts и X-App-Access-Sig, учитывает путь с query-параметрами, HTTP-метод и точные байты тела запроса. Подпись строится на HMAC-SHA256.
В составе есть scripts/sumsub_sign.py для вывода заголовков без сетевого вызова и scripts/sumsub_curl.sh для подписи и отправки запроса через curl. Скилл также разбирает причины 401, включая неверный timestamp, метод или тело. Для работы нужны sandbox App Token и секретный ключ; боевые учётные данные использовать с Claude нельзя.
Какие задачи решает
- подписать запрос к Sumsub API
- разобрать ошибку
401 Unauthorized - проверить HMAC-заголовки через
curl - сформировать подпись для JSON или multipart-тела
Примеры запросов агенту
- Подпиши GET-запрос к
/resources/applicants/-/countи покажи нужные заголовки. - Проверь, почему запрос к
api.sumsub.comполучает401 Invalid signature. - Сформируй пример подписи для
POSTс query-параметрами и JSON-телом.
Как установить sumsub-api-auth
1Через Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-api-auth -a claude-code2Вручную: положить файлы
~/.claude/skills/sumsub-api-auth/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/sumsub-api-auth/
1Через Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-api-auth -a codex2Вручную: положить файлы
.agents/skills/sumsub-api-auth/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-api-auth -a cursor2Вручную: положить файлы
.cursor/skills/sumsub-api-auth/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install sumsub/agent-skills sumsub-api-auth2Вручную: положить файлы
.github/skills/sumsub-api-auth/SKILL.md1Через Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-api-auth -a gemini-cli2Командой платформы
gemini skills install https://github.com/sumsub/agent-skills --path skills/sumsub-api-authВручную: положить файлы
.devin/skills/sumsub-api-auth/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-api-auth -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о sumsub-api-auth
Как установить sumsub-api-auth в Claude Code?
Выполните npx skills add sumsub/agent-skills --skill sumsub-api-auth -a claude-code. После установки файл скилла будет доступен по пути ~/.claude/skills/sumsub-api-auth/SKILL.md.
Что делает sumsub-api-auth?
Он помогает подписывать запросы к Sumsub API через App Token, секретный ключ и HMAC-SHA256. Скилл формирует три заголовка авторизации и помогает найти причину ошибки 401.
Какие данные нужны для работы скилла?
Нужны sandbox SUMSUB_APP_TOKEN и SUMSUB_SECRET_KEY. Их следует сохранить в .env или .claude/settings.local.json; HTTPS для запросов обязателен.