Přejít na obsah

Vyberte, co smí Condorcet.Vote na svých veřejných stránkách měřit. Nastavení se uloží v tomto zařízení a kdykoli ho můžete změnit.

Nezbytné Vždy zapnuto

Jazyk, motiv a zapamatování tohoto nastavení.

Condorcet.vote Alpha
Technická dokumentace

Důvěryhodná platforma

Jak platforma funguje uvnitř: co dělá během hlasování, jaká pravidla si sama ukládá a co z toho lze potom zkontrolovat v registru.

Stránka popisuje tato pravidla v obecné rovině, stejně jako whitepaper: databáze, doba podepisování, přenos, zveřejňování, správa tajemství, hosting. Ověření nenahrazují: každé tvrzení platformy je zveřejněno v registru a dá se zkontrolovat bez ní.

Protokol v1

Model důvěry

Důvěryhodná během hlasování, ověřitelná potom.

Platforma je důvěryhodná třetí strana, ale důvěřovat jí je nutné jen po omezenou dobu. Takové vystavení riziku je záměrné a zdokumentované rozhodnutí návrhu, nikoli přehlédnutí.

  • Během hlasování

    Co se jí svěřuje

    Poskytuje stránku pro hlasování, ve výchozím režimu přidělování klíčů předává tajné klíče a přijímá každý podepsaný hlasovací lístek v relaci VoteLink daného voliče. Po tuto dobu přechodně ví, kdo hlasuje, a ve výchozím režimu i to, který klíč komu předala.

  • Potom

    Co lze ověřit bez ní

    Každé její tvrzení je zachyceno ve veřejném registru a dá se nezávisle ověřit. Obě části registru, prezenční listina a hlasovací lístky, se zveřejňují tak, aby je nebylo možné spojit a přiřadit lístek k voliči.

Míra důvěry se nastavuje pro každé hlasování zvlášť. V režimu BYO-only, kdy si každý volič přináší vlastní klíč, platforma nikdy nemá tajný klíč žádného voliče a důvěřovat jí je nutné jen při příjmu hlasovacích lístků.

Co pojem „důvěryhodná třetí strana“ zahrnuje a co ne, stanoví charta. Není to akreditace, certifikace vydaná úřadem ani značka kvality.

Charta důvěryhodné třetí strany
Databáze

PostgreSQL jako jediný arbitr.

Každý invariant, na který uživatelé spoléhají, vynucuje PostgreSQL chráněnými podmíněnými zápisy a omezeními jedinečnosti, nikdy stav v paměti procesu. Správnost tak plyne ze samotné konstrukce, bez ohledu na počet workerů a instancí, bez pořadí zámků a bez uváznutí.

Pravidla zapsaná ve schématu

ballots (election_id, key_image) jedinečnost
S jedním obrazem klíče lze v hlasování hlasovat jen jednou. Pojistka, která platí i při chybě v aplikaci.
ring_keys (election_id, public_key) jedinečnost
Veřejný klíč se mezi členy kruhů daného hlasování objeví jen jednou.
chain_blocks (election_id, block_number) jedinečnost
Poslední pojistka proti rozvětvení řetězce: souběžný zapisovatel, který prohraje, selže a zkusí zápis znovu za novým koncem řetězce.
ballots append-only · trigger
Každý UPDATE nebo DELETE skončí výjimkou. Jediná stanovená odchylka je příznak is_chain_published, který transakce potvrzující blok přepne z false na true.
chain_blocks append-only · trigger
Stejné pravidlo platí pro kotvy řetězce; jedinou odchylkou je stav OpenTimestamps, který se mění jen jedním směrem: pending → completed.
ballots.payload bytea
Podepsané bajty, uložené beze změny. Nikdy v normalizujícím typu JSON: jsonb mění pořadí klíčů a přepisuje mezery, a tím by znemožnil ověření s přesností na bajt.
ballots.id UUID v4, bez časového razítka
Náhodný identifikátor a žádné datum vytvoření: nic neprozradí, v jakém pořadí byly lístky odevzdány.
Co registr zveřejňuje

