Extensión de VS Code

Instalación

Instala vetkit (editor vetkit, id vetkit.vetkit-vscode) desde el Marketplace de Visual Studio Code. Requiere VS Code 1.85 o posterior.

Iniciar sesión

Ejecuta vetkit: Sign In desde la paleta de comandos o haz clic en Sign in to vetkit en la vista Findings.

1. El navegador abre la aplicación de vetkit en /ide/connect y muestra un código de un solo uso. Comprueba que coincide con el que aparece en VS Code.
2. Elige la organización y aprueba. Necesitas el rol de Miembro o superior; los Lectores no pueden aprobar.
3. La aprobación crea una clave de API de solo lectura (scopes repos:read, audits:read, findings:read, findings:ai-fix) llamada “VS Code — nombre del dispositivo” que caduca a los 90 días. La extensión la guarda en el almacenamiento secreto de VS Code (Secret Storage).

La extensión avisa unos 7 días antes de que caduque la clave. Cuando la clave caduca o se revoca, te pide que inicies sesión de nuevo.

También puedes ejecutar vetkit: Set API Key y pegar una clave que hayas creado tú.

Detección del repositorio

La extensión lee los remotos del .git/config del espacio de trabajo (sin ejecutar git), los normaliza a host/owner/name y los busca en la organización con la sesión iniciada. Si hay una sola coincidencia, se selecciona automáticamente.

En caso contrario, vetkit: Select Repository muestra un selector con la opción Connect this repository in vetkit, que abre la página Repositories de vetkit con el repositorio rellenado.

Los resultados provienen de la última auditoría correcta en el servidor, no de los búferes del editor sin guardar. Se marcan como obsoletos cuando tu HEAD local difiere del commit auditado.

Desconectar

• vetkit: Sign Out revoca la clave en el servidor y la elimina de tu dispositivo. Una clave pegada manualmente solo se olvida en local; no se revoca.
• También puedes revocar el dispositivo en la aplicación de vetkit en Settings → Security → Connected devices, y los administradores de la organización pueden hacerlo en Settings → API keys.
• Al eliminar a un miembro de una organización, o al cambiar su rol a Lector, sus claves de VS Code en esa organización se revocan automáticamente.

Datos enviados

• Al iniciar sesión, el nombre del dispositivo (host), depurado y usado para nombrar la clave de API.
• El remoto de git normalizado (host/owner/name) para buscar el repositorio.
• Solicitudes autenticadas a la API para listar repositorios, auditorías y hallazgos.

La extensión nunca sube código fuente.

En instalaciones autoalojadas, define vetkit.apiUrl (se requiere HTTPS, salvo en localhost). La clave solo se envía a la API que la emitió.