Ir al contenido
Condorcet.vote Alpha
← Documentación técnica

Plataforma de confianza

El funcionamiento interno de la plataforma: lo que hace durante la votación, las reglas que se impone y lo que después cualquiera puede comprobar en el registro.

Esta página presenta los principios de esas reglas, como hace el libro blanco: base de datos, ventana de firma, transporte, publicación, gestión de secretos y alojamiento. No sustituyen a la verificación: cada afirmación de la plataforma se publica en el registro y puede comprobarse sin ella.

Protocolo v1

Modelo de confianza

De confianza durante la votación, verificable después.

La plataforma es un tercero de confianza, y esa confianza está acotada en el tiempo. Esta exposición es una decisión de diseño deliberada y documentada, no un descuido.

  • Durante la votación

    Lo que se le confía

    Sirve la página de votación, entrega las claves secretas en el modo de aprovisionamiento por defecto y recibe cada papeleta firmada a través de la sesión VoteLink del votante. Durante esa ventana sabe, de forma transitoria, quién vota y, en el modo por defecto, qué clave entregó a quién.

  • Después

    Lo que se comprueba sin ella

    Cada una de sus afirmaciones queda reflejada en el registro público y puede verificarse de forma independiente. Las dos caras del registro, participación y papeletas, se publican de modo que no puedan cruzarse para vincular a un votante con su papeleta.

El nivel de confianza se ajusta en cada elección: en el modo BYO-only, en el que cada votante aporta su propia clave, la plataforma nunca tiene el secreto de firma de ningún votante, y la ventana de confianza se reduce a la mera recepción de las papeletas.

Lo que implica ser «tercero de confianza», y lo que no implica, está escrito en la carta. No es una acreditación, ni una certificación expedida por una autoridad, ni un sello.

La carta del tercero de confianza
Base de datos

PostgreSQL, árbitro único.

Cada invariante visible para los usuarios se impone en PostgreSQL mediante escrituras condicionales protegidas y restricciones de unicidad, nunca mediante el estado en memoria de un proceso: correcto por construcción, sea cual sea el número de workers e instancias, sin orden de bloqueos ni interbloqueos.

Las reglas escritas en el esquema

ballots (election_id, key_image) unicidad
Una imagen de clave (key image) solo vota una vez por elección. Es una red de seguridad que resiste incluso a un error de la aplicación.
ring_keys (election_id, public_key) unicidad
Una clave pública solo aparece una vez entre los miembros de anillo de la elección.
chain_blocks (election_id, block_number) unicidad
La protección definitiva contra las bifurcaciones: un escritor concurrente que pierde falla y vuelve a intentarlo sobre la nueva cabeza de la cadena.
ballots solo añadidos · disparador
Todo UPDATE o DELETE lanza una excepción. Única excepción codificada: el indicador is_chain_published, que pasa de false a true en la transacción que confirma un bloque.
chain_blocks solo añadidos · disparador
La misma regla para los anclajes de la cadena; única excepción: el estado de OpenTimestamps, en un solo sentido, pending → completed.
ballots.payload bytea
Los bytes firmados, almacenados tal cual. Nunca en un tipo JSON que normalice: jsonb reordena las claves y reescribe los espacios, lo que rompería la verificación exacta byte a byte.
ballots.id UUID v4, sin sello de tiempo
Un identificador aleatorio y ninguna fecha de creación: nada delata el orden de emisión.
Lo que publica el registro

