Extensão do VS Code

Instalação

Instale o vetkit (editor vetkit, id vetkit.vetkit-vscode) pelo Visual Studio Code Marketplace. É necessário o VS Code 1.85 ou superior.

Entrar

Execute vetkit: Sign In na Paleta de Comandos ou clique em Sign in to vetkit na visualização Findings.

1. O navegador abre o aplicativo vetkit em /ide/connect e mostra um código de uso único. Confira se ele corresponde ao código exibido no VS Code.
2. Escolha a organização e aprove. É necessário o papel de Membro ou superior; Visualizadores não podem aprovar.
3. A aprovação cria uma chave de API somente leitura (scopes repos:read, audits:read, findings:read, findings:ai-fix) chamada “VS Code — nome do dispositivo”, que expira após 90 dias. A extensão a armazena no armazenamento secreto do VS Code (Secret Storage).

A extensão avisa cerca de 7 dias antes de a chave expirar. Quando a chave expira ou é revogada, ela pede que você entre novamente.

Como alternativa, execute vetkit: Set API Key e cole uma chave que você mesmo criou.

Detecção do repositório

A extensão lê os remotes do .git/config do workspace (sem executar o git), normaliza-os para host/owner/name e os procura na organização em que você entrou. Se houver uma única correspondência, ela é selecionada automaticamente.

Caso contrário, vetkit: Select Repository mostra um seletor com a opção Connect this repository in vetkit, que abre a página Repositories do vetkit com o repositório preenchido.

Os resultados vêm da última auditoria bem-sucedida no servidor, não de buffers do editor não salvos. Eles são marcados como desatualizados quando o HEAD local difere do commit auditado.

Desconectar

• vetkit: Sign Out revoga a chave no servidor e a exclui do seu dispositivo. Uma chave colada manualmente é apenas esquecida localmente; ela não é revogada.
• Você também pode revogar o dispositivo no aplicativo vetkit em Settings → Security → Connected devices, e administradores da organização podem revogá-lo em Settings → API keys.
• Remover um membro de uma organização, ou mudar o papel dele para Visualizador, revoga automaticamente as chaves do VS Code dele nessa organização.

Dados enviados

• Ao entrar, o nome do dispositivo (host), higienizado e usado para nomear a chave de API.
• O remote git normalizado (host/owner/name) para a busca do repositório.
• Requisições autenticadas à API para listar repositórios, auditorias e achados.

A extensão nunca envia código-fonte.

Em instalações auto-hospedadas, defina vetkit.apiUrl (HTTPS é obrigatório, exceto para localhost). A chave só é enviada à API que a emitiu.