Plataforma de confiança
Como a plataforma funciona por dentro: o que faz durante a votação, as regras que impõe a si própria e o que se pode verificar depois no registo.
Esta página descreve os princípios dessas regras, tal como o livro branco: base de dados, período de assinatura, transporte, publicação, gestão de segredos, alojamento. Não substituem a verificação: cada afirmação da plataforma é publicada no registo e pode ser confirmada sem ela.
Protocolo v1
Digna de confiança durante a votação, verificável depois.
A plataforma é um terceiro de confiança, mas a confiança que nela se deposita está limitada no tempo. Esta exposição é uma decisão de conceção deliberada e documentada, não um descuido.
-
Durante a votação
O que lhe é confiado
Serve a página de voto, entrega as chaves secretas no modo de provisionamento predefinido e recebe cada boletim assinado através da sessão VoteLink do eleitor. Durante esse período, sabe transitoriamente quem vota e, no modo predefinido, que chave entregou a quem.
-
Depois
O que se verifica sem ela
Cada uma das suas afirmações fica materializada no registo público e pode ser verificada independentemente. As duas faces do registo, participação e boletins, são publicadas de modo que ninguém as possa cruzar para ligar um eleitor a um boletim.
O nível de confiança define-se por eleição: no modo BYO-only, em que cada eleitor deposita a sua própria chave, a plataforma nunca detém o segredo de assinatura de nenhum eleitor, e o período de confiança reduz-se à receção dos boletins.
O que a qualidade de «terceiro de confiança» implica para a plataforma, e o que não implica, está escrito na carta. Não é uma acreditação, nem uma certificação emitida por uma autoridade, nem um selo de qualidade.
A carta do terceiro de confiançaPostgreSQL, árbitro único.
Cada invariante visível para os utilizadores é imposto no PostgreSQL por escritas condicionais protegidas e por restrições de unicidade, nunca pelo estado em memória de um processo: correto por construção, seja qual for o número de workers e de instâncias, sem ordem de bloqueios nem deadlocks.
As regras inscritas no esquema
-
ballots (election_id, key_image)unicidade - Uma imagem de chave só vota uma vez por eleição. É uma rede de segurança que resiste até a um erro da aplicação.
-
ring_keys (election_id, public_key)unicidade - Uma chave pública só aparece uma vez entre os membros dos anéis da eleição.
-
chain_blocks (election_id, block_number)unicidade - A salvaguarda final contra bifurcações: um escritor concorrente que perde a corrida falha e tenta de novo a partir da nova cabeça da cadeia.
-
ballotsappend-only · trigger - Qualquer UPDATE ou DELETE lança uma exceção. A única exceção prevista é o indicador is_chain_published, que passa de false a true na transação que confirma um bloco.
-
chain_blocksappend-only · trigger - A mesma regra para as âncoras da cadeia; a única exceção é o estado OpenTimestamps, num só sentido: pending → completed.
-
ballots.payloadbytea - Os bytes assinados, guardados tal como chegam. Nunca num tipo JSON que normalize: o jsonb reordena as chaves e reescreve os espaços, o que quebraria a verificação exata ao byte.
-
ballots.idUUID v4, sem data nem hora - Um identificador aleatório e nenhuma data de criação: nada denuncia a ordem de envio.
Escritas sem condições de corrida
- Escritas protegidas. A mudança de has_voted, o limite de distribuição das chaves e a reivindicação de uma chave são UPDATE condicionais: zero linhas alteradas equivale a uma recusa. Nunca há leitura-modificação-escrita em memória.
- A criptografia fora dos bloqueios. A verificação da assinatura, simples cálculo sobre dados públicos, é executada antes da transação de escrita: a criptografia nunca detém um bloqueio.
- Uma eleição aberta, reconfirmada. No envio, o estado aberto da eleição volta a ser confirmado dentro da transação, serializada em relação ao encerramento: um boletim ou é confirmado antes do encerramento e publicado por ele, ou é recusado. Nunca fica guardado um boletim que a cadeia deixasse de fora.
- Blocos serializados. Os blocos são produzidos por tarefas em fila de espera, serializadas por eleição; a linha confirmada na base de dados é o árbitro de cada bloco.
Guardar só o necessário, não datar nada.
A plataforma não guarda nada de que o protocolo não precise e não publica nada que date ou identifique um boletim. O momento de cada voto é tratado como um canal lateral e eliminado em todas as etapas.
Minimização
- Os dados do eleitor. O e-mail e, opcionalmente, o nome e o peso: nada mais é pedido ao organizador.
- Segredos cifrados, depois apagados. As chaves secretas de voto são cifradas em repouso e eliminadas no momento em que são usadas. Depois de entregue, a chave deixa de existir na base de dados: sobrevive apenas, cifrada, numa cache de 180 minutos no máximo, para o caso de ser preciso entregá-la de novo, e é apagada dessa cache quando o eleitor vota.
- Memória limpa. Os segredos transitórios são explicitamente postos a zero, tanto do lado PHP (objetos de valor apoiados em sodium_memzero) como do lado Rust/WASM (buffers postos a zero).
- Nenhum rastreador. Nem estatísticas de audiência nem rastreio nas páginas de voto: restam apenas os logs do servidor.
Higiene cronológica
- Boletins sem data nem hora. Nem na base de dados nem no registo; identificadores UUID v4 aleatórios em toda a superfície pública.
- Publicação por lotes. Os boletins saem em lotes de pelo menos 600, segundo um calendário aleatório, ordenados por imagem de chave; o registo de participação é publicado uma única vez, no encerramento.
- Limpeza física. O PostgreSQL marca cada linha com a transação que a escreveu: um boletim e a mudança correspondente no registo de participação partilham por instantes a mesma marca, invisível numa exportação lógica mas legível com acesso direto à base de dados. Duas vezes por dia, uma tarefa reescreve essas linhas numa única transação neutra e executa depois um VACUUM: uma marca recente sobrevive, no máximo, a um ciclo de limpeza.
Proteger o momento em que a chave está em memória.
A chave secreta do eleitor só existe no navegador enquanto a página de voto estiver aberta. É o momento mais exposto do lado do cliente, e aquele que a plataforma protege com mais rigor.
A página de voto
- Autónoma. Uma página sem framework, fora da aplicação do organizador. Qualquer navegação para fora da votação recarrega a página por completo, o que apaga a chave da memória.
- A CSP mais estrita. Só recursos próprios, nenhum script de terceiros, nenhuma estatística de audiência; a execução WASM é permitida e o envio de formulários está desativado, substituído por uma submissão exclusivamente via fetch.
- A integridade do código que assina. Os recursos compilados têm hashes de integridade de sub-recurso (SHA-384): um nó de CDN comprometido não consegue alterar o código de assinatura sem que se note.
- Um subdomínio próprio. A votação decorre em voting.condorcet.vote, com cookies restritos a esse host: o estado da sessão fica isolado do resto do site.
Transporte, links e sessões
- TLS até à aplicação. A cifragem TLS é assegurada pelo próprio servidor web da aplicação, o Caddy (escrito em Go, através do FrankenPHP), sem proxy intermédio. Os certificados Let's Encrypt são emitidos e renovados automaticamente, todo o acesso HTTP é redirecionado para HTTPS e aplicam-se por predefinição as configurações TLS modernas: TLS 1.3 de preferência, 1.2 no mínimo.
- Nenhum log de acesso na votação. O subdomínio de voto nunca fica registado em logs: os seus endereços contêm o token do VoteLink, e logs com data e hora recriariam a cronologia dos votos que a base de dados se recusa a guardar.
- Diretamente para a origem, por TLS. Os anéis (chamados «mesas de voto virtuais» na interface), a distribuição das chaves e o envio dos boletins circulam diretamente entre o navegador e a plataforma. Nenhuma CDN se interpõe nos dados de voto; só os recursos estáticos compilados ficam em cache na periferia da rede.
- Um link de capacidade, sem conta. O eleitor não cria conta nem palavra-passe: o seu VoteLink, enviado por e-mail pela plataforma, é uma capacidade ao portador. Só o hash do token é guardado; o link está associado a um único eleitor, a sua sessão tem um âmbito restrito e o número de pedidos é limitado.
- Sessões do lado do servidor. As sessões são mantidas no Valkey (Redis). No navegador, fica apenas o estado estritamente necessário: sessão, idioma, tema.
- O resto do site. Tudo, incluindo scripts e WASM, é servido a partir do próprio domínio, sob uma CSP estrita; nenhuma origem de terceiros nas páginas públicas.
- Os organizadores. Início de sessão com palavra-passe ou passkey, segundo fator TOTP opcional, tentativas limitadas por identificador e por endereço IP.
O que a aplicação não consegue reescrever.
Um bloco é válido se, e só se, o hash dos seus bytes coincidir com o hash confirmado e a sua assinatura for válida, seja qual for o sítio de onde é lido. O armazenamento acrescenta barreiras próprias.
Isolamento da publicação
- Um armazenamento à parte. Os ficheiros da cadeia ficam num bucket de armazenamento de objetos só deles, com credenciais de acesso próprias, separados de qualquer outro conteúdo armazenado e servidos a partir de um nome de host CDN próprio: uma falha num caminho de carregamento nunca pode escrever na cadeia.
- Escrita única. O bucket ativa o bloqueio de objetos do fornecedor: depois de escrito, um ficheiro de bloco não pode ser substituído nem eliminado, nem sequer com as credenciais de armazenamento da plataforma. Este bloqueio complementa os triggers da base de dados e a cadeia de hashes.
- Bytes em bruto. Os blocos são servidos tal como estão; nenhuma camada do framework os pode reformatar. Como o conteúdo é determinístico, repetir uma escrita é idempotente.
A chave de assinatura
- Uma ferramenta de versão fixa. Cada bloco é assinado em OpenPGP v6 (RFC 9580, Ed25519) por uma versão fixa do Sequoia sq, incluída no projeto, em tarefas de fundo; nenhum cálculo de assinatura do lado PHP.
- Chaves privadas fora da base de dados. Os certificados públicos estão na base de dados; as chaves privadas nunca lá entram. São guardadas no gestor de segredos da OVHcloud (OKMS), segundo as normas de segurança mais exigentes: cifradas em repouso, um domínio isolado por ambiente, acesso por certificado de cliente em TLS mútuo. O OKMS limita-se a guardá-las: a assinatura continua a ser feita localmente, a partir de uma versão fixa da chave cuja impressão digital é verificada.
- Uma rotação que limita os danos. Na rotação, a chave cessante recebe uma data de expiração nesse mesmo instante e as suas versões são desativadas: uma chave retirada continua a servir para verificar, mas já não assina.
- O que a assinatura não prova. Prova que a plataforma produziu um bloco, não que deixou o histórico por reescrever, uma vez que é ela que detém a chave. A imutabilidade vem da replicação independente em espelho, e a ancoragem OpenTimestamps de cada bloco prova quando existiam os seus bytes.
Onde funciona e como é construída.
A operação da plataforma em geral não é descrita aqui; constam apenas os pontos que sustentam uma garantia.
Alojamento
- Em França. A plataforma está alojada em França e tudo é servido a partir do seu próprio domínio: nenhum serviço de terceiros é carregado no navegador dos eleitores.
- Uma pilha reduzida. PostgreSQL para os dados; Valkey para as sessões, as filas e a cache, nunca como armazenamento principal. Filas de tarefas isoladas, para que um pico de carga numa delas nunca deixe as outras sem workers.
- Segredos fora da configuração. Nos ambientes remotos, nenhuma credencial fica nos ficheiros de ambiente: todas são guardadas pelo OKMS, o gestor de segredos da OVHcloud, com um domínio isolado por ambiente.
Disciplina de engenharia
- Criptografia real nos testes. O conjunto de testes usa o verdadeiro módulo WASM, nunca uma imitação, tanto do lado do servidor como no navegador, até percursos de voto completos conduzidos num navegador.
- Vetores fixados. O núcleo criptográfico fixa vetores de protocolo: qualquer alteração silenciosa de uma cadeia de domínio, de um formato ou de uma disposição de bytes faz falhar a compilação. Executa também varrimentos de maleabilidade bit a bit e alvos de fuzzing em todos os seus parsers, e audita as suas dependências na integração contínua.
- Especificações sincronizadas. As especificações são versionadas com o código e mantidas a par dele por convenção explícita; o livro branco e estas páginas são a sua forma publicada.
O que continua a depender de confiança.
Estes limites estão documentados, não escondidos. Dizem respeito sobretudo ao período de votação; depois, o registo limita o que uma plataforma poderia fazer sem ser vista.
O que é preciso confiar-lhe
- Uma plataforma maliciosa no momento da votação. No modo de chaves geradas pelo servidor, poderia pré-calcular a imagem de chave de cada chave que entregou e desanonimizar os boletins. As chaves importadas ou depositadas pelos eleitores retiram-lhe esse poder; as eleições BYO-only eliminam qualquer segredo detido pelo servidor.
- Uma participação fabricada. Poderia marcar um ausente como tendo votado e acrescentar um boletim dentro dos limites publicados; só o eleitor em causa o pode detetar, verificando a sua própria linha no registo de participação.
- O navegador durante a assinatura. Uma injeção de script durante o período de assinatura continua a ser o risco residual do lado do cliente: a CSP reduz esse risco ao mínimo, mas não o consegue eliminar.
- Os contactos em repouso. Os nomes e os e-mails dos eleitores são guardados em claro, porque os VoteLinks seguem por e-mail e o organizador precisa de uma lista legível: uma intrusão na base de dados expô-los-ia. Já as chaves secretas de voto estão sempre cifradas.
- O armazenamento físico. Os ficheiros WAL arquivados, as cópias de segurança e os logs de acesso web continuam a ser uma questão de infraestrutura e de prazos de conservação.
- Uma revisão externa, por fazer. Está prevista uma revisão independente do protocolo e da sua implementação; o relatório ficará acessível a partir da página de segurança.
O que limita essa confiança
- O registo. Assinaturas em anel válidas, nenhuma chave que tenha assinado duas vezes, não mais boletins do que votantes registados: tudo se verifica só a partir do registo publicado.
- A recontagem. O resultado volta a ser calculado a partir do registo, com um software que não é o da plataforma.
- A cadeia e os seus espelhos. Ficheiros em bruto, assinados e encadeados, que qualquer pessoa pode guardar: uma reescrita torna-se evidente para qualquer testemunha que tenha guardado uma cabeça de cadeia anterior.
- O código que conta. O núcleo criptográfico (CryptoVote) e a biblioteca de apuramento (CondorcetPHP) são de código aberto: o que assina, verifica e apura pode ser inspecionado.
- Compromissos escritos. A carta diz o que a plataforma se compromete a fazer, e a não fazer: um registo publicado nunca é retirado nem alterado a pedido do organizador.
Ver também
- 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.
- Chaves da plataforma Os certificados OpenPGP v6 que assinam os blocos, a sua rotação e o ponto de acesso para máquinas.
- Procedimento de verificação Verificar uma eleição do princípio ao fim: só a partir do registo, ou com a blockchain.