Código fuente preliminar 0.1
Compila localmente.
Conecta tu editor.
El backend y la extensión de VS Code son componentes separados. Inicia el backend local, compila el VSIX y conecta el perfil que ya utilizas.
La publicación en Marketplace está pendiente. Mac ARM64 y Ubuntu AMD64 cuentan con aceptación funcional acotada; Fedora está parcialmente probado y Windows nativo y Remote WSL son experimentales. Lee los límites por plataforma.
Antes de empezar
Comprueba los requisitos.
- Backend
- Python 3.12+, Git, Make, un motor Docker Linux local, Compose y Buildx. El lanzador requiere el builder predeterminado reservado, con un único nodo activo del controlador Docker en el mismo motor.
- Editor
- VS Code de escritorio oficial 1.135+ para la extensión. Las versiones mínimas son requisitos, no una promesa de que todas las versiones posteriores estén calificadas.
- Compilación de la extensión
- Node.js y npm. La compilación documentada acepta Node estable 20.18.1+ en 20.x o 22+; excluye Node 21 y versiones preliminares. La guía recomienda una versión LTS 22 o posterior.
- Almacenamiento y red
- Una compilación nueva necesita acceso a la red y 32 GiB libres tanto en el almacenamiento de código/estado como en el de compilación de Docker. Reiniciar con imágenes coincidentes tiene un mínimo aparte de 2 GiB. Son umbrales de admisión, no consumo estable medido; la preparación de escáneres comprueba el espacio de caché por separado.
Lee las instrucciones específicas de tu plataforma antes de instalar dependencias. Mantén el checkout del backend separado de los repositorios que analizarás. El lanzador comprueba requisitos; no los instala ni reconfigura.
Inicia el backend.
En macOS o Linux, ejecuta estos comandos desde el directorio donde guardas los checkouts. El comando checkout fija la revisión pública documentada en este sitio.
git clone https://github.com/lomolabs/lomo-codesecurity.git
cd lomo-codesecurity
git checkout --detach 0b47fd8e14640155435de01c499260fe466c8e1e
python3 scripts/start-lomo.py --check --json
python3 scripts/start-lomo.pyEl comando --check nunca descarga su imagen de comprobación de almacenamiento. En un motor nuevo, engine_storage_probe_missing indica que el inicio normal debe obtener antes esa dependencia fijada. Para otros fallos, sigue las instrucciones de recuperación del informe.
El inicio normal compila y arranca el backend. Su dirección predeterminada es http://127.0.0.1:8080. No abre un editor ni instala la extensión. Repetir el comando conserva los datos y emparejamientos de la instalación y reutiliza compilaciones coincidentes.
Opciones de inicio y recuperación · Elegir otro puerto local
Añade la extensión a VS Code.
Desde el mismo checkout revisado, con Node.js y npm disponibles:
make vscode-packageEn tu perfil habitual, ejecuta Extensions: Install from VSIX… y selecciona:
.kodesec-test/vscode/code-security-0.1.0.vsixAbre tu proyecto y ejecuta CodeSecurity: Get Started. El ID de la extensión es lomo-dev.code-security. La instalación no inicia el backend ni reemplaza tus otras extensiones.
Revisa Workspace Trust como siempre. El primer perfil apto usa el flujo de conexión del primer propietario de la instalación. Los perfiles adicionales requieren aprobación del propietario en Settings > Trusted access > IDE access, usando el código de verificación y el nombre de perfil mostrados. No hace falta pegar ningún secreto de acceso en el editor.
Configuración solo con navegador · Entender la autorización de perfiles
Completa la primera revisión local.
- Autoriza el código. Selecciona un repositorio individual y revisa su autorización limitada. Seleccionar un hijo nunca concede acceso al padre ni a sus hermanos.
- Prepara los escáneres. Elige Tools > Prepare all scanners. Espera a que los escáneres habilitados estén listos. El actualizador separado verifica datos y reglas sin acceder a tu código.
- Analiza y revisa. Analiza el repositorio, una carpeta o un archivo compatible. Usa Findings, Problems y Open Finding in Web para inspeccionar resultados y cobertura. Una lista vacía de hallazgos no demuestra que el análisis sea completo, y un análisis completado puede no superar el control de su política.
- Elige la protección. Revisa los umbrales y usa Protect Pushes… para aprobar y aplicar protección a ese clon. Check Outgoing Commits… comprueba el historial confirmado que quieres enviar.
Un análisis real de ejemplos sintéticos de SRE deliberadamente inseguros en VS Code. Empieza en la línea señalada, abre el hallazgo desde su mensaje al pasar el cursor en VS Code e inspecciona las evidencias del código en el entorno de trabajo.
Un escaneo del espacio de trabajo por sí solo no instala un hook. Las pruebas incompletas, canceladas, fallidas u obsoletas no pueden autorizar un push protegido. Los hooks locales pueden omitirse con --no-verify o con otro clon; usa controles remotos para una aplicación que no pueda evitarse.
Mantén actualizados el código y los datos de los escáneres.
La revisión fijada permite comprobar estas instrucciones. Sus definiciones de escáner incluidas tienen caducidad. Cuando caduquen, obtén código revisado más reciente, ejecuta el inicio normal para recompilar las entradas modificadas y prepara de nuevo los escáneres. Descargar la misma definición caducada no la renueva.
Conserva el estado privado de ejecución y los volúmenes Docker con nombre durante las actualizaciones. Los ayudantes de copia y restauración no son un sistema validado de recuperación ante desastres. Consulta mantenimiento de escáneres y persistencia de datos.
Fuente de instalación: Código fuente preliminar 0.1 · 0b47fd8. Comprueba el estado de plataformas y versión