Escrituras sin condiciones de carrera

  • Escrituras protegidas. El cambio de has_voted, el tope de distribución de claves y la reclamación de una clave son UPDATE condicionales: cero filas modificadas equivale a un rechazo. Nunca una lectura-modificación-escritura en memoria.
  • La criptografía, fuera de los bloqueos. La verificación de la firma, puro cálculo sobre datos públicos, se ejecuta antes de la transacción de escritura: la criptografía nunca retiene un bloqueo.
  • Una elección abierta, reafirmada. Al emitir una papeleta, el estado abierto de la elección se reafirma dentro de la transacción, serializada frente al cierre: o la papeleta se confirma antes del cierre y este la publica, o se rechaza. Nunca queda almacenada una papeleta que la cadena dejaría fuera.
  • Bloques serializados. Los bloques se producen mediante tareas en cola, serializadas por elección; la fila confirmada en la base de datos es el árbitro de cada bloque.
Datos y cronología

Guardar solo lo necesario, no fechar nada.

La plataforma no almacena nada que el protocolo no necesite ni publica nada que feche o identifique una papeleta. La hora de los votos se trata como un canal lateral y se elimina de principio a fin.

Minimización

  • Los datos del votante. Su correo electrónico y, opcionalmente, su nombre y su peso: no se pide nada más al organizador.
  • Secretos cifrados y después borrados. Las claves secretas de voto se cifran en reposo y se eliminan en el momento de usarse. Una vez entregada, la clave deja de existir en la base de datos: solo sobrevive, cifrada, en una caché de 180 minutos como máximo para poder entregarla de nuevo, y se borra de ella al votar.
  • Memoria puesta a cero. Los secretos transitorios se ponen a cero de forma explícita, tanto en PHP (objetos de valor basados en sodium_memzero) como en Rust/WASM (búferes puestos a cero).
  • Ningún rastreador. Ni analítica ni seguimiento en las páginas de votación: solo quedan los logs del servidor.

Higiene cronológica

  • Papeletas sin sello de tiempo. Ni en la base de datos ni en el registro; identificadores UUID v4 aleatorios en toda la superficie pública.
  • Publicación por lotes. Las papeletas salen en lotes de al menos 600, según un calendario aleatorio y ordenadas por imagen de clave; el registro de participación se publica una sola vez, al cierre.
  • Limpieza física. PostgreSQL marca cada fila con la transacción que la escribió: durante un tiempo, una papeleta y su anotación en el registro de participación comparten la misma marca, invisible en una exportación lógica pero legible con acceso directo a la base de datos. Una tarea que se ejecuta dos veces al día reescribe esas filas en una única transacción neutra y después ejecuta un VACUUM: una marca reciente sobrevive como máximo un ciclo de limpieza.
Ventana de firma y transporte

Proteger el momento en que la clave está en memoria.

La clave secreta del votante solo vive en su navegador mientras dura la página de votación. Es el momento más expuesto del lado del cliente, y el que la plataforma protege con más rigor.

La página de votación

  • Autónoma. Una página sin framework, fuera de la aplicación del organizador. Cualquier navegación fuera de la votación es una recarga completa, que borra la clave de la memoria.
  • La CSP más estricta. Solo recursos propios, ningún script de terceros, ninguna analítica; ejecución de WASM permitida y envío de formularios desactivado en favor de un envío exclusivamente por fetch.
  • La integridad del código que firma. Los recursos compilados llevan hashes de integridad de subrecursos (SHA-384): un nodo de CDN comprometido no puede alterar en silencio el código que firma.
  • Su propio subdominio. La votación se aloja en voting.condorcet.vote, con cookies limitadas al host: su estado de sesión está aislado del resto del sitio.

