ZynplexZPX Forgeby Zynplex
Plataforma.md

GitHub

ZPX Forge se conecta a GitHub con una GitHub App que cada empresa instala en su cuenta u organización, eligiendo qué repos puede ver.

Instalación verificada

Al volver de GitHub, la instalación solo se vincula si:

  1. la inició esa misma persona, para esa empresa;
  2. es admin de la empresa en ZPX Forge;
  3. controla la cuenta de GitHub: es la suya o es admin de la organización.

Una instalación pertenece a una sola empresa.

Permisos que pide la app

PermisoPara qué
Contents · lectura y escrituraLeer specs/; proponer specs con pull requests
Pull requests · lectura y escrituraSeguir y abrir PRs
Checks y statuses · lectura y escrituraConsultar o publicar checks según la configuración
Deployments · escrituraAutorizar o rechazar el commit en el entorno de producción protegido con Forge Pro
Actions · lecturaVer ejecuciones de CI
Administration · lectura y escrituraProteger main y develop (opcional)
Members · lecturaRelacionar miembros de la organización

Protección de ramas

Desde un proyecto, Proteger develop y main crea en el repo un ruleset ZPX Forge · ramas protegidas: cambios solo por pull request, sin borrado ni force-push. Si ya existe, lo actualiza.

Webhooks y actividad

Cada entrega se verifica con su firma (X-Hub-Signature-256), se guarda una sola vez aunque GitHub la reintente y se procesa en segundo plano. Se convierte en actividad del proyecto:

Evento de GitHubActividad
pushpush (marca si cambió specs/)
pull_requestpr.opened, pr.merged, pr.closed, pr.reopened
check_suite fallidocheck.failed
workflow_run fallidoci.failed
installation, installation_repositoriesSincroniza instalaciones y repos