ZynplexZPX Forgeby Zynplex
Operación.md

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.