Extension VS Code

Installation

Installez vetkit (éditeur vetkit, identifiant vetkit.vetkit-vscode) depuis le Marketplace de Visual Studio Code. VS Code 1.85 ou version ultérieure est requis.

Connexion

Exécutez vetkit: Sign In depuis la palette de commandes, ou cliquez sur Sign in to vetkit dans la vue Findings.

1. Votre navigateur ouvre l’application vetkit sur /ide/connect et affiche un code à usage unique. Vérifiez qu’il correspond à celui affiché dans VS Code.
2. Choisissez l’organisation et approuvez. Le rôle Membre ou supérieur est requis ; les Lecteurs ne peuvent pas approuver.
3. L’approbation crée une clé d’API en lecture seule (scopes repos:read, audits:read, findings:read, findings:ai-fix) nommée « VS Code — nom de l’appareil », qui expire après 90 jours. L’extension la stocke dans le stockage secret de VS Code (Secret Storage).

L’extension vous avertit environ 7 jours avant l’expiration de la clé. Lorsque la clé expire ou est révoquée, elle vous demande de vous reconnecter.

Vous pouvez aussi exécuter vetkit: Set API Key et coller une clé que vous avez créée vous-même.

Détection du dépôt

L’extension lit les remotes du fichier .git/config de l’espace de travail (sans exécuter git), les normalise en host/owner/name et les recherche dans l’organisation connectée. Une correspondance unique est sélectionnée automatiquement.

Sinon, vetkit: Select Repository affiche un sélecteur avec l’option Connect this repository in vetkit, qui ouvre la page Repositories de vetkit avec le dépôt prérempli.

Les résultats proviennent du dernier audit réussi côté serveur, et non des tampons non enregistrés de l’éditeur. Ils sont marqués comme obsolètes lorsque votre HEAD local diffère du commit audité.

Déconnexion

• vetkit: Sign Out révoque la clé sur le serveur et la supprime de votre appareil. Une clé collée manuellement est seulement oubliée localement ; elle n’est pas révoquée.
• Vous pouvez aussi révoquer l’appareil dans l’application vetkit sous Settings → Security → Connected devices ; les administrateurs de l’organisation peuvent le faire sous Settings → API keys.
• Retirer un membre d’une organisation, ou passer son rôle à Lecteur, révoque automatiquement ses clés VS Code dans cette organisation.

Données envoyées

• À la connexion, le nom de l’appareil (hôte), nettoyé et utilisé pour nommer la clé d’API.
• Le remote git normalisé (host/owner/name) pour la recherche du dépôt.
• Des requêtes d’API authentifiées pour lister les dépôts, les audits et les constats.

L’extension n’envoie jamais de code source.

Pour les installations auto-hébergées, définissez vetkit.apiUrl (HTTPS est requis, sauf pour localhost). La clé n’est envoyée qu’à l’API qui l’a émise.