Guía de la versión preliminar · 0.1.0
Permisos de código y clientes
Entiende las decisiones separadas que permiten al cliente solicitar trabajo y al analizador leer código.
La referencia de la API está en inglés.
Conexión del editor, raíz autorizada y repositorio protegido aprobado responden a preguntas distintas. CodeSecurity comprueba cada una donde corresponde. Un nombre de proyecto o ruta enviados por el cliente no autorizan acceso por sí solos.
Separa las decisiones del propietario
Permisos del cliente
- Sesión de navegador
Sesión HttpOnly asociada; las modificaciones exigen también Origin y valor CSRF exactos.
- Capacidad IDE
La aprobación vincula perfil y generación de permisos previstos.
Admisión de solicitudes
- Comprobaciones de ruta y propietario
El cliente debe cumplir el alcance de ruta y sus controles específicos.
- Autorización del código
Una acción explícita del propietario solo expone raíces concretas revisadas o instantáneas admitidas.
Protección del repositorio
- Aprobación como miembro
La generación prevista del editor recibe permiso para el repositorio exacto.
- Aplicación en el host
Apply explícito cambia el clon local; solicitar un estado no lo instala.
Conexiones
Sesión de navegador a Comprobaciones de ruta y propietario
La pertenencia del navegador no evita los controles de propietario de cada operación.
Capacidad IDE a Comprobaciones de ruta y propietario
Solo se admite la lista exacta de capacidades permitidas.
Comprobaciones de ruta y propietario a Autorización del código
Seleccionar o registrar no concede por sí solo acceso al código del host.
Comprobaciones de ruta y propietario a Aprobación como miembro
La pertenencia IDE ordinaria no concede permiso de miembro del repositorio.
Aprobación como miembro a Aplicación en el host
El ajuste aprobado aún requiere aplicación explícita al clon previsto.
| Decisión | Qué permite | Qué sigue separado |
|---|---|---|
| Autenticación del navegador | Usar el control local dentro del límite de sesión | Las solicitudes no seguras requieren origen permitido y protección CSRF. |
| Pertenencia IDE | Usar rutas de los alcances y generación activa de la capacidad | Workspace Trust, acceso al código y aprobación de protección. |
| Workspace Trust | Permitir acciones admitidas del editor en ese espacio | Un montaje más amplio o aprobación de un nuevo propietario. |
| Autorización de raíz | Montar una raíz existente y concreta en solo lectura | Registro del proyecto y alcance de cada análisis. |
| Admisión de instantánea | Conservar una generación acotada con identidad comprobada | Acceso arbitrario al host o ejecución del código cargado. |
| Aprobación de protección Git | Permitir a la generación aprobada exacta gestionar el repositorio seleccionado | Prueba de hook aplicado, evidencia actual del push o aplicación del lado servidor. |
Los permisos de navegador y editor se revocan independientemente. Las solicitudes IDE se comprueban contra alcances exactos y generación activa. La API no es un servicio genérico de claves API. La guía de autenticación explica el flujo admitido.
El límite también valida Host y Origin y rechaza credenciales en URL. Autenticar no sustituye comprobaciones de propietario específicas. Consulta middleware de seguridad y autorización IDE.
El código montado es un límite explícito del host
En los flujos POSIX y Remote WSL admitidos, el propietario elige raíces existentes concretas. El auxiliar canonicaliza y rechaza raíces amplias, formas inseguras y valores no serializables literalmente en el entorno Compose. Admite como máximo 32 raíces distintas. Compose no crea un origen bind ausente para satisfacer la solicitud.
La API no monta código de proyectos. Su vista previa comprueba si la ruta está dentro de los permisos configurados y decide sin crear proyecto o trabajo. Crear un proyecto registra esa identidad. Al ejecutar, el analizador verifica independientemente la ruta real y usa lecturas restringidas; no toma la comprobación léxica de la API como prueba de acceso seguro.
Los análisis de archivo y directorio permanecen en el repositorio autorizado. El analizador valida el objetivo y captura la vista para las herramientas. Una solicitud no convierte la selección de directorio en permiso fuera de su raíz.
Los puntos de entrada son validación de raíces, vista previa y creación de proyecto y lecturas relativas a descriptor.
Las instantáneas llevan código, no un montaje más amplio
Los flujos Windows nativos admitidos y los árboles Git inmutables usan el almacén dedicado. La API valida rutas, recuentos, tamaños e identidad antes de publicar una generación sellada. El análisis debe nombrar el digest esperado exacto; un proyecto de código montado no puede sustituirlo silenciosamente por una instantánea cargada.
| Límite | Implementación fijada |
|---|---|
| Carga de instantánea | Hasta 5.000 archivos, 8 MiB por archivo y 64 MiB de código. |
| Generaciones conservadas o interrumpidas | Hasta 256. |
| Inventario del almacén | Hasta 65.536 entradas y 64 niveles de directorio. |
| Almacenamiento agregado | Hasta 2 GiB, contabilizando asignación del sistema de archivos y metadatos. |
| Espacio libre para admisión | Nueva asignación más una reserva adicional de 2 GiB. |
Publicación y borrado explícito comparten un bloqueo privado que no sigue enlaces. Un escritor simultáneo recibe snapshot_storage_busy; almacenamiento inseguro o ilegible, snapshot_storage_unavailable; falta de capacidad, snapshot_storage_full. No se encola un reintento oculto ni se borra evidencia antigua automáticamente.
Una generación sellada idéntica se valida y reutiliza sin otra copia, incluso si no caben escrituras nuevas. Una publicación interrumpida sigue consumiendo presupuesto. Solo son borrables generaciones correspondientes revisadas explícitamente. Otros procesos consumen disco, por lo que estos límites locales no garantizan que nunca se llene.
Consulta admisión de instantáneas y contrato de almacenamiento. Captura y límite menor de análisis de texto apto son distintos, como explica análisis.
Vincula navegación y evidencia actual
La ruta de un hallazgo es evidencia, no una instrucción para abrir cualquier archivo. Los comandos de apertura vinculan generación IDE seleccionada, revisión del hallazgo y revisión de colección. Destinatarios obsoletos o ambiguos requieren reconciliación.
Los hallazgos de árboles confirmados tienen un límite más estricto: la API rechaza abrir un archivo actual supuestamente equivalente. El árbol de trabajo puede diferir del histórico que produjo el hallazgo. Revisa el detalle capturado. El rechazo es explícito en los comandos de código IDE.
Conserva el límite al integrar
Usa sesiones de navegador o permisos IDE admitidos y comprueba además la propiedad del recurso. No amplíes raíces para resolver una capacidad obsoleta, confundas vista previa con análisis terminado ni deduzcas aceptación nativa de plataforma por existir instantáneas. El comportamiento real exige evidencia del código, imagen y cliente exactos usados.