Archivos del votante
Los dos archivos que un votante puede conservar: el recibo de voto y el archivo de clave privada. Su contenido campo por campo, qué se puede verificar con ellos y qué debe mantenerse en secreto.
Ambos se generan en su navegador y solo existen si los descarga: la plataforma no los recibe, no los almacena y nunca los envía. Los dos contienen su clave secreta.
Protocolo v1
Las mismas reglas para los dos archivos.
El recibo y el archivo de clave privada siguen las mismas convenciones; los lee y los escribe la biblioteca voter-artifacts del sitio de votación. La validez criptográfica de los valores (suma de verificación, pertenencia a la curva) corresponde a CryptoVote, no al lector del sobre.
- Un objeto JSON en UTF-8. Cada archivo es un único objeto JSON, escrito en una sola línea y sin espacios. Los ejemplos de esta página están sangrados para facilitar la lectura.
- La versión, primero. El campo version nombra el sobre y su versión. Un lector debe comprobarla y rechazar cualquier otro valor.
- Valores con prefijo, nunca hexadecimal suelto. Cada valor criptográfico es la cadena canónica <etiqueta>_<hex>_<suma de verificación> que emite CryptoVote, copiada tal cual. Un valor hexadecimal sin prefijo se rechaza.
- Una suma de verificación contra las erratas. Son 4 bytes de BLAKE3 (8 caracteres hex), con la etiqueta incluida en el cálculo: un valor mal copiado, o un pk_ pegado en lugar de un ki_, se detecta al instante. No es una garantía de seguridad: la autenticidad procede únicamente de la firma de anillo.
- Campos desconocidos, ignorados. Un lector debe ignorar los campos que no conoce, para seguir siendo compatible con una evolución del formato; no los vuelve a escribir.
Las etiquetas
-
pk_32 bytes · 64 caracteres hex - Clave pública: la que figura en el anillo.
-
sk_32 bytes · 64 caracteres hex - Clave secreta: la que firma. Nunca debe divulgarse.
-
ki_32 bytes · 64 caracteres hex - Imagen de clave (key image): el identificador público de una papeleta, propio de una elección.
-
ring_32 bytes · 64 caracteres hex - Huella del anillo: la huella canónica del conjunto de claves de un anillo, independiente de su orden.
-
blsag_32 × (1 + tamaño del anillo) bytes - Firma de anillo bLSAG: 38 464 caracteres hex para un anillo de 600 claves.
El recibo, entregado una vez aceptada la papeleta.
Su copia personal de la papeleta que ha emitido, del anillo (llamado «mesa electoral virtual» en la interfaz) con el que la firmó y de la clave que la firmó: lo necesario para encontrar y verificar usted mismo su papeleta en el registro público.
Cuándo y en manos de quién
- Solo tras la aceptación. El recibo solo aparece en la página de votación cuando el servidor ha aceptado su papeleta. Se muestra una sola vez; descargarlo es opcional.
- Generado en su navegador. La página lo compone a partir de la clave secreta que sigue en memoria desde la firma. Nunca se envía por correo electrónico (el correo de confirmación solo acredita su participación) y la plataforma nunca lo almacena.
- Imposible de volver a emitir. La plataforma ya no tiene su clave secreta, así que no puede reconstruir el recibo. En la página, los valores sensibles están ocultos tras los botones «Mostrar» y «Copiar»; «Ocultar los detalles definitivamente» los borra de la pantalla, y la clave secreta se borra sola tras un plazo fijo. Copie o descargue el recibo antes.
Para qué sirve
- Encontrar su papeleta. Introduzca ballot.key_image en la búsqueda del registro público de la elección, incluso antes de su publicación por lotes, y compare la papeleta publicada con signed_payload, byte a byte.
- Verificar su anillo. Compare ring_digest con la huella que el registro publica para el anillo indicado en ring. Si no coinciden, firmó con un anillo distinto del publicado.
- Verificar su línea de participación. voter_id designa su línea en el registro de participación: número de distribuciones de clave e indicación «ha votado».
- Volver a verificar la firma sin conexión. Bastan signed_payload, signature, el identificador de la elección y las claves públicas del anillo para volver a verificar la firma, sin la plataforma.
- Generar una prueba de voto. La herramienta «Prueba de voto» lee el recibo y toma de él la clave secreta, la elección y la imagen de clave.
-
versioncadena - Siempre condorcet-receipt/1.
-
electionUUID - El identificador de la elección, parámetro de la firma. Se acepta en mayúsculas al leerlo y siempre se reescribe en minúsculas.
-
ringcadena no vacía - El identificador (UUID) del anillo con el que se firmó la papeleta, tal como se publica en el registro.
-
ring_digestring_… - La huella de ese anillo, calculada por su navegador a partir de las claves que recibió. El servidor nunca la proporciona: un valor enviado junto con el anillo podría ajustarse a él.
-
voter_idUUID - Su ID de votante, el único identificador publicado que le concierne.
-
public_keypk_… - Su clave pública, miembro del anillo ring.
-
secret_keysk_… - Su clave secreta, la que firmó la papeleta.
-
ballot.signed_payloadcadena (JSON) - El payload firmado, byte a byte: la misma cadena que se firmó y se envió al servidor. Debe tratarse como una cadena opaca; analizarla y volver a codificarla rompería la comparación con el registro.
-
ballot.signatureblsag_… - La firma de anillo de la papeleta.
-
ballot.key_imageki_… - La imagen de clave de la papeleta, propia de esta elección: el identificador público de su papeleta en el registro.
{
"version": "condorcet-receipt/1",
"election": "0c2e7e2a-5df3-4c0e-9d2b-3f6a8f0c9e21",
"ring": "7b1d4f90-2c3a-4e8b-a6d5-91f0e2c47a38",
"ring_digest": "ring_ffeeddccbbaa99887766554433221100ffeeddccbbaa99887766554433221100_8b7a6f5e",
"voter_id": "3e9a5c71-8d24-4b6f-b0e3-5a7c19d2f846",
"public_key": "pk_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef_a1b2c3d4",
"secret_key": "sk_fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210_d4c3b2a1",
"ballot": {
"signed_payload": "{\"v\":1,\"election\":\"0c2e7e2a-5df3-4c0e-9d2b-3f6a8f0c9e21\",\"ballot\":\"Alice > Bob = Chloé\",\"weight\":1}",
"signature": "blsag_0a1b2c3d4e5f6a7b0a1b2c3d4e5f6a7b0a1b2c3d4e5f6a7b0a1b2c3d4e5f6a7b0a1b2c3d4e5f6a7b0a1b2c3d4e5f6a7b0a1b2c3d4e5f6a7b0a1b2c3d4e5f6a7b_e5f6a7b8",
"key_image": "ki_00112233445566778899aabbccddeeff00112233445566778899aabbccddeeff_5e6f7a8b"
}
}
Valores ficticios: sumas de verificación no válidas y firma reducida a su longitud mínima. El archivo que se descarga se llama recu-vote- seguido de los 8 primeros caracteres del identificador de la elección.
El archivo de clave privada, descargado al depositar la clave.
Cuando deposita usted mismo su clave, el par de claves se genera en su navegador. Este archivo es su copia de seguridad: con él podrá votar.
Cuándo y en manos de quién
- Al depositar una clave generada. Durante el periodo de depósito de claves de una elección, o de un grupo de elecciones, si decide generar una clave. CryptoVote produce el par en su navegador.
- Solo sale la clave pública. public_key se envía a la plataforma, que la colocará en un anillo. La clave secreta se muestra una sola vez, con opción de copiarla, y el archivo se genera en su navegador.
- Sin elección ni grupo. El archivo solo contiene el par de claves: una misma clave puede servir para varias elecciones independientes, porque la imagen de clave se vuelve propia de cada elección en el momento de la firma. Su nombre procede de la propia clave: condorcet-vote- seguido de la suma de verificación de public_key.
Para qué sirve
- Votar. En la página de votación, pegue la clave sk_… o cargue el archivo: la página deriva de ella la clave pública y comprueba que figura en el anillo que se le ha asignado.
- Depositar la misma clave en otro lugar. En otro depósito, cargue el archivo: la clave pública se extrae en el navegador y la clave secreta no sale de su dispositivo.
- Encontrar su papeleta, demostrar su voto. Con la clave secreta y el identificador de una elección, la herramienta «Prueba de voto» recalcula su imagen de clave, incluso sin recibo.
-
versioncadena - Siempre condorcet-private-key/1.
-
public_keypk_… - La clave pública, la que se transmitió a la plataforma al depositarla.
-
secret_keysk_… - La clave secreta, generada en su navegador y nunca transmitida.
{
"version": "condorcet-private-key/1",
"public_key": "pk_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef_a1b2c3d4",
"secret_key": "sk_fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210_d4c3b2a1"
}
Valores ficticios, sumas de verificación no válidas. Ningún campo election ni de grupo: un archivo antiguo con un campo election informativo sigue siendo legible, porque ese campo se ignora.
Lo que debe mantenerse en secreto, y por qué.
Los dos archivos contienen su clave secreta. Guárdelos como una contraseña: fuera del alcance de los demás, pero sin perderlos.
Los riesgos, sin rodeos
- La clave secreta revela su voto. Con ella se puede recalcular su imagen de clave para cualquier elección y, por tanto, encontrar sus papeletas publicadas, de forma retroactiva, en todas las elecciones en las que se haya usado, así como generar en su nombre una prueba de voto.
- La clave secreta firma. Produce una firma válida en cualquier anillo que contenga su clave pública. La plataforma solo acepta una papeleta a través de su enlace de voto, y solo una por votante.
- El recibo revela su voto a quien lo lea. Pone su ID de votante junto a su papeleta. Sirve como prueba, por diseño: el protocolo da prioridad a la verificabilidad individual y, por eso, no ofrece resistencia a la coacción. Enséñelo solo a las personas a las que quiera revelar su voto.
- Una clave perdida es un voto perdido. Una clave depositada no tiene ninguna clave de reserva en el servidor: una vez abierta la elección, perderla equivale a no votar. Mientras el periodo de depósito de claves siga abierto, puede depositar una nueva clave en su lugar para las elecciones cuyos anillos aún no estén constituidos.
- Un recibo perdido no se vuelve a emitir. Su papeleta sigue contando. Si ha conservado su clave secreta, le basta para recalcular su imagen de clave y encontrar su papeleta.
Lo que la plataforma nunca ve
- Sus archivos. El recibo y el archivo de clave privada se escriben y se descargan en su navegador; nunca pasan por nuestros servidores.
- Una clave secreta que usted ha generado. Se genera en su navegador y nunca se transmite. Al cargar un archivo de clave en un depósito, solo se envía su clave pública.
- Una clave distribuida, después de su voto. En el modo por defecto, la plataforma genera la clave y la conserva cifrada; la borra de su base de datos en el momento de entregársela y, después, de su caché temporal en el momento del voto. Por eso ya no puede reconstruir su recibo.
- El vínculo entre su clave y su papeleta. Su clave pública figura en el anillo publicado y su papeleta, en el registro público; solo con la clave secreta se pueden relacionar.
Véase también
- Papeleta firmada La papeleta tal como la firma el votante: payload, firma de anillo, imagen de clave y huella del anillo.
- Registro público Lo que publica cada elección, con independencia del medio que lo transporte: definición, anillos, registro de participación y papeletas.
- Prueba de voto El sobre cvproof/1: demostrar, por iniciativa propia, que una papeleta publicada es suya, lo que revela su voto.