Estensione VS Code

Installazione

Installa vetkit (publisher vetkit, id vetkit.vetkit-vscode) dal Visual Studio Code Marketplace. Richiede VS Code 1.85 o successivo.

Accesso

Esegui vetkit: Sign In dalla Command Palette oppure fai clic su Sign in to vetkit nella vista Findings.

1. Il browser apre l’app vetkit su /ide/connect e mostra un codice monouso. Verifica che corrisponda a quello mostrato in VS Code.
2. Scegli l’organizzazione e approva. Serve il ruolo di Membro o superiore; i Visualizzatori non possono approvare.
3. L’approvazione crea una chiave API di sola lettura (scope repos:read, audits:read, findings:read, findings:ai-fix) chiamata “VS Code — nome del dispositivo” che scade dopo 90 giorni. L’estensione la salva nel Secret Storage di VS Code.

L’estensione ti avvisa circa 7 giorni prima della scadenza della chiave. Quando la chiave scade o viene revocata, ti chiede di accedere di nuovo.

In alternativa, esegui vetkit: Set API Key e incolla una chiave creata da te.

Rilevamento del repository

L’estensione legge i remote nel .git/config dell’area di lavoro (senza eseguire git), li normalizza in host/owner/name e li cerca nell’organizzazione con cui hai effettuato l’accesso. Se c’è una sola corrispondenza, viene selezionata automaticamente.

Altrimenti vetkit: Select Repository mostra un selettore con l’opzione Connect this repository in vetkit, che apre la pagina Repositories di vetkit con il repository precompilato.

I risultati provengono dall’ultimo audit riuscito lato server, non dai buffer non salvati dell’editor. Sono contrassegnati come obsoleti quando l’HEAD locale è diverso dal commit sottoposto ad audit.

Disconnessione

• vetkit: Sign Out revoca la chiave sul server e la elimina dal dispositivo. Una chiave incollata manualmente viene solo dimenticata in locale; non viene revocata.
• Puoi anche revocare il dispositivo nell’app vetkit in Settings → Security → Connected devices; gli amministratori dell’organizzazione possono revocarlo in Settings → API keys.
• Rimuovere un membro da un’organizzazione, o cambiarne il ruolo in Visualizzatore, revoca automaticamente le sue chiavi VS Code in quell’organizzazione.

Dati inviati

• All’accesso, il nome del dispositivo (host), ripulito e usato per dare un nome alla chiave API.
• Il remote git normalizzato (host/owner/name) per la ricerca del repository.
• Richieste API autenticate per elencare repository, audit e risultati.

L’estensione non carica mai il codice sorgente.

Per le installazioni self-hosted, imposta vetkit.apiUrl (HTTPS è obbligatorio, tranne per localhost). La chiave viene inviata solo all’API che l’ha emessa.