# Seguridad y SBOM

> Cómo gestiona AI CodeOps los hallazgos de seguridad, los SBOM por proyecto (CycloneDX y SPDX), las licencias en el control de publicación, los terminales en sandbox y los secretos cifrados.

Fuente: https://aicodeops.dev/es/docs/security-and-sbom

AI CodeOps busca problemas de seguridad en cada cambio que escribe, hace un seguimiento de lo que entrega cada proyecto mediante su lista de materiales de software (SBOM) y registra quién hizo qué. Esta página cubre las partes con las que trabajas como administrador.

## Hallazgos de seguridad

Toda sesión termina con una revisión de su diff con IA. Los hallazgos de la categoría **security**, como cualquier hallazgo, llevan una gravedad (critical, high, medium, low, info), el archivo y la línea, y un estado de triaje. Los hallazgos abiertos de gravedad high y critical bloquean el cambio hasta que pasan por triaje; consulta [Controles de calidad](https://aicodeops.dev/es/docs/quality-gates).

Los flujos de trabajo creados para el trabajo de seguridad van más allá. **Security-Sensitive Change** ejecuta un análisis de riesgos antes de que se escriba el cambio y audita el diff después. **Threat Model** produce un análisis STRIDE y lo registra como un registro de decisión de arquitectura. Consulta [Agentes y flujos de trabajo](https://aicodeops.dev/es/docs/agents).

**Secure → Security** muestra la situación de seguridad del espacio de trabajo: una puntuación, los recuentos por gravedad y una tabla de hallazgos de seguridad abiertos, con la gravedad, el archivo (en **Package**), la descripción y la corrección que recomienda el revisor. La columna **CVE** muestra un guion, porque no hay escáner de CVE. **Fix with AI** lanza una sesión para corregir un hallazgo. Como en cualquier sesión, revisas y apruebas el cambio antes de que se abra un pull request.

## SBOM por proyecto

Un SBOM lista los componentes que entrega un proyecto, con sus versiones y sus licencias. AI CodeOps hace el seguimiento de los SBOM por proyecto en formato **CycloneDX** o **SPDX**.

Cada registro SBOM contiene el formato y la versión, el número de componentes y de componentes vulnerables, un resumen de licencias, el commit que describe, un hash SHA-256 y un enlace al archivo SBOM. AI CodeOps no genera SBOM: crea el tuyo con la herramienta que ya usas en tu build.

Dónde los ves:

- **Secure → Security**, panel **Software Bill of Materials**: los proyectos con SBOM, las licencias distintas y un resumen de licencias de todos los proyectos.
- La página de un proyecto: **Recent SBOMs** y **Vulnerable components (latest SBOM)**.

En la beta abierta no hay formulario de subida. Una instantánea se registra con una petición a `/api/sbom` desde una sesión iniciada; registrar una desde CI con una clave de API todavía no está disponible. Para mirar dentro de un archivo SBOM sin iniciar sesión, prueba el [visor de SBOM](https://aicodeops.dev/tools/sbom-viewer).

## Comprobaciones de licencias

El control de publicación al que llama tu CI puede denegar un cambio cuando el último SBOM del proyecto contiene una licencia que no permites, como `GPL-3.0` o `AGPL-3.0`. Un proyecto sin SBOM no se puede comprobar, así que el control también lo deniega cuando hay fijada una regla de licencias. Las opciones están en la [página de la API](https://aicodeops.dev/es/docs/api).

## Ejecución en sandbox

Las sesiones se ejecutan en la plataforma, no en tu máquina. Cuando una sesión ejecuta tus pruebas, lo hace en un entorno aislado para el proyecto.

**Develop → Terminal** (beta) abre una shell en la raíz de tu proyecto, en su propio sandbox aislado: un contenedor en la plataforma, nunca los servidores propios de la plataforma. Abrir un terminal requiere un rol que pueda gestionar proyectos, y la disponibilidad depende de tu plan.

## Secretos y claves

- Los tokens de Git, las claves de proveedor de modelos y los secretos del espacio de trabajo se cifran en reposo con AES-256-GCM.
- Las claves de API se guardan solo como un hash y se muestran una vez, al crearlas.
- Los secretos del espacio de trabajo se gestionan en **Configure → Settings**; el rol Secret Manager puede gestionar secretos sin ningún otro acceso.

## Registro de auditoría

**Measure → Audit Log** recoge qué cambió en el espacio de trabajo y quién lo cambió: miembros y roles, claves, proveedores, políticas, agentes, programaciones, presupuestos, secretos, aprobaciones y código generado. Cada entrada tiene la hora, la cuenta, el destino y la dirección IP. Los roles Owner, Admin y Security Admin pueden leerlo. Cuánto tiempo se conservan las entradas depende de tu plan.

## Siguientes pasos

- [Aprobaciones y políticas](https://aicodeops.dev/es/docs/approvals-and-policies)
- [Miembros y roles](https://aicodeops.dev/es/docs/members)
- [Paquetes de evidencias](https://aicodeops.dev/es/docs/evidence-packs)

## Preguntas frecuentes

### ¿AI CodeOps genera los SBOM por mí?

No. Tú generas el SBOM con tu herramienta habitual y lo registras para el proyecto. AI CodeOps hace su seguimiento y lo usa para las comprobaciones de licencias.

### ¿Dónde se muestran los hallazgos de seguridad?

En la página de ejecución de la sesión que los encontró, y para todo el espacio de trabajo en Secure → Security.
