Introducción a la criptografía

Esta introducción explica las ideas criptográficas detrás de X Chat a nivel conceptual. No necesitas esta profundidad para construir—el Chat XDK realiza el cifrado, descifrado, firma y almacenamiento de claves por ti—pero el modelo mental ayuda cuando diseñas tu app o depuras su comportamiento. Cuando estés listo para implementarlo, usa Primeros pasos para un recorrido completo y la referencia de la API en la barra lateral para las rutas individuales.

---

​

El panorama general

X Chat usa un sistema de cifrado por capas donde:

1. Los mensajes se cifran con una clave de conversación (cifrado simétrico rápido)
2. Las claves de conversación se cifran para cada participante usando su clave pública de identidad (intercambio de claves asimétrico)
3. Los mensajes se firman con la clave de firma para que los destinatarios puedan verificar quién los envió y que nada fue alterado

El cifrado simétrico es eficiente para grandes volúmenes de tráfico de mensajes; el cifrado asimétrico se usa principalmente para distribuir claves de conversación de manera segura. En el flujo del producto, X transporta texto cifrado y sobres de clave—no contenido legible del mensaje ni la clave de conversación en bruto. Tu app usa el Chat XDK para la criptografía y la Chat API (a través del XDK en Python/TypeScript, o HTTPS) para registrar claves y enviar o recibir esos payloads cifrados. Consulta Primeros pasos para ver cómo encajan estas piezas.

---

​

Tipos de claves explicados

X Chat usa tres tipos de material de clave, cada uno con un propósito específico.

​

1. Par de claves de identidad

Propósito: Intercambiar de manera segura claves de conversación entre usuarios Cuando alguien te añade a una conversación, cifra la clave de conversación usando tu clave pública de identidad. Solo tu clave privada de identidad puede descifrarla. Las mitades públicas se registran y se descubren a través de las APIs de public-key de la plataforma (consulta Claves de cifrado en la referencia de la API). Las mitades privadas permanecen en el Chat XDK (por ejemplo, mediante copia de seguridad segura de claves o un blob de claves cuidadosamente protegido).

​

2. Par de claves de firma

Propósito: Demostrar que fuiste el autor de un mensaje Cuando envías un mensaje, se firma con tu clave privada de firma. Los destinatarios lo verifican usando tu clave pública de firma (también publicada a través de las APIs de public-key). El Chat XDK firma como parte del cifrado de un mensaje y puede verificar al descifrar cuando proporcionas el material de clave pública del remitente.

​

3. Clave de conversación

Propósito: Cifrar y descifrar mensajes (y contenido multimedia) dentro de una conversación específica Las claves de conversación se generan cuando se configura una conversación o cuando las claves rotan. Cada participante recibe una copia cifrada de la clave, generada con su clave pública de identidad. Después de descifrar tu copia una vez, guardas la clave de conversación en bruto y la usas para el cifrado rápido de mensajes (y contenido multimedia). La configuración de esas copias para una conversación se realiza mediante el Chat XDK junto con los endpoints de key de conversación—se recorre en Primeros pasos.

---

​

Cómo funciona el cifrado (conceptualmente)

​

Enviar un mensaje

​

Recibir un mensaje

La implementación de cifrar, enviar, recibir y descifrar está en Primeros pasos y en la referencia del Chat XDK.

---

​

Distribución de claves explicada

Un desafío central en el cifrado de extremo a extremo es la distribución de claves: cómo los participantes obtienen la clave de conversación sin que X (o un observador) vea esa clave en claro.

​

Configuración inicial de la clave

Cuando se prepara una conversación para mensajería:

1. El Chat XDK genera una clave de conversación aleatoria
2. El Chat XDK cifra esa clave para la clave pública de identidad de cada participante
3. Tu app publica esas copias cifradas a través de las Chat APIs de X
4. Cada participante descifra su copia con su clave privada de identidad (en el Chat XDK)

X solo maneja las copias envueltas, nunca la clave de conversación en bruto.

​

Eventos de cambio de clave

