Files
dtic-DIIAA/servicios/nexxa/organismo/lib_envelope.rb
T
a60758875d
Tests ADN / test (push) Canceled after 0s
feat(nexxa): NEXXA versionada en dtic-DIIAA (1.3.0): pools por individuo mente/red, API por rol y gestión desde nexxa-web
- Base: código de producción de srvv-nexxa (1.2.1), importado y verificado por hash (P335/F3)
- Pools por individuo (lib_pools): mente y red, mezclan proveedores, keys compartidas o exclusivas
- API: /disponible/mente|red y /estado por rol, pool_vacio explícito, /pools (CRUD admin), liberar admin
- Revertir el agotada propio + motivo y quién la agotó (de P334/F4)
- nexxa-web: sección Pools, motivo y botón Liberar, provider libre con sugerencias, escape de texto externo
- Convención REG002: lib_*, cli_*, tool_humo_pool; contratos externos con su nombre
- Suite local sobre copia aislada: humo HTTP, pools, revertir; servidor_prueba para mirar la web

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Co-Authored-By: GEMMA <noreply@gemma.dtic>
2026-10-04 16:42:13 -03:00

39 lines
1.9 KiB
Ruby

# frozen_string_literal: true
# lib_envelope.rb — Cifrado de punta a punta hacia el consumidor (P204, "Aplica
# Pilares" sobre la decisión previa de diferirlo)
# ==============================================================================
# Distinto de lib_cripto.rb (AES simétrico, master key propia de NEXXA, cifra EN
# REPOSO — lo que NEXXA guarda). Esto es asimétrico (RSA-OAEP), cifra PARA EL
# CONSUMIDOR — ni NEXXA ni nadie que capture el cuerpo de la respuesta HTTP
# puede leer el valor sin la clave PRIVADA del individuo, que NUNCA sale de
# ese individuo (NEXXA solo guarda la pública, ver lib_tokens.rb).
#
# RSA-OAEP directo (sin AES intermedio): las API keys son strings cortos
# (~30-60 bytes) — un RSA de 2048 bits con padding OAEP-SHA256 cifra hasta
# ~190 bytes de una, de sobra. No hace falta el patrón "envelope" clásico
# (RSA cifra una clave AES efímera, AES cifra el payload grande) porque acá
# el payload YA es chico — agregar esa capa sería complejidad sin beneficio
# real (Menos es Más).
# ==============================================================================
require 'openssl'
require 'base64'
module Nexxa
module Envelope
# Cifra `valor` con la clave pública PEM del consumidor — devuelve base64,
# listo para meter en un campo JSON de la respuesta HTTP. Nunca falla en
# silencio: una clave pública inválida hace que esto reviente (server.rb
# decide qué hacer, no lo traga acá).
def self.cifrar_para(clave_publica_pem, valor)
rsa = OpenSSL::PKey::RSA.new(clave_publica_pem)
Base64.strict_encode64(rsa.public_encrypt(valor.to_s, OpenSSL::PKey::RSA::PKCS1_OAEP_PADDING))
end
# Deliberadamente NO hay Envelope.descifrar acá — descifrar es trabajo
# del CONSUMIDOR con su propia clave privada, nunca de NEXXA. Si NEXXA
# pudiera descifrar esto, no sería de punta a punta.
end
end