Saltar para o conteúdo
Condorcet.vote Alpha
← Documentação técnica

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

Formato comum

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.
Recibo de voto · .condorcet_receipt

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.
version string
Sempre condorcet-receipt/1.
election UUID
O identificador da eleição, parâmetro da assinatura. É aceite em maiúsculas na leitura e sempre reescrito em minúsculas.
ring string não vazia
O identificador (UUID) do anel com que o boletim foi assinado, tal como publicado no registo.
ring_digest ring_…
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_id UUID
O seu ID de eleitor, o único identificador publicado que lhe diz respeito.
public_key pk_…
A sua chave pública, membro do anel ring.
secret_key sk_…
A sua chave secreta, a que assinou o boletim.
ballot.signed_payload string (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.signature blsag_…
A assinatura em anel do boletim.
ballot.key_image ki_…
A imagem de chave do boletim, própria desta eleição: o identificador público do seu boletim no registo.
public/docs/voter-files.example_label · recu-vote-0c2e7e2a.condorcet_receipt
{
    "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.

Ficheiro de chave privada · .condorcet_private_key

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.
version string
Sempre condorcet-private-key/1.
public_key pk_…
A chave pública, a que foi transmitida à plataforma no depósito.
secret_key sk_…
A chave secreta, gerada no seu navegador e nunca transmitida.
public/docs/voter-files.example_label · condorcet-vote-a1b2c3d4.condorcet_private_key
{
    "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.

Segredos

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.
O que uma prova de voto revela

Escolha o que o Condorcet.Vote mede nas páginas públicas. A sua escolha fica guardada neste dispositivo e pode ser alterada a qualquer momento.

Essenciais Sempre ativos

Idioma, tema e memorização destas opções.