Zápisy bez možnosti souběhu

  • Chráněné zápisy. Přepnutí has_voted, limit pro distribuci klíčů a vyzvednutí klíče jsou podmíněné příkazy UPDATE: nula změněných řádků znamená odmítnutí. Žádný cyklus čtení, úpravy a zápisu v paměti.
  • Kryptografie mimo zámky. Ověření podpisu, čistý výpočet nad veřejnými daty, proběhne ještě před zápisovou transakcí: kryptografie nikdy nedrží zámek.
  • Otevřené hlasování, znovu potvrzené. Při odevzdání se v transakci znovu ověří, že je hlasování otevřené, a transakce je serializovaná vůči ukončení hlasování: hlasovací lístek se buď potvrdí před ukončením, které ho pak zveřejní, nebo se odmítne. Nikdy nevznikne uložený lístek, který by řetězec vynechal.
  • Serializované bloky. Bloky vytvářejí úlohy ve frontě, serializované pro každé hlasování zvlášť; o každém bloku rozhoduje potvrzený řádek v databázi.
Data a časová posloupnost

Uchovat jen nezbytné, nic nedatovat.

Platforma neukládá nic, co protokol nepotřebuje, a nezveřejňuje nic, co by hlasovací lístek datovalo nebo identifikovalo. Čas hlasování se považuje za postranní kanál a odstraňuje se na všech úrovních.

Minimalizace

  • Údaje o voliči. Jeho e-mail, případně jméno a váha: nic dalšího se od organizátora nežádá.
  • Tajemství zašifrovaná, pak smazaná. Tajné hlasovací klíče jsou v klidovém stavu šifrované a mažou se v okamžiku použití. Jakmile je klíč předán, v databázi už neexistuje: zašifrovaný zůstává jen v mezipaměti, nejvýše 180 minut, pro případné opětovné předání, a při hlasování se smaže i odtud.
  • Vymazaná paměť. Přechodná tajemství se výslovně přepisují nulami, na straně PHP (hodnotové objekty využívající sodium_memzero) i na straně Rust/WASM (vynulované buffery).
  • Žádné sledování. Na stránkách pro hlasování není analytika ani sledovací kód: zůstávají jen serverové logy.

Hygiena časových údajů

  • Žádné časové razítko lístku. Ani v databázi, ani v registru; ve všem, co je veřejné, jsou jen náhodné identifikátory UUID v4.
  • Zveřejňování po dávkách. Hlasovací lístky se zveřejňují v dávkách po nejméně 600 kusech, podle náhodného harmonogramu a seřazené podle obrazu klíče; prezenční listina se zveřejní jen jednou, při ukončení hlasování.
  • Fyzické pročištění. PostgreSQL označí každý řádek transakcí, která ho zapsala: hlasovací lístek a odpovídající změna v prezenční listině tak na chvíli nesou stejné označení. V logickém exportu vidět není, s přímým přístupem k databázi se ale dá přečíst. Úloha spouštěná dvakrát denně tyto řádky přepíše v jediné neutrální transakci a pak spustí VACUUM: čerstvé označení přežije nejvýše jeden cyklus čištění.
Doba podepisování a přenos

Ochrana chvíle, kdy je klíč v paměti.

Tajný klíč voliče existuje v jeho prohlížeči jen po dobu, kdy je otevřená stránka pro hlasování. Na straně klienta je to nejzranitelnější okamžik, a proto ho platforma chrání nejpřísněji.

Stránka pro hlasování

  • Samostatná. Stránka bez frameworku, oddělená od aplikace organizátora. Každý odchod z hlasování znamená úplné znovunačtení stránky, které klíč z paměti vymaže.
  • Nejpřísnější CSP. Jen vlastní zdroje, žádný skript třetí strany, žádná analytika; spouštění WASM je povolené, odesílání formulářů vypnuté a data se odesílají výhradně přes fetch.
  • Integrita podepisovacího kódu. Zkompilované soubory nesou hashe pro kontrolu integrity podzdrojů (SHA-384): napadený uzel CDN nemůže nepozorovaně změnit kód, který podepisuje.
  • Vlastní subdoména. Hlasuje se na voting.condorcet.vote s cookies omezenými na tohoto hostitele: stav relace je oddělený od zbytku webu.

