Skip to content

El PPN Command Protocol

Topic

From the PointSav Documentation

El PPN Command Protocol es el formato de cable binario de 16 bytes utilizado por os-network-admin para emitir comandos a los nodos os-infrastructure a través de la malla WireGuard, sin intermediario central ni sobrecarga de sesión.

Updated 2026-05-30 · HistoryEnglish

El PPN Command Protocol es el formato de cable utilizado por cada plano de control os-network-admin para emitir comandos hacia los nodos os-infrastructure a través de la PointSav Private Network. Transmite comandos de flota como paquetes binarios de 16 bytes difundidos por UDP en el puerto 8090 sobre la malla WireGuard — sin intermediario central, sin cola y sin ningún servicio de terceros en el camino. Cada nodo de la flota recibe cada paquete simultáneamente; solo el nodo destinatario actúa.

[edit]Restricciones de diseño

El protocolo fue moldeado por tres requisitos que excluyen los enfoques convencionales:

Sin intermediario. Un intermediario de mensajes es un punto único de fallo y un problema de frontera de confianza — debe autenticarse, mantenerse y ser de confianza. El PPN Command Protocol elimina completamente al intermediario. El plano de control difunde; la malla entrega; el nodo decide.

Sin texto en claro. El protocolo se ejecuta exclusivamente sobre la malla WireGuard. El handshake IK del Noise Protocol de WireGuard autentica a cada par antes de que se entregue cualquier paquete. Un paquete de comandos nunca viaja por un enlace sin cifrar.

Sin verbosidad. Los comandos tienen 16 bytes. No hay negociación de sesión, ni handshake de reconocimiento, ni sobrecarga de enmarcado. En el nodo receptor, una lectura de 16 bytes coincide con una operación conocida o no lo hace.

[edit]El formato del paquete

Cada comando tiene exactamente 16 bytes. Los primeros dos bytes constituyen el código de operación: un byte identificando la clase de operación, un byte identificando el nodo destino. Los 14 bytes restantes están disponibles para llevar carga útil específica de la operación — dirección del nodo, política de aislamiento u otros parámetros según la clase de operación.

 0               1               2               3  ...  15
 ┌───────────────┬───────────────┬───────────────────────────┐
 │  clase op (1) │  destino (1)  │  carga útil (14 bytes)    │
 └───────────────┴───────────────┴───────────────────────────┘

El código de operación es producido por service-slm ejecutándose localmente en el nodo os-network-admin — la frase en lenguaje natural que escribe el administrador nunca llega al cable.

[edit]La secuencia de despacho

  1. El administrador escribe su intención en lenguaje natural en el terminal F8 — por ejemplo, instruyendo a la flota que aísle un nodo de borde específico.
  2. service-slm, ejecutándose localmente en el nodo os-network-admin, analiza la frase y produce el código de operación de dos bytes que identifica la clase de operación y el destino.
  3. service-udp construye el paquete completo de 16 bytes y lo difunde a través de la malla WireGuard en el puerto UDP 8090.
  4. Cada nodo de la flota recibe el paquete simultáneamente. Solo el nodo cuya dirección coincide con el byte destino actúa; todos los demás descartan.

La capa de traducción es invisible en el límite del protocolo — la malla solo ve el comando binario, no la frase en lenguaje natural. No hay registro de auditoría del texto original en la capa del protocolo; ese registro reside en el log del terminal F8 en os-network-admin, no en la malla.

[edit]Por qué difusión simultánea

El modelo de difusión es deliberado. Un modelo de unidifusión requeriría que el plano de control mantuviera una tabla de enrutamiento con direcciones individuales para cada nodo, y requeriría sesiones TCP por nodo o reconocimientos. Ambos introducen estado que puede desincronizarse.

La difusión sobre una malla WireGuard elimina ambos problemas. Cada par recibe cada paquete. El nodo destinatario actúa; los demás descartan en la primera comparación de bytes. El plano de control no tiene estado de enrutamiento que mantener más allá de la lista de pares de la malla, que gestiona la función de política de enrutamiento de malla de os-network-admin.

La restricción de seguridad está satisfecha por la propia malla: los no miembros no pueden recibir paquetes de la malla porque no poseen un handshake WireGuard válido con el hub.

[edit]Relación con el Diode Standard

El PPN Command Protocol es la implementación en cable de la categoría de control descendente del Diode Standard. Fluye desde la autoridad (os-network-admin) hacia el sujeto (os-infrastructure) y nunca al revés. No existe un camino de comandos ascendente en el protocolo: el formato del paquete no contiene ninguna dirección de respuesta, ningún campo de reconocimiento y ningún mecanismo para que un nodo Sujeto inicie un paquete hacia la Autoridad.

La telemetría ascendente — logs, latidos, estado — viaja por un canal separado y estrictamente saneado. El canal de comandos y el canal de telemetría están desacoplados intencionalmente para que un fallo en uno no afecte al otro.

[edit]Véase también

  • os-network-admin — el plano de control que produce y difunde los paquetes de comandos
  • infrastructure-os — los nodos de sustrato de cómputo que reciben y ejecutan los comandos
  • diode-standard — la jerarquía de autoridad y las reglas de tráfico que implementa el protocolo
  • sovereign-mesh — la superposición WireGuard sobre la que se ejecuta el protocolo
  • service-slm — el enrutador semántico local que traduce la intención al código de operación de dos bytes
  • machine-based-auth — los pares de claves fiduciarias que aseguran los pares de la malla
Edit this page · View source