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

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

Společný formát

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.
Ověřovací doklad · .condorcet_receipt

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.
election UUID
Identifikátor hlasování, parametr podpisu. Při čtení se přijímá i velkými písmeny, zapisuje se vždy malými.
ring neprá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_digest ring_…
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_id UUID
Vaše ID voliče, jediný zveřejněný identifikátor, který se vás týká.
public_key pk_…
Váš veřejný klíč, člen kruhu z pole ring.
secret_key sk_…
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.signature blsag_…
Kruhový podpis hlasovacího lístku.
ballot.key_image ki_…
Obraz klíče hlasovacího lístku, vázaný na toto hlasování: veřejný identifikátor vašeho lístku v registru.
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"
    }
}

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í.

Soukromý klíč · .condorcet_private_key

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_key pk_…
Veřejný klíč, ten, který se při vložení odeslal platformě.
secret_key sk_…
Tajný klíč, vygenerovaný ve vašem prohlížeči a nikdy neodeslaný.
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"
}

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.

Tajemství

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íč.
Co důkaz hlasu prozrazuje