Transporte, enlaces y sesiones

  • TLS hasta la aplicación. Del cifrado TLS se encarga el propio servidor web de la aplicación, Caddy (escrito en Go, a través de FrankenPHP), sin proxy intermedio. Sus certificados Let's Encrypt se emiten y se renuevan automáticamente, todo acceso HTTP se redirige a HTTPS y sus ajustes TLS modernos se aplican por defecto: TLS 1.3 preferentemente, 1.2 como mínimo.
  • Ningún log de acceso en la votación. El subdominio de votación nunca guarda logs de acceso: sus direcciones llevan el token del VoteLink, y unos logs con fecha y hora recrearían la cronología de los votos que la base de datos se niega a conservar.
  • Directamente al origen, sobre TLS. Los anillos (llamados «mesas electorales virtuales» en la interfaz), la distribución de las claves y la emisión de las papeletas viajan directamente entre el navegador y la plataforma. Ninguna CDN se interpone en los datos de votación; solo los recursos estáticos compilados se guardan en la caché perimetral.
  • Un enlace de capacidad, sin cuenta. El votante no crea cuenta ni contraseña: su VoteLink, que la plataforma le envía por correo electrónico, es una capacidad al portador. Solo se almacena el hash del token; el enlace está vinculado a un único votante y sujeto a un límite de frecuencia, y su sesión tiene un alcance restringido.
  • Sesiones del lado del servidor. Las sesiones se guardan en Valkey (Redis). En el navegador, solo el estado estrictamente necesario: sesión, idioma y tema.
  • El resto del sitio. Todo, scripts y WASM incluidos, se sirve desde el propio dominio, con una CSP estricta; ningún origen de terceros en las páginas públicas.
  • Los organizadores. Inicio de sesión con contraseña o llave de acceso, segundo factor TOTP opcional e intentos limitados por identificador y por dirección IP.
Publicación y firma

Lo que la aplicación no puede reescribir.

Un bloque es válido si y solo si el hash de sus bytes coincide con el hash confirmado y su firma se verifica, se lea desde donde se lea. El almacenamiento añade sus propias barreras.

Aislamiento de la publicación

  • Un almacenamiento aparte. Los archivos de la cadena se guardan en su propio bucket de almacenamiento de objetos, con sus propias credenciales de acceso, separados de cualquier otro contenido almacenado y servidos desde su propio nombre de host de CDN: un fallo en una ruta de subida nunca puede escribir en la cadena.
  • Una sola escritura. El bucket activa el bloqueo de objetos del proveedor: una vez escrito, un archivo de bloque no se puede sobrescribir ni eliminar, ni siquiera con las credenciales de almacenamiento de la plataforma. Complementa los disparadores de la base de datos y la cadena de hashes.
  • Bytes en bruto. Los bloques se sirven tal cual; ninguna capa del framework puede reformatearlos. Como el contenido es determinista, repetir una escritura es idempotente.

La clave de firma

  • Una herramienta fijada. Cada bloque se firma en OpenPGP v6 (RFC 9580, Ed25519) con una versión fijada e integrada de Sequoia sq, en tareas en segundo plano; ningún cálculo de firma en PHP.
  • Claves privadas fuera de la base de datos. Los certificados públicos están en la base de datos; las claves privadas nunca entran en ella. Se conservan en el gestor de secretos de OVHcloud (OKMS), con los estándares de seguridad más exigentes: cifradas en reposo, un dominio aislado por entorno y acceso mediante certificado de cliente en TLS mutuo. OKMS solo las custodia: la firma sigue siendo local, lee una versión fija de la clave y comprueba su huella digital.
  • Una rotación que acota los daños. En cada rotación, la clave saliente recibe una fecha de caducidad en ese mismo instante y sus versiones se desactivan: una clave retirada sigue sirviendo para verificar, pero ya no firma.
  • Lo que la firma no demuestra. Demuestra que la plataforma ha producido un bloque, no que no haya reescrito la historia, puesto que tiene la clave. La inmutabilidad procede de las réplicas independientes, y el anclaje OpenTimestamps de cada bloque demuestra cuándo existían sus bytes.
Alojamiento e ingeniería

Dónde funciona y cómo está construida.

Aquí no se describe la explotación en su conjunto, solo los puntos que aportan una garantía.

