AIKraft/Skills/VTEX IO: токены аутентификации и контекст

VTEX IO: токены аутентификации и контекст

Apply when choosing which VTEX IO authentication token should back a request from a backend app. Covers `ctx.authToken`, `ctx.storeUserAuthToken`, `ctx.adminUserAuthToken`, `authMethod`, and how requester context should determine the identity used by VTEX clients. Use for deciding which identity talks to VTEX endpoints in storefront-backed requests, Admin actions, or app-level integrations that sh

vtex official Другое

Что делает навык

Навык определяет, какой токен аутентификации VTEX IO (пользователя магазина, администратора или приложения) следует использовать для бэкенд-запросов к сервисам VTEX. Он помогает выбрать правильную идентичность для storefront, Admin-интеграций или замены хардкода appKey и appToken.

Когда применять

  • Выбор между ctx.authToken, ctx.storeUserAuthToken и ctx.adminUserAuthToken для бэкенд-запроса.
  • Решение, использовать ли AUTH_TOKEN, STORE_TOKEN или ADMIN_TOKEN для вызова клиента VTEX.
  • Анализ интеграций storefront и Admin на предмет соблюдения текущей идентичности пользователя.
  • Замена использования хардкода appKey и appToken внутри приложения VTEX IO.

Как работает

  1. Определить контекст запроса: является ли он частью storefront, Admin-интеграции или уровня приложения.
  2. Выбрать соответствующий токен: ctx.authToken для пользователей магазина, ctx.adminUserAuthToken для администраторов или специфичные токены приложения.
  3. Настроить вызов клиента VTEX на использование выбранного токена (AUTH_TOKEN, STORE_TOKEN или ADMIN_TOKEN).
  4. Убедиться, что в коде не используется хардкод appKey и appToken, а применяется контекстный токен.

Примеры запросов агенту

Какой токен использовать для запроса от имени текущего пользователя магазина в бэкенде?
Как заменить хардкод appKey и appToken в приложении VTEX IO?
Нужно ли использовать ctx.adminUserAuthToken для интеграции с Admin-интерфейсом?

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «vtex-io-auth-tokens-and-context» из репозитория: # https://github.com/vtex/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r vtex-io-auth-tokens-and-context/ ~/.claude/skills/vtex-io-auth-tokens-and-context/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.