vtex-io-auth-tokens-and-context — скилл для Claude Code: выбор токена

Что делает vtex-io-auth-tokens-and-context

Скилл включается, когда главный вопрос — какая идентичность аутентифицирует запрос к сервисам VTEX. Он разбирает три варианта: ctx.authToken для операций уровня приложения, ctx.storeUserAuthToken для витрины и действий покупателя, ctx.adminUserAuthToken для запросов из админки, где важны права роли в License Manager.

Внутри — правила выбора и таблица соответствия токенов контексту, а также жёсткие ограничения с примерами кода на TypeScript. Если запрос инициировал покупатель или админ, скилл требует брать пользовательский токен, а не токен приложения. Клиенты VTEX, принимающие authMethod, получают выбор токена явно. При обёртке своих клиентов токен передаётся из IOContext на границе клиента, а не хардкодится в обработчиках.

Токен ADMIN_TOKEN с ctx.adminUserAuthToken должен оставаться только на сервере: его нельзя отдавать или проксировать в браузер. Логировать сырые токены и возвращать их в ответах тоже нельзя. Скилл не занимается политиками в manifest.json, маршрутной авторизацией и выбором между ExternalClient и JanusClient — это отдельные задачи.