Soubory voliče
Dva soubory, které si volič může uschovat: ověřovací doklad a soubor se soukromým klíčem. Jejich obsah pole po poli, co s nimi lze ověřit a co musí zůstat tajné.
Oba vznikají ve vašem prohlížeči a existují, jen pokud si je stáhnete: platforma je nedostává, neukládá a nikdy je neposílá. Oba obsahují váš tajný klíč.
Protokol v1
Stejná pravidla pro oba soubory.
Doklad i soubor se soukromým klíčem dodržují stejné konvence; čte je a zapisuje knihovna voter-artifacts webu pro hlasování. Kryptografickou platnost hodnot (kontrolní součet, příslušnost ke křivce) posuzuje CryptoVote, ne program, který čte obálku.
- Jeden objekt JSON v UTF-8. Každý soubor je jediný objekt JSON zapsaný na jednom řádku, bez mezer. Příklady na této stránce jsou pro čitelnost odsazené.
- Na začátku verze. Pole version uvádí obálku a její verzi. Při čtení se musí zkontrolovat a jakákoli jiná hodnota se odmítne.
- Hodnoty s prefixem, nikdy holé hex. Každá kryptografická hodnota je kanonický řetězec <štítek>_<hex>_<kontrolní součet>, který vydává CryptoVote, převzatý beze změny. Hexadecimální hodnota bez prefixu se odmítne.
- Kontrolní součet proti překlepům. 4 bajty BLAKE3 (8 hexadecimálních znaků), do kterých se započítává i štítek: chybně opsaná hodnota nebo pk_ zadaný místo ki_ se odhalí okamžitě. Není to bezpečnostní záruka: pravost zajišťuje jen kruhový podpis.
- Neznámá pole se ignorují. Program, který soubor čte, musí pole, která nezná, ignorovat, aby zůstal kompatibilní s dalším vývojem formátu; zpět je nezapisuje.
Štítky
-
pk_32 bajtů · 64 hexadecimálních znaků - Veřejný klíč: ten, který je uveden v kruhu.
-
sk_32 bajtů · 64 hexadecimálních znaků - Tajný klíč: ten, který podepisuje. Nesmí se nikdy prozradit.
-
ki_32 bajtů · 64 hexadecimálních znaků - Obraz klíče: veřejný identifikátor hlasovacího lístku, vázaný na jedno hlasování.
-
ring_32 bajtů · 64 hexadecimálních znaků - Hash kruhu: kanonický hash množiny klíčů kruhu, nezávislý na jejich pořadí.
-
blsag_32 × (1 + velikost kruhu) bajtů - Kruhový podpis bLSAG: 38 464 hexadecimálních znaků pro kruh o 600 klíčích.
Doklad vydaný po přijetí hlasovacího lístku.
Vaše vlastní kopie odevzdaného hlasovacího lístku, kruhu (v rozhraní se mu říká „virtuální volební místnost“), ve kterém byl podepsán, a klíče, který ho podepsal: podle ní si svůj lístek ve veřejném registru najdete a ověříte.
Kdy a v čích rukou
- Až po přijetí. Doklad se na stránce pro hlasování objeví až poté, co server váš hlasovací lístek přijme. Zobrazí se jen jednou; stažení je nepovinné.
- Vzniká ve vašem prohlížeči. Stránka ho sestaví z tajného klíče, který zůstal v paměti od podepsání. Nikdy se neposílá e-mailem (potvrzovací e-mail dokládá jen vaši účast) a platforma ho nikdy neukládá.
- Nelze vystavit znovu. Platforma už váš tajný klíč nemá, a proto doklad nemůže sestavit znovu. Citlivé hodnoty jsou na stránce skryté za tlačítky „Zobrazit“ a „Kopírovat“; tlačítko „Trvale skrýt podrobnosti“ je z obrazovky definitivně odstraní a tajný klíč se po pevně stanovené době smaže sám. Doklad si proto předtím zkopírujte nebo stáhněte.
K čemu slouží
- Najít svůj hlasovací lístek. Zadejte ballot.key_image do vyhledávání ve veřejném registru hlasování, a to i před zveřejněním v dávce, a pak porovnejte zveřejněný lístek se signed_payload bajt po bajtu.
- Ověřit svůj kruh. Porovnejte ring_digest s hashem, který registr zveřejňuje pro kruh uvedený v poli ring. Rozdíl znamená, že váš lístek byl podepsán v jiném kruhu, než jaký byl zveřejněn.
- Zkontrolovat svůj řádek v prezenční listině. voter_id odkazuje na váš řádek v prezenční listině: počet distribucí klíče, údaj „Hlas odevzdán“.
- Znovu ověřit podpis offline. K opětovnému ověření podpisu bez platformy stačí signed_payload, signature, identifikátor hlasování a veřejné klíče kruhu.
- Vytvořit důkaz hlasu. Nástroj „Důkaz hlasu“ doklad přečte a převezme z něj tajný klíč, hlasování a obraz klíče.
-
versionřetězec - Vždy condorcet-receipt/1.
-
electionUUID - Identifikátor hlasování, parametr podpisu. Při čtení se přijímá i velkými písmeny, zapisuje se vždy malými.
-
ringneprázdný řetězec - Identifikátor (UUID) kruhu, ve kterém byl hlasovací lístek podepsán, tak jak je zveřejněn v registru.
-
ring_digestring_… - Hash tohoto kruhu, vypočítaný vaším prohlížečem z klíčů, které obdržel. Server ho nikdy nedodává: hodnotu poslanou spolu s kruhem by šlo upravit zároveň s ním.
-
voter_idUUID - Vaše ID voliče, jediný zveřejněný identifikátor, který se vás týká.
-
public_keypk_… - Váš veřejný klíč, člen kruhu z pole ring.
-
secret_keysk_… - Váš tajný klíč, ten, který hlasovací lístek podepsal.
-
ballot.signed_payloadřetězec (JSON) - Podepsaná data (payload) bajt po bajtu: přesně ten řetězec, který byl podepsán a odeslán na server. Zachází se s ním jako s neprůhledným řetězcem; kdyby se znovu rozparsoval a zakódoval, porovnání s registrem by selhalo.
-
ballot.signatureblsag_… - Kruhový podpis hlasovacího lístku.
-
ballot.key_imageki_… - Obraz klíče hlasovacího lístku, vázaný na toto hlasování: veřejný identifikátor vašeho lístku v registru.
{
"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"
}
}
Smyšlené hodnoty: neplatné kontrolní součty, podpis zkrácený na minimální délku. Název staženého souboru tvoří recu-vote- a prvních 8 znaků identifikátoru hlasování.
Soubor se soukromým klíčem stažený při vložení klíče.
Když vkládáte vlastní klíč, pár klíčů se vygeneruje ve vašem prohlížeči. Tento soubor je jeho záloha: právě s ním budete hlasovat.
Kdy a v čích rukou
- Při vložení vygenerovaného klíče. Během období vkládání klíčů u hlasování nebo u skupiny hlasování, pokud se rozhodnete klíč vygenerovat. Pár klíčů vytvoří CryptoVote ve vašem prohlížeči.
- Odchází jen veřejný klíč. public_key se odešle platformě, která ho zařadí do kruhu. Tajný klíč se zobrazí jednou a dá se zkopírovat; soubor se sestaví ve vašem prohlížeči.
- Bez hlasování a bez skupiny. Soubor obsahuje jen pár klíčů: tentýž klíč může sloužit pro několik nezávislých hlasování, protože obraz klíče se při podpisu váže na konkrétní hlasování. Název souboru vychází ze samotného klíče: condorcet-vote- a kontrolní součet public_key.
K čemu slouží
- Hlasovat. Na stránce pro hlasování zadejte klíč sk_… nebo nahrajte soubor: stránka z něj odvodí veřejný klíč a zkontroluje, že je v kruhu, který vám byl přidělen.
- Vložit stejný klíč jinde. Při dalším vkládání klíče nahrajte soubor: veřejný klíč se z něj vyčte v prohlížeči a tajný klíč vaše zařízení neopustí.
- Najít svůj hlasovací lístek, prokázat svůj hlas. S tajným klíčem a identifikátorem hlasování nástroj „Důkaz hlasu“ znovu vypočítá váš obraz klíče, i bez dokladu.
-
versionřetězec - Vždy condorcet-private-key/1.
-
public_keypk_… - Veřejný klíč, ten, který se při vložení odeslal platformě.
-
secret_keysk_… - Tajný klíč, vygenerovaný ve vašem prohlížeči a nikdy neodeslaný.
{
"version": "condorcet-private-key/1",
"public_key": "pk_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef_a1b2c3d4",
"secret_key": "sk_fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210_d4c3b2a1"
}
Smyšlené hodnoty, neplatné kontrolní součty. Žádné pole election ani pole pro skupinu: starší soubor s informativním polem election se dá dál načíst, toto pole se ignoruje.
Co musí zůstat tajné a proč.
Oba soubory obsahují váš tajný klíč. Chraňte je jako heslo: mimo dosah ostatních, ale pozor, ať o ně nepřijdete.
Rizika bez obalu
- Tajný klíč prozrazuje váš hlas. Dá se z něj znovu vypočítat váš obraz klíče pro jakékoli hlasování, a tedy i zpětně najít vaše zveřejněné hlasovací lístky ve všech hlasováních, kde byl použit, a vytvořit vaším jménem důkaz hlasu.
- Tajný klíč podepisuje. Vytvoří platný podpis v každém kruhu, který obsahuje váš veřejný klíč. Platforma ale přijme hlasovací lístek jen přes váš hlasovací odkaz, a od každého voliče jen jeden.
- Doklad prozradí váš hlas každému, kdo ho čte. Spojuje vaše ID voliče s vaším hlasovacím lístkem. Je z principu prokazatelný: protokol upřednostňuje individuální ověřitelnost, a proto nenabízí odolnost vůči nátlaku. Ukažte ho jen tomu, komu chcete svůj hlas prozradit.
- Ztracený klíč znamená ztracený hlas. Vložený klíč nemá na serveru žádnou zálohu: jakmile je hlasování otevřené, jeho ztráta znamená, že nebudete moci hlasovat. Dokud je období vkládání klíčů otevřené, můžete místo něj vložit nový klíč, a to u hlasování, jejichž kruhy ještě nejsou sestavené.
- Ztracený doklad se znovu nevydává. Váš hlasovací lístek se i tak započítá. Pokud máte stále svůj tajný klíč, stačí k opětovnému výpočtu obrazu klíče a k nalezení lístku.
Co platforma nikdy nevidí
- Vaše soubory. Doklad i soubor se soukromým klíčem se zapisují a stahují ve vašem prohlížeči; nikdy neprocházejí našimi servery.
- Tajný klíč vygenerovaný u vás. Vzniká ve vašem prohlížeči a nikdy se neodesílá. Když při vkládání klíče nahrajete soubor s klíčem, odešle se z něj jen veřejný klíč.
- Přidělený klíč po vašem hlasování. Ve výchozím režimu klíč generuje platforma a uchovává ho zašifrovaný; ze své databáze ho smaže ve chvíli, kdy vám ho předá, a ze své dočasné mezipaměti ve chvíli hlasování. Váš doklad proto už sestavit znovu nedokáže.
- Vazba mezi vaším klíčem a hlasovacím lístkem. Váš veřejný klíč je ve zveřejněném kruhu a váš hlasovací lístek ve veřejném registru; spojit je dokáže jen tajný klíč.
Viz také
- Podepsaný hlasovací lístek Hlasovací lístek v podobě, v jaké ho volič podepisuje: podepsaná data, kruhový podpis, obraz klíče, hash kruhu.
- Veřejný registr Co každé hlasování zveřejňuje bez ohledu na způsob přenosu: definice, kruhy, prezenční listina, hlasovací lístky.
- Důkaz hlasu Obálka cvproof/1: volič z vlastního podnětu dokáže, že zveřejněný hlasovací lístek je jeho, a tím prozradí svůj hlas.