¿Te resulta más fácil leer con fondo crema, un tono de color, más contraste o un texto más grande? Elige tus colores y tu texto una sola vez, para todas las páginas.

Lección gratuita

Intercambio de claves ML-KEM con OpenSSL

Después de esta lección: Puedo crear un par de claves ML-KEM y usarlo para compartir un secreto con OpenSSL.

Lección de 65 min12 comandosLaboratorio de criptografía poscuántica: ML-KEM, ML-DSA, TLS híbrido y SSH poscuántico con OpenSSL 3.5 y OpenSSH 10

Qué es ML-KEM y por qué importa

ML-KEM es el mecanismo de encapsulación de claves poscuántico, normalizado en 2024. Navegadores, servidores y SSH ya lo usan para acordar claves de sesión. Por eso es el primer algoritmo poscuántico que encuentra casi cualquier sistema.

La lección 1 explicó qué hace un KEM. Aquí ejecutas tú sus tres pasos con OpenSSL 3.5 y mides cuánto cuesta en bytes.

Al final de esta lección

Nota

Puedo crear un par de claves ML-KEM y usarlo para compartir un secreto con OpenSSL.

Palabras clave

PalabraQué significaEjemplo
ML-KEMel KEM poscuántico normalizado, basado en retículos
Clave de encapsulaciónla clave pública que usa el emisor
Clave de desencapsulaciónla clave privada que recupera el secreto
Texto cifradolo que la encapsulación devuelve al dueño de la clave
Secreto compartidolos 32 bytes con los que acaban los dos lados
Conjunto de parámetrosun tamaño de un algoritmoML-KEM-768

Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.

Tres tamaños de ML-KEM

ML-KEM tiene tres conjuntos de parámetros: ML-KEM-512, ML-KEM-768 y ML-KEM-1024. Un número mayor significa más seguridad y más bytes. ML-KEM-768 es la opción habitual y la que llevan TLS híbrido y SSH.

Todos dan el mismo secreto de 32 bytes. Lo que crece es la clave pública y el texto cifrado, que cruzan la red en cada negociación.

Ejemplo resuelto: bytes por la red

AlgoritmoClave públicaTexto cifradoSecretoNivel de seguridad
X25519 (clásico)3232 (una segunda clave pública)32Lo rompe Shor
ML-KEM-512800768321
ML-KEM-76811841088323
ML-KEM-102415681568325

Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.

Los tres pasos en OpenSSL

genpkey crea el par de claves, y pkey -pubout saca la parte pública para darla. pkeyutl -encap toma esa clave pública y escribe un texto cifrado y un secreto. pkeyutl -decap toma la clave privada y el texto cifrado y vuelve a escribir el secreto.

Cada ejecución llega a la estación de trabajo con docker exec pq, en su carpeta /lab.

Lista los KEM que conoce OpenSSL

Comando
docker exec pq sh -c "openssl list -kem-algorithms | grep -i ml-kem"

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Crea un par de claves ML-KEM-768

Comando
docker exec pq openssl genpkey -algorithm ML-KEM-768 -out kem.pem

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Saca la clave pública

Comando
docker exec pq openssl pkey -in kem.pem -pubout -out kem.pub

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Mira las partes de la clave privada

Comando
docker exec pq sh -c "openssl pkey -in kem.pem -text -noout | grep -v '^ '"

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Encapsula: el paso del emisor

Comando
docker exec pq openssl pkeyutl -encap -inkey kem.pub -pubin -out ct.bin -secret sent.bin

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Desencapsula: el paso del dueño

Comando
docker exec pq openssl pkeyutl -decap -inkey kem.pem -in ct.bin -secret got.bin

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

¿Son iguales los dos secretos?

Comando
docker exec pq diff -qs sent.bin got.bin

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Mide el texto cifrado y los secretos

Comando
docker exec pq wc -c ct.bin sent.bin got.bin

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Mide la clave pública en DER

Comando
docker exec pq sh -c "openssl pkey -pubin -in kem.pub -outform DER | wc -c"

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Lo que imprimen las ejecuciones

EjecuciónLo que imprime
list -kem-algorithmsTres líneas, ML-KEM-512, ML-KEM-768 y ML-KEM-1024, cada una con su número y su nombre corto
pkey -textML-KEM-768 Private-Key:, y luego seed:, dk: y ek:
diff -qsFiles sent.bin and got.bin are identical
wc -c1088 ct.bin, 32 sent.bin, 32 got.bin, 1152 total
Tamaño en DER1206: la clave de 1184 bytes más una etiqueta de 22 bytes que nombra el algoritmo

Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.

Una clave equivocada da un secreto equivocado

¿Y si alguien desencapsula con la clave privada equivocada? ML-KEM no se detiene con un error. Devuelve un secreto que parece aleatorio y no coincide con nada.

Esto se llama rechazo implícito. Un mensaje de error le diría algo a un atacante, así que ML-KEM no revela nada. La diferencia aparece después, cuando los dos lados no consiguen descifrarse.

Un desconocido crea un par de claves

Comando
docker exec pq openssl genpkey -algorithm ML-KEM-768 -out stranger.pem

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

El desconocido desencapsula el texto cifrado

Comando
docker exec pq openssl pkeyutl -decap -inkey stranger.pem -in ct.bin -secret wrong.bin

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Compáralo con el secreto real

Comando
docker exec pq diff -qs sent.bin wrong.bin

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Un error frecuente

Advertencia

Mucha gente cree que desencapsular con la clave equivocada da un error. En ML-KEM funciona y no imprime nada, y luego diff dice Files sent.bin and wrong.bin differ. Así que nunca tomes una desencapsulación silenciosa como prueba de que la clave era la buena: comprueba la sesión que viene después.

Sobre este laboratorio y su código: Laboratorio de criptografía poscuántica: ML-KEM, ML-DSA, TLS híbrido y SSH poscuántico con OpenSSL 3.5 y OpenSSH 10

¿Enseñas a una clase? Asigna este módulo a tus alumnos con guía del profesor, tareas con corrección automática y un laboratorio para cada alumno.