La exclusa soberana — PointSav Documentation

La exclusa soberana es el protocolo de commits y despliegue que impone una separación estructural entre las identidades que escriben trabajo y las identidades que lo publican en repositorios canónicos. Ningún autor de commits tiene acceso push directo a un repositorio canónico. Ninguna identidad push canónica es autora de commits. Las dos funciones están separadas criptográficamente: una sesión que escribe código no puede hacer push sin pasar por el paso explícito de promoción Stage 6, y ese paso de promoción no puede ejecutarlo la misma identidad que realizó el commit. Esto no es una política impuesta por la configuración de herramientas — es una imposibilidad estructural, ya que la clave de autor de commit y la clave de push pertenecen a directorios de identidad distintos.

[edit]Las cuatro identidades

El almacén de identidades de la plataforma define cuatro identidades, cada una respaldada por una clave SSH dedicada almacenada en un directorio de control exclusivo del operador al que ninguna sesión puede acceder ni modificar directamente:

Identidad	Clave	Función	Ámbito
`jwoodfine`	`id_jwoodfine`	Staging — Jennifer	Todos los commits en repos de ingeniería
`pwoodfine`	`id_pwoodfine`	Staging — Peter	Todos los commits en repos de ingeniería
`ps-administrator`	`id_pointsav-administrator`	Solo push	Org canónica `pointsav` en GitHub
`mcorp-administrator`	`id_woodfine-administrator`	Solo push	Org canónica `woodfine` en GitHub

Las identidades de staging (jwoodfine, pwoodfine) se usan exclusivamente a través de las herramientas de commit de la plataforma. Sus claves se conservan en el almacén de identidades controlado por el operador y nunca se elevan a derechos de push en repositorios canónicos. Las identidades de administrador tienen derechos de push en repositorios canónicos pero nunca se usan como autores de commits.

[edit]El flujo de commits

El trabajo fluye a través de tres niveles:

Nivel de staging (commits de jwoodfine, pwoodfine)
       │
       │ Promoción Stage 6 — iniciada por el operador, solo identidad administradora
       ▼
Nivel vendor canónico  (pointsav/* — push vía alias SSH ps-administrator)
       │
       │ Gobernanza de ingeniería de lanzamientos
       ▼
Nivel customer canónico  (woodfine/* — push vía alias SSH mcorp-administrator)

Las herramientas de commit de la plataforma alternan la autoría entre jwoodfine y pwoodfine en commits sucesivos. El paso de promoción empaqueta los commits en staging y los envía al remoto canónico correspondiente usando el alias SSH de la identidad administradora. Las claves de las identidades administradoras están configuradas solo para autenticación de push; no aparecen como autores de commits en el registro del repositorio.

[edit]La garantía estructural

La garantía de la exclusa no es "es poco probable que los usuarios hagan push directo" sino "el push directo desde una sesión de staging es estructuralmente imposible." Una sesión de staging que emite un comando de push apunta al remoto de staging, no al repositorio canónico. Alcanzar el repositorio canónico requiere el alias SSH administrador, que requiere la clave administradora, que requiere que el operador inicie explícitamente el paso de promoción Stage 6.

Esta separación cumple dos funciones para los operadores regulados. Primero, convierte el nivel de staging en un límite de revisión genuino: los commits promovidos llevan implícita la aprobación de que el operador revisó el trabajo antes de autorizar el push canónico. Segundo, mantiene el historial de commits limpio — cada commit en el repositorio canónico fue creado por una identidad de staging conocida, revisado en un momento conocido, y promovido mediante una acción deliberada del operador, conforme al mecanismo de transferencia de PI mediante squash-and-merge.

[edit]Custodia de claves

Las cuatro claves residen en el directorio de identidades controlado por el operador con permisos 0600, accesibles únicamente al usuario del sistema propietario del espacio de trabajo. Las herramientas de sesión leen las claves desde este directorio; ninguna clave se copia en un repositorio ni se exporta al entorno de la sesión. Un hook pre-commit bloquea los commits que contengan material de clave, aplicando la regla de custodia en la capa técnica en lugar de la capa de política. La misma disciplina de límite se extiende a las credenciales de inferencia de IA, que se conservan exclusivamente en la pasarela y nunca en los motores de inferencia.

[edit]Véase también

pairing-as-permission — el patrón de emparejamiento criptográfico que gobierna qué nodos pueden conectarse
machine-based-auth — el protocolo de autenticación basado en máquina de la plataforma
api-key-boundary-discipline — la misma disciplina de separación de claves aplicada a las credenciales de inferencia de IA
legal-and-ip-structure — el mecanismo de transferencia de PI que depende de esta separación del flujo de commits
single-boundary-compute-discipline — el límite de inferencia de IA que aplica la misma disciplina de separación de claves en la capa de modelo