Přenos, odkazy a relace

  • TLS až do aplikace. Šifrování TLS zajišťuje přímo webový server aplikace, Caddy (napsaný v Go, běží přes FrankenPHP), bez mezilehlé proxy. Jeho certifikáty Let’s Encrypt se vydávají a obnovují automaticky, každý požadavek HTTP se přesměruje na HTTPS a platí moderní výchozí nastavení TLS: přednostně TLS 1.3, nejméně 1.2.
  • Žádný přístupový log hlasování. Přístupy na subdoménu pro hlasování se nikdy nezaznamenávají: její adresy obsahují token VoteLink a logy s časovými údaji by znovu vytvořily časovou posloupnost hlasování, kterou databáze odmítá uchovávat.
  • Přímo na zdrojový server, přes TLS. Kruhy (v rozhraní se jim říká „virtuální volební místnosti“), distribuce klíčů a odevzdávání hlasovacích lístků putují přímo mezi prohlížečem a platformou. Pro data hlasování nestojí v cestě žádná CDN; na okraji sítě se ukládají do mezipaměti jen zkompilované statické soubory.
  • Odkaz jako oprávnění, bez účtu. Volič nezakládá účet ani heslo: jeho VoteLink, který mu platforma pošle e-mailem, je oprávnění typu bearer, platné pro toho, kdo ho drží. Ukládá se jen hash tokenu; odkaz patří jedinému voliči, jeho relace má úzký rozsah a počet požadavků je omezený.
  • Relace na straně serveru. Relace se uchovávají ve Valkey (Redis). V prohlížeči je jen nezbytně nutný stav: relace, jazyk, motiv.
  • Zbytek webu. Vše včetně skriptů a WASM se poskytuje z vlastní domény pod přísnou CSP; veřejné stránky nenačítají nic ze zdrojů třetích stran.
  • Organizátoři. Přihlášení heslem nebo přístupovým klíčem, nepovinný druhý faktor TOTP, omezený počet pokusů na účet i na IP adresu.
Zveřejňování a podpis

Co aplikace nemůže přepsat.

Blok je platný tehdy a jen tehdy, když hash jeho bajtů odpovídá potvrzenému hashi a jeho podpis projde ověřením, ať se blok čte odkudkoli. Úložiště k tomu přidává vlastní zábrany.

Oddělené zveřejňování

  • Samostatné úložiště. Soubory řetězce leží ve vlastním bucketu objektového úložiště, s vlastními přístupovými údaji, odděleně od veškerého ostatního obsahu, a poskytují se z vlastního názvu hostitele CDN: chyba v kterékoli cestě pro nahrávání souborů nikdy nemůže zapsat do řetězce.
  • Jediný zápis. Bucket má zapnuté zamykání objektů od poskytovatele: zapsaný soubor bloku nelze přepsat ani smazat, a to ani s přístupovými údaji platformy k úložišti. Doplňuje tak databázové triggery a řetězec hashů.
  • Surové bajty. Bloky se poskytují tak, jak jsou; žádná vrstva frameworku je nemůže přeformátovat. Obsah je deterministický, takže opakovaný zápis je idempotentní.

Podpisový klíč

  • Pevně daný nástroj. Každý blok se podepisuje ve formátu OpenPGP v6 (RFC 9580, Ed25519) pevně danou verzí Sequoia sq přibalenou k aplikaci, a to v úlohách na pozadí; PHP žádnou matematiku podpisu neprovádí.
  • Soukromé klíče mimo databázi. Veřejné certifikáty jsou v databázi, soukromé klíče se do ní nikdy nedostanou. Uchovává je služba OVHcloud pro správu tajemství (OKMS) podle nejpřísnějších bezpečnostních standardů: šifrované v klidovém stavu, izolovaná doména pro každé prostředí, přístup klientským certifikátem přes vzájemné TLS. OKMS je jen uchovává: podepisuje se lokálně, pevně danou verzí klíče, jejíž otisk se kontroluje.
  • Obměna, která omezí škody. Při obměně dostane odcházející klíč expiraci s okamžitou platností a jeho verze se deaktivují: vyřazený klíč dál slouží k ověřování, ale už nepodepisuje.
  • Co podpis nedokazuje. Dokazuje, že blok vytvořila platforma, ale už ne to, že nepřepsala historii, protože klíč drží ona sama. Neměnnost zajišťuje nezávislé zrcadlení a ukotvení každého bloku přes OpenTimestamps dokazuje, kdy jeho bajty existovaly.
Hosting a vývoj