Cuando la clave de conversación rota (por ejemplo cuando cambia la membresía), los participantes reciben un evento de cambio de clave con nuevas copias cifradas para cada miembro. Tu app debe:

1. Detectar material de cambio de clave en eventos en vivo o en el historial de la conversación
2. Descifrar y almacenar la nueva clave de conversación (y versión)
3. Usar la versión más reciente para los envíos posteriores

Primeros pasos y Eventos en tiempo real describen dónde aparecen esos eventos en la práctica.

---

​

Copia de seguridad segura de claves: almacenamiento distribuido de claves

Tus claves privadas de identidad y de firma deben almacenarse con cuidado. X Chat incluye un sistema de copia de seguridad segura de claves para que las claves puedan recuperarse con un código de acceso en distintos dispositivos sin darle a un solo servidor el secreto completo.

​

El problema con el almacenamiento tradicional de claves

​

Cómo lo resuelve la copia de seguridad segura de claves

La copia de seguridad segura de claves combina compartición de secretos con protección por código de acceso:

1. Las claves privadas se dividen en shares
2. Los shares los guardan realms independientes (servidores separados)
3. Ningún realm tiene por sí solo información suficiente para reconstruir las claves
4. La recuperación requiere tu código de acceso y la cooperación de suficientes realms
5. Los códigos de acceso incorrectos están limitados por tasa para ralentizar las conjeturas

Obtienes capacidad de recuperación (nuevo dispositivo + código de acceso) sin que una sola parte guarde todo el secreto.

---

​

Firmas explicadas

Cada mensaje de X Chat incluye una firma digital que aporta:

1. Autenticidad — se produjo con la clave privada de firma del remitente
2. Integridad — el contenido cifrado no se modificó después de firmarse

​

Cómo funcionan las firmas (conceptualmente)

Si algo en el material firmado cambia, la verificación falla. Solo alguien con la clave privada de firma puede producir una firma válida para esa clave.

​

En tu app

El Chat XDK firma cuando cifras mensajes salientes y verifica cuando descifras los entrantes contra el material de clave pública del remitente (obtenido de las APIs de public-key). La verificación es obligatoria por defecto: el SDK rechaza eventos firmados no verificados a menos que desactives explícitamente la comprobación (no recomendado). Los detalles están en la referencia del Chat XDK. Las firmas también cubren el contenido citado. Una respuesta incrusta el mensaje original firmado en bruto que cita; cuando el Chat XDK descifra la respuesta, verifica ese original incrustado y compara la cita contra él, reportando el resultado como reply_preview_validation (Valid / Invalid). Un resultado Invalid significa que la cita no coincide con el original firmado—trata el material citado como no confiable, aunque la respuesta en sí se verifique por separado—de modo que ningún participante pueda atribuir palabras inventadas a otro.

​

Cambios de estado firmados (firmas de acción)

Los mensajes no son el único material firmado. Cada llamada que cambia el estado de una conversación—añadir o rotar claves de conversación, crear un grupo, añadir miembros—debe llevar una o más firmas de acción: el remitente firma un payload que describe exactamente lo que hace el cambio (para un cambio de clave, ese payload incluye la nueva clave de conversación en sí), y la API rechaza la solicitud si las firmas faltan o están mal formadas. Como el servidor nunca posee la clave de conversación en texto plano, no puede comprobar criptográficamente la firma de un cambio de clave; valida que la descripción firmada y codificada del cambio coincida con la solicitud que recibió. La comprobación criptográfica ocurre en los extremos: el Chat XDK de cada destinatario verifica la firma contra la clave pública de firma del remitente cuando descifra el evento de cambio de clave. Los métodos prepare del Chat XDK producen estas firmas por ti—las creaciones de grupo y las adiciones de miembros devuelven dos (el cambio de clave más la acción del grupo), y ambas deben enviarse. Las firmas están vinculadas al contenido del evento y son inmutables: un evento cuya firma no se verifica nunca podrá volverse válido más tarde. Consulta Solución de problemas para saber cómo tratarlos.

---

​

Propiedades de seguridad

​

Contra qué protege X Chat

​

Contra qué no protege X Chat

---

​

Glosario

---

​

Próximos pasos