PWR Túnel

require_once __DIR__ . '/core/tunel.php';

require_once 'core/tunel.php';

// 1. Cada sede genera sus claves
$sede_a = pwr_tunel_generar_claves();
$sede_b = pwr_tunel_generar_claves();

// 2. Handshake: A encapsula con pk de B
$hs = pwr_tunel_handshake($sede_b['pk']);

// 3. B decapsula y obtiene el mismo shared_secret
$dec = pwr_tunel_decapsular($sede_b['sk'], $hs['ciphertext']);

// 4. Ambos crean sesion con el shared_secret
$sesion = pwr_tunel_crear_sesion($hs['shared_secret']);

// 5. A envia request cifrado a B
$paquete = pwr_tunel_empaquetar_request(
    'POST',
    'https://sede-b.ejemplo.es/api/datos',
    ['Content-Type' => 'application/json'],
    '{"expediente":"2026/001"}',
    $sesion
);

// B desempaqueta
$request = pwr_tunel_desempaquetar_request(
    $paquete['paquete'],
    $sesion
);

pwr_tunel_generar_claves(): array

$claves = pwr_tunel_generar_claves();

// Guardar la pk para enviarla a la otra sede
file_put_contents('mi_pk.b64', $claves['pk']);

// Guardar la sk en lugar seguro (nunca compartir)
file_put_contents('mi_sk.b64', $claves['sk']);

pwr_tunel_handshake(string $pk_destino): array

pwr_tunel_decapsular(string $sk, string $ciphertext): array

// Sede A: encapsula con pk de B
$hs = pwr_tunel_handshake($pk_sede_b);
// Enviar $hs['ciphertext'] a la sede B

// Sede B: decapsula con su sk
$dec = pwr_tunel_decapsular($sk_sede_b, $hs['ciphertext']);

// Ambos tienen el mismo shared_secret
// $hs['shared_secret'] === $dec['shared_secret']

pwr_tunel_crear_sesion(string $shared_secret, array $opciones = []): array

pwr_tunel_estado(array $sesion): array

pwr_tunel_cifrar(string $datos, array &$sesion): array

pwr_tunel_descifrar(array $datos_cifrados, array &$sesion): array

$texto = 'Datos sensibles del expediente municipal';

// Cifrar con doble capa
$cifrado = pwr_tunel_cifrar($texto, $sesion);

// Descifrar
$descifrado = pwr_tunel_descifrar($cifrado, $sesion);
// $descifrado['datos'] === $texto

pwr_tunel_empaquetar_request(
    string $method,
    string $url,
    array $headers,
    string $body,
    array &$sesion
): array

pwr_tunel_desempaquetar_request(string $paquete, array &$sesion): array

pwr_tunel_empaquetar_response(
    int $status,
    array $headers,
    string $body,
    array &$sesion
): array

pwr_tunel_desempaquetar_response(string $paquete, array &$sesion): array

// Sede A envia request
$req = pwr_tunel_empaquetar_request(
    'POST',
    'https://sede-b.palma.es/api/registro',
    ['Content-Type' => 'application/json'],
    '{"ciudadano":"12345678A"}',
    $sesion
);
// Enviar $req['paquete'] por HTTPS a la sede B

// Sede B recibe y desempaqueta
$request = pwr_tunel_desempaquetar_request($paquete_recibido, $sesion);
// $request['method'] === 'POST'
// $request['body'] === '{"ciudadano":"12345678A"}'

// Sede B responde
$res = pwr_tunel_empaquetar_response(
    201,
    ['Content-Type' => 'application/json'],
    '{"ok":true,"id":"REG-001"}',
    $sesion
);

pwr_tunel_rotar_claves(array &$sesion): array

// Rotar claves cada N mensajes o periodicamente
if ($sesion['paquetes'] % 100 === 0) {
    $rot = pwr_tunel_rotar_claves($sesion);
    // $rot['rotacion'] indica el numero de rotacion
}

Sede A                           Sede B
  |                                |
  |  1. Generar claves (pk_a, sk_a)  1. Generar claves (pk_b, sk_b)
  |                                |
  |  2. Intercambiar pks           |
  |  ─────── pk_a ───────────────> |
  |  <─────── pk_b ─────────────── |
  |                                |
  |  3. Handshake PQC              |
  |  encapsular(pk_b) → ss + ct   |
  |  ─────── ct ─────────────────> |
  |                      decapsular(sk_b, ct) → ss
  |                                |
  |  4. Crear sesion(ss)           4. Crear sesion(ss)
  |                                |
  |  5. Empaquetar request         |
  |  [HTTP req] → cifrar(2 capas)  |
  |  ─── paquete cifrado ────────> |
  |                      desempaquetar → [HTTP req]
  |                                |
  |                      6. Empaquetar response
  |       descifrar ← [paquete] ── |
  |                                |