Kde platforma běží a jak se vyvíjí.

Provoz v širším smyslu tu popsán není; uvedeny jsou jen body, na kterých stojí některá ze záruk.

Hosting

  • Ve Francii. Platforma je hostována ve Francii a vše se poskytuje z její vlastní domény: v prohlížečích voličů se nenačítá žádná služba třetí strany.
  • Úsporná sestava. PostgreSQL pro data; Valkey pro relace, fronty a mezipaměť, nikdy jako hlavní úložiště. Oddělené fronty úloh, aby nápor v jedné nikdy nepřipravil ostatní o workery.
  • Tajemství mimo konfiguraci. Ve vzdálených prostředích nejsou žádné přístupové údaje v souborech prostředí: všechny drží OKMS, služba OVHcloud pro správu tajemství, s izolovanou doménou pro každé prostředí.

Vývojová disciplína

  • Skutečná kryptografie v testech. Testovací sada používá skutečný modul WASM, nikdy napodobeninu, na serveru i v prohlížeči, až po kompletní průchody hlasováním řízené prohlížečem.
  • Zafixované vektory. Kryptografické jádro má zafixované testovací vektory protokolu: jakákoli tichá změna doménového řetězce, formátu nebo rozložení bajtů shodí build. Jádro také bit po bitu testuje tvárnost dat (malleability), na všech svých parserech spouští fuzzing a v CI audituje své závislosti.
  • Specifikace v souladu s kódem. Specifikace se verzují spolu s kódem a podle výslovné konvence se s ním průběžně sladí; whitepaper a tyto stránky jsou jejich zveřejněná podoba.
Omezení

Co zůstává věcí důvěry.

Tyto meze jsou zdokumentované, ne zamlčené. Týkají se hlavně doby hlasování; potom registr omezuje, co by platforma mohla udělat nepozorovaně.

V čem je nutné jí důvěřovat

  • Zlovolná platforma v době hlasování. V režimu klíčů generovaných serverem by mohla předem vypočítat obraz klíče ke každému klíči, který předala, a hlasovací lístky deanonymizovat. Importované klíče nebo klíče vložené voliči jí tuto možnost berou; hlasování v režimu BYO-only odstraňují jakékoli tajemství uložené na serveru.
  • Vymyšlená účast. Mohla by označit, že nepřítomný volič hlasoval, a přidat hlasovací lístek, aniž by překročila zveřejněné meze; odhalit to může jen ten volič sám, když si zkontroluje svůj řádek v prezenční listině.
  • Prohlížeč při podepisování. Vložení škodlivého skriptu během podepisování zůstává zbytkovým rizikem na straně klienta: CSP ho snižuje, ale odstranit ho nedokáže.
  • Kontaktní údaje v klidovém stavu. Jména a e-maily voličů jsou uloženy nešifrované, protože VoteLinky se posílají e-mailem a organizátor potřebuje čitelný seznam: při napadení databáze by byly vyzrazeny. Tajné hlasovací klíče jsou naproti tomu vždy šifrované.
  • Fyzické úložiště. Archivované záznamy WAL, zálohy a přístupové logy webu zůstávají otázkou infrastruktury a doby uchovávání.
  • Externí audit, připravuje se. Plánuje se nezávislé posouzení protokolu a jeho implementace; odkaz na zprávu z něj bude na stránce o bezpečnosti.

Co tuto důvěru omezuje

  • Registr. Platné kruhové podpisy, žádný klíč, který by podepsal dvakrát, ne více hlasovacích lístků než voličů v seznamu: to vše se kontroluje jen ze zveřejněného registru.
  • Přepočítání. Výsledek se přepočítá z registru jiným softwarem, než jaký používá platforma.
  • Řetězec a jeho zrcadla. Surové soubory, podepsané a zřetězené, které si může uložit kdokoli: přepsání historie pozná každý svědek, který si uschoval starší konec řetězce.
  • Kód, na kterém záleží. Kryptografické jádro (CryptoVote) i knihovna pro sčítání (CondorcetPHP) jsou open source: kód, který podepisuje, ověřuje a sčítá, si může prohlédnout kdokoli.
  • Písemné závazky. Charta uvádí, co se platforma zavazuje dělat a co nedělat: zveřejněný registr se na žádost organizátora nikdy nestáhne ani nezmění.