Расширение VS Code

Установка

Установите vetkit (издатель vetkit, идентификатор vetkit.vetkit-vscode) из Visual Studio Code Marketplace. Требуется VS Code 1.85 или новее.

Вход

Выполните vetkit: Sign In в палитре команд или нажмите Sign in to vetkit в представлении Findings.

1. Браузер откроет приложение vetkit по адресу /ide/connect и покажет одноразовый код. Убедитесь, что он совпадает с кодом в VS Code.
2. Выберите организацию и подтвердите. Нужна роль «Участник» или выше; «Наблюдатели» подтвердить не могут.
3. После подтверждения создаётся API-ключ только для чтения (scopes repos:read, audits:read, findings:read, findings:ai-fix) с именем «VS Code — имя устройства», срок действия которого истекает через 90 дней. Расширение хранит его в защищённом хранилище VS Code (Secret Storage).

Расширение предупредит примерно за 7 дней до истечения срока действия ключа. Когда срок ключа истёк или он отозван, расширение предложит войти снова.

Также можно выполнить vetkit: Set API Key и вставить ключ, созданный вами самостоятельно.

Определение репозитория

Расширение читает remotes из файла .git/config рабочей области (не запуская git), приводит их к виду host/owner/name и ищет в организации, в которую вы вошли. Единственное совпадение выбирается автоматически.

В остальных случаях vetkit: Select Repository показывает список выбора с пунктом Connect this repository in vetkit, который открывает страницу Repositories в vetkit с заполненным репозиторием.

Результаты берутся из последнего успешного серверного аудита, а не из несохранённых буферов редактора. Они помечаются как устаревшие, если локальный HEAD отличается от проверенного коммита.

Отключение

• vetkit: Sign Out отзывает ключ на сервере и удаляет его с устройства. Вставленный вручную ключ лишь удаляется локально, но не отзывается.
• Устройство также можно отозвать в приложении vetkit в разделе Settings → Security → Connected devices, а администраторы организации могут отозвать его в Settings → API keys.
• При удалении участника из организации или смене его роли на «Наблюдатель» его ключи VS Code в этой организации отзываются автоматически.

Какие данные отправляются

• При входе — имя устройства (хоста) после очистки; по нему называется API-ключ.
• Нормализованный git remote (host/owner/name) для поиска репозитория.
• Аутентифицированные запросы к API для получения списков репозиториев, аудитов и результатов.

Расширение никогда не загружает исходный код.

Для самостоятельно развёрнутых установок задайте vetkit.apiUrl (нужен HTTPS, кроме localhost). Ключ отправляется только в тот API, который его выдал.