Ficheiros do eleitor
Os dois ficheiros que um eleitor pode guardar: o recibo de voto e o ficheiro de chave privada. O que contêm, campo a campo, o que se pode verificar com eles e o que tem de ficar secreto.
Ambos são construídos no seu navegador e só existem se os descarregar: a plataforma não os recebe, não os guarda e nunca os envia. Ambos contêm a sua chave secreta.
Protocolo v1
As mesmas regras para os dois ficheiros.
O recibo e o ficheiro de chave privada seguem as mesmas convenções, lidas e escritas pela biblioteca voter-artifacts do site de voto. A validade criptográfica dos valores (soma de verificação, pertença à curva) cabe ao CryptoVote, não ao leitor do envelope.
- Um objeto JSON UTF-8. Cada ficheiro é um único objeto JSON, escrito numa só linha, sem espaços. Os exemplos desta página estão indentados para facilitar a leitura.
- A versão primeiro. O campo version identifica o envelope e a sua versão. Um leitor tem de a verificar e recusar qualquer outro valor.
- Valores com prefixo, nunca hex simples. Cada valor criptográfico é a cadeia canónica <etiqueta>_<hex>_<soma de verificação> emitida pelo CryptoVote, copiada tal e qual. Um valor hex sem prefixo é recusado.
- Uma soma de verificação contra gralhas. 4 bytes de BLAKE3 (8 caracteres hex), com a etiqueta incluída no cálculo: um valor mal copiado, ou um pk_ colado no lugar de um ki_, é detetado de imediato. Não é uma garantia de segurança: a autenticidade vem apenas da assinatura em anel.
- Campos desconhecidos ignorados. Um leitor tem de ignorar os campos que não conhece, para se manter compatível com uma evolução do formato; não os volta a escrever.
As etiquetas
-
pk_32 bytes · 64 caracteres hex - Chave pública: a que figura no anel.
-
sk_32 bytes · 64 caracteres hex - Chave secreta: a que assina. Nunca pode ser divulgada.
-
ki_32 bytes · 64 caracteres hex - Imagem de chave: o identificador público de um boletim, próprio de uma eleição.
-
ring_32 bytes · 64 caracteres hex - Resumo do anel: o resumo canónico do conjunto das chaves de um anel, independente da sua ordem.
-
blsag_32 × (1 + tamanho do anel) bytes - Assinatura em anel bLSAG: 38 464 caracteres hex para um anel de 600 chaves.
O recibo, emitido depois de o boletim ser aceite.
A sua cópia pessoal do boletim que enviou, do anel em que o assinou (chamado «mesa de voto virtual» na interface) e da chave usada na assinatura: o necessário para encontrar e verificar por si próprio o seu boletim no registo público.
Quando, e nas mãos de quem
- Só depois de aceite. O recibo só aparece na página de voto depois de o servidor aceitar o seu boletim. É mostrado uma única vez; descarregá-lo é facultativo.
- Construído no seu navegador. A página compõe-no a partir da chave secreta que ficou em memória desde a assinatura. Nunca é enviado por e-mail (o e-mail de confirmação apenas atesta a sua participação) nem guardado pela plataforma.
- Impossível de emitir de novo. A plataforma já não detém a sua chave secreta, por isso não consegue reconstruir o recibo. Na página, os valores sensíveis ficam ocultos atrás dos botões «Mostrar» e «Copiar»; «Ocultar os detalhes» apaga-os do ecrã de vez, e a chave secreta apaga-se sozinha ao fim de um tempo fixo. Copie ou descarregue o recibo antes disso.
Para que serve
- Encontrar o seu boletim. Introduza ballot.key_image na pesquisa do registo público da eleição, mesmo antes da publicação por lote, e compare depois o boletim publicado com signed_payload, byte a byte.
- Verificar o seu anel. Compare ring_digest com o resumo que o registo publica para o anel indicado em ring. Uma diferença significa que assinou com um anel diferente do publicado.
- Verificar a sua linha de participação. voter_id designa a sua linha no registo de participação: número de distribuições da chave, indicação «votou».
- Voltar a verificar a assinatura offline. signed_payload, signature, o identificador da eleição e as chaves públicas do anel bastam para voltar a verificar a assinatura, sem a plataforma.
- Produzir uma prova de voto. A ferramenta «Prova de voto» lê o recibo e extrai dele a chave secreta, a eleição e a imagem de chave.
-
versionstring - Sempre condorcet-receipt/1.
-
electionUUID - O identificador da eleição, parâmetro da assinatura. É aceite em maiúsculas na leitura e sempre reescrito em minúsculas.
-
ringstring não vazia - O identificador (UUID) do anel com que o boletim foi assinado, tal como publicado no registo.
-
ring_digestring_… - O resumo desse anel, calculado pelo seu navegador a partir das chaves que recebeu. O servidor nunca o fornece: um valor enviado com o anel poderia ser ajustado juntamente com ele.
-
voter_idUUID - O seu ID de eleitor, o único identificador publicado que lhe diz respeito.
-
public_keypk_… - A sua chave pública, membro do anel ring.
-
secret_keysk_… - A sua chave secreta, a que assinou o boletim.
-
ballot.signed_payloadstring (JSON) - O payload assinado, byte a byte: a própria cadeia que foi assinada e enviada ao servidor. Deve ser tratado como uma cadeia opaca; analisá-lo e voltar a codificá-lo estragaria a comparação com o registo.
-
ballot.signatureblsag_… - A assinatura em anel do boletim.
-
ballot.key_imageki_… - A imagem de chave do boletim, própria desta eleição: o identificador público do seu boletim no registo.
{
"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 fictícios: somas de verificação inválidas, assinatura reduzida ao comprimento mínimo. O ficheiro descarregado chama-se recu-vote- seguido dos 8 primeiros caracteres do identificador da eleição.
O ficheiro de chave privada, descarregado ao depositar a chave.
Quando deposita a sua própria chave, o par de chaves é gerado no seu navegador. Este ficheiro é a cópia de segurança desse par: é com ele que vai votar.
Quando, e nas mãos de quem
- Ao depositar uma chave gerada. Durante o período de depósito das chaves de uma eleição, ou de um grupo de eleições, se optar por gerar uma chave. O CryptoVote produz o par no seu navegador.
- Só sai a chave pública. public_key é enviada à plataforma, que a colocará num anel. A chave secreta é mostrada uma única vez, pode ser copiada, e o ficheiro é construído no seu navegador.
- Sem eleição nem grupo. O ficheiro só contém o par de chaves: a mesma chave pode servir para várias eleições independentes, porque a imagem de chave se torna própria de cada eleição no momento da assinatura. O nome do ficheiro vem da própria chave: condorcet-vote- seguido da soma de verificação de public_key.
Para que serve
- Votar. Na página de voto, cole a chave sk_… ou carregue o ficheiro: a página deriva dela a chave pública e verifica que esta figura no anel que lhe foi atribuído.
- Depositar a mesma chave noutro sítio. Noutro depósito, carregue o ficheiro: a chave pública é extraída no navegador e a chave secreta não sai do seu dispositivo.
- Encontrar o seu boletim, provar o seu voto. Com a chave secreta e o identificador de uma eleição, a ferramenta «Prova de voto» recalcula a sua imagem de chave, mesmo sem recibo.
-
versionstring - Sempre condorcet-private-key/1.
-
public_keypk_… - A chave pública, a que foi transmitida à plataforma no depósito.
-
secret_keysk_… - A chave secreta, gerada no seu navegador e nunca transmitida.
{
"version": "condorcet-private-key/1",
"public_key": "pk_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef_a1b2c3d4",
"secret_key": "sk_fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210_d4c3b2a1"
}
Valores fictícios, somas de verificação inválidas. Não há campo election nem campo de grupo: um ficheiro antigo com um campo election informativo continua legível, mas esse campo é ignorado.
O que tem de ficar secreto, e porquê.
Os dois ficheiros contêm a sua chave secreta. Guarde-os como uma palavra-passe: fora do alcance de outras pessoas, mas sem os perder.
Os riscos, sem rodeios
- A chave secreta revela o seu voto. Com ela, pode recalcular-se a sua imagem de chave para qualquer eleição e, portanto, encontrar retroativamente os seus boletins publicados em todas as eleições em que foi usada, e produzir em seu nome uma prova de voto.
- A chave secreta assina. Produz uma assinatura válida em qualquer anel que contenha a sua chave pública. A plataforma só aceita um boletim através do seu link de voto, e apenas um por eleitor.
- O recibo revela o seu voto a quem o ler. Põe lado a lado o seu ID de eleitor e o seu boletim. Por conceção, serve de prova: o protocolo privilegia a verificabilidade individual e, por isso, não oferece resistência à coação. Mostre-o apenas a quem decidir revelar o seu voto.
- Chave perdida, voto perdido. Uma chave depositada não tem cópia de recurso do lado do servidor: depois de a eleição abrir, perdê-la equivale a não votar. Enquanto o período de depósito das chaves estiver aberto, pode depositar uma nova chave em substituição, para as eleições cujos anéis ainda não foram constituídos.
- Um recibo perdido não é emitido de novo. O seu boletim continua a contar. Se guardou a sua chave secreta, essa chave basta para recalcular a sua imagem de chave e encontrar o seu boletim.
O que a plataforma nunca vê
- Os seus ficheiros. O recibo e o ficheiro de chave privada são escritos e descarregados no seu navegador; nunca passam pelos nossos servidores.
- Uma chave secreta gerada por si. Gerada no seu navegador, nunca é transmitida. Carregar um ficheiro de chave num depósito só envia a respetiva chave pública.
- Uma chave distribuída, depois do seu voto. No modo predefinido, a plataforma gera a chave e guarda-a cifrada; apaga-a da base de dados no momento em que lha entrega e, depois, da cache temporária no momento do voto. Por isso, já não consegue reconstruir o seu recibo.
- A ligação entre a sua chave e o seu boletim. A sua chave pública figura no anel publicado e o seu boletim no registo público; só a chave secreta os liga um ao outro.
Ver também
- Boletim assinado O boletim tal como o eleitor o assina: payload, assinatura em anel, imagem de chave, resumo do anel.
- Registo público O que cada eleição publica, seja qual for o meio que o transporta: definição, anéis, registo de participação, boletins.
- Prova de voto O envelope cvproof/1: provar, por iniciativa própria, que um boletim publicado é o seu, o que revela o voto.