vtex-io-auth-and-policies — скилл для Claude Code
Скилл помогает настраивать права VTEX IO, политики манифеста и доступ к внешним сервисам. Нужен при добавлении интеграций и защищённых маршрутов.
npx skills add vtex/skills --skill vtex-io-auth-and-policies -a claude-codeЧто делает vtex-io-auth-and-policies
Скилл разбирает границы авторизации в приложениях VTEX IO: доступ к ресурсам VTEX, внешним HTTP-сервисам и операциям других приложений. Он помогает связать сервисные маршруты и интеграции с явными разрешениями.
В центре работы — политики в manifest.json: License Manager, политики приложений и outbound-access. Для внешних запросов предлагается ограничивать хост и путь, а для собственных маршрутов задавать серверные resource-based policies. VRN используются там, где их ожидает платформа, например в service.json.
Без нужной политики платформа заблокирует доступ, даже если код обработчика написан правильно. Перед добавлением клиента, внешнего хоста или защищённого маршрута нужно проверить границу разрешений и не оставлять избыточные wildcard-правила.
Какие задачи решает
- проверить права приложения VTEX IO
- добавить разрешение для внешнего API
- связать маршрут с политикой доступа
- сузить правила
outbound-access - найти отсутствующее разрешение в
manifest.json
Примеры запросов агенту
- Проверь права приложения VTEX IO и найди отсутствующие политики в
manifest.json. - Добавь интеграцию с внешним API и задай для неё узкое правило
outbound-access. - Проверь, кто может вызывать защищённый маршрут, и сопоставь его с resource-based policy.
Как установить vtex-io-auth-and-policies
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-auth-and-policies -a claude-code2Вручную: положить файлы
~/.claude/skills/vtex-io-auth-and-policies/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/vtex-io-auth-and-policies/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-auth-and-policies -a codex2Вручную: положить файлы
.agents/skills/vtex-io-auth-and-policies/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-auth-and-policies -a cursor2Вручную: положить файлы
.cursor/skills/vtex-io-auth-and-policies/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vtex/skills vtex-io-auth-and-policies2Вручную: положить файлы
.github/skills/vtex-io-auth-and-policies/SKILL.md1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-auth-and-policies -a gemini-cli2Командой платформы
gemini skills install https://github.com/vtex/skills --path skills/vtex-io-auth-and-policiesВручную: положить файлы
.devin/skills/vtex-io-auth-and-policies/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-auth-and-policies -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о vtex-io-auth-and-policies
Как установить vtex-io-auth-and-policies в Claude Code?
Выполните npx skills add vtex/skills --skill vtex-io-auth-and-policies -a claude-code, затем проверьте файл ~/.claude/skills/vtex-io-auth-and-policies/SKILL.md.
Что делает vtex-io-auth-and-policies?
Скилл помогает выбирать политики для ресурсов VTEX, приложений и внешних HTTP-сервисов. Он также проверяет серверные ограничения для защищённых маршрутов.
Что нужно учитывать при настройке outbound-access?
Правило должно охватывать нужный хост и путь, а не лишние адреса. Для ресурсов с License Manager или политиками приложений нужны соответствующие записи в manifest.json.