Alojamiento

  • En Francia. La plataforma está alojada en Francia y todo se sirve desde su propio dominio: ningún servicio de terceros se carga en el navegador de los votantes.
  • Una pila reducida. PostgreSQL para los datos; Valkey para las sesiones, las colas y la caché, nunca como almacenamiento principal. Colas de tareas aisladas, para que una ráfaga en una de ellas nunca deje a las demás sin workers.
  • Secretos fuera de la configuración. En los entornos remotos, ninguna credencial figura en los archivos de entorno: todas las custodia OKMS, el gestor de secretos de OVHcloud, con un dominio aislado por entorno.

Disciplina de ingeniería

  • Criptografía real en las pruebas. La batería de pruebas usa el módulo WASM real, nunca un simulacro, tanto en el servidor como en el navegador, hasta recorridos de votación completos automatizados en el navegador.
  • Vectores fijados. El núcleo criptográfico fija vectores de protocolo: cualquier cambio silencioso en una cadena de dominio, un formato o una disposición de bytes hace fallar la compilación. También ejecuta barridos de maleabilidad bit a bit y objetivos de fuzzing sobre todos sus analizadores, y audita sus dependencias en la CI.
  • Especificaciones sincronizadas. Las especificaciones se versionan junto con el código y, por convención explícita, se mantienen al día con él; el libro blanco y estas páginas son su forma publicada.
Límites

Lo que sigue siendo cuestión de confianza.

Estos límites están documentados, no ocultos. Afectan sobre todo a la ventana de la votación; después, el registro acota lo que una plataforma podría hacer sin que se viera.

Lo que hay que confiarle

  • Una plataforma malintencionada durante la votación. En el modo de clave generada por el servidor, podría precalcular la imagen de clave de cada clave que ha entregado y desanonimizar las papeletas. Las claves importadas o depositadas por el votante le quitan ese poder; las elecciones BYO-only eliminan cualquier secreto en poder del servidor.
  • Una participación inventada. Podría hacer constar que ha votado alguien que no lo ha hecho y añadir una papeleta dentro de los límites publicados; solo el afectado puede detectarlo, comprobando su propia línea del registro de participación.
  • El navegador durante la firma. Una inyección de script durante la ventana de firma sigue siendo el riesgo residual del lado del cliente: la CSP lo reduce al mínimo, pero no puede eliminarlo.
  • Los datos de contacto en reposo. Los nombres y correos electrónicos de los votantes se guardan en claro, porque los VoteLink se envían por correo y el organizador necesita una lista legible: si la base de datos se viera comprometida, quedarían expuestos. Las claves secretas de voto, en cambio, siempre están cifradas.
  • El almacenamiento físico. Los segmentos WAL archivados, las copias de seguridad y los logs de acceso web siguen siendo una cuestión de infraestructura y de plazos de conservación.
  • Una revisión externa pendiente. Está prevista una revisión independiente del protocolo y de su implementación; su informe se enlazará desde la página Seguridad.

Lo que acota esa confianza

  • El registro. Firmas de anillo válidas, ninguna clave que haya firmado dos veces, no más papeletas que electores inscritos: todo se comprueba con el registro publicado y nada más.
  • El recuento. El resultado se recalcula a partir del registro, con un software distinto del de la plataforma.
  • La cadena y sus réplicas. Archivos en bruto, firmados y encadenados, que cualquiera puede conservar: una reescritura salta a la vista de cualquier testigo que haya guardado una cabeza de cadena anterior.
  • El código que cuenta. El núcleo criptográfico (CryptoVote) y la biblioteca de escrutinio (CondorcetPHP) son de código abierto: cualquiera puede inspeccionar el código que firma, verifica y escruta.
  • Compromisos por escrito. La carta establece lo que la plataforma se compromete a hacer, y a no hacer: un registro publicado nunca se retira ni se modifica a petición del organizador.

Elija qué mide Condorcet.Vote en sus páginas públicas. Su elección se guarda en este dispositivo y puede cambiarla en cualquier momento.

Imprescindibles Siempre activos

Idioma, tema y conservación de estas opciones.