# Seguridad

## Tu código

ZPX Forge no almacena código. Los agentes trabajan en la máquina de cada desarrollador; la plataforma
solo guarda metadatos (proyectos, tareas, eventos) y lo que GitHub expone a la app que instalas.

## Empresas aisladas

Todo dato de negocio pertenece a una empresa y se consulta a partir de ella. Quien no es miembro recibe
*no encontrada*. Hay pruebas automáticas que lo verifican en cada cambio.

## Cuentas

El acceso a la web requiere GitHub y un correo verificado. Para aceptar una invitación o decidir sobre una entrega, usa la cuenta asociada al correo designado. Forge mantiene la sesión en una cookie protegida y comprueba el origen de las solicitudes que modifican datos.

## GitHub

- La instalación se vincula solo si la persona controla la cuenta de GitHub.
- Los webhooks se verifican con su firma y se procesan una sola vez.
- La llave privada de la app nunca sale del servidor.

## Infraestructura

```
Navegador → zpxforge.com (Vercel) → balanceador AWS (HTTPS) → backend privado
```

El backend no tiene IP pública y solo acepta tráfico que pasó por Vercel, identificado con una llave
compartida.

## Auditoría

Cada acción relevante (registro, aprobaciones, invitaciones, roles, repos, GitHub) queda registrada con
quién, cuándo y desde dónde.

## Fichas compartidas

Quien tenga el enlace público puede consultar la instantánea durante su vigencia de 30 días o hasta su revocación. Para decidir sobre una entrega, el cliente externo abre el enlace privado con su cuenta de correo verificada y designada para ese hito.

## Auditoría de seguridad Pro

Desde el repositorio de destino conectado a Forge, inicia sesión con `zpx login`, elige el proyecto con `zpx use empresa/proyecto` y ejecuta `zpx audit`. Usa `zpx audit --pdf informe.pdf` para guardar el PDF al registrar la revisión. El diagnóstico básico `zpx audit` sigue disponible sin cuenta. La revisión Pro analiza el último commit guardado en Git. Los cambios que solo están en tu editor quedan para la próxima revisión.

Añade `--agent claude` o `--agent codex` para generar la lectura ejecutiva con el perfil de auditor de Forge. El cliente elegido recibe los totales, una muestra de hasta 15 hallazgos priorizados y hasta 10 límites de cobertura. Su interpretación queda identificada en el portal y en el PDF junto a las tablas de criticidad, evidencia y correcciones. La autorización sigue a cargo del responsable.

El CLI 0.3.0 comprueba archivos de entorno versionados, workflows, indicios de ejecución dinámica en Python, mensajes privilegiados con contenido dinámico y llamadas HTTP sin tiempo límite. En JavaScript y TypeScript revisa la inserción de HTML, la evaluación dinámica y el acceso síncrono a archivos en funciones asíncronas. Lee las versiones públicas de npm y PyPI en `package-lock.json` y `uv.lock`, consulta sus nombres y versiones en OSV y señala paquetes npm marcados como obsoletos. Para las dependencias directas públicas compara la versión fijada con la vigente en su registro. En despliegues Kubernetes revisa límites de memoria y pruebas de disponibilidad. Forge recibe las rutas, evidencias resumidas y propuestas de corrección. El portal identifica esta fuente como **declarada por el equipo**. Una prueba de carga del servicio y una evaluación del comportamiento del modelo requieren evidencia adicional.

Si tu aplicación usa plantillas de mensajes JSON, guarda la plantilla real con el sufijo `.prompt.json`. La comprobación local coloca un documento de muestra donde aparece `{{document}}` y verifica en qué rol termina. Un ejemplo de estructura compatible es `{"messages":[{"role":"system","content":"Resume el documento."},{"role":"user","content":"{{document}}"}]}`. El informe indica cuántas plantillas se comprobaron.

En **Proyecto → Auditoría de seguridad** puedes descargar el PDF de cada versión. Cada hallazgo genera una propuesta de especificación. Quien tiene la responsabilidad de **Specs** puede marcar hallazgos individuales o usar **Seleccionar todas**. Al aprobar la selección, las tareas nuevas entran en la primera ola abierta. Si la ola ya está aprobada o en curso, la persona necesita también permiso para aprobar el plan. Si todas están cerradas, el responsable del plan debe elegir explícitamente dónde continuar. Una vez incorporadas las correcciones, repite `zpx audit`. La comparación indica qué apareció, qué persiste y qué dejó de detectarse. Una comprobación incompleta deja los resultados anteriores pendientes de verificar.

En **Plan → Gestión del plan**, elige **Revisiones de seguridad** para consultar las correcciones históricas por estado. El historial de informes está en **Entregas → Auditoría de seguridad**.

El responsable con permiso de decisión de entrega autoriza o bloquea la revisión más reciente del repositorio. Los riesgos altos, críticos o de severidad desconocida y las comprobaciones incompletas impiden autorizar. Cada nuevo informe requiere otra decisión, incluso sobre el mismo commit.

### Aplicar el control al despliegue real

En GitHub, habilita la regla de protección de la aplicación ZPX Forge en el entorno de producción y configura el trabajo que despliega para utilizar ese entorno. La instalación necesita permiso de escritura en **Deployments** y la aplicación debe recibir el evento `deployment_protection_rule`. Cuando GitHub solicita autorización, Forge responde para el repositorio y el commit exactos. Tras un rechazo, corrige los hallazgos, registra y aprueba la nueva revisión y vuelve a ejecutar el despliegue. La protección externa depende de que el proveedor use ese entorno para desplegar.

El mismo comando consulta la suscripción y tus permisos. Pro habilita el informe completo automáticamente. Individual recibe el diagnóstico básico. Si solicitas PDF o lectura con IA sin acceso, Forge explica que necesitas activar Pro.
