[ { "path": ".editorconfig", "content": "# http://editorconfig.org\n\nroot = true\n\n[*]\ntrim_trailing_whitespace = true\ninsert_final_newline = true\ncharset = utf-8\nend_of_line = lf\n\n[*.{conf,html,ini,jinja,sql,py}]\nindent_style = space\nindent_size = 4\n\n[*.{json,schema,schema.example}]\nindent_style = space\nindent_size = 4\ninsert_final_newline = false\n\n[*.{css,feature,js,pu,sh,yaml,yml}]\nindent_style = space\nindent_size = 2\n\n[*.{inc,rst}]\nindent_style = space\nindent_size = 3\n\n[Makefile]\nindent_style = tab\n\n[*.mk]\nindent_style = tab\n\n[debian/*{preinst,postinst,prerm,postrm}]\nindent_style = space\nindent_size = 4\n\n[debian/changelog]\nindent_style = space\nindent_size = 2\n" }, { "path": ".gitignore", "content": "*.swp\n*.pyc\ngen_types.go\ngen_types_test.go\ngen_import.go\ngen_import_dev.go\n__pycache__\n.idea\n\n# ivxv-admin\n/build\n/dist\n/.pybuild\n/collector-admin/IVXVCollectorAdminDaemon.egg-info\n" }, { "path": ".gitmodules", "content": "[submodule \"Documentation/public/liidesed/VIS3-EHS\"]\n path = Documentation/public/liidesed/VIS3-EHS\n url = https://github.com/e-gov/VIS3-EHS.git\n branch = feature/tervikdokument\n" }, { "path": "Documentation/.gitignore", "content": "_build\n_master\n*.mo\n" }, { "path": "Documentation/Makefile", "content": "# This Makefile supports two different invocation \"modes\".\n#\n# The default mode, invoked via \"all\", \"pdf\", or \"html\", builds all of the\n# documentation with a few exceptions, putting PDF files into $(DESTDIR)/pdf\n# (_build/pdf by default) and HTML files into $(DESTDIR)/html (_build/html by\n# default, \"all\" builds html only in development mode).\n#\n# Release mode, invoked via \"release\", builds only the release documents and\n# puts the PDF files, examples, and PDF diffs into a release hierarchy created\n# at $(DESTDIR) (_build/release by default).\n\n# Can be overridden from the command line.\nDESTDIR = _build\n\n# Build all Estonian and English documentation with a few exceptions.\nDOCS := $(wildcard internal/* public/* et/*)\nDOCS := $(filter-out et/example-config,$(DOCS)) # Does not contain reST.\nDOCS := $(filter-out internal/formal,$(DOCS)) # Does not contain reST.\nDOCS := $(filter-out internal/ivxv-pyapi,$(DOCS)) # Too many Python dependencies.\nDOCS := $(filter-out internal/entroopia,$(DOCS)) # Does not have a Makefile?\nDOCS := $(filter-out internal/stresstesting,$(DOCS)) # Does not have a Makefile?\n\nPDFDOCS := $(DOCS:%=pdf-%)\nDIFFDOCS := $(DOCS:%=diff-%)\nHTMLDOCS := $(DOCS:%=html-%)\n\n.PHONY: all\nall: release\n\n.PHONY: pdf\npdf: $(PDFDOCS)\n\t$(MAKE) -C public/arhitektuur install-en-pdf DESTDIR=$(abspath $(DESTDIR)/pdf)\n\t$(MAKE) -C public/liidesed install-en-pdf DESTDIR=$(abspath $(DESTDIR)/pdf)\n\t$(MAKE) -C public/protokollid install-en-pdf DESTDIR=$(abspath $(DESTDIR)/pdf)\n\n.PHONY: $(PDFDOCS)\n$(PDFDOCS): pdf-%:\n\tmkdir -p $(DESTDIR)/pdf\n\t$(MAKE) -C $* install-pdf DESTDIR=$(abspath $(DESTDIR)/pdf)\n\n\n.PHONY: diff\ndiff: $(DIFFDOCS)\n\n.PHONY: $(DIFFDOCS)\n$(DIFFDOCS): diff-%:\n\tmkdir -p $(DESTDIR)/diff\n\t$(MAKE) -C $* install-diff DESTDIR=$(abspath $(DESTDIR)/diff)\n\n\n.PHONY: html\nhtml: $(HTMLDOCS)\n\n.PHONY: $(HTMLDOCS)\n$(HTMLDOCS): html-%:\n\tmkdir -p $(DESTDIR)/html/$(notdir $*) # Drop language prefix.\n\t$(MAKE) -C $* install-html DESTDIR=$(abspath $(DESTDIR)/html/$(notdir $*))\n\n\n# Rules for generating release documentation.\n\nRELEASE1 = \"$(abspath $(DESTDIR))/1. Ülddokumendid\"\nDOCS1ET := public/uldsisukord\n\nRELEASE2 = \"$(abspath $(DESTDIR))/2. Spetsifikatsioonid\"\nDOCS2ET := \\\n\tpublic/arhitektuur \\\n\tpublic/liidesed \\\n\tet/kasutusmall \\\n\tpublic/protokollid \\\n\tet/xteeteenus \\\n\tet/votmerakendus\nDOCS2EN := \\\n\tpublic/arhitektuur \\\n\tpublic/liidesed \\\n\tpublic/protokollid \\\n\ten/backendlogs\n\nRELEASE3 = \"$(abspath $(DESTDIR))/3. Juhendid\"\nDOCS3ET := \\\n\tet/haldusteenus \\\n\tet/kogumisteenuse_haldusjuhend \\\n\tet/seadistuste_koostejuhend \\\n\tet/audiitor\n\nRELEASE4 = \"$(abspath $(DESTDIR))/4. Näited\"\nDOCS4ET := \\\n\tet/example-config \\\n\tet/seadistuste_koostejuhend/config-examples/android-ios-config.json\n\nRELEASE5 = \"$(abspath $(DESTDIR))/5. Muudatused\"\n\nRELEASEDOCSET := $(patsubst %,release-et-%,$(DOCS1ET) $(DOCS2ET) $(DOCS3ET) $(DOCS4ET))\nRELEASEDOCSEN := $(patsubst %,release-en-%,$(DOCS1EN) $(DOCS2EN))\n\n# If releasing locally (i.e., no explicit DESTDIR is given), then use\n# _build/release. RELEASE[1-5] must be recursively expanded for this to work.\n$(RELEASEDOCSET): DESTDIR := $(DESTDIR)/release\n$(RELEASEDOCSEN): DESTDIR := $(DESTDIR)/release\n\n.PHONY: release\nrelease: $(RELEASEDOCSET) $(RELEASEDOCSEN)\n\n.PHONY: $(RELEASEDOCSET)\n$(DOCS1ET:%=release-et-%): release-et-%:\n\tmkdir -p $(RELEASE1)\n\t$(MAKE) -C $* install-pdf DESTDIR=$(RELEASE1)\n\tmkdir -p $(RELEASE5)\n\t$(MAKE) -C $* install-diff DESTDIR=$(RELEASE5)\n\n$(DOCS2ET:%=release-et-%): release-et-%:\n\tmkdir -p $(RELEASE2)\n\t$(MAKE) -C $* install-pdf DESTDIR=$(RELEASE2)\n\tmkdir -p $(RELEASE5)\n\t$(MAKE) -C $* install-diff DESTDIR=$(RELEASE5)\n\n$(DOCS3ET:%=release-et-%): release-et-%:\n\tmkdir -p $(RELEASE3)\n\t$(MAKE) -C $* install-pdf DESTDIR=$(RELEASE3)\n\tmkdir -p $(RELEASE5)\n\t$(MAKE) -C $* install-diff DESTDIR=$(RELEASE5)\n\n$(DOCS4ET:%=release-et-%): release-et-%:\n\tmkdir -p $(RELEASE4)\n\tcp --recursive --update $* $(RELEASE4)\n\n\n.PHONY: $(RELEASEDOCSEN)\n$(DOCS2EN:%=release-en-%): release-en-%:\n\tmkdir -p $(RELEASE2)\n\t$(MAKE) -C $* install-en-pdf DESTDIR=$(RELEASE2)\n\n\n# Cleanup.\n\n# DOCS already contains DOCS[1-3].\nCLEANDOCS := $(DOCS:%=clean-%)\n\n.PHONY: clean\nclean: $(CLEANDOCS)\n\t-git worktree remove --force _master\n\trm -rf $(DESTDIR) _master\n\tpy3clean .\n\n.PHONY: $(CLEANDOCS)\n$(CLEANDOCS): clean-%:\n\t$(MAKE) -C $* clean\n" }, { "path": "Documentation/_static/custom.css", "content": "/*\n * IVXV Internet voting framework\n *\n * Sphinx stylesheet for HTML documentation\n */\n\n.figure {\n background-color: rgba(128, 128, 128, 0.1);\n border: thin dotted gray;\n}\n\n.caption {\n border-bottom: thin solid gray;\n}\n\n/* Highlight target section */\n\n.section:target {\n background-color: rgba(220, 220, 255, 0.2);\n box-shadow: 0 0 10px 0 rgba(0, 0, 0, 0.2);\n padding: 10px 5px 5px 5px;\n}\n\n/*\n * vim:foldmethod=syntax:\n */\n" }, { "path": "Documentation/common/examples/id.rpc.vote.query.json", "content": "{\n \"id\": 0.0,\n \"method\": \"RPC.Vote\",\n \"params\": [\n {\n \"AuthMethod\": \"tls\",\n \"Choices\": \"0140.1\",\n \"SessionID\": \"ec3a0cab353d552952289f2c7ad52e27\",\n \"OS\": \"Operating System,2,0\",\n \"Type\": \"bdoc\",\n \"Vote\": \"UEsDBAoABgAAAAIAAAAbWltZXR5cGVhcHBsaWNhdGlv\\nbi92bmQuZX...\"\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/id.rpc.vote.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"Qualification\": {\n \"ocsp\": \"MIIFTAoBAKCCBUUwggVBBgkrBgEFBQcwAQEEggUyMIIFLjCB5qFMME...\",\n \"tspreg\": \"MIIDsAYJKoZIhvcNAQcCoIIDoTCCA50CAQMxCzAJBgUrDgMCGgQS...\"\n },\n \"SessionID\": \"ec3a0cab353d552952289f2c7ad52e27\",\n \"TestVote\": true,\n \"VoteID\": \"VM/cUIU4n7VjxpUx1fC00Q==\"\n }\n}\n" }, { "path": "Documentation/common/examples/id.rpc.voterchoices.query.json", "content": "{\n \"id\": 0.0,\n \"method\": \"RPC.VoterChoices\",\n \"params\": [\n {\n \"AuthMethod\": \"tls\",\n \"OS\": \"Operating System,2,0\"\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/id.rpc.voterchoices.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"Choices\": \"0140.1\",\n \"List\": \"ew0KICAgICAgICAgICAgIkVyYWtvbmQgMSI6IHsNCiAgICAgICAgICAgIC...\",\n \"SessionID\": \"ec3a0cab353d552952289f2c7ad52e27\",\n \"Voted\": true\n }\n}\n" }, { "path": "Documentation/common/examples/json.rpc.method.query.json", "content": "{\n \"id\": 0.0,\n \"method\": \"RPC.Method\",\n \"params\": [\n {\n \"MethodParam\": \"value\",\n \"SessionID\": \"ec3a0cab353d552952289f2c7ad52e27\"\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/json.rpc.method.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"ResultParam\": \"value\",\n \"SessionID\": \"ec3a0cab353d552952289f2c7ad52e27\"\n }\n}\n" }, { "path": "Documentation/common/examples/mid.rpc.authenticate.query.json", "content": "{\n \"id\": 0.0,\n \"method\": \"RPC.Authenticate\",\n \"params\": [\n {\n \"OS\": \"Operating System,2,0\",\n \"IDCode\": \"60001019906\",\n \"PhoneNo\": \"+37200000766\"\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/mid.rpc.authenticate.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"Challenge\": \"EtsTur4XV7xEGS9LBjHSfF9Cc5PQxtYW+YAOysRIt2r...\",\n \"SessionCode\": \"2127729011\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\",\n \"DataToken\": \"G1GTSqBSBKrzqReuKYrmFUFXWFPkisjJjdiZi6zqAnaK3OvrT2Qu6...\"\n }\n}\n" }, { "path": "Documentation/common/examples/mid.rpc.authenticatestatus.query.json", "content": "{\n \"id\": 0.0,\n \"method\": \"RPC.AuthenticateStatus\",\n \"params\": [\n {\n \"OS\": \"Operating System,2,0\",\n \"SessionCode\": \"2127729011\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\"\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/mid.rpc.authenticatestatus.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"AuthToken\": null,\n \"GivenName\": \"\",\n \"PersonalCode\": \"\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\",\n \"Status\": \"POLL\",\n \"Surname\": \"\"\n }\n}\n" }, { "path": "Documentation/common/examples/mid.rpc.authenticatestatus2.query.json", "content": "{\n \"id\": 0.0,\n \"method\": \"RPC.AuthenticateStatus\",\n \"params\": [\n {\n \"OS\": \"Operating System,2,0\",\n \"SessionCode\": \"2127729011\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\"\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/mid.rpc.authenticatestatus2.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"AuthToken\": \"G1RTZqBSBKrzqReuKYrmFUFXWFPvaxhJjdiZi6zqAnaK3OvrT2Qu6...\",\n \"GivenName\": \"MARY \\u00c4NN\",\n \"PersonalCode\": \"60001019906\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\",\n \"Status\": \"OK\",\n \"Surname\": \"O\\u2019CONNE\\u017d-\\u0160USLIK\"\n }\n}\n" }, { "path": "Documentation/common/examples/mid.rpc.getcertificate.query.json", "content": "{\n \"id\": 0.0,\n \"method\": \"RPC.GetCertificate\",\n \"params\": [\n {\n \"AuthMethod\": \"ticket\",\n \"AuthToken\": \"G1RTZqBSBKrzqReuKYrmFUFXWFPvaxhJjdiZi6zqAnaK3OvrT...\",\n \"DataToken\": \"G1GTSqBSBKrzqReuKYrmFUFXWFPkisjJjdiZi6zqAnaK3OvrT2Qu6...\",\n \"OS\": \"Operating System,2,0\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\"\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/mid.rpc.getcertificate.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"Certificate\": \"MIIEVjCCAz6gAwIBAgIQRfmbsIcpkQ9UhxScCwG6VDANBgkqhki...\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\"\n }\n}\n" }, { "path": "Documentation/common/examples/mid.rpc.sign.query.json", "content": "{\n \"id\": 0.0,\n \"method\": \"RPC.Sign\",\n \"params\": [\n {\n \"AuthMethod\": \"ticket\",\n \"AuthToken\": \"G1RTZqBSBKrzqReuKYrmFUFXWFPvaxhJjdiZi6zqAnaK3OvrT...\",\n \"DataToken\": \"G1GTSqBSBKrzqReuKYrmFUFXWFPkisjJjdiZi6zqAnaK3OvrT2Qu6...\",\n \"Hash\": \"9IBrA05ylt2StdjxKkSTYMW/rQXY3Vub4upzShdfEzo=\",\n \"HashType\": \"SHA256\",\n \"OS\": \"Operating System,2,0\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\"\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/mid.rpc.sign.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"SessionCode\": \"E663A711BB9447EAD82491F9372F4CA\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\"\n }\n}\n" }, { "path": "Documentation/common/examples/mid.rpc.signstatus.query.json", "content": "{\n \"id\": 0.0,\n \"method\": \"RPC.SignStatus\",\n \"params\": [\n {\n \"OS\": \"Operating System,2,0\",\n \"SessionCode\": \"E663A711BB9447EAD82491F9372F4CA\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\"\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/mid.rpc.signstatus.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\",\n \"Signature\": null,\n \"Status\": \"POLL\"\n }\n}\n" }, { "path": "Documentation/common/examples/mid.rpc.signstatus2.query.json", "content": "{\n \"id\": 0.0,\n \"method\": \"RPC.SignStatus\",\n \"params\": [\n {\n \"OS\": \"Operating System,2,0\",\n \"SessionCode\": \"E663A711BB9447EAD82491F9372F4CA\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\"\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/mid.rpc.signstatus2.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\",\n \"Signature\": \"MOj+8xQ9DmZPr/ItHlm0tHNMCuTgn6dT9jcXjPLf0+2sVjsS11jRI...\",\n \"Algorithm\": \"SHA256WithECEncryption\",\n \"Status\": \"OK\"\n }\n}\n" }, { "path": "Documentation/common/examples/mid.rpc.vote.query.json", "content": "{\n \"id\": 0.0,\n \"method\": \"RPC.Vote\",\n \"params\": [\n {\n \"AuthMethod\": \"ticket\",\n \"AuthToken\": \"G1RTZqBSBKrzqReuKYrmFUFXWFPvaxhJjdiZi6zqAnaK3OvrT...\",\n \"Choices\": \"0919.1\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\",\n \"OS\": \"Operating System,2,0\",\n \"Type\": \"bdoc\",\n \"Vote\": \"UEsDBAoAAAAAAAAAAACKIflFHwAAAB8AAAAIAAAAbWltZXR5cGVhcHB...\"\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/mid.rpc.vote.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"Qualification\": {\n \"ocsp\": \"MIIG7QoBAKCCBuYwggbiBgkrBgEFBQcwAQEEggbTMIIGzzCCASGhgY...\",\n \"tspreg\": \"MIIE0QYJKoZIhvcNAQcCoIIEwjCCBL4CAQMxDzANBglghkgBZQMEA...\"\n },\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\",\n \"TestVote\": true,\n \"VoteID\": \"dWf/HUQVqXili7BeX2JAZQ==\"\n }\n}\n" }, { "path": "Documentation/common/examples/mid.rpc.voterchoices.query.json", "content": "{\n \"id\": 0.0,\n \"method\": \"RPC.VoterChoices\",\n \"params\": [\n {\n \"AuthMethod\": \"ticket\",\n \"AuthToken\": \"G1RTZqBSBKrzqReuKYrmFUFXWFPvaxhJjdiZi6zqAnaK3OvrT...\",\n \"OS\": \"Operating System,2,0\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\"\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/mid.rpc.voterchoices.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"Choices\": \"0919.1\",\n \"List\": \"ew0KICAgICAgICAgICAgIsOca3Npa2thbmRpZGFhZGlkIjogew0KICAgIC...\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\",\n \"Voted\": true\n }\n}\n" }, { "path": "Documentation/common/examples/smartid.rpc.authenticate.query.json", "content": "{\n \"id\": 0.0,\n \"method\": \"RPC.Authenticate\",\n \"params\": [\n {\n \"OS\": \"Operating System,2,0\",\n \"XSmartIDAuth\": \"4wesTurtYW+66BjHSfF9CcAQEB56It2rW+11112018Reji==...\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\",\n \"Identifier\": \"60001019906\"\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/smartid.rpc.authenticate.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"XSmartIDAuth\": \"4wesTurtYW+66BjHSfF9CcAQEB56It2rW+11112018Reji==...\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\",\n \"SessionCode\": \"2127729011\",\n }\n}\n" }, { "path": "Documentation/common/examples/smartid.rpc.authenticatestatus.query.json", "content": "{\n \"id\": 0.0,\n \"method\": \"RPC.AuthenticateStatus\",\n \"params\": [\n {\n \"OS\": \"Operating System,2,0\",\n \"SessionCode\": \"2127729011\",\n \"XSmartIDAuth\": \"4wesTurtYW+66BjHSfF9CcAQEB56It2rW+11112018Reji==...\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\"\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/smartid.rpc.authenticatestatus.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"AuthToken\": null,\n \"DataToken\": null,\n \"GivenName\": \"\",\n \"PersonalCode\": \"\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\",\n \"XSmartIDAuth\": \"4wesTurtYW+66BjHSfF9CcAQEB56It2rW+11112018Reji==...\",\n \"Status\": \"POLL\",\n \"Surname\": \"\"\n }\n}\n" }, { "path": "Documentation/common/examples/smartid.rpc.authenticatestatus2.query.json", "content": "{\n \"id\": 0.0,\n \"method\": \"RPC.AuthenticateStatus\",\n \"params\": [\n {\n \"OS\": \"Operating System,2,0\",\n \"SessionCode\": \"2127729011\",\n \"XSmartIDAuth\": \"4wesTurtYW+66BjHSfF9CcAQEB56It2rW+11112018Reji==...\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\"\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/smartid.rpc.authenticatestatus2.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"AuthToken\": \"G1RTZqBSBKrzqReuKYrmFUFXWFPvaxhJjdiZi6zqAnaK3OvrT2Qu6...\",\n \"DataToken\": \"G1RTZqBSBKrzqReuKYrmFUFXWkajsdhaiuhdaksdj62vrT2Qu6...\",\n \"GivenName\": \"MARY \\u00c4NN\",\n \"PersonalCode\": \"60001019906\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\",\n \"Status\": \"OK\",\n \"Surname\": \"O\\u2019CONNE\\u017d-\\u0160USLIK\"\n }\n}\n" }, { "path": "Documentation/common/examples/smartid.rpc.challenge.query.json", "content": "{\n \"id\": 0.0,\n \"method\": \"RPC.Challenge\",\n \"params\": [\n {\n \"OS\": \"Operating System,2,0\",\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/smartid.rpc.challenge.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"Challenge\": \"EtsTur4XV7xEGS9LBjHSfF9Cc5PQxtYW+YAOysRIt2r...\",\n \"XSmartIDAuth\": \"4wesTurtYW+66BjHSfF9CcAQEB56It2rW+11112018Reji==...\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\"\n }\n}\n" }, { "path": "Documentation/common/examples/smartid.rpc.getcertificatechoice.query.json", "content": "{\n \"id\": 0.0,\n \"method\": \"RPC.GetCertificateChoice\",\n \"params\": [\n {\n \"AuthMethod\": \"ticket\",\n \"AuthToken\": \"G1RTZqBSBKrzqReuKYrmFUFXWFPvaxhJjdiZi6zqAnaK3OvrT...\",\n \"DataToken\": \"G1RTZqBSBKrzqReuKYrmFUFXWkajsdhaiuhdaksdj62vrT2Qu6...\",\n \"OS\": \"Operating System,2,0\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\"\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/smartid.rpc.getcertificatechoice.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\",\n \"SessionCode\": \"2127729011\"\n }\n}\n" }, { "path": "Documentation/common/examples/smartid.rpc.getcertificatechoicestatus.query.json", "content": "{\n \"id\": 0.0,\n \"method\": \"RPC.GetCertificateChoiceStatus\",\n \"params\": [\n {\n \"SessionCode\": \"2127729011\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\",\n \"OS\": \"Operating System,2,0\"\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/smartid.rpc.getcertificatechoicestatus.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"Certificate\": null,\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\",\n \"Status\": \"POLL\"\n }\n}\n" }, { "path": "Documentation/common/examples/smartid.rpc.getcertificatechoicestatus2.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"Certificate\": \"MIIEVjCCAz6gAwIBAgIQRfmbsIcpkQ9UhxScCwG6VDANBgkqhki...\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\",\n \"Status\": \"OK\"\n }\n}\n" }, { "path": "Documentation/common/examples/smartid.rpc.sign.query.json", "content": "{\n \"id\": 0.0,\n \"method\": \"RPC.Sign\",\n \"params\": [\n {\n \"AuthMethod\": \"ticket\",\n \"AuthToken\": \"G1RTZqBSBKrzqReuKYrmFUFXWFPvaxhJjdiZi6zqAnaK3OvrT...\",\n \"DataToken\": \"G1RTZqBSBKrzqReuKYrmFUFXWkajsdhaiuhdaksdj62vrT2Qu6...\",\n \"Hash\": \"9IBrA05ylt2StdjxKkSTYMW/rQXY3Vub4upzShdfEzo=\",\n \"HashType\": \"SHA256\",\n \"OS\": \"Operating System,2,0\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\"\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/smartid.rpc.sign.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"SessionCode\": \"E663A711BB9447EAD82491F9372F4CA\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\"\n }\n}\n" }, { "path": "Documentation/common/examples/smartid.rpc.signstatus.query.json", "content": "{\n \"id\": 0.0,\n \"method\": \"RPC.SignStatus\",\n \"params\": [\n {\n \"OS\": \"Operating System,2,0\",\n \"SessionCode\": \"E663A711BB9447EAD82491F9372F4CA\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\"\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/smartid.rpc.signstatus.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\",\n \"Signature\": null,\n \"Status\": \"POLL\"\n }\n}\n" }, { "path": "Documentation/common/examples/smartid.rpc.signstatus2.query.json", "content": "{\n \"id\": 0.0,\n \"method\": \"RPC.SignStatus\",\n \"params\": [\n {\n \"OS\": \"Operating System,2,0\",\n \"SessionCode\": \"E663A711BB9447EAD82491F9372F4CA\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\"\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/smartid.rpc.signstatus2.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\",\n \"Signature\": \"MOj+8xQ9DmZPr/ItHlm0tHNMCuTgn6dT9jcXjPLf0+2sVjsS11jRI...\",\n \"Algorithm\": \"sha256WithRSAEncryption\",\n \"Status\": \"OK\"\n }\n}\n" }, { "path": "Documentation/common/examples/smartid.rpc.vote.query.json", "content": "{\n \"id\": 0.0,\n \"method\": \"RPC.Vote\",\n \"params\": [\n {\n \"AuthMethod\": \"ticket\",\n \"AuthToken\": \"G1RTZqBSBKrzqReuKYrmFUFXWFPvaxhJjdiZi6zqAnaK3OvrT...\",\n \"Choices\": \"0919.1\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\",\n \"OS\": \"Operating System,2,0\",\n \"Type\": \"bdoc\",\n \"Vote\": \"UEsDBAoAAAAAAAAAAACKIflFHwAAAB8AAAAIAAAAbWltZXR5cGVhcHB...\"\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/smartid.rpc.vote.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"Qualification\": {\n \"ocsp\": \"MIIG7QoBAKCCBuYwggbiBgkrBgEFBQcwAQEEggbTMIIGzzCCASGhgY...\",\n \"tspreg\": \"MIIE0QYJKoZIhvcNAQcCoIIEwjCCBL4CAQMxDzANBglghkgBZQMEA...\"\n },\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\",\n \"TestVote\": true,\n \"VoteID\": \"dWf/HUQVqXili7BeX2JAZQ==\"\n }\n}\n" }, { "path": "Documentation/common/examples/smartid.rpc.voterchoices.query.json", "content": "{\n \"id\": 0.0,\n \"method\": \"RPC.VoterChoices\",\n \"params\": [\n {\n \"AuthMethod\": \"ticket\",\n \"AuthToken\": \"G1RTZqBSBKrzqReuKYrmFUFXWFPvaxhJjdiZi6zqAnaK3OvrT...\",\n \"OS\": \"Operating System,2,0\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\"\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/smartid.rpc.voterchoices.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"Choices\": \"0919.1\",\n \"List\": \"ew0KICAgICAgICAgICAgIsOca3Npa2thbmRpZGFhZGlkIjogew0KICAgIC...\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\",\n \"Voted\": true\n }\n}\n" }, { "path": "Documentation/common/examples/ver.rpc.verify.query.json", "content": "{\n \"id\": 1,\n \"method\": \"RPC.Verify\",\n \"params\": [\n {\n \"OS\": \"Operating System,2,0\",\n \"SessionID\": \"ec3a0cab353d552952289f2c7ad52e27\",\n \"VoteID\": \"VM/cUIU4n7VjxpUx1fC00Q==\"\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/ver.rpc.verify.response.json", "content": "{\n \"error\": null,\n \"id\": 1,\n \"result\": {\n \"Qualification\": {\n \"ocsp\": \"MIIG8woBAKCCBuwwggboBgkrBgEFBQcwAQEEggbZMIIG1TCCASehgY...\",\n \"tspreg\": \"MIIE0QYJKoZIhvcNAQcCoIIEwjCCBL4CAQMxDzANBglghkgBDQEJE...\"\n },\n \"SessionID\": \"027ab451969d9d3f044ea2cb2675b503\",\n \"Type\": \"bdoc\",\n \"Vote\": \"UEsDBAoAAAAAAAAAAACKIflFHwAAAB8AAAAIAAAAbWltZXR5cGVhcHB...\",\n \"ChoicesList\": \"ew0KICAgICAgICAgICAgIkVyYWtvbmQgMSI6IHsNCiAgICAgICAgICAgIC...\"\n }\n}\n" }, { "path": "Documentation/common/examples/votesorder.rpc.votes.query.json", "content": "{\n \"id\": 0.0,\n \"method\": \"RPC.Votes\",\n \"params\": [\n {\n \"VotesFrom\": 1,\n \"BatchMaxSize\": 1000\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/votesorder.rpc.votes.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\",\n \"batchRecords\": [\n {\n \"seqNo\": 1,\n \"idCode\": \"37123097845\",\n \"voterName\": \"NIMI NIMESTE1\",\n \"kovCode\": \"0123\",\n \"electoralDistrictNo\": 1\n },\n {\n \"seqNo\": 2,\n \"idCode\": \"37123097653\",\n \"voterName\": \"NIMI NIMESTE2\",\n \"kovCode\": \"0444\",\n \"electoralDistrictNo\": 1\n }\n ]\n }\n}\n" }, { "path": "Documentation/common/examples/votesorder.rpc.votesseqno.query.json", "content": "{\n \"id\": 0.0,\n \"method\": \"RPC.VotesSeqNo\",\n \"params\": [\n {\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/votesorder.rpc.votesseqno.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\",\n \"SeqNo\": 10\n }\n}\n" }, { "path": "Documentation/common/examples/webeid.rpc.challenge.query.json", "content": "{\n \"id\": 0.0,\n \"method\": \"RPC.Challenge\",\n \"params\": [\n {\n \"OS\": \"Operating System,2,0\"\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/webeid.rpc.challenge.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"Challenge\": \"EtsTur4XV7xEGS9LBjHSfF9Cc5PQxtYW+YAOysRIt2r...\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\",\n \"Bearer\": \"xtYW+YAOyXV7xEGS9YWxtYW+YAOtsTur4XV7xEGS9LB1...\"\n }\n}\n" }, { "path": "Documentation/common/examples/webeid.rpc.token.query.json", "content": "{\n \"id\": 0.0,\n \"method\": \"RPC.Token\",\n \"params\": [\n {\n \"OS\": \"Operating System,2,0\",\n \"Token\": \"{\\\"unverifiedCertificate\":\"MIICnDCCA...\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\",\n \"Bearer\": \"xtYW+YAOyXV7xEGS9YWxtYW+YAOtsTur4XV7xEGS9LB1...\"\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/webeid.rpc.token.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"AuthToken\": \"G1RTZqBSBKrzqReuKYrmFUFXWFPvaxhJjdiZi6zqAnaK3OvrT2Qu6...\",\n \"GivenName\": \"MARY \\u00c4NN\",\n \"PersonalCode\": \"60001019906\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\",\n \"Status\": \"OK\",\n \"Surname\": \"O\\u2019CONNE\\u017d-\\u0160USLIK\"\n }\n}\n" }, { "path": "Documentation/common/examples/webeid.rpc.vote.query.json", "content": "{\n \"id\": 0.0,\n \"method\": \"RPC.Vote\",\n \"params\": [\n {\n \"AuthMethod\": \"ticket\",\n \"AuthToken\": \"G1RTZqBSBKrzqReuKYrmFUFXWFPvaxhJjdiZi6zqAnaK3OvrT...\",\n \"Choices\": \"0919.1\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\",\n \"OS\": \"Operating System,2,0\",\n \"Type\": \"bdoc\",\n \"Vote\": \"UEsDBAoAAAAAAAAAAACKIflFHwAAAB8AAAAIAAAAbWltZXR5cGVhcHB...\"\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/webeid.rpc.vote.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"Qualification\": {\n \"ocsp\": \"MIIG7QoBAKCCBuYwggbiBgkrBgEFBQcwAQEEggbTMIIGzzCCASGhgY...\",\n \"tspreg\": \"MIIE0QYJKoZIhvcNAQcCoIIEwjCCBL4CAQMxDzANBglghkgBZQMEA...\"\n },\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\",\n \"TestVote\": true,\n \"VoteID\": \"dWf/HUQVqXili7BeX2JAZQ==\"\n }\n}\n" }, { "path": "Documentation/common/examples/webeid.rpc.voterchoices.query.json", "content": "{\n \"id\": 0.0,\n \"method\": \"RPC.VoterChoices\",\n \"params\": [\n {\n \"AuthMethod\": \"ticket\",\n \"AuthToken\": \"G1RTZqBSBKrzqReuKYrmFUFXWFPvaxhJjdiZi6zqAnaK3OvrT...\",\n \"OS\": \"Operating System,2,0\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\"\n }\n ]\n}\n" }, { "path": "Documentation/common/examples/webeid.rpc.voterchoices.response.json", "content": "{\n \"error\": null,\n \"id\": 0.0,\n \"result\": {\n \"Choices\": \"0919.1\",\n \"List\": \"ew0KICAgICAgICAgICAgIsOca3Npa2thbmRpZGFhZGlkIjogew0KICAgIC...\",\n \"SessionID\": \"057229fdfa2df7d3c7f4ced81b02760b\",\n \"Voted\": true\n }\n}\n" }, { "path": "Documentation/common/schema/Makefile", "content": ".PHONY: validate\nvalidate:\n\tpython3 validate_schema.py\n" }, { "path": "Documentation/common/schema/ivxv.anon-bb.schema", "content": "{\n \"$schema\": \"http://json-schema.org/draft-04/schema#\",\n \"definitions\": {\n \"results\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n },\n \"additionalItems\": false\n },\n \"questions\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"$ref\": \"#/definitions/results\"\n },\n \"minProperties\": 1\n },\n \"parish\": {\n \"type\": \"object\",\n \"patternProperties\": {\n \"^[0-9]{4}$|^(FOREIGN)$\": {\n \"$ref\": \"#/definitions/questions\"\n }\n },\n \"additionalProperties\": false,\n \"minProperties\": 1\n },\n \"districts\": {\n \"type\": \"object\",\n \"patternProperties\": {\n \"^[0-9]{4}\\\\.[0-9]{1,2}$\": {\n \"$ref\": \"#/definitions/parish\"\n }\n },\n \"additionalProperties\": false,\n \"minProperties\": 1\n }\n },\n \"type\": \"object\",\n \"properties\": {\n \"election\": {\n \"type\": \"string\"\n },\n \"districts\": {\n \"$ref\": \"#/definitions/districts\"\n }\n },\n \"required\": [\n \"election\",\n \"districts\"\n ],\n \"additionalProperties\": false\n}\n" }, { "path": "Documentation/common/schema/ivxv.anon-bb.schema.example", "content": "{\n \"election\": \"TESTKOV\",\n \"districts\": {\n \"0164.1\": {\n \"0164\": {\n \"TESTKOV.1\": [\n \"MDkxOS4xMDUK\",\n \"MDkxOS4xMDQK\",\n \"MDkxOS4xMDEK\",\n \"MDkxOS4xMDMK\"\n ]\n }\n },\n \"0296.1\": {\n \"0296\": {\n \"TESTKOV.1\": [\n \"MDkxOS4xMDQK\",\n \"MDkxOS4xMDQK\"\n ]\n }\n }\n }\n}\n" }, { "path": "Documentation/common/schema/ivxv.choices.schema", "content": "{\n \"$schema\": \"http://json-schema.org/draft-04/schema#\",\n \"definitions\": {\n \"choice\": {\n \"type\": \"string\",\n \"description\": \"Candidate's name in case of RK, EP, KOV. Possible answer in case of RH\"\n },\n \"list_choices\": {\n \"type\": \"object\",\n \"patternProperties\": {\n \"^[0-9]{4}\\\\.[0-9]{3,4}$\": {\n \"$ref\": \"#/definitions/choice\"\n }\n },\n \"additionalProperties\": false,\n \"minProperties\": 1\n },\n \"district_choices\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"$ref\": \"#/definitions/list_choices\"\n },\n \"minProperties\": 1,\n \"description\": \"Political unions and independent candidates in district, in case of RH - question\"\n },\n \"district_dict\": {\n \"type\": \"object\",\n \"patternProperties\": {\n \"^[0-9]{4}\\\\.[0-9]{1,2}$\": {\n \"$ref\": \"#/definitions/district_choices\"\n }\n },\n \"additionalProperties\": false,\n \"minProperties\": 1\n }\n },\n \"type\": \"object\",\n \"properties\": {\n \"election\": {\n \"type\": \"string\",\n \"pattern\": \"^[ \\\\-,\\\\+\\\\.:;=!?&%#<>_/\\\\'\\\\*()\\\\[\\\\]{}|^A-Za-z0-9]{1,28}$\"\n },\n \"choices\": {\n \"$ref\": \"#/definitions/district_dict\"\n }\n },\n \"required\": [\n \"election\",\n \"choices\"\n ],\n \"additionalProperties\": false\n}\n" }, { "path": "Documentation/common/schema/ivxv.choices.schema.example", "content": "{\n \"choices\": {\n \"0164.1\": {\n \"Nimi Valimisliit\": {\n \"0164.126\": \"Nimi Kandidaat\",\n \"0164.127\": \"Nimi Kandidaat\"\n }\n },\n \"0296.1\": {\n \"Nimi Erakond\": {\n \"0296.198\": \"Nimi Kandidaat\",\n \"0296.199\": \"Nimi Kandidaat\",\n \"0296.200\": \"Nimi Kandidaat\"\n },\n \"Nimi Valimisliit\": {\n \"0296.115\": \"Nimi Kandidaat\",\n \"0296.116\": \"Nimi Kandidaat\",\n \"0296.117\": \"Nimi Kandidaat\"\n },\n \"Üksikkandidaadid\": {\n \"0296.101\": \"Nimi Kandidaat\",\n \"0296.102\": \"Nimi Kandidaat\"\n }\n }\n },\n \"election\": \"TESTKOV\"\n}\n" }, { "path": "Documentation/common/schema/ivxv.districts.schema", "content": "{\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\n \"definitions\": {\n \"region\": {\n \"type\": \"object\",\n \"properties\": {\n \"state\": {\n \"type\": \"string\"\n },\n \"county\": {\n \"type\": \"string\"\n },\n \"parish\": {\n \"type\": \"string\"\n }\n },\n \"additionalProperties\": false,\n \"minProperties\": 1,\n \"description\": \"Value - parish - is absent in case of Tallinn and Tartu cities as they are marked as counties. Parish represents city district in case of Tallinn. Parish and county are absent in case of Välisriik and RK, EP and RH elections\"\n },\n \"region_dict\": {\n \"type\": \"object\",\n \"patternProperties\": {\n \"^[0-9]{4}$\": {\n \"$ref\": \"#/definitions/region\"\n }\n },\n \"additionalProperties\": false,\n \"minProperties\": 1,\n \"description\": \"Parishes EHAK code; city district code in case of Tallinn; 0000 for foreign state in case of RK, EP and RH elections\"\n },\n \"parish\": {\n \"type\": \"string\",\n \"pattern\": \"^[0-9]{4}$\",\n \"description\": \"Parishes in election district of county. 0000 value in represents foreign state in case of RK, EP and RH elections for each election district in districts block\"\n },\n \"district\": {\n \"type\": \"object\",\n \"properties\": {\n \"name\": {\n \"type\": \"string\"\n },\n \"parish\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/definitions/parish\"\n }\n }\n },\n \"required\": [\n \"parish\"\n ],\n \"description\": \"Object includes parishes or city districts that belong to this election district\"\n },\n \"district_dict\": {\n \"type\": \"object\",\n \"patternProperties\": {\n \"^[0-9]{4}.[0-9]{1,2}$\": {\n \"$ref\": \"#/definitions/district\"\n }\n },\n \"additionalProperties\": false,\n \"minProperties\": 1\n },\n \"counties\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/definitions/parish\"\n },\n \"description\": \"Object includes parishes or city districts that belong into this election district\",\n \"additionalProperties\": false,\n \"minProperties\": 1\n },\n \"county_dict\": {\n \"type\": \"object\",\n \"patternProperties\": {\n \"^[0-9]{4}$\": {\n \"$ref\": \"#/definitions/counties\"\n }\n },\n \"description\": \"Object contains parishes or city districts inside county. Tallinn is defined as county and contains city districts, Tartu linn is both county and parish\",\n \"additionalProperties\": false,\n \"minProperties\": 1\n }\n },\n \"type\": \"object\",\n \"properties\": {\n \"election\": {\n \"type\": \"string\",\n \"pattern\": \"^[ \\\\-,\\\\+\\\\.:;=!?&%#<>_/\\\\'\\\\*()\\\\[\\\\]{}|^A-Za-z0-9]{1,28}$\"\n },\n \"districts\": {\n \"$ref\": \"#/definitions/district_dict\"\n },\n \"regions\": {\n \"$ref\": \"#/definitions/region_dict\"\n },\n \"counties\": {\n \"$ref\": \"#/definitions/county_dict\"\n }\n },\n \"required\": [\n \"districts\",\n \"regions\",\n \"counties\",\n \"election\"\n ],\n \"additionalProperties\": false\n}\n" }, { "path": "Documentation/common/schema/ivxv.districts.schema.example", "content": "{\n \"election\": \"KOV2034\",\n \"regions\": {\n \"0809\": {\n \"parish\": \"Tori vald\",\n \"county\": \"Pärnu maakond\",\n \"state\": \"Eesti Vabariik\"\n },\n \"0624\": {\n \"parish\": \"Pärnu linn\",\n \"county\": \"Pärnu maakond\",\n \"state\": \"Eesti Vabariik\"\n },\n \"0524\": {\n \"parish\": \"Nõmme linnaosa\",\n \"county\": \"Tallinn\",\n \"state\": \"Eesti Vabariik\"\n },\n \"0784\": {\n \"county\": \"Tallinn\",\n \"state\": \"Eesti Vabariik\"\n },\n \"0796\": {\n \"parish\": \"Tartu vald\",\n \"county\": \"Tartu maakond\",\n \"state\": \"Eesti Vabariik\"\n },\n \"0793\": {\n \"county\": \"Tartu linn\",\n \"state\": \"Eesti Vabariik\"\n }\n },\n \"districts\": {\n \"0809.1\": {\n \"name\": \"Valimisringkond nr. 1\",\n \"parish\": [\n \"0809\"\n ]\n },\n \"0809.2\": {\n \"name\": \"Valimisringkond nr. 2\",\n \"parish\": [\n \"0809\"\n ]\n },\n \"0624.1\": {\n \"name\": \"Valimisringkond nr. 1\",\n \"parish\": [\n \"0624\"\n ]\n },\n \"0784.6\": {\n \"name\": \"Valimisringkond nr. 6\",\n \"parish\": [\n \"0524\"\n ]\n },\n \"0796.1\": {\n \"name\": \"Valimisringkond nr. 1\",\n \"parish\": [\n \"0796\"\n ]\n },\n \"0793.1\": {\n \"name\": \"Valimisringkond nr. 1\",\n \"parish\": [\n \"0793\"\n ]\n }\n },\n \"counties\": {\n \"0068\": [\n \"0809\",\n \"0624\"\n ],\n \"0784\": [\n \"0524\"\n ],\n \"0079\": [\n \"0796\"\n ],\n \"0793\": [\n \"0793\"\n ]\n }\n}\n" }, { "path": "Documentation/common/schema/ivxv.result.schema", "content": "{\n \"$schema\": \"http://json-schema.org/draft-04/schema#\",\n \"definitions\": {\n \"results\": {\n \"type\": \"object\",\n \"properties\": {\n \"invalid\": {\n \"type\": \"integer\",\n \"description\": \"Number of invalid votes\"\n }\n },\n \"patternProperties\": {\n \"^[0-9]{4}\\\\.[0-9]{3,4}$\": {\n \"type\": \"integer\"\n }\n },\n \"additionalProperties\": false,\n \"required\": [\n \"invalid\"\n ]\n },\n \"parish\": {\n \"type\": \"object\",\n \"patternProperties\": {\n \"^[0-9]{4}$\": {\n \"$ref\": \"#/definitions/results\"\n }\n },\n \"additionalProperties\": false,\n \"minProperties\": 1\n },\n \"district_dict\": {\n \"type\": \"object\",\n \"patternProperties\": {\n \"^[0-9]{4}\\\\.[0-9]{1,2}$\": {\n \"$ref\": \"#/definitions/results\"\n }\n },\n \"additionalProperties\": false,\n \"minProperties\": 1\n },\n \"parish_dict\": {\n \"type\": \"object\",\n \"patternProperties\": {\n \"^[0-9]{4}\\\\.[0-9]{1,2}$\": {\n \"$ref\": \"#/definitions/parish\"\n }\n },\n \"additionalProperties\": false,\n \"minProperties\": 1\n }\n },\n \"type\": \"object\",\n \"properties\": {\n \"election\": {\n \"type\": \"string\",\n \"pattern\": \"^[ \\\\-,\\\\+\\\\.:;=!?&%#<>_/\\\\'\\\\*()\\\\[\\\\]{}|^A-Za-z0-9]{1,28}$\"\n },\n \"bydistrict\": {\n \"$ref\": \"#/definitions/district_dict\"\n },\n \"byparish\": {\n \"$ref\": \"#/definitions/parish_dict\"\n }\n },\n \"required\": [\"election\", \"bydistrict\", \"byparish\"],\n \"additionalProperties\": false\n}\n" }, { "path": "Documentation/common/schema/ivxv.result.schema.example", "content": "{\n \"bydistrict\": {\n \"0164.1\": {\n \"0164.126\": 0,\n \"0164.127\": 0,\n \"invalid\": 0\n },\n \"0296.1\": {\n \"0296.101\": 0,\n \"0296.102\": 0,\n \"0296.115\": 0,\n \"0296.116\": 0,\n \"0296.117\": 0,\n \"0296.198\": 0,\n \"0296.199\": 0,\n \"0296.200\": 0,\n \"invalid\": 0\n }\n },\n \"byparish\": {\n \"0164.1\": {\n \"0164\": {\n \"0164.126\": 0,\n \"0164.127\": 0,\n \"invalid\": 0\n }\n },\n \"0296.1\": {\n \"0296\": {\n \"0296.101\": 0,\n \"0296.102\": 0,\n \"0296.115\": 0,\n \"0296.116\": 0,\n \"0296.117\": 0,\n \"0296.198\": 0,\n \"0296.199\": 0,\n \"0296.200\": 0,\n \"invalid\": 0\n },\n \"0296\": {\n \"0296.101\": 0,\n \"0296.102\": 0,\n \"0296.115\": 0,\n \"0296.116\": 0,\n \"0296.117\": 0,\n \"0296.198\": 0,\n \"0296.199\": 0,\n \"0296.200\": 0,\n \"invalid\": 0\n }\n }\n },\n \"election\": \"TESTKOV\"\n}\n" }, { "path": "Documentation/common/schema/ivxv.revoke.schema", "content": "{\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\n \"definitions\": {\n \"rev_entry\": {\n \"type\": \"string\",\n \"pattern\": \"^[0-9]{11}$\",\n \"description\": \"Personal code of onlinevoter to be revoked\"\n }\n },\n \"type\": \"object\",\n \"properties\": {\n \"election\": {\n \"type\": \"string\",\n \"pattern\": \"^[ \\\\-,\\\\+\\\\.:;=!?&%#<>_/\\\\'\\\\*()\\\\[\\\\]{}|^A-Za-z0-9]{1,28}$\"\n },\n \"type\": {\"enum\": [\"revoke\", \"restore\"]},\n \"persons\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/definitions/rev_entry\"\n }\n }\n },\n \"required\": [\n \"election\",\n \"persons\",\n \"type\"\n ],\n \"additionalProperties\": false\n}\n" }, { "path": "Documentation/common/schema/ivxv.revoke.schema.example", "content": "{\n \"election\": \"TESTKOV\",\n \"persons\": [\n \"11412090004\",\n \"11412090005\",\n \"11412090006\"\n ],\n \"type\": \"revoke\"\n}\n" }, { "path": "Documentation/common/schema/ivxv.voterlist.schema", "content": "{\n \"$schema\": \"http://json-schema.org/draft-04/schema#\",\n \"definitions\": {\n \"onlinevoters_entry\": {\n \"type\": \"string\",\n \"pattern\": \"^[0-9]{11}$\",\n \"additionalItems\": false\n },\n\n \"onlinevoters\": {\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/definitions/onlinevoters_entry\"\n },\n \"additionalItems\": false\n },\n\n \"parish\": {\n \"type\": \"object\",\n \"patternProperties\": {\n \"^[0-9]{4}$\": {\n \"$ref\": \"#/definitions/onlinevoters\"\n }\n },\n \"additionalProperties\": false,\n \"minProperties\": 1\n },\n\n \"districts\": {\n \"type\": \"object\",\n \"patternProperties\": {\n \"^[0-9]{4}\\\\.[0-9]{1,2}$\": {\n \"$ref\": \"#/definitions/parish\"\n }\n },\n \"additionalProperties\": false,\n \"minProperties\": 1\n }\n },\n \"type\": \"object\",\n \"properties\": {\n \"election\": {\n \"type\": \"string\",\n \"pattern\": \"^[ \\\\-,\\\\+\\\\.:;=!?&%#<>_/\\\\'\\\\*()\\\\[\\\\]{}|^A-Za-z0-9]{1,28}$\"\n },\n \"onlinevoters\": {\n \"$ref\": \"#/definitions/districts\"\n }\n },\n \"required\": [\n \"election\",\n \"onlinevoters\"\n ],\n \"additionalProperties\": false\n}\n" }, { "path": "Documentation/common/schema/ivxv.voterlist.schema.example", "content": "{\n \"election\": \"RK2030\",\n \"onlinevoters\": {\n \"0000.1\": {\n \"0176\": [\n \"11412090001\"\n ],\n \"0339\": [\n \"11412090002\",\n \"11412090003\"\n ],\n \"0614\": [\n \"11412090004\"\n ],\n \"0000\": [\n \"11412090005\"\n ]\n },\n \"0000.10\": {\n \"0793\": [\n \"11412090006\",\n \"11412090007\",\n \"11412090008\"\n ],\n \"0000\": [\n \"11412090009\"\n ]\n }\n }\n}\n" }, { "path": "Documentation/common/schema/validate_schema.py", "content": "# IVXV Internet voting framework\n\"\"\"Validate jsonschema example files.\"\"\"\n\nimport json\nimport logging\nimport os\nimport sys\n\nimport jsonschema\n\nlog = logging.getLogger()\nlogging.basicConfig(level=logging.INFO)\n\n\ndef main():\n \"\"\"Main routine.\"\"\"\n for schema_filename in sorted(os.listdir(\".\")):\n if schema_filename.endswith(\".schema\"):\n log.info(\"Loading schema %s\", schema_filename)\n with open(schema_filename) as fd:\n schema = json.load(fd)\n log.info(\"Schema file %s is valid\", schema_filename)\n\n example_filename = f\"{schema_filename}.example\"\n log.info(\"Validating file %s\", example_filename)\n with open(example_filename) as fd:\n example = json.load(fd)\n\n try:\n jsonschema.validate(instance=example, schema=schema)\n except jsonschema.exceptions.ValidationError as err:\n log.error(\n \"Schema validation error while validating %r: %s\",\n example_filename,\n err,\n )\n return 1\n log.info(\"File %s is valid\", example_filename)\n\n return 0\n\n\nif __name__ == \"__main__\":\n sys.exit(main())\n" }, { "path": "Documentation/common/xmltemplates/si.template", "content": "\n \n \n \n \n %VOTE_DIGEST%\n \n \n \n \n \n \n %SP_DIGEST%\n \n\n" }, { "path": "Documentation/common/xmltemplates/sig.template", "content": "\n\n \n %SI_XML%\n %SV_XML%\n \n \n %X509_CERT%\n \n \n \n \n %SP_XML%\n \n \n \n\n" }, { "path": "Documentation/common/xmltemplates/sp.template", "content": "\n\n %SIGNING_TIME%\n \n \n \n \n %CERT_DIGEST%\n \n \n %ISSUER_NAME%\n %ISSUER_SERIAL%\n \n \n \n\n\n \n application/octet-stream\n \n\n\n" }, { "path": "Documentation/common/xmltemplates/sv.template", "content": "%SIG_VALUE%\n" }, { "path": "Documentation/common-model.mk", "content": "PLANTUML=env -u DISPLAY plantuml\nPLANTUML_EN=env -u DISPLAY plantuml -I./en/lang.pu\nPLANTUML_ET=env -u DISPLAY plantuml -I./et/lang.pu\n\nLANGUAGES=et en\n\nDIAGRAMS=$(SRC_DIAG) $(SUB_DIAG)\n\n# We process each diagram in all languages, so that the variables are set properly\nTARGETS=$(foreach DIAGRAM,$(DIAGRAMS),$(patsubst %, img/$(DIAGRAM).%.png, $(LANGUAGES)))\n\nall:\n\t@echo \"Dry run, make model to apply changes\"\n\t$(MAKE) -n model\n\nmodel: $(TARGETS)\n\n# Process manually translated diagrams\nimg/%.png: %.pu\n\t$(PLANTUML) $<\n\tmv $*.png $@\n\n\n# Process source diagrams\nimg/%.et.png: %.pu\n\t$(PLANTUML_ET) $<\n\tmv $*.png $@\n\nimg/%.en.png: %.pu\n\t$(PLANTUML_EN) $<\n\tmv $*.png $@\n\n\n# Process sub-diagrams of major diagram\nimg/%.et.png: $(PARENT).pu %.env\n\t$(PLANTUML_ET) $(DIAGRAM_DEF) $<\n\tmv $(PARENT).png $@\n\nimg/%.en.png: $(PARENT).pu %.env\n\t$(PLANTUML_EN) $(DIAGRAM_DEF) $<\n\tmv $(PARENT).png $@\n" }, { "path": "Documentation/common.mk", "content": "# common.mk: Common recipes for Documentation.\n#\n# Defines a catch-all recipe which routes unknown targets to Sphinx in \"make\n# mode\". If $(DEPENDENCIES) is defined, then it will be set as a prerequisite\n# of the catch-all and removed on clean. In addition, if the source directory\n# contains a \"model\" subdirectory, then it invokes make in it to build and\n# clean that too.\n#\n# Defines a \"diff\" recipe which generates a PDF that highlights differences\n# between the current and latest released version of the document. If there are\n# no differences, then no PDF is produced.\n#\n# Defines \"install-pdf\", \"install-html\", and \"install-diff\" recipes which build\n# the specified type of documentation and install it to $(DESTDIR).\n\ncommon.mk := $(lastword $(MAKEFILE_LIST))\nMakefile := $(lastword $(filter-out $(common.mk),$(MAKEFILE_LIST)))\n\n# You can set these variables from the command line, and also\n# from the environment for the first two.\nSPHINXOPTS ?= -c $(dir $(common.mk))\nSPHINXBUILD ?= sphinx-build\nSOURCEDIR = $(dir $(Makefile))\nBUILDDIR = $(SOURCEDIR)_build\nSPHINXINTL ?= sphinx-intl\n\n# Set IVXV_DOCUMENT to the name of the source directory. This will be used as\n# the key to look up configuration from documents.py.\nexport IVXV_DOCUMENT := $(notdir $(patsubst %/,%,$(abspath $(SOURCEDIR))))\n\n# Special case the help target: set as default and skip prerequisites.\n.DEFAULT_GOAL := help\n.PHONY: help\nhelp:\n\t@$(SPHINXBUILD) -M help \"$(SOURCEDIR)\" \"$(BUILDDIR)\" $(SPHINXOPTS) $(O)\n\ntranslation-et:\n\t@$(SPHINXBUILD) -M gettext \"$(SOURCEDIR)\" \"$(BUILDDIR)\" $(SPHINXOPTS) $(O)\n\t@$(SPHINXINTL) update -p _build/gettext -l et\n\ntranslation:\n\t@$(SPHINXBUILD) -M gettext \"$(SOURCEDIR)\" \"$(BUILDDIR)\" $(SPHINXOPTS) $(O)\n\t@$(SPHINXINTL) update -p _build/gettext -l en\n\nspelling:\n\t@$(SPHINXBUILD) -M spelling \"$(SOURCEDIR)\" \"$(BUILDDIR)\" $(SPHINXOPTS) $(O)\n\nenglish: clean $(DEPENDENCIES)\n\texport SPHINXOPTS=\"-D language='en'\" && $(SPHINXBUILD) -M latexpdf \"$(SOURCEDIR)\" \"$(BUILDDIR)\" $(SPHINXOPTS) $(O)\n\nestonian: clean $(DEPENDENCIES)\n\t@$(SPHINXBUILD) -M latexpdf \"$(SOURCEDIR)\" \"$(BUILDDIR)\" $(SPHINXOPTS) $(O)\n\n\n# Special case the clean target: skip prerequisites and perform extra steps.\n.PHONY: clean\nclean:\n\t#if [ -d \"model\" ]; then $(MAKE) -C model clean; fi\n\t@$(SPHINXBUILD) -M clean \"$(SOURCEDIR)\" \"$(BUILDDIR)\" $(SPHINXOPTS) $(O)\n\trm -rf $(BUILDDIR) $(DEPENDENCIES)\n\n# Do not regenerate the Makefiles.\n$(common.mk) $(Makefile): ;\n\n# Catch-all target: route all unknown targets to Sphinx using the new\n# \"make mode\" option. $(O) is meant as a shortcut for $(SPHINXOPTS).\n%: $(DEPENDENCIES)\n\tif [ -d \"model\" ]; then $(MAKE) -C model; fi\n\t$(SPHINXBUILD) -M $@ \"$(SOURCEDIR)\" \"$(BUILDDIR)\" $(SPHINXOPTS) $(O)\n\n# Variables and rules for diffing.\ndiffer.sh := $(dir $(common.mk))differ.sh\nmaster := $(dir $(common.mk))_master/\ngitdir := $(patsubst $(shell git rev-parse --show-toplevel)%,%,$(abspath $(SOURCEDIR)))\nolddir := $(master)$(gitdir)\n\nifeq (\"$(olddir)\", \"../../_master//Documentation/public/protokollid\")\n\tolddir := \"../../_master//Documentation/et/protokollid\"\nendif\n\nifeq (\"$(olddir)\", \"../../_master//Documentation/public/uldsisukord\")\n\tolddir := \"../../_master//Documentation/et/uldsisukord\"\nendif\n\nifeq (\"$(olddir)\", \"../../_master//Documentation/public/arhitektuur\")\n\tolddir := \"../../_master//Documentation/et/arhitektuur\"\nendif\n\n.PHONY: diff\ndiff: latex master-latex\n\t# latexmk attempts to proceed even though errors may be present\n\t# pdflatex attempts to proceed with errors and is silent (batchmode)\n\tLATEXMKOPTS=\"-f -interaction=batchmode\" $(differ.sh) $(BUILDDIR)/master $(BUILDDIR)\n\n.PHONY: master-latex\nmaster-latex: $(master)\n\tif [ -d $(olddir) ]; then \\\n\t\t$(MAKE) -C $(olddir) BUILDDIR=$(abspath $(BUILDDIR))/master latex; \\\n\tfi\n\n$(master):\n\tgit worktree add $@ 1.9.10\n\n# Installation rules.\n.PHONY: install-pdf\ninstall-pdf: estonian\n\tcp --update $(filter-out %-diff.pdf,$(wildcard $(BUILDDIR)/latex/*.pdf)) \"$(DESTDIR)\"\n\n.PHONY: install-en-pdf\ninstall-en-pdf: english\n\tcp --update $(filter-out %-diff.pdf,$(wildcard $(BUILDDIR)/latex/*.pdf)) \"$(DESTDIR)\"\n\n.PHONY: install-html\ninstall-html: html\n\tcp --recursive --update $(BUILDDIR)/html/** \"$(DESTDIR)\"\n\n.PHONY: install-diff\ninstall-diff: diff\n\t$(eval diff.pdf = $(wildcard $(BUILDDIR)/latex/*-diff.pdf))\n\t$(if $(diff.pdf),cp --update $(diff.pdf) \"$(DESTDIR)\")\n" }, { "path": "Documentation/conf.py", "content": "# Configuration file for the Sphinx documentation builder.\n#\n# This file only contains a selection of the most common options. For a full\n# list see the documentation:\n# https://www.sphinx-doc.org/en/master/usage/configuration.html\n\n# -- Path setup --------------------------------------------------------------\n\n# If extensions (or modules to document with autodoc) are in another directory,\n# add these directories to sys.path here. If the directory is relative to the\n# documentation root, use os.path.abspath to make it absolute, like shown here.\n#\nimport os\nimport sys\nsys.path.insert(0, os.path.abspath('.'))\n\nimport documents\n\n# -- Project information -----------------------------------------------------\n\ndef detect_language():\n opts = os.environ.get('SPHINXOPTS')\n # expecting \"-D language='en'\"\n if opts is not None and 'en' in opts:\n return 'en'\n return 'et'\n\n\nlanguage = detect_language()\n\nproject = documents.project\ncopyright = documents.copyright\nauthor = documents.author\nrelease = documents.release\n\ndocument = os.environ['IVXV_DOCUMENT']\n\nversion = documents.get(document, 'version', language)\ntoday = documents.get(document, 'changed', language)\ndocument_prefix = documents.get(document, 'document_prefix', language)\ndocument_type = documents.get(document, 'document_type', language)\ndocument_title = documents.get(document, 'document_title', language)\ndocument_target_name = documents.get(document, 'document_target_name', language)\n\ndocument_number = f'{document_prefix}-{version}'\n\ntoday_fmt = \"%d.%m.%Y\"\n\nnumfig = True\nnumfig_format = {\n 'section': '{name} (ptk. {number})'\n}\n\n# sphinx-intl\nlocale_dirs = ['locales/']\ngettext_compact = False\n\n\n# -- General configuration ---------------------------------------------------\n\n# Add any Sphinx extension module names here, as strings. They can be\n# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom\n# ones.\nextensions = [\n 'sphinx.ext.autodoc',\n 'sphinx.ext.autosummary',\n 'sphinx.ext.imgmath',\n 'sphinx.ext.todo',\n 'sphinx_rtd_theme',\n 'sphinxcontrib.spelling',\n 'myst_parser',\n]\n\n\nspelling_lang='et_EE'\n\nspelling_word_list_filename = ['../../spelling_wordlist.txt', 'spelling_wordlist.txt']\n\n# Add any paths that contain templates here, relative to this directory.\ntemplates_path = ['_templates']\n\n# The suffix(es) of source filenames.\n# You can specify multiple suffix as a list of string:\n#\n# source_suffix = ['.rst', '.md']\nsource_suffix = {\n '.rst': 'restructuredtext',\n '.md': 'markdown',\n}\n\n# The master toctree document.\nmaster_doc = 'index'\n\n# The language for content autogenerated by Sphinx. Refer to documentation\n# for a list of supported languages.\n#\n# This is also used if you do content translation via gettext catalogs.\n# Usually you set \"language\" from the command line for these cases.\n\n# List of patterns, relative to source directory, that match files and\n# directories to ignore when looking for source files.\n# This pattern also affects html_static_path and html_extra_path.\nexclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']\n\n# If true, `todo` and `todoList` produce output, else they produce nothing.\ntodo_include_todos = False\n\n# -- Options for HTML output -------------------------------------------------\n\n# The theme to use for HTML and HTML Help pages. See the documentation for\n# a list of builtin themes.\n#\nhtml_theme = 'sphinx_rtd_theme'\n\n# Add any paths that contain custom themes here, relative to this directory.\n# html_theme_path = []\n\n# The name for this set of Sphinx documents.\n# \" v documentation\" by default.\n#\nhtml_title = f'{document_title} v{release}'\n\n# Add any paths that contain custom static files (such as style sheets) here,\n# relative to this directory. They are copied after the builtin static files,\n# so a file named \"default.css\" will overwrite the builtin \"default.css\".\nhtml_static_path = ['_static']\n\n# List of CSS files.\nhtml_css_files = ['custom.css']\n\n# HTML logo image.\nhtml_logo = '_static/ivxv.png'\n\n# -- Options for LaTeX output ------------------------------------------------\n\nlatex_preamble_lines = [\n '\\\\makeatletter',\n '\\\\IVXVDefineDocumentVersion{%s}' % version,\n '\\\\IVXVDefineDocumentNumber{%s}' % document_number,\n '\\\\IVXVDefineDocumentType{%s}' % document_type,\n '\\\\IVXVDefineDocumentSecurity{}',\n '\\\\pagestyle{IVXVFancy}',\n '\\\\makeatother',\n '\\\\newcommand{\\\\tablecontinued}{\\\\sphinxtablecontinued}',\n]\n\nlatex_elements = {\n # The paper size ('letterpaper' or 'a4paper').\n 'papersize': 'a4paper',\n 'preamble': ''.join(latex_preamble_lines),\n\n # The font size ('10pt', '11pt' or '12pt').\n 'pointsize': '12pt',\n\n # Additional stuff for the LaTeX preamble.\n # 'preamble': '',\n\n # Latex figure (float) alignment\n # 'figure_align': 'htbp',\n}\n\n# Grouping the document tree into LaTeX files. List of tuples\n# (source start file, target name, title,\n# author, documentclass [howto, manual, or own class]).\nlatex_documents = [\n (master_doc,\n f'{document_target_name}.tex',\n document_title,\n author,\n 'ivxv-technical'),\n]\n\nlatex_additional_files = [\n 'ivxv-technical/ivxv-common.cls',\n 'ivxv-technical/ivxv-technical.cls'\n]\n\n# The name of an image file (relative to this directory) to place at the top of\n# the title page.\n#\nlatex_logo = html_logo\n\n# If true, show page references after internal links.\n#\nlatex_show_pagerefs = False\n\n# If true, show URL addresses after external links.\n#\n\nlatex_show_urls = 'footnote'\n\n\n# -- Options for Texinfo output ----------------------------------------------\n\n# Grouping the document tree into Texinfo files. List of tuples\n# (source start file, target name, title, author,\n# dir menu entry, description, category)\ntexinfo_documents = [\n (master_doc,\n document_target_name,\n document_title,\n author,\n document_target_name,\n 'One line description of project.',\n 'Miscellaneous'),\n]\n" }, { "path": "Documentation/differ.sh", "content": "#!/bin/bash\n# differ.sh: Generate LaTeX differences between two Sphinx build directories.\n\nset -eu\n\nold=\"$1/latex/\"\nnew=\"$2/latex/\"\n\nshopt -s nullglob\nfor oldfile in ${old}*.tex; do\n basename=\"$(basename \"${oldfile}\" .tex)\"\n newfile=\"${new}${basename}.tex\"\n difffile=\"${new}${basename}-diff.tex\"\n if [[ \"${basename}\" != \"*-diff\" && -f \"${newfile}\" ]]; then\n latexdiff --replace-context2cmd=\"none\" --config VERBATIMENV=sphinxVerbatim \"${oldfile}\" \"${newfile}\" > \"${difffile}\"\n\n # Only generate the -diff.pdf if there are any actual differences.\n if grep --invert-match \"%DIF PREAMBLE\" \"${difffile}\" | grep --quiet '\\\\DIF'; then\n # latexdiff can mess up latex sometimes, but output is still visually fine\n make --directory \"${new}\" \"${basename}-diff.pdf\" || true\n else\n # Remove any existing -diff.pdf to signal that there were no changes.\n rm --force \"${new}${basename}-diff.pdf\"\n fi\n fi\ndone\n\nexit 0\n" }, { "path": "Documentation/documents.py", "content": "#!/usr/bin/python3\n\"\"\"\nIVXV documents\n\"\"\"\n\nproject = 'Elektroonilise hääletamise infosüsteem'\ncopyright = '2016-2025, Cybernetica AS'\nauthor = 'Cybernetica AS'\n\nrelease = '1.10'\n\nMETA = {\n\n 'audiitor': {\n 'et':{\n 'version': '1.10',\n 'changed': \"25.09.2025\",\n 'document_prefix': 'IVXV-JAJ',\n 'document_type': 'Juhend',\n 'document_title': 'IVXV audiitori juhend',\n 'document_target_name': 'IVXV-audiitor'\n }\n },\n\n 'arhitektuur': {\n 'et':{\n 'version': '1.10',\n 'changed': \"25.09.2025\",\n 'document_prefix': 'IVXV-AR',\n 'document_type': 'Arhitektuuridokument',\n 'document_title': 'IVXV arhitektuur',\n 'document_target_name': 'IVXV-arhitektuur'\n },\n 'en':{\n 'version': '1.10',\n 'changed': \"25.09.2025\",\n 'document_prefix': 'IVXV-AR-EN',\n 'document_type': 'Architecture document',\n 'document_title': 'IVXV architecture',\n 'document_target_name': 'IVXV-architecture'\n }\n },\n\n 'protokollid': {\n 'et':{\n 'lang': 'et',\n 'version': '1.10',\n 'changed': \"25.09.2025\",\n 'document_prefix': 'IVXV-PR',\n 'document_type': 'Spetsifikatsioon',\n 'document_title': 'IVXV protokollide kirjeldus',\n 'document_target_name': 'IVXV-protokollid'\n },\n 'en':{\n 'version': '1.10',\n 'changed': \"25.09.2025\",\n 'document_prefix': 'IVXV-PR-EN',\n 'document_type': 'Specification',\n 'document_title': 'IVXV protocols',\n 'document_target_name': 'IVXV-protocols'\n }\n },\n\n 'haldusteenus': {\n 'et':{\n 'version': '1.10',\n 'changed': \"25.09.2025\",\n 'document_prefix': 'IVXV-JHT',\n 'document_type': 'Juhend',\n 'document_title': 'IVXV haldusteenuse kasutusjuhend',\n 'document_target_name': 'IVXV-haldusteenuse-juhend'\n }\n },\n\n 'kasutusmall': {\n 'et':{\n 'version': '1.8.1',\n 'changed': \"16.12.2022\",\n 'document_prefix': 'IVXV-KM',\n 'document_type': 'Analüüsidokument',\n 'document_title': 'IVXV kasutusmallid',\n 'document_target_name': 'IVXV-kasutusmallid'\n }\n },\n\n 'votmerakendus': {\n 'et':{\n 'version': '1.8.0',\n 'changed': \"01.12.2022\",\n 'document_prefix': 'IVXV-SVR',\n 'document_type': 'Spetsifikatsioon',\n 'document_title': 'IVXV võtmerakendus',\n 'document_target_name': 'IVXV-votmerakendus'\n }\n },\n\n 'ivxvapi': {\n 'et':{\n 'version': '1.8.0',\n 'changed': \"01.12.2022\",\n 'document_prefix': 'IVXV-API',\n 'document_type': 'API-dokument',\n 'document_title': 'IVXV API',\n 'document_target_name': 'IVXV-API'\n }\n },\n\n 'seadistuste_koostejuhend': {\n 'et':{\n 'version': '1.10',\n 'changed': \"25.09.2025\",\n 'document_prefix': 'IVXV-JSK',\n 'document_type': 'Juhend',\n 'document_title': 'IVXV seadistuste koostamise juhend',\n 'document_target_name': 'IVXV-seadistuste-koostejuhend'\n }\n },\n 'kogumisteenuse_haldusjuhend': {\n 'et':{\n 'version': '1.10',\n 'changed': \"25.09.2025\",\n 'document_prefix': 'IVXV-JSH',\n 'document_type': 'Juhend',\n 'document_title': 'IVXV kogumisteenuse haldusjuhend',\n 'document_target_name': 'IVXV-kogumisteenuse-haldusjuhend'\n }\n },\n 'uldsisukord': {\n 'et':{\n 'version': '1.10',\n 'changed': \"25.09.2025\",\n 'document_prefix': 'IVXV-YS',\n 'document_type': '',\n 'document_title': 'IVXV dokumentatsiooni üldsisukord',\n 'document_target_name': 'IVXV-dokumentatsiooni-uldsisukord'\n },\n 'en':{\n 'version': '1.10',\n 'changed': \"25.09.2025\",\n 'document_prefix': 'IVXV-YS-EN',\n 'document_type': '',\n 'document_title': 'IVXV documentation overview',\n 'document_target_name': 'IVXV-documentation-overview'\n }\n\n },\n 'valijarakendus': {\n 'et':{\n 'version': '1.10',\n 'changed': \"25.09.2025\",\n 'document_prefix': 'IVXV-JVR',\n 'document_type': 'Juhend',\n 'document_title': 'IVXV valijarakendus',\n 'document_target_name': 'IVXV-valijarakendus'\n }\n },\n 'valijarakenduse_pakendamine': {\n 'et':{\n 'version': '1.10',\n 'changed': \"25.09.2025\",\n 'document_prefix': 'IVXV-JVP',\n 'document_type': 'Juhend',\n 'document_title': 'IVXV valijarakenduse pakendamine',\n 'document_target_name': 'IVXV-valijarakenduse-pakendamine'\n }\n },\n 'tarne': {\n 'et':{\n 'version': '1.8.0',\n 'changed': \"01.12.2022\",\n 'document_prefix': 'IVXV-T',\n 'document_type': 'Juhend',\n 'document_title': 'IVXV tarnejuhend',\n 'document_target_name': 'IVXV-tarnejuhend'\n }\n },\n 'eriomadused': {\n 'et':{\n 'version': '1.8.0',\n 'changed': \"01.12.2022\",\n 'document_prefix': 'IVXV-EO',\n 'document_type': 'Analüüsidokument',\n 'document_title': 'IVXV eriomadused',\n 'document_target_name': 'IVXV-eriomadused'\n }\n },\n 'testimisplaan': {\n 'et':{\n 'version': '1.8.0',\n 'changed': \"01.12.2022\",\n 'document_prefix': 'IVXV-TP',\n 'document_type': 'Testimisplaan',\n 'document_title': 'IVXV testimisplaan',\n 'document_target_name': 'IVXV-testimisplaan'\n }\n },\n 'regteenus': {\n 'et':{\n 'version': '1.8.0',\n 'changed': \"01.12.2022\",\n 'document_prefix': 'IVXV-SRT',\n 'document_type': 'Spetsifikatsioon',\n 'document_title': 'IVXV registreerimisteenuse kirjeldus',\n 'document_target_name': 'IVXV-registreerimisteenus'\n }\n },\n 'liidesed': {\n 'et': {\n 'version': '1.10',\n 'changed': \"25.09.2025\",\n 'document_prefix': 'IVXV-VIS-EHS',\n 'document_type': 'Spetsifikatsioon',\n 'document_title': 'VIS3-EHS liidesed',\n 'document_target_name': 'IVXV-liidesed'\n },\n 'en': {\n 'version': '1.10',\n 'changed': \"25.09.2025\",\n 'document_prefix': 'IVXV-VIS-EHS-EN',\n 'document_type': 'Specification',\n 'document_title': 'VIS3-EHS interfaces',\n 'document_target_name': 'IVXV-interfaces'\n }\n },\n 'xteeteenus': {\n 'et':{\n 'version': '1.10',\n 'changed': \"25.09.2025\",\n 'document_prefix': 'IVXV-XTEE',\n 'document_type': 'Spetsifikatsioon',\n 'document_title': 'IVXV X-tee teenuse kirjeldus',\n 'document_target_name': 'IVXV-xteeteenus'\n }\n },\n 'ivxv-pyapi': {\n 'et':{\n 'version': '1.8.0',\n 'changed': \"01.12.2022\",\n 'document_prefix': 'IVXV-PYAPI',\n 'document_type': 'API-dokument',\n 'document_title': 'IVXV Python API',\n 'document_target_name': 'IVXV-python-api'\n }\n },\n 'backendlogs': {\n 'en':{\n 'version': '1.10',\n 'changed': \"25.09.2025\",\n 'document_prefix': 'IVXV-LOGS-EN',\n 'document_type': 'Technical documentation',\n 'document_title': 'IVXV Backend Log Messages',\n 'document_target_name': 'IVXV-backend-log-messages'\n }\n }\n}\n\n\ndef get(doc, meta, language):\n return META[doc][language][meta]\n\n\ndef print_table_header():\n\n print(\"\")\n print(\".. list-table::\")\n print(\" :widths: 47 20 13 15\")\n print(\" :header-rows: 1\")\n print(\"\")\n print(\" * - Nimi\")\n print(\" - ID\")\n print(\" - Versioon\")\n print(\" - Kuupäev\")\n print(\"\")\n\n\ndef print_document(doc, lang='et'):\n\n title = get(doc, 'document_title', lang)\n prefix = get(doc, 'document_prefix', lang)\n version = get(doc, 'version', lang)\n changed = get(doc, 'changed', lang)\n\n print(f\" * - {title}\")\n print(f\" - {prefix}-{version}\")\n print(f\" - {version}\")\n print(f\" - {changed}\")\n print(\"\")\n\n\nif __name__ == \"__main__\":\n\n print(\".. IVXV dokumentatsiooni üldsisukord\")\n print(\"\")\n\n print(\"Dokumendid\")\n print(\"==========\")\n print(\"\")\n\n print(\"Ülddokumendid\")\n print(\"-------------\")\n print(\"\")\n\n print_table_header()\n print_document('uldsisukord')\n\n print(\"Spetsifikatsioonid\")\n print(\"------------------\")\n print(\"\")\n\n print_table_header()\n\n print_document('kasutusmall')\n print_document('protokollid')\n print_document('arhitektuur')\n print_document('votmerakendus')\n\n print(\"Ingliskeelsed dokumendid\")\n print(\"------------------------\")\n print(\"\")\n\n print_table_header()\n\n print_document('protokollid', 'en')\n print_document('arhitektuur', 'en')\n print_document('liidesed', 'en')\n print_document('backendlogs', 'en')\n\n print(\"Juhendid\")\n print(\"--------\")\n print(\"\")\n\n print_table_header()\n\n print_document('seadistuste_koostejuhend')\n print_document('kogumisteenuse_haldusjuhend')\n print_document('haldusteenus')\n print_document('ivxvapi')\n print_document('audiitor')\n print_document('valijarakendus')\n print_document('valijarakenduse_pakendamine')\n" }, { "path": "Documentation/en/backendlogs/.gitignore", "content": "index.rst\n" }, { "path": "Documentation/en/backendlogs/Makefile", "content": "\nDEPENDENCIES := index.rst\ninclude ../../common.mk\n\nindex.rst:\n\t./create_rst.py\n" }, { "path": "Documentation/en/backendlogs/create_rst.py", "content": "#!/usr/bin/env python3\n\n\"\"\"\nGenerate log-event reference doc from source code\n\"\"\"\n\n\nimport os\nimport re\n\nfrom rstcloth import RstCloth\n\n\ndef rstescape(txt):\n \"\"\"\n Escape RST formatting symbols from text\n \"\"\"\n return txt.replace(\"*\", r\"\\*\")\n\n\ndef parse_structs(file_content):\n \"\"\"\n Parse information about a particular struct in the generated file\n \"\"\"\n pattern = re.compile(\n r\"// BEGIN (\\w+)\\n\\n\" # Match typename\n r\"// auto-generated.*\\n\" # Match warning\n r\"//\\s*([\\w./]+)\\.\\1\\s*\\n\" # Match package\n r\"((?:\\s*//.*\\n)+)\" # Match comments\n r\"(type\\s+\\1\\s+struct\\s*{(?:.|\\n)+?})\\s*\" # Match typedef\n r\"// END \\1\", # Match end\n re.MULTILINE,\n )\n\n structs = []\n\n for match in pattern.finditer(file_content):\n typename = match.group(1)\n packagename = match.group(2)\n comments = match.group(3).replace(\"//\", \"\").strip()\n typedef = match.group(4).strip()\n\n struct_info = {\n \"typename\": typename,\n \"packagename\": packagename,\n \"fullcomment\": comments,\n \"typedef\": typedef,\n }\n\n structs.append(struct_info)\n\n return structs\n\n\ndef output_section_common(common_modules, rst, h2_common, h3_common, text):\n \"\"\"\n Output section with common modules\n \"\"\"\n\n rst.h2(h2_common)\n\n sorted_modules = sorted(common_modules.keys())\n for module in sorted_modules:\n rst.h3(f\"{h3_common} {module.replace('ivxv.ee/', '')}\")\n\n sorted_events = sorted(common_modules[module].keys())\n for event in sorted_events:\n data = common_modules[module][event]\n rst.definition(event, text)\n _, val = next(iter(data.items()))\n rst.codeblock(val[\"typedef\"], indent=3)\n rst.newline()\n for mod in data:\n rst.li(rstescape(f\"{mod}.{event}: {data[mod]['fullcomment']}\"))\n\n rst.newline()\n\n\ndef output_section_unique(unique_modules, rst, h2_unique, h3_unique):\n \"\"\"\n Output section with unique models\n \"\"\"\n\n rst.h2(h2_unique)\n sorted_modules = sorted(unique_modules.keys())\n for module in sorted_modules:\n rst.h3(f\"{h3_unique} {module.replace('ivxv.ee/', '')}\")\n\n sorted_events = sorted(unique_modules[module].keys())\n for event in sorted_events:\n data = unique_modules[module][event]\n rst.definition(\n f\"{data['packagename']}.{event}\", rstescape(data[\"fullcomment\"])\n )\n rst.codeblock(data[\"typedef\"], indent=3)\n rst.newline()\n\n\ndef output_intro(rst, h1, content_file):\n \"\"\"\n Output introduction\n \"\"\"\n\n rst.h1(h1)\n with open(content_file, \"r\", encoding=\"ascii\") as inf:\n for line in inf.readlines():\n if line.startswith(\"*\"):\n rst.li(line.replace(\"* \", \"\"))\n else:\n rst.content(line)\n rst.newline()\n\n\ndef categorize_event(pkg, evt, item, exclusions, events_dicts):\n \"\"\"\n Analyze each event to a category\n \"\"\"\n\n if exclusions and pkg in exclusions:\n return\n if \"/cmd/\" in pkg:\n events_dicts[\"cmd_events\"].setdefault(pkg, {})[evt] = item\n elif \"/service/\" in pkg:\n events_dicts[\"srv_events\"].setdefault(pkg, {})[evt] = item\n elif \"/internal/\" in pkg:\n events_dicts[\"int_events\"].setdefault(pkg, {})[evt] = item\n else:\n events_dicts[\"events\"].setdefault(pkg, {})[evt] = item\n\n\ndef analyze_src(src_dir, target_file, exclusions=None):\n \"\"\"\n Walk the source tree and analyze generated code\n \"\"\"\n\n events_dicts = {\"events\": {}, \"cmd_events\": {}, \"int_events\": {}, \"srv_events\": {}}\n\n for dirpath, _, filenames in os.walk(src_dir):\n if target_file in filenames:\n full_path = os.path.join(dirpath, target_file)\n\n with open(full_path, \"r\", encoding=\"utf8\") as file:\n parsed_structs = parse_structs(file.read())\n\n for item in parsed_structs:\n categorize_event(\n item[\"packagename\"],\n item[\"typename\"],\n item,\n exclusions,\n events_dicts,\n )\n\n return tuple(\n events_dicts[key]\n for key in [\"events\", \"cmd_events\", \"int_events\", \"srv_events\"]\n )\n\n\ndef remove_common(events):\n \"\"\"\n Remove common events from unique set\n \"\"\"\n\n common_events = {}\n unique_events = {}\n\n all_events = {}\n\n for module, mod_events in events.items():\n for event in mod_events:\n all_events.setdefault(event, set([]))\n all_events[event].add(module)\n\n for event, modules in all_events.items():\n if len(modules) > 1:\n by_types = {}\n for mod in modules:\n typedef = events[mod][event][\"typedef\"]\n by_types.setdefault(typedef, set([]))\n by_types[typedef].add(mod)\n\n if len(by_types) > 1:\n pass\n # This should not happen often. This means that same identifiers\n # do not have equal typedefs and we may even have several different\n # clusters with same identifier\n # TODO\n # print(event,file=sys.stderr)\n # print(by_types, file=sys.stderr)\n\n for _, val in by_types.items():\n if len(val) > 1:\n\n printable = \"\"\n for mod in sorted(val):\n printable += mod\n printable += \", \"\n\n printable = printable[:-2]\n\n common_events.setdefault(printable, {})\n\n common_events[printable][event] = {}\n for mod in sorted(val):\n common_events[printable][event][mod] = events[mod][event]\n\n else:\n mod = next(iter(val))\n unique_events.setdefault(mod, {})\n unique_events[mod][event] = events[mod][event]\n else:\n mod = next(iter(modules))\n unique_events.setdefault(mod, {})\n unique_events[mod][event] = events[mod][event]\n\n return common_events, unique_events\n\n\nif __name__ == \"__main__\":\n\n SRC_DIR = os.path.abspath(\"../../../\")\n print(SRC_DIR)\n TARGET_FILE = \"gen_types.go\"\n\n OUT_FILE = \"index.rst\"\n\n EXCLUSIONS = set(\n [\n \"ivxv.ee/common/collector/auth/dummy\",\n \"ivxv.ee/common/collector/container/dummy\",\n \"ivxv.ee/common/collector/storage/file\",\n \"ivxv.ee/common/collector/storage/memory\",\n ]\n )\n\n MOD_EVENTS, CMD_EVENTS, INT_EVENTS, SRV_EVENTS = analyze_src(\n SRC_DIR, TARGET_FILE, EXCLUSIONS\n )\n\n with open(OUT_FILE, \"w\") as output_file:\n\n RST = RstCloth(output_file)\n RST.title(\"IVXV Backend Log Messages\")\n\n RST.newline()\n RST.content(\".. raw:: html\")\n RST.newline()\n RST.content('

')\n RST.content(\" NB!\")\n RST.content(\" See on HTML-versioon dokumendist.\")\n RST.content(\" Tellijale antakse üle PDF-versioon.\")\n RST.content(\"

\")\n RST.newline()\n RST.content(\".. toctree::\")\n RST.content(\" :maxdepth: 4\")\n RST.newline()\n\n output_intro(RST, \"Overview\", \"introduction.inc\")\n\n CMD_COMMON, CMD_UNIQUE = remove_common(CMD_EVENTS)\n SRV_COMMON, SRV_UNIQUE = remove_common(SRV_EVENTS)\n MOD_COMMON, MOD_UNIQUE = remove_common(MOD_EVENTS)\n INT_COMMON, INT_UNIQUE = remove_common(INT_EVENTS)\n\n RST.h1(\"Commands\")\n output_section_common(\n CMD_COMMON, RST, \"Common events\", \"Commands\", \"Typedef for common event\"\n )\n output_section_unique(CMD_UNIQUE, RST, \"Specific events\", \"Command\")\n\n RST.h1(\"Services\")\n output_section_common(\n SRV_COMMON, RST, \"Common events\", \"Services\", \"Typedef for common event\"\n )\n output_section_unique(SRV_UNIQUE, RST, \"Specific events\", \"Service\")\n\n RST.h1(\"Modules\")\n output_section_common(\n MOD_COMMON, RST, \"Common events\", \"Modules\", \"Typedef for common event\"\n )\n output_section_unique(MOD_UNIQUE, RST, \"Specific events\", \"Module\")\n\n RST.h1(\"Internal modules\")\n output_section_common(\n INT_COMMON, RST, \"Common events\", \"Modules\", \"Typedef for common event\"\n )\n output_section_unique(INT_UNIQUE, RST, \"Specific events\", \"Module\")\n" }, { "path": "Documentation/en/backendlogs/introduction.inc", "content": "The purpose of this document is to provide a reference to all possible log\nmessages in the IVXV backend.\n\nThis document is partially auto-generated from the comments in the source code.\nThis is necessary to keep the document up to date through the evolution of the\nsoftware. The document is written in english, since the source code is written\nin english for improved readability and availability to wider audiences.\n\n\nIVXV systematically logs based on the protocol description and the service\nstatus diagram. We describe general principles that are followed.\n\nAt a minimum, the following should be logged:\n\n* The fact of receiving each request and the start of processing\n\n* The handover of processing to an external component\n\n* The return of the processing sequence to the component\n\n* The end of the request processing and the result\n\n* Additionally, passing through significant stages in the process state model together with important facts about the process\n\n\nGeneral Principles:\n\n* The rsyslog service is used for logging, which records the timestamp of the log message with millisecond precision.\n\n* At the start of each session, the system generates a unique identifier, which the client application uses in its requests to the central system.\n\n* All log entries belonging to a single session contain the same session identifier. Validity of the session identifier is checked, requests with unknown, invalid or expired session identifiers are not served.\n\n* Each log entry must be uniquely identifiable.\n\n* For each log message, it must be possible to unambiguously identify the location in the source code where the message originated. To ensure this, each logged message must have a unique phrasing or contain a unique identifier. In IVXV all event identifiers and corresponding data structures are generated before the compilation. This makes it easier to follow unified pattern.\n\n* The log entry should preferably be in JSON format, where machine readability is primary and human readability is secondary for automated monitoring.\n\n* The log entries may be stacked, to include information from more technical contexts.\n\n* If in doubt - log, one can filter unnecessary information, but cannot regenerate missing information.\n\nRequirements:\n\n* The information logged must be sanitized (e.g., URL encoding) and subject to length restrictions (both overall and per parameter).\n\n* Information originating from outside the system perimeter must only be logged in a sanitized form and within a predefined length.\n\n* Certificates and the agreed cipher used during TLS handshake must be logged.\n\n* Sensitive data must not be logged Directly, it must be protected by e.g. hashing.\n" }, { "path": "Documentation/et/audiitor/Makefile", "content": "include ../../common.mk\n" }, { "path": "Documentation/et/audiitor/annotatsioon.rst", "content": ".. IVXV kogumisteenuse haldusteenuse kirjeldus\n\nAnnotatsioon\n------------\n\nJuhend annab suunised IVXV andmeauditi teostamiseks Ubuntu 20.04 platvormil.\nKasulik on tutvuda järgmiste dokumentidega.\n\n* https://www.valimised.ee/sites/default/files/uploads/eh/IVXV_raamistiku_yldkirjeldus_29052017.pdf\n* https://www.valimised.ee/sites/default/files/uploads/eh/IVXV-seadistuste-koostejuhend.pdf\n* https://www.valimised.ee/sites/default/files/uploads/eh/IVXV-protokollid.pdf\n\nJuhendiga kaasneb näidisandmekomplekt ning vabas vormis `history` fail.\n\n\n" }, { "path": "Documentation/et/audiitor/audit.rst", "content": "\n================================================================================\nIVXV juhend audiitorile\n================================================================================\n\nRakenduste kompileerimine\n================================================================================\n\n\nEELDUSED\n--------------------------------------------------------------------------------\n\nKõik tegevused viime läbi tavakasutaja -- näidetes `ubuntu` -- õigustes,\nkasutades vajadusel käsklust `sudo`.\n\nÜldjuhul viime kõik tegevused läbi kasutaja kodukaustas::\n\n cd $HOME\n\nPaigaldame tarkvara, mis on vajalik audiitori tööriistade ehitamiseks::\n\n sudo apt-get install --no-install-recommends -y autoconf automake build-essential libgmp-dev libtool git openjdk-11-jdk-headless python unzip zip wget make\n\n\nINTCHECK\n--------------------------------------------------------------------------------\n\nVerificatum miksneti tervikluskontroll toimub rakendusega `intcheck`::\n\n wget https://github.com/vvk-ehk/intcheck/archive/master.zip\n unzip master.zip\n rm master.zip\n mv intcheck-master intcheck\n chmod +x intcheck/src/intcheck.py\n\nVeendume et rakendus on paigaldatud korrektselt::\n\n ./intcheck/src/intcheck.py -h\n\n\nJAVA RAKENDUSED\n--------------------------------------------------------------------------------\n\nAndmeauditi läbiviimiseks läheb vaja rakendust `auditor`, mille lähtekood on\navalikustatud IVXV repositooriumis::\n\n wget https://github.com/vvk-ehk/ivxv/archive/master.zip\n unzip master.zip\n rm master.zip\n mv ivxv-master ivxv\n\n\nPaigaldame Java sõltuvuspaketid::\n\n cd $HOME/ivxv/common/external\n wget -O gradle-8.11.zip https://services.gradle.org/distributions/gradle-8.11-bin.zip\n unzip gradle-8.11.zip\n rm gradle-8.11.zip\n cd $HOME/ivxv/common/java\n make sync\n\nVeendume, et ettevalmistused on tehtud korrektselt::\n\n cd $HOME/ivxv\n make clean-java\n\nEhitame Java rakendused::\n\n make java\n\nRVT'le tarnitavad rakendused::\n\n $HOME/ivxv/auditor/build/distributions/auditor-1.10.3.zip\n $HOME/ivxv/key/build/distributions/key-1.10.3.zip\n $HOME/ivxv/processor/build/distributions/processor-1.10.3.zip\n\nKäivitatavad failid::\n\n $HOME/ivxv/auditor/build/install/auditor/bin/auditor\n $HOME/ivxv/key/build/install/key/bin/key\n $HOME/ivxv/processor/build/install/processor/bin/processor\n\n\nVERIFICATUM\n--------------------------------------------------------------------------------\n\nVerificatum miksneti adapter on vajalik miksimistõendi kontrolliks::\n\n cd $HOME\n wget https://github.com/vvk-ehk/ivxv-mixnet-adapter/archive/master.zip\n unzip master.zip\n rm master.zip\n mv ivxv-mixnet-adapter-master ivxv-verificatum\n\nVerificatum tarkvara allalaadmine::\n\n git clone https://github.com/verificatum/verificatum-gmpmee gmpmee\n git clone https://github.com/verificatum/vmgj\n git clone https://github.com/verificatum/vcr\n git clone https://github.com/verificatum/vmn\n\nTarkvara täpse versiooni hankimine ning tervikluse kontroll::\n\n cd gmpmee\n git checkout 4aafc31\n rm -rf .git/\n cd ..\n ./intcheck/src/intcheck.py verify gmpmee ivxv-verificatum/doc/gmpmee.dirsha256sum\n\n cd vmgj\n git checkout 8d7d412\n rm -rf .git/\n cd ..\n ./intcheck/src/intcheck.py verify vmgj ivxv-verificatum/doc/vmgj.dirsha256sum\n\n cd vcr\n git checkout af9fd82\n rm -rf .git/\n cd ..\n ./intcheck/src/intcheck.py verify vcr ivxv-verificatum/doc/vcr.dirsha256sum\n\n cd vmn\n git checkout bb00543\n rm -rf .git/\n cd ..\n ./intcheck/src/intcheck.py verify vmn ivxv-verificatum/doc/vmn.dirsha256sum\n\nVerificatumi adapteri ehitamine::\n\n cd $HOME/ivxv-verificatum\n make zipext\n\nJuhuarvugeneraatori initsialiseerimine Verificatumi jaoks::\n\n cd $HOME\n ./vcr/bin/vog -rndinit RandomDevice /dev/urandom\n\n\nAuditeerimine\n================================================================================\n\nSiit edasi eeldame, et lugeja on tuttav dokumendiga \"IVXV seadistuste\nkoostamise juhend\" järgmises ulatuses:\n\n* Ptk. 2, IVXV seadistused valimise korraldamise protsessis\n* Ptk. 3, IVXV rakendused\n* Ptk. 6, Auditirakendus\n* Ptk. 10, E-häälte miksimine\n\nOlgu samuti paigaldatud pakk `audit-examples.tar`, millel on järgmine\nstruktuur::\n\n audit-conv\n |-- auditor.yaml -- konfinäide\n |-- inputs\n | |-- \n |-- process\n | |-- \n |\n audit-mix\n |-- auditor.yaml -- konfinäide\n |-- inputs\n | |-- \n |-- process\n | |-- \n |\n audit-mixver\n |-- inputs\n | |-- \n |\n audit-pdec\n |-- auditor.yaml -- konfinäide\n |-- inputs\n | |-- \n |-- process\n | |-- \n |\n audit-vertally\n |-- inputs\n | |-- \n |\n processor\n |-- \n\nTegutsemine on üldjuhul järgmine:\n\n* Tutvuge konfinäitega\n* Veenduge, et on olemas vajalik RVT sisend\n* Tehke kausta `process` konfinäitest lähtuv failistruktuur\n* Käivitage kaustas `process` rakendus ja tööriist (eelvalmendatud seadistused on seal\n juba ees)\n\nTäpsemad juhised järgnevad.\n\nGenereeritud avalike võtmete kooskõlalisuse kontroll\n--------------------------------------------------------------------------------\n\nVõtmete genereerimise ajal tekib kaks võtit - tulemusfaili signeerimisvõti ja\nhäälte salastamise võti.\n\nTulemusfaili signeerimisvõti on kodeeritud X509 sertifikaadina failis\n`RK2051-sign.pem`. Häälte salastamise võti on antud kolmes kodeeringus:\n\n* X509 sertifikaadina failis `RK2051-enc.pem`\n* DER-kodeeritud avaliku võtmena failis `RK2051-pub.der`\n* PEM-kodeeritud avaliku võtmena failis `RK2051-pub.pem`\n\nOn võimalik kontrollida, et sertifikaat, mis sisaldab tulemusfaili\nsigneerimisvõtit, on korrektselt isesigneeritud. Seda saab teha järgnevalt::\n\n openssl verify -CAfile RK2051-sign.pem -check_ss_sig RK2051-sign.pem\n\nKorrektse sertifikaadi korral on väljund::\n\n RK2051-sign.pem: OK\n\nOn võimalik kontrollida, et sertifikaat, mis sisaldab häälte salastamise võtit,\non korrektselt signeeritud tulemusfaili signeerimisvõtmega. Seda saab\nteha järgnevalt::\n\n openssl verify -CAfile RK2051-sign.pem -check_ss_sig RK2051-enc.pem\n\nKorrektselt allkirjastatud sertifikaadi korral on väljund::\n\n RK2051-enc.pem: OK\n\n.. note:: Teadaoleva OpenSSL vea tõttu ei suuda OpenSSL versioonist `1.1.1b`\n vanemad versioonid sertifikaadi usaldusahelat kontrollida. Eelneva kontrolli\n õnnestumise jaoks on eelduseks vähemalt OpenSSL versioon `1.1.1b`.\n\nLisaks on võimalik kontrollida, et häälte salastamise võtme eri kodeeringud\nvastavad üksteisele. Me kontrollime, et X509 sertifikaadis olev võti vastab\nDER-kodeeritud võtmele ning lisaks, et PEM-kodeeritud võti vastab DER-kodeeritud\nvõtmele. Transitiivsuse tõttu on seega kõik kolm kodeeringut kooskõlalised.\n\nEsiteks tuleb eraldada häälte salastamise võti vastavast sertifikaadist. Kuna\nOpenSSL ei toeta kasutatavad ElGamali krüptoskeemi, siis tuleb avaliku võtme\neksportimiseks kasutada OpenSSL `asn1parse` tööriista.\n\nKõigepealt tuleb leida avaliku võtme nihe sertifikaadis::\n\n openssl asn1parse -in RK2051-enc.pem\n\nAvalik võti on vastavas `SubjectPublicKeyInfo` väljal::\n\n 156:d=2 hl=4 l= 816 cons: SEQUENCE\n 160:d=3 hl=4 l= 415 cons: SEQUENCE\n 164:d=4 hl=2 l= 9 prim: OBJECT :1.3.6.1.4.1.3029.2.1\n 175:d=4 hl=4 l= 400 cons: SEQUENCE\n 179:d=5 hl=4 l= 385 prim: INTEGER :FFFFFFFFFFFFFFFFC90FDA\n A22168C234C4C6628B80DC1CD129024E088A67CC74020BBEA63B139B22514A08\n 798E3404DDEF9519B3CD3A431B302B0A6DF25F14374FE1356D6D51C245E485B5\n 76625E7EC6F44C42E9A637ED6B0BFF5CB6F406B7EDEE386BFB5A899FA5AE9F24\n 117C4B1FE649286651ECE45B3DC2007CB8A163BF0598DA48361C55D39A69163F\n A8FD24CF5F83655D23DCA3AD961C62F356208552BB9ED529077096966D670C35\n 4E4ABC9804F1746C08CA18217C32905E462E36CE3BE39E772C180E86039B2783\n A2EC07A28FB5C55DF06F4C52C9DE2BCBF6955817183995497CEA956AE515D226\n 1898FA051015728E5A8AAAC42DAD33170D04507A33A85521ABDF1CBA64ECFB85\n 0458DBEF0A8AEA71575D060C7DB3970F85A6E1E4C7ABF5AE8CDB0933D71E8C94\n E04A25619DCEE3D2261AD2EE6BF12FFA06D98A0864D87602733EC86A64521F2B\n 18177B200CBBE117577A615D6C770988C0BAD946E208E24FA074E5AB3143DB5B\n FCE0FD108E4B82D120A93AD2CAFFFFFFFFFFFFFFFF\n 568:d=5 hl=2 l= 1 prim: INTEGER :02\n 571:d=5 hl=2 l= 6 prim: GENERALSTRING\n 579:d=3 hl=4 l= 393 prim: BIT STRING\n\nNäeme, et `SubjectPublicKeyInfo` välja nihe on 156 baiti. Eraldame avaliku\nvõtme ja kontrollime vastavust väljastatud avaliku võtmega::\n\n openssl asn1parse -in RK2051-enc.pem -strparse 156 -noout -out extracted.der\n diff -s extracted.der RK2051-pub.der\n\nSamaväärsete võtmete korral on väljundiks::\n\n Files extracted.der and RK2051-pub.der are identical\n\nTeiseks kontrollime DER-kodeeritud võtme vastavust PEM-kodeeritud võtmele.\nSelleks teisendame PEM-kodeeritud võtme DER-kodeeringusse ja võrdleme::\n\n openssl asn1parse -in RK2051-pub.pem -noout -out converted.der\n diff -s converted.der RK2051-pub.der\n\nSamaväärsete võtme korral on väljundiks::\n\n Files converted.der and RK2051-pub.der are identical\n\nHääletamistulemuse allkirja verifitseerimine\n--------------------------------------------------------------------------------\n\nNii tavalise dekrüpteerimise kui tõestatava dekrüpteerimise käigus tekib kaks\nfaili:\n\n* Tulemusfail `RK2051.1.tally`\n* Signatuurifail `RK2051.1.tally.signature`\n\nKoos häälte salastamise võtmega genereeritakse tulemusfaili signeerimisvõti ja\nvastav sertifikaat (`RK2051-sign.pem`). Dekrüpteeritud tulemusele antakse selle\nvõtmega signatuur, mida tuleb kontrollida.\n\nEraldame signeerimisvõtme sertifikaadist avaliku võtme::\n\n openssl x509 -in RK2051-sign.pem -noout -pubkey > sign.pub\n\nKasutame avalikku võtit tulemusfaili allkirja kontrollimiseks::\n\n openssl dgst -sha256 -sigopt rsa_padding_mode:pss -sigopt rsa_pss_saltlen:32 -sigopt rsa_mgf1_md:sha256 -verify sign.pub -signature RK2051.1.tally.signature RK2051.1.tally\n\nNB! Tavalise dekrüpteerimise ja tõestatava dekrüpteerimise käigus tekkivad\ntulemusfailid peavad olema identsed. Kontrollimiseks UNIXi tööriist `diff`::\n\n diff decout/RK2051.1.tally pdecout/RK2051.1.tally\n\nNäitefailid on pakis::\n\n cd $HOME/audit-examples/audit-vertally\n\n\nIVXV <-> Verificatum teisenduste korrektsuse kontroll\n--------------------------------------------------------------------------------\n\nTeisenduste korrektsuse kontroll toimub tööriistaga `convert`. NB! Kaust\n`process` tuleb `auditor.yaml` põhjal sisenditest ettevalmistada::\n\n cd $HOME/audit-examples/audit-conv/process\n $HOME/ivxv/auditor/build/install/auditor/bin/auditor convert -c conf.bdoc -p auditor.yaml.bdoc\n\nMiksimistõendi kontroll tööriistaga `auditor`\n--------------------------------------------------------------------------------\n\nMiksimistõendi kontroll toimub tööriistaga `mixer`. NB! Kaust `process` tuleb\n`auditor.yaml` põhjal sisenditest ettevalmistada::\n\n cd $HOME/audit-examples/audit-mix/process\n $HOME/ivxv/auditor/build/install/auditor/bin/auditor mixer -c conf.bdoc -p auditor.yaml.bdoc\n\nLugemistõendi kontroll\n--------------------------------------------------------------------------------\n\nLugemistõendi kontroll toimub tööriistaga `decrypt`. NB! Kaust `process` tuleb\n`auditor.yaml` põhjal sisenditest ettevalmistada::\n\n cd $HOME/audit-examples/audit-pdec/process\n $HOME/ivxv/auditor/build/install/auditor/bin/auditor decrypt -c conf.bdoc -p auditor.yaml.bdoc\n\nMiksimistõendi kontroll Verificatumi originaaltööriistaga\n--------------------------------------------------------------------------------\n\nMiksimistõendi kontroll Verificatumi abil::\n\n cd $HOME/audit-examples/audit-mixver\n $HOME/ivxv-verificatum/release/mixer/bin/mix.py verify --proof-zipfile shuffle_proof.zip\n\nTöötlemise audit\n--------------------------------------------------------------------------------\n\nTäiendavalt on lisatud pakki kõik töötlemisrakenduse sisendid ja väljundid\nlihtsustamaks töötlemisprotsessi auditit. Täiendavad auditeerimistööriistad,\nnt. `integrity` on kirjeldatud dokumendis \"IVXV seadistuste koostamise juhend\".\n" }, { "path": "Documentation/et/audiitor/history.rst", "content": "\n`.history`\n---------------\n\n.. literalinclude:: history.txt\n :linenos:\n\n" }, { "path": "Documentation/et/audiitor/history.txt", "content": "sudo apt update\nsudo apt upgrade\ntar xvf audit-examples.tar\nsudo apt-get install --no-install-recommends -y autoconf automake build-essential libgmp-dev libtool git openjdk-11-jdk-headless python unzip zip wget make\njava -version\njavac -version\nsudo apt install openjdk-11-jre-headless\nsudo update-alternatives --config java\njava -version\njavac -version\nwget https://github.com/vvk-ehk/intcheck/archive/master.zip\nunzip master.zip\nrm master.zip\nmv intcheck-master/ intcheck\nchmod +x intcheck/src/intcheck.py\n./intcheck/src/intcheck.py -h\n./intcheck/src/intcheck.py verify -h\nwget https://github.com/vvk-ehk/ivxv/archive/master.zip\nunzip master.zip\nrm master.zip\nmv ivxv-master/ ivxv\ncd ivxv/common/external/\nwget -O gradle-8.11.zip https://services.gradle.org/distributions/gradle-8.11-bin.zip\nunzip gradle-8.11.zip\nrm gradle-8.11.zip\ncd ..\ncd java/\nmake sync\nls ../external/\ncd ..\ncd ..\nmake clean-java\nmake java\nauditor/build/install/auditor/bin/auditor -h\nls auditor/build/distributions/*.zip\nls key/build/distributions/*.zip\nls processor/build/distributions/*.zip\nls processor/build/install/processor/bin/processor\nls key/build/install/key/bin/key\nls auditor/build/install/auditor/bin/auditor\ncd ..\nwget https://github.com/vvk-ehk/ivxv-mixnet-adapter/archive/master.zip\nunzip master.zip\nrm master.zip\nmv ivxv-mixnet-adapter-master ivxv-verificatum\ngit clone https://github.com/verificatum/verificatum-gmpmee gmpmee\ngit clone https://github.com/verificatum/vmgj\ngit clone https://github.com/verificatum/vcr\ngit clone https://github.com/verificatum/vmn\ncd gmpmee/\ngit checkout 4aafc31\nrm -rf .git/\ncd ..\n./intcheck/src/intcheck.py verify gmpmee ivxv-verificatum/doc/gmpmee.dirsha256sum\ncd vmgj/\ngit checkout 8d7d412\nrm -rf .git/\ncd ..\n./intcheck/src/intcheck.py verify vmgj ivxv-verificatum/doc/vmgj.dirsha256sum\ncd vcr/\ngit checkout af9fd82\nrm -rf .git/\ncd ..\n./intcheck/src/intcheck.py verify vcr ivxv-verificatum/doc/vcr.dirsha256sum\ncd vmn/\ngit checkout bb00543\nrm -rf .git\ncd ..\n./intcheck/src/intcheck.py verify vmn ivxv-verificatum/doc/vmn.dirsha256sum\ncd ivxv-verificatum/\nmake zipext\ncd ..\n./vcr/bin/vog -rndinit RandomDevice /dev/urandom\nopenssl verify -CAfile initout/RK2051-sign.pem -check_ss_sig initout/RK2051-sign.pem\nopenssl verify -CAfile initout/RK2051-sign.pem -check_ss_sig initout/RK2051-enc.pem\nopenssl asn1parse -in initout/RK2051-enc.pem\nopenssl asn1parse -in initout/RK2051-enc.pem -strparse 156 -noout -out extracted.der\ndiff -s extracted.der initout/RK2051-pub.der\nopenssl asn1parse -in initout/RK2051-pub.pem -noout -out converted.der\ndiff -s converted.der initout/RK2051-pub.der\ndiff decout/RK2051.1.tally pdecout/RK2051.1.tally\nopenssl x509 -in initout/RK2051-sign.pem -noout -pubkey > sign.pub\nopenssl dgst -sha256 -sigopt rsa_padding_mode:pss -sigopt rsa_pss_saltlen:32 -sigopt rsa_mgf1_md:sha256 -verify sign.pub -signature decout/RK2051.1.tally.signature decout/RK2051.1.tally\ncd $HOME/audit-examples/audit-conv\ncd process\n$HOME/ivxv/auditor/build/install/auditor/bin/auditor\n$HOME/ivxv/auditor/build/install/auditor/bin/auditor convert -c conf.bdoc -p auditor.yaml.bdoc\ncat ../auditor.yaml\ncp ../inputs/bb-4.json* .\nmkdir initout\ncp ../inputs/RK2051-pub.pem initout/\ncp ../inputs/shuffled.json .\n$HOME/ivxv/auditor/build/install/auditor/bin/auditor convert -c conf.bdoc -p auditor.yaml.bdoc\nunzip -l ../inputs/shuffle_proof.zip\ncd ..\nunzip inputs/shuffle_proof.zip\ncd process/\n$HOME/ivxv/auditor/build/install/auditor/bin/auditor convert -c conf.bdoc -p auditor.yaml.bdoc\n$HOME/ivxv/auditor/build/install/auditor/bin/auditor mixer -c conf.bdoc -p auditor.yaml.bdoc\n$HOME/ivxv/auditor/build/install/auditor/bin/auditor decrypt -c conf.bdoc -p auditor.yaml.bdoc\n$HOME/ivxv-verificatum/release/mixer/bin/mix.py verify --proof-zipfile shuffle_proof.zip\n$HOME/ivxv/processor/build/install/processor/bin/processor\n" }, { "path": "Documentation/et/audiitor/index.rst", "content": ".. IVXV seadistuste koostamise juhend\n\nIVXV audiitori juhend\n==========================================================================\n\n.. raw:: html\n\n

\n NB!\n See on HTML-versioon dokumendist.\n Tellijale antakse üle PDF-versioon.\n

\n\n.. toctree::\n :maxdepth: 2\n :numbered:\n\n ylevaade\n annotatsioon\n audit\n history\n" }, { "path": "Documentation/et/audiitor/spelling_wordlist.txt", "content": "\nPEM\nRVT'le\n\nkonfinäitega\nkonfinäitest\n\nubuntu\n" }, { "path": "Documentation/et/audiitor/ylevaade.rst", "content": "Miksimistõendi ülevaade\n=======================\n\nIlma juhuslikkust kasutamata oleks iga krüpteerimise algoritm deterministlik,\nst. valija valiku krüpteerimisel oleks tulemuseks alati sama väljund. See\nlubaks ründajal tuvastada esialgse valiku, kui ta krüpteeriks kõikvõimalikud\nvalikud ja võrdleks seda nimekirja nähtud krüpteeritud valikuga. Seega,\nkrüpteerimine peab kasutama juhuslikkust.\n\nJuhuslikkuse kasutamine teeb krüptogrammid unikaalseks - isegi kui kaks korda\non krüpteeritud sama valik, siis krüptogrammid on erinevad. See tähendab, et\nkui ründaja on võimeline mingil ajahetkel seostama krüptogrammi ja selle\nkrüpteerinud isikut, siis on tal võimalik hiljem ainult krüptogrammi nähes\ntuletada seda andnud isik. Kuna sobivate parameetrite kasutamisel on ElGamali\navaliku võtme krüptosüsteem pikaajaliselt turvaline, siis see ei ole otseselt\nprobleemiks.\n\nProbleem tekib siis, kui on tarvis tõestada, et krüptogramm on korrektselt\ndekrüpteeritud. Kui kasutatav valikute agregeerimise algoritm töötab avateksti\nkujul sõnede peal (nagu see IVXVs on), siis iga krüptogrammi kohta tekib üks\ndekrüpteeritud avatekst. Korrektse dekrüpteerimise tõestus peab nii\nkrüptogrammi kui dekrüpteeritud avateksti siduma. Seega on võimalik ründajal\ntekitada seos isiku ja krüptogrammi, ning krüptogrammi ja vastava avateksti\nvahel, st. ta saab teada, mis valiku isik tegi.\n\nEt seda seost eemaldada, kasutatakse IVXVs krüptogrammide segamist (miksnet).\nMiksnet teeb korraga kahte operatsiooni -- järjestab sisendkrüptogrammid ümber\n(permuteerib) ja uuendab krüptogrammis olevad juhuslikkust (rerandomiseerib).\nSee tähendab, et krüptogrammid, mis lähevad miksneti sisse on väliselt täiesti\nsõltumatud krüptogrammidest, mis tulevad miksnetist välja. Kuna välise\nsõltumatuse tõttu võiks teoreetiliselt miksnet krüptogramme asendada, siis on\ntarvis lisada miksimistõend, mis tõestab krüptograafiliselt, et operatsioonid\non tehtud korrektselt ja ühtegi täiendavat operatsiooni pole tehtud.\nKontrollides miksimistõendit, on võimalik garanteerida, et miksnet on töötanud\nkorrektselt.\n\nVäikeste parameetritega kirjutatud näide\n----------------------------------------\n\nIVXV kasutab valikute krüpteerimiseks ElGamali avaliku võtme krüptosüsteemi.\nElGamali krüptosüsteemi korral on fikseeritud algebralise rühma parameetrid\nkoos generaatoriga :math:`g`. Salajane võti :math:`x` valitakse vahemikus\n:math:`[0, q-1]` ühtlase jaotusega, kus :math:`q` on rühma multiplikatiivse\nalamrühma järk. Salajasele võtmele avalik võti on defineeritud:\n\n.. math::\n pk = (g, g^x) = (g, y).\n\nKrüpteerimaks sõne kujul valikut `V`, tuleb see kõigepealt kodeerida rühma\nelemendiks\n\n.. math::\n m = encode(V)\n\nja seejärel arvutatakse krüptogramm kasutades ühekordset juhuarvu\n:math:`0<=r\n NB!\n See on HTML-versioon dokumendist.\n Tellijale antakse üle PDF-versioon.\n

\n\n\n.. toctree::\n :maxdepth: 2\n\n annotatsioon\n ylevaade\n yldseisund\n nimekirjad\n statistika\n kasutajad\n teenused\n allalaadimised\n seadistused\n logi\n" }, { "path": "Documentation/et/haldusteenus/kasutajad.rst", "content": ".. IVXV kogumisteenuse haldusliidese kasutusjuhend\n\nKasutajate haldus\n=================\n\nKasutajate halduse leht avaneb menüüvalikust ``Kasutajad``.\n\n\nKasutajate nimekiri\n-------------------\n\nKasutajate nimekirjas kuvatakse kõigi haldusteenuses registreeritud kasutajate\nandmeid sordituna kasutaja ID-kaardi üldnime (CN - *Common Name*) järgi:\n\n#. Järjekorranumber nimekirjas;\n\n#. Üldnimi;\n\n#. Kasutaja rollid.\n\nKasutaja volituste laadimise vorm\n---------------------------------\n\nKasutaja volituste laadimiseks kogumisteenusesse on lehe allosas laadimisvorm.\nLaadida on lubatud ainult volitatud kasutajate poolt digitaalselt signeeritud\nvolitusi.\n" }, { "path": "Documentation/et/haldusteenus/logi.rst", "content": ".. IVXV kogumisteenuse haldusliidese kasutusjuhend\n\nHaldussündmuste logi jälgimine\n==============================\n\nKogumisteenuse sündmuste logi sirvimise leht avaneb menüüvalikust\n``Logiraamat``.\n\nLogis on järgmised väljad:\n\n#. ``Aeg`` - sündmuse registreerimise aeg;\n\n#. ``Teenus`` - teenuse identifikaator;\n\n#. ``Tase`` - logisündmuse tase (``INFO`` või ``ERROR``);\n\n#. ``Sündmus`` - sündmuse liigi identifikaator;\n\n#. ``Kirjeldus`` - sündmuse tekstiline kirjeldus.\n\nLogi on võimalik filtreerida ja välja väärtuse järgi sortida.\n\nLogisündmused\n-------------\n\nKogumisteenuse olekud:\n\n:COLLECTOR_INIT:\n Kogumisteenuse lähtestamine (käsuga :command:`ivxv-collector-init`);\n\n:COLLECTOR_RESET:\n Kogumisteenuse seadistuste lähtestamine (usaldusjuure laadimine);\n\n:COLLECTOR_STATE_CHANGE:\n Kogumisteenuse olekumuutus;\n\nKorralduste laadimine:\n\n:CMD_LOAD:\n Korraldusfaili haldusteenusesse laadimine;\n\n:CMD_LOADED:\n Edukalt laaditud korraldusfaili registreerimine haldusteenuses;\n\n:CMD_REMOVED:\n Korraldusfaili eemaldamine haldusteenusest;\n\n:VOTER_LIST_DOWNLOADED:\n Valijate muudatusnimekirja allalaadimine;\n\n:VOTER_LIST_DOWNLOAD_FAILED:\n Valijate muudatusnimekirja nurjunud allalaadimine;\n\n:VOTER_LIST_NOT_FOUND:\n Valijate järgmist muudatusnimekirja ei leitud Valimiste Infosüsteemis;\n\nKasutajaõiguste muutused:\n\n:PERMISSION_SET:\n Kasutajale õiguse määramine;\n\n:PERMISSION_RESET:\n Kasutaja õiguste lähtestamine;\n\nHääletusperioodi registreerimine:\n\n:SET_ELECTION_TIME:\n Hääletusperioodi algus- ja lõpuaegade registreerimine;\n\nMikroteenuste haldus:\n\n:SERVICE_REGISTER:\n Teenuse registreerimine haldusteenuses;\n\n:SERVICE_CONFIG_APPLY:\n Seadistuse rakendamine teenusele;\n\n:SERVICE_STATE_CHANGE:\n Teenuse olekumuutus;\n\n:SECRET_INSTALL:\n Saladuse laadimine teenusele.\n" }, { "path": "Documentation/et/haldusteenus/nimekirjad.rst", "content": ".. IVXV kogumisteenuse haldusliidese kasutusjuhend\n\nNimekirjade haldamine\n=====================\n\nNimekirjade haldamise leht avaneb menüüvalikust ``Nimekirjad``.\n\n\nValikute nimekiri\n-----------------\n\nValikute nimekirja kohta kuvatakse nimekirja seisundit ja laaditud nimekirja\nkorral selle versiooni (nimekirja signeerija andmed koos digiallkirja\najatempliga).\n\nNimekirja võimalikud seisundid on:\n\n#. Laadimata;\n\n#. Laaditud haldusteenusesse;\n\n#. Rakendatud kogumisteenusele.\n\n\nValijate nimekirjad\n-------------------\n\nValijate nimekirjade kohta kuvatakse nimekirjade koguarvu, nimekirjade arvu\nseisundi kaupa ning loetelu kõigi kogumisteenuses registreeritud nimekirjade\nkohta (versioon ja seisund).\n\nValijate algnimekirja korral on nimekirja versioon nimekirja signeerija andmed\nkoos digiallkirja ajatempliga; muudatusnimekirja korral nimekirja allalaadimise\nURL koos allalaadimise hetke ajatempliga.\n\nNimekirja võimalikud seisundid on:\n\n#. Rakendamise ootel;\n\n#. Rakendatud kogumisteenusele;\n\n#. Vigane;\n\n#. Vahele jäetud.\n\n\nRingkondade nimekiri\n--------------------\n\nRingkondade nimekirja kohta kuvatakse nimekirja seisundit ja laaditud nimekirja\nkorral selle versiooni (nimekirja signeerija andmed koos digiallkirja\najatempliga).\n\nNimekirja võimalikud seisundid on:\n\n#. Laadimata;\n\n#. Laaditud haldusteenusesse;\n\n#. Rakendatud kogumisteenusele.\n\n\nNimekirjade laadimine kogumisteenusesse\n---------------------------------------\n\nNimekirjade laadimiseks kogumisteenusesse on lehe allosas laadimisvorm. Laadida\non lubatud ainult volitatud kasutajate poolt digitaalselt signeeritud\nnimekirju.\n\n.. note::\n\n Nimekirjade laadimise järjekord ei ole oluline. Enne nimekirjade laadimist\n tuleb laadida valimiste seadistused.\n\n.. important::\n\n Valikute nimekirja on võimalik kogumisteenusele rakendada ainult üks kord!\n" }, { "path": "Documentation/et/haldusteenus/seadistused.rst", "content": ".. IVXV kogumisteenuse haldusliidese kasutusjuhend\n\nSeadistuste rakendamise seisundid\n=================================\n\nSeadistuste seisundite jälgimise leht avaneb menüüvalikust ``Seadistused``.\n\nSeisundit kuvatakse järgmiste seadistuste kohta:\n\n* Usaldusjuure seadistused;\n\n* Tehniline seadistus;\n\n* Valimiste seadistus;\n\n* Valikute nimekiri;\n\n* Ringkondade nimekiri;\n\n* Valijate nimekirjad.\n\nSeisundit ei kuvata järgmiste seadistuste kohta:\n\n* Kasutaja volitused (on laadimisel kohe rakendatud).\n\nHaldusteenusesse laaditud seadistuste kohta kuvatakse:\n\n* Seadistuse rakendamise seisundit;\n\n* Aktiivse seadistuse versiooni;\n\n* Seadistuste rakendamise katsete arvu;\n\n* Rakendamisele saadetud seadistuse kohta ka rakendamise logi.\n\n\nSeadistuste laadimine kogumisteenusesse\n---------------------------------------\n\nTehnilise seadistuse ja valimiste seadistuste laadimiseks kogumisteenusesse on\nlehe allosas laadimisvorm. Laadida on lubatud ainult volitatud kasutajate poolt\ndigitaalselt signeeritud seadistuspakke. Seadistuste laadimise järjekord ei ole\noluline. Valimiste seadistuse laadimine on eelduseks valimiste nimekirjade\nlaadimisele.\n\n.. note::\n\n Usaldusjuure seadistuse laadib kogumisteenuse haldur käsurealt. Enne\n usaldusjuure laadimist pole kogumisteenuse haldusliidest võimalik kasutada.\n" }, { "path": "Documentation/et/haldusteenus/spelling_wordlist.txt", "content": "" }, { "path": "Documentation/et/haldusteenus/statistika.rst", "content": ".. IVXV kogumisteenuse haldusliidese kasutusjuhend\n\nStatistika jälgimine\n====================\n\nStatistika jälgimise leht avaneb menüüvalikust ``Statistika``.\nHääletamise detailstatistika allalaadimine on kirjeldatud lõigus\n:ref:`allalaadimised`.\n\n\nStatistika genereerimine\n------------------------\n\nStatistika vaates kuvatavad andmed genereeritakse ja uuendatakse korrapäraselt\nlogimonitoris ning laaditakse automaatselt haldusliidesesse.\n\nHaldusliideses kuvatav statistika kajastab kogumisteenuse seisundit mõningase\nviivitusega (harilikult kuni 10 minutit).\n\n\nStatistika sisu\n---------------\n\nKuvatavad andmed on järgmised:\n\n#. Kogutud häälte arv;\n\n#. Hääletajate arv;\n\n#. Kontrollitud häälte arv;\n\n#. Hääle kontrollijate arv;\n\n#. Hääletajate jaotumine:\n\n #. Sugude kaupa;\n\n #. Vanusegruppide kaupa;\n\n #. Autentimisvahendite kaupa;\n\n #. Operatsioonisüsteemide kaupa;\n\n #. Riikide kaupa (vastavalt hääletaja IP-aadressile).\n\n#. Korduvhääletamiste statistika.\n\nStatistikat on võimalik filtreerida ringkondade ja jaoskondade kaupa (juhul,\nkui ringkondade nimekiri on laaditud haldusteenusesse).\n" }, { "path": "Documentation/et/haldusteenus/teenused.rst", "content": ".. IVXV kogumisteenuse haldusliidese kasutusjuhend\n\nTeenuste haldus\n===============\n\nTeenuste haldamise leht avaneb menüüvalikust ``Teenused``.\n\n\nTeenuste kokkuvõte\n------------------\n\nTeenuste kokkuvõttes kuvatakse kõikide registreeritud teenuste ülevaadet\nseisundi kaupa. Iga seisundi järel kuvatakse selles seisundis olevate teenuste\narvu:\n\n#. Paigaldamata – teenus pole paigaldatud;\n\n#. Paigaldatud – teenus on paigaldatud ja sellele on rakendatud usaldusjuure\n seadistus, kogumisteenuse tehniline seadistus. Valimiste seadistus on\n teenusele rakendamata;\n\n#. Seadistatud – teenusele on rakendatud kõik seadistused ja teenus on töökorras;\n\n#. Tõrge – teenuse toimimises on avastatud tõrge;\n\n#. Eemaldatud – teenuse on kogumisteenuse koosseisust eemaldatud.\n\n\nTeenuste nimekiri\n-----------------\n\nTeenuste nimekirjas kuvatakse kõiki haldusteenuses registreeritud teenuseid.\nIga teenuse kohta kuvatakse:\n\nTeenuste halduse vaates kuvatakse alamteenuste nimekirja, mis on sorditud\nteenuse identifikaatori järgi:\n\n#. Teenuse identifikaator;\n\n#. Teenuse alamvõrk;\n\n#. Teenuse liik;\n\n#. Teenuse seisund;\n\nKui haldusteenus on alamteenuse kohta tuvastanud seadistuste puudumise või\nveaolukorra, siis vastav teave kuvatakse teenuse all. Iga teenuse kohta\nkuvatakse korraga vaid ühte teadet.\n\nNimekirjas teenuse kirjel klõpsates avaneb kirje all tabel täpsema infoga:\n\n#. Teenuse korrasoleku kontrolli poolt tuvastatud järjestikune vigade arv\n (ainult teenustel, mis on olekus ``seadistatud`` või ``tõrge``);\n\n#. Teenuse korrasoleku kontrolli viimase läbiviimise aeg\n (ainult teenustel, mis on olekus ``seadistatud`` või ``tõrge``);\n\n#. Teenusele rakendadud tehnilise seadistuse versioon;\n\n#. Teenusele rakendadud valimiste seadistuse versioon;\n\n#. Teenuse IP-aadress ja port;\n\n#. Teenuse TLS-sertifikaadi kontrollsumma (SHA256);\n\n#. Teenuse TLS-sertifikaadile vastava võtme kontrollsumma (SHA256);\n\n#. Mobiil-ID/Smart-ID/Web eID tugiteenuste jagatud krüptimissaladuse kontrollsumma\n (SHA256);\n" }, { "path": "Documentation/et/haldusteenus/yldseisund.rst", "content": ".. IVXV kogumisteenuse haldusliidese kasutusjuhend\n\nÜldseisund\n==========\n\nÜldseisundi leht avaneb menüüvalikust ``Üldseisund``.\n\nKogumisteenuse üldseisund\n-------------------------\n\nKogumisteenuse üldseisundi vaates kuvatakse järgnevaid andmeid:\n\n#. Valimiste identifikaator;\n\n#. Kogumisteenuse seisund;\n\n#. Käimasolev hääletusetapp;\n\n#. Kogumisteenusele rakendatud seadistuste ja nimekirjade versioonid;\n\n#. Mikroteenuste seisundite kokkuvõte;\n\n#. Kogumisteenuse tarkvarapakkide seisund;\n\n#. Kogumisteenuses registreeritud kasutajate arv;\n\n#. Kogumisteenusesse laaditud korralduste arv.\n\nKogumisteenuse üldseisundi tuvastamiseks kogub haldusteenus korrapäraselt\nalamteenustelt nende seisundi kohta andmeid ja peab selle üle arvestust.\n\n.. note::\n\n Kogumisteenusesse laaditud korraldused jagunevad aktiivseteks ja\n arhiveeritud korraldusteks. Aktiivsed korraldused on hetkel teenusele\n rakendatud. Arhiveeritud korraldused on süsteemi laaditud, kuid pole\n rakendatud - näiteks uuema versiooniga asendatud korraldused.\n" }, { "path": "Documentation/et/haldusteenus/ylevaade.rst", "content": ".. IVXV kogumisteenuse haldusliidese kasutusjuhend\n\nÜlevaade\n========\n\nHaldusliidese funktsionaalsus\n-----------------------------\n\nHaldusliides on kogumisteenuse haldamise teenuse veebipõhine kasutajaliides ja\nsellel on järgmised funktsioonid:\n\n* Kogumisteenuse seisundi ja ajaloo kohta ülevaate esitamine:\n\n * Koondülevaade;\n\n * Teenuste seisund;\n\n * Valmisnimekirjade seisund;\n\n * Üldstatistika;\n\n * Kogumisteenuse haldussündmuste logi;\n\n* Korralduste laadimine kogumisteenusesse;\n\n* Kasutajate haldamine;\n\n* Väljavõtete allalaadimine:\n\n * Hääletamise detailstatistika allalaadimine;\n\n * Hääletamisseansside nimekirja allalaadimine;\n\n * E-valimiskasti allalaadimine.\n\n\nLigipääse haldusliidesele\n-------------------------\n\nKogumisteenuse haldusliides on kasutatav veebisirviku abil. Haldusliidesele\nligipääsuks vajaliku ``URL-i`` annab kasutajatele IVXV süsteemihaldur.\n\nHaldusliidesele pääsevad ligi ainult volitatud kasutajad, kes on ennast\nautentinud ID-kaardiga. Kasutajale pakutavate funktsioonide hulk sõltub\nkasutaja volitustest.\n\n\nKasutajaliidese ülevaade\n------------------------\n\nLehe ülaosas asub lehe päis, kus on kirjas haldusliidese nimi ja ikoon\nsisselogitud kasutaja andmete vaatamiseks.\n\nLehe vasakus servas asub menüüriba, mille abil saab navigeerida alamlehtede vahel.\n\n.. note::\n\n Kasutajaliides skaleerub ka madala resolutsiooniga ekraanidele, siis\n peidetakse menüüosa vaikimisi vaatest ja see on avatav lehe päisest.\n\n\nSeadistuste, nimekirjade ja volituste koostamine ning laadimine\n---------------------------------------------------------------\n\nKasutajaliides kaudu on võimalik süsteemi laadida kogumisteenuse seadistusi,\nvalikute- ja valijate nimekirju ning kasutajate volitusi.\n\nNende andmete peavad olema vormistatud digitaalselt signeeritud korraldusena.\nSeadistuspakkide ettevalmistamine on kirjeldatud dokumendis ``IVXV seadistuste\nkoostamise juhend``.\n\nSüsteemi laaditud seadistuspakke on võimalik alla laadida, kui klõpsata\nkasutajaliideses seadistuspaki versiooniandmetel.\n" }, { "path": "Documentation/et/kasutusmall/Makefile", "content": "include ../../common.mk\n" }, { "path": "Documentation/et/kasutusmall/index.rst", "content": ".. IVXV kasutusmallid\n\nIVXV kasutusmallid\n==========================================================\n\n.. raw:: html\n\n

\n NB!\n See on HTML-versioon dokumendist.\n Tellijale antakse üle PDF-versioon.\n

\n\n.. toctree::\n :maxdepth: 3\n :numbered:\n\n sissejuhatus\n tegijad\n kasutusmallid\n" }, { "path": "Documentation/et/kasutusmall/kasutusmallid.rst", "content": ".. IVXV kasutusmallid\n\nKasutusmallid\n=============\n\nHääletamiseelne etapp\n---------------------\n\nKorraldaja - Valimise defineerimine\n```````````````````````````````````\n\nKirjeldus\n'''''''''\n\nRangelt võttes ei ole tegemist elektroonilise hääletamise infosüsteemi kasutusmalliga, kuid see on elektroonilise hääletamise alguspunkt - Korraldaja kirjeldab valimise, küsimused, ringkonnad, valijad ning erinevate rollide täitjad e-hääletamise põhiprotsessides - Lugeja, Koguja, Töötleja jt.\n\nLugeja - Häälte salastamise ja avamise võtme genereerimine\n``````````````````````````````````````````````````````````\n\nKirjeldus\n'''''''''\n\nLugeja genereerib võtmepaari e-häälte salastamiseks ja avamiseks. Avamisvõtme osakud jagatakse Võtmehaldurite vahel.\n\nEeltingimus\n'''''''''''\n\n#. Lugejal on olemas Võtmerakendus.\n#. Läviskeemi tehniline seadistus on olemas.\n#. Leidub Läviskeemi rakendamiseks vajalik hulk Võtmehaldureid ning võtmekandjaid.\n\nPäästik\n'''''''\n\nLugeja algatab võtmepaari genereerimise Võtmerakenduses.\n\nPõhiprotsess\n''''''''''''\n\n#. Võtmerakendus verifitseerib konfiguratsiooni digitaalallkirja.\n#. Võtmerakendus genereerib võtmeosakud vastavalt läviskeemi spetsifikatsioonile.\n#. Võtmerakendus küsib Lugejalt võtmekandjaid osakute talletamiseks.\n#. Võtmerakendus talletab osakud võtmekandjatele.\n#. Võtmerakendus kasutab häälte salastamise võtit sõnumi krüpteerimiseks.\n#. Võtmerakendus testib võtmekandjaid ning taastab 2 erineva kvoorumiga võtme sõnumi dekrüpteerimiseks.\n#. Võtmerakendus allkirjastab krüpteerimisvõtme allkirjastamisvõtmega.\n\nLaiendid\n''''''''\n\n- Tehniliste vigade tekkimisel kõigis põhivoo sammudes logitakse sündmus tehniliste vigade logisse. Kasutajale väljastatakse teade veasituatsiooni kohta..\n\nJäreltingimus\n'''''''''''''\n\nHäälte salastamise ja avamise võtmepaar on edukalt genereeritud, avamise võti on talletatud osakutena võtmekandjatel.\n\n\nKorraldaja - Valijarakenduse seadistuse loomine\n```````````````````````````````````````````````\n\nKirjeldus\n'''''''''\n\nKorraldaja konfigureerib Valijarakenduse poolt kasutatavad tekstid, sertifikaadid, ikoonid ja valimise parameetrid.\n\nEeltingimus\n'''''''''''\nSeadistamiseks on täidetud järgmised tingimused:\n\n- Korraldaja on Valijarakenduse tekstid ette valmistanud\n- Korraldaja on valimise parameetrid ette valmistanud\n- Häälte salastamise võti on olemas.\n\nPõhiprotsess\n''''''''''''\n#. Korraldaja käivitab Seadistamisrakenduse.\n#. Korraldaja sisestab valimise ja küsimuste identifikaatorid ning tüübid.\n#. Korraldaja sisestab valimise küsimused.\n#. Korraldaja laadib häälte salastamise võtme.\n#. Korraldaja konfigureerib Valijarakenduse kasutajaliidese – tekstid, fondid, värvid, ikoonid.\n#. Korraldaja kontrollib kõigi Valijarakenduse vaadete vastavust soovitule.\n#. Korraldaja salvestab loodud konfiguratsiooni.\n\nLaiendid\n''''''''\n\nJäreltingimus\n'''''''''''''\nSeadistamise lõpuks on olemas Valijarakenduse konfiguratsioon, millest on puudu Kogumisteenuse tehniline info.\n\nKorraldaja - Kontrollrakenduse seadistuse loomine\n`````````````````````````````````````````````````\n\nEeltingimus\n'''''''''''\nKorraldajal on olemas\n\n#. Hääletaja allkirja kontrolliks vajalikud sertifikaadid\n#. Registreerimisteenuse kinnituse kontrolliks vajalikud sertifikaadid\n#. Kogumisteenuse allkirja kontrolliks vajalikud sertifikaadid\n#. Käimasoleval valimisel häälte krüpteerimiseks kasutatav avalik võti\n#. Kontrollrakenduse tekstid HTML kujul\n#. Kontrollrakenduse fondid\n#. Kontrollrakenduse värvid\n#. Käimasoleva valimise identifikaator ja küsimused\n\nPõhiprotsess\n''''''''''''\n1. Korraldaja loob Kontrollrakenduse seadistuse\n2. Korraldaja veendub seadistamise õnnestumises vaadates läbi rakenduse vaated\n\nLaiendid\n''''''''\n1. Vaadete mittesobivuse korral muudab Korraldaja seadistusi ning alustab põhiprotsessi algusest.\n\n\nKoguja - Kogumisteenuse seadistamine\n````````````````````````````````````\n\nKirjeldus\n'''''''''\nKoguja valmistab Kogumisteenuse valimiseks ette.\n\nEeltingimus\n'''''''''''\n#. Kogumisteenuse operatsioonisüsteem on paigaldatud\n#. Kogumisteenuse tarkvarapakid on paigaldatud.\n\nPäästik\n'''''''\nKasutusmall algab kui Koguja logib enne hääletamisperioodi algust Kogumisteenusesse.\n\nPõhiprotsess\n''''''''''''\n1. Koguja viib läbi alljärgnevad sammud:\n\n a. Laeb konfiguratsioonipakkide verifitseerimiseks vajaliku sertifikaatide konfiguratsiooni.\n b. Laeb Tuvastusteenuse konfiguratsiooni.\n c. Laeb Allkirjastamisteenuse konfiguratsiooni.\n d. Laeb Registreerimisteenuse konfiguratsiooni.\n e. Laeb mikroteenuste võrgukonfiguratsiooni.\n f. Laeb talletustehnoloogia konfiguratsiooni.\n g. Laeb volitatud nimekirjade laadijate konfiguratsiooni.\n h. Laeb digitaalselt allkirjastatud jaoskondade/ringkondade nimekirja.\n i. Laeb digitaalselt allkirjastatud valikute nimekirja.\n j. Laeb signeeritud valijate nimekirja.\n k. Kogumisteenus kontrollib digitaalallkirju konfiguratsioonipakkidel ja nimekirjadel (tehniline kasutusmall Digitaalallkirja kehtivuse kontroll Kogumisteenuses).\n l. Kogumisteenus kontrollib tuvastatud allkirjastaja volitusi süsteemis.\n m. Kogumisteenus kontrollib konfiguratsiooni vormilist ja sisulist kooskõlalisust ning initsialiseerib sisemised andmestruktuurid.\n\nLaiendid\n''''''''\n- Kui põhiprotsessi sammus 1.k ei tuvastata digitaalallkirja kehtivust, siis väljastatakse veateade, sündmus logitakse vigade logisse, ühtegi muudatust ei rakendata.\n- Kui põhiprotsessi sammus 1.l ei tuvastata digitaalallkirjastaja vastavat volitust volitatud isikute nimekirjast, siis väljastatakse veateade, sündmus logitakse vigade logisse, ühtegi muudatust ei rakendata.\n- Kui põhivoo sammus 1.m tuvastatakse vorminguprobleemid, siis väljastatakse veateade, sündmus logitakse vigade logisse, ühtegi muudatust ei rakendata.\n- Kui põhivoo sammus 1.m tuvastatakse ebakooskõla konfiguratsioonis – valed valimised, korduv jaoskond, korduv ringkond, jaoskond olematus ringkonnas, korduv kandidaat, olematu ringkonnaga kandidaat, korduv valija, olematu jaoskonnaga Hääletaja vms. – siis väljastatakse veateade, sündmus logitakse vigade logisse, ühtegi muudatust ei rakendata.\n- Tehniliste vigade tekkimisel kõigis põhivoo sammudes logitakse sündmus tehniliste vigade logisse. Kasutajale väljastatakse teade veasituatsiooni kohta..\n\nJäreltingimus\n'''''''''''''\nKogumisteenus on kooskõlaliselt seadistatud ning seda on võimalik viia hääletamisetappi.\n\n\nKoguja - Valijarakenduse valmendamine\n`````````````````````````````````````\n\nKirjeldus\n'''''''''\nKoguja valmendab Valijarakenduse.\n\nEeltingimus\n'''''''''''\nValmendamiseks on täidetud järgmised tingimused:\n\n- Korraldaja on loonud omapoolse Valijarakenduse konfiguratsioonifaili\n- Valijarakendus on kompileeritud kõigi toetatavate platvormide jaoks.\n- Valijarakendus on seadistamata.\n- Kogumisteenuse TLS-sertifikaadi usaldamiseks vajalikud sertifikaadid on olemas.\n- Kogumisteenuse URI on teada.\n\nPõhiprotsess\n''''''''''''\n#. Koguja käivitab Seadistamisrakenduse.\n#. Koguja laadib Korraldaja loodud Valijarakenduse konfiguratsioonifaili.\n#. Koguja laadib Kogumisteenuse TLS-sertifikaadi usaldamiseks vajalikud sertifikaadid.\n#. Koguja rakendab loodud seadistuse Valijarakendusele.\n#. Koguja kontrollib kõigi Valijarakenduse vaadete vastavust soovitule.\n\nLaiendid\n''''''''\nMõne vajaliku ressurssi puudumisel seadistamine katkestatakse ning protsessi alustatakse uuesti kui kõik eeltingimused on täidetud.\n\nJäreltingimus\n'''''''''''''\nSeadistamise lõpuks Valijarakendus käivitub ning kasutab seadistatud ressursse.\n\n\nKoguja - Kontrollrakenduse valmendamine\n```````````````````````````````````````\n\nEeltingimus\n'''''''''''\nKogujal on olemas\n\n1. Kompileeritud Kontrollrakendus\n2. Kontrollrakenduse allkirjastamiseks sobiv võtmepaar\n3. Kogumisteenuse võrguaadress\n4. Kogumisteenuse sertifikaadi verifitseerimiseks vajalikud sertifikaadid\n\nPõhiprotsess\n''''''''''''\n1. Koguja seadistab Kontrollrakenduse Kogumisteenuse võrguaadressi ja vastavate sertifikaatidega.\n2. Koguja pakendab rakenduse\n3. Koguja allkirjastab pakendatud rakenduse\n\nKorraldaja - Proovihääletamine\n``````````````````````````````\n\nKirjeldus\n'''''''''\n\nKorraldaja koostöös Koguja, Töötleja, Lugeja ning Võtmehalduritega veendub Kogumisteenuse valmisolekus elektrooniliseks hääletamiseks ning kõigi komponentide kooskõlalises seadistatuses.\n\nEeltingimus\n'''''''''''\n\n#. e-häälte salastamise võti on loodud ja testitud\n#. Kogumisteenus on seadistatud\n#. Valijarakendus on seadistatud\n#. Kontrollrakendus on seadistatud\n\nPõhiprotsess\n''''''''''''\n1. Korraldaja viib läbi testhääletamise\n\n #. Koguja viib Kogumisteenuse hääletamisetappi\n #. Korraldaja annab Valijarakenduse abil ühe või mitu häält\n #. Korraldaja kontrollib Kontrollrakenduse abil hääli\n #. Koguja peatab Kogumisteenuse ja väljastab e-valimiskasti\n #. Töötleja genereerib e-hääletanute nimekirja\n #. Töötleja loob lugemisele minevate anonüümistatud e-häälte nimekirja\n #. Lugeja koos Võtmehalduritega aktiveerib Võtmerakenduse ja häälte avamise võtme\n #. Lugeja dekrüpteerib anonüümistatud hääled ja väljastab hääletamistulemuse\n\n2. Koguja lõpetab testhääletamise ning viib Kogumisteenuse algsesse olekusse, kus talletatud häälte andmebaas on tühi.\n\nLaiendid\n''''''''\n\n- Testhääletamine võib sisaldada ka miksimise ja auditeerimise töövooge.\n\nJäreltingimus\n'''''''''''''\nElektroonilise hääletamise süsteemi komponendid on kontrollitult kooskõlaliselt seadistatud.\n\nHääletamisetapp\n---------------\n\nKorraldaja - Hääletamise alustamine\n```````````````````````````````````\n\nKirjeldus\n'''''''''\nHääletamise alustamine viib Kogumisteenuse hääletamisetappi - algab valikute nimekirjade väljastamine, häälte talletamine ja kontrollpäringutele vastamine.\n\nPäästik\n'''''''\n\n#. Valimise seadistustes näidatud hääletamise algusaeg jõuab kätte.\n#. Korraldaja edastab Haldusteenuse vahendusel digitaalallkirjastatud korralduse hääletamise alustamiseks.\n\nPõhiprotsess\n''''''''''''\n\n1. Kogumisteenus alustab valikute nimekirjade väljastamist, häälte talletamist ja kontrollpäringutele vastamist.\n\nJäreltingimus\n'''''''''''''\n\nKogumisteenus väljastab valikute nimekirju, talletab hääli ning vastab kontrollpäringutele.\n\nHääletaja - Elektrooniline hääletamine Valijarakendusega\n````````````````````````````````````````````````````````\n\nKirjeldus\n'''''''''\nHääletaja kasutab Valijarakendust elektroonilise hääle andmiseks käimasoleval valimisel, mille valijate nimekirja ta kuulub.\n\nEeltingimus\n'''''''''''\nHääletaja on laadinud oma arvutisse käimasoleva valimise jaoks seadistatud Valijarakenduse.\n\nPäästik\n'''''''\nKasutusmall käivitub kui Hääletaja on käivitanud Valijarakenduse.\n\nPõhiprotsess\n''''''''''''\n#. Hääletaja autendib ennast elektroonilise isikutunnistusega (tehniline kasutusmall Autentimine Valijarakenduses) Kogumisteenusele.\n#. Kogumisteenus saadab isikukoodi alusel Valijarakendusele (tehniline kasutusmall Valikute nimekirjade väljastamine Valijarakendusele):\n\n - Hääletaja elukohajärgse valimisringkonna küsimuste ja valikute nimekirja valimisel,\n - teavituse varasema hääletamise kohta, kui sellel valimisel on sama isikukoodi kohta juba talletatud elektrooniline hääl.\n\n3. Valijarakendus esitab Hääletaja isikuandmed, käimasoleva valimise kirjelduse ning küsimused.\n#. Valijarakendus esitab Hääletaja elukohajärgse valimisringkonna valikute nimekirja.\n#. Hääletaja teeb kõigi küsimuste kontekstis kuvatud valikute hulgast valiku.\n#. Valijarakendus esitab Hääletajale tehtud valikute andmed (valiku nimi, valiku number, teatud valimistel ka valimisnimekirja nimi või üksikkandidaat) ning küsib kinnitust valikutele.\n#. Hääletaja kinnitab tehtud valikud.\n#. Valijarakendus krüpteerib Hääletaja valikud valimise avaliku võtmega ning algatab hääle digitaalse allkirjastamise (tehniline kasutusmall Digitaalne allkirjastamine Valijarakenduses) Hääletaja elektroonilise isikutunnistusega. Valijarakendus saadab digitaalselt allkirjastatud hääle Kogumisteenusele talletamiseks (tehniline kasutusmall Hääle talletamine Kogumisteenuses).\n#. Valijarakendus verifitseerib Kogumisteenuse poolt vastusena saadetud Registreerimiskinnitust, kuvab Hääletajale teate hääle edukast talletamisest ning hääle kontrollimiseks vajaliku kontrollkoodi.\n\nLaiendid\n''''''''\n- Hääletaja võib põhiprotsessi läbiviimisel kasutada ligipääsetavustehnoloogiaid (nt. ekraanilugerid).\n- Põhiprotsessi mis tahes etapis asetleidvad vead on fataalsed ning toovad kaasa hääletamisprotsessi katkestamise. Vea põhjuse kõrvaldamise korral tuleb kasutusmall uuesti käivitada.\n\nOlulisimad vead:\n\n- Elektroonilise isikutunnistuse kasutamine ebaõnnestus\n- Sidehäire Valijarakenduse ja Kogumisteenuse vahel\n- Autentimine ebaõnnestus\n- Hääletajal ei ole hääleõigust käimasoleval valimisel\n- Digitaalne allkirjastamine ebaõnnestus\n- Tehnilised vead\n\nJäreltingimus\n'''''''''''''\nÕnnestunud elektroonilise hääletamise korral kuvatakse Hääletajale kontrollkood, mille alusel on võimalik kontrollida elektroonilise hääle jõudmist Kogumisteenusesse ning vastavust Hääletaja tahtele.\nKasutusmalli katkestamine enne elektroonilise hääle digitaalset allkirjastamist ei mõjuta Hääletaja Kogumisteenuses eelnevalt talletatud häält.\n\nHääletaja - Elektroonilise hääle kontrollimine Kontrollrakendusega\n``````````````````````````````````````````````````````````````````\n\nKirjeldus\n'''''''''\nHääletaja kasutab vahetult peale hääletamist Valijarakendusega Kontrollrakendust elektroonilise hääle korrektse jõudmise Kogumisteenusesse kontrollimiseks.\n\nEeltingimus\n'''''''''''\n#. Hääletaja valduses on Kontrollrakendusega mobiilseade.\n#. Hääletaja on kasutanud Valijarakendust hääletamiseks.\n#. Hääle kontrollimise ajaaken ei ole veel möödunud.\n#. Valijarakenduse viimane vaade on ekraanil avatud ning kuvab kontrollimiseks vajalikku infot sisaldavat QR-koodi.\n\nPäästik\n'''''''\nKasutusmall käivitub kui Hääletaja on käivitanud Kontrollrakenduse.\n\nPõhiprotsess\n''''''''''''\nPõhiprotsess on ühesuunaline, tagasi liikumised protsessis eeldavad Kontrollrakenduse töö lõpetamist.\n\n#. Kontrollrakendus laadib Kogumisteenusest seadistused.\n#. Kontrollrakendus kuvab tervitusteksti.\n#. Hääletaja suunab mobiilseadme kaamera Valijarakenduses kuvatavale QR-koodile.\n#. Kontrollrakendus analüüsib QR-koodi ning tuvastab sealt hääle krüpteerimiseks kasutatud juhuarvu ning häält Kogumisteenuses identifitseeriva sessiooniidentifikaatori.\n#. Kontrollrakendus pöördub sessiooniidentifikaatoriga Kogumisteenuse poole.\n#. Kontrollrakendus verifitseerib Kogumisteenuse sertifikaadi ning kuvab Hääletajale info verifitseerimise õnnestumise kohta.\n#. Kontrollrakendus laadib Kogumisteenusest alla Kogumisteenuse allkirjastatud hääle, Registreerimisteenuse kinnituse ja häälega seotud valikute nimekirjad (tehniline kasutusmall Hääle väljastamine kontrollimiseks Kogumisteenusest).\n#. Kontrollrakendus veendub, et hääl vastab kontrollprotokolli nõuetele. Kontrollrakendus verifitseerib Registreerimisteenuse kinnitust ning Hääletaja allkirja. Kontrollrakendus kuvab Hääletajale info verifitseerimiste õnnestumise kohta, hääle allkirjastanud Hääletaja andmed ning küsimused, mille kohta antud hääles leidub krüpteeritud tahteavaldus.\n#. Hääletaja käivitab kontrollalgoritmi.\n#. Kontrollrakendus puhastab vaate hääle allkirjastanud Hääletaja andmetest.\n#. Kontrollrakendus tuvastab krüpteeritud tahteavalduse sisu kasutades kontrollalgoritmi ja QR-koodist saadud juhuarvu.\n#. Kontrollrakendus kuvab iga krüpteeritud tahteavalduse kohta Hääletajale küsimuse identifikaatorit ja tuvastatud valikut.\n\nLaiendid\n''''''''\n#. Kui Kontrollrakendus tuvastab võrguühenduse puudumise, siis suunatakse Hääletaja võrguühendust aktiveerima.\n#. Kui Kontrollrakendus tuvastab vea Kogumisteenuse sertifikaadis, siis lõpetatakse rakenduse töö veateatega.\n#. Kui Kogumisteenusest ei saadud häält või Registreerimisteenuse kinnitust, siis juhendatakse Hääletajat Kliendituge informeerima ja lõpetatakse rakenduse töö veateatega.\n#. Kui Kogumisteenusest tuleb teade, et konkreetse hääle kontrollimine ei ole enam võimalik (aeg või korrad ületatud), siis lõpetatakse rakenduse töö vastavasisulise teatega.\n#. Kui Kogumisteenusest saadud hääl ei vasta nõuetele, siis lõpetatakse rakenduse töö veateatega.\n#. Kui Hääletaja allkirja verifitseerimine ebaõnnestub, siis lõpetatakse rakenduse töö veateatega.\n#. Kui Registreerimisteenuse kinnituse verifitseerimine ebaõnnestub, siis lõpetatakse rakenduse töö veateatega.\n#. Kui kontrollalgoritm ei leia kandidaatide nimekirjast sobivat valikut, siis kuvatakse konkreetse valimise ja küsimuse identifikaatori järel veateade.\n#. Kui QR koodis sisaldub rohkem kui ühe küsimuse kontrollkood, siis teostatakse kontroll kõigi viidatud küsimuste jaoks.\n#. Kui Kogumisteenusest saadetud allkirjastatud hääles on krüpteeritud hääli, mille kohta puudub kontrollkood, siis esitab Kontrollrakendus Hääletajale nende valimiste/küsimuste identifikaatorid ning vastavasisulise hoiatuse. Ülejäänud hääled kontrollitakse.\n#. Kui Kogumisteenusest saadetud allkirjastatud hääles ei ole kõiki hääli, mille kohta on kontrollkood, siis esitab Kontrollrakendus Hääletajale nende valimiste/küsimuste identifikaatorid ning vastavasisulise hoiatuse. Ülejäänud hääled kontrollitakse.\n#. Kui kontrollalgoritm lõpetab veateatega, siis juhendatakse Hääletajat Kliendituge informeerima.\n\nJäreltingimus\n'''''''''''''\nKui hääle kontrollimisega ületatakse lubatud kontrollimiste limiit, siis Kogumisteenus rohkem häält kontrollida ei võimalda.\n\n\nKogumisteenuse Haldur - Kogumisteenuse seisundi kuvamine\n````````````````````````````````````````````````````````\n\nPäästik\n'''''''\nKogumisteenuse Haldur siseneb Kogumisteenuse Haldusteenusesse.\n\nPõhiprotsess\n''''''''''''\n\n#. Haldusteenus autendib kasutaja ning tuvastab autenditud kasutaja volitused Haldusteenuses\n#. Vastavalt volituste määrale kuvab Kogumisteenus alamhulka järgmisest informatsioonist:\n\n #. Valimise identifikaator, küsimused, hääletusetapp\n #. Töötavad teenusserverid\n #. Laetud nimekirjad - ringkonnad, valijad, valikud\n #. Hääletamise statistika\n #. Kogumisteenuse volitatud kasutajad\n #. Kogumisteenuse tehniline logi\n\n\nKorraldaja - Hääletamise lõpetamine\n```````````````````````````````````\n\nKirjeldus\n'''''''''\nHääletamise lõpetamine lõpetab häälte vastuvõtmise Kogumisteenuse poolt. Hääletamise lõpetamine toimub järk-järgult – Hääletajad, kes on saanud kandidaatide nimekirja enne hääletamise ametlikku lõppu, peavad saama mõistliku aja jooksul hääletada.\n\nPäästik\n'''''''\n\n#. Valimise seadistustes näidatud hääletamise lõpetamise aeg jõuab kätte.\n#. Korraldaja edastab Haldusteenuse vahendusel digitaalallkirjastatud korralduse hääletamise lõpetamiseks.\n\nPõhiprotsess\n''''''''''''\n1. Kogumisteenus vastab kõigile kandidaatide nimekirjade päringutele veateatega, kuid jätkab häälte talletamispäringute teenindamist.\n2. Kogumisteenus lõpetab korralduses/konfiguratsioonis näidatud aja möödudes häälte vastuvõtmise.\n3. Kogumisteenus vastab kõigile Valijarakendustelt tulevatele päringutele veateatega.\n\nJäreltingimus\n'''''''''''''\nKogumisteenus ei võta enam uusi hääli vastu.\n\n\nTöötlusetapp\n------------\n\nKoguja - E-valimiskasti väljastamine\n````````````````````````````````````\n\nKirjeldus\n'''''''''\n\nKoguja ekspordib e-valimiskasti Kogumisteenuse andmebaasist.\n\nEeltingimus\n'''''''''''\n\nElektrooniline hääletamine on lõpetatud.\n\nPäästik\n'''''''\n\nKoguja valib Haldusteenusest e-valimiskasti eksportimise funktsionaalsuse.\n\nPõhiprotsess\n''''''''''''\n\n#. Kogumisteenus teeb häälte andmebaasist väljavõtte, mis sisaldab kogu talletamisteenuses sisalduvat häältega seotud infot.\n\nJäreltingimus\n'''''''''''''\n\nE-valimiskast on eksporditud.\n\n\nTöötleja - E-valimiskasti verifitseerimine\n``````````````````````````````````````````\n\nKirjeldus\n'''''''''\n\nTöötleja verifitseerib Kogujalt saadud e-valimiskasti kooskõlalisust ning selle vastavust Registreerimisteenuselt saadud informatsioonile.\n\nEeltingimus\n'''''''''''\n\n- E-valimiskast on väljastatud\n- Registreerimiskinnitused on väljastatud\n\nPäästik\n'''''''\n\nTöötleja käivitab vastava funktsionaalsuse Töötlemisrakenduse kasutajaliideses.\n\nPõhiprotsess\n''''''''''''\n\n#. Töötlemisrakendus laadib seadistused\n#. Töötlemisrakendus kontrollib seadistuste digitaalallkirja\n#. Töötlamisrakendus kontrollib seadistuste kooskõlalisust\n#. Töötlemisrakendus laadib e-valimiskasti\n#. Töötlemisrakendus kontrollib e-häälte digitaalallkirja\n#. Töötlemisrakendus laadib registreerimiskinnitused\n#. Töötlemisrakendus verifitseerib registreerimiskinnitused\n#. Töötlemisrakendus kontrollib e-valimiskasti ja registreerimiskinnituste kooskõlalisust\n\nLaiendid\n''''''''\n- Tehniliste vigade tekkimisel kõigis põhiprotsessi sammudes logitakse sündmus tehniliste vigade logisse. Kasutajale väljastatakse teade veasituatsiooni kohta ning protsess peatatakse.\n- Kasutajal on võimalus viia protsess läbi selliselt et vigadega seotud Hääletajad eraldatakse muust e-valimiskastist. Tulemuseks on probleemsete häälte raport ja puhastatud e-valimiskast.\n\nJäreltingimus\n'''''''''''''\n\nE-valimiskasti verifitseerimise raport identifitseerib üheselt korrektsed ja probleemsed hääled.\n\n\nTöötleja - Elektrooniliselt hääletanute nimekirja koostamine\n````````````````````````````````````````````````````````````\nKirjeldus\n'''''''''\nPeale hääletamisperioodi lõppu koostab Töötleja valimisjaoskondade kaupa nimekirjad elektrooniliselt hääletanud isikutest. Nimekirjad on nii inim- kui masinloetavad.\n\nEeltingimus\n'''''''''''\n\nE-valimiskast on edukalt verifitseeritud.\n\nPäästik\n'''''''\nTöötleja käivitab vastava funktsionaalsuse Töötlemisrakenduse kasutajaliideses.\n\nPõhiprotsess\n''''''''''''\n1. Töötlemisrakendus tühistab korduvad hääled, jättes iga Hääletaja kohta alles ajaliselt kõige viimasena antud hääle.\n2. Töötlemisrakendus sorteerib kehtivad hääled valimisjaoskondade kaupa.\n3. Töötlemisrakendus loob elektrooniliselt hääletanute nimekirjade faili.\n\n 1. Iga kehtiva hääle kohta lisab Töötlemisrakendus faili ühe kirje, kus sisaldub isikukood, nimi, valimisjaoskonna number ja rea number valimisringkonna nimekirjas. Andmed võetakse valijate nimekirjast.\n\n4. Töötlemisrakendus esitab vastuvõetud häälte koguarvu ning elektrooniliselt hääletanute arvu.\n5. Töötleja salvestab nimekirja välisele andmekandjale.\n\nLaiendid\n''''''''\nKui põhiprotsessi sammus 3 ei tuvastata isikukoodi valijate nimekirjast, siis logitakse vastavasisuline informatsioon ning jätkatakse põhiprotsessiga.\n\nJäreltingimus\n'''''''''''''\nKehtivad hääled on kantud e-hääletanute nimekirja. Korduvad hääled on tühistatud.\n\nTöötleja - Miksimisele/Lugemisele minevate e-häälte anonümiseerimine\n````````````````````````````````````````````````````````````````````\n\nKirjeldus\n'''''''''\n\nTöötleja rakendab tühistus- ja ennistusnimekirju ning loob lugemisele minevate e-häälte anonümiseeritud hulga.\n\nEeltingimus\n'''''''''''\n\nE-valimiskast on edukalt verifitseeritud ning elektrooniliselt hääletanute nimekiri koostatud.\n\nPäästik\n'''''''\n\nTöötleja käivitab vastava funktsionaalsuse Töötlemisrakenduse kasutajaliideses.\n\nPõhiprotsess\n''''''''''''\n\n Töötlemisrakendus verifitseerib tühistus- ja ennistusnimekirjade digitaalallkirjad.\n Töötlemisrakendus kontrollib tühistus- ja ennistusnimekirjade kooskõlalisust järjekorras.\n Töötlemisrakendus rakendab tühistus- ja ennistusnimekirju järjekorras.\n Töötlemisrakendus koostab miksimisele/lugemisele minevate häälte nimekirja eraldades krüptogrammid digitaalallkirjadest.\n Töötlemisrakendus väljastab lõpliku elektrooniliselt hääletanute nimekirja masinloetavas vormingus.\n\nLaiendid\n''''''''\n\n - Kui põhiprotsessi sammus 1 Korraldaja allkirja verifitseerimine või volituse kontroll ebaõnnestuvad, siis väljastatakse veateade Ühtegi muudatust ei rakendata.\n\nJäreltingimus\n'''''''''''''\n\nMiksimisele/lugemisele minevate häälte hulk on koostatud, elektrooniliselt hääletanute nimekiri on väljastatud.\n\nMiksija - Miksimine\n```````````````````\n\nKirjeldus\n'''''''''\n\nEeltingimus\n'''''''''''\n\nPäästik\n'''''''\n\nPõhiprotsess\n''''''''''''\n\n#. Miksija käivitab Miksimisrakenduse ning laadib anonüümistatud e-hääled\n#. Miksimisrakendus rerandomiseerib ning permuteerib e-hääled, tulemuseks on uued e-hääled\n#. Miksimisrakendus genereerib tõestuse, et uued e-hääled on algsete e-häältega sisuliselt samaväärsed\n#. Miksimisrakendus väljastab nii miksitud hääled kui Miksimistõendi\n\nLaiendid\n''''''''\n\nJäreltingimus\n'''''''''''''\n\nAlgsete häältega tõestatavalt samaväärsed, miksitud hääled on väljastatud.\n\nLugemisetapp\n------------\n\nLugeja - Elektroonilise hääletamise tulemuse kindlaks tegemine\n``````````````````````````````````````````````````````````````\n\nKirjeldus\n'''''''''\nTühistusperioodi lõppedes sorteeritakse ümbrikud valimisringkondade kaupa. Välised ümbrikud avatakse. s.t. digitaalallkirjad eemaldatakse, järgi jäävad häälte salastamise võtmega krüpteeritud hääled, mis dekrüpteeritakse Võtmerakendusega.\n\nPõhiprotsess\n''''''''''''\n#. Lugeja algatab häälte kokku lugemise Võtmerakendusega.\n#. Võtmehaldurid aktiveerivad vastavalt võtmehalduse protseduuridele häälte avamise võtme.\n#. Võtmerakendus loeb krüpteeritud hääled väliselt andmekandjalt.\n#. Võtmerakendus teostab häältefaili tehnilise kontrolli ning algatab häälte krüpteerimise.\n#. Võtmerakendus kontrollib dekrüpteeritud hääle vastavust avakujul hääle vormingule.\n#. Võtmerakendus kontrollib hääle kehtivust, veendudes et dekrüpteerimisel selgunud kandidaat kuulus antud ringkonnas valikute hulka.\n#. Võtmerakendus summeerib arvesse minevad hääled jaoskondade, ringkondade ja kandidaatide kaupa.\n#. Võtmerakendus kannab hääletamistulemuse andmekandjale.\n#. Hääletamistulemus imporditakse valimiste infosüsteemi.\n\nLaiendid\n''''''''\n- Tehniliste vigade tekkimisel kõigis põhiprotsessi sammudes logitakse sündmus tehniliste vigade logisse. Kasutajale väljastatakse teade veasituatsiooni kohta ning protsess peatatakse.\n- Põhiprotsessi sammudes 4 ja 5 tehtavate kontrollide ebaõnnestumise korral loetakse antud hääl kehtetuks ning protsessi jätkatakse järgmise krüpteeritud hääle juurest.\n\nJäreltingimus\n'''''''''''''\nHääletamistulemus on sisestatud valimiste infosüsteemi.\n\nAuditeerimisetapp\n-----------------\n\nAudiitor - Auditeerimine\n````````````````````````\n\nKirjeldus\n'''''''''\n\nPeale hääletamistulemuse väljaselgitamist on Audiitoril võimalik kontrollida Miksimistõendit ja Lugemistõendit.\n\n\nEeltingimus\n'''''''''''\n\n- Hääletamistulemus, krüptogrammid ning lugemistõend on olemas\n- Miksimiseelsed krüptogrammid, miksimisjärgsed krüptogrammid ning miksimistõend on olemas\n\nPõhiprotsess\n''''''''''''\n\n1. Audiitor kasutab Auditirakendust Lugemistõendi kontrollimiseks\n2. Audiitor kasutab Auditirakendust Miksimistõendi kontrollimiseks\n\nLaiendid\n''''''''\n\nJäreltingimus\n'''''''''''''\n\nLugemistõend ja Miksimistõend on kontrollitud.\n\n\nTehnilised kasutusmallid\n------------------------\n\nAutentimine Valijarakenduses\n````````````````````````````\n\nKirjeldus\n'''''''''\nValijarakenduse vahendusel ja elektroonilise isikutunnistuse abil tuvastab Kogumisteenus Hääletaja isiku.\n\nPäästik\n'''''''\nKasutusmall käivitatakse kui Hääletaja käivitab Valijarakenduse ning suundub hääletama.\n\nPõhiprotsess – ID kaart\n'''''''''''''''''''''''\n1. Hääletaja sisestab ID-kaardi lugejasse.\n2. Valijarakendus pöördub Kogumisteenuse poole protokolli algatamiseks.\n3. Kogumisteenus saadab Valijarakendusele oma sertifikaadi.\n4. Valijarakendus kontrollib Kogumisteenuse sertifikaati.\n5. Kogumisteenus nõuab Hääletaja autentimist TLS-protokolli kohaselt.\n6. Valijarakendus küsib valijalt ID-kaardi autentimisvõtme kasutamiseks PIN1 koodi.\n7. Hääletaja sisestab PIN1 koodi.\n8. Valijarakendus ja Kogumisteenus viivad läbi TLS-protokolli, Kogumisteenuse saadetakse Hääletaja sertifikaat.\n9. Kogumisteenus kontrollib Hääletaja sertifikaati.\n10. Kogumisteenus tuvastab Hääletaja isikukoodi.\n\nPõhiprotsess – Mobiil-ID\n''''''''''''''''''''''''\n1. Hääletaja sisestab Valijarakendusse oma Mobiil-ID SIM kaarti sisaldava mobiiltelefoni numbri.\n2. Valijarakendus pöördub Kogumisteenuse poole protokolli algatamiseks.\n3. Kogumisteenus saadab Valijarakendusele oma sertifikaadi.\n4. Valijarakendus kontrollib Kogumisteenuse sertifikaati.\n5. Valijarakendus saadab telefoninumbri Kogumisteenusele.\n6. Kogumisteenus algatab autentimise Mobiil-ID teenuse kaudu.\n7. Kogumisteenus saadab Mobiil-ID kontrollkoodi Valijarakendusele, mis kuvab seda valijale.\n8. Hääletaja saab mobiiltelefonile autentimissõnumi.\n9. Hääletaja võrdleb autentimissõnumi kontrollkoodi Valijarakenduses kuvatavaga.\n10. Hääletaja sisestab autentimisvõtme kasutamiseks PIN1 koodi.\n11. Kogumisteenus ja Mobiil-ID teenus viivad läbi autentimise, Kogumisteenuse saadetakse Hääletaja sertifikaat.\n12. Kogumisteenus kontrollib Hääletaja sertifikaati.\n13. Kogumisteenus tuvastab Hääletaja isikukoodi.\n14. Valijarakendus küsib regulaarselt, kas autentimine on toimunud, Kogumisteenus vastab.\n\nLaiendid\n''''''''\n- Kui ID-kaarti ei ole lugejas, siis katkestab Valijarakendus töö veateatega (ID-kaart).\n- Kui Kogumisteenus ei ole kättesaadav, siis katkestab Valijarakendus töö veateatega.\n- Kui Kogumisteenuse sertifikaadi kehtivust ei õnnestu kontrollida või kui sertifikaat ei vasta Kogumisteenuse nimele, siis katkestab Valijarakendus töö veateatega.\n- Kui ID-kaardi kasutamine ebaõnnestub, siis katkestab Valijarakendus töö veateatega. (ID-kaart)\n- Kui Kogumisteenuses annab Hääletaja sertifikaadi kontroll negatiivse tulemuse, siis saadetakse Valijarakendusele veateade ning autentimine katkestatakse.\n- Kui Mobiil-ID protokolli läbiviimine ebaõnnestub, siis vastab Kogumisteenus Valijarakenduse päringule veateatega ning autentimine katkestatakse. (Mobiil-ID)\n\nJäreltingimus\n'''''''''''''\nKogumisteenus teab Hääletaja sertifikaati ning on tuvastanud sellest isikukoodi.\n\nDigitaalne allkirjastamine Valijarakenduses\n```````````````````````````````````````````\n\nKirjeldus\n'''''''''\nValijarakenduse abil antakse digitaalallkirja vahendi abil krüpteeritud häälele digitaalallkiri.\n\nEeltingimus\n'''''''''''\nHääletaja on teinud oma valikud ja kinnitanud need. Valijarakendus on valikud krüpteerinud Kogumisteenuse avaliku võtmega.\nMobiil-ID korral teab Kogumisteenus juba Hääletaja Mobiil-ID SIM kaardiga mobiiltelefoninumbrit, kuna autentimine on edukalt toimunud.\n\nPäästik\n'''''''\nHääletaja on valinud Valijarakenduses hääletamise funktsionaalsuse, kõik valikud on krüpteeritud Kogumisteenuse avaliku võtmega.\n\nPõhiprotsess – ID-kaart\n'''''''''''''''''''''''\n1. Valijarakendus moodustab BES vormingus BDOC konteineri.\n2. Valijarakendus lisab konteinerisse andmefailidena krüpteeritud valikud.\n3. Valijarakendus moodustab allkirjastatava räsi BDOC standardi kohaselt.\n4. Valijarakendus algatab räsi signeerimise ID-kaardiga.\n5. Hääletaja sisestab PIN2 koodi allkirjastamisvõtme kasutamiseks.\n6. Valijarakendus lisab Hääletaja signatuuri ja allkirjastamissertifikaadi BDOC konteinerile.\n\nPõhiprotsess – Mobiil-ID\n''''''''''''''''''''''''\n1. Valijarakendus moodustab BES vormingus BDOC konteineri.\n2. Valijarakendus lisab konteinerisse andmefailidena krüpteeritud valikud.\n3. Valijarakendus saadab konteineri Kogumisteenusele.\n4. Kogumisteenus moodustab allkirjastatava räsi BDOC standardi kohaselt.\n5. Kogumisteenus algatab räsi signeerimise Mobiil-ID teenusega.\n6. Kogumisteenus saadab Mobiil-ID kontrollkoodi Valijarakendusele, mis kuvab seda valijale.\n7. Hääletaja saab mobiiltelefonile allkirjastamissõnumi.\n8. Hääletaja võrdleb allkirjastamissõnumi kontrollkoodi Valijarakenduses kuvatavaga.\n9. Hääletaja sisestab allkirjastamisvõtme kasutamiseks PIN2 koodi.\n10. Kogumisteenus ja Mobiil-ID teenus viivad läbi allkirjastamise, Kogumisteenuse saadetakse digitaalselt allkirjastatud ja kehtivuskinnitusega TS vormingus BDOC konteiner.\n11. Valijarakendus küsib regulaarselt, kas allkirjastamine on toimunud, Kogumisteenus vastab.\n12. TS vormingus BDOC konteiner edastatakse Valijarakendusele verifitseerimiseks.\n\nLaiendid\n''''''''\n- Kui ID-kaarti ei ole lugejas, siis katkestab Valijarakendus töö veateatega (ID-kaart).\n- Kui Kogumisteenus ei ole kättesaadav, siis katkestab Valijarakendus töö veateatega.\n- Kui ID-kaardi kasutamine ebaõnnestub, siis katkestab Valijarakendus töö veateatega. (ID-kaart)\n- Kui Mobiil-ID protokolli läbiviimine ebaõnnestub, siis vastab Kogumisteenus Valijarakenduse päringule veateatega ning allkirjastamine katkestatakse. (Mobiil-ID)\n\nJäreltingimus\n'''''''''''''\nHääletaja hääl on digitaalselt allkirjastatud.\n\nDigitaalallkirja kehtivuse kontroll Kogumisteenuses\n```````````````````````````````````````````````````\n\nKirjeldus\n'''''''''\nKogumisteenus kontrollib digitaalallkirju ID-kaardi ja Mobiil-ID'ga allkirjastatud e-häältel ning seadistamisel ja tühistamisel kasutatavatel sisendfailidel.\n\nEeltingimus\n'''''''''''\nKogumisteenusede sertifikaatide konfiguratsioon on tehtud. Kogumisteenuse kehtivuskinnitusteenuse konfiguratsioon on tehtud.\n\nPäästik\n'''''''\nKogumisteenus algatab digitaalallkirja kehtivuse kontrolli.\n\nPõhiprotsess\n''''''''''''\n1. Kogumisteenus tuvastab profiili, millest lähtudes kontroll läbi viia:\n\n 1. ID-kaardiga allkirjastatud hääl võib olla BES või TS vormingus, tohib sisaldada mitut andmefaili ja täpselt ühte allkirja.\n 2. Mobiil-ID'ga allkirjastatud hääl peab olema TS vormingus, tohib sisaldada mitut andmefaili ja täpselt ühte allkirja.\n 3. Muud failid peavad olema TS vormingus, tohivad sisaldada täpselt ühte andmefaili ja täpselt ühte allkirja.\n\n2. Kogumisteenus veendub allkirja vastavuses nõutud profiilile.\n3. Kui allkiri on BES vormingus, siis pöördub Kogumisteenus kehtivuskinnitusteenuse poole sertifikaadi kehtivuse kontrolliks. Kogumisteenus liidab kehtivuskinnituse digitaalallkirjale, tulemuseks on TS vormingus allkiri.\n4. Kogumisteenus kontrollib TS vormingus allkirja:\n\n 1. Signatuuri.\n 2. Sertifikaadi kehtivuskinnitust.\n\nLaiendid\n''''''''\n- Tehniliste vigade tekkimisel kõigis põhiprotsessi sammudes logitakse sündmus tehniliste vigade logisse. Välja kutsuvale protsessile väljastatakse teade veasituatsiooni kohta.\n- Kehtivuskinnituse laadimise ebaõnnestumisel põhiprotsessi sammus 3 logitakse sündmus tehniliste vigade logisse. Välja kutsuvale protsessile väljastatakse teade veasituatsiooni kohta.\n- Kontrollide ebaõnnestumisel põhiprotsessi sammus 4 logitakse sündmus tehniliste vigade logisse. Välja kutsuvale protsessile väljastatakse teade veasituatsiooni kohta.\n\nValikute nimekirjade väljastamine Valijarakendusele\n```````````````````````````````````````````````````\n\nKirjeldus\n'''''''''\nKogumisteenus väljastab Valijarakendusele valikute nimekirja.\n\nEeltingimus\n'''''''''''\nHääletaja autentimine on õnnestunult toimunud.\n\nPäästik\n'''''''\nValijarakendus on pöördunud Kogumisteenuse poole valikute nimekirja alla laadimiseks.\n\nPõhiprotsess\n''''''''''''\n1. Kogumisteenus kontrollib isikukoodi kasutades, millisesse valimisringkonda Hääletaja kuulub.\n2. Kogumisteenus kontrollib, kas Hääletaja kohta on juba mõni hääl talletatud.\n3. Kogumisteenus saadab Valijarakendusele ringkonnakohase kandidaatide nimekirja kõigi valimise kohta, kus isikukood on nimekirja kantud ning informatsiooni võimaliku korduvhääletamise kohta.\n\nLaiendid\n''''''''\n- Tehniliste vigade tekkimisel kõigis põhiprotsessi sammudes logitakse sündmus tehniliste vigade logisse. Valijarakendust teavitatakse protsessi ebaõnnestumisest.\n- Kui põhiprotsessi sammus 2 on selge, et Hääletaja ei kuulu käimasoleva valimise valijate nimekirja, siis saadetakse Valijarakendusele vastavasisuline veateade.\n\nHääle talletamine Kogumisteenuses\n`````````````````````````````````\n\nKirjeldus\n'''''''''\nKogumisteenus talletab Hääletaja hääle.\n\nEeltingimus\n'''''''''''\nHääle digitaalne allkirjastamine Valijarakenduses on edukalt toimunud.\n\nPäästik\n'''''''\nValijarakendus on saatnud hääle talletamisele.\n\nPõhiprotsess\n''''''''''''\n1. Kogumisteenus kontrollib hääle digitaalallkirja (tehniline kasutusmall Digitaalallkirja kehtivuse kontroll Kogumisteenuses). Kontrolli käigus tagatakse muu hulgas kehtivuskinnituse lisamine allkirjale.\n2. Kogumisteenus kontrollib hääle allkirjastanud ja valikute nimekirja laadimisel TLS protokollis autenditud isikukoodide samasust.\n3. Kogumisteenus registreerib hääle vastuvõtmise Registreerimisteenuses.\n4. Kogumisteenus genereerib häälega seostatud unikaalse identifikaatori.\n5. Kogumisteenus salvestab hääle koos unikaalse identifikaatoriga.\n6. Kogumisteenus tagastab Valijarakendusele õnnestumise teate koos häälele viitava unikaalse identifikaatoriga ja Registreerimisteenuse kinnitusega\n\nLaiendid\n''''''''\n- Tehniliste vigade tekkimisel kõigis põhiprotsessi sammudes logitakse sündmus tehniliste vigade logisse. Valijarakendust teavitatakse protsessi ebaõnnestumisest. Häält ei talletata.\n- Kui põhiprotsessi sammus 1 digitaalallkirja kontroll ebaõnnestub, siis logitakse sündmus tehniliste vigade logisse. Valijarakendust teavitatakse protsessi ebaõnnestumisest. Häält ei talletata.\n- Kui põhiprotsessi sammus 2 isikukoodid erinevad, siis logitakse sündmus tehniliste vigade logisse. Valijarakendust teavitatakse protsessi ebaõnnestumisest. Häält ei talletata.\n\nJäreltingimus\n'''''''''''''\nDigitaalselt allkirjastatud hääl on varustatud kehtivuskinnitusega, Kogumisteenuse poolse kinnitusega ning talletatud Kogumisteenuses seostatuna unikaalse identifikaatoriga.\n\nHääle väljastamine kontrollimiseks Kogumisteenusest\n```````````````````````````````````````````````````\n\nKirjeldus\n'''''''''\nKogumisteenus väljastab Kontrollrakendusele kontrollimiseks allkirjastatud hääle ja registreerimiskinnituse.\n\nPäästik\n'''''''\nKontrollrakendus on esitanud Kogumisteenusele unikaalse identifikaatoriga hääle kontrollimise päringu.\n\nPõhiprotsess\n''''''''''''\n1. Kogumisteenus kontrollib, kas unikaalsele identifikaatorile vastab elektrooniline hääl.\n2. Kogumisteenus kontrollib, kas unikaalsele identifikaatorile vastava hääle kontrollimine on veel võimalik vastavalt aja ja kordade tingimustele.\n3. Kogumisteenus suurendab konkreetse hääle kontrollimise kordade loendurit.\n4. Kogumisteenus väljastab Kontrollrakendusele unikaalse identifikaatori poolt viidatud hääle koos ringkonna valikute nimekirjaga ning häälele vastava registreerimiskinnitusega.\n\nLaiendid\n''''''''\n- Tehniliste vigade tekkimisel kõigis põhiprotsessi sammudes logitakse sündmus tehniliste vigade logisse. Kontrollrakendust teavitatakse protsessi ebaõnnestumisest. Häält ei väljastata.\n- Kui põhiprotsessi sammus 1 ei leita unikaalsele identifikaatorile vastavat häält, siis logitakse sündmus tehniliste vigade logisse. Kontrollrakendust teavitatakse protsessi ebaõnnestumisest. Häält ei väljastata.\n- Kui põhiprotsessi sammus 2 tehtavad kontrollid annavad negatiivse tulemuse, siis logitakse sündmus tehniliste vigade logisse. Kontrollrakendust teavitatakse protsessi ebaõnnestumisest. Häält ei väljastata.\n\nElektrooniliste häälte avalduse alusel tühistamine/ennistamine\n``````````````````````````````````````````````````````````````\n\nKirjeldus\n'''''''''\nKorraldaja poolt kinnitatud digitaalallkirjastatud tühistus-/ennistuskannete faili import Töötleja poolt. Töötlemisrakendus teostab tühistused/ennistused, logides tegevused. Töötlejale kuvatakse tühistamise/ennistamise tulem – aruanne tühistustest/ennistustest koos tulemusega.\n\nPäästik\n'''''''\n\nTöötlemisrakendus käivitab vastava funktsionaalsuse.\n\nPõhiprotsess\n''''''''''''\n#. Töötlemisrakendus verifitseerib avalduse digitaalallkirja.\n#. Töötlemisrakendus kontrollib, et avaldus oleks allkirjastatud volitatud kasutaja poolt.\n#. Töötlemisrakendus loeb failist kandeid ning viib operatsioonid täide märkides hääle kas tühistatuks või ennistatuks.\n#. Kogumisteenus kuvab avalduse rakendamise tulemusi.\n\nLaiendid\n''''''''\n- Kui põhiprotsessi sammus 1 tuvastatakse digitaalallkirja mittekehtivus, siis logitakse tehniliste vigade logisse vastav kanne ning protsess peatatakse.\n- Kui põhiprotsessi sammus 2 tuvastatakse, et avalduse allkirjastajal ei ole vastavaid volitusi, siis logitakse tehniliste vigade logisse vastav kanne ning protsess peatatakse.\n- Kui põhiprotsessi sammus 3 tuvastatakse, et isikukoodiga identifitseeritud Hääletaja hääl on mittesobivas olekus või Hääletaja ei ole hääletanud, siis logitakse aruandesse vastav kanne ning protsessi jätkatakse järgmise kandega.\n- Tehniliste vigade tekkimisel kõigis põhivoo sammudes logitakse sündmus tehniliste vigade logisse. Kasutajale väljastatakse teade veasituatsiooni kohta ning protsess peatatakse.\n\nJäreltingimus\n'''''''''''''\nTühistatud hääled ei lähe lugemisele, ennistatud hääled lähevad lugemisele.\n" }, { "path": "Documentation/et/kasutusmall/sissejuhatus.rst", "content": ".. IVXV kasutusmallid\n\nSissejuhatus\n============\n\nDokument kirjeldab elektroonilise hääletamise süsteemi kasutusmallimudeli. Dokument on jaotatud kaheks osaks: tegijad ja kasutusmallid. Esimeses osas on kirjeldatud kasutusmallimudeli tegijad. Teises osas on kirjeldatud elektroonilise hääletamise süsteemi kasutusmallid.\n\nViited\n------\n1. [UML] – UMLi kontsentraat. Objektmodelleerimise standardkeele UML 2.0 lühijuhend. Martin Fowler. Cybernetica AS.\n\nKasutatud metoodika\n-------------------\n\nKasutusmallimudel\n`````````````````\n Kasutusmallid on abivahend, mis aitab aru saada süsteemi talitlusnõuetest. Kasutusmallid esitavad süsteemi välisvaate kirjeldades süsteemi kasutajate ja süsteemi vahelisi interaktsioone kasutajate eesmärkide täitmiseks. Kasutusmallimudel koondab endas kõik analüüsitava süsteemi olulised kasutusmallid [UML].\n\nTegija\n``````\n Tegija on roll, mida kasutaja mängib süsteemi suhtes. Tegija ei pea olema inimene. Kui modelleeritav süsteem annab mingit teenust teisele arvutisüsteemile, on see teine süsteem tegija.\n\nKasutusmall\n```````````\n\nKirjeldus\n'''''''''\n\nKasutusmall on kogum stsenaariume, mida omavahel ühendab ühine kasutaja eesmärk. Iga stsenaarium on süsteemis tehtavate toimingute jada, mis annab tegijale nähtava ja kasuliku tulemuse.\n\nEeltingimus\n'''''''''''\n\nEeltingimus kirjeldab tingimusi, mille täidetuse peab süsteem tagama, enne kui ta laseb alustada kasutusmalli täitmist.\n\nPäästik\n'''''''\n\nPäästik spetsifitseerib sündmuse, mis käivitab kasutusmalli.\n\nPõhiprotsess\n''''''''''''\n\nPõhiprotsess kirjeldab kasutusmalli peastsenaariumi.\n\nLaiendid\n''''''''\n\nLaiend kasutusmallis nimetab oleku, mis tuleneb teistsugustest interaktsioonidest kui need, mis on kirjeldatud õnnestumise peastsenaariumis, ja ütleb, millised on need erinevused.\n\nJäreltingimus\n'''''''''''''\n\nJäreltingimuse täidetus garanteeritakse süsteemi poolt kasutusmalli täitmise lõpus.\n\nE-hääletamise etapid\n--------------------\n\nE-hääletamine jaguneb korralduslikult viieks etapiks:\n\n- hääletamiseelne etapp\n- hääletamisetapp\n- töötlusetapp\n- lugemisetapp\n- auditeerimisetapp\n\nMõisted\n-------\n\nMõiste *isik* võib tähistada nii füüsilist kui juriidilist isikut. Eeldame, et konkreetsete toimingute läbiviija on alati üheselt indentifitseeritav füüsiline isik, kes võib tegutseda juriidilise isiku volitatud esindajana.\n\nMõiste *serverisüsteem* tähistab terviklikku kogumit tarkvaralisi ja riistvaralisi komponente, mis koostoimes realiseerivad konkreetset protokolli ning osutavad pikema aja vältel teenust paljudele kasutajatele.\n\nMõiste *liides* tähistab selgelt spetsifitseeritud kokkupuutepunkti süsteemi komponentide vahel, mis võimaldab komponentide vahelist infovahetust.\n\nMõiste *rakendus* tähistab tarkvaralist komponenti, mida käivitatakse konkreetsel ajahetkel ühel riistvaralisel komponendil ühe kasutaja poolt. Rakendus võib oma ülesande täitmiseks suhelda servrisüsteemiga.\n\nMõiste *teenus* tähistab süsteemivälist komponenti, millega süsteem oma ülesannete täitmiseks konkreetsete liideste kaudu andmeid vahetab.\n" }, { "path": "Documentation/et/kasutusmall/tegijad.rst", "content": ".. IVXV kasutusmallid\n\nTegijad\n=======\n\nKorraldaja\n----------\n\n*Korraldaja* on isik, kes korraldab valimisi mille raamides elektroonilise hääletamise süsteemi kasutatakse. Korraldaja määrab elektroonilise hääletamise seadistuse, sealhulgas kõik ülejäänud rollitäitjad. Korraldaja haldab Kogumisteenust sisuliselt.\n\nKorraldaja tegeleb hääletamiseelsel etapil valijate, valimisjaoskondade, ringkondade ja valikute- kandidaatide (valimistel) või vastusevariantide (rahvahääletusel) nimekirja koostamise ja/või kinnitamisega.\n\nKorraldaja loob ja/või kinnitab Valimisrakenduse ning Kontrollrakenduse seadistused.\n\nKorraladaja tegeleb hääletamisetapil valijate nimekirjade täiendamise ja/või täienduste kinnitamisega.\n\nKorraldaja tegeleb töötlusetapil e-häälte tühistamis- ja ennistamisavalduste koostamise ja/või kinnitamisega.\n\nKorraldaja võib täita ka elektroonilise hääletamise põhiprotsesside toimimisega seotud konkreetseid rolle. Näiteks hoiab Korraldaja tavajuhtumitel ka e-hääletamise süsteemi põhisaladust – häälte avamise võtit ning seega täidab ta ka häälte avaja ja summeerija ehk Lugeja rolli.\n\nHääletaja\n---------\n\n*Hääletaja* on isik, kes kasutab elektroonilise hääletamise süsteemi hääletamisetapil\n\n- hääletamiseks Valijarakendusega,\n- hääle kontrollimiseks Kontrollrakendusega.\n\nHääletajal on elektrooniline isikutunnistus – ID-kaart, Mobiil-ID, Smart-ID või Web eID.\n\nKoguja\n------\n\n*Koguja* on isik, kes haldab Kogumisteenust, Valijarakendust ja Kontrollrakendust tehniliselt.\n\n*Kogumisteenus* on serverisüsteem, mis tuvastab hääleõiguslikkust Tuvastusteenuse abil, väljstab kandidaatide nimekirja, aitab Valijarakendusel Allkirjastamisteenuse abil e-häält moodustada, talletab hääli e-valimiskasti ning registreerib neid Registreerimisteenuses. Kogumisteenus vastab Kontrollrakenduse poolt tehtud hääle tervikluse kontrollpäringutele.\n\n*Kogumisteenuse Haldur* on kas Korraldaja, Koguja või Klienditugi. Koguja on Kogumisteenuse tehniline haldur. Kogumisteenuse sisuline haldur on Korraldaja. Kogumisteenus pakub informatiivset liidest Klienditoele.\n\n*Haldusteenus* on teenus, mida Kogumisteenuse Haldur kasutab Kogumisteenuselt informatsiooni saamiseks või Kogumisteenusele korralduste edastamiseks.\n\n*Valijarakendus* on rakendus, mida Hääletaja kasutab e-hääle andmiseks käimasolevatel valimistel. Valijarakendus suhtleb Kogumisteenusega ning võimaldab Hääletajal teha valikut, seda krüpteerida ja digitaalselt allkirjastada. Valijarakendus kuvab QR-koodi, mille alusel saab Hääletaja Kontrollrakendusega kontrollida e-hääle korrektset jõudmist Kogumisteenusesse.\n\nKoguja valmistab kompileeritud valijarakendusest ette seadistatud valijarakenduse, mis allkirjastatakse ja levitatakse valijateni.\n\n*Kontrollrakendus* on rakendus, mis võimaldab Hääletajal arvutist erineval nutiseadme platvormil veenduda, et tema e-hääl jõudis Kogumisteenusesse ja Registreermisteenusesse ning väljendas tema tahet korrektselt.\n\nKoguja seadistab kontrollrakenduse selliselt, et too on võimeline võrgust tegelikke seadistusi laadima ning allkirjastab kontrollrakenduse.\n\nKoguja on Valijarakenduse ja Kontrollrakenduse tehniline haldur, sisuline haldur on Korraldaja.\n\nKoguja poolt täidetavad põhiprotsessid leiavad aset hääletamisetapil, alustavad ning lõpetavad tegevused toimuvad nii hääletamiseelsel kui töötlusetapil.\n\nKoguja digiallkirjastab hääletamisperioodi lõpul Töötlejale üle antavad andmed (e-hääled ja logid).\n\nTöötleja\n--------\n\n*Töötleja* on isik, kes kasutades Töötlemisrakendust töötleb töötlusetapil hääletamisperioodil kogutud e-hääli:\n\n- kontrollib digitaalallkirju ja Kogujalt saadud andmete täielikkust,\n- tühistab korduvad e-hääled ning paralleelhääletamise kasutamisel ka nende Hääletajate e-hääled, kes hääletasid jaoskonnas eelhääletamise ajal,\n- anonüümistab e-hääled, eemaldades nendelt isikulised digitaalallkirjad, olles eelnevalt need sorteerinud ringkondade kaupa\n\nTöötleja võib e-hääli täiendavalt krüptograafiliselt anonüümistada kasutades Miksimisrakendust.\n\n*Töötlemisrakendus* on rakendus, mille abil kontrollitakse häälte individuaalset terviklust ja e-valimiskasti terviklust, tühistatakse hääli, väljastatakse hääletanute nimekirju ning ringkondade kaupa rühmitatud anonüümistatud hääli. Töötlemisrakenduse sisendi annavad Koguja, Registreerimisteenus ja Korraldaja. Töötlemisrakendust võib käitada ka Audiitor Töötleja töötulemuste kontrollimiseks.\n\nMiksija\n-------\n\n*Miksija* on isik, kes töötlusetapil anonüümistab e-hääled krüptograafiliselt kasutades Miksimisrakendust.\n\n*Miksimisrakendus* on rakendus, mille sisendiks on ringkondade kaupa rühmitatud anonüümistatud krüpteeritud hääled ning mis väljastab krüptograafiliselt segatud hääled selliselt, et neid ei ole võimalik sisendiga vastavusse viia. Miksimine toimub sellisel moel, et nii sisend- kui ka väljundhäälte dekrüpteerimine ja tulemi summeerimine annab sama resultaadi. Miksimirakendus väljastab lisaks segatud häältele miksimistõendi, mis kinnitab sisend- ja väljundhäälte semantilist samaväärsust.\n\nLugeja\n------\n\n*Lugeja* on isik, kes kasutades Võtmerakendust\n\n- hääletamiseelsel etapil genereerib häälte salastamise ja avamise võtme,\n- lugemisetapil avab krüpteeritud hääled ning summeerib need e-hääletamise tulemusteks.\n\nLugeja võib toimetada ainuisikuliselt, üldjuhul kaitstakse e-hääletamise salastamise võti läviskeemiga, kus ühe tervikvõtme asemel luuakse mitu võtmeosakut ning võtmeoperatsioonid on teostatavad ainult teatud kvoorumi võtmeosakute osavõtul. Sellisel juhul assisteerivad Lugejat Võtmehaldurid.\n\n*Võtmehaldur* on isik, kelle ülesandeks on talle usaldatud võtmeosaku alalhoidmine ning selle andmine Lugeja käsutusse ainult siis kui selleks on seaduslik alus.\n\n*Võtmerakendus* on rakendus, millega genereeritakse iga hääletamise jaoks häälte salastamise ja häälte avamise võti. Võtmerakenduse abil toimub ka häälte lugemine ja tulemuse väljastamine.\n\nAudiitor\n--------\n\n*Audiitor* on isik, kes auditeerimisetapil kontrollib süsteemi kirjelduse ja Korraldaja poolt avaldatud süsteemi kesksete osapoolte vahel liikunud andmete põhjal andmete terviklust ning kooskõlalisust. Audiitor kasutab oma töös Auditirakendust. Kui Audiitor kontrollib ka Töötleja toimimise korrektsust, siis kasutab Audiitor ka Töötlemisrakendust.\n\n*Auditirakendus* on rakendus mis võimaldab kontrollida Lugeja ja Miksija töö korrektsust. Lugeja töö korrektsust on võimalik kontrollida ka avalikult.\n\nKlienditugi\n-----------\n\n*Klienditugi* on isik, kelle poole Hääletaja hääletamisetapil probleemide korral pöördub. Klienditugi abistab Kogumisteenusest saadud info abil Hääletajat probleemide lahendamisel.\n\nTuvastusteenus\n--------------\n\n*Tuvastusteenus* on teenus, mida kasutatakse vajadusel hääletaja identiteedi tuvastamiseks.\n\nAllkirjastamisteenus\n--------------------\n\n*Allkirjastamisteenus* on teenus, mida kasutatakse vajadusel hääle\nallkirjastamisel ja sellele kehtivuskinnituse saamisel. Vajadus\nAllkirjastamisteenuse järele sõltub allkirja andmise vahendist - Mobiil-ID,\nSmart-ID, Web eID ja ID-kaardi korral on nende teenuste ülesehitus erinev.\n\nRegistreerimisteenus\n--------------------\n\n*Registreerimisteenus* on teenus, mille abil Kogumisteenus peab registreerima kõik Valijarakendustelt saadud hääled. Pärast hääletamisperioodi lõppu edastab teenuseosutaja info registreeritud häälte kohta Töötlejale.\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/Makefile", "content": "include ../../common.mk\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/algseadistamine.rst", "content": ".. IVXV kogumisteenuse haldusjuhend\n\nSüsteemi algseadistamine\n========================\n\nSüsteemi algseadistamine tähendab süsteemi paigaldamist ning seadistamist\nläbiviidavate valimiste tarbeks.\n\n.. _nouded-platvormile:\n\nNõuded kasutatavale platvormile\n-------------------------------\n\nKogumisteenus töötab platvormil ``Ubuntu 20.04 LTS (Focal Fossa)``.\n\nVäliste teenuste kaardistamine\n------------------------------\n\nKogumisteenuse poolt toetatavate ja läbiviidavas hääletamises kasutatavate\nväliste teenuste (Mobiil-ID, Smart-ID, OCSP jms) kaardistamise käigus koostatakse\nnimekiri välistest teenustest ja nendega andmevahetuseks vajalikest andmetest\n(võrguaadress, port jms).\n\nVäliste teenuste andmed on sisendiks kogumisteenuse tehnilise seadistuse\nkoostamisel (:ref:`seadistuste_koostamine`).\n\nVäliste teenuste kaardistamise tulemusena on kogumisteenuse osutajal olemas\nnimekiri kogumisteenuse poolt kasutatavatest välistest teenustest koos teenuste\nkasutamiseks vajalike parameetritega.\n\n\nTugiteenuste ettevalmistamine\n-----------------------------\n\nKogumisteenuse tugiteenusteks on:\n\n#. Tehnilise seire teenus;\n\n#. Logiseire teenus;\n\n#. Varundusteenus.\n\nTehnilise seire ettevalmistamine\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n.. important::\n\n Kogumisteenuse osutaja peab kogumisteenuse töötamiseks eraldatud riistvara\n jälgimiseks läbi viima riistvara tehnilist seiret.\n\nTehnilise seire teenus on `Zabbix `_ tarkvaral põhinev\nseire- ja teavitussüsteem. Zabbix serveri paigaldab ja seadistab\nkogumisteenuse osutaja iseseisvalt.\n\nTehnilisse seiresse võib hõlmata ka kogumisteenuse tarkvaralisi komponente nagu\nkirjeldatud lõigus \":ref:`etcd-zabbix`\".\n\nSeire toimimiseks on tarvis määrata seire eest vastutavad isikud ning tagada\nnende vahetu teavitamine seireprogrammi poolt avastatud kõrvalekalletest.\n\nLisaks standardsele tehnilisele seirele (teenusmasinate\nprotsessori-/kettakasutus jms.) viib kogumisteenuse haldusteenus läbi\nalamteenuste seiret ja teavitab tehnilise seire serverit avastatud\nkõrvalekalletest.\n\n.. todo::\n\n Lisada haldusteenusele tehnilise seire teavituste tugi!\n\nTehnilise seire ettevalmistamise tulemusena on kogumisteenuse osutajal olemas\ntehnilise seire server, kuhu on paigaldatud seiretarkvara ning kus on\nkirjeldatud tehnilise seire eest vastutavad isikud ja nende teavitamise\nmeetodid.\n\n\nLogiseire ettevalmistamine\n^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nLogiseire teenus koosneb rsyslog logiserverist koos analüüsi- ja\nvisualiseerimistarkvaraga (Log Monitor, `Grafana `_).\n\nLogiseire ettevalmistamine ja integreerimine kogumisteenusega on kirjeldatud\ndokumendis ``IVXV tegevuslogi\nseirelahendus``.\n\nLogiseire ettevalmistamise tulemusena on kogumisteenuse osutajal olemas\nlogiseire server, kuhu on paigaldatud logiseire tarkvara ning kus on\nkirjeldatud logiseire andmetele ligipääsevad isikud.\n\n\nVarunduse ettevalmistamine\n^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nVarundusteenus on kogumisteenuse osutaja poolt paigaldatud ja seadistatud\nvarundusserver, mis vastutab kogumisteenuse sisemises varundusserveris\nkoostatud varukoopiate säilimise eest.\n\nVarunduse ettevalmistamise tulemusena on kogumisteenuse osutajal olemas\nvarundusserver, mis on suuteline kogumisteenuse varundusliidese kaudu andmeid\nvarundama.\n\n\n.. _seadistuste_koostamine:\n\nKogumisteenuse seadistuste koostamine\n-------------------------------------\n\nKogumisteenuse seadistused koosnevad kolmest eraldiseisvast osast:\n\n#. **Usaldusjuure seadistus** sisaldab andmed seadistuste (kaasa arvatud\n usaldusjuure enda) allkirjade kontrollimiseks ja nimekirja kogumisteenuse\n haldurite volitustest.\n\n#. **Kogumisteenuse tehniline seadistus** määrab kogumisteenuse tehnilised\n parameetrid, hääletuse läbiviimiseks kasutatavad teenused, samuti ka\n kogumisteenuse koosseisu kuulvad alamteenused.\n\n#. **Valimiste seadistus** määrab ühe valimise seadistuse.\n\nSeadistuste koostamine on kirjeldatud dokumendis IVXV-JSK-\\* \"Elektroonilise hääletamise\ninfosüsteemi IVXV seadistuste koostamise juhend\". Kogumisteenusele\nrakendatavad seadistused peavad olema pakendatud ASiC-E konteinerisse ja olema\nsigneeritud volitatud kasutaja poolt.\n\nKogumisteenuse seadistuste koostamise tulemusena on kogumisteenuse osutajal\nolemas kogumisteenuse seadistamiseks vajalikud seadistuspakid. Kõik seadistused\non signeeritud isiku(te) poolt, kelle volitused on kirjeldatud usaldusjuure\nseadistustes või kelle volitused on määratud eraldiseisvate korralduste abil.\n\n\n.. _taristu-paigaldamine:\n\nKogumisteenuse taristu paigaldamine\n-----------------------------------\n\nKogumisteenuse taristu eraldatakse teenuse osutamiseks vastavalt koostatud\nseadistustele (:ref:`seadistuste_koostamine`).\n\nIgas teenusmasinas:\n\n#. peab olema seadistatud hostinimi (fail :file:`/etc/hostname`);\n\n#. peab olema paigaldatud SSH teenus (tarkvarapakk ``openssh-server``);\n\n#. peab olema paigaldatud tehnilise seire teenuse agent\n (tarkvarapakk ``zabbix-agent``);\n\n#. peab olema tagatud õige kellaaeg\n (näiteks õige kellaaja teenuse ``ntp`` abil).\n\n#. peab olema seadistatud nimelahendus, mis võimaldab kõikide teenusmasinate\n aadresse lahendada;\n\n#. peab olema seadistatud Eesti lokaat koos UTF-8 kooditabeli toega\n ``et_EE.UTF-8`` (kas tarkvarapakk ``locales`` koos nimetatud lokaadi\n seadistamisega või tarkvarapakk ``locales-all``, mis paigaldab kõik toetatud\n lokaadid).\n\n.. note::\n\n Iga teenusmasina poolt kasutatav nimelahendus peab tagama, et suhtluseks\n kasutatavate hostide nimed lahenduvad korrektselt.\n\n Vältima peab olukordi, kus hostinimi lahendub mitmeks aadressiks või\n teistele hostidele kättesaamatuks aadressiks.\n\n Järgnev näide kirjeldab võimalikku olukorda failis :file:`/etc/hosts`, kus\n operatsioonisüsteemi paigalduse järel on hostinimi ``ivxv123`` määratud kahele\n liidesele. Sellise seadistuse puhul võib tekkida olukord, kus aadressile\n ``ivxv123`` ühendusi vastu võtma seadistatud teenus hakkab kuulama kohalikul\n liidesel ``127.0.0.1`` ja pole avaliku liidese ``192.168.10.1`` kaudu\n teistele teenustele kättesaadav.\n\n .. code-block:: text\n\n # /etc/hosts\n 127.0.0.1 ivxv123\n 192.168.10.1 ivxv123\n\nKogumisteenuse taristu jaoks eraldatud hostidest tuleb koostada nimekiri, kus\non kirjas hosti asukohaks olev alamvõrk, hosti nimi, IP-aadress, SSH-serveri\navalik võti ja hostile plaanitud teenused.\n\nKogumisteenuse taristu nimekirja näide:\n\n.. code-block:: text\n\n Valimiste infrastruktuuri andmed\n\n Alamvõrk: zone1\n\n IP-aadress: 172.16.238.10\n Hostinimi: admin\n SSH-serveri avalik võti:\n ecdsa-sha2-nistp256 AAAAE2VjZHNhLX...SgtbbE= root@admin\n\n IP-aadress: 172.16.238.41\n Hostinimi: ivxv1\n SSH-serveri avalik võti:\n ecdsa-sha2-nistp256 AAAAE2VjZHNhLX...mN8ul0= root@ivxv1\n\n Alamvõrk: zone2\n\n IP-aadress: 172.16.100.63\n Hostinimi: ivxv2\n SSH-serveri avalik võti:\n ecdsa-sha2-nistp256 AAAE2VjZHNhLXN...rtWT7A= root@ivxv2\n\nKogumisteenuse taristusse kuuluvad hostid tuleb lisada tehnilisse seiresse.\n\nKogumisteenuse taristu paigaldamise tulemusena on kogumisteenuse osutajal\nolemas dokumenteeritud platvorm kogumisteenuse paigaldamiseks ettenähtud\nkonfiguratsiooniga. Kõik taristusse kuuluvad (virtuaal)masinad on tehnilise\nseire teenuse poolt kättesaadavad ja nende seisundis pole tuvastatud probleeme.\n\n\nVõrgupääsude loomine\n--------------------\n\nKogumisteenuse paigaldamiseks ja seadistamiseks on vajalik seadustustele\nvastavate võrgupääsude olemasolu.\n\n\nSüsteemiülemad ja kasutajad\n^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n#. Kogumisteenuse süsteemiülemate arvutitest haldusteenusesse\n (protokoll SSH, port 22);\n\n#. Haldusteenuse kasutajate arvutitest haldusteenusesse\n (protokoll HTTPS, port 443);\n\n#. Kogumisteenuse süsteemiülemate arvutitest logiseire teenusesse\n (protokoll SSH, port 22);\n\n#. Logiseire kasutajate arvutitest logiseire teenusesse\n (protokoll HTTPS, port 443).\n\n\nTeenuste omavaheline suhtlus\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n#. Haldusteenusest kõikidesse mikroteenustesse\n (protokoll SSH, port 22);\n\n#. Haldusteenusest logiseire teenusesse\n (protokoll SSH, port 22);\n\n#. Kõigist mikroteenuste hostidest kõikidesse logikogumisteenustesse\n (protokoll RELP, port 20514);\n\n#. Kõigist mikroteenuste hostidest kõikidesse välistesse logikogumisteenustesse\n (sh, ka logiseire teenusesse)\n (protokoll RELP, port 20514);\n\n#. Kõigist mikroteenuste hostidest logiseire teenusesse\n (protokoll SSH, port 22);\n\n#. Kõigist logikogumisteenuste hostidest logiseire teenusesse\n (protokoll SSH, port 22);\n\n#. Vahendusteenusest teistesse mikroteenustesse peale talletusteenuse\n (protokoll TLS, port vastavalt tehnilisele seadistusele);\n\n#. Nimekirjateenusest talletusteenustesse\n (protokoll TLS, port vastavalt tehnilisele seadistusele);\n\n#. Hääletamisteenusest talletusteenustesse\n (protokoll TLS, port vastavalt tehnilisele seadistusele);\n\n#. Kontrolliteenusest talletusteenustesse\n (protokoll TLS, port vastavalt tehnilisele seadistusele);\n\n#. Talletusteenusest teistesse talletusteenustesse\n (protokoll TLS, port vastavalt tehnilisele seadistusele);\n\n#. Mobiil-ID tugiteenusest välisesse Mobiil-ID teenusesse\n (protokoll HTTP(S), port vastavalt tehnilisele seadistusele);\n\n#. Smart-ID tugiteenusest välisesse Smart-ID teenusesse\n (protokoll HTTP(S), port vastavalt tehnilisele seadistusele);\n\n#. Teistest mikroteenustest Session status tugiteenusesse\n (protokoll RPC, port vastavalt tehnilisele seadistusele);\n\n#. Hääletamisteenusest välisesse kvalifitseerimisteenusesse\n (protokoll HTTP(S), port vastavalt tehnilisele seadistusele);\n\n#. Varundusteenusest haldusteenusesse\n (protokoll SSH, port 22);\n\n#. Varundusteenusest logikogumisteenustesse\n (protokoll SSH, port 22);\n\n#. Varundusteenusest talletusteenustesse\n (protokoll SSH, port 22);\n\n\nHääletaja\n^^^^^^^^^\n\n#. Hääletaja kasutatavast seadmest vahendusteenusesse\n (protokoll TLS, port vastavalt tehnilisele seadistusele, eeldatavalt 443).\n\n\nHaldusteenuse paigaldamine\n--------------------------\n\nHaldusteenuse paigaldamine toimub haldusteenuse hostil.\n\nHaldusteenuse paigaldamiseks tuleb kopeerida **kõik** kogumisteenuse\ntarkvarapakid haldusteenuse masina kataloogi :file:`/etc/ivxv/debs/`. Nendest pakkidest\npaigaldatakse haldusteenus, samuti kasutab haldusteenus neid pakke alamteenuste\npaigaldamiseks.\n\nHaldusteenuse sõltuvuste paigaldamine:\n\n.. include:: genereeritud-failid/haldusteenuse_soltuvuste_paigaldamine.inc\n\nHaldusteenuse paigaldamine:\n\n.. include:: genereeritud-failid/haldusteenuse_paigaldamine.inc\n\n.. important::\n\n Haldusteenuse edasine kasutamine toimub haldusteenuse konto alt. Selleks\n tuleb halduril luua SSH-ligipääs haldusteenuse kontole ``ivxv-admin``.\n Soovitav on autentimine teha ID-kaardi põhiseks (vaata\n :ref:`configure-ssh-idcard-auth`).\n\nHaldusteenuse paigaldamise tulemusena on kogumisteenuse osutajal teenuse\nhaldamiseks vajalik liides.\n\n\nHaldusteenuse seadistamine\n^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nOsad haldusteenuse protsessid käivitatakse korrapärase intervalliga cron\nteenuse abil. Nende protsesside puhul väljastatakse võimalik tõrkeinfo\nstandardväljunditesse ja cron edastab selle e-posti teel käivitaja konto\naadressile. Seetõttu tuleb haldusteenuse masinasse paigaldada meiliserver ja\nseadistada see nii, et kõigile masinas asuvatele kontodele (nt.\n``root@localhost``) saadetavad sõnumid edastatakse teenuse halduritele.\n\n\nKogumisteenuse taristu hõlmamine haldusesse\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nHaldusteenus kasutab kogumisteenuse haldamiseks SSH protokolli. Selleks, et\nhaldusteenusel oleks võimalik teisi teenushoste usaldada, tuleb\nhaldusteenusesse lisada hallatavate teenushostide SSH-serveri võtmed.\n\nNäide hosti ``ivxv1`` SSH-võtmete lisamisest haldusteenuse usaldatavate hostide\nhulka::\n\n ivxv-admin@admin $ ssh-keyscan ivxv1 >> ~/.ssh/known_hosts\n # ivxv1:22 SSH-2.0-OpenSSH_8.2p1 Ubuntu-4ubuntu0.2\n # ivxv1:22 SSH-2.0-OpenSSH_8.2p1 Ubuntu-4ubuntu0.2\n # ivxv1:22 SSH-2.0-OpenSSH_8.2p1 Ubuntu-4ubuntu0.2\n\nSelleks, et haldusteenusel oleks võimalik teenushostidesse tarkvara paigaldada,\ntuleb haldusteenuse kontole ``ivxv-admin`` luua SSH-ligipääs teenushostide\njuurkasutaja kontole.\n\n.. note::\n\n Haldusteenus vajab juurkasutaja ligipääsu alamteenuse tarkvara\n paigaldamiseks. Pärast edukat paigaldamist ühel hostil eemaldab\n haldusteenus ligipääsu selle hosti juurkasutaja kontole.\n\nHaldusteenuse konto SSH-võtmepaari avalik võti asub kasutaja ``ivxv-admin``\nkodukataloogi all failis :file:`.ssh/id_ed25519.pub` ja see on genereeritud\nhaldusteenuse paigaldamise käigus. Vajadusel võib haldur selle võtme asendada\n(kuid see peab toimuma enne, kui võti on üle kantud hallatavatesse\nteenusmasinatesse).\n\nTeenusmasinas tuleb haldusteenuse konto SSH avalik võti panna faili\n:file:`/root/.ssh/authorized_keys`. See fail peab kuuluma juurkasutajale ja\nolema loetav ainult juurkasutaja poolt (faili pääsuõigused ``0600``).\n\nKogumisteenuse taristu haldusesse hõlmamise tulemusena on haldusteenusel\nusaldusväärne ligipääs kogumisteenuse taristusse kuuluvatele teenusmasinate\njuurkasutaja kontodele.\n\n\nLogiseire lahenduse ühendamine haldusteenusega\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nLogiseire lahenduse kasutamise korral peab haldusteenusel olema ligipääs\nlogiseire lahendusele, et sealt kogutud statistikat alla laadida ja vajadusel\nvärskendada logiseire poolt analüüsitavaid logisid.\n\nSelleks, et haldusteenusel oleks usaldus logiseire teenuse vastu, tuleb\nhaldusteenusesse lisada logiseire teenuse hosti (käesolevas näites nimega\n``logmonitor``) SSH-serveri võtmed::\n\n ivxv-admin@admin $ ssh-keyscan -t ecdsa logmonitor >> ~/.ssh/known_hosts\n\nSelleks, et haldusteenus pääseks logiseire kontole ligi, tuleb haldusteenuse\nkonto SSH avalik võti panna logiseire konto ``logmon`` volitatud võtmete faili\n:file:`~logmon/.ssh/authorized_keys`. See fail peab kuuluma logimonitori\nkasutajale ja olema loetav ainult selle kasutaja poolt (faili pääsuõigused\n``0600``).\n\nLogiseire lahenduse haldusteenusega ühendamise tulemusena on tegevuslogi\nseirelahendus haldusteenusele kättesaadav ning haldusteenusel on võimalik\nseirelahendusest statistikaandmeid laadida ning seirelahenduse andmehoidlasse\najakohaseid logiandmeid üle kanda.\n\n\nHaldusteenuse veebiliidese vaikimisi TLS-sertifikaadi asendamine\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nHaldusteenuse paigalduse käigus genereeritakse kasutajaliidese veebiserveri\nTLS-sertifikaat koos krüptovõtmega ja tugeva Diffie-Hellman grupifailiga (vaata\nhttps://weakdh.org/). Vajadusel on halduril võimalik need asendada.\n\nFailide asukohad:\n\n* Veebiserveri TLS-sertifikaadi võti:\n :file:`/etc/ssl/private/ivxv-admin-default.key`\n\n* Veebiserveri TLS-sertifikaat: :file:`/etc/ssl/certs/ivxv-admin-default.crt`\n\n* Diffie-Hellmani grupifail: :file:`/etc/ssl/dhparams.pem`\n\nAsendatud failide rakendamiseks tuleb veebiserver taaskäivitada käsuga\n:command:`service apache2 restart` ja veenduda, et veebiliides töötab.\n\nHaldusteenuse veebiliidese vaikimisi TLS-sertifikaadi asendamise tulemusena\nkasutab haldusteenuse veebiliides turvalist sertifikaati.\n\n\nHaldusteenuse vaikimisi autentimissertifikaadi asendamine\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nHaldusteenuse paigalduse käigus genereeritakse haldusteenuse\nautentimissertifikaat koos krüptovõtmega (haldusteenus kasutab seda Valimiste\nInfosüsteemiga infovahetusel autentimiseks). Vajadusel on halduril võimalik\nneed asendada.\n\nFailide asukohad:\n\n* Autentimissertifikaadi võti: :file:`/etc/ssl/private/ivxv-admin-client.key`\n\n* Autentimissertifikaat: :file:`/etc/ssl/certs/ivxv-admin-client.crt`\n\nHaldusteenuse vaikimisi autentimissertifikaadi asendamise tulemusena kasutab\nhaldusteenus Valimiste Infosüsteemi autentimiseks turvalist sertifikaati.\n\nAutentimissertifikaadi testimine:\n\n.. code-block:: shell-session\n\n $ openssl s_client -connect vis-address:443 \\\n -cert /etc/ssl/certs/ivxv-admin-client.crt \\\n -key /etc/ssl/private/ivxv-admin-client.key\n\n\nHaldusteenuse lähtestamine\n--------------------------\n\nHaldusteenuse lähtestamine toimub käsuga :ref:`ivxv-collector-init`. Selle\nkäigus puhastatakse haldusteenuse andmekataloogid ja lähtestatakse andmebaas.\n\n\nSeadistuste ja valimisnimekirjade rakendamine kogumisteenusele\n--------------------------------------------------------------\n\n.. note::\n\n Käesolevas lõigus ja alamlõikudes tähendab \"seadistuspakk\" nii seadistusi\n sisaldavat faili kui valimisnimekirja faili, mis on signeeritud volitatud\n isiku poolt.\n\nKogumisteenusele tuleb rakendada järgmised seadistuspakid:\n\n#. Usaldusjuur – laaditakse alati esimesena;\n\n#. Kogumisteenuse tehniline seadistus – laaditakse enne valimiste seadistust;\n\n#. Valimiste seadistus – laaditakse enne nimekirju;\n\n#. Valikute nimekiri;\n\n#. Ringkondade nimekiri;\n\n#. Valijate algnimekiri.\n\nEttevalmistatud seadistuspakkide rakendamiseks tuleb läbi viia järgmised\ntegevused:\n\n#. Ülekandmine haldusteenuse masinasse;\n\n#. Laadimine haldusteenusesse;\n\n#. Rakendamine alamteenustele.\n\n.. hint::\n\n Seadistuspakkide ettevalmistamine on kirjeldatud lõigus\n \":ref:`seadistuste_koostamine`\".\n\n.. attention::\n\n Usaldusjuure seadistuse laadimisega kaasneb alati ka\n kogumisteenuse haldusteenuse andmebaasi lähtestamine!\n\nSeadistuste ja valimisnimekirjade kogumisteenusele rakendamise tulemusena on\nkogumisteenus seadistatud ettenähtud perioodil osutama nõuetekohast häälte\nkogumise teenust.\n\n\nSeadistuspaki ülekandmine haldusteenuse masinasse\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nSeadistuspaki ülekandmine haldusteenuse masinasse toimub üle `SCP\n`_ protokolli. Seadistuspakk peab\nolema kättesaadav haldusteenuse kasutajakontole ``ivxv-admin``.\n\nNäide::\n\n $ scp seadistus.asice ivxv-admin@admin:\n seadistus.asice 100% 15KB 79.5KB/s 00:00\n\n.. note::\n\n Kogumisteenus osutaja võib seadistuspakkide ülekandmiseks kasutada ka muid\n meetodeid, näiteks irdmeediat.\n\nSeadistuspaki ülekandmise tulemusena on seadistuspakk haldusteenuse poolt\nligipääsetaval andmekandjal.\n\n\nSeadistuspaki laadimine haldusteenusesse\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nSeadistuspakk laaditakse haldusteenusesse käsuga :ref:`ivxv-cmd-load`. Selle\nkäigus kontrollib haldusteenus seadistuspaki signeerinud isiku volitusi ja\nvalideerib seadistuste sisu ning kooskõlalisust. Laadimise tulemusena on\nseadistuspakk valmis rakendamiseks hallatavatele teenustele.\n\nNäide: Usaldusjuure laadimine haldusteenusesse:\n\n.. include:: genereeritud-failid/haldusteenus-laadi_usaldusjuure_seadistused.inc\n\nSeadistuspaki haldusteenusesse laadimise tulemusena on haldusteenus valmis\nrakendama seadistuspakki alamteenustele. Seadistuspaki versiooni kuvatakse\nhaldusteenuse olekuandmetes.\n\n.. seealso:: * :ref:`korralduste-valideerimine`\n\n\nSeadistuste rakendamine alamteenustele\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nHaldusteenusesse laaditud seadistuspakid rakendatakse hallatavatele teenustele\nkäsuga :ref:`ivxv-config-apply`. Rakendamine on võimalik tehniliste seadistuse\nlaadimise järel, kuna tehnilise seadistusega tekivad haldusteenusesse andmed\nhallatavate teenuste kohta.\n\nSeadistuste rakendamise käigus haldusteenus:\n\n* Paigaldab seadistatava teenuse tarkvara (tehnilise seadistuse laadimisel, kui\n pole eelnevalt paigaldatud);\n\n* Kannab seadistuspaki üle hallatava teenuse hosti failisüsteemi;\n\n* Valimiste seadistuse laadimisel lubab ja käivitab seadistatava teenuse.\n\n.. note::\n\n Seadistuste rakendamise järjekord on kirjeldatud utiliidi ivxv-config-apply\n abiteabe lõigus (vaata :ref:`ivxv-config-apply`).\n\nNäide: Haldusteenusesse laaditud seadistuste rakendamine hallatavatele\nteenusele::\n\n ivxv-admin@admin $ ivxv-config-apply\n INFO: Technical config is signed by ÕIGE,VALIK,44444444444 2017-06-07T12:05:44Z\n INFO: Service choices@choices1.ivxv.ee: Applying technical config\n SERVICE choices@choices1.ivxv.ee: Installing service to host \"ivxv1\"\n SERVICE choices@choices1.ivxv.ee: Querying state of the service software package \"ivxv-choices\"\n SERVICE choices@choices1.ivxv.ee: Copying software package files to service host\n SERVICE choices@choices1.ivxv.ee: Checking state of dpkg database in service host\n SERVICE choices@choices1.ivxv.ee: Installing dependencies for package \"ivxv-common\"\n Reading package lists...\n Building dependency tree...\n Reading state information...\n ...\n SERVICE voting@voting3.ivxv.ee: Set trust config file permissions in service host\n SERVICE voting@voting3.ivxv.ee: Trust root config successfully applied to service\n SERVICE voting@voting3.ivxv.ee: Applying technical config to service\n SERVICE voting@voting3.ivxv.ee: Copying technical config to service host\n SERVICE voting@voting3.ivxv.ee: Set technical config file permissions in service host\n SERVICE voting@voting3.ivxv.ee: Technical config successfully applied to service\n SERVICE voting@voting3.ivxv.ee: Registering technical config version \"ÕIGE,VALIK,44444444444 2017-06-07T12:05:44Z\" in management database\n SERVICE voting@voting3.ivxv.ee: Registering service state as \"INSTALLED\" in management database\n INFO: Service voting@voting3.ivxv.ee: technical config config applied successfully\n INFO: 15 configuration packages successfully applied\n\nSeadistuste alamteenustele rakendamise tulemusena on hallatavad teenused\nseadistatud ja nende seisund on haldusteenusest jälgitav.\n\n.. seealso:: * :ref:`korralduste-laadimine-rakendamine`\n\n\nKogumisteenuse krüptovõtmete rakendamine\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n**Teenuste krüptovõtmete ja TLS-sertifikaatide** rakendamine toimub käsuga\n:ref:`ivxv-secret-load`.\n\n.. hint::\n\n Teenuse krüptovõtmete seisundit on võimalik väljastada käsuga\n :command:`ivxv-status --service=` (vaata :ref:`ivxv-status`)\n\nVõtme laadimine teenusele:\n\n.. code-block:: shell-session\n\n $ ivxv-secret-load --service= tls-key tls.key\n\nSertifikaadi laadimine teenusele:\n\n.. code-block:: shell-session\n\n $ ivxv-secret-load --service= tls-cert tls.pem\n\n.. important::\n\n Igale teenuse isendile tuleb rakendada selle\n isendi jaoks genereeritud võti ja sertifikaat!\n\n**Hääletamisteenuse ajatemplipäringute signeerimisvõtme** rakendamine toimub\nkäsuga :ref:`ivxv-secret-load`:\n\n.. code-block:: shell-session\n\n $ ivxv-secret-load tsp-regkey tspreg.key\n\n.. note::\n\n Hääletamisteenuse ajatemplipäringute signeerimisvõti on vaja rakendada vaid\n juhul, kui ajatempliteenust kasutatakse registreerimisteenuseks (valimiste\n seadistuses on ``qualification/protocol`` välja väärtuseks ``tspreg``).\n\n**Mobiil-ID/Smart-ID/Web eID identsustõendi võtme** rakendamine toimub\nkäsuga :ref:`ivxv-secret-load`:\n\n.. code-block:: shell-session\n\n $ ivxv-secret-load mid-token-key mobid-shared-secret.key\n\n.. note::\n\n Mobiil-ID/Smart-ID/Web eID identsustõendi võti on vaja rakendada vaid\n juhul, kui Mobiil-ID/Smart-ID/Web eID tugiteenus on kasutusel\n (valimiste seadistuses on olemas plokk ``auth.ticket``).\n\nKogumisteenuse krüptovõtmete rakendamise tulemusena on hallatavate teenuste\nsuhtluskanalid varustatud kanali turvamiseks vajalike krüptovõtmetega, samuti\non teenustel olemas krüptovõtmed muude oluliste operatsioonide jaoks.\n\n\nAlgseadistamise tulemuse kontrollimine\n--------------------------------------\n\nAlgseadistamise tegevuste tulemusena on kogumisteenus eeldatavalt valmis\nhääletuse läbiviimiseks. Tulemust on võimalik kontrollida kogumisteenuse oleku\njälgimisega, mis on kirjeldatud süsteemi haldustoimingute lõigus\n(:ref:`kogumisteenuse-oleku-jälgimine`).\n\nHääletuse läbiviimiseks seadistatud kogumisteenuse olek on \"Seadistatud\"\n(CONFIGURED). Oleku \"Paigaldatud\" puhul tuleb kontrollida mikroteenuste\nseisundit ja seisundi taustainfot.\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/annotatsioon.rst", "content": ".. IVXV kogumisteenuse haldusjuhend\n\nAnnotatsioon\n------------\n\nKäesolev juhend käsitleb tööd elektroonilise hääletamise raamistiku IVXV\nkogumisteenuse tarkvaraga süsteemiülema vaatepunktist ning kirjeldab tarkvara\nkõiki võimalusi kogu e-hääletusprotsessi ulatuses. Süsteemiülemalt eeldatakse\ne-hääletuse põhiterminoloogia tundmist.\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/genereeritud-failid/e-valimiskasti_koostamine.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * steps/test_util/report.py\n\n.. Feature: Kogumisteenuse käivitamine kõrgkäideldava konfiguratsiooniga\n features/end-to-end-10-collector-ha-setup.feature:7\n Scenario: Valimiste kokkuvõtete tegemine\n features/end-to-end-10-collector-ha-setup.feature:892\n Step: Haldur ekspordib haldusteenusest kogutud hääled\n features/end-to-end-10-collector-ha-setup.feature:970\n\n.. code-block:: text\n\n ivxv-admin@admin $ ivxv-export-votes /output/voting/HA-SETUP/exported-votes.zip\n INFO: Creating backup copy from current ballot box\n SERVICE backup@backup.ivxv.ee: Copying list of known SSH hosts to service host\n # Preparing ballot box backup file in voting service voting@voting1.ivxv.ee\n # Creating ballot box backup file ballot-box-20211228_1155.zip\n Exporting votes: 0\n Exporting votes: 1\n Exporting votes: 2\n Exporting votes: 3\n Exporting votes: 4\n Exporting votes: 5\n Exporting votes: 6\n Exporting votes: 7\n Exporting votes: 8\n # Copying backup file ballot-box-20211228_1155.zip to backup service\n # Removing backup file ballot-box-20211228_1155.zip from voting service\n INFO: Copying ballot box to management service\n SERVICE backup@backup.ivxv.ee: Copying ballot box from service host\n INFO: Collected votes archive is written to '/output/voting/HA-SETUP/exported-votes.zip'\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/genereeritud-failid/haldusteenus-laadi_kogumisteenuse_tehnilised_seadistused.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * steps/test_util/report.py\n\n.. Feature: Kogumisteenuse käivitamine kõrgkäideldava konfiguratsiooniga\n features/end-to-end-10-collector-ha-setup.feature:7\n Scenario: Kogumisteenuse tehniliste seadistuste rakendamine\n features/end-to-end-10-collector-ha-setup.feature:404\n Step: Haldur laadib haldusteenusesse kogumisteenuse tehnilised seadistused\n features/end-to-end-10-collector-ha-setup.feature:438\n\n.. code-block:: text\n\n ivxv-admin@admin $ ivxv-cmd-load technical /output/voting/HA-SETUP/config/HA-SETUP.technical.asice\n INFO: Config file is signed by: ROPKA,KIVIVALVUR,32608320001 2021-12-28T11:38:40Z\n INFO: User ROPKA,KIVIVALVUR,32608320001 with role 'admin' is authorized to execute 'technical' commands\n INFO: Using signature 'ROPKA,KIVIVALVUR,32608320001 2021-12-28T11:38:40Z' as config file version\n INFO: Config file version is 'ROPKA,KIVIVALVUR,32608320001 2021-12-28T11:38:40Z'\n INFO: Loading command 'collectors technical configuration' from file '/output/voting/HA-SETUP/config/HA-SETUP.technical.asice'\n command_file:INFO: Loading command file '/output/voting/HA-SETUP/config/HA-SETUP.technical.asice' (collectors technical configuration)\n command_file:INFO: Validating collectors technical configuration\n command_file:INFO: Files in collectors technical configuration package are valid\n INFO: Collectors technical configuration file loaded successfully\n INFO: Collectors technical configuration file is registered in management service\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/genereeritud-failid/haldusteenus-laadi_ringkondade_nimekiri.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * steps/test_util/report.py\n\n.. Feature: Kogumisteenuse käivitamine kõrgkäideldava konfiguratsiooniga\n features/end-to-end-10-collector-ha-setup.feature:7\n Scenario: Ringkondade nimekirja rakendamine\n features/end-to-end-10-collector-ha-setup.feature:586\n Step: Nimekirjade haldur laadib ringkondade nimekirja haldusteenusesse\n features/end-to-end-10-collector-ha-setup.feature:630\n\n.. code-block:: text\n\n ivxv-admin@admin $ ivxv-cmd-load districts /output/voting/HA-SETUP/config/districts.asice\n INFO: Config file is signed by: NÕID,VÄIKE,33333333333 2021-12-28T11:49:17Z\n INFO: User NÕID,VÄIKE,33333333333 with role 'election-conf-manager' is authorized to execute 'districts' commands\n INFO: Using signature 'NÕID,VÄIKE,33333333333 2021-12-28T11:49:17Z' as config file version\n INFO: Config file version is 'NÕID,VÄIKE,33333333333 2021-12-28T11:49:17Z'\n INFO: Loading command 'districts list' from file '/output/voting/HA-SETUP/config/districts.asice'\n command_file:INFO: Loading command file '/output/voting/HA-SETUP/config/districts.asice' (districts list)\n command_file:INFO: Validating districts list\n command_file:INFO: Files in districts list package are valid\n INFO: Some voting lists are already loaded, executing consistency checks: ivxv-config-validate --election=/etc/ivxv/election.bdoc --choices=/etc/ivxv/choices.bdoc --districts=/output/voting/HA-SETUP/config/districts.asice\n INFO: Validating elections configuration file '/etc/ivxv/election.bdoc'\n ...\n command_file:INFO: Files in districts list package are valid\n INFO: Config files are valid\n INFO: Detected election ID 'HA-SETUP' from election config\n INFO: Election ID consistency check succeeded\n INFO: Checking districts and choices lists consistency\n INFO: Voting lists consistency check succeeded\n INFO: Writing simplified district list to '/var/lib/ivxv/admin-ui-data/districts.json'\n INFO: Districts list file loaded successfully\n INFO: Districts list file is registered in management service\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/genereeritud-failid/haldusteenus-laadi_usaldusjuure_seadistused.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * steps/test_util/report.py\n\n.. Feature: Kogumisteenuse käivitamine kõrgkäideldava konfiguratsiooniga\n features/end-to-end-10-collector-ha-setup.feature:7\n Scenario: Kogumisteenuse tehniliste seadistuste rakendamine\n features/end-to-end-10-collector-ha-setup.feature:404\n Step: Haldur laadib haldusteenusesse usaldusjuure seadistused\n features/end-to-end-10-collector-ha-setup.feature:412\n\n.. code-block:: text\n\n ivxv-admin@admin $ ivxv-cmd-load trust /output/voting/HA-SETUP/config/HA-SETUP.trust.asice\n command_file:INFO: Loading command file '/output/voting/HA-SETUP/config/HA-SETUP.trust.asice' (trust root configuration)\n command_file:INFO: Validating trust root configuration\n command_file:INFO: Files in trust root configuration package are valid\n INFO: Config file is signed by: ORAV,IVAN,30809010001 2021-12-28T11:38:37Z\n INFO: User ORAV,IVAN,30809010001 with role 'admin' is authorized to execute 'trust' commands\n INFO: Using signature 'ORAV,IVAN,30809010001 2021-12-28T11:38:37Z' as config file version\n INFO: Config file version is 'ORAV,IVAN,30809010001 2021-12-28T11:38:37Z'\n INFO: Loading command 'trust root configuration' from file '/output/voting/HA-SETUP/config/HA-SETUP.trust.asice'\n command_file:INFO: Loading command file '/output/voting/HA-SETUP/config/HA-SETUP.trust.asice' (trust root configuration)\n command_file:INFO: Validating trust root configuration\n command_file:INFO: Files in trust root configuration package are valid\n INFO: Resetting collector management database\n db:INFO: Initializing management database '/var/lib/ivxv/db/ivxv-management.db'\n Removing crontab (if exist)\n no crontab for ivxv-admin\n INFO: Trust root configuration file loaded successfully\n INFO: Resetting user permissions\n INFO: Trust root configuration file is registered in management service\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/genereeritud-failid/haldusteenus-laadi_valijate_nimekiri.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * steps/test_util/report.py\n\n.. Feature: Kogumisteenuse käivitamine kõrgkäideldava konfiguratsiooniga\n features/end-to-end-10-collector-ha-setup.feature:7\n Scenario: Valijate algnimekirja rakendamine\n features/end-to-end-10-collector-ha-setup.feature:642\n Step: Nimekirjade haldur laadib valijate algnimekirja haldusteenusesse\n features/end-to-end-10-collector-ha-setup.feature:666\n\n.. code-block:: text\n\n ivxv-admin@admin $ ivxv-cmd-load voters /output/voting/HA-SETUP/config/voters-0.asice\n INFO: Config file is signed by: NÕID,VÄIKE,33333333333 2021-12-28T11:49:37Z\n INFO: User NÕID,VÄIKE,33333333333 with role 'election-conf-manager' is authorized to execute 'voters' commands\n INFO: Using signature 'NÕID,VÄIKE,33333333333 2021-12-28T11:49:37Z' as config file version\n INFO: Config file version is 'NÕID,VÄIKE,33333333333 2021-12-28T11:49:37Z'\n INFO: Loading command 'voters list' from file '/output/voting/HA-SETUP/config/voters-0.asice'\n command_file:INFO: Loading command file '/output/voting/HA-SETUP/config/voters-0.asice' (voters list)\n command_file:INFO: Validating voters list\n command_file:INFO: Files in voters list package are valid\n INFO: Some voting lists are already loaded, executing consistency checks: ivxv-config-validate --election=/etc/ivxv/election.bdoc --choices=/etc/ivxv/choices.bdoc --districts=/etc/ivxv/districts.bdoc --voters=/output/voting/HA-SETUP/config/voters-0.asice\n INFO: Validating elections configuration file '/etc/ivxv/election.bdoc'\n ...\n command_file:INFO: Files in voters list package are valid\n INFO: Config files are valid\n INFO: Detected election ID 'HA-SETUP' from election config\n INFO: Election ID consistency check succeeded\n INFO: Checking districts and choices lists consistency\n INFO: Checking districts and voter list changeset #0 consistency\n INFO: Voting lists consistency check succeeded\n INFO: Voters list file loaded successfully\n INFO: Voters list file is registered in management service\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/genereeritud-failid/haldusteenus-laadi_valikute_nimekiri.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * steps/test_util/report.py\n\n.. Feature: Kogumisteenuse käivitamine kõrgkäideldava konfiguratsiooniga\n features/end-to-end-10-collector-ha-setup.feature:7\n Scenario: Valikute nimekirja rakendamine\n features/end-to-end-10-collector-ha-setup.feature:528\n Step: Nimekirjade haldur laadib valikute nimekirja haldusteenusesse\n features/end-to-end-10-collector-ha-setup.feature:574\n\n.. code-block:: text\n\n ivxv-admin@admin $ ivxv-cmd-load choices /output/voting/HA-SETUP/config/choices.asice\n INFO: Config file is signed by: NÕID,VÄIKE,33333333333 2021-12-28T11:49:03Z\n INFO: User NÕID,VÄIKE,33333333333 with role 'election-conf-manager' is authorized to execute 'choices' commands\n INFO: Using signature 'NÕID,VÄIKE,33333333333 2021-12-28T11:49:03Z' as config file version\n INFO: Config file version is 'NÕID,VÄIKE,33333333333 2021-12-28T11:49:03Z'\n INFO: Loading command 'choices list' from file '/output/voting/HA-SETUP/config/choices.asice'\n command_file:INFO: Loading command file '/output/voting/HA-SETUP/config/choices.asice' (choices list)\n command_file:INFO: Validating choices list\n command_file:INFO: Files in choices list package are valid\n INFO: Choices list file loaded successfully\n INFO: Choices list file is registered in management service\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/genereeritud-failid/haldusteenus-laadi_valimiste_seadistused.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * steps/test_util/report.py\n\n.. Feature: Kogumisteenuse käivitamine kõrgkäideldava konfiguratsiooniga\n features/end-to-end-10-collector-ha-setup.feature:7\n Scenario: Lugemisperioodi alustamine\n features/end-to-end-10-collector-ha-setup.feature:885\n Step: Haldur määrab kogumisteenuse uueks perioodiks \"lõpetatud\"\n features/end-to-end-10-collector-ha-setup.feature:888\n\n.. code-block:: text\n\n ivxv-admin@admin $ ivxv-cmd-load election /output/voting/HA-SETUP/config/HA-SETUP.election.asice\n INFO: Config file is signed by: NÕID,VÄIKE,33333333333 2021-12-28T11:54:10Z\n INFO: User NÕID,VÄIKE,33333333333 with role 'election-conf-manager' is authorized to execute 'election' commands\n INFO: Using signature 'NÕID,VÄIKE,33333333333 2021-12-28T11:54:10Z' as config file version\n INFO: Config file version is 'NÕID,VÄIKE,33333333333 2021-12-28T11:54:10Z'\n INFO: Loading command 'elections configuration' from file '/output/voting/HA-SETUP/config/HA-SETUP.election.asice'\n command_file:INFO: Loading command file '/output/voting/HA-SETUP/config/HA-SETUP.election.asice' (elections configuration)\n command_file:INFO: Validating elections configuration\n command_file:INFO: Files in elections configuration package are valid\n INFO: Elections configuration file loaded successfully\n command_file:INFO: Loading command file '/output/voting/HA-SETUP/config/HA-SETUP.election.asice' (elections configuration)\n INFO: Elections configuration file is registered in management service\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/genereeritud-failid/haldusteenuse_paigaldamine.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * steps/test_util/report.py\n\n.. Feature: Kogumisteenuse käivitamine kõrgkäideldava konfiguratsiooniga\n features/end-to-end-10-collector-ha-setup.feature:7\n Scenario: Kogumisteenuse haldusteenuse paigaldus\n features/end-to-end-10-collector-ha-setup.feature:370\n Step: Haldur paigaldab haldusteenuse\n features/end-to-end-10-collector-ha-setup.feature:376\n\n.. code-block:: text\n\n root@admin # dpkg -i /etc/ivxv/debs/ivxv-common_1.7.8_all.deb /etc/ivxv/debs/ivxv-admin_1.7.8_amd64.deb\n Selecting previously unselected package ivxv-common.\n (Andmebaasi lugemine ... 13710 files and directories currently installed.)\n Preparing to unpack .../debs/ivxv-common_1.7.8_all.deb ...\n Unpacking ivxv-common (1.7.8) ...\n Selecting previously unselected package ivxv-admin.\n Preparing to unpack .../ivxv-admin_1.7.8_amd64.deb ...\n Unpacking ivxv-admin (1.7.8) ...\n Paki ivxv-common (1.7.8) paikasättimine ...\n # Adding user group 'ivxv'\n Adding group `ivxv' (GID 109) ...\n ...\n systemctl restart apache2\n # Starting Apache web server\n # Restarting rsyslog log server\n Created symlink /etc/systemd/system/multi-user.target.wants/ivxv-admin.service → /lib/systemd/system/ivxv-admin.service.\n Created symlink /etc/systemd/system/multi-user.target.wants/ivxv-admin-agent.service → /lib/systemd/system/ivxv-admin-agent.service.\n /usr/lib/python3/dist-packages/schematics/validate.py:121: SyntaxWarning: \"is\" with a literal. Did you mean \"==\"?\n if not kwargs or kwargs.pop('context', 0) is 0:\n Processing triggers for rsyslog (8.2001.0-1ubuntu1.1) ...\n invoke-rc.d: WARNING: No init system and policy-rc.d missing! Defaulting to block.\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/genereeritud-failid/haldusteenuse_soltuvuste_paigaldamine.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * steps/test_util/report.py\n\n.. Feature: Kogumisteenuse käivitamine kõrgkäideldava konfiguratsiooniga\n features/end-to-end-10-collector-ha-setup.feature:7\n Scenario: Kogumisteenuse haldusteenuse paigaldus\n features/end-to-end-10-collector-ha-setup.feature:370\n Step: Haldur paigaldab haldusteenuse\n features/end-to-end-10-collector-ha-setup.feature:376\n\n.. code-block:: text\n\n root@admin # apt-get install --yes --quiet adduser openssh-server openssl rsync rsyslog rsyslog-relp sudo tzdata locales libc6 python3-bottle python3-dateutil python3-debian python3-docopt python3-fasteners python3-jinja2 python3-jsonschema python3-openssl python3-pkg-resources python3-yaml python3:any apache2 cron fonts-font-awesome javascript-common language-pack-et libapache2-mod-wsgi-py3 libjs-bootstrap libjs-jquery libjs-jquery-datatables libjs-jquery-datatables-extensions python3-gdbm python3-requests ssl-cert\n Reading package lists...\n Building dependency tree...\n Reading state information...\n adduser is already the newest version (3.118ubuntu2).\n cron is already the newest version (3.0pl1-136ubuntu1).\n fonts-font-awesome is already the newest version (5.0.10+really4.7.0~dfsg-1).\n javascript-common is already the newest version (11).\n libapache2-mod-wsgi-py3 is already the newest version (4.6.8-1ubuntu3).\n libjs-jquery is already the newest version (3.3.1~dfsg-3).\n libjs-jquery on määratud käsitsi paigaldatuks.\n ...\n Paki apache2-data (2.4.41-4ubuntu3.8) paikasättimine ...\n Paki openssl (1.1.1f-1ubuntu2.10) paikasättimine ...\n Paki rsync (3.1.3-8ubuntu0.1) paikasättimine ...\n invoke-rc.d: WARNING: No init system and policy-rc.d missing! Defaulting to block.\n Paki apache2-utils (2.4.41-4ubuntu3.8) paikasättimine ...\n Paki apache2 (2.4.41-4ubuntu3.8) paikasättimine ...\n invoke-rc.d: WARNING: No init system and policy-rc.d missing! Defaulting to block.\n invoke-rc.d: WARNING: No init system and policy-rc.d missing! Defaulting to block.\n Processing triggers for systemd (245.4-4ubuntu3.13) ...\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/genereeritud-failid/kasutaja_lisamine.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * steps/test_util/report.py\n\n.. Feature: Kogumisteenuse käivitamine kõrgkäideldava konfiguratsiooniga\n features/end-to-end-10-collector-ha-setup.feature:7\n Scenario: Kogumisteenuse tehniliste seadistuste rakendamine\n features/end-to-end-10-collector-ha-setup.feature:404\n Step: Haldur määrab haldusteenuses kasutajale \"NÕID,VÄIKE,33333333333\" rolli \"election-conf-manager\"\n features/end-to-end-10-collector-ha-setup.feature:471\n\n.. code-block:: text\n\n ivxv-admin@admin $ ivxv-cmd-load user /output/voting/HA-SETUP/config/user-NÕID,VÄIKE,33333333333-election-conf-manager.asice\n INFO: Config file is signed by: ORAV,IVAN,30809010001 2021-12-28T11:46:31Z\n INFO: User ORAV,IVAN,30809010001 with role 'admin' is authorized to execute 'user' commands\n INFO: Using signature 'ORAV,IVAN,30809010001 2021-12-28T11:46:31Z' as config file version\n INFO: Config file version is 'ORAV,IVAN,30809010001 2021-12-28T11:46:31Z'\n INFO: Loading command 'user permissions configuration' from file '/output/voting/HA-SETUP/config/user-NÕID,VÄIKE,33333333333-election-conf-manager.asice'\n command_file:INFO: Loading command file '/output/voting/HA-SETUP/config/user-NÕID,VÄIKE,33333333333-election-conf-manager.asice' (user permissions configuration)\n command_file:INFO: Validating user permissions configuration\n command_file:INFO: Files in user permissions configuration package are valid\n INFO: User permissions configuration file loaded successfully\n INFO: Resetting user 'NÕID,VÄIKE,33333333333' permissions\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/genereeritud-failid/mikroteenuse_kaivitamine.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * steps/test_util/report.py\n\n.. Feature: Kogumisteenuse käivitamine kõrgkäideldava konfiguratsiooniga\n features/end-to-end-10-collector-ha-setup.feature:7\n Scenario: Mikroteenuse seiskamine ja käivitamine\n features/end-to-end-10-collector-ha-setup.feature:512\n Step: Haldur käivitab teenuse \"voting@voting2.ivxv.ee\"\n features/end-to-end-10-collector-ha-setup.feature:518\n\n.. code-block:: text\n\n ivxv-admin@admin $ ivxv-service restart voting@voting2.ivxv.ee\n INFO: Restarting service voting@voting2.ivxv.ee\n SERVICE voting@voting2.ivxv.ee: Restarting service\n SERVICE voting@voting2.ivxv.ee: Registering service state as 'CONFIGURED' in management database (last state: 'FAILURE')\n SERVICE voting@voting2.ivxv.ee: Service restarted successfully\n INFO: Service voting@voting2.ivxv.ee restarted" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/genereeritud-failid/mikroteenuse_seiskamine.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * steps/test_util/report.py\n\n.. Feature: Kogumisteenuse käivitamine kõrgkäideldava konfiguratsiooniga\n features/end-to-end-10-collector-ha-setup.feature:7\n Scenario: Mikroteenuse seiskamine ja käivitamine\n features/end-to-end-10-collector-ha-setup.feature:512\n Step: Haldur seiskab teenuse \"voting@voting2.ivxv.ee\"\n features/end-to-end-10-collector-ha-setup.feature:515\n\n.. code-block:: text\n\n ivxv-admin@admin $ ivxv-service stop voting@voting2.ivxv.ee\n INFO: Stopping service voting@voting2.ivxv.ee\n SERVICE voting@voting2.ivxv.ee: Stopping service\n SERVICE voting@voting2.ivxv.ee: Service stopped successfully\n INFO: Service voting@voting2.ivxv.ee stopped" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/genereeritud-failid/mikroteenuse_seisundi_tuvastamine.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * steps/test_util/report.py\n\n.. Feature: Kogumisteenuse käivitamine kõrgkäideldava konfiguratsiooniga\n features/end-to-end-10-collector-ha-setup.feature:7\n Scenario: Mikroteenuse seiskamine ja käivitamine\n features/end-to-end-10-collector-ha-setup.feature:512\n Step: Haldur tuvastab teenuse \"voting@voting2.ivxv.ee\" seisundi\n features/end-to-end-10-collector-ha-setup.feature:516\n\n.. code-block:: text\n\n ivxv-admin@admin $ ivxv-service ping voting@voting2.ivxv.ee\n INFO: Pinging service voting@voting2.ivxv.ee\n SERVICE voting@voting2.ivxv.ee: Registering background info: Ping error: * ivxv-voting@voting@voting2.ivxv.ee.service - IVXV voting service\n SERVICE voting@voting2.ivxv.ee: ERROR: Pinging service failed\n ERROR: Failed to query service voting@voting2.ivxv.ee status" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/genereeritud-failid/töötlemisrakenduse_sisendi_koostamine.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * steps/test_util/report.py\n\n.. Feature: Kogumisteenuse käivitamine kõrgkäideldava konfiguratsiooniga\n features/end-to-end-10-collector-ha-setup.feature:7\n Scenario: Valimiste kokkuvõtete tegemine\n features/end-to-end-10-collector-ha-setup.feature:892\n Step: Haldur genereerib haldusteenuses töötlemisrakenduse sisendi aluse\n features/end-to-end-10-collector-ha-setup.feature:973\n\n.. code-block:: text\n\n ivxv-admin@admin $ ivxv-generate-processor-input /output/voting/HA-SETUP/processor.cfg.zip\n INFO: Generating processor application config\n command_file:INFO: Loading command file '/etc/ivxv/election.bdoc' (elections configuration)\n INFO: Creating input file for processor application\n INFO: Preparing container structure in directory '/tmp/tmp6jswwi8i'\n INFO: Copying district list 'HA-SETUP.districts.json.bdoc'\n INFO: Copying voter list signing key 'voterfile.pub.key'\n INFO: Copying voter list #0 content '00.HA-SETUP.voters.utf'\n INFO: Copying voter list #0 signature '00.HA-SETUP.voters.sig'\n INFO: Copying voter list #1 content '01.HA-SETUP.voters.utf'\n INFO: Copying voter list #1 signature '01.HA-SETUP.voters.sig'\n ...\n INFO: Adding '02.HA-SETUP.voters.sig' to ZIP container\n INFO: Adding '02.HA-SETUP.voters.utf' to ZIP container\n INFO: Adding '03.HA-SETUP.voters.sig' to ZIP container\n INFO: Adding '03.HA-SETUP.voters.utf' to ZIP container\n INFO: Adding 'HA-SETUP.districts.json.bdoc' to ZIP container\n INFO: Adding 'HA-SETUP.processor.yaml' to ZIP container\n INFO: Adding 'ts.key' to ZIP container\n INFO: Adding 'voterfile.pub.key' to ZIP container\n INFO: Processor input is written to '/output/voting/HA-SETUP/processor.cfg.zip'\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/haldusteenus.rst", "content": ".. IVXV kogumisteenuse haldusjuhend\n\n.. _haldusteenus:\n\nHaldusteenus\n============\n\nHaldusteenus on kogumisteenuse haldamiseks mõeldud lahendus. Haldusteenus\npaigaldatakse eraldiseisvasse masinasse ja selle kaudu toimub kogumisteenuse\njuhtimine paigaldusest kuni seiskamiseni.\n\nHaldusteenuse funktsioonid on:\n\n#. Kogumisteenuse alamteenuste haldamine:\n\n #. Seadistuste ja valimisnimekirjade laadimine;\n\n #. Alamteenuste paigaldus selleks ettevalmistatud masinatesse;\n\n #. Alamteenustele seadistuste ja nimekirjade rakendamine;\n\n #. Valijate nimekirjade uuenduste hankimine Valimiste Infosüsteemist;\n\n#. E-valimiskasti koostamine töötlemiseks;\n\n#. Valimiste üldstatistika jälgimine;\n\n#. Valijate statistika allalaadimine;\n\n#. E-valimiskasti ja logide korrapärane varundamine;\n\n#. Kogumisteenuse seisundi seire;\n\nHaldusteenus suhtleb hallatavate teenustega üle `SSH\n`_-kanali. Suhtluse algatab alati\nhaldusteenus. Usaldus teenusmasinate vastu luuakse süsteemihalduri abiga pärast\nteenuseid majutavate masinate paigaldamist.\n\nTeenust majutava masina paigaldamise järel loob haldur haldusteenusele\nligipääsu teenusmasina juurkontole, et haldusteenusel oleks võimalik teenuse\ntarkvara paigaldada. Pärast viimase teenuse paigaldamist teenuseid majutavasse\nmasinasse eemaldab haldusteenus ligipääsu juurkontole.\n\n\nHaldusteenuse koosseis\n----------------------\n\nHaldusteenuse kasutajaliides koosneb kahest osast:\n\n#. Haldamise põhifunktsionaalsus on teostatud :ref:`käsureautiliitide\n ` abil;\n\n#. Graafiline kasutajaliides on veebipõhine liides, mille funktsionaalsuse\n tagavad käsureautiliidid.\n\n .. seealso::\n\n Graafilise kasutajaliidese kasutusjuhend asub dokumendis\n ``IVXV kogumisteenuse haldusliidese kasutusjuhend``.\n\nLisaks töötavad deemonprotsessid:\n\n#. Veebiserver graafilise kasutajaliidese jaoks;\n\n#. Haldusdeemon veebiserveri poolt vahendatud päringute käivitamiseks;\n\n#. Agentdeemon teenuste seisundi jälgimiseks.\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/haldustoimingud.rst", "content": ".. IVXV kogumisteenuse haldusjuhend\n\nSüsteemi haldustoimingud\n========================\n\n.. _kogumisteenuse-oleku-jälgimine:\n\nKogumisteenuse oleku jälgimine\n------------------------------\n\nKogumisteenuse olekuandmed registreeritakse haldusteenuse andmebaasis. Oleku\nkuvamiseks on utiliit :ref:`ivxv-status`.\n\nOlekus kuvatakse järgmisi andmeid:\n\n* Valimise ID, faas, algus- ja lõpuaeg;\n\n* Haldusteenusesse laaditud konfiguratsioon:\n\n * Seadistuspakkide versioonid;\n\n * Valikute nimekirja ja ringkondade nimekirja versioonid;\n\n * Valijate nimekirjade versioonid ja olekud;\n\n* Teenuste nimekiri koos rakendatud seadistuste versioonidega, teenuse seisundi\n ja selle viimase tuvastamise ajaga;\n\n* Väliste teenuste seisundid;\n\n* Haldusteenuse andmehoidla statistika.\n\nSõltuvalt kogumisteenuse seisundist võib oleku kuvamise utiliit jätta mõned\nandmeblokid kuvamata (kui need pole jooksva seisundi puhul olulised). Täieliku\nandmestiku väljastamiseks vaata utiliidi :ref:`ivxv-status` abiteavet.\n\nMikroteenuste oleku jälgimise ning oleku ja võimaliku veainfo registreerimisega\nhaldusteenuse andmebaasis tegeleb haldusteenuse :ref:`agentdeemon\n`.\n\nValijate muudatusnimekirjade hankimine Valimiste Infosüsteemist toimub\nutiliidiga :ref:`ivxv-voter-list-download`, mis käivitatakse teenuse `cron`\npoolt veerandtunnise intervalliga.\n\nKogumisteenuse haldusteenuse sündmuste logi kuvamiseks on utiliit\n:ref:`ivxv-eventlog-dump`.\n\n.. important::\n\n Haldusteenus tagab kogumisteenuse alamteenuste olekuandmetes vajaliku teabe\n teenuse töökorda seadmiseks. See võib olla järgmine:\n\n #. Teave puuduvate seadistuste kohta (seadistusfailid, võtmed jms). Seda\n kuvatakse kuni teenus on varustatud kõigi käivitamiseks vajalike\n seadistustega.\n\n #. Veateade - alamteenuse haldusvahendite (seadistuste kontrollivahend,\n teenuse haldusvahend) veaväljund mittetöötava teenuse kohta.\n\n\n.. _korralduste-valideerimine:\n\nKorralduste valideerimine\n-------------------------\n\nKorraldusfailide valideerimine võimaldab veenduda korralduste vastavuses\nvormistusnõuetele ning tuvastada vigased või mittekooskõlalised korraldused.\n\nValideerimine toimub käsuga :ref:`ivxv-config-validate`.\n\nValimise seadistuse valideerimise näide::\n\n $ ivxv-config-validate --election=valimise-seadistus-TEST2017.asice\n\n\nKorralduste kooskõlalisuse valideerimine\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nKooskõla valideerimine viiakse läbi kahel juhul:\n\n#. Kui valideerimise käsule antakse korraga valideerimiseks mitu korraldust;\n\n#. Korralduse laadimisel juhul, kui laaditava korraldusega kooskõla nõudev\n oluline korraldus juba haldusteenusesse laaditud.\n\nKorralduste kooskõla valideerimise kontrollid:\n\n#. Korraga valimiste seadistust ja/või nimekirju (valikute, ringkondade või\n valijate) valideerides kontrollitakse valimiste identifikaatori kooskõla.\n\n#. Korraga mitut valijate nimekirja valideerides viiakse läbi järgnevad\n kontrollid:\n\n * Nimekirjade korrektne järjestus;\n\n * Muudatusnimekirjas kontrollitakse:\n\n #. Valija topeltlisamist ja -eemaldamist;\n\n #. Valija eemaldamist pärast tema lisamist sama muudatusnimekirjaga.\n\n #. Valija eemaldamist ringkonnast, kuhu teda pole lisatud;\n\n#. Korraga ringkondade ja valikute nimekirja valideerides viiakse läbi\n järgnevad kontrollid:\n\n * Igas valimisringkonnas peab olema kirjeldatud vähemalt üks valik;\n\n * Iga valik peab olema seotud olemasoleva valimisringkonnaga.\n\n#. Korraga ringkondade nimekirja ja valijate nimekirju valideerides viiakse\n läbi järgnevad kontrollid:\n\n * Igas valimisjaoskonnas peab olema vähemalt üks valija;\n\n * Iga valimisnimekirja kantud isik peab olema seotud olemasoleva\n ringkonnaga;\n\n#. Valijate nimekirja(de) ja ringkondade nimekirja valideerimisel\n kontrollitakse valijale määratud ringkonna olemasolu ringkondade nimekirjas.\n\nKui valimiste seadistuses on määratud välisriigis asuvale valijale määratav\nringkonna haldusüksuse EHAK-kood (parameeter ``voterforeignehak``), peab\nvalikute, valijate ja ringkondade nimekirjade vastavuse valideerimisel olema\nkaasatud ka valimiste seadistus ja seadistuste valideerimisel tehakse täiendavad\nkontrollid:\n\n#. Valijate nimekirja ja ringkondade nimekirja kooskõla valideerides\n kontrollitakse, et ringkondade nimekirjas on parameetriga määratud\n haldusüksuses olemas valijale määratud ringkond.\n\n\n.. _korralduste-laadimine-rakendamine:\n\nKorralduste laadimine ja rakendamine\n------------------------------------\n\nKogumisteenuse korraldused koostatakse signeeritud korralduspakkidena, millega\nkirjeldatakse kasutaja identifikaator (*Common Name* ehk CN väli ID-kaardilt)\nja rollide nimekiri.\n\nSõltuvalt korraldusest tuleb rakendamiseks kasutada ühte või kahte käsku.\nHaldusteenust puudutavad korralduste rakendamiseks piisab nende laadimisest\nhaldusteenusesse. Alamteenuseid puudutavad korraldused (näiteks seadistuspakid)\ntuleb pärast haldusteenusesse laadimist rakendada ka hallatavatele teenustele.\n\nKorralduste laadimine haldusteenusesse toimub käsuga :ref:`ivxv-cmd-load`.\nLaadimise käigus viiakse läbi ka :ref:`korralduse valideerimine\n`, vigane või mittekooskõlaline korraldus jäetakse\nlaadimata.\n\nValikute nimekirja korralduse rakendamise näide:\n\n.. include:: genereeritud-failid/haldusteenus-laadi_valikute_nimekiri.inc\n\n.. seealso::\n\n * Käsu :ref:`ivxv-cmd-load` abiteave;\n\n * Korralduste rollide kirjeldus ja korralduste koostamise juhend asuvad\n dokumendis ``IVXV seadistuste\n koostamise juhend``.\n\n\nTeenuse isendi seisundi tuvastamine\n-----------------------------------\n\nMikroteenuse isendi seisundi tuvastamiseks on utiliit :ref:`ivxv-service`,\nmillega on võimalik teenuse seisundit vahetult küsida (utiliit\n:ref:`ivxv-status` kuvab andmebaasis puhverdatavat seisundit).\n\nTeenuse seisundi päringu näide:\n\n.. include:: genereeritud-failid/mikroteenuse_seisundi_tuvastamine.inc\n\n\n.. _teenuse-taaskäivitamine:\n\nTeenuse (taas)käivitamine\n-------------------------\n\nMikroteenuste käivitamiseks ja taaskäivitamiseks on utiliit\n:ref:`ivxv-service`.\n\nTeenuse taaskäivitamise näide:\n\n.. include:: genereeritud-failid/mikroteenuse_kaivitamine.inc\n\n.. note::\n\n Protseduuri nimetamine käivitamiseks või taaskäivitamiseks sõltub teenuse\n protsessi seisundist. Tehniliselt on tegemist sarnaste protseduuridega, kus\n esmalt veendutakse, et teenus seisab (vajadusel jäetakse see seisma) ja siis\n püütakse käivitada hetkel kehtivate seadistustega.\n\n\n.. _teenuse-seiskamine:\n\nTeenuse seiskamine\n------------------\n\nMikroteenuste seiskamiseks on utiliit :ref:`ivxv-service`.\n\nTeenuse seiskamise näide:\n\n.. include:: genereeritud-failid/mikroteenuse_seiskamine.inc\n\n\n.. _teenuse-asendamine:\n\nTeenuse isendi asendamine\n-------------------------\n\nTeenuse isendi asendamine koosneb ühe mikroteenuse isendi eemaldamisest (vt.\n:ref:`teenuse-eemaldamine`) ja teise sama funktsiooniga mikroteenuse isendi\nlisamisest (vt. :ref:`teenuse-lisamine`).\n\n\n.. _teenuse-lisamine:\n\nTeenuse isendi lisamine\n-----------------------\n\nTeenuse isendi lisamiseks tuleb vajadusel teenust hostiv server ette valmistada\n(vt. :ref:`taristu-paigaldamine`) ning rakendada uus tehniline seadistus, mis\nsisaldab lisatavat teenuse isendit.\n\n.. important::\n\n Lisatava isendi identifikaator ei tohi kattuda ühegi teise, ka minevikus\n eemaldatud isendi identifikaatoriga.\n\n\n.. _teenuse-eemaldamine:\n\nTeenuse isendi eemaldamine\n--------------------------\n\nTeenuse isendi eemaldamiseks tuleb:\n\n#. Teenuse isend seisma jätta (vt. :ref:`teenuse-seiskamine`);\n\n#. Keelata teenuse isendi uuesti käivitamine (vt. allpool);\n\n#. Rakendada uus tehniline seadistus, mis eemaldatavat isendit enam ei sisalda.\n\n.. important::\n\n Teenuse isendi eemaldamisel kogumisteenuse koosseisust on oluline\n eemaldatava isendi täielik elimineerimine.\n\n Teenuste isendid kasutavad üksteisele usalduse tõestamiseks kindla\n sertifitseerimiskeskuse (CA) poolt välja antud sertifikaate, kuid ei kasuta\n sama meetodit eemaldatud isendi usalduse tühistamiseks (vastava protseduuri\n rakendamise liigse keerukuse tõttu).\n\n Seetõttu on oluline veenduda, et kogumisteenusest eemaldatud teenuse isend\n on enne uue seadistuse rakendamist täielikult süsteemist eemaldatud.\n Vastasel juhul tekib oht, et eemaldatav isend jätkab tegutsemist ja häirib\n kogumisteenuse tööd.\n\nTeenuse isendi käivitamise keelamiseks teenuse eemaldamisel tuleb eemaldada\nvastava teenuse tarkvarapakk teenuse hostist:\n\n* Nimekirjateenuse paki eemaldamine:\n\n .. code-block:: text\n\n $ apt purge ivxv-choices\n\n* Mobiil-ID tugiteenuse paki eemaldamine:\n\n .. code-block:: shell-session\n\n $ apt purge ivxv-mid\n\n* Smart-ID tugiteenuse paki eemaldamine:\n\n .. code-block:: shell-session\n\n $ apt purge ivxv-smartid\n\n* Web eID tugiteenuse paki eemaldamine:\n\n .. code-block:: shell-session\n\n $ apt purge ivxv-webeid\n\n* Session status tugiteenuse paki eemaldamine:\n\n .. code-block:: shell-session\n\n $ apt purge ivxv-sessionstatus\n\n* Vahendusteenuse paki eemaldamine:\n\n .. code-block:: shell-session\n\n $ apt purge haproxy\n\n* Talletusteenuse paki eemaldamine:\n\n .. code-block:: shell-session\n\n $ apt purge etcd-server\n\n* Kontrolliteenuse paki eemaldamine:\n\n .. code-block:: shell-session\n\n $ apt purge ivxv-verification\n\n* Hääletamisteenuse paki eemaldamine:\n\n .. code-block:: shell-session\n\n $ apt purge ivxv-voting\n\n\nKasutajate haldus\n-----------------\n\nKasutajate algsed kirjeldused määratakse usaldusjuure seadistuses, hilisem\nhaldus toimub vastavate korralduste abil.\n\nKasutajate halduse korraldused rakendatakse käsuga :ref:`ivxv-cmd-load` (vaata\n:ref:`korralduste-laadimine-rakendamine`).\n\nKasutajaõiguste määramise korralduse rakendamise näide:\n\n.. include:: genereeritud-failid/kasutaja_lisamine.inc\n\n.. attention::\n\n Juba lisatud kasutajate eemaldamine süsteemist pole võimalik. Kasutaja\n eemaldamise asemel tuleb kasutaja rolliks määrata \"õigusteta kasutaja\".\n\n.. seealso::\n\n * Kasutajate rollide kirjeldus ja volituste korralduste koostamise juhend\n asuvad dokumendis ``IVXV seadistuste koostamise juhend``.\n\n * Korralduste rakendamine on kirjeldatud lõigus\n :ref:`korralduste-laadimine-rakendamine`.\n\n\nTarkvarauuenduste rakendamine\n-----------------------------\n\nTarkvarauuendused jagunevad kogumisteenuse vaatepunktist kaheks:\noperatsioonisüsteemi uuendused ja kogumisteenuse uuendused.\n\nOperatsioonisüsteemi tarkvarapakkide uute versioonide paigaldamine pole\nkogumisteenuse dokumentatsioonis käsitletud. Süsteemiülem peab tagama\najakohaste turvauuenduste rakendamise kogumisteenuses kasutatavate\noperatsioonisüsteemidele;\n\nKogumisteenuse tarkvarapakkide uute versioonide paigaldamine toimub järgnevalt:\n\n#. Uuenenud tarkvarapakid kopeeritakse haldusteenuse kataloogi\n :file:`/etc/ivxv/debs` (soovitavalt juurkasutaja õigustes);\n\n#. Haldusteenuse tarkvara uuendatakse juurkasutaja õigustes käsuga\n :command:`dpkg -i /etc/ivxv/debs/ivxv-common_1.0_all.deb\n /etv/ivxv/debs/ivxv-admin_1.0_amd64.deb` (tegelik versiooninumber erineb\n käesolevas näites kasutatud versioonist);\n\n#. Hallatavate teenuste tarkvara uuendamine toimub haldusteenuse kasutaja\n ``ivxv-admin`` õigustes käsuga :ref:`ivxv-update-packages`.\n\n\nVarundamine\n-----------\n\nVarundamine hõlmab kolme liiki andmeid:\n\n#. Haldusteenuse seadistused;\n\n#. Kogumisteenuse e-valimiskast;\n\n#. Kogutud logid.\n\nVarukoopia loomine toimub haldusteenuse masinas utiliidi\n:ref:`ivxv-backup` abil, varukoopiad talletatakse varundusserveri\nkataloogis :file:`/var/backups/ivxv`.\n\n\nHaldusteenus seadistuste varundamine\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nHaldusteenuse seadistustest varundatakse järgmised andmed:\n\n#. :file:`etc/` - haldusteenusesse laaditud tarkvarapakid ja hetkel kehtivad\n seadistusfailid;\n\n#. :file:`admin-ui-permissions/` - haldusteenuse kasutajaliidese pääsuõigused;\n\n#. :file:`commands/` - kõik haldusteenusese laaditud korraldusfailid.\n\nHaldusteenuse varundamist viiakse läbi haldusteenuses, varundatavad andmed\nkopeeritakse varundusserverisse.\n\n.. hint::\n\n Haldusteenuse andmete tõhusamaks varundamiseks ja taasteks on soovitav\n kasutada haldusteenuse virtuaalmasina dünaamilist tõmmist (*snapshot dump*).\n\nHaldusteenuse seadistuste varukoopiast taastamise protseduuri pole\nkogumisteenuses ette nähtud.\n\nHaldusteenuse seadistusete varukoopia loomise näide::\n\n $ ivxv-backup management-conf\n\n\nKogumisteenuse e-valimiskasti varundamine\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nKogumisteenuse e-valimiskasti varundamine toimub talletusteenuses kogutud häältest\ne-valimiskasti loomisega ja selle kopeerimisega varundusteenusesse. Varundatud andmete\ntaastamine toimub hääletuse järel e-valimiskasti väljastamise käigus, kus\ntalletusteenuses olevatest häältest ja varukoopiatesse salvestatud häältest\npannakse kokku töötlemisele minev e-valimiskast.\n\nE-valimiskasti varundamist viib läbi haldusteenus. Varukoopia loomine toimub\ntalletusteenuses ja see kopeeritakse varundusserverisse.\n\nVarukoopia on sama vorminguga, nagu kogumisteenuse poolt väljastatav e-valimiskast\n(ZIP64).\n\nVarundamise andmemahtu saab arvutada järgmise meetodiga:\n``häälte arv * 12,1 kB * pakkimistegur``.\n\nNäiteks saja tuhande hääle suurus, kus pakkimistegur on 0,4 = 472 MB.\n\nE-valimiskasti varukoopia loomise näide::\n\n $ ivxv-backup ballot-box\n\n\nLogide varundamine\n^^^^^^^^^^^^^^^^^^\n\nLogikogumisteenustes kogutud logifailide varundamine toimub logifailide\n:file:`/var/log/ivxv/ivxv-YYYY-MM-DD-HH.log` kopeerimisega varundusserverisse. Logide\nvarundamist viib läbi haldusteenus.\n\nLogide varukoopiast taastamise protseduuri pole kogumisteenuses ette nähtud.\n\nLogikogumisteenusesse kogutud logist varukoopia loomise näide::\n\n $ ivxv-backup log\n\n\n.. _konsolideeritud-e-valimiskasti-koostamine:\n\nKonsolideeritud e-valimiskasti koostamine\n-----------------------------------------\n\nKonsolideeritud e-valimiskast koostatakse talletusteenusesse kogutud häältest ja\nvarundusteenusesse varundatud e-valimiskastidest. Konsolideerimise protsess koosneb\njärgmistest sammudest:\n\n#. Talletusteenusesse kogutud hääled varundatakse varundusteenusesse. Selle\n tulemusena on varundusteenusesse salvestatud kõik kogutud e-valimiskastid;\n\n#. Varundusteenuses koostatakse konsolideeritud e-valimiskast;\n\n#. Konsolideeritud e-valimiskast kopeeritakse haldusteenusesse.\n\nKonsolideeritud e-valimiskasti koostamise näide:\n\n.. include:: genereeritud-failid/e-valimiskasti_koostamine.inc\n\n\nTöötlemisrakenduse sisendi aluse koostamine\n-------------------------------------------\n\nTöötlemisrakenduse sisendi alus on häälte töötlemiseks vajalike sisendfailide\nkomplekt, mis genereeritakse kogumisteenuses salvestatud andmete põhjal.\nKomplekti koosseis on järgmine:\n\n#. Ringkondade nimekiri;\n\n#. Valijate nimekirjad;\n\n#. E-valimiskast kogutud häältega;\n\n#. Häälte registreerimispäringute valideerimisandmed;\n\n#. Töötlemisrakenduse seadistused.\n\nVäljund on ZIP-konteiner, mis sisaldab järgmisi faile:\n\n#. Ringkondade nimekiri digitaalselt signeerituna\n :file:`.districts.json.asice`;\n\n#. Valijate nimekirjade signeerimisvõtme avalik võti\n :file:`voterfile.pub.key`;\n\n#. Valijate nimekirjad\n :file:`..voters.utf`;\n\n#. Valijate nimekirjade signatuurid\n :file:`..voters.sig`;\n\n#. Valijate nimekirja vahelejätmise korraldused\n :file:`..voters-skip.yaml.asice`;\n\n#. Registreerimispäringute verifitseerimise avalik võti\n :file:`ts.key`;\n\n#. Töötlemisrakenduse seadistuste mall e-valimiskasti verifitseerimiseks\n :file:`.processor.yaml`.\n\nTöötlemisrakenduse sisendi alus koostatakse utiliidi\n:ref:`ivxv-generate-processor-input` abil. Näide:\n\n.. include:: genereeritud-failid/töötlemisrakenduse_sisendi_koostamine.inc\n\nHääletamise statistika eksportimine\n-----------------------------------\n\nHäälestamise statistika koostatakse hääletusteenuses ja see koosneb kahest\nosast: üldstatistika (hääletajate koguarv) ja detailstatistika. Üldstatistika\nkopeeritakse haldusteenusesse ja eksporditakse Valimiste Infosüsteemi 15\nminutilise intervalliga. Detailstatistika koostatakse ja eksporditakse\nValimiste Infosüsteemi käsitsi.\n\nHäälestamise statistika importimine ja eksportimine toimub haldusteenuse\nmasinas utiliidi :ref:`ivxv-voterstats` abil. Üldstatistika importimise ja\neksportimise automaatika on teostatud cron-teenuse abil ja kirjeldatud failis\n:file:`/etc/cron.d/ivxv-admin`.\n\n\nHääletamise seansside väljavõtte koostamine\n-------------------------------------------\n\nHääletamise ja hääle kontrollimise seansside väljavõte on CSV-vormingus ja see\nkoostatakse logiseire teenuses.\n\nVäljavõtet on võimalik koostada anonüümistatud kujul, kus kasutajate\nisikukoodid ja IP-aadressid on asendatud anonüümsete väärtustega.\n\nVõimalik on valida, kas väljastada kõik hääletamise seansid või ainult hääle\nkontrollimisega seansid.\n\n:ref:`ivxv-voting-sessions`\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/index.rst", "content": ".. IVXV kogumisteenuse haldusjuhend\n\nIVXV kogumisteenuse haldusjuhend\n========================================================================\n\n.. raw:: html\n\n

\n NB!\n See on HTML-versioon dokumendist.\n Tellijale antakse üle PDF-versioon.\n

\n\n.. toctree::\n :maxdepth: 2\n\n annotatsioon\n ylevaade\n haldusteenus\n algseadistamine\n haldustoimingud\n krahhitaaste\n seadistused\n protseduurid\n lisad\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/krahhitaaste.rst", "content": ".. IVXV kogumisteenuse haldusjuhend\n\nKrahhitaaste\n============\n\nKogumisteenus on projekteeritud nii, et teenuse või selle osade krahhimise\ntagajärjel ei tekiks andmekadu või oleks see minimaalne.\n\n\nEeldused edukaks krahhitaasteks\n-------------------------------\n\nKõrgkäideldav seadistus\n^^^^^^^^^^^^^^^^^^^^^^^\n\nPeamine eeldus edukaks krahhitaasteks on kogumisteenuse paigaldamine\nkõrgkäideldava seadistusega, mis määrab vähemalt kolme talletusteenuse isendi\nkasutamise. Lisaks on krahhiolukorra kiiremaks lahendamiseks kasulik eraldada\nmikroteenustele ühe lisaisendite komplekti paigalduseks vajalik taristu.\n\n\nLogikoguja kasutamine\n^^^^^^^^^^^^^^^^^^^^^\n\nKogumisteenuse seadistus peab kirjeldama logikogumisteenuse, et mikroteenuste\npoolt toodetavad logisid oleks võimalik lihtsal moel kokku koguda. Soovitav on\nkasutada mitut logikogujat erinevas füüsilises lokatsioonis, et minimeerida\nlogikirjete kaotsimineku võimalust.\n\n\nVarundusteenuse kasutamine\n^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nKogumisteenuse seadistus peab kirjeldama varundusteenuse ning automaatse\nvarundamise ajad piisava sagedusega. Samuti on soovitav teha varukoopiad ka\nvarundusteenusest.\n\nAutomaatne varundamine tagab e-valimiskasti koopia säilimise :ref:`talletusteenuse\ntäieliku krahhi ` korral.\n\n.. note::\n\n Varundusteenus on soovitav paigaldada teistest kogumisteenuse isenditest\n füüsiliselt eraldi, et võimalikud eriolukorrad (näiteks tulekahju) ei\n mõjutaks korraga nii varundusteenust kui teisi teenuseid.\n\nVarundusteenus on projekteeritud kogumisteenuse andmetest automaatsete\nvarukoopiate loomiseks ühte kohta ning nende kättesaadavaks tegemiseks\noperatsioonidele, mis varukoopiaid kasutavad (näiteks häälte kokkulugemine).\n\n.. note::\n\n Kogumisteenuse osutaja peaks kaaluma võimalust teha varundusteenusest\n täiendavaid varukoopiaid, et tagada varundatud andmete säilimine ka\n varundusteenuse krahhi korral.\n\nValmisolek krahhiks\n^^^^^^^^^^^^^^^^^^^\n\nKogumisteenuse krahh mõjutab kõiki e-hääletamise komponente, erilist\ntähelepanu tuleb pöörata valijarakenduste ja kontrollrakenduste\nnimelahendusele ning TLS ühenduste usaldamiseks vajalikele\nsertifikaatidele.\n\nHääletamise edukaks läbiviimiseks tuleb tagada, et nimeserverid\nsisaldaks kogu hääletusperioodi vältel ajakohast infot\nhääletamissüsteemi sisendpunktide kohta - siis suudavad\nvalijarakendused ja kontrollrakendused vastavalt muutuvatele oludele\nnimesid korrektselt lahendada.\n\n#. Krahhimise tuvastamisel tuleb esimeste tegevuste hulgas eemaldada\n nimelahendusest krahhinud teenus, et rakendused enam selle poole\n pöörduda ei saaks.\n#. Kui teenused pärast krahhi uuesti töökorda saadakse, tuleb\n viimase sammuna nimelahenduses panna uute teenuste aadressid\n lahenduma vastavalt rakendustes defineeritule.\n\nKui kogumisteenusesse lisatakse uusi mikroteenuseid (eeldatavalt\npärast krahhimist), siis on tarvis tagada lisatud teenuste\nusaldusväärsus rakendustes.\n\nTeenuse plaanimisel tuleb luua serdid/võtmed ka võimalike\nasendusteenuste jaoks (choices, mid, voting). Need võtmed tuleb\npakendada valijarakendusse, et pärast krahhi poleks tarvis hakata uut\nrakendust levitama. Kui sertifikaadid luuakse ühe CA alt, siis piisab\nvalijarakendusse vastava CA sertifikaadi pakendamisest.\nKontrollrakenduste jaoks tuleb seadistustes alati näidata konkreetsed\nteenussertifikaadid, kuid kontrollrakenduste seadistuste muutmine ei\neelda kontrollrakenduste uuesti levitamist.\n\nTeenuste taastamine krahhist\n----------------------------\n\n\nMikroteenuse isendi krahh ilma andmekaota\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nMikroteenuse isendi krahh ilma andmekaota võib esineda teenuste puhul, mis ei\ntegele andmete säilitamisega (nimekirjateenus, hääletusteenus, kontrolliteenus\nvõi mobiil-id tugiteenus). Sellises olukorras piisab teenuse isendi\ntaastamiseks kas teenuse taaskäivitamisest (kui see on võimalik) või teenuse\nisendi asendamisest uuega.\n\n.. seealso::\n\n * :ref:`teenuse-taaskäivitamine`\n\n * :ref:`teenuse-asendamine`\n\n * :ref:`recovery-stateless`\n\nLogikogumisteenuse isendi krahh\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nLogikogumisteenuse krahh võib esineda nii logiandmete riknemisega kui ka ilma.\n\nIlma logiandmete riknemiseta krahh tähendab olukorda, kus rsyslog teenus seisab\nja ei võta seetõtte teenustelt logikirjeid vastu ning salvestatud logifailid ei\nole rikutud. Sellises olukorras piisab teenuse isendi töökorda seadmiseks selle\ntaaskäivitamisest.\n\nLogikogumisteenuse krahh koos logiandmete riknemisega nõuab teenuse isendi\nasendamist uuega.\n\nKui logiandmete riknemisega kaasneb alati logiandmete kadu, siis ilma\nriknemiseta krahhi puhul tuleb samuti selle võimalusega arvestada. Logisid\nedastatakse üle RELP-protokolli, mis on küllalt töökindel, kuid vaatamata\nsellele võib logiedastus katkeda olukorras, kus logi genereeriva teenuse hostil\non rsyslogi isendit taaskäivitatud ajal, mil logikoguja rsyslog isend ei\ntöötanud.\n\n.. seealso::\n\n * :ref:`teenuse-taaskäivitamine`\n\n * :ref:`teenuse-asendamine`\n\n * `RELP - The Reliable Event Logging Protocol\n `_\n\n * :ref:`recovery-logcollection`\n\nVarundusteenuse isendi krahh\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nVarundusteenuse isendi krahh tähendab varundusteenusesse varundatud andmete\nriknemist. Teenuse taastamiseks tuleb varundusteenus uuesti paigaldada ja\nvarundatud andmed taastada. Andmete taastamine varundusserverisse võib toimuda\nka pärast häälte kogumise lõppemist, kuid enne häälte kokkulugemist.\n\n.. note::\n\n Varundusprotseduuride käivitamist juhitakse haldusteenusest ja seetõttu pole\n varundusteenust võimalik käivitada ega seisma jätta.\n\n.. seealso::\n\n * :ref:`recovery-backupservice`\n\nTalletusteenuse isendi krahh\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nTalletusteenuse ühe isendi krahhimisel piisab isendi asendamisest uuega.\n\nTalletusteenuseid saab lisada ja eemaldada ainult siis, kui klastris on\nvähemalt kvoorumi jagu töökorras talletusteenuse isendeid. Kvoorumi suurus on\nN/2+1 ümardatud alla, kus N on seadistatud isendite arv (näiteks kolme\nseadistatud isendi korral on kvoorumi suurus kaks).\n\nKui talletusteenuse isendeid jääb alles vähem kui kvoorumi jagu, siis tuleb\nteha kõigile isenditele uus paigaldus (vt.\n:ref:`talletusteenuste-täielik-krahh`).\n\nTalletusteenuse kvoorumist tingitud piirangud:\n\n#. Talletusteenuse isendite arvu ei ole kunagi võimalik vähendada ühele;\n\n#. Talletusteenuste isendite eemaldamisel peab arvestama kvoorumi säilimisega.\n\n Näide: kui on seadistatud 6 talletusteenuse isendit (kvoorum=4), siis sealt\n ei saa korraga eemaldada kolme isendit (jääks järgi kolm isendit,\n kvoorum=2), kuna seadistatud isendite hulk oleks siis väiksem kui algne\n kvoorum. Kõigepealt tuleb eemaldada üks (jääb järgi 5 isendit, kvoorum=3)\n isend ja alles pärast seda saab eemaldada ülejäänud kaks.\n\n.. seealso::\n\n * :ref:`teenuse-taaskäivitamine`\n\n * :ref:`teenuse-asendamine`\n\n * :ref:`recovery-storageservice`\n\n.. _talletusteenuste-täielik-krahh:\n\nTalletusteenuste täielik krahh ehk kogumisteenuse täielik asendamine\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nTalletusteenuste täielikul asendamisel tuleb koostada uus tehniline seadistus,\nmis vastab järgmistele tingimustele:\n\n* ei sisalda ühtegi vana talletusteenust;\n\n* kõik uued talletusteenused on loetletud parameetri ``storage.conf.bootstrap``\n nimekirjas.\n\n.. important::\n\n Talletusteenuste täielikul asendamisel tuleb arvestada järgnevada:\n\n * enne asendamist kogutud hääled säilivad varundusserveritesse tehtud\n varukoopiates;\n\n * varukoopia loomise ja krahhi vahel kogutud hääled lähevad kaotsi;\n\n * valikute, ringkondade ja valijate nimekirjad tuleb teenustele uuesti rakendada.\n\n.. seealso::\n\n * :ref:`recovery-fullstorage`\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/lisad.rst", "content": ".. IVXV kogumisteenuse haldusjuhend\n\nLisad\n=====\n\n.. _utiliidid:\n\nUtiliidid\n---------\n\nKogumisteenuse haldamise käsureautiliitide ülevaade ja abiteave.\n\n.. contents:: .\n :local:\n :depth: 1\n\n\nAndmehoidla utiliidid\n^^^^^^^^^^^^^^^^^^^^^\n\n.. include:: utiliitide-abiteave/ivxv-create-data-dirs.inc\n\n.. include:: utiliitide-abiteave/ivxv-db-reset.inc\n\n.. include:: utiliitide-abiteave/ivxv-db-dump.inc\n\n\nTeenuse seisundi utiliidid\n^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n.. include:: utiliitide-abiteave/ivxv-status.inc\n\n.. include:: utiliitide-abiteave/ivxv-service.inc\n\n\nSündmuste logi utiliidid\n^^^^^^^^^^^^^^^^^^^^^^^^\n\n.. include:: utiliitide-abiteave/ivxv-eventlog-dump.inc\n\n\nKasutajate halduse utiliidid\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n.. include:: utiliitide-abiteave/ivxv-users-list.inc\n\n\nSeadistusutiliidid\n^^^^^^^^^^^^^^^^^^\n\n.. include:: utiliitide-abiteave/ivxv-collector-init.inc\n\n.. include:: utiliitide-abiteave/ivxv-cmd-load.inc\n\n.. include:: utiliitide-abiteave/ivxv-config-validate.inc\n\n.. include:: utiliitide-abiteave/ivxv-config-apply.inc\n\nSeadistuste rakendamine hallatavatele teenustele on võimalik siis, kui\nhaldusteenusesse on laaditud kogumisteenuse tehnilised seadistused.\n\nSeadistuste rakendamise järjekord:\n\n#. Tehnilised seadistused koos usaldusjuure seadistustega.\n\n #. Teenuse tarkvara paigaldamine;\n\n #. Haldusteenuse ligipääsu loomine hallatava teenuse kontole;\n\n #. Teenuse logimisseadistuste rakendamine;\n\n #. Haldusteenuse ligipääsu eemaldamine teenuse hosti juurkasutaja kontole\n (ainult juhul, kui teenusmasinas pole rohkem seadistamata teenuseid);\n\n #. Usaldusjuure rakendamine teenusele;\n\n #. Tehniliste seadistuste rakendamine teenusele;\n\n#. Valikute nimekiri;\n\n#. Ringkondade nimekiri;\n\n#. Valijate nimekirjad;\n\nLogikogumisteenus erineb teistest hallatavatest teenustest:\n\n#. Logikogumisteenus seadistatakse enne teisi teenuseid, et tagada võimalikult\n varajane logi kogumine.\n\n#. Logikogumisteenustele ei rakendata muid seadistusi peale logikogumisteenuse\n seadistuste (usaldusjuure seadistusi, kogumisteenuse tehnilised seadistusi\n ja valimiste seadistusi logikogumisteenus ei vaja).\n\nValimisnimekirjade (valikute ja valijate nimekirjad) rakendamine tähendab\nnimekirja ülekandmist talletusteenusesse vastavat nimekirja teenindava teenuse kaudu.\n\nNäiteks valikute nimekiri rakendatakse vaid ühele (juhuslikult valitud)\nnimekirjateenusele, mis kannab nimekirja talletusteenusesse. Talletusteenuse\nkaudu on nimekiri kättesaadav kõigile teistele nimekirjateenustele.\n\n.. include:: utiliitide-abiteave/ivxv-voter-list-download.inc\n\n.. include:: utiliitide-abiteave/ivxv-secret-load.inc\n\n.. include:: utiliitide-abiteave/ivxv-copy-log-to-logmon.inc\n\n.. include:: utiliitide-abiteave/ivxv-update-packages.inc\n\n.. include:: utiliitide-abiteave/ivxv-backup-crontab.inc\n\n\nAndmete eksportimise ja varundamise utiliidid\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n.. include:: utiliitide-abiteave/ivxv-export-votes.inc\n\n.. include:: utiliitide-abiteave/ivxv-backup.inc\n\n.. include:: utiliitide-abiteave/ivxv-generate-processor-input.inc\n\n.. include:: utiliitide-abiteave/ivxv-voterstats.inc\n\n.. include:: utiliitide-abiteave/ivxv-voting-sessions.inc\n\n\nDeemonid\n^^^^^^^^\n\n.. include:: utiliitide-abiteave/ivxv-agent-daemon.inc\n\n\nSisemised utiliidid\n^^^^^^^^^^^^^^^^^^^\n\n.. attention::\n\n Sisemised utiliidid on kasutusel haldusdeemoni poolt alamteenuste\n haldamiseks ja neid ei ole reeglina tarvis eraldi käivitada.\n\n.. include:: utiliitide-abiteave/ivxv-admin-helper.inc\n\n.. include:: utiliitide-abiteave/ivxv-admin-sudo.inc\n\n\nSeadistusfailid\n---------------\n\n.. _ivxv-logcollector.conf:\n\nLogikogumisteenuse seadistusfail\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n.. literalinclude:: ../../../common/collector/config/rsyslog-logcollector.conf\n :name: /etc/rsyslog.d/ivxv-logcollector.conf\n :language: text\n :linenos:\n\n\nLisaseadistused\n---------------\n\n.. _configure-ssh-idcard-auth:\n\nSSH kasutajate autentimine ID-kaardi abil\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nSSH-teenusesse on võimalik autentida ID-kaardi avaliku võtmega abil, kasutades\nselleks PKCS#11 toega SSH-klienti ``kitty.exe`` (http://kitty.9bis.net/).\n\nTurvakaalutustel tuleks keelata haldusliidese SSH-teenusesse parooliga\nautentimine. Parooliga autentimise keelamiseks tuleb seadistusfailis\n:file:`/etc/ssh/sshd_config` määrata parameetri ``PasswordAuthentication``\nväärtuseks ``no``::\n\n # To disable tunneled clear text passwords, change to no here!\n PasswordAuthentication no\n\nVolitatud kasutajate faili asukoht (:file:`/etc/ssh/kasutajad`) tuleb failis\n:file:`/etc/ssh/sshd_config` määrata parameetriga ``AuthorizedKeysFile``:\n\n ``AuthorizedKeysFile /etc/ssh/kasutajad``\n\n.. important::\n\n Seadistusfailis ``/etc/ssh/sshd_config`` tehtud muutuse rakendamiseks tuleb\n SSH teenus taaskäivitada::\n\n # service ssh restart\n [ ok ] Restarting OpenBSD Secure Shell server: sshd.\n\nID-kaardi isikutuvastamise sertifikaadiga autenditava kasutaja ülesseadmine\nkäib järgmiselt:\n\n#. Kasutajale konto loomine:\n\n .. code-block:: shell-session\n\n # adduser --disabled-password kasutajanimi\n # usermod -a -G www-data kasutajanimi\n\n#. Kasutaja ID-kaardi isikutuvastamise sertifikaadi salvestamine PEM-vormingus\n faili :file:`usercert.cer` (ID-kaardi haldusvahendi abil);\n\n#. Sertifikaadist kasutaja avaliku võtme eraldamine ja salvestamine faili\n :file:`userpubkey.pem`:\n\n .. code-block:: shell-session\n\n # openssl x509 -in usercert.cer -pubkey -noout > userpubkey.pem\n\n#. Avaliku võtme teisendamine PKCS#8 vormingusse, kasutaja tunnusega\n varustamine ja salvestamine SSH volitatud kasutajate faili\n :file:`/etc/ssh/kasutajad`:\n\n .. code-block:: shell-session\n\n # KEY=$(ssh-keygen -i -m PKCS8 -f userpubkey.pem)\n # echo \"$KEY kasutaja@eesti.ee\" >> /etc/ssh/kasutajad\n\n#. Kontrollimine, kas lisatud kirje on kujul ``ssh-rsa PKCS8-võti``\n kasutajatunnus:\n\n .. code-block:: shell-session\n\n # tail -1 /etc/ssh/kasutajad\n ssh-rsa AAAAB3NzaC1yc2EAAAAELGuiTwAAAIEAxZf/TuSrGJEU1PlfkY9jJ33VOYVZ9Vao0Uiytlf8\n 7HJu/78fCIB7m05J7ibpMhsZoZ4DElU7ve0VwbvdDS3srh1OhiQcUjpznTlx4rIM1vkHwadrHtmF+BNi\n DwbLbbdD5y3puGcLH+sLuwba6Vuc3aU0QuqzenYmY9pV7w9y0wc= kasutaja@eesti.ee\n\n\nAndmehoidla\n-----------\n\nHaldusteenuse andmeid hoitakse failisüsteemis ja andmebaasis. Failisüsteemis\nhoitakse andmeid, mis on pärit välistest süsteemidest ja on haldusteenusesse\nüle kantud faili kujul. Andmebaasis hoitakse andmeid, mis on genereeritud\nhaldusteenuse töö käigus.\n\n\nFailisüsteemis hoitavad andmed\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n* :file:`/etc/ivxv/` -- kogumisteenusele rakendatud ja hetkel kehtivad\n seadistus- ja nimekirjafailid;\n\n* :file:`/var/lib/ivxv/` -- kogumisteenuse haldusteenuse andmefailid;\n\n* :file:`/var/lib/ivxv/admin-ui-data/` -- haldusteenuse veebiliidese jaoks\n serveeritavad JSON-failid;\n\n* :file:`/var/lib/ivxv/admin-ui-data/status.json` -- kogumisteenuse seisundi\n koondandmed;\n\n* :file:`/var/lib/ivxv/admin-ui-permissions/` -- haldusteenuse veebiliidese\n kasutajaõigused (Apache veebiserveri jaoks);\n\n* :file:`/var/lib/ivxv/ballot-box/` -- allalaaditava e-valimiskasti salvestamise kataloog;\n\n* :file:`/var/lib/ivxv/commands/` -- kogumisteenuse juhtimiseks rakendatud\n korraldusfailide ajalugu;\n\n* :file:`/var/lib/ivxv/commands/-.bdoc` --\n digitaalselt allkirjastatud korraldus ``ASiC-E`` vormingus.\n\n* :file:`/var/lib/ivxv/commands/-.json` --\n korralduse olekufail JSON-vormingus.\n\n* :file:`/var/lib/ivxv/db/` -- haldusteenuse andmebaasi kataloog;\n\n* :file:`/var/lib/ivxv/db/ivxv-management.db` -- haldusteenuse andmebaasi\n fail;\n\n* :file:`/var/lib/ivxv/ivxv-management-events.log` -- haldusteenuse sündmuste\n logi;\n\n* :file:`/var/lib/ivxv/service/` -- muud teenusespetsiifilised failid\n (nt. registreerimisvõtmest eraldatud avalik võti);\n\n* :file:`/var/lib/ivxv/upload/` -- kogumisteenusesse veebiliidese kaudu\n laaditud failid;\n\nAndmebaasis hoitavad andmed\n^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nAndmevälja nimi ja kirjeldus:\n\n* ``collector/state`` -- kogumisteenuse olek;\n\n* ``config/election`` -- kogumisteenuses rakendatud valimiste seadistusele\n digiallkirja andnud volitatud kasutaja andmed kujul `` ``;\n\n* ``config/technical`` -- kogumisteenuses rakendatud tehnilisele seadistusele\n digiallkirja andnud volitatud kasutaja andmed kujul `` ``;\n\n* ``config/trust`` -- kogumisteenuses rakendatud usaldusjuure seadistusele\n digiallkirja andnud volitatud kasutaja andmed kujul `` ``;\n\n* ``election/election-id`` -- valimiste identifikaator;\n\n* ``election/electionstart`` -- valimiste algusaeg;\n\n* ``election/electionstop`` -- valimiste lõpuaeg;\n\n* ``election/servicestart`` -- kogumisteenuse käivitamise aeg;\n\n* ``election/servicestop`` -- kogumisteenuse seiskamise aeg;\n\n* ``host//state`` -- teenushosti seisund;\n\n* ``list/choices`` -- haldusteenusesse laaditud valikute nimekirjale\n digiallkirja andnud volitatud kasutaja andmed kujul `` ``;\n\n* ``list/choices-loaded`` -- nimekirjateenustesse laaditud valikute\n nimekirjale digiallkirja andnud volitatud kasutaja andmed kujul ``\n ``;\n\n* ``list/districts`` -- nimekirjateenustesse laaditud ringkondade\n nimekirjale digiallkirja andnud volitatud kasutaja andmed kujul ``\n ``;\n\n* ``list/districts-loaded`` -- nimekirjateenustesse laaditud ringkondade\n nimekirjale digiallkirja andnud volitatud kasutaja andmed kujul ``\n ``;\n\n* ``list/voters0000`` -- haldusteenusesse laaditud valijate algnimekirjale\n digiallkirja andnud volitatud kasutaja andmed kujul `` ``;\n\n* ``list/voters`` (``list-number >= 01``) -- haldusteenusesse\n laaditud valijate muudatusnimekirja allalaadimise hetke ajatempel;\n\n* ``list/voters-state`` -- nimekirjateenustesse laaditud valijate\n nimekirja olek.\n\n Võimalikud väärtused:\n\n 1. ``PENDING`` - laaditud haldusteenusesse;\n\n 2. ``APPLIED`` - rakendatud nimekirjateenusele;\n\n 3. ``INVALID`` - nimekiri on märgitud vigaseks ja ootab halduri otsust\n vahelejätmise kohta (ainult muudatusnimekirja korral);\n\n 4. ``SKIPPED`` - nimekiri on vahele jäetud (ainult muudatusnimekirja korral).\n\n* ``logmonitor/address`` -- seireteenuse aadress või võrgunimi;\n\n* ``logmonitor/last-data`` -- viimase seireteenusest statistikafaili hankimise\n aeg;\n\n* ``user/`` -- haldusteenuse kasutaja nimi ja rollid kujul\n `` [,]``;\n\n* ``service//service-type`` -- Teenuse liik;\n\n* ``service//technical-conf-version`` -- Teenusele rakendatud\n tehnilise seadistuse versioon;\n\n* ``service//election-conf-version`` -- Teenusele rakendatud\n valimiste seadistuse versioon;\n\n* ``service//network`` -- Teenusele alamvõrgu nimi;\n\n* ``service//state`` -- Teenuse olek;\n\n* ``service//ping-errors`` -- Teenuse elusoleku kontrollimise\n järjestikuste vigade arv;\n\n* ``service//last-data`` -- Teenuse viimase oleku hankimise aeg;\n\n* ``service//ip-address`` -- Teenuse IP-aadress;\n\n* ``service//bg_info`` -- Teenuse taustainfo stringina (näiteks\n elusoleku kontrolli käigus genereeritud veateade);\n\n* ``service//backup-times`` -- Varundusteenuse automaatvarunduse\n kellaajad;\n\n* ``service//mid-token-key`` -- Mobiil-ID/Smart-ID/Web eID tugiteenuse\n identsustõendi võtmefaili kontrollsumma (SHA256);\n\n* ``service//tls-cert`` -- Teenuse TLS-sertifikaadi faili\n kontrollsumma (SHA256);\n\n* ``service//tls-key`` -- Teenuse TLS-sertifikaadi võtmefaili\n kontrollsumma (SHA256);\n\n* ``service//tspreg-key`` -- Hääletamisteenuse ajatempliteenuse\n signeerimisvõtme faili kontrollsumma (SHA256);\n\nKasutatud tähised:\n\n* ```` -- korralduse liik:\n\n #. ``trust`` -- usaldusjuure seadistused;\n\n #. ``technical`` kogumisteenuse seadistused;\n\n #. ``election`` valimiste seadistused;\n\n* ```` -- ID-kaardi CN väli kujul ``PEREKONNANIMI,EESNIMI,ISIKUKOOD``;\n\n* ```` on seadistuse liik. Usaldusjuure seadistus on ``trust``,\n valimiste seadistus on ``election`` ja kogumisteenuse tehniline\n seadistus on ``tech``;\n\n* ```` teenushosti nimi;\n\n* ```` valimisnimekirja kahekohaline järjekorranumber, esimene nimekiri\n kannab numbrit 01.\n\n* ```` teenuse identifikaator kogumisteenuse seadistustest;\n\n* ```` on ajatempel ISO-8601 vormingus.\n\n\n.. _etcd-zabbix:\n\nKlastri seisundi monitoorimine Zabbixiga\n----------------------------------------\n\nEtcd klaster tagab süsteemi toimimise ka olukorras, kus mõni klastriliige kaotab\ntöövõime (krahh, võrguühenduse kadumine jms.). Siiski on oluline selliseid\nsündmuseid monitoorida ning nende algpõhjus tuvastada. Etcd krahhimise\ntuvastamiseks tuleb talletusteenuste logidest (``ivxv-YYYY-MM-DD-HH.log``) monitoorida\n``ivxv.ee/service/storage.EtcdTerminatedError`` kirjet.\n\nTäiendavalt saab etcd käsureakliendiga küsida klastri liikmete olekut. Kuna\nIVXV klastris on kõik klient-päringud autenditud, siis tuleb korraldus\nkäivitada mõnes ``ivxv-storage`` teenuse masinas kasutajakonto\n``ivxv-storage`` (või juurkasutaja) õigustes:\n\n.. code-block:: shell-session\n\n # ivxv-storage@ivxv1:~$ env ETCDCTL_API=3 etcdctl \\\n --cacert /var/lib/ivxv/service/storage@storage1.ivxv.ee/ca.pem \\\n --cert /var/lib/ivxv/service/storage@storage1.ivxv.ee/tls.pem \\\n --key /var/lib/ivxv/service/storage@storage1.ivxv.ee/tls.key \\\n --endpoints ivxv1:2379,ivxv2:2379,ivxv3:2379 \\\n endpoint status\n\n ivxv1:2379, 2d0df029f29770a4, 3.2.17, 25 kB, true, 12, 15\n ivxv2:2379, d4a9ae16c8557764, 3.2.17, 25 kB, false, 12, 15\n ivxv3:2379, e8914f4e0b89b80f, 3.2.17, 25 kB, false, 12, 15\n\nVastuses on veergude tähendused järgmised:\n\n #. klastri liige;\n #. klastri liikme identifikaator;\n #. etcd versioon;\n #. baasi suurus (max 8GB ehk 8589934592);\n #. kas konkreetne klastri liige on hetkel juht;\n #. RAFT ametiaeg (sisuliselt toimunud juhi-valimiste arv);\n #. RAFT indeks - etcd kirjutamisoperatsioonide arv (sh.\n konfiguratsiooni muutused).\n\nMonitooringule on oluline parameeter RAFT ametiaeg. Selle väärtuse muutumine\ntähendab juhivahetust, mis üldjuhul on seotud probleemidega klastri töös -\nolemasolev juht ei vasta piisavalt kiiresti klastri liikmete päringutele.\n\nKäsurea seletus:\n\n * ``env ETCDCTL_API=3``: kasutame etcd API versiooni 3 (Ubuntu versioonis\n 20.04 LTS on ``etcdctl`` API vaikeversioon veel 2);\n * ``--cacert``: usaldame ainult servereid, mille sertifikaat on antud selle CA\n poolt;\n * ``--cert`` ja ``--key``: kasutame klient-autentimiseks ivxv1 talletusteenuse\n sertifikaati ja võtit;\n * ``--endpoints``: millistele serveritele päring saata. Siin võib kõigi kolme\n asemel ka ainult ühe loetleda: sellisel juhul on väljundis vaid üks rida.\n Kasulik nt kui Zabbix tahab igas talletusteenuses küsida ainult selle isendi\n kohta;\n * ``endpoint status``: küsime loetletud serverite olekut.\n\n\nVäljundit on võimalik küsida ka masinloetavas JSON-vormingus\n(parameeter ``-w json``):\n\n .. code-block:: shell-session\n\n ivxv-storage@ivxv1:~$ env ETCDCTL_API=3 etcdctl \\\n --cacert /var/lib/ivxv/service/storage@storage1.ivxv.ee/ca.pem \\\n --cert /var/lib/ivxv/service/storage@storage1.ivxv.ee/tls.pem \\\n --key /var/lib/ivxv/service/storage@storage1.ivxv.ee/tls.key \\\n --endpoints ivxv1:2379,ivxv2:2379,ivxv3:2379 \\\n endpoint status -w json\n\n [{\"Endpoint\":\"ivxv1:2379\",\"Status\":{\"header\":{\"cluster_id\":1867986262344190226,\"member_id\":3246514969358332068,\"revision\":1,\"raft_term\":12},\"version\":\"3.2.17\",\"dbSize\":24576,\"leader\":3246514969358332068,\"raftIndex\":15,\"raftTerm\":12}},\n {\"Endpoint\":\"ivxv2:2379\",\"Status\":{\"header\":{\"cluster_id\":1867986262344190226,\"member_id\":15323970619978381156,\"revision\":1,\"raft_term\":12},\"version\":\"3.2.17\",\"dbSize\":24576,\"leader\":3246514969358332068,\"raftIndex\":15,\"raftTerm\":12}},\n {\"Endpoint\":\"ivxv3:2379\",\"Status\":{\"header\":{\"cluster_id\":1867986262344190226,\"member_id\":16758262885041944591,\"revision\":1,\"raft_term\":12},\"version\":\"3.2.17\",\"dbSize\":24576,\"leader\":3246514969358332068,\"raftIndex\":15,\"raftTerm\":12}}]\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/protseduurid.rst", "content": ".. IVXV kogumisteenuse haldusjuhend\n\nProtseduurid\n============\n\n\n.. _recovery-stateless:\n\nJuhend: olekuvaba mikroteenuse isendi taastamine krahhist\n---------------------------------------------------------\n\n.. include:: recovery/recovery_stateless.inc\n\n\n\n.. _recovery-logcollection:\n\nJuhend: logikogumisteenuse isendi taastamine krahhist\n-----------------------------------------------------\n\n.. include:: recovery/recovery_logcollection.inc\n\n\n\n.. _recovery-backupservice:\n\nJuhend: varundusteenuse isendi taastamine krahhist\n--------------------------------------------------\n\n.. include:: recovery/recovery_backupservice.inc\n\n\n\n.. _recovery-storageservice:\n\nJuhend: talletusteenuse isendi taastamine krahhist\n--------------------------------------------------\n\n.. include:: recovery/recovery_storageservice.inc\n\n\n\n.. _recovery-fullstorage:\n\nJuhend: talletusteenuse taastamine täielikust krahhist\n------------------------------------------------------\n\n.. include:: recovery/recovery_fullstorage.inc\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/recovery/recovery_backupservice.inc", "content": "\nKrahhi toimumise indikaatorid\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nHaldusveebiliides.\nVali **Teenused** vasakult menüüst. Kui varundusteenus on krahhinud,\nsiis tema **Seisund** on **Tõrge**.\n\nHalduskäsurealiides.\nLogi sisse **ivxv-admin** kasutajana ja päri teenuste statistikat::\n\n $ sudo su - ivxv-admin\n $ ivxv-status\n\nKui varundusteenus on krahhinud, siis tema **State** on **FAILURE**.\n\n\nKrahhist taastumise eeldused\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nKrahhist taastumine on alati võimalik.\n\n\nKrahhi võimalik mõju hääletamistulemusele\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nVarundusteenuse krahh mõjutab hääletamistulemust (andmekadu), kui täiendavalt\nkrahhib ka talletusteenus.\n\n\nKrahhist taastumise sammud\n^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n.. seealso::\n\n * Kasuta :ref:`recovery-stateless` juhendis oleva\n **Teenuse masin on krahhinud, v.a vahendus- ja x-tee teenused**\n peatükki, v.a sammud 8, 10, 12-16.\n\n.. note::\n\n Punktis 10 tuleb välja vahetada ainult varundusteenuse **id** ja **address**\n väljad:\n\n .. code-block:: yaml\n\n - id: zone0\n services:\n log:\n - id: backup@backup1.ivxv.ee\n address: backup1\n\n uute vastu:\n\n .. code-block:: yaml\n\n - id: zone0\n services:\n log:\n - id: backup@backup2.ivxv.ee\n address: backup2\n\nSSH logi sisse haldusmasinasse **ivxv-admin** kasutajana::\n\n $ sudo su - ivxv-admin\n\nSeadista SSH ühenduse loomiseks *prompt* sõnumi\n*Are you sure you want to continue connecting (yes/no)? yes* kinnitamist\nvältida, näiteks, kui varundusteenuse masina DNS **address** on *backup2*::\n\n $ ssh backup2\n $ echo \"StrictHostKeyChecking no\" >> /var/lib/ivxv/user/ivxv-admin/.ssh/config\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/recovery/recovery_fullstorage.inc", "content": "Krahhi toimumise indikaatorid\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nHaldusveebiliides.\nVali **Teenused** vasakult menüüst. Kui talletusteenused on krahhinud,\nsiis tema **Seisund** on **Tõrge**.\n\nHalduskäsurealiides.\nLogi sisse **ivxv-admin** kasutajana ja päri teenuste statistikat::\n\n $ sudo su - ivxv-admin\n $ ivxv-status\n\nKui talletusteenused on krahhinud, siis tema **State** on **FAILURE**.\n\n\nKrahhist taastumise eeldused\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nKrahhi taastumiseks piisab kui teenuste CA TLS privaatvõti ja sertifikaat on\nalles, mida saab kasutada teenuse varuvõtmete ja -sertifikaatide\ngenereerimiseks. Samas, saab ka enne valimisi teenuse varuvõtmed ja\n-sertifikaadid ette genereerida.\n\nKui kõikide teenuste CA on sama, siis tasub valija- ja kontrollrakenduste\nseadistusse panna hoopis CA TLS sertifikaadi. Juhul kui CA on teenustel erinev,\nsiis peab panema kõik teenuste TLS sertifikaadid rakenduste seadistusse\nvahetult enne valimisi.\n\n\nKrahhi võimalik mõju hääletamistulemusele\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nKui krahhib talletusteenuse klaster, siis kindlasti tegu on andmekaoga.\nAndmekao suurus sõltub varundusteenusest ehk kui tihti e-urni varundati.\n\nLisaks, juba hääletanud valijal võivad tekkida segadus, kui teist korda\nhääletades, kuvatakse valijarakenduses \"Teie pole veel hääletanud\"\ntervitustekst.\n\n\nKrahhist taastumise sammud\n^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n.. seealso::\n\n * Tee :ref:`recovery-storageservice` juhendis oleva\n **Teenuse andmed (võti, sertifikaat jne) on rikutud või masina krahh**\n peatükki protseduurid läbi iga uue koguja masina jaoks.\n\n.. note::\n\n Punktis 10 tuleb välja vahetada kõik vanad **id** ja **address** kirjed\n uute vastu, lisaks tuleb muuta ka talletusteenuse **bootstrap**\n seadistust:\n\n .. code-block:: yaml\n\n bootstrap:\n - storage@storage1.ivxv.ee\n - storage@storage2.ivxv.ee\n - storage@storage3.ivxv.ee\n\n selliselt:\n\n .. code-block:: yaml\n\n bootstrap:\n - storage@storage4.ivxv.ee\n - storage@storage5.ivxv.ee\n - storage@storage6.ivxv.ee\n\nNüüd tuleb taastada koguja krahhieelne seisund, v.a kaotsi läinud hääled:\n\n #. SSH logi sisse haldusmasinasse **ivxv-admin** kasutajana::\n\n $ sudo su - ivxv-admin\n\n #. Laadi ringkondade nimekiri::\n\n $ ivxv-config-apply --type=districts\n\n #. Laadi valikute nimekiri::\n\n $ ivxv-config-apply --type=choices\n\n #. Laadi nii valijate alg-, kui ka kõik vahepealsed muudatusnimekirjad::\n\n $ ivxv-config-apply --type=voters\n\n.. warning::\n Ära unusta, et valimiste lõpus tuleb hääli alla laadida koos varundatud\n häältega, et vähemalt mingis ulatuses tagada e-urni terviklikkus::\n\n $ ivxv-export-votes --consolidate\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/recovery/recovery_logcollection.inc", "content": "Krahhi toimumise indikaatorid\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nHaldusveebiliides.\nVali **Teenused** vasakult menüüst. Kui logikogumisteenus on krahhinud,\nsiis tema **Seisund** on **Tõrge**.\n\nHalduskäsurealiides.\nLogi sisse **ivxv-admin** kasutajana ja päri teenuste statistikat::\n\n $ sudo su - ivxv-admin\n $ ivxv-status\n\nKui logikogumisteenus on krahhinud, siis tema **State** on **FAILURE**.\n\n\nKrahhist taastumise eeldused\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nKrahhist taastumine on alati võimalik.\n\n\nKrahhi võimalik mõju hääletamistulemusele\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nHääletamistulemusele mõju puudub, küll aga krahhinud logikogumisteenusega kaob\nka osa varundatud logidest, mida enam taastada ei ole võimalik. Samas, need\nlogid on ikkagi endiselt alles koguja masinates, ning ka logimonitori\nmasinas. Ainus koht kus avaldub logikogumisteenuse krahh on varundusteenuse\nmasin, kus jääbki puudu osa varundatud logidest.\n\n\nKrahhist taastumise sammud\n^^^^^^^^^^^^^^^^^^^^^^^^^^\n.. seealso::\n\n * Kasuta :ref:`recovery-stateless` juhendis oleva\n **Teenuse masin on krahhinud, v.a vahendus- ja x-tee teenused**\n peatükki, v.a sammud 10, 12-16.\n\n\n.. note::\n\n Punktis 10 tuleb välja vahetada ainult logikogumisteenuse **id** ja\n **address** väljad:\n\n .. code-block:: yaml\n\n - id: zone0\n services:\n log:\n - id: log@log1.ivxv.ee\n address: log1:20514\n\n uute vastu:\n\n .. code-block:: yaml\n\n - id: zone0\n services:\n log:\n - id: log@log2.ivxv.ee\n address: log2:20514\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/recovery/recovery_stateless.inc", "content": "Krahhi toimumise indikaatorid\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nHaldusveebiliides.\nVali **Teenused** vasakult menüüst. Kui teenus on krahhinud,\nsiis tema **Seisund** on **Tõrge**.\n\nHalduskäsurealiides.\nLogi sisse **ivxv-admin** kasutajana ja päri teenuste statistikat::\n\n $ sudo su - ivxv-admin\n $ ivxv-status\n\nKui teenus on krahhinud, siis tema **State** on **FAILURE**.\n\n\nKrahhist taastumise eeldused\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nKrahhist taastumiseks piisab kui teenuste CA TLS privaatvõti ja sertifikaat on\nalles, mida saab kasutada teenuse varuvõtmete ja -sertifikaatide\ngenereerimiseks. Samas, saab ka enne valimisi teenuse varuvõtmed ja\n-sertifikaadid ette genereerida.\n\nKui kõikide teenuste CA on sama, siis tasub valija- ja kontrollrakenduste\nseadistusse panna hoopis CA sertifikaat. Juhul kui CA on teenustel erinev,\nsiis peab panema kõik teenuste TLS sertifikaadid rakenduste seadistusse\nvahetult enne valimisi.\n\n\nKrahhi võimalik mõju hääletamistulemusele\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nSõltuvalt teenusest võivad tagajärjed olla järgmised:\n\n * kui krahhivad nimekirja-, Mobiil-ID, vahendus-, seansi-, Smart-ID,\n hääletamis-, Web-eID teenused, siis valijal ei õnnestu hääletada\n\n * kui krahhivad järjekorra- ja x-tee teenused, siis VIS ei saa pärida\n andmeid x-tee kaudu\n\n * kui krahhib verifitseerimisteenus, siis valijal ei õnnestu oma häält\n verifitseerida\n\n\nKrahhist taastumise sammud\n^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n.. seealso::\n\n * Talletusteenust antud juhendis ei käsitleta, selleks\n on eraldi juhend :ref:`recovery-storageservice`\n\nKrahhi saab liigitada järgmiselt:\n\n #. Teenus on terve, ning vajab ainult taaskäivitamist, v.a x-tee teenus\n\n #. Teenuse andmed (TLS privaatvõti, sertifikaat jne) on rikutud, v.a\n vahendus- ja x-tee teenused\n\n #. Teenuse lähtekoodis on viga, v.a x-tee teenus\n\n #. X-tee teenuse taastumine, sh. krahh ja lähtekoodi viga\n\n #. Teenuse masin on krahhinud, v.a vahendus- ja x-tee teenused\n\n #. Vahendusteenuse masin on krahhinud\n\nTeenus on terve, ning vajab ainult taaskäivitamist, v.a x-tee teenus\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n #. SSH logi sisse haldus masinasse **ivxv-admin** kasutajana::\n\n $ sudo su - ivxv-admin\n\n #. Taaskäivita teenus, näiteks nimekirjateenust::\n\n $ ivxv-service restart choices@choices1.ivxv.ee\n\nTeenuse andmed (TLS privaatvõti, sertifikaat jne) on rikutud, v.a vahendus- ja x-tee teenused\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n #. Vaheta välja krahhinud teenuse **id** tehnilises seadistuses\n varuteenuse **id** vastu, mille TLS privaatvõti ja sertifikaat on\n genereeritud\n\n #. Allkirjasta tehniline seadistus\n\n #. Laadi seadistus läbi haldusveebiliidese **Seadistused**\n\n #. SSH logi sisse haldusmasinasse **ivxv-admin** kasutajana::\n\n $ sudo su - ivxv-admin\n\n #. Laadi TLS privaatvõti ja sertifikaat, näiteks nimekirjateenus::\n\n $ ivxv-secret-load --service=choices@choices4.ivxv.ee tls-key /opt/ivxv-install/service_definition/choices@choices4.ivxv.ee.key\n $ ivxv-secret-load --service=choices@choices4.ivxv.ee tls-cert /opt/ivxv-install/service_definition/choices@choices4.ivxv.ee.pem\n\n #. Kui tegu on nimekirja-, Mobiil-ID, Smart-ID, hääletamis-, Web-eID või\n verifitseerimisteenusega siis tuleb üles laadida ka küpsiste\n allkirjatamiseks privaatvõti::\n\n $ ivxv-secret-load mid-token-key /opt/ivxv-install/service_definition/ticket.key\n\n #. Kui tegu on hääletamisteenusega siis tuleb üles laadida TSP vastuse\n räsi allkirjastamiseks privaatvõti::\n\n $ ivxv-secret-load tsp-regkey /opt/ivxv-install/service_definition/tspreg.key\n\n #. Käivita teenused::\n\n $ ivxv-config-apply --type=election\n\nTeenuse lähtekoodis on viga, v.a x-tee teenus\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n #. Kopeeri uus *.deb* pakk haldusmasinasse\n\n #. SSH logi sisse haldusmasinasse **sudo** kasutajana::\n\n $ sudo su\n\n #. Kopeeri *.deb* pakk */etc/ivxv/debs/* kausta\n\n #. Logi **sudo** kasutajalt välja::\n\n $ exit\n\n #. SSH logi sisse haldusmasinasse **ivxv-admin** kasutajana::\n\n $ sudo su - ivxv-admin\n\n #. Uuenda teenuse *.deb* pakki kõikides masinates, näiteks nimekirjateenus::\n\n $ ivxv-update-packages --service=choices --package=/etc/ivxv/debs/ivxv-choices_1.9.12~dev_amd64.deb\n\n #. Taaskäivita teenus igal hostil, näiteks taaskäivitame nimekirjateenuse\n kolmeõlgse seadistuse korral::\n\n $ ivxv-service restart choices@choices1.ivxv.ee\n $ ivxv-service restart choices@choices2.ivxv.ee\n $ ivxv-service restart choices@choices3.ivxv.ee\n\nX-tee teenuse taastumine, sh. krahh ja lähtekoodi viga\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n #. Esmalt tasub proovida taaskäivitada systemd x-tee teenust::\n\n $ sudo systemctl restart xroad-service\n\n #. Ebaõnnestumise korral tuleb tarnida uus *.deb* pakk, ning\n vana pakk eemaldada::\n\n $ sudo apt purge xroad-service\n\n #. Kui uus *.deb* pakk on masinasse kopeeritud, tuleb see paigaldada::\n\n $ sudo apt install ./xroad-service_*.deb\n\n #. Kasuta x-tee teenuse juhendit, et paigaldada TLS sertifikaadid õigesse\n kaustadesse\n\n #. Käivita systemd x-tee teenus::\n\n $ sudo systemctl start xroad-service\n\nTeenuse masin on krahhinud, v.a vahendus- ja x-tee teenused\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n #. Paigalda värske Ubuntu masin\n\n .. important::\n Palun täpsusta üle, millist Ubuntu versiooni parasjagu\n kasutatakse\n\n #. Paigalda teenuse masinasse baastarkvara pakid APT\n pakihoidlast::\n\n $ sudo apt-get install acl locales unzip zstd --yes\n\n #. Nüüd tuleb haldus-, koguja-, varundus-, logi-, vahendus-, logi\n monitooringu masinate **ip** ja DNS **nimi** lisada uue teenuse masina\n */etc/hosts* faili\n\n #. Seejärel tuleb haldus-, koguja-, varundus-, logi-, vahendus masinates\n kustutada krahhinud teenuse masina **ip** ja DNS **nimi** ning lisada\n uus\n\n .. attention::\n\n See on kõige olulisem samm, kuna siin peab valima sellise DNS\n **nime**, mille tulevikus lisame tehnilistesse seadistustesse.\n\n Reegel on lihtne, et iga uue teenuse masina DNS **nimi** peab olema\n unikaalne ja ei tohi olla sama, mis krahhinud teenuste masinatele\n olid varem omistatud. Haldusteenuse andmebaasis on registreeritud\n kõigi süsteemis leiduvate masinate DNS **nimed**, isegi krahhinud\n isendite omad. Haldusteenuse eripära seisneb selles, et see ei\n paigalda tarkvara masinatele, mille DNS **nimi** on juba\n haldusteenuse andmebaasis registreeritud.\n\n #. SSH logi sisse haldusmasinasse **ivxv-admin** kasutajana::\n\n $ sudo su - ivxv-admin\n\n #. Kuna haldusteenus paigaldab vajaliku taristu kõikidele süsteemi masinatele\n automaatselt, siis on vaja vältida SSH ühenduse loomisel *prompt* sõnumi\n *Are you sure you want to continue connecting (yes/no)? yes* kinnitamist.\n\n Kustuta vana teenusmasina SSH avalik võti */etc/ssh/ssh_known_hosts*\n failist, ning lisa uus, näiteks, kui uue teenuse masina DNS **nimi** on\n *ivxv4*::\n\n $ ssh-keyscan -t ecdsa ivxv4 | grep -v ^# >> /etc/ssh/ssh_known_hosts\n\n #. SSH logi sisse uue teenuse masinasse **root** kasutajana::\n\n $ sudo su\n\n #. Kuna haldusteenus edastab teenuse logid logimonitori, lisaks\n *syslog* *RELP* protokollile, ka üle SSH protokolli, siis on vaja samuti\n vältida SSH ühenduse loomisel *prompt* sõnumi kinnitamist, näiteks,\n monitooringu masina *logmonitor* DNS **address** korral::\n\n $ ssh-keyscan -t ecdsa logmonitor | grep -v ^# >> /etc/ssh/ssh_known_hosts\n\n #. Kuna haldusteenus peab paigaldama tarkvara APT pakihoidlast, mis\n on võimatu juurkasutaja õiguseid omandamata, pead kopeerima haldusmasina\n SSH avaliku võtme, mis asub\n */var/lib/ivxv/user/ivxv-admin/.ssh/id_ed25519.pub* failis, ning lisama\n selle uue teenuse masina */root/.ssh/authorized_keys* faili\n\n #. Nüüd tuleb tehnilistes seadistustes välja vahetada teenuste **id** ja\n **nimed** (**address**), näiteks:\n\n .. code-block:: yaml\n\n - id: zone1\n services:\n mid:\n - id: mid@mid1.ivxv.ee\n address: ivxv1:4441\n choices:\n - id: choices@choices1.ivxv.ee\n address: ivxv1:4442\n voting:\n - id: voting@voting1.ivxv.ee\n address: ivxv1:4443\n verification:\n - id: verification@verification1.ivxv.ee\n address: ivxv1:4444\n smartid:\n - id: smartid@smartid1.ivxv.ee\n address: ivxv1:4445\n votesorder:\n - id: votesorder@votesorder1.ivxv.ee\n address: ivxv1:4446\n webeid:\n - id: webeid@webeid1.ivxv.ee\n address: ivxv1:4447\n origin: https://ivxv1.test.ivxv.ee:443\n sessionstatus:\n - id: sessionstatus@sessionstatus1.ivxv.ee\n address: ivxv1:4448\n\n uute **id** ja **address** vastu:\n\n .. code-block:: yaml\n\n - id: zone1\n services:\n mid:\n - id: mid@mid4.ivxv.ee\n address: ivxv4:4441\n choices:\n - id: choices@choices4.ivxv.ee\n address: ivxv4:4442\n voting:\n - id: voting@voting4.ivxv.ee\n address: ivxv4:4443\n verification:\n - id: verification@verification4.ivxv.ee\n address: ivxv4:4444\n smartid:\n - id: smartid@smartid4.ivxv.ee\n address: ivxv4:4445\n votesorder:\n - id: votesorder@votesorder4.ivxv.ee\n address: ivxv4:4446\n webeid:\n - id: webeid@webeid4.ivxv.ee\n address: ivxv4:4447\n origin: https://ivxv4.test.ivxv.ee:443\n sessionstatus:\n - id: sessionstatus@sessionstatus4.ivxv.ee\n address: ivxv4:4448\n\n .. attention::\n Pane tähele, et on muutunud nii **id** kui ka **address**.\n Vahendus- ja talletusteenuste **id** ja **address** jäävad samaks\n **siis ja ainult siis**, kui need teenused ei olnud krahhinud masina\n koosseisus, vastasel juhul tuleb sarnaselt muuta ka nende teenuste\n **id** ja **address**.\n\n #. Allkirjasta uus tehniline seadistus. Laadi see läbi\n haldusveebiliidese, vasakult valides **Seadusted**.\n\n #. SSH logi sisse haldusmasinasse **ivxv-admin** kasutajana::\n\n $ sudo su - ivxv-admin\n\n #. Laadi kõik teenuste TLS privaatvõtmed ja sertifikaadid, näiteks::\n\n $ ivxv-secret-load --service=choices@choices4.ivxv.ee tls-key /opt/ivxv-install/service_definition/choices@choices4.ivxv.ee.key\n $ ivxv-secret-load --service=voting@voting4.ivxv.ee tls-key /opt/ivxv-install/service_definition/voting@voting4.ivxv.ee.key\n $ ivxv-secret-load --service=mid@mid4.ivxv.ee tls-key /opt/ivxv-install/service_definition/mid@mid4.ivxv.ee.key\n $ ivxv-secret-load --service=smartid@smartid4.ivxv.ee tls-key /opt/ivxv-install/service_definition/smartid@smartid4.ivxv.ee.key\n $ ivxv-secret-load --service=sessionstatus@sessionstatus4.ivxv.ee tls-key /opt/ivxv-install/service_definition/sessionstatus@sessionstatus4.ivxv.ee.key\n $ ivxv-secret-load --service=verification@verification4.ivxv.ee tls-key /opt/ivxv-install/service_definition/verification@verification4.ivxv.ee.key\n $ ivxv-secret-load --service=votesorder@votesorder4.ivxv.ee tls-key /opt/ivxv-install/service_definition/votesorder@votesorder4.ivxv.ee.key\n $ ivxv-secret-load --service=webeid@webeid4.ivxv.ee tls-key /opt/ivxv-install/service_definition/webeid@webeid4.ivxv.ee.key\n $ ivxv-secret-load --service=choices@choices4.ivxv.ee tls-cert /opt/ivxv-install/service_definition/choices@choices4.ivxv.ee.pem\n $ ivxv-secret-load --service=voting@voting4.ivxv.ee tls-cert /opt/ivxv-install/service_definition/voting@voting4.ivxv.ee.pem\n $ ivxv-secret-load --service=mid@mid4.ivxv.ee tls-cert /opt/ivxv-install/service_definition/mid@mid4.ivxv.ee.pem\n $ ivxv-secret-load --service=smartid@smartid4.ivxv.ee tls-cert /opt/ivxv-install/service_definition/smartid@smartid4.ivxv.ee.pem\n $ ivxv-secret-load --service=sessionstatus@sessionstatus4.ivxv.ee tls-cert /opt/ivxv-install/service_definition/sessionstatus@sessionstatus4.ivxv.ee.pem\n $ ivxv-secret-load --service=verification@verification4.ivxv.ee tls-cert /opt/ivxv-install/service_definition/verification@verification4.ivxv.ee.pem\n $ ivxv-secret-load --service=votesorder@votesorder4.ivxv.ee tls-cert /opt/ivxv-install/service_definition/votesorder@votesorder4.ivxv.ee.pem\n $ ivxv-secret-load --service=webeid@webeid4.ivxv.ee tls-cert /opt/ivxv-install/service_definition/webeid@webeid4.ivxv.ee.pem\n\n #. Lisa küpsiste signeerimisvõti::\n\n $ ivxv-secret-load mid-token-key /opt/ivxv-install/service_definition/ticket.key\n\n #. Lisa hääletamisteenuse TSP räsi signeerimisvõti::\n\n $ ivxv-secret-load tsp-regkey /opt/ivxv-install/service_definition/tspreg.key\n\n #. Käivita teenused::\n\n $ ivxv-config-apply --type=election\n\nVahendusteenuse masin on krahhinud\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n.. seealso::\n\n * Kasuta käesoleva juhendi\n **Teenuste masin on krahhinud, v.a vahendus- ja x-tee teenused**\n peatükki, v.a punktid 6, 10-12.\n\n.. note::\n\n Punktis 8 tuleb ainult asendada vana vahendusteenuse **id** ja **address**:\n\n .. code-block:: yaml\n\n - id: zone1\n services:\n proxy:\n - id: proxy@proxy1.ivxv.ee\n address: proxy1:443\n\n uute vastu:\n\n .. code-block:: yaml\n\n - id: zone1\n services:\n proxy:\n - id: proxy@proxy4.ivxv.ee\n address: proxy4:443\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/recovery/recovery_storageservice.inc", "content": "Krahhi toimumise indikaatorid\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nHaldusveebiliides.\nVali **Teenused** vasakult menüüst. Kui talletusteenus on krahhinud,\nsiis tema **Seisund** on **Tõrge**.\n\nHalduskäsurealiides.\nLogi sisse **ivxv-admin** kasutajana ja päri teenuste statistikat::\n\n $ sudo su - ivxv-admin\n $ ivxv-status\n\nKui talletusteenus on krahhinud, siis tema **State** on **FAILURE**.\n\n\nKrahhist taastumise eeldused\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nKrahhi taastumiseks piisab kui teenuste CA TLS privaatvõti ja sertifikaat on\nalles, mida saab kasutada teenuse varuvõtmete ja -sertifikaatide\ngenereerimiseks. Samas, saab ka enne valimisi teenuse varuvõtmed ja\n-sertifikaadid ette genereerida.\n\nKui kõikide teenuste CA on sama, siis tasub valija- ja kontrollrakenduste\nseadistusse panna hoopis CA TLS sertifikaadi. Juhul kui CA on teenustel erinev,\nsiis peab panema kõik teenuste TLS sertifikaadid rakenduste seadistusse\nvahetult enne valimisi.\n\n\nKrahhi võimalik mõju hääletamistulemusele\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nKõik päringud mis saadetakse vastu krahhinud talletusteenuse\nmasinat ebaõnnestuvad. Valija ei saa autentida, ega hääletada.\n\n\nKrahhist taastumise sammud\n^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nKrahhi saab liigitada järgmiselt:\n\n #. Talletusteenus on terve, ning vajab ainult taaskäivitamist\n\n #. Talletusteenuse andmed (võti, sertifikaat jne) on rikutud või masina\n krahh\n\n #. Talletusteenuse lähtekoodis on viga\n\nTalletusteenus on terve, ning vajab ainult taaskäivitamist\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n.. seealso::\n\n * Kasuta :ref:`recovery-stateless` juhendis oleva\n **Teenus on terve, ning vajab ainult taaskäivitamist, v.a x-tee teenus**\n peatükki\n\nTalletusteenuse andmed (võti, sertifikaat jne) on rikutud või masina krahh\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n.. seealso::\n\n * Kasuta :ref:`recovery-stateless` juhendis oleva\n **Teenuse masin on krahhinud, v.a vahendus- ja x-tee teenused**\n peatükki\n\n\n.. note::\n\n Punktis 10 tuleb asendada vana talletusteenuse **id** ja **address** väljad:\n\n .. code-block:: yaml\n\n - id: zone1\n services:\n storage:\n - id: storage@storage1.ivxv.ee\n address: ivxv1:2379\n peeraddress: ivxv1:2380\n\n uute vastu:\n\n .. code-block:: yaml\n\n - id: zone1\n services:\n storage:\n - id: storage@storage4.ivxv.ee\n address: ivxv4:2379\n peeraddress: ivxv4:2380\n\n Punktis 12 tuleb uuendada ka talletusteenuse TLS privaatvõti::\n\n $ ivxv-secret-load --service=storage@storage4.ivxv.ee tls-key /opt/ivxv-install/service_definition/storage@storage4.ivxv.ee.key\n\n ja sertifikaat:::\n\n $ ivxv-secret-load --service=storage@storage4.ivxv.ee tls-cert /opt/ivxv-install/service_definition/storage@storage4.ivxv.ee.pem\n\nVeendu, et asendamine läks sujuvalt läbi:\n\n #. SSH logi uue koguja masinasse *root* kasutajana::\n\n $ sudo su\n\n #. Päri andmebaasi klastri seisu, näiteks, kui klaster koosneb\n *ivxv4*, *ivxv2*, *ivxv3* masinatest::\n\n $ cd /var/lib/ivxv/service/storage@storage4.ivxv.ee\n $ env ETCDCTL_API=3 etcdctl --endpoints=ivxv4:2379,ivxv2:2379,ivxv3:2379 --cert tls.pem --key tls.key --cacert ca.pem endpoint status -w table\n\nTalletusteenuse lähtekoodis on viga\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nKui talletusteenuse lähtekoodis on viga, siis seda saab\nasendada uuema versiooniga, olemasoleva andmebaasi\nklastrit rikumata.\n\n.. seealso::\n\n * Kasuta :ref:`recovery-stateless` juhendis oleva\n **Teenuse lähtekoodis on viga, v.a x-tee teenus**\n peatükki\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/seadistused.rst", "content": ".. IVXV kogumisteenuse haldusjuhend\n\nKogumisteenuse seadistused\n==========================\n\nLogimise seadistused\n--------------------\n\nKogumisteenuse logi hoitakse logi tekkimise asukohas ja dubleeritakse\nlogiserveritesse. Logide kogumiseks ja edastamiseks kasutatakse vaikimisi\n*syslog*-teenust ``rsyslog``.\n\nKogumisteenus toetab kahte liiki logiservereid, mis\nkirjeldatakse kogumisteenuse tehnilises seadistuses.\n\n#. Kogumisteenuse logikogumisteenus on kogumisteenuse sisemine teenus ja seda\n võib süsteemis olla mitu isendit.\n\n#. Tegevusmonitooringu server on kogumisteenuse jaoks\n väline teenus ja seda võib olla ainult üks isend.\n\nKogumisteenusele tehniliste seadistuse rakendamisel paigaldab haldusteenus\nlogikogumisteenuse enne teise teenuseid, et teenuste poolt toodetav logi\nsaaks võimalikult varakult ka logikogumisteenusesse kogutud.\n\n.. note::\n\n Kogumisteenuse logiteated tekivad pärast valimiste seadistuse esmakordset\n laadimist, kuna teenused käivitatakse selle seadistuse laadimise järel.\n\nLogi tootva teenuse logimise korraldus\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nLogi tootva teenuse logimise seadistuse genereerib haldusteenus vastavalt\ntehnilistele seadistustele.\n\n#. Iga teenus logib kohalikku *syslog*-teenusesse;\n\n#. Kõigi teenusmasinate *syslog*-teenused on seadistatud kogumisteenuse logi\n salvestama kohalikku failisüsteemi (:file:`/var/log/ivxv/ivxv-YYYY-MM-DD-HH.log`);\n\n#. Kõigi teenusmasinate (peale logikogumisteenuse) *syslog*-teenused on\n seadistatud edastama üle võrgu:\n\n #. Kõiki logikirjeid logikogumisteenusesse (protokoll: RELP);\n\n #. Kogumisteenuse logikirjeid tegevuslogi monitooringu serverisse\n (protokoll: RELP);\n\n\nLogikogumisteenuse korraldus\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nLogikogumisteenuse seadistusfail tuleb teenuse tarkvarapakist\n(:ref:`ivxv-logcollector.conf `).\n\n#. Logikogumisteenus võtab logikirjeid vastu RELP-protokolli kaudu;\n\n#. Kogumisteenuse logikirjeid kirjutatakse JSON-vormingus faili\n :file:`/var/log/ivxv/ivxv-YYYY-MM-DD-HH.log` (välja arvatud päringu- ja\n silumislogi);\n\n#. Kogumisteenuse päringulogi kirjutatakse rsyslogi standardvormingus faili\n :file:`/var/log/ivxv/ivxv-request-YYYY-MM-DD-HH.log`;\n\n#. Kogumisteenuse silumislogi ja teiste oluliste teenuste (haproxy, etcd,\n rsyslog, sshd) logi kirjutatakse rsyslogi standardvormingus faili\n :file:`/var/log/ivxv/ivxv-debug-YYYY-MM-DD-HH.log`.\n\n\nTalletamisteenuse seadistused\n-----------------------------\n\nHetkel ainus talletamisteenuse teostus kasutab hajusat võti-väärtus andmebaasi\n``etcd``. Korraga käivitatakse mitu ``etcd`` isendit, mis saavutavad omavahel\nkonsensuse talletatud andmete osas.\n\nTalletusteenuse sujuvaks tööks võib olla vajalik osade ``etcd`` parameetrite\nhäälestamine konkreetse evituskeskkonna jaoks. Selleks tuleb teenuse masinas\nluua fail :file:`/etc/default/ivxv` ning sinna lisada järgmistes jaotistes\nkirjeldatud read. Pärast faili loomist või selle sisu muutmist tuleb uute\nväärtuste rakendamiseks talletusteenus taaskäivitada. Parameetri puudumise\nkorral kasutatakse vaikeväärtust.\n\nSeadistuste väärtuste valimisel on abiks ``etcd`` dokumentatsioon aadressil\nhttps://coreos.com/etcd/docs/latest/tuning.html.\n\nAjaparameetrid\n^^^^^^^^^^^^^^\n\n``etcd`` klaster valib ühe liikmetest juhiks, mis koordineerib kõiki\nandmemuudatusi. Lisaks pingib juht perioodiliselt kõiki ülejäänud klastri\nliikmeid aitamaks tuvastada olukorda, kus ühendus juhiga on katkenud: kui mõni\nklastri liikmetest pole piisavalt kaua ühtegi pingi saanud, algatab see uue\njuhi valimise.\n\nSuurema võrgu- või kettalatentsuse tagajärjel võib juhi ping liialt viibida\nning põhjustada uue juhi valimise. Tõrgete korral on juhivahetus süsteemi\nloomulik osa, ent töötava süsteemi puhul tarbetu koormus. Seetõttu tuleks\nseadistada juhi pingimise tihedust ``ETCD_HEARTBEAT_INTERVAL`` ning teiste\nliikmete ooteaega ``ETCD_ELECTION_TIMEOUT`` vastavalt evituskeskkonna\nlatentsusele::\n\n ETCD_HEARTBEAT_INTERVAL=100\n ETCD_ELECTION_TIMEOUT=1000\n\nMõlemad väärtused on millisekundites ning vaikimisi vastavalt 100ms ja 1000ms.\n\n.. important::\n\n Ühes klastris peavad kõigil talletamisteenuse isenditel olema samad\n ajaparameetrid. Vastasel korral võib esineda stabiilsusprobleeme erinevate\n pingi ootuste tõttu.\n\n\nHetkvõtete parameetrid\n^^^^^^^^^^^^^^^^^^^^^^\n\n``etcd`` peab logi kõigist andmemuudatustest. Vältimaks logi liiga suureks\nkasvamist tehakse andmebaasi seisust perioodiliselt hetkvõtteid ning eelnev\nlogi kustutatakse. Kui talletamisteenus kasutab liiga palju mälu või\nkettaruumi, siis võib aidata tihedam hetkvõtete tegemine.\n\nUus hetkvõte tehakse iga ``ETCD_SNAPSHOT_COUNT`` andmemuudatuse järel, seega\nmadalam väärtus toob kaasa tihedamad hetkvõtted ning väiksema logi suuruse::\n\n ETCD_SNAPSHOT_COUNT=10000\n\nVaikimisi tehakse hetkvõte iga 10000 muudatuse järel.\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/spelling_wordlist.txt", "content": "id\nx\n\napache\ncron\netcd\nhaproxy\nrsyslog\nrsyslogi\nsshd\nsystemd\nubuntu\nzabbix\nzabbixiga\n\nivxv\nvoter\nlist\ndownload\ndb\nreset\ncollector\ninit\ncmd\nload\ncopy\nlog\nto\nlogmon\nupdate\npackages\nbackup\ncrontab\nconfig\nvalidate\napply\nsecret\nexport\nvotes\ncreate\ndata\ndirs\ndump\ngenerate\nprocessor\ninput\nchoices\nvoting\neventlog\nusers\nvoterstats\ndaemon\nhelper\n\nCSV\nASiC\nIP\nPEM\nSSH\n\n\nesmakordset\nhosti\nhostid\nhostide\nhostidel\nhostidele\nhostidest\nhostil\nhostile\nhostinimi\nhostist\nhostiv\nkrahhib\nkrahhimise\nkrahhinud\n\npingib\npingimise\n\nDiffie\nHellmani\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/utiliitide-abiteave/ivxv-admin-helper.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. Käsureautiliidi ivxv-admin-helper kasutusjuhend\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * features/steps/autodoc.py\n.. * features/autodoc-utilities.feature\n\n.. _ivxv-admin-helper:\n\nivxv-admin-helper\n`````````````````\n\n:command:`ivxv-admin-helper --help`:\n\n.. code-block:: text\n\n Usage:\n ivxv-admin-helper check-service-config \n Check service configuration\n\n ivxv-admin-helper copy-logs-to-logmon \n Copy IVXV service log files to Log Monitor\n\n ivxv-admin-helper restart-service \n \n Restart service\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/utiliitide-abiteave/ivxv-admin-sudo.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. Käsureautiliidi ivxv-admin-sudo kasutusjuhend\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * features/steps/autodoc.py\n.. * features/autodoc-utilities.feature\n\n.. _ivxv-admin-sudo:\n\nivxv-admin-sudo\n```````````````\n\n:command:`ivxv-admin-sudo --help`:\n\n.. code-block:: text\n\n Usage:\n ivxv-admin-sudo backup-ballot-box \n \n Backup ballot box (in backup service)\n\n ivxv-admin-sudo backup-log \n Backup log file (in backup service)\n\n ivxv-admin-sudo create-ssh-access \n Create management service access to account in service host\n\n ivxv-admin-sudo init-host\n Initialize service host\n\n ivxv-admin-sudo init-service \n Initialize service data directory.\n Value 'backup' is used for all backup services\n\n ivxv-admin-sudo install-pkg \n Install IVXV package with dependencies\n\n ivxv-admin-sudo prepare-ballot-box-backup \n Prepare votes backup file in voting service\n\n ivxv-admin-sudo remove-admin-root-access\n Remove management service access to service host root account\n\n ivxv-admin-sudo rsyslog-config-apply\n Apply rsyslog config file for IVXV logging\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/utiliitide-abiteave/ivxv-agent-daemon.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. Käsureautiliidi ivxv-agent-daemon kasutusjuhend\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * features/steps/autodoc.py\n.. * features/autodoc-utilities.feature\n\n.. _ivxv-agent-daemon:\n\nivxv-agent-daemon\n`````````````````\n\n:command:`ivxv-agent-daemon --help`:\n\n.. code-block:: text\n\n IVXV Collector Management Service agent daemon.\n\n Usage: ivxv-agent-daemon [--get-stats] [--register-status]\n\n Options:\n --get-stats Copy statistics from Log Monitor to\n Management Service without daemonizing.\n --register-status Register collector state (if not registered).\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/utiliitide-abiteave/ivxv-backup-crontab.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. Käsureautiliidi ivxv-backup-crontab kasutusjuhend\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * features/steps/autodoc.py\n.. * features/autodoc-utilities.feature\n\n.. _ivxv-backup-crontab:\n\nivxv-backup-crontab\n```````````````````\n\n:command:`ivxv-backup-crontab --help`:\n\n.. code-block:: text\n\n Generate crontab for IVXV backup automation.\n\n This utility must be called as editor by crontab utility:\n\n $ env VISUAL=ivxv-backup-crontab crontab -e\n\n Usage: ivxv-backup-crontab \n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/utiliitide-abiteave/ivxv-backup.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. Käsureautiliidi ivxv-backup kasutusjuhend\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * features/steps/autodoc.py\n.. * features/autodoc-utilities.feature\n\n.. _ivxv-backup:\n\nivxv-backup\n```````````\n\n:command:`ivxv-backup --help`:\n\n.. code-block:: text\n\n Backup IVXV collector data.\n\n Usage: ivxv-backup management-conf\n ivxv-backup ballot-box []\n ivxv-backup log\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/utiliitide-abiteave/ivxv-cmd-load.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. Käsureautiliidi ivxv-cmd-load kasutusjuhend\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * features/steps/autodoc.py\n.. * features/autodoc-utilities.feature\n\n.. _ivxv-cmd-load:\n\nivxv-cmd-load\n`````````````\n\n:command:`ivxv-cmd-load --help`:\n\n.. code-block:: text\n\n Load command to IVXV Collector Management Service.\n\n Usage: ivxv-cmd-load [--autoapply] [--show-version] FILE\n\n Options:\n Command type. Possible values are:\n - election: election config\n - technical: collector technical config\n - trust: trust root config\n - choices: choices list\n - districts: districts list\n - voters: voters list or voters list skipping\n - user: user account and role(s)\n --autoapply Apply command file automatically (by Agent Daemon).\n --show-version Output config file version and exit.\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/utiliitide-abiteave/ivxv-collector-init.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. Käsureautiliidi ivxv-collector-init kasutusjuhend\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * features/steps/autodoc.py\n.. * features/autodoc-utilities.feature\n\n.. _ivxv-collector-init:\n\nivxv-collector-init\n```````````````````\n\n:command:`ivxv-collector-init --help`:\n\n.. code-block:: text\n\n Initialize IVXV Collector.\n\n Usage: ivxv-collector-init [--force]\n\n Options:\n --force Don't ask user confirmation\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/utiliitide-abiteave/ivxv-config-apply.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. Käsureautiliidi ivxv-config-apply kasutusjuhend\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * features/steps/autodoc.py\n.. * features/autodoc-utilities.feature\n\n.. _ivxv-config-apply:\n\nivxv-config-apply\n`````````````````\n\n:command:`ivxv-config-apply --help`:\n\n.. code-block:: text\n\n Apply loaded IVXV Collector config to services.\n\n Usage: ivxv-config-apply [--type=] ... [] ...\n\n Options:\n --type= Config type. Possible values are:\n - election: election config file\n - technical: collector technical config file\n - choices: choices list\n - districts: districts list\n - voters: voters list\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/utiliitide-abiteave/ivxv-config-validate.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. Käsureautiliidi ivxv-config-validate kasutusjuhend\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * features/steps/autodoc.py\n.. * features/autodoc-utilities.feature\n\n.. _ivxv-config-validate:\n\nivxv-config-validate\n````````````````````\n\n:command:`ivxv-config-validate --help`:\n\n.. code-block:: text\n\n Validate IVXV collector config files.\n\n Validate single config files. Also validate voting lists consistency if\n multiple lists are provided.\n\n Usage:\n ivxv-config-validate [--plain] [--trust=]\n [--technical=] [--election=]\n [--choices=] [--districts=]\n [--voters= ...]\n\n Options:\n --plain Validate plain config file (Default: BDOC container)\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/utiliitide-abiteave/ivxv-copy-log-to-logmon.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. Käsureautiliidi ivxv-copy-log-to-logmon kasutusjuhend\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * features/steps/autodoc.py\n.. * features/autodoc-utilities.feature\n\n.. _ivxv-copy-log-to-logmon:\n\nivxv-copy-log-to-logmon\n```````````````````````\n\n:command:`ivxv-copy-log-to-logmon --help`:\n\n.. code-block:: text\n\n Copy IVXV log files from service hosts to Log Monitor.\n\n This utility transports collected IVXV log files from IVXV services\n (including Log Collector Service) to Log Monitor.\n\n Usage: ivxv-copy-log-to-logmon [--log-level=] [ ...]\n\n Options:\n Service host name.\n --log-level= Logging level [Default: INFO].\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/utiliitide-abiteave/ivxv-create-data-dirs.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. Käsureautiliidi ivxv-create-data-dirs kasutusjuhend\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * features/steps/autodoc.py\n.. * features/autodoc-utilities.feature\n\n.. _ivxv-create-data-dirs:\n\nivxv-create-data-dirs\n`````````````````````\n\n:command:`ivxv-create-data-dirs --help`:\n\n.. code-block:: text\n\n Create IVXV Collector Management Service data directories.\n\n NOTE: Directory owners and permissions are not set by this utility!\n\n Usage: ivxv-create-data-dirs\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/utiliitide-abiteave/ivxv-db-dump.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. Käsureautiliidi ivxv-db-dump kasutusjuhend\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * features/steps/autodoc.py\n.. * features/autodoc-utilities.feature\n\n.. _ivxv-db-dump:\n\nivxv-db-dump\n````````````\n\n:command:`ivxv-db-dump --help`:\n\n.. code-block:: text\n\n Dump IVXV Collector Management Service database.\n\n Usage: ivxv-db-dump [] ...\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/utiliitide-abiteave/ivxv-db-reset.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. Käsureautiliidi ivxv-db-reset kasutusjuhend\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * features/steps/autodoc.py\n.. * features/autodoc-utilities.feature\n\n.. _ivxv-db-reset:\n\nivxv-db-reset\n`````````````\n\n:command:`ivxv-db-reset --help`:\n\n.. code-block:: text\n\n Reset IVXV Collector Management Service database.\n\n Usage: ivxv-db-reset [--force]\n\n Options:\n --force Don't ask user confirmation\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/utiliitide-abiteave/ivxv-eventlog-dump.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. Käsureautiliidi ivxv-eventlog-dump kasutusjuhend\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * features/steps/autodoc.py\n.. * features/autodoc-utilities.feature\n\n.. _ivxv-eventlog-dump:\n\nivxv-eventlog-dump\n``````````````````\n\n:command:`ivxv-eventlog-dump --help`:\n\n.. code-block:: text\n\n Dump IVXV Collector Management event log in human readable format.\n\n Usage: ivxv-eventlog-dump\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/utiliitide-abiteave/ivxv-export-votes.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. Käsureautiliidi ivxv-export-votes kasutusjuhend\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * features/steps/autodoc.py\n.. * features/autodoc-utilities.feature\n\n.. _ivxv-export-votes:\n\nivxv-export-votes\n`````````````````\n\n:command:`ivxv-export-votes --help`:\n\n.. code-block:: text\n\n Export collected votes.\n\n This utility copies current ballot box from voting service to backup\n service and outputs ballot box content.\n\n Usage: ivxv-export-votes [--consolidate] \n\n Options:\n --consolidate Consolidate all collected votes\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/utiliitide-abiteave/ivxv-generate-processor-input.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. Käsureautiliidi ivxv-generate-processor-input kasutusjuhend\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * features/steps/autodoc.py\n.. * features/autodoc-utilities.feature\n\n.. _ivxv-generate-processor-input:\n\nivxv-generate-processor-input\n`````````````````````````````\n\n:command:`ivxv-generate-processor-input --help`:\n\n.. code-block:: text\n\n Generate input for processor application.\n\n This utility generates ZIP container with data files\n for processor application to validate ballot box:\n\n 1. District list;\n 2. Voter lists;\n 3. Validation key for vote registration requests;\n 4. Configuration for processor application.\n\n Usage: ivxv-generate-processor-input \n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/utiliitide-abiteave/ivxv-secret-load.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. Käsureautiliidi ivxv-secret-load kasutusjuhend\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * features/steps/autodoc.py\n.. * features/autodoc-utilities.feature\n\n.. _ivxv-secret-load:\n\nivxv-secret-load\n````````````````\n\n:command:`ivxv-secret-load --help`:\n\n.. code-block:: text\n\n Load secret data to IVXV services.\n\n This utility loads file that contains secret data to services.\n\n Supported secret types are:\n\n tls-cert - TLS certificate for service.\n\n Certificate (and key) is used for securing\n communication between services and service instances.\n\n tls-key - TLS key for service.\n\n Key is used together with service certificate.\n\n tsp-regkey - PKIX TSP registration key for voting services.\n\n Key is used for signing Time Stamp Protocol requests.\n\n Key file must be in PEM format and must be not password protected.\n\n mid-token-key - Mobile ID identity token for\n choices, mobile-id and voting services.\n\n Key file must be 32 bytes long.\n\n Usage: ivxv-secret-load [--service=] \n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/utiliitide-abiteave/ivxv-service.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. Käsureautiliidi ivxv-service kasutusjuhend\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * features/steps/autodoc.py\n.. * features/autodoc-utilities.feature\n\n.. _ivxv-service:\n\nivxv-service\n````````````\n\n:command:`ivxv-service --help`:\n\n.. code-block:: text\n\n Manage IVXV services.\n\n Usage: ivxv-service ...\n\n Options:\n Management action: start, stop, restart, ping\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/utiliitide-abiteave/ivxv-status.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. Käsureautiliidi ivxv-status kasutusjuhend\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * features/steps/autodoc.py\n.. * features/autodoc-utilities.feature\n\n.. _ivxv-status:\n\nivxv-status\n```````````\n\n:command:`ivxv-status --help`:\n\n.. code-block:: text\n\n Output IVXV Collector state.\n\n Usage: ivxv-status [--json] [--service= ...] [ ...]\n\n Options:\n --json Output full data in JSON format.\n Note: filters have no effect in JSON output.\n --service= Filter output by service ID.\n Note: This filter conflicts other section\n filters than \"smart\" or \"service\".\n Filter output by section. Possible values are:\n * collector - collector state;\n * election - election data;\n * config - versions of loaded config;\n * list - versions of loades lists;\n * service - service information;\n * ext - external service information;\n * storage - storage information;\n * smart - output only relevant data;\n * all - output all data;\n [Default: smart].\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/utiliitide-abiteave/ivxv-update-packages.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. Käsureautiliidi ivxv-update-packages kasutusjuhend\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * features/steps/autodoc.py\n.. * features/autodoc-utilities.feature\n\n.. _ivxv-update-packages:\n\nivxv-update-packages\n````````````````````\n\n:command:`ivxv-update-packages --help`:\n\n.. code-block:: text\n\n Update service packages in IVXV service hosts.\n\n This utility checks versions of software packages in service hosts\n and installs new versions if required.\n\n Usage: ivxv-update-packages [--force]\n\n Options:\n --force Update even package version does not require update\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/utiliitide-abiteave/ivxv-users-list.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. Käsureautiliidi ivxv-users-list kasutusjuhend\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * features/steps/autodoc.py\n.. * features/autodoc-utilities.feature\n\n.. _ivxv-users-list:\n\nivxv-users-list\n```````````````\n\n:command:`ivxv-users-list --help`:\n\n.. code-block:: text\n\n List IVXV Collector Management Service registered users.\n\n Usage: ivxv-users-list\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/utiliitide-abiteave/ivxv-voter-list-download.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. Käsureautiliidi ivxv-voter-list-download kasutusjuhend\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * features/steps/autodoc.py\n.. * features/autodoc-utilities.feature\n\n.. _ivxv-voter-list-download:\n\nivxv-voter-list-download\n````````````````````````\n\n:command:`ivxv-voter-list-download --help`:\n\n.. code-block:: text\n\n Download next available voter list changeset from VIS to IVXV Collector\n Management Service.\n\n Usage:\n ivxv-voter-list-download [--output-report=] [--log-level=]\n\n Options:\n --output-report= Write JSON report about HTTP request to VIS.\n --log-level= Logging level [Default: INFO].\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/utiliitide-abiteave/ivxv-voterstats.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. Käsureautiliidi ivxv-voterstats kasutusjuhend\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * features/steps/autodoc.py\n.. * features/autodoc-utilities.feature\n\n.. _ivxv-voterstats:\n\nivxv-voterstats\n```````````````\n\n:command:`ivxv-voterstats --help`:\n\n.. code-block:: text\n\n Import voter stats from voting service and export common stats to VIS.\n\n Usage: ivxv-voterstats [--action=] [--file=]\n [--service-id=] [--log-level=]\n\n Options:\n Stats type \"common\" or \"detail\".\n --action= Limit actions for \"common\" stats type.\n Possible values are \"import\" and \"export\".\n [Default: all]\n --file= Path to stats file.\n --service-id= Voting service ID [Default: random].\n --log-level= Logging level [Default: INFO].\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/utiliitide-abiteave/ivxv-voting-sessions.inc", "content": ".. Elektroonilise hääletamise infosüsteem IVXV\n\n.. Käsureautiliidi ivxv-voting-sessions kasutusjuhend\n\n.. SEE FAIL ON GENEREERITUD AUTOMAATTESTI POOLT:\n.. * features/steps/autodoc.py\n.. * features/autodoc-utilities.feature\n\n.. _ivxv-voting-sessions:\n\nivxv-voting-sessions\n````````````````````\n\n:command:`ivxv-voting-sessions --help`:\n\n.. code-block:: text\n\n Import list of voting sessions from Log Monitor.\n\n Session data is in CSV format.\n\n Usage: ivxv-voting-sessions (vote | verify) [--anonymize]\n [--log-level=]\n\n Options:\n Write sessions to file.\n --anonymize Anonymize session data\n (IP addresses and ID codes).\n --log-level= Logging level [Default: INFO].\n" }, { "path": "Documentation/et/kogumisteenuse_haldusjuhend/ylevaade.rst", "content": ".. IVXV kogumisteenuse haldusjuhend\n\nÜlevaade\n========\n\nKogumisteenuse ülevaade\n-----------------------\n\nIVXV kogumisteenus on elektroonilise\nhääletuse käigus hääletajate teenindamiseks ja häälte kogumiseks mõeldud\ntarkvara.\n\nKogumisteenus koosneb mikroteenustest ja nende haldamiseks mõeldud\nhaldusteenusest. Haldusteenuse kasutamine on käsureapõhine. Osade funktsioonide\nkasutamist on laiendatud veebipõhise liidesega, mida on kirjeldatud dokumendis\n``IVXV kogumisteenuse haldusliidese\nkasutusjuhend``.\n\n.. attention::\n\n Kogumisteenus paigaldatakse ja seadistatakse eraldi iga hääletuse\n läbiviimiseks. Ühe kogumisteenusega on korraga võimalik teenindada ainult\n ühte hääletust.\n\n\nLisamaterjalid\n--------------\n\nKäesolevas dokumendis kasutatakse mõisteid ja definitsioone, mis on kirjeldatud\ndokumendis ``IVXV-ÜK-0.95 Elektroonilise hääletamise üldraamistik ja selle\nkasutamine Eesti riiklikel valimistel``:\n\n* E-hääletamise etapid;\n\n* Süsteemi osapooled ja komponendid.\n\n\nKogumisteenuse kasutajate rollid\n--------------------------------\n\nKogumisteenuses on kasutusel järgnevad rollid:\n\n#. **Kogumisteenuse haldur** tegeleb kogumisteenuse tehnilise haldamisega;\n\n#. **Valimiste haldur** tegeleb valimiste seadistuste kehtestamisega;\n\n#. **Vaataja** pääseb ligi haldusteenuse kaudu väljastatavatele seisundi- ja\n statistikaandmetele;\n\nRollide täpsem kirjeldus asub dokumendis ``Elektroonilise hääletamise\ninfosüsteemi IVXV seadistuste koostamise juhend``.\n\n\nSüsteemi komponendid\n--------------------\n\nKogumisteenus\n^^^^^^^^^^^^^\n\n**Haldusteenus** on kogumisteenuse haldamise teenus. Haldusteenuse kaudu\njuhitakse ja jälgitakse kogumisteenust alates paigaldusest kuni mahavõtmiseni.\nVaata lähemalt lõigus :ref:`haldusteenus`.\n\n**Logikoguja** on kogumisteenuse sisemine logiserver, mis kogub ja säilitab\nkõigi kogumisteenuste alamteenuste logisid. Logikogujasse kogutud logid antakse\nvalimiste lõppedes üle korraldajale.\n\n**Sisemine varundus** on kogumisteenuse varundusteenus, mis varundab kõigi\nalamteenuste andmeid ja teeb need lihtsa liidese (failisüsteemi kataloog) kaudu\nkättesaadavaks välisele varundusteenusele.\n\n**Alamteenused** on kogumisteenuse eri lõikude eest vastutavad teenused.\n\n\n.. _tugiteenused:\n\nTugiteenused\n^^^^^^^^^^^^\n\n**Logiseire** on kogumisteenuse logide analüüsiks ja jälgimiseks mõeldud\nseireprogramm.\n\n**Tehniline seire** on kogumisteenuse tehnilise toimimise jälgimiseks mõeldud\nseireprogramm.\n\n**Väline varundus** on kogumisteenuse sisemisest varunduse poolt varundatud\nandmete säilitamiseks mõeldud väline varundusteenus.\n\n\n.. _välisteenused:\n\nVälised teenused\n^^^^^^^^^^^^^^^^\n\nVälised teenused on läbiviidavatele valimistele kehtestatud nõuetest sõltuvad\nteenused, millega kogumisteenus on võimeline liidestuma. Väliste teenuste hulka\nkuuluvad Registreerimisteenus, Ajatempliteenus, Mobiil-ID\nteenus, Smart-ID teenus, OCSP teenus vms.\n\n\nÜlevaade toimingutest\n---------------------\n\n* Hääletamiseelsel etapil:\n\n * Kirjeldatakse kogumisteenuse poolt kasutatavad :ref:`välised teenused\n `;\n\n * Valmistatakse ette kogumisteenuse :ref:`tugiteenused `;\n\n * Koostatakse kogumisteenuse seadistused (usaldusjuur, tehnilised\n seadistused ja valimiste seadistused);\n\n * Genereeritakse teenuse toimimiseks vajalikud krüptovõtmed ja\n sertifikaadid;\n\n * Valmistatakse ette kogumisteenuse käitamiseks vajalik taristu;\n\n * Paigaldatakse haldusteenus;\n\n * Rakendatakse seadistused haldusteenusele, mille põhjal haldusteenus\n paigaldab ja seadistab kogumisteenuse alamteenused.\n\n* Hääletamisetapil\n\n * Jälgitakse teenuse toimimist;\n\n * Luuakse e-valimiskastist varukoopiaid.\n\n* Töötlusetapil\n\n * Eksporditakse kogumisteenusesse kogutud andmed:\n\n #. konsolideeritud e-valimiskast kogutud häältega.\n\n* Lugemisetapil\n\n * Lugemisetapil kogumisteenust ei kasutata;\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/Makefile", "content": "include ../../common.mk\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/annotatsioon.rst", "content": ".. IVXV kogumisteenuse haldusteenuse kirjeldus\n\nAnnotatsioon\n------------\n\nKäesolev dokument sisaldab elektroonilise hääletamise infosüsteemi IVXV\nrakenduste ja kogumisteenuse seadistuste ülevaadet ja koostamise juhendit.\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/auditirakendus.rst", "content": ".. IVXV kogumisteenuse haldusteenuse kirjeldus\n\n.. _app-auditor:\n\nAuditirakendus\n==============\n\nIVXV võtmerakendus võimaldab kasutada tõestatavat dekrüpteerimist -\nkoos tulemusega väljastatakse lugemistõend e-häälte korrektse avamise\nkohta. Vältimaks häälte salajasuse rikkumist lugemistõendi kontrollil\nvõimaldab IVXV kasutada häälte miksimist, mis säilitab häälte sisu\nkuid eemaldab krüptograafiliselt seose konkreetse hääle ja selle hääle\nandnud isiku vahel.\n\nIVXV kasutab e-häälte miksimiseks tarkvara Verificatum, mis võtab\nsisendiks krüpteeritud hääled ning annab väljundiks miksitud\nkrüpteeritud hääled ja miksimistõendi.\n\nMiksimistõendi ja lugemistõendi kontroll toimub auditirakenduse tööriistadega\n*convert*, *mixer* ja *decrypt*.\n\nTöötlemisrakenduse toimingute kontroll toimub auditirakenduse tööriistaga\n*integrity*.\n\n#. Tööriist *convert* kontrollib, teisenduste korrektsust IVXV\n andmevormingute ja Verificatumi andmevormingute vahel.\n#. Tööriist *mixer* kontrollib miksimistõendi korrektsust.\n#. Tööriist *decrypt* kontrollib lugemistõendi korrektsust.\n#. Tööriist *integrity* kontrollib töötlemisrakenduse logide korrektsust.\n\nE-häälte korrektse kokkulugemise kontrolliks on vajalik ja piisav\nkasutada kõiki nelja auditirakenduse tööriista.\n\nKõigi tööriistade kasutamine eeldab allkirjastatud usaldusjuure ja\nkonkreetse tööriista seadistuste olemasolu. Alljärgnevalt kirjeldame\nkonkreetsete tööriistade seadistusi.\n\n.. _auditor-convert:\n\nE-häälte korrektse teisendamise kontroll\n----------------------------------------\n\nVerificatumi poolt koostatud miksimistõendi formaat on erinev IVXV raamistikus\nkasutatavast formaadist, samuti erinevad IVXV ning Verificatumi\nkrüpteeritud häälte formaadid. IVXV raamistikku on pakendatud\nadapterid formaaditeisendusteks, auditirakendus pakub võimalust nende\nteisenduste korrektsuse kontrolliks.\n\nTööriist *convert* kontrollib, et Verificatumi poolt väljastatud\nmiksimistõend vastab failidele IVXV raamistikus.\n\n:convert.input_bb: IVXV miksimiseelse e-valimiskasti asukoht.\n\n:convert.output_bb: IVXV miksimisjärgse e-valimiskasti asukoht.\n\n:convert.pub: IVXV avaliku võtme asukoht.\n\n:convert.protinfo: Verificatumi miksimise protokollifaili asukoht.\n\n:convert.proofdir: Verificatumi miksimistõendi asukoht.\n\n:file: `auditor.convert.yaml`:\n\n.. literalinclude:: config-examples/auditor.convert.yaml\n :language: yaml\n :linenos:\n\n.. _auditor-mix:\n\nE-häälte miksimistõendi kontroll\n--------------------------------\n\nTööriist *mixer* kontrollib Verificatumi miksimistõendi korrektsust.\n\n:mixer.protinfo: Verificatumi miksimistõendi protokollifaili asukoht.\n\n:mixer.proofdir: Verificatumi miksimistõendi asukoht.\n\n:mixer.threaded: Kasuta mitmelõimelist implementatsiooni. Vaikimisi\n väärtus on väär. Kasutatavate lõimede arv sõltub\n käsurea-argumentidest. Käsurea-argumentide puudumise\n korral valitakse optimaalne lõimede arv lähtudes\n tuvastatud tuumade arvust.\n\n:file:`auditor.mixer.yaml`:\n\n.. literalinclude:: config-examples/auditor.mixer.yaml\n :language: yaml\n :linenos:\n\n.. _auditor-decrypt:\n\nE-häälte lugemistõendi kontroll\n-------------------------------\n\nTööriist *decrypt* kontrollib lugemistõendi korrektsust.\n\n:decrypt.proofs: Kehtivate sedelite lugemistõendi asukoht.\n\n:decrypt.pub: Dekrüpteerimiseks kasutatud salajasele võtmele vastava avaliku\n võtme asukoht.\n\n:decrypt.discarded: Loend kehtetutest sedelitest.\n\n:decrypt.anon_bb: Töötlemisrakenduse või miksimisrakenduse poolt loodud\n e-valimiskast anonüümistatud häältega.\n\n:decrypt.plain_bb: Dekrüpteeritud valimiskast.\n\n:decrypt.tally: Elektroonilise hääletamise tulemus.\n\n:decrypt.candidates: Valimise valikute nimekiri allkirjastatud kujul.\n\n:decrypt.districts: Valimise ringkondade nimekiri allkirjastatud kujul.\n\n:decrypt.out: Lugemistõendi kontrolli tulemuste asukoht. Tegemist on\n kataloogiga kuhu salvestatakse sedelid, mille\n lugemistõend oli kehtetu.\n\n:decrypt.invalidity_proofs: Valikuline kehtetute sedelite lugemistõendi\n asukoht.\n\n:decrypt.abort_early: Valikuline auditirakenduse peatamine esimese läbikukutud\n kontrolli korral. Vaikimisi väärtus on tõene.\n\n:file:`auditor.decrypt.yaml`:\n\n.. literalinclude:: config-examples/auditor.decrypt.yaml\n :language: yaml\n :linenos:\n\n.. _auditor-integrity:\n\nTöötlemisrakenduse logide kontroll\n----------------------------------\n\nTööriist *integrity* kontrollib, et töötlemisrakenduse poolt väljastatud\nlogid ühendavad e-valimiskasti anonüümitud e-valimiskastiga.\n\n:integrity.ballotbox: Kogumisteenusest väljastatud e-valimiskast.\n\n:integrity.anon_bb: Töötlemisrakenduse poolt loodud e-valimiskast\n anonüümistatud häältega.\n\n:integrity.log_accepted: Vastuvõetud häälte *log1* fail.\n\n:integrity.log_squashed: Tühistatud korduvhäälte häälte *log2* fail.\n\n:integrity.log_revoked: Jaoskonnainfo põhjal tühistatud ja ennistatud häälte\n *log2* fail.\n\n:integrity.log_anonymised: Lugemisele läinud häälte *log3* fail.\n\n:integrity.bb_errors: E-valimiskasti töötlemisvigade raport.\n\n:integrity.abort_early: Valikuline auditirakenduse peatamine esimese\n läbikukutud kontrolli korral. Vaikimisi\n väärtus on tõene.\n\n:file: `auditor.integrity.yaml`:\n\n.. literalinclude:: config-examples/auditor.integrity.yaml\n :language: yaml\n :linenos:\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/DEMO_SK_TIMESTAMPING_AUTHORITY_2020.pem", "content": "-----BEGIN CERTIFICATE-----\nMIIEgzCCA2ugAwIBAgIQcGzJsYR4QLlft+S73s/WfTANBgkqhkiG9w0BAQsFADB9\nMQswCQYDVQQGEwJFRTEiMCAGA1UECgwZQVMgU2VydGlmaXRzZWVyaW1pc2tlc2t1\nczEwMC4GA1UEAwwnVEVTVCBvZiBFRSBDZXJ0aWZpY2F0aW9uIENlbnRyZSBSb290\nIENBMRgwFgYJKoZIhvcNAQkBFglwa2lAc2suZWUwHhcNMjAxMTMwMjEwMDAwWhcN\nMjUxMTMwMjEwMDAwWjB/MSwwKgYDVQQDDCNERU1PIFNLIFRJTUVTVEFNUElORyBB\nVVRIT1JJVFkgMjAyMDEXMBUGA1UEYQwOTlRSRUUtMTA3NDcwMTMxDDAKBgNVBAsM\nA1RTQTEbMBkGA1UECgwSU0sgSUQgU29sdXRpb25zIEFTMQswCQYDVQQGEwJFRTCC\nASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMz8yTHQyp8gzyPnKt/CQg+0\n7c/ogDl4V1SmyFGPT+lQaYZvXIKNNZyJlzII+vNnsok6hIRvAX5ffDZs8dkeNdo8\nQOuQ81QbLn5JJT2VuSppvpnqpFCiL+uWY0/nnwNmyiDueMkUDDJavbSPCkWwmW+a\nQZCNGd+krSTL/zNHCfOt7cAVDQAL9C4Ue7olufIZoDCTqRA00S8bGbTQPyTS8uUM\nEuwWc4JYZqEu4c24bIGhbKoCOSR60WrD6cBoZXLlqwDbWdkX5SLjJ9dTCxGW+pLp\nnAWx+KqJY3HkDiSZCT46JXOaoVzmcFx3l7eqQfqWgkzRZs9TJvqQSLQ+vgSAOREC\nAwEAAaOB/DCB+TAOBgNVHQ8BAf8EBAMCBsAwFgYDVR0lAQH/BAwwCgYIKwYBBQUH\nAwgwHQYDVR0OBBYEFJ8v3/rNs6jK0l3BxyVSixDYEOJHMB8GA1UdIwQYMBaAFLU0\nCp2lLxDF5yEOvsSxZUcbA3b+MIGOBggrBgEFBQcBAQSBgTB/MCEGCCsGAQUFBzAB\nhhVodHRwOi8vZGVtby5zay5lZS9haWEwWgYIKwYBBQUHMAKGTmh0dHBzOi8vd3d3\nLnNrLmVlL3VwbG9hZC9maWxlcy9URVNUX29mX0VFX0NlcnRpZmljYXRpb25fQ2Vu\ndHJlX1Jvb3RfQ0EuZGVyLmNydDANBgkqhkiG9w0BAQsFAAOCAQEAWWkQKAbEAT77\nn8L42gw5ql7BO1fdmUgRJRRwWL9Vo9l1c50lqieR8MUToF4wpF6D0PJUx9FDcKL0\nfbURFTRuETCgGekYmCjMbVQCiv6W38vMsIdJLBWjo2oT2AjtJ2VakwkrzzSxOSBr\nF5u0hPsAkP0VkBhmW1E0DHfm1Bti2xk5t9OsJMJqfTTl8v1HXktlnxi6WdUzLBcS\ndknFePDnSYoT3xOfOz1IlB3Ta729bgglAjVBEoWyrKX4kTjZPChxseMntXaW/pN+\nAgm3Xa9hniXdK4KamzX8d8LJ+qObxmc9TXmksbWZVup0ktfJYWIHCwZjmQukAed/\npIX8UV3N9w==\n-----END CERTIFICATE-----\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/Stats_Server_Certificate.pem", "content": "-----BEGIN CERTIFICATE-----\nMIIDbDCCAlQCCQCc0vA55LL2hDANBgkqhkiG9w0BAQsFADB4MRwwGgYDVQQDDBNp\ndnh2LWFkbWluLWRlbW9jZXJ0MSUwIwYDVQQKDBxJVlhWIGNvbGxlY3RvciBhZG1p\nbmlzdHJhdG9yMRIwEAYDVQQLDAlCREQgdGVzdHMxEDAOBgNVBAcMB1Rlc3RFbnYx\nCzAJBgNVBAYTAkVFMB4XDTE2MTIwOTIxMTMzN1oXDTI2MTIwNzIxMTMzN1oweDEc\nMBoGA1UEAwwTaXZ4di1hZG1pbi1kZW1vY2VydDElMCMGA1UECgwcSVZYViBjb2xs\nZWN0b3IgYWRtaW5pc3RyYXRvcjESMBAGA1UECwwJQkREIHRlc3RzMRAwDgYDVQQH\nDAdUZXN0RW52MQswCQYDVQQGEwJFRTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCC\nAQoCggEBANqBKqPiPEv4TE3UnO6pym8ejzsY6WaTSnqJE2mSoXBKquc/tK3eLon4\nXdkgJI6wz/x2ZkPbUUuQW1NBhHGXY7W5Yu5OQ1lIKi/UAirPoQg4qsyyXkti51+R\nHeepaKB8ll7+ALXBTDLvNbIn9NN2pPp3Lf+j0vJDvgL2aQYfcUMKe0E6Vdr0r2fY\nDShCrLssNNlkY9wHPxBPKY2MPeIQxrCSI8OAjH5vGXoU0QLUAxTh6kFowU438tGp\n3Hxa4IbaaACNhghRudxcRi8SYCRAgc3zuzOFtkU2k3aetZT60Zcpuds+ZlPQl8Sd\nRJ6ToGQ7dO/Pvwpc+D8MEmwFSgHJb7ECAwEAATANBgkqhkiG9w0BAQsFAAOCAQEA\nIaOkADkkoJo+zFhKL4EYJpnq22nCB2FHYjuHQDzyyjfHU9r2J11s66ol4tWj/k9u\nFnQq9xE19L+QI3DsDA/q8XlRlhMKYRE8Pm5zpoC99+6QS34qbOvNR65pq3WH6J3m\nhWLulbJhEjgR5KXZSIzPWxt781sx1n9BEQCWsm3aCPGQofuEOcjTlZYuHSymSF5I\n5q9FAcI0jsquZVdlWsIg3QucSlS+wZVM/1GjTWorAekXTAhrLhIrTdpvNwo+fysy\nAJXROOJbkLUlVaAJFFT+CAUl1qWd9M1CmTYc91RFrlKN/hVItIJeIRGunE5N9dl4\n2/RTqnxfqfwSZuQ3DcRKSw==\n-----END CERTIFICATE-----\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/TEST_of_EE_Certification_Centre_Root_CA.pem", "content": "-----BEGIN CERTIFICATE-----\r\nMIIEEzCCAvugAwIBAgIQc/jtqiMEFERMtVvsSsH7sjANBgkqhkiG9w0BAQUFADB9\r\nMQswCQYDVQQGEwJFRTEiMCAGA1UECgwZQVMgU2VydGlmaXRzZWVyaW1pc2tlc2t1\r\nczEwMC4GA1UEAwwnVEVTVCBvZiBFRSBDZXJ0aWZpY2F0aW9uIENlbnRyZSBSb290\r\nIENBMRgwFgYJKoZIhvcNAQkBFglwa2lAc2suZWUwIhgPMjAxMDEwMDcxMjM0NTZa\r\nGA8yMDMwMTIxNzIzNTk1OVowfTELMAkGA1UEBhMCRUUxIjAgBgNVBAoMGUFTIFNl\r\ncnRpZml0c2VlcmltaXNrZXNrdXMxMDAuBgNVBAMMJ1RFU1Qgb2YgRUUgQ2VydGlm\r\naWNhdGlvbiBDZW50cmUgUm9vdCBDQTEYMBYGCSqGSIb3DQEJARYJcGtpQHNrLmVl\r\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA1gGpqCtDmNNEHUjC8LXq\r\nxRdC1kpjDgkzOTxQynzDxw/xCjy5hhyG3xX4RPrW9Z6k5ZNTNS+xzrZgQ9m5U6uM\r\nywYpx3F3DVgbdQLd8DsLmuVOz02k/TwoRt1uP6xtV9qG0HsGvN81q3HvPR/zKtA7\r\nMmNZuwuDFQwsguKgDR2Jfk44eKmLfyzvh+Xe6Cr5+zRnsVYwMA9bgBaOZMv1TwTT\r\nVNi9H1ltK32Z+IhUX8W5f2qVP33R1wWCKapK1qTX/baXFsBJj++F8I8R6+gSyC3D\r\nkV5N/pOlWPzZYx+kHRkRe/oddURA9InJwojbnsH+zJOa2VrNKakNv2HnuYCIonzu\r\npwIDAQABo4GKMIGHMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0G\r\nA1UdDgQWBBS1NAqdpS8QxechDr7EsWVHGwN2/jBFBgNVHSUEPjA8BggrBgEFBQcD\r\nAgYIKwYBBQUHAwEGCCsGAQUFBwMDBggrBgEFBQcDBAYIKwYBBQUHAwgGCCsGAQUF\r\nBwMJMA0GCSqGSIb3DQEBBQUAA4IBAQAj72VtxIw6p5lqeNmWoQ48j8HnUBM+6mI0\r\nI+VkQr0EfQhfmQ5KFaZwnIqxWrEPaxRjYwV0xKa1AixVpFOb1j+XuVmgf7khxXTy\r\nBmd8JRLwl7teCkD1SDnU/yHmwY7MV9FbFBd+5XK4teHVvEVRsJ1oFwgcxVhyoviR\r\nSnbIPaOvk+0nxKClrlS6NW5TWZ+yG55z8OCESHaL6JcimkLFjRjSsQDWIEtDvP4S\r\ntH3vIMUPPiKdiNkGjVLSdChwkW3z+m0EvAjyD9rnGCmjeEm5diLFu7VMNVqupsbZ\r\nSfDzzBLc5+6TqgQTOG7GaZk2diMkn03iLdHGFrh8ML+mXG9SjEPI\r\n-----END CERTIFICATE-----\r\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/TEST_of_ESTEID-SK_2015.pem", "content": "-----BEGIN CERTIFICATE-----\nMIIGgzCCBWugAwIBAgIQEDb9gCZi4PdWc7IoNVIbsTANBgkqhkiG9w0BAQwFADB9\nMQswCQYDVQQGEwJFRTEiMCAGA1UECgwZQVMgU2VydGlmaXRzZWVyaW1pc2tlc2t1\nczEwMC4GA1UEAwwnVEVTVCBvZiBFRSBDZXJ0aWZpY2F0aW9uIENlbnRyZSBSb290\nIENBMRgwFgYJKoZIhvcNAQkBFglwa2lAc2suZWUwIBcNMTUxMjE4MDcxMzQ0WhgP\nMjAzMDEyMTcyMzU5NTlaMGsxCzAJBgNVBAYTAkVFMSIwIAYDVQQKDBlBUyBTZXJ0\naWZpdHNlZXJpbWlza2Vza3VzMRcwFQYDVQRhDA5OVFJFRS0xMDc0NzAxMzEfMB0G\nA1UEAwwWVEVTVCBvZiBFU1RFSUQtU0sgMjAxNTCCAiIwDQYJKoZIhvcNAQEBBQAD\nggIPADCCAgoCggIBAMTeAFvLxmAeaOsRKaf+hlkOhW+CdEilmUIKWs+qCWVq+w8E\n8PA/TohAZdUcO4KFXothmPDmfOCb0ExXcnOPCr2NndavzB39htlyYKYxkOkZi3pL\nz8bZg/HvpBoy8KIg0sYdbhVPYHf6i7fuJjDac4zN1vKdVQXA6Tv5wS/e90/ZyF95\n5vycxdNLticdozm5yCDMNgsEji6QNA1zIi3+C2YmnDXx6VyxhuC2R3q0xNkwtJ4e\nzs1RZGxWokTNPzQc3ilGhEJlVsS8vP624hUHwufQnwrKWpc3+D+plMIO0j3E+hmh\n46gIadDRweFR/dzb+CIBHRaFh0LEBjd/cDFQlBI+E8vpkhqeWp6rp1xwnhCL201M\n3E1E1Mw+51Xqj7WOfY0TzjOmQJy8WJPEwU2m44KxW1SnpeEBVkgb4XYFeQHAllc7\nJ7JDv50BoIPpecgaqn1vKR7l//wDsL0MN1tDlBhl3x7TJ/fwMnwB1E3zVZR74TUZ\nh5J49CAcFrfM4RmP/0hcDW8+4wNWMg2Qgst2qmPZmHCI/OJt5yMt0Ud5yPF8AWxV\not3TxOBGjMiM8m6WsksFsQxp5WtA0DANGXIIfydTaTV16Mg+KpYVqFKxkvFBmfVp\n6xApMaFl3dY/m56O9JHEqFpBDF+uDQIMjFJxJ4Pt7Mdk40zfL4PSw9Qco2T3AgMB\nAAGjggINMIICCTAfBgNVHSMEGDAWgBS1NAqdpS8QxechDr7EsWVHGwN2/jAdBgNV\nHQ4EFgQUScDyRDll1ZtGOw04YIOx1i0ohqYwDgYDVR0PAQH/BAQDAgEGMGYGA1Ud\nIARfMF0wMQYKKwYBBAHOHwMBATAjMCEGCCsGAQUFBwIBFhVodHRwczovL3d3dy5z\nay5lZS9DUFMwDAYKKwYBBAHOHwMBAjAMBgorBgEEAc4fAwEDMAwGCisGAQQBzh8D\nAQQwEgYDVR0TAQH/BAgwBgEB/wIBADBBBgNVHR4EOjA4oTYwBIICIiIwCocIAAAA\nAAAAAAAwIocgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAwJwYDVR0l\nBCAwHgYIKwYBBQUHAwkGCCsGAQUFBwMCBggrBgEFBQcDBDCBiQYIKwYBBQUHAQEE\nfTB7MCUGCCsGAQUFBzABhhlodHRwOi8vZGVtby5zay5lZS9jYV9vY3NwMFIGCCsG\nAQUFBzAChkZodHRwOi8vd3d3LnNrLmVlL2NlcnRzL1RFU1Rfb2ZfRUVfQ2VydGlm\naWNhdGlvbl9DZW50cmVfUm9vdF9DQS5kZXIuY3J0MEMGA1UdHwQ8MDowOKA2oDSG\nMmh0dHBzOi8vd3d3LnNrLmVlL3JlcG9zaXRvcnkvY3Jscy90ZXN0X2VlY2NyY2Eu\nY3JsMA0GCSqGSIb3DQEBDAUAA4IBAQDBOYTpbbQuoJKAmtDPpAomDd9mKZCarIPx\nAH8UXphSndMqOmIUA4oQMrLcZ6a0rMyCFR8x4NX7abc8T81cvgUAWjfNFn8+bi6+\nDgbjhYY+wZ010MHHdUo2xPajfog8cDWJPkmz+9PAdyjzhb1eYoEnm5D6o4hZQCiR\nyPnOKp7LZcpsVz1IFXsqP7M5WgHk0SqY1vs+Yhu7zWPSNYFIzNNXGoUtfKhhkHiR\nWFX/wdzr3fqeaQ3gs/PyD53YuJXRzFrktgJJoJWnHEYIhEwbai9+OeKr4L4kTkxv\nPKTyjjpLKcjUk0Y0cxg7BuzwevonyBtL72b/FVs6XsXJJqCa3W4T\n-----END CERTIFICATE-----\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/TEST_of_SK_OCSP_RESPONDER_2020.pem", "content": "-----BEGIN CERTIFICATE-----\nMIIEzjCCA7agAwIBAgIQa7w4iGoiIOtfrn0fG/hc1zANBgkqhkiG9w0BAQUFADB9\nMQswCQYDVQQGEwJFRTEiMCAGA1UECgwZQVMgU2VydGlmaXRzZWVyaW1pc2tlc2t1\nczEwMC4GA1UEAwwnVEVTVCBvZiBFRSBDZXJ0aWZpY2F0aW9uIENlbnRyZSBSb290\nIENBMRgwFgYJKoZIhvcNAQkBFglwa2lAc2suZWUwHhcNMjAxMTEzMTIzMzM1WhcN\nMjQwNjEzMTEzMzM1WjCBgzELMAkGA1UEBhMCRUUxIjAgBgNVBAoMGUFTIFNlcnRp\nZml0c2VlcmltaXNrZXNrdXMxDTALBgNVBAsMBE9DU1AxJzAlBgNVBAMMHlRFU1Qg\nb2YgU0sgT0NTUCBSRVNQT05ERVIgMjAyMDEYMBYGCSqGSIb3DQEJARYJcGtpQHNr\nLmVlMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAz6U1uMvi5P6bycik\ngOFp1QdIdt2R/x/+WbRVNLNjDTMS0t70BVl6+Z7c5jqZUNIBZ5qlr3K8v5bIv0rd\nr1H/By0wFMWsWksZnQLIsb/lU+HeuSIDY2ESs0YzvZW4AB3tDrMFOrtuImmsUxhs\nz00KcRt9o+/o0RD9v5qxhJaqj6+Pr/8fZJK67Wuiqli2vVtuStaTb5zpjA1MJtu9\nOM4jk/FaL1FaST72XPTzpMVNJR/Rk63t0wL4l4f4s3y0ZI+JPzXu3jyeH+g3ZVLb\nwB2ccwgqfDPKXoxfNtcDxjUZz16OQQp2Rp14h/n8If0jyHfiNHHCDKaSPFyyJJMg\nRrQkiwIDAQABo4IBQTCCAT0wEwYDVR0lBAwwCgYIKwYBBQUHAwkwHQYDVR0OBBYE\nFIGteMcJzpGYrEl+MRkb+QpBx6XFMIGgBgNVHSAEgZgwgZUwgZIGCisGAQQBzh8D\nAQEwgYMwWAYIKwYBBQUHAgIwTB5KAEEAaQBuAHUAbAB0ACAAdABlAHMAdABpAG0A\naQBzAGUAawBzAC4AIABPAG4AbAB5ACAAZgBvAHIAIAB0AGUAcwB0AGkAbgBnAC4w\nJwYIKwYBBQUHAgEWG2h0dHA6Ly93d3cuc2suZWUvYWphdGVtcGVsLzAfBgNVHSME\nGDAWgBS1NAqdpS8QxechDr7EsWVHGwN2/jBDBgNVHR8EPDA6MDigNqA0hjJodHRw\nczovL3d3dy5zay5lZS9yZXBvc2l0b3J5L2NybHMvdGVzdF9lZWNjcmNhLmNybDAN\nBgkqhkiG9w0BAQUFAAOCAQEAKR+ssgVTDDkGl+sLwz5OwaBMUOPEscr7DcCXmjmR\naC+KjTe8kCuXZwnMH7tMf0mDyF22USJ/o2m0MFW1k8zjH1yr1/2JghttRfi5mCvo\nMHNXVM/ST1C/6rrymaYA27RxIj201USwTQp35YvhUUIZO3Xby/60yXZyt7wCS7xA\nnH65U/0LnkT5w5DLC8EdXlH3QF600Z74fm8z54lY80IoSgIEPmFZlLe4YR822G24\nmawGRQKIbhPK2DO6sGtLZDAfee4B6TGmPcunztsYaUoc1spfCKrx5EBthieSgAp0\ndh0kMBAR/AGh7fSwl5zyASFgYmtVP4FZS6w6ETlXU7Bg3g==\n-----END CERTIFICATE-----\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/android-ios-config.json", "content": "{\n \"appConfig\": {\n \"colors\": {\n \"btn_background\": \"#F0F0F0\",\n \"btn_background_focused\": \"#CFCFCF\",\n \"btn_close_view_focused\": \"#1995B4\",\n \"btn_foreground\": \"#727272\",\n \"btn_verify_background_center\": \"#1AABE1\",\n \"btn_verify_background_end\": \"#00A1DC\",\n \"btn_verify_background_focused\": \"#1693C0\",\n \"btn_verify_background_start\": \"#30B4E5\",\n \"btn_verify_foreground\": \"#FFFFFF\",\n \"error_window\": \"#FF0000\",\n \"error_window_close_btn_focused\": \"#B60010\",\n \"error_window_foreground\": \"#FFFFFF\",\n \"error_window_shadow\": \"#770000\",\n \"frame_background\": \"#AA444444\",\n \"lbl_background\": \"#33B5E5\",\n \"lbl_close_timeout_background_center\": \"#F9D303\",\n \"lbl_close_timeout_background_end\": \"#F7C804\",\n \"lbl_close_timeout_background_start\": \"#FEEC00\",\n \"lbl_close_timeout_foreground\": \"#454444\",\n \"lbl_close_timeout_shadow\": \"#C6A002\",\n \"lbl_foreground\": \"#FFFFFF\",\n \"lbl_inner_container_background\": \"#FFFFFF\",\n \"lbl_inner_container_foreground\": \"#404040\",\n \"lbl_outer_container_background\": \"#EAEAEA\",\n \"lbl_outer_container_foreground\": \"#404040\",\n \"lbl_outer_inner_container_divider\": \"#595959\",\n \"lbl_shadow\": \"#008EC2\",\n \"loading_window_background\": \"#33B5E5\",\n \"loading_window_foreground\": \"#FFFFFF\",\n \"main_window\": \"#33B5E5\",\n \"main_window_foreground\": \"#FFFFFF\",\n \"main_window_shadow\": \"#005777\"\n },\n \"elections\": {\n \"question-1\": \"Prototüübi test\"\n },\n \"errors\": {\n \"bad_config_message\": \"Seadistuse viga\",\n \"bad_device_message\": \"Seadmel puudub kaamera, verifitseerimist ei ole võimalik läbi viia\",\n \"bad_server_response_message\": \"Tehniline viga, palun teavita valimiste korraldajat abi@valimised.ee\",\n \"bad_verification_message\": \"Valiku tuvastamine ebaõnnestus\",\n \"bad_version_message\": \"Rakenduse versioon ei ole ajakohane, palun uuenda oma rakendust\",\n \"camera_permission_required_message\": \"Rakenduse kasutamiseks peab olema kaamera kasutamine lubatud\",\n \"error_title_bad_version\": \"Rakenduse versiooni viga\",\n \"error_title_default\": \"Viga\",\n \"error_title_network\": \"Internetiühendus puudub\",\n \"get_config_message\": \"Seadistuse laadimine ebaõnnestus\",\n \"no_network_message\": \"Palun veendu, et nutiseadme internetiühendus on aktiivne\",\n \"problem_qrcode_message\": \"QR-koodi ei õnnestunud tuvastada\",\n \"send_server_request_message\": \"Serveriga ühendumine ebaõnnestus, kontrolli internetiühendust või teavita valimiste korraldajat abi@valimised.ee\"\n },\n \"params\": {\n \"close_interval\": 1000,\n \"close_timeout\": 30000,\n \"con_timeout_1\": 3000,\n \"con_timeout_2\": 15000,\n \"help_url\": \"https://www.valimised.ee/verify/help/index.html\",\n \"ocsp_service_cert\": [],\n \"public_key\": \"\",\n \"tspreg_client_cert\": \"\",\n \"tspreg_service_cert\": \"\",\n \"verification_sni\": \"verification.ivxv.valimised.ee\",\n \"verification_tls\": [\n \"\",\n \"\",\n \"\"\n ],\n \"verification_url\": [\n \"collector1:port\",\n \"collector2:port\",\n \"collector3:port\"\n ]\n },\n \"texts\": {\n \"a11y_qr_view_opened\": \"Alusta QR-koodi skaneerimist\",\n \"btn_close\": \"Sulge\",\n \"btn_more\": \"Abi\",\n \"btn_next\": \"Edasi\",\n \"btn_ok\": \"Ok\",\n \"btn_packet_data\": \"Andmeside\",\n \"btn_update\": \"Värskenda\",\n \"btn_verify\": \"Kuva minu valik\",\n \"btn_wifi\": \"Wifi\",\n \"lbl_choice\": \"Tuvastatud valik\",\n \"lbl_close_timeout\": \"Rakendus suletakse XX sekundi pärast!\",\n \"lbl_no_choice\": \"Valikut ei tehtud\",\n \"lbl_vote\": \"Hääle kontrollimine\",\n \"lbl_vote_signer\": \"E-hääle allkirjastaja: \",\n \"lbl_vote_txt\": \"Sinu QR-koodile vastav hääl on talletatud valimiste serveris\",\n \"loading\": \"Laadin...\",\n \"notification_message\": \"Kontrollimine lõpetatud\",\n \"notification_title\": \"Riigi valimisteenistus\",\n \"welcome_message\": \"Hääle kontrollimiseks suuna nutiseadme kaamera arvuti ekraanil kuvatavale QR-koodile\"\n },\n \"versions\": {\n \"android_version_code\": 42,\n \"ios_bundle_version\": \"2.1.19\"\n }\n }\n}" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/auditor.convert.yaml", "content": "convert:\n input_bb: TESTCONF-bb-4.json\n output_bb: TESTCONF-shuffled.json\n pub: TESTCONF-pub.pem\n protinfo: prot.xml\n proofdir: mixnet/\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/auditor.decrypt.yaml", "content": "decrypt:\n proofs: decout/TESTCONF-proof\n pub: initout/TESTCONF-pub.pem\n discarded: decout/TESTCONF-invalid\n anon_bb: TESTCONF-shuffled.json\n plain_bb: decout/TESTCONF.TESTQUESTION.plain\n tally: decout/TESTCONF.TESTQUESTION.tally\n candidates: TESTCONF.choices.bdoc\n districts: TESTCONF.districts.bdoc\n out: auditout\n invalidity_proofs: decout/TESTCONF-proof-invalid\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/auditor.integrity.yaml", "content": "integrity:\n ballotbox: TESTCONF.votes.zip\n anon_bb: TESTCONF-bb-4.json\n log_accepted: out-1/TESTCONF.TESTQUESTION.check.log1\n log_squashed: out-2/TESTCONF.TESTQUESTION.squash.log2\n log_revoked: out-3/TESTCONF.TESTQUESTION.revoke.log2\n log_anonymised: out-4/TESTCONF.TESTQUESTION.anonymize.log3\n bb_errors: out-1/ballotbox_errors.txt\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/auditor.mixer.yaml", "content": "mixer:\n protinfo: prot.xml\n proofdir: mixnet/\n threaded: true\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/etcd_CA.pem", "content": "-----BEGIN CERTIFICATE-----\nMIIDgDCCAmigAwIBAgIJAN8HvtqlwnNYMA0GCSqGSIb3DQEBCwUAMFQxCzAJBgNV\nBAYTAkVFMRIwEAYDVQQKDAlTQ0NFSVYgT1kxHzAdBgNVBAsMFklWWFYgVGVzdCBD\nZXJ0aWZpY2F0ZXMxEDAOBgNVBAMMB2V0Y2QgQ0EwIBcNMTcwNzI3MTIyMjIwWhgP\nMjExNzA3MDMxMjIyMjBaMFQxCzAJBgNVBAYTAkVFMRIwEAYDVQQKDAlTQ0NFSVYg\nT1kxHzAdBgNVBAsMFklWWFYgVGVzdCBDZXJ0aWZpY2F0ZXMxEDAOBgNVBAMMB2V0\nY2QgQ0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC8xktrfvOSwiKg\nsd2CfOQ2PobheaMqhbd+zHyj+Vmw0KIc+LwRoPK6FiGVmeIJXp7bN3QbbZdbpTfh\nap1xJr/wYu5JJO8DEy5i+Ea5IBGf6fZ6RTVngtbigln0FCFyRqumvD5yuZRbOnV6\nw1Roe1GmhtrrW3QTHR5OSc8FjLcw21RkjrKbc0VtLoaGTU0CB7gSLUoHgXdOb3n5\nn5pLa/N/4VjfIEqL7U4Pi9eFRl1tcKnj3+AwHp5HAHZgN937YDqXAtbWL7BwAToR\nCcW5ESm2xq6i46wg/OLhNU4bA8kfxqVCuCk/QDX3tvo4pkavC5bXMybc+3LfRfjO\nk7KKr+2XAgMBAAGjUzBRMB0GA1UdDgQWBBRWhI+0eFROcX+wY8h8jCU9SuXlHDAf\nBgNVHSMEGDAWgBRWhI+0eFROcX+wY8h8jCU9SuXlHDAPBgNVHRMBAf8EBTADAQH/\nMA0GCSqGSIb3DQEBCwUAA4IBAQBOs9gwX28/Q2dvU9zFxHxVZ0x3jv2DAjAqBGHp\nI5ZbVjoWdjxurMwid9X6CF0nwqtHZQieGfKKt3wRv7G05yKZNlWkxSBfBiQwTwSs\nMp2rj5zXDdQdkPWMD/08cDLj1jcynM8GMgUKzldcUKpWvwaL1MFaNda/pZAwd3DH\nr/s+XHnGKNafNalkCd+n/bWXUkJvVlE3Aakx2hfuNiT2WQ9rb6J7LkPhrWN4X1E4\n1a++vt53qgMYH+jvYJkiKi9mDa+XVZR7XA9tD2xLGC5l0zt7Aaz4xUG9YVxc8/sW\nwP7zi1j187I4XZ9FIhO4+dmbpy+vg4e51xvQfC9/5T5vmfWR\n-----END CERTIFICATE-----\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/example.election.yaml", "content": "# Valimiste seadistuse näide\n\nidentifier: TESTCONF\nquestions:\n - TESTQUESTION\n\nperiod:\n servicestart: 2017-01-16T08:50:00+02:00\n electionstart: 2017-01-16T09:00:00+02:00\n electionstop: 2017-01-18T19:00:00+02:00\n servicestop: 2017-01-18T19:15:00+02:00\n verificationstop: 2017-01-18T19:20:00+02:00\n\nvoting:\n ratelimitstart: 50\n ratelimitminutes: 5\n\nverification:\n count: 3\n minutes: 30\n latestonly: false\n\nvoterlist:\n key: !container rr_pub.key\n\nvis:\n url: https://vis-mock.local/vis3/\n ca:\n - |\n -----BEGIN CERTIFICATE-----\n MIIDmzCCAoOgAwIBAgIDOBFTMA0GCSqGSIb3DQEBCwUAMFcxCzAJBgNVBAYTAkVF\n MRIwEAYDVQQKDAlTQ0NFSVYgT1kxHzAdBgNVBAsMFklWWFYgVGVzdCBDZXJ0aWZp\n Y2F0ZXMxEzARBgNVBAMMClNlcnZpY2UgQ0EwIBcNMjEwNjE3MTIwNTI0WhgPMjEy\n MTA1MjQxMjA1MjRaMFsxCzAJBgNVBAYTAkVFMRIwEAYDVQQKDAlTQ0NFSVYgT1kx\n HzAdBgNVBAsMFklWWFYgVGVzdCBDZXJ0aWZpY2F0ZXMxFzAVBgNVBAMMDnZpcy1t\n b2NrLmxvY2FsMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAzZW7yXGO\n SEt4qavm/vNJj9otKf9j8runLJcmoTGR61A5As2gluRnj3z6/U8An/VsX1dUG2qL\n sJecEXUkvXBSTw2IIyfA6lJNtaov44ytRB4fKpuFx+lb00WmuRf99uC0Tpp5K0Of\n 7D5NO5dgtMXLrdpzuyJD6NP2xrp8Dio5a1TosHcQEVWJvR/dwCr02TmcQjvILOVN\n vJFr038Dg77NQKojOsag60KRrHcKc1WukgUPu4AJ2VFCmn67rCfp39tusbcndsNs\n EX7zGNghOk85CMoGWlYfnJm94oAoKUsYtpF1hinfBN/EikXZwJbsVFoSg4mo/te2\n MfwzK7E5j17JWwIDAQABo2owaDAdBgNVHQ4EFgQUI2yfomatZq3HLyL+DpqeBYO9\n /1EwHwYDVR0jBBgwFoAUbyNWl77jkIGrjVtW7Eu4+qpDXxYwDgYDVR0PAQH/BAQD\n AgOoMBYGA1UdJQEB/wQMMAoGCCsGAQUFBwMBMA0GCSqGSIb3DQEBCwUAA4IBAQCA\n RsgmPcL4NaHxQGRxPS2agw2ihLPgkmZcUJhJ0ObnmVYBjCCpYxaNd0vCWBYejChj\n Q2cblFAuKUtc+pwSC2WDPV9rRwLNOQn/PR2dzeNRP7L0UmNyPcH5pwmltAJLFQqW\n OdnlXL8ehXSLeIdzlBkqNYZCrj4Ulv4W8cLosjCrmwTZ8OW2E/GSTY7YljsPZZt0\n uI5Sxz8VtlMJsVh0HWCQ4oAawp6BOgUAGdE9PIo2UlDHyUHBSDXDuZKTGut+yv1T\n NOq+xK3YM/CRFf/ujIuc1zx+dzkM9l72VJT2BQ6+LKeS5qzduJTG/8dJJFzgNB9p\n vo7reW+FURRS+CQI633D\n -----END CERTIFICATE-----\n min: 15\n\nxroad:\n ca: !container xroadservice_ca.pem\n\nballot:\n # This group must be the one used for voter ballot encryption public key\n # generation, check documentation for all available groups to use\n encpkeygroup: RFC3526ModPGroup3072\n encpkey: !container vote_enc_pkey.pem\n\nauth:\n ticket:\n tls:\n roots:\n - !container TEST_of_EE_Certification_Centre_Root_CA.pem\n intermediates:\n - !container TEST_of_ESTEID-SK_2015.pem\n ocsp:\n url: http://demo.sk.ee/ocsp\n responders:\n - !container TEST_of_SK_OCSP_RESPONDER_2020.pem\n retry: 2\n\nidentity: pnoee\n\nage:\n method: estpic\n timezone: Europe/Tallinn\n limit: 18\n\nvote:\n bdoc:\n filecount: 4\n bdocsize: 32768 # 32 KiB\n filesize: 32768 # 32 KiB\n roots:\n - !container TEST_of_EE_Certification_Centre_Root_CA.pem\n intermediates:\n - !container TEST_of_ESTEID-SK_2015.pem\n profile: BES\n\nmid:\n url: https://tsp.demo.sk.ee/mid-api/\n relyingpartyuuid: 00000000-0000-0000-0000-000000000000\n relyingpartyname: DEMO\n language: EST\n authmessage: Mobiil-ID autentimise testimine.\n signmessage: Mobiil-ID allkirjastamise testimine.\n messageformat: GSM-7\n authchallengesize: 64\n statustimeoutms: 5000\n roots:\n - !container TEST_of_EE_Certification_Centre_Root_CA.pem\n intermediates:\n - !container TEST_of_ESTEID-SK_2015.pem\n ocsp:\n url: http://demo.sk.ee/ocsp\n responders:\n - !container TEST_of_SK_OCSP_RESPONDER_2020.pem\n\nsmartid:\n url: https://sid.demo.sk.ee/smart-id-rp/v2/\n relyingpartyuuid: 00000000-0000-0000-0000-000000000000\n relyingpartyname: DEMO\n certificatelevel: QUALIFIED\n authinteractionsorder:\n - type: verificationCodeChoice\n displayText60: authenticating\n - type: displayTextAndPIN\n displayText60: authenticating\n signinteractionsorder:\n - type: verificationCodeChoice\n displayText60: signing\n - type: displayTextAndPIN\n displayText60: signing\n authchallengesize: 64\n statustimeoutms: 5000\n roots:\n - !container TEST_of_EE_Certification_Centre_Root_CA.pem\n intermediates:\n - !container TEST_of_ESTEID-SK_2015.pem\n ocsp:\n url: http://demo.sk.ee/ocsp\n responders:\n - !container TEST_of_SK_OCSP_RESPONDER_2020.pem\n\nqualification:\n - protocol: tspreg\n conf:\n url: http://demo.sk.ee/tsa\n signers:\n - !container DEMO_SK_TIMESTAMPING_AUTHORITY_2020.pem\n delaytime: 1\n retry: 2\n - protocol: ocsp\n conf:\n url: http://demo.sk.ee/ocsp\n responders:\n - !container TEST_of_SK_OCSP_RESPONDER_2020.pem\n retry: 2\n\n# this block defines any statistics that EHS shares with any other third-party\nstats:\n # this block defines detail statistics that EHS shares with VIS,\n # you can add 'common' here if implemented, or any other kind\n detail:\n # this block defines an automation (scheduler) for detail statistics sharing\n scheduler:\n # cron is a scheduler, you can add 'systemd-timer' here if implemented,\n # only crontab syntax supported for cron: section\n cron:\n min: \"*/15\" # minutes of a hour: 00, 15, 30, 45\n hour: \"*\" # each hour\n day: \"*\" # each day\n month: \"*\" # each month\n weekday: \"*\" # each week day\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/example.technical.yaml", "content": "# Tehnilise seadistuse näide\n\ndebug: true\n\nsnidomain: inttest.ivxv.ee\n\nfilter:\n tls:\n handshaketimeout: 20\n ciphersuites:\n - TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384\n - TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384\n # Vanemate nutiseadmete tugi.\n - TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA\n - TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA\n codec:\n rwtimeout: 10\n requestsize: 16384 # 16 KiB\n logrequests: true\n\nnetwork:\n - id: default\n services:\n proxy:\n - id: proxy@proxy1.ivxv.ee\n address: proxy1.ivxv.ee:443\n mid:\n - id: mid@mid1.ivxv.ee\n address: mid1.ivxv.ee:443\n smartid:\n - id: smartid@smartid1.ivxv.ee\n address: smartid1.ivxv.ee:443\n webeid:\n - id: webeid@webeid1.ivxv.ee\n address: webeid1.ivxv.ee:443\n origin: https://ivxv1.mydomain.ivxv.ee:443 # address that client sees\n choices:\n - id: choices@choices1.ivxv.ee\n address: choices1.ivxv.ee:443\n voting:\n - id: voting@voting1.ivxv.ee\n address: voting1.ivxv.ee:443\n verification:\n - id: verification@verification1.ivxv.ee\n address: verification1.ivxv.ee:443\n sessionstatus:\n - id: sessionstatus@sessionstatus1.ivxv.ee\n address: sessionstatus1.ivxv.ee:443\n storage:\n - id: storage@storage1.ivxv.ee\n address: storage1.ivxv.ee:2379\n peeraddress: storage1.ivxv.ee:2380\n\nstatus:\n session:\n name: session\n servername: session.status.inttest.ivxv.ee\n authttl: 60 # ttl in seconds!\n choicettl: 90\n votettl: 60\n verifyttl: 60\n\nlogging:\n - address: logserver1.ivxv.ee\n port: 20514\n - address: logserver2.ivxv.ee\n port: 514\n\nstorage:\n protocol: etcd\n conf:\n ca: !container etcd_CA.pem\n conntimeout: 5\n optimeout: 10\n size: 2147483648 # bytes\n snapshotcount: 10000 # etcd revisions\n heartbeattimeout: 100 # ms\n electiontimeout: 1000 # ms\n bootstrap:\n - storage@storage1.ivxv.ee\n ordertimeout: 10\n\nbackup: [\"03:00\", \"09:00\", \"15:00\", \"21:00\"]\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/example.trust.yaml", "content": "# Usaldusjuure seadistuse näide\n\ncontainer:\n bdoc:\n filecount: 50\n bdocsize: 104857600 # 100 MiB\n filesize: 104857600 # 100 MiB\n roots:\n - !container TEST_of_EE_Certification_Centre_Root_CA.pem\n intermediates:\n - !container TEST_of_ESTEID-SK_2015.pem\n profile: TS\n ocsp:\n responders:\n - !container TEST_of_SK_OCSP_RESPONDER_2020.pem\n tsp:\n signers:\n - !container DEMO_SK_TIMESTAMPING_AUTHORITY_2020.pem\n delaytime: 1\n tsdelaytime: 60\n\nauthorizations:\n - ORAV,IVAN,30809010001\n - ROPKA,KIVIVALVUR,32608320001\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/example.voters.skip.yaml", "content": "# Valijate muudatusnimekirja nr. 15 vahelejätmise korralduse näide\n\nelection: TESTCONF\nskip_voter_list: \"https://vis-ehs-api.ria.ee/ehs-election-voters-changeset 2021-07-22T10:12:49Z\"\nchangeset: 15\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/ivxv.properties.real", "content": "ca = EE-GovCA2018.pem.crt, ESTEID2018.pem.crt, ESTEID-SK_2015.pem.crt\nocsp = SK_OCSP_RESPONDER_2011.pem.crt\ntsa = SK_TIMESTAMPING_AUTHORITY_2023.pem.crt\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/key.decrypt.yaml", "content": "decrypt:\n identifier: TESTCONF\n protocol:\n recover:\n threshold: 2\n parties: 3\n anonballotbox: TESTCONF-bb-4.json\n anonballotbox_checksum: TESTCONF-bb-4.json.sha256sum.bdoc\n candidates: TESTCONF.choices.bdoc\n districts: TESTCONF.districts.bdoc\n provable: true\n prove_invalid: true\n check_decodable: false\n out: decout\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/key.groupgen.yaml", "content": "groupgen:\n paramtype: mod\n length: 3072\n init_template: key.init.template.yaml\n random_source:\n - random_source_type: DPRNG\n random_source_path: public_seed_file\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/key.init.original.yaml", "content": "init:\n identifier: TESTCONF\n paramtype:\n mod:\n p: 5809605995369958062791915965639201402176612226902900533702900882779736177890990861472094774477339581147373410185646378328043729800750470098210924487866935059164371588168047540943981644516632755067501626434556398193186628990071248660819361205119793693985433297036118232914410171876807536457391277857011849897410207519105333355801121109356897459426271845471397952675959440793493071628394122780510124618488232602464649876850458861245784240929258426287699705312584509625419513463605155428017165714465363094021609290561084025893662561222573202082865797821865270991145082200656978177192827024538990239969175546190770645685893438011714430426409338676314743571154537142031573004276428701433036381801705308659830751190352946025482059931306571004727362479688415574702596946457770284148435989129632853918392117997472632693078113129886487399347796982772784615865232621289656944284216824611318709764535152507354116344703769998514148343807\n g: 2\n out: initout\n skiptest: true\n fastmode: true\n signaturekeylen: 3072\n signcn: SIGNATURE\n signsn: 1\n enccn: ENCRYPTION\n encsn: 2\n required_randomness: 128\n random_source:\n - random_source_type: file\n random_source_path: randomness_file\n - random_source_type: system\n - random_source_type: DPRNG\n random_source_path: seed_file\n - random_source_type: stream\n random_source_path: /dev/urandom\n - random_source_type: user\n random_source_path: user_entropy.exe\n genprotocol:\n desmedt:\n threshold: 2\n parties: 3\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/key.init.yaml", "content": "init:\n identifier: TESTCONF\n paramtype:\n mod:\n p: 58096059953699580627919159656392014021766122269029005337..\n g: 2\n out: initout\n skiptest: true\n fastmode: true\n signaturekeylen: 3072\n signcn: SIGNATURE\n signsn: 1\n enccn: ENCRYPTION\n encsn: 2\n required_randomness: 128\n random_source:\n - random_source_type: file\n random_source_path: randomness_file\n - random_source_type: system\n - random_source_type: DPRNG\n random_source_path: seed_file\n - random_source_type: stream\n random_source_path: /dev/urandom\n - random_source_type: user\n random_source_path: user_entropy.exe\n genprotocol:\n desmedt:\n threshold: 2\n parties: 3\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/key.testkey.yaml", "content": "testkey:\n identifier: TESTCONF\n out: initout\n threshold: 2\n parties: 3\n fastmode: false\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/key.util.yaml", "content": "util:\n listreaders: true\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/processor.anonymize.yaml", "content": "anonymize:\n ballotbox: out-3/TESTCONF-bb-3.json\n ballotbox_checksum: out-3/TESTCONF-bb-3.json.sha256sum.bdoc\n out: out-4\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/processor.check.yaml", "content": "check:\n ballotbox: TESTCONF.votes.zip\n ballotbox_checksum: TESTCONF.votes.zip.sha256sum.bdoc\n signed_ballot_max_size_bytes: 32768\n districts: TESTCONF.districts.bdoc\n registrationlist: TESTCONF.registration.zip\n registrationlist_checksum: TESTCONF.registration.zip.sha256sum.bdoc\n tskey: TESTCONF.ts.key\n vlkey: TESTCONF.voterfile.pub.key\n voterlists_dir: TESTCONF.voterlists\n voterlists:\n - path: TESTCONF.voters_1\n signature: TESTCONF.voters_1.signature\n - path: TESTCONF.voters_2\n signature: TESTCONF.voters_2.signature\n election_start: 2017-05-01T12:00:00+03:00\n out: out-1\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/processor.checkAndSquash.yaml", "content": "checkAndSquash:\n ballotbox: TESTCONF.votes.zip\n ballotbox_checksum: TESTCONF.votes.zip.sha256sum.bdoc\n signed_ballot_max_size_bytes: 32768\n districts: TESTCONF.districts.bdoc\n registrationlist: TESTCONF.registration.zip\n registrationlist_checksum: TESTCONF.registration.zip.sha256sum.bdoc\n tskey: TESTCONF.ts.key\n vlkey: TESTCONF.voterfile.pub.key\n voterlists_dir: TESTCONF.voterlists\n voterlists:\n - path: TESTCONF.voters_1\n signature: TESTCONF.voters_1.signature\n - path: TESTCONF.voters_2\n signature: TESTCONF.voters_2.signature\n enckey: TESTCONF-enc.pub.key\n election_start: 2017-05-01T12:00:00+03:00\n out: out-2\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/processor.export.yaml", "content": "export:\n ballotbox: TESTCONF.votes.zip\n ballotbox_checksum: TESTCONF.votes.zip.sha256sum.bdoc\n signed_ballot_max_size_bytes: 32768\n out: out-export\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/processor.revoke.yaml", "content": "revoke:\n ballotbox: out-2/TESTCONF-bb-2.json\n ballotbox_checksum: out-2/TESTCONF-bb-2.json.sha256sum.bdoc\n districts: TESTCONF.districts.bdoc\n revocationlists:\n - TESTCONF.revoke_1.bdoc\n - TESTCONF.revoke_2.bdoc\n out: out-3\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/processor.revokeAndAnonymize.yaml", "content": "revokeAndAnonymize:\n ballotbox: out-2/TESTCONF-bb-2.json\n ballotbox_checksum: out-2/TESTCONF-bb-2.json.sha256sum.bdoc\n districts: TESTCONF.districts.bdoc\n revocationlists:\n - TESTCONF.revoke_1.bdoc\n - TESTCONF.revoke_2.bdoc\n out: out-4\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/processor.squash.yaml", "content": "squash:\n ballotbox: out-1/TESTCONF-bb-1.json\n ballotbox_checksum: out-1/TESTCONF-bb-1.json.sha256sum.bdoc\n districts: TESTCONF.districts.bdoc\n enckey: TESTCONF-enc.pub.key\n out: out-2\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/processor.stats.yaml", "content": "stats:\n ballotbox: TESTCONF.votes.zip\n signed_ballot_max_size_bytes: 32768\n election_day: 2018-11-11\n period_start: 2018-11-01T10:00:00+03:00\n period_end: 2018-11-07T22:00:00+03:00\n districts: TESTCONF.districts.bdoc\n vlkey: TESTCONF.voterfile.pub.key\n voterlists:\n - path: TESTCONF.voters_1\n signature: TESTCONF.voters_1.signature\n - path: TESTCONF.voters_2\n signature: TESTCONF.voters_2.signature\n out: out-stats\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/processor.statsdiff.yaml", "content": "statsdiff:\n compare: out-stats/TESTCONF-stats.json\n to: TESTCONF-voting-stats.json\n diff: TESTCONF-stats-diff.json\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/processor.verify.yaml", "content": "verify:\n file: processor.yaml.bdoc\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/rnd.groupgen.yaml", "content": "groupgen:\n\n [...]\n\n random_source:\n - random_source_type: DPRNG\n random_source_path: public_seed_file\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/rnd.init.yaml", "content": "init:\n\n [...]\n\n required_randomness: 128\n random_source:\n - random_source_type: system\n - random_source_type: user\n random_source_path: server.exe\n\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/rr_pub.key", "content": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAxOJOUqfOxVHHGplNmSSt\nLYXfpjyRlJrONLu74b85rBjTmr1bBwLRz+LemN9QWJJySKMaB0kShUhYoBDCAnpr\ngChxvnMzh2fsX9eK//dBWj+xbWFtzr2rrKLR8BnbB8SFDH18p1c4Pk3fDZGTME0D\ngmceUhAS83kZb/sZeRBf3ODDf9eWgFZupOOLGMIzwUYlMbYGGDV8dR8tNHKyNgj7\nyWWPlCrqh1vrBqYSDcTZv0B5Rd+aaBwwvTFLc3cqeE2Xy59Rh7bJvTf8IHlPBPRY\neqDqGvpQ/1rQcuqzfqqB6zc1qHUu09nViLc6qJJ3jQ5jQjJ1OREz9u05whEpD8Y1\n9QIDAQAB\n-----END PUBLIC KEY-----\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/vote_enc_pkey.pem", "content": "-----BEGIN PUBLIC KEY-----\nMIIDMzCCAaEGCSsGAQQBl1UCATCCAZICggGBAP//////////yQ/aoiFowjTExmKLgNwc0SkCTgiK\r\nZ8x0Agu+pjsTmyJRSgh5jjQE3e+VGbPNOkMbMCsKbfJfFDdP4TVtbVHCReSFtXZiXn7G9ExC6aY3\r\n7WsL/1y29Aa37e44a/taiZ+lrp8kEXxLH+ZJKGZR7ORbPcIAfLihY78FmNpINhxV05ppFj+o/STP\r\nX4NlXSPco62WHGLzViCFUrue1SkHcJaWbWcMNU5KvJgE8XRsCMoYIXwykF5GLjbOO+OedywYDoYD\r\nmyeDouwHoo+1xV3wb0xSyd4ry/aVWBcYOZVJfOqVauUV0iYYmPoFEBVyjlqKqsQtrTMXDQRQejOo\r\nVSGr3xy6ZOz7hQRY2+8KiupxV10GDH2zlw+FpuHkx6v1rozbCTPXHoyU4EolYZ3O49ImGtLua/Ev\r\n+gbZighk2HYCcz7IamRSHysYF3sgDLvhF1d6YV1sdwmIwLrZRuII4k+gdOWrMUPbW/zg/RCOS4LR\r\nIKk60sr//////////wIBAhsISEEtU0VUVVADggGKADCCAYUCggGBANr8jgmDq2SRdr85JlmKb+J4\r\nOuqinXnSyJ/p/S0qqyde8VCzaBe2G7xj/l0zSVf1dj6JJeGzaN2G9DbrchOrix33ctjKNjnsp/kN\r\nRro3xr/hPcnX3xdnywSvJIR8FEx2p1b3EU2AMEnmY8YDJeLYb7M/YqtLAfWd5qFCYsnzapMIgWj6\r\nWfKvx8+h8STzI2Kc3xtHTW6KQrSRdb8yIJUIv5Tt+3Lgyng50twN4n1tynLjkpa5UG0sMIQWHjZV\r\neEUWasqOUKfWugUEswUe7vi8AAL6q8EVxeh0C1VCwbkTdV/GwlI5zuvXdXZtFn9IOMgp3cHZjYNQ\r\neEBFCVGzwzoBr9S3b75A7WAkGV596B7jHTJuBP02nJw4kU+TDr7tpVM2WK4tcZKrW3YNhOBofAt7\r\ne1F2U7gyvwEECkEIc8PnYmh5twwUQv+AF2ABJOnoDR3cBbzqzyBzNSwnyu6kdegyXk8tBJLQ6ddu\r\nGZ6R0YR8V4xT7bCMVDMIM0fi7EmIkicJlQ==\n-----END PUBLIC KEY-----" }, { "path": "Documentation/et/seadistuste_koostejuhend/config-examples/xroadservice_ca.pem", "content": "-----BEGIN CERTIFICATE-----\nMIIDfzCCAmegAwIBAgIUdYaa1OjZYFHPG7Ku7/Res9nou2AwDQYJKoZIhvcNAQEL\nBQAwTzELMAkGA1UEBhMCRUUxDjAMBgNVBAgMBVRhcnR1MQ8wDQYDVQQKDAZTQ0NF\nSVYxHzAdBgNVBAMMFnhzZXJ2aWNlLmRldmVsLml2eHYuZWUwHhcNMjIxMTMwMTY0\nOTE2WhcNMjMxMTMwMTY0OTE2WjBPMQswCQYDVQQGEwJFRTEOMAwGA1UECAwFVGFy\ndHUxDzANBgNVBAoMBlNDQ0VJVjEfMB0GA1UEAwwWeHNlcnZpY2UuZGV2ZWwuaXZ4\ndi5lZTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMO3JO230yexwypu\nYHfBUgGiTvXTIBScpP1HwiLvBSr9FylD+iaZ890TpGLGMSH83FWgznu4NJmbqhHF\ndlrZICnivng9C7w+/egE0coqExRuR0ECWSLXAkfNVQ82YKPedhdZ3gw88YByFwvy\nEhjD17Fiv5CHZ3Iu3Fa4Lb0U95/0AI45GGgLA2DWB914Lqloc28lyCXb2cQ3OUoM\nCZkjGmsC9BLSXbsiqhU2TqQ1R1vh9/ru4cYR37JtWrU/H7tGwNB/8/AFQ161zZOz\nDXIBv5wEmZ4Rco+pXiQY5Tp3wucagwGdYFFqzxPeiPxRa56Qk5F7zBQyifEZ/ypK\nMCSRO9UCAwEAAaNTMFEwHQYDVR0OBBYEFLdlusaUnlQmzLPFo+fLNewQcPzwMB8G\nA1UdIwQYMBaAFLdlusaUnlQmzLPFo+fLNewQcPzwMA8GA1UdEwEB/wQFMAMBAf8w\nDQYJKoZIhvcNAQELBQADggEBAKTbKmS8Wy5vSiaqlEo+Cs6bl1/RMRjzjc7k51Jk\n0l1uvPBEA2/3ETZAkErqpApfwOD+CGNLPAgoLMH7dSpzyb7Z7i6bjZUcH8CeKT/D\nXZNHun2eBIuEP+sRXdzs+UAwL5Axj5ncemNEjfHLgZaKA4cr/QNkrdxViqzUbsFY\nACjTr5UhqSLZpjRRmT7UNtGB5wdk+F76DIEdjGCAWzpufPTwPDemx301P4qg4R1m\nnS0ErClDR+AiQLTkLB/uzCQmWMhgq/++boyw8Ny2A8I/OphEghsl//NYBlQ+Uz2K\nhtQmzR3L3Q0NE+9vXh8PFuFLv1qtyOpuhEn0/HuU/NzGMcU=\n-----END CERTIFICATE-----\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/genparam.py", "content": "#!/usr/bin/env sage\n\nfrom sage.all import *\n\nn = 3072\np_found = False\nc = 0\n\nwhile not(p_found):\n if (Mod(c,10000) == 0):\n print(\"c is: \", c)\n p = 2**n - 2**(n-64) - 1 + 2**64*(floor(2**(n-130)*pi.n(prec=10000))+c)\n if is_pseudoprime(p):\n print(p, \" is prime\")\n q = (p-1)/2\n if is_pseudoprime(q):\n print(p, \" is safe prime\")\n p_found = True\n c = c + 1\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/index.rst", "content": ".. IVXV seadistuste koostamise juhend\n\nIVXV seadistuste koostamise juhend\n==========================================================================\n\n.. raw:: html\n\n

\n NB!\n See on HTML-versioon dokumendist.\n Tellijale antakse üle PDF-versioon.\n

\n\n.. toctree::\n :maxdepth: 2\n :numbered:\n\n annotatsioon\n ylevaade\n rakendused\n votmerakendus\n tootlemisrakendus\n auditirakendus\n kogumisteenus\n valijarakendus\n kontrollrakendus\n mixnet\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/kogumisteenus.rst", "content": ".. IVXV kogumisteenuse haldusteenuse kirjeldus\n\n.. _kogumisteenus:\n\nKogumisteenus\n=============\n\n.. include:: kt-ylevaade.inc\n.. include:: kt-usaldusjuur.inc\n.. include:: kt-tehniline.inc\n.. include:: kt-valimised.inc\n.. include:: kt-valijate-nimekirja-vahelejätmine.inc\n.. include:: kt-volitused.inc\n.. include:: kt-krypto.inc\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/kontrollrakendus.rst", "content": ".. IVXV kogumisteenuse haldusteenuse kirjeldus\n\n.. _kontroll:\n\nKontrollrakenduse seadistamine\n==============================\n\nKontrollrakenduste seadistus on JSON formaadis.\n\nReaalne sisu võib kahel seadistusel olla samasugune ka siis kui\nvõimalike erinevuste tekkimise jaoks kasutatakse ennetavalt erinevaid\nURLe. Varasemalt on erinevate URLide kasutamist õigustanud nt. iOS\nrakenduste pikem tarnetsükkel, mis nõuab testseadistuste\navalikustamist.\n\nSeadistus koosneb viiest peamisest rühmast\n\n* :token:`versions` - Rakenduse nõutud versioon\n* :token:`texts` - Kasutajaliideses kasutatavad tekstid\n* :token:`errors` - Kasutajaliideses kasutatavad veateated\n* :token:`colors` - Kasutajaliidese värvide koodid\n* :token:`params` - Rakenduse tööks vajalikud parameetrid\n* :token:`elections` - Igale küsimuse identifikaatorile vastav tekst\n kasutajaliideses\n\nKõiki seadistatavaid väärtusi näeb näidisseadistusest. Kõik väärtused\non kohustuslikud.\n\nVersioonide seadistamine\n------------------------\n\nKontrollrakenduse versioon peab olema suurem või võrdne seadistuses määratud\nversiooniga. Versioonid kuuluvad rühma :token:`versions`:\n\n* :token:`android_version_code` - Android-rakenduse minimaalne versioonikood.\n Väärtus peab olema positiivne JSON täisarv.\n* :token:`ios_bundle_version` - iOS-rakenduse minimaalne versioonisõne. Väärtus\n peab olema JSON sõne, mis koosneb punktidega eraldatud positiivsetest\n täisarvudest.\n\nParameetrite seadistamine\n-------------------------\n\nRakenduse tööks vajalikud parameetrid kuuluvad rühma :token:`params`:\n\n* :token:`verification_url` - Nimekiri kogumisteenuse hostinimedest\n või IP-aadressidest koos pordiga. Järjekord pole oluline. Väärtus\n peab olema JSON loend ka ühe URLi puhul.\n* :token:`verification_tls` - Nimekiri kogumisteenuse TLS\n sertifikaatidest PEM vormingus. Järjekord pole oluline. Väärtus peab\n olema JSON loend ka ühe sertifikaadi puhul.\n* :token:`help_url` - Abiinfo vaate URL\n* :token:`close_timeout` - Ajaaken, mil on kasutajal võimalik oma\n valikut näha enne rakenduse sulgumist. Millisekundites.\n* :token:`close_interval` - Intervall, millega uuendatakse\n :token:`close_timeout` väärtust kasutajaliideses. Millisekundites.\n* :token:`con_timeout_1` - Kogumisteenusega ühenduse saamise esimese\n katse ajapiirang. Millisekundites.\n* :token:`con_timeout_2` - Kui esimese ringiga ei saadud ühendust\n ühegi kogumisteenuse instantsiga, proovitakse uuesti selle\n ajapiiranguga. Millisekundites.\n* :token:`public_key` - Valimiste avalik võti, millega krüpteeritakse\n valijate hääli. PEM vormingus.\n* :token:`tspreg_service_cert` - Ajatembeldusteenuse sertifikaat PEM\n vormingus.\n* :token:`ocsp_service_cert` - OCSP-teenuse sertifikaadid PEM\n vormingus. Järjekord pole oluline. Väärtus peab olema JSON loend ka\n ühe väärtuse puhul. Kui väli on tühi, siis tuvastatakse OCSP\n responderi sertifikaat automaatselt.\n* :token:`tspreg_client_cert` - Kogumisteenuse sertifikaat\n registreerimispäringute tegemiseks PEM vormingus.\n\nTekstide seadistamine\n---------------------\n\nKasutajaliideses kasutatavad tekstid kuuluvad rühma :token:`texts`. Järgmised\ntekstid on parametriseeritavad:\n\n* :token:`lbl_close_timeout` - Kontrollrakenduse sulgemisteade koos\n loenduriga. Tekst peab sisaldama märgendit XX, mis asendatakse automaatselt\n rakenduse sulgemiseni jäänud ajaga sekundites.\n\nNäide\n-----\n\n.. literalinclude:: config-examples/android-ios-config.json\n :language: json\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/kt-krypto.inc", "content": ".. IVXV seadistuste koostamise juhend\n\n.. _kt-krypto:\n\nKogumisteenuse krüptovõtmed\n---------------------------\n\nKogumisteenuse andmevahetuse turvamiseks on tarvis luua komplekt\nkrüptograafilisi võtmeid. Komplekti koosseis sõltub kogumisteenuse tehnilistest\nseadistustest.\n\n#. Teenuse krüptovõti ja TLS-sertifikaat - kasutatakse teenuste omavahelise\n suhtluse turvamiseks kõigi teenuste puhul peale vahendusteenuse;\n\n#. Hääletamisteenuse ajatemplipäringute signeerimisvõti - kasutatakse\n ajatemplipäringute signeerimiseks juhul, kui ajatempliteenus on\n registreerimisteenuseks;\n\n#. Mobiil-ID/Smart-ID/Web eID tugiteenuse jagatud krüptimissaladus – kasutatakse sümmeetrilise\n AES-256 krüptimise jaoks. Krüptimissaladusega krüptib Mobiil-ID tugiteenus\n hääletajale väljastatava identsustõendi, mille abil hääletaja enda\n identiteeti teistele teenustele tõendab.\n\n\n\nTeenuse krüptovõtme ja TLS-sertifikaadi genereerimine\n*****************************************************\n\nTeenuse krüptovõti ja TLS-sertifikaat genereeritakse kõigile teenustele peale\nvahendusteenuse. Kõikide teenuste sertifikaadid peavad olema välja antud sama\nsertifitseerimiskeskuse (CA – *Certificate Authority*) poolt.\n\n\nCA sertifikaadi genereerimine\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nSertifitseerimiskeskuse krüptovõtme ja sertifikaadi genereerimine toimub\njärgneva käsuga:\n\n.. code-block:: shell-session\n\n $ openssl req -newkey ec -pkeyopt ec_paramgen_curve:P-256 -x509 -nodes\n -days 365 -out ca.pem -keyout ca.key -utf8\n -subj \"/C=EE/O=Example/OU=IVXV Test Certificates/CN=Service CA\"\n\nKäsu väljundiks on failid :file:`ca.key` (võti) ja :file:`ca.pem` (sertifikaat).\n\n\nTeenuse isendi krüptovõtme ja TLS-sertifikaadi genereerimine\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nTeenuse isendi krüptovõtme ja sertifikaadipäringu genereerimine toimub järgneva\nkäsuga:\n\n.. code-block:: shell-session\n\n $ openssl req -newkey ec -pkeyopt ec_paramgen_curve:P-256 -nodes\n -out -tls.csr -keyout -tls.key -utf8\n -subj \"/C=EE/O=Example/OU=IVXV Test Certificates/CN=\"\n\nKäsu väljundiks on failid :file:`-tls.key` (võti) ja\n:file:`-tls.csr` (sertifikaadipäring).\n\n.. attention::\n\n Talletusteenuse puhul peab sertifikaadipäringus olema CN väärtuseks teenuse\n identifikaatori asemel hostinimi: erinevalt teistest teenustest ei kasutata\n talletusteenuse puhul alternatiivset TLS nime.\n\nTeenuse isendi TLS-sertifikaadi genereerimine toimub järgneva käsuga:\n\n.. code-block:: shell-session\n\n $ openssl x509 -req -days 365 -CA ca.pem -CAkey ca.key -set_serial 1\n -extfile service-cert-openssl.cnf -extensions ext_\n -in -tls.csr -out -tls.pem\n\nKäsu väljundiks on fail :file:`-tls.pem`.\n\nSertifikaadi genereerimiseks peab failisüsteemis olema seadistusfail\n:file:`service-cert-openssl.cnf`.\n\n.. literalinclude:: ../../../tests/testdata/testca/service/service-cert-openssl.cnf\n :caption: Fail ``service-cert-openssl.cnf``\n :language: ini\n\n\nHääletamisteenuse ajatemplipäringute signeerimisvõtme ja sertifikaadi genereerimine\n***********************************************************************************\n\nHääletamisteenuse registreerimispäringute tegemise võti genereeritakse\njärgneva käsuga:\n\n.. code-block:: shell-session\n\n $ openssl genrsa -out tspreg.key 2048\n\nKäsu väljundiks on fail :file:`tspreg.key`.\n\nHääletamisteenuse registreerimispäringute tegemise võtme sertifikaat\ngenereeritakse järgneva käsuga:\n\n.. code-block:: shell-session\n\n $ openssl req -x509 -nodes -days 365 -out tspreg.pem -key tspreg.key -utf8\n -subj \"/C=EE/O=Example/OU=IVXV Test Certificates/CN=Collector Registration\"\n\nKäsu väljundiks on fail :file:`tspreg.pem`.\n\n.. note::\n\n Hääletamisteenuse ajatemplipäringute signeerimisvõti on vaja genereerida\n vaid juhul, kui ajatempliteenust kasutatakse registreerimisteenuseks.\n\n\nMobiil-ID/Smart-ID/Web eID tugiteenusele jagatud krüptimissaladuse genereerimine\n********************************************************************************\n\nJagatud krüptimissaladus genereeritakse järgneva käsuga:\n\n.. code-block:: shell-session\n\n $ openssl rand -out mobid-shared-secret.key 32\n\nKäsu väljundiks on 32 baidi suurune fail :file:`mobid-shared-secret.key`, mida\nMobiil-ID, Smart-ID ja Web eID teenus hakkab kasutama sümmeetrilise AES-256 krüptimise\njaoks.\n\n.. note::\n\n Mobiil-ID/Smart-ID/Web eID tugiteenuse jagatud krüptimissaladus on vaja genereerida vaid\n juhul, kui Mobiil-ID, Smart-ID või Web eID tugiteenus on kasutusel.\n\n.. vim:syntax=rst:\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/kt-tehniline.inc", "content": ".. IVXV seadistuste koostamise juhend\n\n.. _kt-technical:\n\nKogumisteenuse tehnilise seadistuse koostamine\n----------------------------------------------\n\nTehniline seadistus määrab kogumisteenuse tehnilised parameetrid. Sama tehnilist\nseadistust peaks olema võimalik kasutada erinevate valimiste seadistustega [#]_.\n\n.. [#] Aga mitte samaaegselt: kogumisteenus toetab ainult ühte valimist.\n\nTehnilise seadistuse koostab kogumisteenuse osutaja.\n\nSeadistusfaili nimi peab alati lõppema stringiga :file:`technical.yaml`.\nFailinime võimalik eesliide peab alati lõppema punktiga.\n\n:debug:\n Tõeväärtus, kas logidesse kirjutatakse silumisteateid.\n\n:snidomain:\n Kohustuslik väli.\n Domeen, mida kasutatakse teenuste SNI väärtuse seadistamiseks.\n Varasemalt on kasutusel olnud väärtus `ivxv.invalid` võib kasutada ka\n reaalseid domeene, mille nimehaldus on korraldaja kontrolli all nagu nt.\n `ivxv.ee`\n\n----\n\n:filter:\n Kohustuslik väli.\n Alamblokk, mis sisaldab ühenduste filtrite seadistusi.\n\n:filter.tls:\n Kohustuslik väli.\n Alamblokk, mis sisaldab ühenduste TLS-filtri seadistusi.\n\n:filter.tls.handshaketimeout:\n Kohustuslik väli.\n Maksimaalne aeg sekundites TLS-kätluse läbiviimiseks.\n\n:filter.tls.ciphersuites:\n Kohustuslik väli.\n TLS-protokolli versioonis 1.2 rakendamiseks lubatud šifrikomplektid.\n Hetkel toetatud valikud on::\n\n TLS_RSA_WITH_AES_128_CBC_SHA\n TLS_RSA_WITH_AES_256_CBC_SHA\n TLS_RSA_WITH_AES_128_GCM_SHA256\n TLS_RSA_WITH_AES_256_GCM_SHA384\n TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA\n TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA\n TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA\n TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA\n TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256\n TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256\n TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384\n TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384\n\n Kui TLS-kätluse käigus lepitakse kokku TLS-protokolli versioonis 1.3,\n siis šifrikomplekti seadistada ei saa ning kõik serveri poolt toetatud\n turvalised šifrid on lubatud. Hetkel on nendeks::\n\n TLS_AES_128_GCM_SHA256\n TLS_AES_256_GCM_SHA384\n TLS_CHACHA20_POLY1305_SHA256\n\n:filter.codec:\n Kohustuslik väli.\n Alamblokk, mis sisaldab ühenduste koodekfiltri seadistusi.\n\n:filter.codec.rwtimeout:\n Kohustuslik väli.\n Maksimaalne aeg sekundites valijalt tervikliku päringu lugemiseks.\n Maksimaalne aeg sekundites valijale tervikliku päringu kirjutamiseks.\n\n:filter.codec.requestsize:\n Päringu maksimaalne suurus baitides. Välja puudumise või väärtuse 0\n korral päringu suurust ei piirata.\n\n:filter.codec.logrequests:\n Tõeväärtus, kas logidesse kirjutatakse kõik sissetulnud päringud\n algkujul. Päringu logi talletatakse tavalogist eraldi.\n\n----\n\n:network:\n Kohustuslik väli.\n Loetelu kogumisteenuse võrgusegmentidest.\n\n Kõik kogumisteenuse võrgusegmentide parameetrid määrab kogumisteenuse osutaja.\n\n:network.*.id:\n Kohustuslik väli.\n Võrgusegmendi identifikaator.\n\n:network.*.services:\n Kohustuslik väli.\n Alamblokk, mis sisaldab kogumisteenuse selle võrgusegmendi\n mikroteenuste seadistust.\n\n .. todo:: Kuigi kõik selle bloki parameetrid määrab Koguja, kas\n Korraldaja peaks vähemalt vahendusteenuste väliseid aadresse\n kinnitama, kuna need on otspunktid, kuhu valija- ja\n kontrollrakendus peavad ühendama hakkama?\n\n:network.*.services.proxy:\n Loetelu, mis sisaldab vahendusteenuste isendite seadistust.\n\n:network.*.services.mid:\n Loetelu, mis sisaldab Mobiil-ID toeteenuste isendite seadistust.\n\n:network.*.services.smartid:\n Loetelu, mis sisaldab Smart-ID toeteenuste isendite seadistust.\n\n:network.*.services.webeid:\n Loetelu, mis sisaldab Web eID toeteenuste isendite seadistust.\n\n:network.*.services.sessionstatus:\n Loetelu, mis sisaldab Session status toeteenuste isendite seadistust.\n\n:network.*.services.choices:\n Loetelu, mis sisaldab nimekirjateenuste isendite seadistust.\n\n:network.*.services.voting:\n Loetelu, mis sisaldab hääletamisteenuste isendite seadistust.\n\n:network.*.services.verification:\n Loetelu, mis sisaldab kontrollteenuste isendite seadistust.\n\n:network.*.services.storage:\n Loetelu, mis sisaldab talletusteenuste isendite seadistust.\n\n:network.*.services.log:\n Loetelu, mis sisaldab logikogumisteenuste isendite seadistust.\n\n:network.*.services.backup:\n Varundusteenuse isendi seadistus.\n\n:network.*.services.*.id:\n Kohustuslik väli.\n Mikroteenuse isendi identifikaator.\n\n:network.*.services.*.address:\n Kohustuslik väli.\n Mikroteenuse isendi võrguaadress ja -port.\n\n .. todo:: Sama parameetrit kasutatakse kirjeldamaks seda, millisel\n aadressil teenus peab kuulama hakkama ning milliselt aadressilt\n saavad haldusteenus ja vahendusteenus teenusele ligi. Kui\n sisemine ja välimine aadress hakkavad erinema, siis tuleb see\n parameeter lüüa kaheks.\n\n:network.*.services.*.peeraddress:\n Mikroteenuse isenditevahelise suhtluse võrguaadress ja -port.\n Kasutatakse ainult juhul, kui sama teenust pakkuvad isendid peavad\n omavahel suhtlema (nt talletusteenus).\n\n .. todo:: Sama parameetrit kasutatakse kirjeldamaks seda, millisel\n aadressil teenus peab kuulama hakkama ning milliselt aadressilt\n saavad teised isendid teenusele ligi. Kui sisemine ja välimine\n aadress hakkavad erinema, siis tuleb see parameeter lüüa\n kaheks.\n\n:network.*.services.*.origin:\n Kohustuslik väli.\n Mikroteenuse isendi täielik domeeninimi ja -port.\n\n----\n\n:status:\n Kohustuslik väli.\n Alamblokk, mis sisaldab loetelu staatust raporteeriva serveritest.\n\n:status.name:\n Kohustuslik väli. Hetkel toetatud ainult ``session``.\n\n Staatust raporteeriva serveri nimi.\n\n:status.servername:\n Kohustuslik väli.\n Staatust raporteeriva serveri SNI.\n\n:status.authttl:\n Kohustuslik väli.\n Aeg sekundites. Vaikeväärtus 0.\n\n Maksimaalne aeg autentimiseks.\n\n:status.choicettl:\n Kohustuslik väli.\n Aeg sekundites. Vaikeväärtus 0.\n\n Maksimaalne aeg valiku tegemiseks.\n\n:status.votettl:\n Kohustuslik väli.\n Aeg sekundites. Vaikeväärtus 0.\n\n Maksimaalne aeg hääle andmiseks.\n\n:status.verifyttl:\n Kohustuslik väli.\n Aeg sekundites. Vaikeväärtus 0.\n\n Maksimaalne aeg hääle verifitseerimiseks.\n\n----\n\n:logging:\n Alamblokk, mis sisaldab loetelu mikroteenuste kauglogimise serveritest.\n Siin blokis kirjeldatakse:\n\n * Logiseire teenus. Alati loetelus esimene. Teenusele saadetakse IVXV\n logi alates tasemest INFO;\n\n * Vajadusel ka täiendavad välised logikogujad, kuhu saadetakse täielik\n logi alates tasemest DEBUG.\n\n Logimine toimub üle RELP protokolli.\n\n Kõik logiserverite parameetrid määrab kogumisteenuse osutaja.\n\n:logging.address:\n Kohustuslik väli.\n Logiserveri aadress (IP-aadress või hostinimi).\n\n:logging.port:\n Logiserveri port (täisarv, vaikimisi *20514*).\n\n----\n\n:storage:\n Kohustuslik väli.\n Alamblokk, mis sisaldab talletusprotokolli seadistust.\n\n Kõik talletusprotokolli parameetrid määrab kogumisteenuse osutaja.\n\n:storage.protocol:\n Kohustuslik väli.\n Kogumisteenuse talletusprotokoll. Hetkel toetatud ainult ``etcd``.\n\n:storage.conf:\n Kohustuslik väli.\n Talletusprotokolli seadistus. Sisu sõltub ``storage.protocol`` parameetri\n väärtusest.\n\n:storage.conf.ca:\n Kohustuslik väli.\n Kasutatakse ainult juhul kui ``storage.protocol`` on ``etcd``.\n\n Talletusteenuste TLS sertifikaatide väljastaja sertifikaat.\n\n:storage.conf.conntimeout:\n Kohustuslik väli.\n Kasutatakse ainult juhul kui ``storage.protocol`` on ``etcd``.\n\n Maksimaalne aeg sekundites etcd serveriga ühenduse loomiseks.\n\n:storage.conf.optimeout:\n Kohustuslik väli.\n Kasutatakse ainult juhul kui ``storage.protocol`` on ``etcd``.\n\n Maksimaalne aeg sekundites ühe talletusoperatsiooni teostamiseks.\n\n:storage.conf.size:\n Valikuline väli.\n Kasutatakse ainult juhul kui ``storage.protocol`` on ``etcd``.\n\n Andmebaasi suurus baitides.\n\n:storage.conf.electiontimeout:\n Valikuline väli.\n Kasutatakse ainult juhul kui ``storage.protocol`` on ``etcd``.\n\n Aeg millisekundites, mida kasutatakse liidri kättesaadavuse\n kontrollimiseks.\n\n:storage.conf.heartbeattimeout:\n Valikuline väli.\n Kasutatakse ainult juhul kui ``storage.protocol`` on ``etcd``.\n\n Aeg millisekundites, mida kasutatakse andmebaasi hosti\n kättesaadavuse kontrollimiseks.\n\n:storage.conf.snapshotcount:\n Valikuline väli.\n Kasutatakse ainult juhul kui ``storage.protocol`` on ``etcd``.\n\n Andmebaasi talletamispäringute arv, mille täitumise korral\n andmebaasi seis varundatakse.\n\n:storage.conf.bootstrap:\n Kohustuslik väli.\n Kasutatakse ainult juhul kui ``storage.protocol`` on ``etcd``.\n\n Loetelu nende talletusteenuste identifikaatoritest, mis on osa algsest\n etcd klastrist. Vajalik, et talletusteenuse isend teaks esmasel\n käivitumisel, kas see loob uut klastrit või liitub olemasolevaga.\n\n Esmases tehnilises seadistuses peab loetelu kattuma ``network`` blokis\n loetletud talletusteenuste identifikaatoritega. Hiljem teenuseid\n lisades või eemaldades ei tohi ``storage.conf.bootstrap`` väärtust\n uuendada.\n\n:storage.ordertimeout:\n Aeg sekundites. Vaikeväärtus 5.\n\n Maksimaalne aeg hääle kirjutamiseks häälte järjekorra tabelisse.\n\n----\n\n:backup:\n Varunduse parameetrid.\n\n Loetelu varundamise kellaaegadest vormingus HH:MM.\n\n:file:`example.technical.yaml`:\n\n.. literalinclude:: config-examples/example.technical.yaml\n :language: yaml\n :linenos:\n\n.. vim:syntax=rst:\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/kt-usaldusjuur.inc", "content": ".. IVXV kogumisteenuse haldusteenuse kirjeldus\n\n.. _kt-trust:\n\nKogumisteenuse usaldusjuure seadistamine\n----------------------------------------\n\nKogumisteenuse usaldusjuur sisaldab andmeid seadistuste (kaasa arvatud\nusaldusjuure enda) allkirjade kontrollimiseks ja nimekirja süsteemi esmastest\nvolitustest.\n\nUsaldusjuure seadistuse koostab valimiste korraldaja.\nSeadistusfaili nimi peab alati lõppema stringiga :file:`trust.yaml`.\nFailinime võimalik eesliide peab alati lõppema punktiga.\n\n.. attention::\n\n Usaldusjuure seadistuste laadimine lähtestab kogumisteenuse. Seetõttu pole\n juba seadistatud kogumisteenuse usaldusahela muutmine võimalik. Volituste\n muutmine on võimalik vastavate korralduste abil.\n\n:container:\n\n Kohustuslik väli.\n Alamblokk, mis sisaldab seadistusfailide allkirjade kontrollimise\n seadistust.\n\n:container.bdoc:\n\n Alamblokk, mis sisaldab seadistusfailide BDOC-allkirjade kontrollimise\n seadistust.\n\n:container.bdoc.filecount:\n Kohustuslik väli. Maksimaalne lubatud failide arv ZIP konteineris, ning\n kuna tegu on BDOC konteineriga, siis sellele väärtusele tuleb alati liita 3,\n sest BDOC konteineris on lisaks sisufailidele veel ``signatures0.xml``,\n ``manifest.xml`` ja ``mimetype`` failid.\n\n:container.bdoc.bdocsize:\n Kohustuslik väli.\n BDOC konteineri maksimaalne lubatud suurus baitides.\n\n:container.bdoc.filesize:\n Kohustuslik väli.\n BDOC konteineris olevate failide maksimaalne lubatud hõrendatud suurus\n baitides.\n\n:container.bdoc.roots:\n\n Kohustuslik väli.\n Seadistuste allkirjastajate sertifikaatide usaldusjuured.\n\n:container.bdoc.intermediates:\n\n Seadistuste allkirjastajate sertifikaatide vahesertifikaadid.\n Usalduse saavutamiseks peab nende sertifikaatide abil olema võimalik\n luua ahel allkirjastaja sertifikaadist usaldusjuureni.\n\n:container.bdoc.profile:\n\n Kohustuslik väli.\n Seadistuste allkirjadelt nõutav BDOC profiil. Toetatud valikud on\n ``BES`` (põhiprofiil kirjeldatud BDOC spetsifikatsiooni jaotises 5),\n ``TS`` (ajatemplitega profiil kirjeldatud BDOC\n spetsifikatsiooni jaotises 6.2).\n\n:container.bdoc.ocsp.responders:\n\n Kasutatakse ainult juhul kui ``container.bdoc.profile`` on ``TS``.\n\n Kehtivuskinnitusi väljastanud OCSP responderi sertifikaadid. Kui nende\n hulgast responderi sertifikaati ei leita, siis otsitakse OCSP vastuses\n olevate sertifikaatide hulgast selline, mis on antud välja sama\n väljastaja poolt, mis seadistuste allkirjastaja sertifikaat, ning on\n lubatud OCSP vastuste signeerimiseks. AIA loogika kasutamise\n korral võib väli olla tühi.\n\n:container.bdoc.tsp.signers:\n\n Kohustuslik väli.\n Kasutatakse ainult juhul kui ``container.bdoc.profile`` on ``TS``.\n\n Ajatempliteenuse vastuse allkirjastamise sertifikaadid.\n\n:container.bdoc.tsp.delaytime:\n\n Kohustuslik väli.\n Kasutatakse ainult juhul kui ``container.bdoc.profile`` on ``TS``.\n\n Maksimaalne ajanihe ajatempli loomise ja allkirjastamise vahel\n sekundites.\n\n:container.bdoc.tsdelaytime:\n\n Kasutatakse ainult juhul kui ``container.bdoc.profile`` on ``TS``.\n\n Maksimaalne ajanihe ajatempli ja kehtivuskinnituse loomise vahel\n sekundites. Välja puudumise või väärtuse 0 korral peavad mõlemad olema\n loodud samal sekundil.\n\n:authorizations:\n\n Kohustuslik väli.\n Esmane nimekiri kogumisteenuse halduri volitustega isikutest (vt.\n :ref:`rollid`), mis rakendatakse süsteemile usaldusjuure laadimisel.\n Iga isiku kohta on kirje tema ID-kaardi välja ``Common Name`` (CN)\n väärtusega. Minimaalselt peab sisaldama usaldusjuure signeerinud isiku\n andmeid.\n\n\nNäide\n*****\n\n:file:`example.trust.yaml`:\n\n.. literalinclude:: config-examples/example.trust.yaml\n :language: yaml\n :linenos:\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/kt-valijate-nimekirja-vahelejätmine.inc", "content": ".. IVXV seadistuste koostamise juhend\n\n.. _kt-voter-list-skip:\n\nValijate nimekirja vahelejätmine\n--------------------------------\n\nValijate nimekirja vahelejätmine tähendab haldusteenuses registreerinud\nvigase valijate nimekirja asendamist tühja nimekirjaga.\n\nProtseduur on vajalik olukorras, kus haldusteenus on Valimiste Infosüsteemist\nalla laadinud ja haldusteenuses registreerinud valijate muudatusnimekirja, mida\npole võimalik kogumisteenusele rakendada (nimekiri on vigane või pole kooskõlas\nteiste kogumisteenuste seadistustega).\n\nValijate nimekirja vahelejätmine korralduse koostab valimiste korraldaja.\n\nSeadistusfaili nimi peab alati lõppema stringiga :file:`.skip.yaml`.\n\n:election:\n\n Kohustuslik väli.\n Valimise unikaalne identifikaator.\n\n:skip_voter_list:\n\n Kohustuslik väli.\n Vahele jäetava valijate muudatusnimekirja versioon.\n\n:changeset:\n\n Kohustuslik väli.\n Vahele jäetava valijate muudatusnimekirja järjekorranumber.\n\nNäide\n*****\n\n:file:`example.voters.skip.yaml`:\n\n.. literalinclude:: config-examples/example.voters.skip.yaml\n :language: yaml\n :linenos:\n\n.. vim:syntax=rst:\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/kt-valimised.inc", "content": ".. IVXV seadistuste koostamise juhend\n\n.. _kt-election:\n\nKogumisteenusele valimise seadistuse koostamine\n-----------------------------------------------\n\nValimise seadistus määrab ühe valimise seadistuse.\n\nValimise seadistuse koostab valimiste korraldaja.\nSeadistusfaili nimi peab alati lõppema stringiga :file:`election.yaml`.\nFailinime võimalik eesliide peab alati lõppema punktiga.\n\n:identifier:\n\n Kohustuslik väli.\n Valimise unikaalne identifikaator.\n\n:questions:\n\n Loetelu, mis sisaldab ühe või enama valimise küsimuse unikaalset\n identifikaatorit. Unikaalsus peab olema tagatud ainult konkreetse\n valimise küsimuste hulgas. Kohustuslik väli.\n\n----\n\n:period:\n\n Kohustuslik väli.\n E-hääletuse perioodi andmete alamblokk.\n\n:period.servicestart:\n\n Kohustuslik väli.\n Kogumisteenuses häälte vastuvõtmise algusaeg. Sellest hetkest alates\n hakkab kogumisteenus ühendusi teenindama. See aeg peab eelnema valimise\n algusajale ning on mõeldud enne valimise algust proovihääle andmiseks.\n\n Enne ``electionstart`` parameetriga määratud aega vastu võetud häälte\n puhul tagastatakse valijarakendusele hääle esitamise lõpus vastav\n veateade (hääl jõudis kohale enne valimise algust). Sellised hääled\n tühistatakse automaatselt töötlemise käigus.\n\n:period.electionstart:\n\n Kohustuslik väli.\n E-hääletuse algusaeg. Sellest hetkest alates antud hääled lähevad\n häälte lugemisel arvesse.\n\n:period.electionstop:\n\n Kohustuslik väli.\n E-hääletuse lõpuaeg. Sellest hetkest lõpetatakse valikute nimekirjade\n väljastamine.\n\n:period.servicestop:\n\n Kohustuslik väli.\n E-hääletuse lõppemisaeg. Sellest hetkest lõpetatakse häälte\n vastuvõtmine ning teenused lõpetavad töö.\n\n----\n\n:voting:\n\n Hääle esitamise parameetrite alamblokk.\n\n:voting.ratelimitstart:\n\n Valija poolt esitatud häälte kogus, mille järel rakendub talle\n hääletamissageduse piirang. Arvesse lähevad ka vigased hääled, kuna\n muidu saaks nendega süsteemi koormata piirangust hoolimata. Välja\n puudumise või väärtuse 0 korral rakendub piirang alates esimesest\n häälest.\n\n:voting.ratelimitminutes:\n\n Aeg minutites, mis peab jääma kahe hääle esitamise vahele, kui valijale\n on rakendatud hääletamissageduse piirang. Välja puudumise või väärtuse\n 0 korral on hääletamissageduse piirangud välja lülitatud.\n\n----\n\n:verification:\n\n Kohustuslik väli.\n Hääle kontrollimise parameetrite alamblokk.\n\n:verification.count:\n\n Kohustuslik väli.\n Suurim ühe hääle lubatud kontrollimiste arv.\n\n:verification.minutes:\n\n Kohustuslik väli.\n Hääle kontrollimise perioodi kestus minutites. Pärast hääle\n andmist on selle perioodi vältel võimalik häält kontrollida.\n\n:verification.latestonly:\n\n Tõeväärtus, kas kontrollida saab ainult valija viimati antud häält. Kui\n väärtus on väär või puudu, siis saab kontrollida kõiki valija hääli\n (teiste piirangute raames).\n\n----\n\n:voterforeignehak:\n\n Alaliselt välisriigis elavate valijate ringkonnakuuluvuse tuvastamiseks\n kasutatav EHAK-kood.\n\n Kui parameeter on määratud, siis alaliselt välisriigis elavad valijad\n kuuluvad ringkondadesse, kuhu kuulub ka parameetris määratud\n EHAK-koodile vastav haldusüksus. Täiendavalt peab ringkondade nimekiri\n sisaldama sellise EHAK-koodiga haldusüksust.\n\n Kui parameeter on määramata, siis kasutatakse EHAK-koodi \"0000\". Kui\n parameeter on määramata ning ringkondade nimekiri ei sisalda\n vaikekoodile vastavat haldusüksust, siis valijate nimekiri ei tohi\n sisaldada alaliselt välisriigis elavaid valijaid.\n\n:ignorevoterlist:\n\n Ringkonna identifikaator, mille valikud esitada kõigile valijatele.\n Kui see väärtus ei ole tühi, siis kogumisteenus ei kasuta valijate\n nimekirja ning esitab kõigile valijatele väärtusega määratud ringkonna\n valikud ja lubab hääletada kõigil, kellel õnnestub isikutuvastus ning\n hääle allkirja kontrollimine.\n\n----\n\n:voterlist:\n\n Kohustuslik väli.\n Valijate nimekirjade kontrollimise parameetrid.\n\n:voterlist.key:\n\n Kohustuslik väli.\n ECDSA-võtmepaari avalik võti valijate nimekirjade allkirja\n kontrollimiseks.\n\n:vis:\n Alamblokk, mis sisaldab Valimiste Infosüsteemi seadistust.\n\n:vis.url:\n\n Kohustuslik väli.\n Valimiste Infosüsteemi URL.\n\n:vis.ca:\n\n Valimiste Infosüsteemi TLS-sertifikaadi usaldusahel.\n\n:vis.min:\n\n Valimiste Infosüsteemi valijate nimekirja hankimise sagedus\n minutites (vaikeväärtus on 15).\n\n:xroad:\n Alamblokk, mis sisaldab X-teega ühenduva teenuse seadistust.\n\n:xroad.ca:\n\n X-teega teenuse TLS-sertifikaadi usaldusahel.\n\n----\n\n:ballot:\n Alamblokk, mis sisaldab sedeli verifitseerimise seadistust.\n\n:ballot.encpkeygroup:\n\n\tKohustuslik väli.\n Abstraktne rühm, millele kuulub Võtmerakenduses genereeritud avalik võti\n häälte krüpteerimiseks.\n\n Võimalikud väärtused ``RFC3526ModPGroup2048`` (võtme pikkus on 2048 bitti ehk\n 256 baiti), ``RFC3526ModPGroup3072``, ``RFC3526ModPGroup4096``,\n ``RFC3526ModPGroup8192``, ``NIST-P256``, ``NIST-P384``, ``NIST-P521`` ja\n ``Edwards25519``. NB! Palun veendu, et valitud rühm loetelust oli ka\n kasutusel avaliku võtme genereerimisel Võtmerakenduses (vt Võtmerakenduse\n konfiguratsiooni faili).\n\n\tAntud rühma kasutatakse krüpteeritud häälte korrektsuse verifitseerimiseks.\n\n Antud väli on ignoreeritud kui `encpkey` on määratud.\n\n:ballot.encpkey:\n\n Avalik võti häälte krüpteerimiseks valijarakenduses.\n\n Võtme rühma kasutatakse krüpteeritud häälte korrektsuse verifitseerimiseks.\n\n----\n\n:auth:\n\n Kohustuslik väli.\n Alamblokk, mis sisaldab valija tuvastamise seadistust.\n\n:auth.ticket:\n\n Alamblokk, mis sisaldab piletipõhise valija tuvastamise seadistust.\n\n Piletipõhist valija tuvastamist kasutatakse Mobiil-ID/Smart-ID/Web eID puhul,\n kus ``mid``/``smartid``/``webeid`` teenus tuvastab valija ning väljastab talle\n pileti, millega teistele teenustele ennast tuvastada.\n\n See alamblokk on tühi, aga tema olemasolu või puudumine määrab, kas\n piletipõhine valija tuvastus on lubatud või ei.\n\n:auth.tls:\n\n Alamblokk, mis sisaldab TLS-põhise valija tuvastamise seadistust.\n\n TLS-põhist valijatuvastust kasutatakse ID-kaardi puhul.\n\n:auth.tls.roots:\n\n Kohustuslik väli.\n Valija TLS-klientsertifikaatide usaldusjuured.\n\n:auth.tls.intermediates:\n\n Valija TLS-klientsertifikaatide vahesertifikaadid. TLS-autentimiseks\n peab nende sertifikaatide abil olema võimalik luua ahel valija\n klientsertifikaadist usaldusjuureni.\n\n:auth.tls.ocsp:\n\n Alamblokk, mis sisaldab valija TLS-klientsertifikaatide oleku\n kontrollimise seadistust. Selle bloki puudumisel valija sertifikaatide\n kehtivust ei kontrollita välisest kehtivuskinnitusteenusest.\n\n:auth.tls.ocsp.url:\n\n Valija TLS-klientsertifikaatide kehtivuskinnitusteenuse aadress.\n Kui pole seadistatud, siis kasutatakse kehtivuskinnitusteenuse\n aadressi otse TLS-klientsertifikaadist.\n\n:auth.tls.ocsp.responders:\n\n Valija TLS-klientsertifikaatide kehtivuskinnitusteenuse responderi\n sertifikaadid. Kui nende hulgast responderi sertifikaati ei leita, siis\n otsitakse vastuses olevate sertifikaatide hulgast selline, mis on antud\n välja sama väljastaja poolt, mis kontrollitav sertifikaat, ning on\n lubatud OCSP vastuste signeerimiseks.\n\n:auth.tls.ocsp.retry:\n\n Valija TLS-klientsertifikaatide oleku kontrolli korduvkatsete arv.\n Juhul kui sertifikaadi oleku kontroll ebaõnnestub võrgu- või serverivea\n tõttu, saab seda automaatselt korrata. Välja väärtus määrab katsete\n arvu, mis tehakse lisaks algsele päringule. Seega kui väärtus on 1,\n siis tehakse kokku maksimaalselt kaks päringut. Välja puudumise või\n väärtuse 0 korral automaatseid korduvkatseid ei sooritata.\n\n----\n\n:identity:\n\n Tuvastatud valija X.500 eraldusnimest unikaalse identifikaatori\n tuletamise meetod. Hetkel toetatud valikud ``commonname``,\n ``serialnumber`` ja ``pnoee``.\n\n Eesti elektrooniliste isikut tõendavate dokumentide korral on\n ``commonname`` puhul identifikaator kujul \"PERENIMI,EESNIMI,ISIKUKOOD\"\n ning teiste valikute teise puhul \"ISIKUKOOD\".\n\n Kui ``serialnumber`` tagastab eraldusnimest ``serialNumber`` välja\n muutmata kujul, siis ``pnoee`` eemaldab sellelt enne mittekohustusliku\n \"PNOEE-\" eesliite. Viimane on vastavuses standardi ETSI EN 319 412-1\n jaotisega 5.1.3 Eesti isikukoodide jaoks, kuid lubab ka standardile\n mittevastavaid seerianumbreid.\n\n\n----\n\n:age:\n\n Alamblokk, mis sisaldab valija vanuse kontrolli seadistust. Kui see\n blokk puudub, siis valija vanust ei kontrollita.\n\n:age.method:\n\n Kohustuslik väli.\n Valija sünniaja tuvastamiseks kasutatav meetod. Hetkel toetatud ainult\n ``estpic``, mis eeldab, et valija unikaalne identifikaator on Eesti\n isikukood ning eraldab sealt sünniaja.\n\n:age.timezone:\n\n Kohustuslik väli.\n IANA ajavööndi nimi, milles valija vanus arvutatakse ehk millises\n ajavööndis peab valija olema valimisealine.\n\n:age.limit:\n\n Kohustuslik väli.\n Valija peab olema vähemalt nii vana, et hääletada. Kui väärtus on 0,\n siis valija vanust ei kontrollita.\n\n----\n\n:vote:\n\n Kohustuslik väli.\n Alamblokk, mis sisaldab häälte allkirjade kontrollimise seadistust.\n\n:vote.bdoc:\n\n Alamblokk, mis sisaldab häälte BDOC-allkirjade kontrollimise seadistust.\n\n:vote.bdoc.filecount:\n\n Kohustuslik väli. Maksimaalne lubatud failide arv ZIP konteineris, ning\n kuna tegu on BDOC konteineriga, siis sellele väärtusele tuleb alati liita 3,\n sest BDOC konteineris on lisaks sisufailidele veel ``signatures0.xml``,\n ``manifest.xml`` ja ``mimetype`` failid. Antud parameetri väärtuseks sobib 4\n (hääl + 3 lisafaili).\n\n:vote.bdoc.bdocsize:\n\n Kohustuslik väli.\n BDOC konteineri maksimaalne lubatud suurus baitides.\n\n:vote.bdoc.filesize:\n\n Kohustuslik väli.\n BDOC konteineris olevate failide maksimaalne lubatud hõrendatud suurus\n baitides.\n\n:vote.bdoc.roots:\n\n Kohustuslik väli.\n Häälte allkirjastajate sertifikaatide usaldusjuured.\n\n:vote.bdoc.intermediates:\n\n Häälte allkirjastajate sertifikaatide vahesertifikaadid.\n Hääle arvesseminekuks peab nende sertifikaatide abil olema võimalik\n luua ahel allkirjastaja sertifikaadist usaldusjuureni.\n\n:vote.bdoc.profile:\n\n Kohustuslik väli.\n Häälte allkirjadelt nõutav BDOC profiil. Toetatud valikud on ``BES``\n (põhiprofiil kirjeldatud BDOC spetsifikatsiooni jaotises 5) ja\n ``TS`` (ajatemplitega profiil kirjeldatud BDOC spetsifikatsiooni\n jaotises 6.2).\n\n See peaks olema ``BES``, kuna kõikide allkirjastamisvahendite puhul ei\n ole sissetulev hääl kvalifitseeritud (nt Eesti ID-kaart). Kogumisteenus\n kvalifitseerib häältel olevad allkirjad ise (vt ``qualification``).\n\n----\n\n:mid:\n\n Alamblokk, mis sisaldab Mobiil-ID teenusepakkuja seadistust.\n\n:mid.url:\n\n Kohustuslik väli.\n Mobiil-ID teenusepakkuja asukoht.\n\n:mid.relyingpartyuuid:\n\n Kohustuslik väli.\n Mobiil-ID teenusepakkujaga kokkulepitud kliendi identifikaator.\n\n:mid.relyingpartyname:\n\n Kohustuslik väli.\n Mobiil-ID teenusepakkujaga kokkulepitud kliendi nimi.\n\n:mid.language:\n\n Kohustuslik väli.\n Mobiil-ID kasutajale kuvatavate sõnumite keel. Võimalikud väärtused\n ``EST``, ``ENG``, ``RUS`` ja ``LIT``.\n\n:mid.authmessage:\n\n Kohustuslik väli.\n Sõnum, mida Mobiil-ID kasutajale kuvada autentimise käigus.\n\n:mid.signmessage:\n\n Kohustuslik väli.\n Sõnum, mida Mobiil-ID kasutajale kuvada allkirjastamise käigus.\n\n:mid.messageformat:\n\n Autentimise ning allkirjastamise käigus kasutajale kuvatava sõnumi\n vorming. Võimalikud väärtused ``GSM-7`` (Mobiil-ID poolt kasutatav\n vaikeväärtus) ja ``UCS-2``.\n\n:mid.authchallengesize:\n\n Autentimise käigus Mobiil-ID teenusele saadetava pretensiooni pikkus.\n Võimalikud väärtused ``32`` (vaikeväärtus), ``48`` ja ``64``.\n\n:mid.statustimeoutms:\n\n Parameeter, mis edastatakse autentimise ja allkirjastamise staatuse\n päringu korral Mobiil-ID teenusele ning millega saab kontrollida, kui\n kaua ootab Mobiil-ID teenus kasutaja poolse tegevuse lõpptulemust, enne\n kui vastab, et tegevus on pooleli. Väärtuse puudumisel oodatakse\n võimalikult vähe: täpne aeg sõltub Mobiil-ID teenusest.\n\n Antud parameetri abil saab vähendada ühe autentimise või allkirjastamise\n käigus Mobiil-ID teenusele saadetavate päringute arvu.\n\n:mid.roots:\n\n Kohustuslik väli.\n Mobiil-ID sertifikaatide usaldusjuured.\n\n:mid.intermediates:\n\n Mobiil-ID sertifikaatide vahesertifikaadid. Mobiil-ID autentimiseks\n peab nende sertifikaatide abil olema võimalik luua ahel Mobiil-ID\n sertifikaadist usaldusjuureni.\n\n:mid.ocsp:\n\n Alamblokk, mis sisaldab valija Mobiil-ID sertifikaatide oleku\n kontrollimise seadistust.\n\n:mid.ocsp.url:\n\n Valija Mobiil-ID sertifikaatide kehtivuskinnitusteenuse aadress.\n Kui pole seadistatud, siis kasutatakse kehtivuskinnitusteenuse\n aadressi otse Mobiil-ID klientsertifikaadist.\n\n:mid.ocsp.responders:\n\n Mobiil-ID sertifikaatide OCSP responderi sertifikaadid. Kui nende\n hulgast responderi sertifikaati ei leita, siis otsitakse vastuses\n olevate sertifikaatide hulgast selline, mis on antud välja sama\n väljastaja poolt, mis kontrollitav sertifikaat, ning on lubatud OCSP\n vastuste signeerimiseks.\n\n----\n\n:smartid:\n\n Alamblokk, mis sisaldab Smart-ID teenusepakkuja seadistust.\n\n:smartid.url:\n\n Kohustuslik väli.\n Smart-ID teenusepakkuja asukoht.\n\n:smartid.relyingpartyuuid:\n\n Kohustuslik väli.\n Smart-ID teenusepakkujaga kokkulepitud kliendi identifikaator.\n\n:smartid.relyingpartyname:\n\n Kohustuslik väli.\n Smart-ID teenusepakkujaga kokkulepitud kliendi nimi.\n\n:smartid.authinteractionsorder:\n\n Kohustuslik väli.\n Autentimise käigus Smart-ID kasutajale kuvatavate interaktsioonide järjekord.\n Järjekorrast valitakse esimene interaktsioon, mida rakendus toetab.\n Võimalikud väärtused: ``displayTextAndPIN`` koos ``displayText60``,\n ``verificationCodeChoice`` koos ``displayText60``,\n ``confirmationMessage`` koos ``displayText200`` või\n ``confirmationMessageAndVerificationCodeChoice`` koos ``displayText200``.\n\n:smartid.signinteractionsorder:\n\n Kohustuslik väli.\n Allkirjastamise käigus Smart-ID kasutajale kuvatavate interaktsioonide järjekord.\n Järjekorrast valitakse esimene interaktsioon, mida rakendus toetab.\n Võimalikud väärtused: ``displayTextAndPIN`` koos ``displayText60``,\n ``verificationCodeChoice`` koos ``displayText60``,\n ``confirmationMessage`` koos ``displayText200`` või\n ``confirmationMessageAndVerificationCodeChoice`` koos ``displayText200``.\n\n:smartid.authchallengesize:\n\n Autentimise käigus Smart-ID teenusele saadetava pretensiooni pikkus.\n Võimalikud väärtused ``32`` (vaikeväärtus), ``48`` ja ``64``.\n\n:smartid.statustimeoutms:\n\n Autentimise ja allkirjastamise staatuse päringu korral Smart-ID\n teenusele edastatav parameeter, millega saab kontrollida, kui kaua\n Smart-ID teenus ootab kasutajapoolse tegevuse lõpptulemust, enne kui\n vastab, et tegevus on pooleli.\n Väärtuse puudumisel oodatakse võimalikult vähe: täpne aeg sõltub\n Smart-ID teenusest.\n\n Parameeter aitab vähendada autentimise või allkirjastamise käigus\n Smart-ID teenusele saadetavate päringute arvu.\n\n:smartid.roots:\n\n Kohustuslik väli.\n Smart-ID sertifikaatide usaldusjuured.\n\n:smartid.intermediates:\n\n Smart-ID sertifikaatide vahesertifikaadid. Smart-ID autentimiseks\n peab nende sertifikaatide abil olema võimalik luua ahel Smart-ID\n sertifikaadist usaldusjuureni.\n\n:smartid.ocsp:\n\n Alamblokk, mis sisaldab valija Smart-ID sertifikaatide oleku\n kontrollimise seadistust.\n\n:smartid.ocsp.url:\n\n Valija Smart-ID sertifikaatide kehtivuskinnitusteenuse aadress.\n Kui pole seadistatud, siis kasutatakse kehtivuskinnitusteenuse\n aadressi otse Smart-ID klientsertifikaadist.\n\n:smartid.ocsp.responders:\n\n Smart-ID sertifikaatide OCSP responderi sertifikaadid. Kui nende\n hulgast responderi sertifikaati ei leita, siis otsitakse vastuses\n olevate sertifikaatide hulgast selline, mis on\n 1) välja antud sama väljastaja poolt, mis kontrollitav sertifikaat;\n ja\n 2) lubatud OCSP vastuste signeerimiseks.\n\n----\n\n:qualification:\n\n Loetelu välistest kvalifitseerivatest päringutest, mis tehakse iga\n hääle kohta, koos seadistustega.\n\n Siin on kasutatud loetelu protokoll ja seadistus blokkidest selle\n asemel, et anda igale protokollile oma blokk, kuna kvalifitseerivate\n päringute järjekord on oluline ning seadistatav.\n\n:qualification.*.protocol:\n\n Kohustuslik väli.\n Kvalifitseeriva päringu protokoll. Hetkel toetatud ``ocsp``\n (harilik OCSP), ``tsp`` (PKIX ajatempel) ja ``tspreg`` (PKIX ajatempel\n registreerimistõendina).\n\n:qualification.*.conf:\n\n Kohustuslik väli.\n Kvalifitseeriva päringu protokolli seadistus. Sisu sõltub\n ``qualification.*.protocol`` parameetri väärtusest.\n\n:qualification.*.conf.url:\n\n Valikuline väli ainult ``ocsp`` puhul, sest kui pole seadistatud,\n kasutatakse kehtivuskinnitusteenuse aadressi otse klientsertifikaadist.\n Aadress, kuhu kvalifitseeriv päring tehakse.\n\n:qualification.*.conf.responders:\n\n Kasutatakse ainult juhul kui ``qualification.*.protocol`` on ``ocsp``.\n\n OCSP responderi sertifikaadid. Kui nende hulgast responderi sertifikaati\n ei leita, siis otsitakse vastuses olevate sertifikaatide hulgast\n selline, mis on antud välja sama väljastaja poolt, mis kontrollitav\n sertifikaat, ning on lubatud OCSP vastuste signeerimiseks. AIA\n loogika kasutamise korral võib väli jääda tühjaks.\n\n:qualification.*.conf.signers:\n\n Kohustuslik väli.\n Kasutatakse ainult juhul kui ``qualification.*.protocol`` on ``tsp``\n või ``tspreg``.\n\n Ajatempliteenuse vastuse allkirjastamise sertifikaadid.\n\n:qualification.*.conf.delaytime:\n\n Kohustuslik väli.\n Kasutatakse ainult juhul kui ``qualification.*.protocol`` on ``tsp``\n või ``tspreg``.\n\n Maksimaalne ajanihe ajatempli loomise ja allkirjastamise vahel\n sekundites.\n\n:qualification.*.conf.retry:\n\n Kvalifitseeriva päringu korduvkatsete arv. Juhul kui päring ebaõnnestub\n võrgu- või serverivea tõttu, saab seda automaatselt korrata. Välja\n väärtus määrab katsete arvu, mis tehakse lisaks algsele päringule.\n Seega kui väärtus on 1, siis tehakse kokku maksimaalselt kaks päringut.\n Välja puudumise või väärtuse 0 korral automaatseid korduvkatseid ei\n sooritata.\n\nNäide\n*****\n\n:file:`example.election.yaml`:\n\n.. literalinclude:: config-examples/example.election.yaml\n :language: yaml\n :linenos:\n\n.. vim:syntax=rst:\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/kt-volitused.inc", "content": ".. IVXV kogumisteenuse haldusteenuse kirjeldus\n\n.. _kt-management:\n\nKogumisteenuse volituste kirjeldamine\n-------------------------------------\n\nKasutajatele volituste määramine käib süsteemis kirjeldatud rollide kaudu.\nIgale rollile on määratud komplekt õigusi ja kasutajal on kõik volitused, mis\ntalle seotud rollide kaudu on määratud.\n\nVolituste määramise korraldus määrab ühele kasutajale tema rollid süsteemis.\n\nVolitused koostatakse JSON-vormingus failina, millega määratakse:\n\n#. Korralduse sisu (``action=user-permissions``);\n\n#. Volitatud kasutaja *Common Name* väli tema ID-kaardilt (väli ``cn``);\n\n#. Kasutaja rollide nimekiri komadega eraldatud nimekirjana (väli ``roles``).\n\nFaili vorming:\n\n.. code-block:: JavaScript\n\n {\n \"action\": \"user-permissions\",\n \"cn\": \",\n \"roles\": \"roll1[,roll2]\"\n }\n\n\n.. _rollid:\n\nRollid\n******\n\nKogumisteenuses on järgnevad rollid:\n\n#. **Kogumisteenuse haldur** (``admin``) on ette nähtud kogumisteenuse\n tehniliseks haldamiseks;\n\n#. **Valimiste haldur** (``election-conf-manager``) on ette nähtud valimiste\n seadistuste kehtestamiseks;\n\n#. **Vaataja** (``viewer``) on ette nähtud haldusteenuse kaudu väljastatavate\n andmete vaatamiseks;\n\n#. **Õigusteta kasutaja** (``none``). See roll on ette nähtud kasutajakonto\n kirje hoidmiseks olukorras, kus kasutajale pole ühtegi teist rolli määratud\n (näiteks pärast lisamist või pärast kõigist teistest rollidest eemaldamist).\n\n.. list-table::\n Rollide ja volituste maatriks\n :header-rows: 1\n\n * -\n - ``admin``\n - ``election-`` ``conf-`` ``manager``\n - ``viewer``\n - ``none``\n\n * - Üldseisundi ja statistika vaatamine\n - ✓\n - ✓\n - ✓\n - `-`\n\n * - Valimiste seadistuste rakendamine\n - ✓\n - ✓\n - `-`\n - `-`\n\n * - E-valimiskasti allalaadimine\n - ✓\n - ✓\n - `-`\n - `-`\n\n * - Kasutajate haldus\n - ✓\n - `-`\n - `-`\n - `-`\n\n * - Tehnilise seadistuse rakendamine\n - ✓\n - `-`\n - `-`\n - `-`\n\n * - Logide vaatamine\n - ✓\n - `-`\n - `-`\n - `-`\n\n\nVolituste reeglid\n*****************\n\n* Kasutaja võib olla mitmes rollis korraga;\n\n* Roll annab kasutajale rolliga seotud õigused, ükski roll õigusi ära ei võta.\n\n.. vim:syntax=rst:\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/kt-ylevaade.inc", "content": ".. IVXV kogumisteenuse haldusteenuse kirjeldus\n\nÜlevaade\n--------\n\nKogumisteenuse juhtimine toimub signeeritud korralduste abil. Korraldused\nkoostatakse operaatori poolt tekstiredaktori abil või imporditakse Valimiste\nInfosüsteemist. Korraldused signeeritakse ID-kaardiga.\n\nNimekiri kogumisteenuse haldamise korraldustest:\n\n#. Usaldusjuure seadistus;\n\n#. Tehniline seadistus;\n\n#. Valimiste seadistus;\n\n#. Valikute nimekiri;\n\n#. Ringkondade nimekiri;\n\n#. Valijate nimekiri;\n\n#. Valijate nimekirja vahelejätmine;\n\n#. Kasutajate volituste määramine.\n\nLisaks korraldustele tuleb kogumisteenusele genereerida ka komplekt\nkrüptovõtmeid.\n\n\nKorralduste vorming\n*******************\n\nKogumisteenuse korralduste vorming on enamasti YAML või JSON, valijate\nnimekirja puhul kasutatakse spetsiifilist vormingut.\n\nYAML-vormingus korraldused:\n\n#. Usaldusjuure seadistus;\n\n#. Tehniline seadistus;\n\n#. Valimiste seadistus.\n\nJSON-vormingus korraldused:\n\n#. Valikute nimekiri;\n\n#. Kasutajate volituste määramine.\n\nKohandatud vormingus korraldused:\n\n#. Valijate nimekiri.\n\n\nYAML-vormingus korraldused\n~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nYAML-vormingus seadistustesse on võimalik kaasata väliseid faile. Selleks\nkasutatakse silti ``!container``.\n\nNäide:\n\n.. code-block:: yaml\n\n # välja \"ext_file\" väärtus loetakse failist \"certificate-file.pem\"\n ext_file: !container certificate-file.pem\n\n.. caution::\n\n Väliste failide kaasamisel tuleb arvestada sellega, et seadistused\n laaditakse süsteemi BDOC-vormingus konteinerites (vt. lõiku\n :ref:`korralduspaki-vorming`). See seab väliste failide kaasamisele\n järgmised nõuded:\n\n * Kasutatavad välised failid peavad olema pakendatud seadistusfailiga\n samasse konteinerisse;\n\n * Välised failid peavad asuma seadistusfailiga samas kataloogis.\n\n\n.. _korralduspaki-vorming:\n\nKorralduspaki vorming\n*********************\n\nKorralduspakk on BDOC-vormingus konteiner, milles on korraldusfail ja\nsignatuurid. Üks korralduspakk tohib sisaldada ainult ühte korraldust.\nYAML-vormingus seadistuse (usaldusjuure seadistus, tehniline seadistus ja\nvalimiste seadistus) korral võivad failis olla ka seadistusfaili poolt\nkasutatavad välised failid.\n\n.. vim:syntax=rst:\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/mixnet.rst", "content": ".. IVXV juhend Verificatumi miksneti ettevalmistamiseks ning kasutamiseks\n\nE-häälte miksimine\n====================================================\n\n.. _mix-install:\n\nMiksneti Verificatum paigaldamine\n---------------------------------\n\nEeldused\n^^^^^^^^\n\nJuhend on kasutamiseks distributsiooniga Ubuntu 20.04 LTS (Bionic Beaver) ja\nsee eeldab, et käske käivitatakse lihtkasutaja õigustest, kellel on õigus\nprivileegide eskaleerimiseks `sudo` käsu abil. Lisaks on eeldatud järgmiste\nfailide olemasolu kasutaja kodukaustas:\n\nGithub repositooriumist (https://github.com/vvk-ehk/intcheck):\n\n* :file:`intcheck.py` - tööriist kataloogide täielikkuse kontrolliks\n\nIVXV tarnefailist:\n\n* :file:`gmpmee.dirsha256sum` - ``gmpmee`` kataloogi räsi;\n\n* :file:`vmgj.dirsha256sum` - ``vmgj`` kataloogi räsi;\n\n* :file:`vcr.dirsha256sum` - ``vcr`` kataloogi räsi;\n\n* :file:`vmn.dirsha256sum` - ``vmn`` kataloogi räsi;\n\n* :file:`ivxv-verificatum-1.10.3-runner.zip` - IVXV adapter Verificatumi\n kasutamiseks.\n\nValimise korraldaja käest:\n\n* :file:`data/bb-4.json` - anonüümitud e-valimiskast;\n\n* :file:`data/pub.pem` - häälte krüpteerimiseks kasutatud võti.\n\nKataloogis :file:`data/` ei tohi olla ühtegi teist faili.\n\nPärast protsessi lõppu on kataloogis :file:`data/` vajalikud järgnevad failid:\n\n* :file:`shuffled.json` - miksitud e-valimiskast;\n\n* :file:`proof.zip` - korrektse miksimise tõend.\n\n\nVerificatumi ehitamine\n^^^^^^^^^^^^^^^^^^^^^^\n\nEhitamiseks vajalike pakkide paigaldamine::\n\n sudo apt-get install --no-install-recommends -y autoconf autoconf automake \\\n build-essential libgmp-dev libtool git openjdk-11-jdk-headless \\\n python unzip wget\n\nVerificatumi lähtekoodi allalaadimine::\n\n git clone https://github.com/verificatum/verificatum-gmpmee gmpmee\n git clone https://github.com/verificatum/vmgj\n git clone https://github.com/verificatum/vcr\n git clone https://github.com/verificatum/vmn\n\nLähtekoodist puhaste arhiivide loomine täielikkuse kontrolliks::\n\n cd gmpmee\n git checkout 4aafc31\n rm -rf .git/\n cd ../vmgj\n git checkout 8d7d412\n rm -rf .git/\n cd ../vcr\n git checkout af9fd82\n rm -rf .git/\n cd ../vmn\n git checkout bb00543\n rm -rf .git/\n cd ..\n\nVerificatumi lähtekoodi täielikkuse kontrollimine::\n\n chmod +x ./intcheck.py\n ./intcheck.py verify gmpmee gmpmee.dirsha256sum\n ./intcheck.py verify vmgj vmgj.dirsha256sum\n ./intcheck.py verify vcr vcr.dirsha256sum\n ./intcheck.py verify vmn vmn.dirsha256sum\n\n`gmpmee` ehitamine::\n\n cd gmpmee/\n make -f Makefile.build\n ./configure\n make\n sudo make install\n\n`vmgj` ehitamine::\n\n cd ../vmgj/\n make -f Makefile.build\n ./configure\n make\n sudo make install\n\n`vcr` ehitamine::\n\n cd ../vcr/\n make -f Makefile.build\n ./configure --enable-vmgj\n make\n sudo make install\n\n`vmn` ehitamine::\n\n cd ../vmn/\n make -f Makefile.build\n ./configure\n make\n sudo make install\n\n\nIVXV Verificatumi adapteri ja käivitusskripti lahtipakkimine::\n\n cd ..\n unzip ivxv-verificatum-1.10.3-runner.zip\n\nVerificatumi teekide kopeerimine adapteri väliste teekide kataloogi::\n\n cp /usr/local/share/java/verificatum-vmgj-1.2.2.jar mixer/lib/verificatum-vmgj.jar\n cp /usr/local/share/java/verificatum-vcr-vmgj-3.0.4.jar mixer/lib/verificatum-vcr-vmgj.jar\n cp /usr/local/share/java/verificatum-vmn-3.0.4.jar mixer/lib/verificatum-vmn.jar\n cp /usr/local/lib/libgmpmee.so.0.0.0 mixer/lib/libgmpmee.so.0\n cp /usr/local/lib/libvmgj-1.2.2.so mixer/lib/libvmgj-1.2.2.so\n\n\n\n.. _mix-mix:\n\n\nE-häälte miksimine\n----------------------------------------\n\nVerificatumi miksneti käivitamine::\n\n cd data\n ../mixer/bin/mix.py --pubkey pub.pem --ballotbox bb-4.json \\\n --shuffled shuffled.json --proof-zipfile proof.zip shuffle\n\nVerificatumi miksneti käivitamine koos entroopiaallika eelneva tühjendamisega::\n\n cd data\n ../mixer/bin/mix.py --pubkey pub.pem --ballotbox bb-4.json \\\n --shuffled shuffled.json --proof-zipfile proof.zip --empty-entropy-pool \\\n shuffle\n\n.. _mix-verify:\n\nMiksimistõendi verifitseerimine\n-------------------------------\n\nVerificatumi adapteri abil saab miksimistõendit ka verifitseerida::\n\n cd ..\n mkdir verify\n cp data/proof.zip verify\n cd verify\n ../mixer/bin/mix.py verify --proof-zipfile proof.zip\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/rakendused.rst", "content": ".. IVXV kogumisteenuse haldusteenuse kirjeldus\n\n\n.. _ivxv-rakendused:\n\nIVXV rakendused\n===============\n\n.. _app-install:\n\nRakenduste paigaldamine\n--------------------------------------------------------------------------------\n\nIVXV rakendused on:\n\n* võtmerakendus `key` (:numref:`app-key`),\n* töötlemisrakendus `processor` (:numref:`app-processor`),\n* auditirakendus `auditor` (:numref:`app-auditor`).\n\nIVXV rakendused on arendatud programmeerimiskeeles Java, kasutusel on Java 21.\nRakendused on testitud Windows 11 ja Ubuntu 22.04 platvormil kasutades OpenJDK'd\nvõi Oracle Javat.\n\nRakendused tarnitakse ZIP-vormingus failidena::\n\n -.zip\n\nPeale ZIP-faili lahti pakkimist tekib kataloogipuu::\n\n -\n |-- bin\n | |-- \n | |-- \n |-- lib\n | |-- *.jar\n\nKui kataloogitee `-/bin` panna keskkonnamuutujasse `PATH`, saab rakendust\nedaspidi käivitada käsurealt::\n\n $ \n\nRakendusi paigaldades tuleb arvestada, et kesksüsteemi protokollides kirjeldatud\nraportid kasutavad ilma ajavööndita aja vormingut (`yyyymmddhhmmss`).\nAjavööndiga ajamärgendi (näiteks hääletamise aeg kogumisteenuselt saadud\ne-valimiskastis) esitamiseks raportis teisendavad Java rakendused ajamärgendi esmalt\noperatsioonisüsteemi ajavööndisse ning seejärel eemaldavad ajavööndi info.\nSeetõttu tuleb rakendusi käivitavates masinates seadistada ajavöönd selliseks,\nmillise kohalikus ajas soovitakse ajamärgendeid näha.\n\n.. _app-trust:\n\nRakenduste usaldusjuure kirjeldamine\n------------------------------------\n\nRakenduste kasutamine eeldab digitaalselt allkirjastatud seadistuste kasutamist.\nAllkirjade verifitseerimiseks vajalikud sertifikaadid tuleb rakendusele ette\nanda usaldusjuure koosseisus. Usaldusjuur on samuti digitaalselt allkirjastatud.\n\nUsaldusjuure seadistuse koostab valimiste korraldaja.\n\n:ca:\n\n Komadega eraldatud loetelu konteineris sisalduvatest CA sertifikaatidest ja\n vahesertifikaatidest.\n\n:ocsp:\n\n Komadega eraldatud loetelu konteineris sisalduvatest OCSP sertifikaatidest.\n\n:tsa:\n\n Komadega eraldatud loetelu konteineris sisalduvatest ATO sertifikaatidest.\n\nKõik sertifikaadid antakse PEM vormingus.\n\nRakendusele esitatakse usaldusjuur BDOC konteineris, kus usaldusjuure\nspetsifikatsioon on kirjeldatud failis `ivxv.properties` ning kõik juure\nelemendid on konteinerisse laaditud.\n\n\nNäide\n*****\n\n:file:`ivxv.properties`:\n\n.. literalinclude:: config-examples/ivxv.properties.real\n :linenos:\n\n\nRakenduste käivitamine\n--------------------------------------------\n\nRakendusi käivitatakse käsurealt, nende toimimist juhitakse käsureaparameetrite\nja digitaalselt allkirjastatud seadistustega. Kõik rakendused väljastavad\nvajadusel abiinfot::\n\n $ --help\n\n Rakendus 'rakendus' - Rakendus\n\n Kasutamine:\n --conf [--params ] [--force ] [--quiet ] [--lang ] [--container_threads ] [--threads ]\n -h | --help\n -h | --help\n\n Tööriistad:\n tool_foo - Tegevuse FOO teostamine\n tool_bar - Tegevuse BAR teostamine\n\n Käsurea argumendid:\n -h --help - Abi\n -c --conf (*) - Konfiguratsioon\n -p --params - Tööriista parameetrid\n -f --force - Ära küsi kasutajalt kinnitust\n -q --quiet - Vaikne käivitusrežiim\n --lang - Keel\n -ct --container_threads - Allkirjastatud konteinerite teegi poolt kasutatav lõimede arv (<= 0 korral dünaamiline)\n -t --threads - Rakenduse poolt paralleeltöötluse korral kasutatav lõimede arv (<= 0 korral dünaamiline)\n Rakendus lõpetas töö ilma vigadeta\n\nRakenduste kasutamisel tuleb määrata konkreetne tööriist, usaldusjuur ning\nseadistusfail::\n\n $ tool_foo --conf usaldusjuur.asice --params tool_foo.conf.asice\n\n Konfiguratsiooni laadimine failist usaldusjuur.asice\n Konfiguratsiooni allkirja kontrollimine\n Konfiguratsiooni allkirja on andnud NIMI NIMESTE\n Konfiguratsiooni allkirja andmise aeg on 24.12.2018 18:00\n Konfiguratsiooni allkiri on korrektne ja kehtiv\n\n FOO!\n\n Rakendus lõpetas töö ilma vigadeta\n\nJuhised rakenduste tööriistade ning nende seadistusfailide koostamise kohta\nantakse järgmistes peatükkides. Käsureaargumendid on kõigil rakendustel samad:\n\n:-h --help:\n Abiinfo kuvamine kas rakenduse või konkreetse tööriista kohta.\n\n:-c --conf (*):\n Digitaalselt allkirjastatud fail usaldusjuurega. Kohustuslik parameeter.\n\n:-p --params:\n Digitaalselt allkirjastatud tööriista parameetrid.\n\n:-f --force:\n Ära küsi kasutajalt kinnitust.\n\n:-q --quiet:\n Vaikne käivitusrežiim.\n\n:--lang:\n Juhul kui rakendus on kompileeritud mitmekeelsena, siis keele valik.\n Vaikimisi on rakendustes võimaldatud ainult eesti keel.\n\n:-ct --container_threads:\n Allkirjastatud konteinerite teegi poolt kasutatav lõimede arv. Vaikimisi\n valitakse lõimede arv teegi poolt dünaamiliselt lähtudes saadaolevate\n tuumade arvust.\n\n:-t --threads:\n Rakenduse poolt paralleeltöötluse korral kasutatav lõimede arv. Vaikimisi\n valitakse lõimede arv rakenduse poolt dünaamiliselt lähtudes saadaolevate\n tuumade arvust.\n\n\nRakendustest eksisteerivad nii tooteversioonid kui testversioonid.\nTestrakendused on kohaldatud protseduuride efektiivseks testimiseks, kuid ei\nsobi valimiste tegelikuks läbiviimiseks. Näiteks ei võimalda võtmerakenduse\ntestversioon kasutada kiipkaarte. Testversioonid rakendustest kuvavad\nkäivitamisel hoiatuse::\n\n ********************************************************************\n * !!! HOIATUS !!! *\n * *\n * Rakendus on käivitatud arendusrežiimis ning rakenduse käitumine *\n * võib erineda tavarežiimist. *\n * Rakenduse käivitamiseks tavarežiimis tuleb rakendus ümber *\n * kompileerida. *\n ********************************************************************\n\nRakenduste käivituskeskkonna parameetrid\n----------------------------------------\n\nSuure e-valimiskasti auditeerimisel, töötlemisel või dekrüpteerimisel, võib olla\ntarvilik suurendada protsessi mälupiirangut.\n\nSeda saab teha kasutades rakendusespetsiifilist keskkonnamuutujat\n``{RAKENDUS}_OPTS``, mis defineerib täiendavad argumendid Java virtuaalmasinale.\n``{RAKENDUS}`` on üks kolmest ``AUDITOR``, ``KEY`` või ``PROCESSOR``. Protsessi\nmälupiirangu suurendamiseks tuleb kasutada argumenti ``-Xmx{N}G``, kus ``{N}``\non mälupiirangu suurus gigabaitides.\n\nNäiteks 10 gigabaidi mälu eraldamiseks töötlemisrakendusele tuleb seada\n``PROCESSOR_OPTS=-Xmx10G``.\n\n\n.. list-table:: Rakenduste mälupiirangu parameetrid\n :header-rows: 1\n\n * - Rakendus\n - Vaikimisi mälupiirang\n - Keskkonnamuutuja\n * - Auditirakendus\n - 8GB\n - ``AUDITOR_OPTS``\n * - Töötlemisrakendus\n - 8GB\n - ``PROCESSOR_OPTS``\n * - Võtmerakendus\n - Puudub\n - ``KEY_OPTS``\n\n\nRakendused töötavad nii 32-bitise kui 64-bitise Java andmemudeliga, samas\nefektiivseimaks toimimiseks tuleb rakendusi kasutada 64-bitisel platvormil\n64-bitise Java andmemudeliga. Juhul kui rakendus ei suuda käivitamisel 64-bitist\nmudelit tuvastada kuvatakse hoiatus::\n\n ********************************************************************\n * !!! HOIATUS !!! *\n * *\n * 64-bitise Java andmemudeli tuvastamine ebaõnnestus. Rakendus on *\n * vähemefektiivsem. Rakenduse jõudluse suurendamiseks tuleb *\n * kasutada 64-bitise andmemudeliga Java keskkonda. *\n ********************************************************************\n\nJuhul kui rakenduse mälupiirang on 4GB või rohkem, ei ole 32-bitise\nandmemudeliga Java võimeline rakendust käivitama. Kuvatakse järgmine veateade::\n\n Invalid maximum heap size: -Xmx4G\n The specified size exceeds the maximum representable size.\n Error: Could not create the Java Virtual Machine.\n Error: A fatal exception has occurred. Program will exit.\n\n\n\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/spelling_wordlist.txt", "content": "\nBeaver\nBionic\nGithub\niOS\nJavat\nOracle\nUbuntu\n\nhosti\nhostinimedest\nhostinimi\n\netcd\nxml\n\nCSV\nIP\nPDF\nURL\n\nBertoni\nDaemen\nPeeters\nVan\nAssche\nSponge\nBased\nPseudo\nRandom\nNumber\nGenerators\n\nKivinen\nKojo\nMore\nModular\nExponential\nDiffie\nHellman\ngroups\nfor\nInternet\nKey\nExchange\n\nDesmedt\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/tootlemisrakendus.rst", "content": ".. IVXV kogumisteenuse haldusteenuse kirjeldus\n\n.. _app-processor:\n\nTöötlemisrakendus\n=================\n\nTöötlemisrakendus on käsurearakendus e-valimiskasti kontrollimiseks ja edasiseks\ntöötlemiseks peale e-hääletamise lõppu.\n\nTöötlemisrakenduse põhilised tööriistad on *check*, *squash*, *revoke* ja\n*anonymize*, mis käivitatakse loetletud järjekorras vastavalt ette nähtud\nvalimisprotseduuridele.\nPõhitööriistade sisendi hulgas on alati kas kogumisteenuse või eelmise tööriista\npoolt väljastatud e-valimiskast ja e-valimiskasti digitaalselt allkirjastatud räsi.\nVäljundi hulgas on töötlemisetapi tulemuseks olev e-valimiskast koos allkirjastamata\nräsiga. Kuna rakendused käivitatakse internetiühenduseta arvutis, tuleb\nräsifailid tõsta digitaalseks allkirjastamiseks välisesse seadmesse.\nE-valimiskasti räsi arvutatakse funktsiooniga ``hex(sha256())``.\n\nLisaks põhitööriistadele on rakendusel veel neli täiendavat tööriista:\n*export*, *verify*, *stats* ja *statsdiff*.\n\nKõigi tööriistade kasutamine eeldab allkirjastatud usaldusjuure ja konkreetse\ntööriista seadistuste olemasolu.\nFaile väljastavatel tööriistadel tuleb seadistustes määrata väljundkausta\nasukoht. Väljundkausta ei tohi käivitamise ajal olemas olla, selle loob rakendus.\nAlljärgnevalt on kirjeldatud tööriistade seadistusi.\n\n.. _processor-check:\n\nE-valimiskasti töötlemine - verifitseerimine\n--------------------------------------------\n\nKogumisteenusest väljastatud e-valimiskasti verifitseerimiseks kasutatakse tööriista\n*check*. valimiskasti verifitseeritakse usaldusjuure, valijate nimekirjade, ringkondade\nnimekirja ja registreerimisteenuse väljundi vastu.\n\nVerifitseerimise käigus kontrollitakse järgmiseid põhilisi omadusi:\n\n* Ringkondade nimekirja ja valijate nimekirjade andmeterviklus ja\n kooskõlalisus;\n\n* E-valimiskasti andmeterviklus;\n\n* E-hääletajate valimisõigus e. kuuluvus valijate nimekirja (kontrollitakse\n juhul kui valijate nimekirjad on seadistustes kirjeldatud);\n\n* E-valimiskastis sisalduvate häälte vastavus digiallkirja vormingule;\n\n* Registreerimisandmete andmeterviklus;\n\n* E-valimiskastis sisalduvate häälte vastavus registreerimisandmetega.\n\nE-valimiskasti verifitseerimine on töömahukas protsess. 4-tuumalise *i7* protsessoriga\narvuti suudab ühe sekundi jooksul töödelda umbes 200 häält. Töötlemise jooksul\nkuvatakse kasutajale edenemisriba, mille alusel on võimalik ennustada\ntöötlemisele kuluvat aega.\n\n:check.ballotbox:\n Kogumisteenusest väljastatud e-valimiskast.\n\n:check.ballotbox_checksum:\n Kogumisteenusest väljastatud e-valimiskasti digitaalselt allkirjastatud räsi.\n\n Kui määramata, siis ei väljastata korrastatud e-valimiskasti järgmisteks\n etappideks. Kasulik mitte-lõpliku e-valimiskasti valimisaegseks kontrolliks.\n\n:check.signed_ballot_max_size_bytes:\n Kogumisteenusest väljastatud e-valimiskasti üksiku allkirjastatud hääle\n maksimaalne lubatud pikkus baitides.\n\n Kui määramata, siis vaikimisi kasutatakse 32768 baiti.\n\n:check.districts:\n Digitaalselt allkirjastatud ringkondade nimekiri.\n\n:check.registrationlist:\n Registreerimisteenusest pärit registreerimisandmed. Kui määramata, siis\n ei kontrollita e-valimiskastis sisalduvate häälte vastavust\n registreerimisandmetega.\n\n:check.registrationlist_checksum:\n Registreerimisandmete digitaalselt allkirjastatud räsi. Võib puududa,\n kui ``registrationlist`` puudub.\n\n:check.tskey:\n Registreerimispäringute verifitseerimiseks kasutatav kogumisteenuse\n avalik võti registreerimispäringute tegemise sertifikaadist.\n\n:check.vlkey:\n Valijate nimekirjade verifitseerimiseks kasutatav avalik võti.\n Argument on kohustuslik, kui valijate nimekirjad on antud.\n\n:check.voterlists_dir:\n Valijate nimekirjade loendi kaust. Kui on määramata, siis e-hääletanute\n hääleõigust ei kontrollita.\n\n:check.voterlists:\n Valijate nimekirjade loend. Kui on määramata, siis e-hääletanute\n hääleõigust ei kontrollita.\n\n:check.voterlists.path:\n Valijate nimekirja fail.\n\n:check.voterlists.signature:\n Valijate nimekirja allkiri, mis on antud algoritmiga\n ``ecdsa-with-SHA256``.\n\n:check.districts_mapping:\n Valijate nimekirjas oleva ringkonna ja jaoskonna teisendusfail\n (valikuline).\n\n:check.election_start:\n Hääletamise algusaeg. Sellest varasema hääletusajaga hääli käsitletakse\n proovihäältena ning need lugemisele ei lähe.\n\n:check.voterforeignehak:\n Alaliselt välisriigis elavate valijate ringkonnakuuluvuse tuvastamiseks\n kasutatav EHAK-kood. Vaikeväärtus \"0000\".\n\n:check.out:\n Tööriista väljundkaust. Sellesse kausta tekivad:\n\n #. Tervikluskontrolliga korrastatud e-valimiskast :file:`-bb-1.json`;\n\n #. Tervikluskontrolliga korrastatud e-valimiskasti räsi\n :file:`-bb-1.json.sha256sum`;\n\n #. E-valimiskasti töötlemisvigade raport :file:`ballotbox_errors.txt`;\n\n #. Valijate nimekirjade töötlemisvigade raport\n :file:`voterlist_errors.txt`;\n\n #. *Log1* fail ehk vastuvõetud hääled\n :file:`..check.log1`.\n\n:file:`processor.check.yaml`:\n\n.. literalinclude:: config-examples/processor.check.yaml\n :language: yaml\n :linenos:\n\n.. _processor-squash:\n\nE-valimiskasti töötlemine - korduvhäälte tühistamine\n----------------------------------------------------\n\nKorduvate e-häälte tühistamiseks kasutatakse tööriista *squash*.\nTööriista sisendiks on tööriista *check* poolt koostatud e-valimiskast.\nKorduvhäälte tühistamisel jäetakse alles iga hääletaja kõige hilisema hääl ja\neemaldatakse kõik varasemad hääled.\n\n:squash.ballotbox:\n Tervikluskontrolliga korrastatud e-valimiskast.\n\n:squash.ballotbox_checksum:\n Tervikluskontrolliga korrastatud e-valimiskasti digitaalselt allkirjastatud\n räsi.\n\n:squash.districts:\n Digitaalselt allkirjastatud ringkondade nimekiri.\n\n:squash.enckey:\n Krüpteerimise avaliku võtme faili asukoht (võtmerakenduse väljund).\n Võtit kasutatakse krüpteeritud häälte eelkontrolliks, eristamaks\n päriselt krüpteeritud hääli suvalisest binaarsest prügist.\n\n:squash.out:\n Tööriista väljundkaust. Sellesse kausta luuakse:\n\n #. Korduvhäältest puhastatud e-valimiskast :file:`-bb-2.json`;\n\n #. Korduvhäältest puhastatud e-valimiskasti räsi :file:`-bb-2.json.sha256sum`;\n\n #. E-hääletanute nimekiri JSON-vormingus :file:`-ivoterlist.json`;\n\n #. E-hääletanute nimekiri PDF-vormingus :file:`-ivoterlist.pdf`;\n\n #. Tühistamiste ja ennistamiste aruanne :file:`-revocation-report.csv`;\n\n #. Tühistamiste ja ennistamiste aruanne ilma isikuandmeteta\n :file:`-revocation-report.csv.anonymous`;\n\n #. *Log2* fail ehk tühistatud hääled :file:`..squash.log2`.\n\n:file:`processor.squash.yaml`:\n\n.. literalinclude:: config-examples/processor.squash.yaml\n :language: yaml\n :linenos:\n\n\n.. _processor-revoke:\n\nE-valimiskasti töötlemine - häälte tühistamine ja ennistamine jaoskonnainfo põhjal\n----------------------------------------------------------------------------------\n\nHäälte tühistamiseks ja ennistamiseks jaoskonnainfo põhjal kasutatakse tööriista\n*revoke*. Tööriist saab sisendiks tööriista *squash* poolt koostatud e-valimiskasti ning\nrakendab sellele sisendiks antud tühistus- ja ennistusnimekirjad.\n\n:revoke.ballotbox:\n Korduvhäältest puhastatud e-valimiskast.\n\n:revoke.ballotbox_checksum:\n Korduvhäältest puhastatud e-valimiskasti digitaalselt allkirjastatud räsi.\n\n:revoke.districts:\n Digitaalselt allkirjastatud ringkondade nimekiri.\n\n:revoke.revocationlists:\n Tühistus- ja ennistusnimekirjade loend. Võib olla tühi.\n\n:revoke.out:\n Tööriista väljundkaust. Sellesse kausta tekivad:\n\n #. Korduvhääletajate häältest puhastatud e-valimiskast :file:`-bb-3.json`;\n\n #. Korduvhääletajate häältest puhastatud e-valimiskasti räsi\n :file:`-bb-3.json.sha256sum`;\n\n #. Tühistamiste ja ennistamiste aruanne :file:`-revocation-report.csv`;\n\n #. Tühistamiste ja ennistamiste aruanne ilma isikuandmeteta\n :file:`-revocation-report.csv.anonymous`;\n\n #. E-hääletanute nimekiri JSON-vormingus :file:`-ivoterlist.json``;\n\n #. *Log2* fail e. tühistatud hääled\n :file:`..revoke.log2`.\n\n:file:`processor.revoke.yaml`:\n\n.. literalinclude:: config-examples/processor.revoke.yaml\n :language: yaml\n :linenos:\n\n\n.. _processor-anonymize:\n\nE-valimiskasti töötlemine - anonüümimine\n----------------------------------------\n\nE-valimiskasti anonüümimiseks kasutatakse tööriista *anonymize*.\nTööriist saab sisendiks tööriista *revoke* poolt koostatud e-valimiskasti ning eemaldab\nsellest valijate info.\n\n:anonymize.ballotbox:\n Korduvhääletajate häältest puhastatud e-valimiskast.\n\n:anonymize.ballotbox_checksum:\n Korduvhääletajate häältest puhastatud e-valimiskasti digitaalselt allkirjastatud\n räsi.\n\n:anonymize.out:\n Tööriista väljundkaust. Sellesse kausta luuakse:\n\n #. Hääletajate isikuandmetest puhastatud e-valimiskast :file:`-bb-4.json`;\n\n #. Hääletajate isikuandmetest puhastatud e-valimiskasti räsi :file:`-bb-4.json.sha256sum`;\n\n #. *Log3* fail e. lugemisele läinud hääled :file:`..anonymize.log3`.\n\n:file:`processor.anonymize.yaml`:\n\n.. literalinclude:: config-examples/processor.anonymize.yaml\n :language: yaml\n :linenos:\n\n\nTöötlemisrakenduse täiendavad tööriistad\n----------------------------------------\n\nTööriist *verify*\n*****************\n\n*Verify* on lisavahend, millega saab verifitseerida digitaalselt allkirjastatud\nkonteineri allkirja ning kuvada konteineri andmed.\n\n:verify.file:\n Verifitseeritav fail.\n\n\n:file:`processor.verify.yaml`:\n\n.. literalinclude:: config-examples/processor.verify.yaml\n :language: yaml\n :linenos:\n\n\nTööriist *export*\n*****************\n\n*Export* on lisavahend, millega saab eksportida kogumisteenusest väljastatud\ne-valimiskasti seest täielikke digitaalselt allkirjastatud hääle konteinereid. On\nvõimalik eksportida nii kõiki hääli korraga, kui konkreetse valija hääli.\n\n:export.ballotbox:\n Kogumisteenusest väljastatud e-valimiskast.\n\n:export.ballotbox_checksum:\n Kogumisteenusest väljastatud e-valimiskasti digitaalselt allkirjastatud räsi.\n\n:export.signed_ballot_max_size_bytes:\n Kogumisteenusest väljastatud e-valimiskasti üksiku allkirjastatud hääle\n maksimaalne lubatud pikkus baitides.\n\n Kui määramata, siis vaikimisi kasutatakse 32768 baiti.\n\n:export.voter_id:\n Valija identifikaator (valikuline).\n\n:export.out:\n Tööriista väljundkaust. Sellesse kausta tekivad:\n\n #. E-valimiskasti töötlemisvigade raport :file:`ballotbox_errors.txt`\n (valikuline);\n\n #. E-valimiskastist eksporditud häälte digitaalselt allkirjastatud konteinerid.\n\n\n:file:`processor.export.yaml`:\n\n.. literalinclude:: config-examples/processor.export.yaml\n :language: yaml\n :linenos:\n\n\nTööriist *stats*\n****************\n\n*Stats* on lisavahend, millega saab arvutada häälte ja hääletajate statistikat\ne-valimiskasti põhjal. Statistikat on võimalik piiritleda ajavahemikuga ning väljundit\non võimalik piiritleda koondandmetega kui ka ringkondade kaupa. NB! Tööriist ei\nkontrolli digitaalallkirju, häälte töötlemiseks tuleb kasutada *check*,\n*squash*, *revoke*, *anonymize* töövoogu.\n\n:stats.ballotbox:\n E-valimiskast, mille põhjal statistika koostada. Kui faili laiendiks on\n ``.json``, siis peab see olema olema töödeldud e-valimiskast. Vastasel juhul\n peab see olema kogumisteenusest väljastatud e-valimiskast.\n\n:stats.signed_ballot_max_size_bytes:\n Kogumisteenusest väljastatud e-valimiskasti üksiku allkirjastatud hääle\n maksimaalne lubatud pikkus baitides.\n\n Kui määramata, siis vaikimisi kasutatakse 32768 baiti.\n\n:stats.election_day:\n Valimispäev. Kõikide e-hääletanute vanused arvutatakse statistika\n tarbeks selle kuupäeva suhtes.\n\n:stats.period_start:\n Statistikaperioodi algusaeg (valikuline). Sellest varasema\n hääletusajaga hääli statistikasse ei kaasata.\n\n:stats.period_end:\n Statistikaperioodi lõppaeg (valikuline). Sellest hilisema hääletusajaga\n hääli statistikasse ei kaasata.\n\n:stats.districts:\n Digitaalselt allkirjastatud ringkondade nimekiri. Vajalik ringkondade\n kaupa statistika väljastamiseks. Kui on määramata, siis väljastatakse\n ainult koondstatistika.\n\n:stats.vlkey:\n Valijate nimekirjade verifitseerimiseks kasutatav avalik võti.\n Argument on kohustuslik valijate nimekirjade kasutamise korral.\n\n:stats.voterlists:\n Valijate nimekirjade loend. Vajalik kogumisteenusest väljastatud\n e-valimiskastist valija ringkonna tuvastamiseks.\n\n Argument on kohustuslik, kui e-valimiskast on väljastatud kogumisteenusest ja\n statistikat väljastatakse ringkondade kaupa.\n\n:stats.voterlists.path:\n Valijate nimekirja fail.\n\n:stats.voterlists.signature:\n Valijate nimekirja allkiri, mis on antud algoritmiga\n ``ecdsa-with-SHA256``.\n\n:check.voterforeignehak:\n Alaliselt välisriigis elavate valijate ringkonnakuuluvuse tuvastamiseks\n kasutatav EHAK-kood. Vaikeväärtus \"0000\".\n\n:stats.out:\n Tööriista väljundkaust. Sellesse kausta tekivad:\n\n #. E-valimiskasti statistika JSON-vormingus :file:`-stats.json`\n (:file:`ELECTION-stats.json` kui valimist ei suudeta tuvastada);\n\n #. E-valimiskasti statistika CSV-vormingus :file:`-stats.csv`\n (:file:`ELECTION-stats.csv` kui valimist ei suudeta tuvastada);\n\n #. E-valimiskasti töötlemisvigade raport :file:`ballotbox_errors.txt`\n (tekib vigade korral);\n\n #. Valijate nimekirjade töötlemisvigade raport\n :file:`voterlist_errors.txt` (tekib vigade korral).\n\n\n:file:`processor.stats.yaml`:\n\n.. literalinclude:: config-examples/processor.stats.yaml\n :language: yaml\n :linenos:\n\n\nTööriist *statsdiff*\n********************\n\n*Statsdiff* on lisavahend, millega saab arvutada kahe statistikafaili vahet.\nTulemuseks on kolmas statistikafail, mille kõik väärtused on pärit alusfailist,\nkust on lahutatud võrreldava faili väärtused.\n\n:statsdiff.compare:\n Statistika võrdluse alusfail JSON-vormingus.\n\n:statsdiff.to:\n Võrreldav statistika fail JSON-vormingus. Võrreldav statistika fail on pärit\n IVXV logimonitorist. Selleks et kasutada *statsdiff* utiliidi tuleb antud failist\n eemaldada **time:** ja **meta:** JSON kirjed. Need kirjed ei oma tähtsust\n statistika võrdlemisel ja on lihtsalt statistika faili genereerimise ajatempel,\n mis on alati erinev **statsdiff.compare** ja **statsdiff.to** failides.\n\n:statsdiff.diff:\n Tööriista väljundfail. Sellesse faili salvestatakse statistikate vahe\n JSON-vormingus.\n\n\n:file:`processor.statsdiff.yaml`:\n\n.. literalinclude:: config-examples/processor.statsdiff.yaml\n :language: yaml\n :linenos:\n\n.. _processor-checkAndSquash:\n\nE-valimiskasti töötlemine - verifitseerimine ja korduvhäälte tühistamine\n------------------------------------------------------------------------\n\nAntud tööriist teostab nii verifitseerimist, kui ka korduvhäälte tühistamist.\nRohkem infot teostavate operatsioonide kohta leidub alapeatükkides:\n\n* *E-valimiskasti töötlemine - verifitseerimine*\n* *E-valimiskasti töötlemine - korduvhäälte tühistamine*\n\n:checkAndSquash.ballotbox:\n Kogumisteenusest väljastatud e-valimiskast.\n\n:checkAndSquash.ballotbox_checksum:\n Kogumisteenusest väljastatud e-valimiskasti digitaalselt allkirjastatud räsi.\n\n Kui määramata, siis ei väljastata korrastatud e-valimiskasti järgmisteks\n etappideks. Kasulik mitte-lõpliku e-valimiskasti valimisaegseks kontrolliks.\n\n:checkAndSquash.signed_ballot_max_size_bytes:\n Kogumisteenusest väljastatud e-valimiskasti üksiku allkirjastatud hääle\n maksimaalne lubatud pikkus baitides.\n\n Kui määramata, siis vaikimisi kasutatakse 32768 baiti.\n\n:checkAndSquash.districts:\n Digitaalselt allkirjastatud ringkondade nimekiri.\n\n:checkAndSquash.registrationlist:\n Registreerimisteenusest pärit registreerimisandmed. Kui määramata, siis\n ei kontrollita e-valimiskastis sisalduvate häälte vastavust\n registreerimisandmetega.\n\n:checkAndSquash.registrationlist_checksum:\n Registreerimisandmete digitaalselt allkirjastatud räsi. Võib puududa,\n kui ``registrationlist`` puudub.\n\n:checkAndSquash.tskey:\n Registreerimispäringute verifitseerimiseks kasutatav kogumisteenuse\n avalik võti registreerimispäringute tegemise sertifikaadist.\n\n:checkAndSquash.vlkey:\n Valijate nimekirjade verifitseerimiseks kasutatav avalik võti.\n Argument on kohustuslik, kui valijate nimekirjad on antud.\n\n:checkAndSquash.voterlists_dir:\n Valijate nimekirjade loendi kaust. Kui on määramata, siis e-hääletanute\n hääleõigust ei kontrollita.\n\n:checkAndSquash.voterlists:\n Valijate nimekirjade loend. Kui on määramata, siis e-hääletanute\n hääleõigust ei kontrollita.\n\n:checkAndSquash.voterlists.path:\n Valijate nimekirja fail.\n\n:checkAndSquash.voterlists.signature:\n Valijate nimekirja allkiri, mis on antud algoritmiga\n ``ecdsa-with-SHA256``.\n\n:checkAndSquash.districts_mapping:\n Valijate nimekirjas oleva ringkonna ja jaoskonna teisendusfail\n (valikuline).\n\n:checkAndSquash.election_start:\n Hääletamise algusaeg. Sellest varasema hääletusajaga hääli käsitletakse\n proovihäältena ning need lugemisele ei lähe.\n\n:checkAndSquash.voterforeignehak:\n Alaliselt välisriigis elavate valijate ringkonnakuuluvuse tuvastamiseks\n kasutatav EHAK-kood. Vaikeväärtus \"0000\".\n\n:checkAndSquash.enckey:\n Krüpteerimise avaliku võtme faili asukoht (võtmerakenduse väljund).\n Võtit kasutatakse krüpteeritud häälte eelkontrolliks, eristamaks\n päriselt krüpteeritud hääli suvalisest binaarsest prügist.\n\n:checkAndSquash.out:\n Tööriista väljundkaust. Sellesse kausta tekivad:\n\n #. Korduvhäältest puhastatud e-valimiskast :file:`-bb-2.json`;\n\n #. Korduvhäältest puhastatud e-valimiskasti räsi :file:`-bb-2.json.sha256sum`;\n\n #. E-hääletanute nimekiri JSON-vormingus :file:`-ivoterlist.json`;\n\n #. E-hääletanute nimekiri PDF-vormingus :file:`-ivoterlist.pdf`;\n\n #. Tühistamiste ja ennistamiste aruanne :file:`-revocation-report.csv`;\n\n #. Tühistamiste ja ennistamiste aruanne ilma isikuandmeteta\n :file:`-revocation-report.csv.anonymous`;\n\n #. *Log1* fail ehk vastuvõetud hääled\n :file:`..log1`.\n\n #. *Log2* fail ehk tühistatud hääled :file:`..log2`.\n\n #. E-valimiskasti töötlemisvigade raport :file:`ballotbox_errors.txt`\n (valikuline);\n\n #. Valijate nimekirjade töötlemisvigade raport\n :file:`voterlist_errors.txt` (valikuline);\n\n\n:file:`processor.checkAndSquash.yaml`:\n\n.. literalinclude:: config-examples/processor.checkAndSquash.yaml\n :language: yaml\n :linenos:\n\n.. _processor-revokeAndAnonymize:\n\nE-valimiskasti töötlemine - häälte tühistamine, ennistamine jaoskonnainfo põhjal ja anonüümimine\n---------------------------------------------------------------------------------------------------\n\nHäälte tühistamiseks, ennistamiseks jaoskonnainfo põhjal ning anonüümimiseks\nkasutatakse tööriista *revokeAndAnonymize*. Tööriist saab sisendiks tööriista *squash*\nvõi *checkAndSquash* poolt koostatud e-valimiskasti ning rakendab sellele sisendiks antud\ntühistus- ja ennistusnimekirjad.\n\n:revokeAndAnonymize.ballotbox:\n Korduvhäältest puhastatud e-valimiskast.\n\n:revokeAndAnonymize.ballotbox_checksum:\n Korduvhäältest puhastatud e-valimiskasti digitaalselt allkirjastatud räsi.\n\n:revokeAndAnonymize.districts:\n Digitaalselt allkirjastatud ringkondade nimekiri.\n\n:revokeAndAnonymize.revocationlists:\n Tühistus- ja ennistusnimekirjade loend. Võib olla tühi.\n\n:revokeAndAnonymize.out:\n Tööriista väljundkaust. Sellesse kausta tekivad:\n\n #. Korduvhääletajate häältest puhastatud ning anonüümitud e-valimiskast\n :file:`-bb-4.json`;\n\n #. Korduvhääletajate häältest puhastatud ning anonüümitud e-valimiskasti räsi\n :file:`-bb-4.json.sha256sum`;\n\n #. Tühistamiste ja ennistamiste aruanne :file:`-revocation-report.csv`;\n\n #. Tühistamiste ja ennistamiste aruanne ilma isikuandmeteta\n :file:`-revocation-report.csv.anonymous`;\n\n #. E-hääletanute nimekiri JSON-vormingus :file:`-ivoterlist.json``;\n\n #. *Log2* fail e. tühistatud hääled\n :file:`..log2`.\n\n #. *Log3* fail e. lugemisele läinud hääled :file:`..log3`.\n\n:file:`processor.revokeAndAnonymize.yaml`:\n\n.. literalinclude:: config-examples/processor.revokeAndAnonymize.yaml\n :language: yaml\n :linenos:\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/valijarakendus.rst", "content": ".. IVXV kogumisteenuse haldusteenuse kirjeldus\n\n.. _valijarakendus:\n\nValijarakenduse seadistamine\n============================\n\nValijarakenduse seadistamist ning pakendamist käsitleb eraldi dokument.\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/votmerakendus.rst", "content": ".. IVXV kogumisteenuse haldusteenuse kirjeldus\n\n.. _app-key:\n\nVõtmerakendus\n=============\n\nVõtmerakendus `key` koosneb tööriistadest *groupgen*, *init*, *testkey*,\n*decrypt* ja *util*. Kõigi tööriistade kasutamine eeldab allkirjastatud\nusaldusjuure ja konkreetse tööriista seadistuste olemasolu. Alljärgnevalt\nkirjeldame konkreetsete tööriistade seadistusi.\n\n.. _key-groupgen:\n\nHäälte salastamise võtme spetsifikatsiooni valimine\n--------------------------------------------------------------------------------\n\nKasutamaks ElGamali krüptosüsteemi häälte krüpteerimiseks, on oluline häälte\nsalastamise võtme spetsifikatsiooni valimine ehk kasutatavate rühma parameetrite\nvalimine, milles tehakse matemaatilisi operatsioone. Oluline on, et antud\nparameetrid oleksid valitud läbipaistvalt, vältimaks tagauste olemasolu, mille\nabil oleks võimalik ilma salajast võtit omamata krüpteeritud hääli avada.\n\nKuna turvalisuse jaoks peavad rühma parameetrid vastama teatud tingimustele,\nsiis nende valimiseks pole kiiret meetodit. Sobivate rühmaparameetrite\nleidmiseks tuleb juhuslikult valida mingid parameetrid ja kontrollida, kas need\nvastavad antud tingimustele.\n\nRühma parameetrite genereerimise protsessi on võimalik läbipaistvalt läbi viia\nkahel viisil:\n\n #. Kasutades teadaolevaid defineeritud parameetreid\n #. Parameetreid avaliku algoritmi alusel deterministlikult genereerides\n\n\nTeadaolevate parameetrite kasutamine\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nMitmed standardid ja rakendused on juba defineerinud parameetrid, mida on sobiv\nkasutada ElGamal krüptosüsteemis. Kasutades laialt levinud parameetreid on\nsuurem tõenäosus, et neid on sõltumatult kontrollitud.\n\nÜheks selliseks standardiks on [RFC3526]_, mis kasutab samuti deterministlikku\nparameetrite genereerimist. Antud standardi korral saab kontrollida defineeritud\nparameetrite korrektsust järgneva Sage skriptiga:\n\n.. literalinclude:: genparam.py\n :language: python\n :linenos:\n\n\nUute parameetrite deterministlik ja kontrollitav genereerimine\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nElGamal krüptosüsteemi jaoks sobilikke parameetreid saab genereerida kasutades\ntööriista *groupgen*.\n\nVõtmespetsifikatsiooni genereerimine on ajaliselt mahukas tegevus, mis võib\nolenevalt riistvarast kesta tunde. Ühekordselt genereeritud rühm on kasutatav\nmitmetel valimistel.\n\n:groupgen.paramtype: ElGamal'i krüptosüsteemi töö aluseks oleva rühma\n tüüp. Toetatud väärtused:\n #. ``mod`` - jäägiklassiring ``Zp``\n\n:groupgen.length: ElGamal'i krüptosüsteemi töö aluseks olevat rühma iseloomustav\n turvaparameeter. Jäägiklassiringide korral on sobiv väärtus\n 3072.\n\n:groupgen.init_template: Asukoht, kuhu kirjutatakse rühma parameetrid. Väljund\n sobib kasutamiseks võtme genereerimise seadistuse\n koostamisel.\n\n:groupgen.random_source: Juhuarvugeneraatori sisendiks kasutatavate allikate\n loetelu. Vaata ka :numref:`random-gen`.\n\nElliptkõveraid kasutades on toetatud kõver P-384, mille parameetrite\ngenereerimine ei ole vajalik.\n\nKasutades juhuslike parameetrite leidmiseks juhuarvugeneraatorit, mille\nalgväärtus on üheselt defineeritav ning avalikustatud, võivad kolmandad\nosapooled kontrollida, et avaldatud rühma parameetrid on esimesed sellised\nleitud parameetrid, mis vastavad tingimustele. Näitekonfiguratsioon kasutab\nDPRNG'd avaliku seemnefailiga. Vaata ka :numref:`random-gen`.\n\n:file:`key.groupgen.yaml`:\n\n.. literalinclude:: config-examples/key.groupgen.yaml\n :language: yaml\n :linenos:\n\nSellise seadistuse korral loetakse juhuarvugeneraatori algväärtus failist\n``public_seed_file``. Oluline on, et sellisel juhul käivitatakse võtmerakendus\nühelõimelisena::\n\n $ key groupgen --conf usaldusjuur.asice --params key.groupgen.asice --threads 1\n\n.. _key-init:\n\nHäälte salastamise võtme genereerimine\n--------------------------------------\n\nHäälte salastamise võtme genereerimiseks kasutatakse võtmerakenduse tööriista\n*init*. Võti genereeritakse seadistustes näidatud läviskeemiga ``MofN``, mis\ntähendab, et N võtmehaldurist peavad häälte dekrüpteerimisel osalema vähemalt M\nhaldurit, vastasel juhul ei ole dekrüpteerimine võimalik.\n\n\n:init.identifier: Valimise unikaalne identifikaator.\n\n:init.out:\n\n Võtmerakenduse tööriista *init* väljundkataloog. Sellesse kataloogi\n tekivad\n\n #. PEM vormingus allkirjavõtme sertifikaat (``sign.pem``)\n #. PEM vormingus krüpteerimisvõtme sertifikaat (``enc.pem``)\n #. PEM vormingus krüpteerimisvõti (``pub.pem``)\n #. DER vormingus krüpteerimisvõti (``pub.der``)\n\n:init.skiptest: Võtmeosakute kontrolltestide vahelejätmine.\n\n:init.fastmode: Kaartidele automaatne terminalide määramine. Vaikimise väärtus\n on tõene.\n\n----\n\n:init.paramtype: ElGamal krüptosüsteemi aluseks oleva rühma parameetrid, mis\n ühtlasi määravad võtme turvataseme. Korraga saab olla\n kasutusel vaid ühe rühma spetsifikatsioon - kas\n jäägiklassiring või elliptkõver\n\n:init.paramtype.ec: Elliptkõverat määravad parameetrid.\n\n:init.paramtype.ec.name: Kasutatava kõvera nimi, hetkel P-384.\n\n:init.paramtype.mod: Jäägiklassiringi määravad parameetrid kümnendesituses.\n Parameetrid võib luua võtmerakenduse tööriista *groupgen*\n kasutades.\n\n:init.paramtype.mod.p: Jäägiklassiringi moodul.\n\n:init.paramtype.mod.g: Jäägiklassiringi generaator.\n\n----\n\n:init.signaturekeylen: Võtmerakenduse poolt genereeritava allkirjastamise võtme\n pikkus.\n\n:init.signcn: Võtmerakenduse poolt loodava allkirjastamise sertifikaadi subjekti\n nimi (väli *CN*).\n\n:init.signsn: Võtmerakenduse poolt loodava allkirjastamise sertifikaadi\n järjekorranumber.\n\n:init.enccn: Võtmerakenduse poolt loodava krüpteerimise sertifikaadi subjekti\n nimi (väli *CN*).\n\n:init.encsn: Võtmerakenduse poolt loodava krüpteerimise sertifikaadi\n järjekorranumber.\n\n----\n\n:init.required_randomness: Juhuslikkuse allikatest loetava entroopia kohustuslik\n hulk baitides.\n\n:init.random_source: Juhuarvugeneraatori sisendiks kasutatavate allikate\n loetelu. Vaata ka :numref:`random-gen`.\n\n----\n\n:init.genprotocol: Võtme genereerimiseks kasutatava algoritmi ja läviskeemi\n spetsifikatsioon.\n\n:init.genprotocol.desmedt:\n\n Algoritmi Desmedt korral genereeritakse võti usaldatava osakujagaja poolt\n ehk võtmerakenduse mälus. Privaatvõtme osakud talletatakse kiipkaartidel.\n\n Täiendavalt tuleb määrata läviskeemi osaliste arv ja minimaalne kvoorum.\n\n Kaartide arv 7 - võimalikud kvoorumid 1,2,3,4 - soovitatav kvoorum 4\n Kaartide arv 8 - võimalikud kvoorumid 1,2,3,4 - soovitatav kvoorum 4\n Kaartide arv 9 - võimalikud kvoorumid 1,2,3,4,5 - soovitatav kvoorum 5\n\n:init.genprotocol.desmedt.threshold: Läviskeemi M väärtus - kvoorum.\n\n:init.genprotocol.desmedt.parties: Läviskeemi N väärtus.\n\n:file:`key.init.yaml`:\n\n.. literalinclude:: config-examples/key.init.yaml\n :language: yaml\n :linenos:\n\n\n\n.. _key-testkey:\n\nHäälte salastamise võtme testimine\n----------------------------------\n\nHäälte salastamise võtme testimine kontrollib võtme rekonstrueerimise võimekust\nselliselt, et iga osak osaleb vähemalt kahes kvoorumis. Testimiseks on vajalik\nkõigi osakute osalemine.\n\n:testkey.identifier: Valimise unikaalne identifikaator.\n\n:testkey.out: Krüpteerimise avaliku võtme asukoha kataloog.\n\n:testkey.threshold: Testimiseks kasutatav lävi, sama mis võtme loomisel\n spetsifitseeritud.\n\n:testkey.parties: Testimiseks kasutatav osapoolte arv, sama mis võtme loomisel\n spetsifitseeritud.\n\n:testkey.fastmode: Kaartidele automaatne terminalide määramine. Vaikimise\n väärtus on tõene.\n\n\n:file:`key.testkey.yaml`:\n\n.. literalinclude:: config-examples/key.testkey.yaml\n :language: yaml\n :linenos:\n\n\n.. _key-decrypt:\n\nE-häälte dekrüpteerimine\n--------------------------------------\n\nElektrooniliste häälte dekrüpteerimiseks kasutatakse võtmerakenduse tööriista\n*decrypt*. Dekrüpteerimise õnnestumiseks peab osalema läviskeemi poolt määratud\nkvoorumi jagu võtmehaldureid. Kui rakendati skeemi ``5of9``, siis osaleb\ndekrüpteerimisel täpselt 5 võtmehaldurit. Vähema arvu haldurite korral ei ole\ndekrüpteerimine võimalik.\n\n:decrypt.identifier:\n\n Valimise unikaalne identifikaator.\n\n----\n\n:decrypt.protocol:\n\n:decrypt.protocol.recover:\n\n Algoritmi Desmedt korral genereeritakse võti usaldatava osakujagaja poolt\n ehk võtmerakenduse mälus. Privaatvõtme osakud talletatakse kiipkaartidel.\n\n:decrypt.protocol.recover.threshold:\n\n Läviskeemi M väärtus - kvoorum, mis spetsifitseeriti võtme loomisel.\n\n:decrypt.protocol.recover.parties:\n\n Läviskeemi N väärtus, mis spetsifitseeriti võtme loomisel.\n\n----\n\n:decrypt.anonballotbox:\n\n Töötlemisrakenduse või miksimisrakenduse poolt loodud e-valimiskast anonüümistatud\n häältega.\n\n:decrypt.anonballotbox_checksum:\n\n Anonüümistatud häältega e-valimiskasti allkirjastatud SHA256 kontrollsummafail.\n\n:decrypt.questioncount:\n\n Küsimuste arv anonüümistatud e-valimiskastis. Vaikimisi väärtus on 1.\n\n:decrypt.candidates:\n\n Valimise valikute nimekiri allkirjastatud kujul.\n\n:decrypt.districts:\n\n Valimise ringkondade nimekiri allkirjastatud kujul.\n\n:decrypt.provable:\n\n Valikuline korrektse dekrüpteerimise tõestuse väljastamine. Vaikimisi\n väärtus on tõene.\n\n:decrypt.prove_invalid:\n\n Valikuline korrektse dekrüpteerimise tõestuse väljastamine ka\n ebakorrektsete sedelite kohta. Eeldab dekrüpteerimise tõestuse\n väljastamist. Vaikimisi väärtus on väär.\n\n:decrypt.check_decodable:\n\n Krüptogrammide korrektsuse kontrollimine enne dekrüpteerimist. Juhul kui\n krüptogrammide sisend ei tule usaldatud allikast, siis tuleb kontrollida\n krüptogrammide korrektsust. Usaldatud allikad on töötlemisrakendus ning\n miksija. Vaikimisi väärus on väär.\n\n:decrypt.out:\n\n Võtmerakenduse tööriista *decrypt* väljundkataloog. Eduka dekrüpteerimise\n korral tekivad siia kausta:\n\n #. Elektroonilise hääletamise tulemus\n #. Elektroonilise hääletamise tulemuse signatuur\n #. Dekrüpteeritud valimiskast\n #. Dekrüpteeritud valimiskasti signatuur\n #. Loend kehtetutest sedelitest\n #. Kehtivate sedelite lugemistõend\n #. Kehtetute sedelite lugemistõend (valikuline)\n\nDekrüpteeritud valimiskast tundlikke andmeid ei sisalda.\n\n:file:`key.decrypt.yaml`:\n\n.. literalinclude:: config-examples/key.decrypt.yaml\n :language: yaml\n :linenos:\n\nPärast dekrüpteerimist on võimalik kontrollida väljastatud elektroonilise\nhääletamise tulemuse signatuuri korrektsust. Selleks tuleb teha järgnevad\nsammud:\n\n1. Eraldada allkirja kontrollimise võti allkirjastamise sertifikaadist::\n\n openssl x509 -in initout/sign.pem -noout -pubkey > sign.pub\n\n2. Kontrollida hääletamise tulemuse allkirja::\n\n openssl dgst -sha256 -sigopt rsa_padding_mode:pss -sigopt \\\n rsa_pss_saltlen:32 -sigopt rsa_mgf1_md:sha256 -verify sign.pub \\\n -signature decout/TESTCONF.tally.signature decout/TESTCONF.tally\n\nKorrektse allkirja korral kuvatakse väärtust `Verified OK`.\n\nSarnaste sammudega on võimalik kontrollida ka väljastatud dekrüpteeritud\nvalimiskasti signatuuri korrektsust.\n\nVõtmerakenduse täiendavad tööriistad\n------------------------------------\n\n:util.listreaders: Loetle ühendatud kaardilugejad.\n\n:file:`key.util.yaml`:\n\n.. literalinclude:: config-examples/key.util.yaml\n :language: yaml\n :linenos:\n\n\n.. _random-gen:\n\nJuhuarvude genereerimine võtmerakenduses\n----------------------------------------\n\nVõtmerakenduse tööriistad *groupgen* ja *init* vajavad oma tööks juhuarve, mille\ngenereerimiseks on võimalik kasutada erinevaid entroopiaallikaid, mis\nvõtmerakenduse poolt üheks allikaks kombineeritakse.\n\nKombineerimisel on oluline, et säiliks sisendite sõltumatus, st. kombineeritud\nväljund ei tohi olla kehvem ühestki sisendist. IVXV raamistikus toimub entroopia\nkombineerimine SHAKE-256 muutuva väljundipikkusega räsifunktsiooni abil (XOF),\nkasutades skeemi nagu on kirjeldatud [BDPA10]_.\n\nLõpliku pikkusega entroopiaallika kasutamisel loetakse kogu väärtus ning antakse\nsee SHAKE-256 sisendiks. Piiramata pikkusega allika lisamisel salvestatakse\nselle viide kombineerija mällu.\n\nPärides kombineerijast töödeldud juhuslikkust, loetakse kõigepealt igast\nsalvestatud entroopia allikast sama palju baite ning antakse see SHAKE-256\nsisendiks. Seejärel kopeeritakse SHAKE-256 isend, muudetakse kopeeritud\nSHAKE-256 režiim lugemisele ning loetakse nõutud baitide jagu väljundit.\n\n\n:random_source: Juhuarvugeneraatori sisendiks kasutatavate allikate loetelu.\n\n:random_source.random_source_type: Juhuarvugeneraatori allika tüüp.\n\n:random_source.random_source_path: Juhuarvugeneraatori allika seadistatav\n asukoht. Argument on valikuline sõltuvalt\n allika tüübist.\n\n----\n\n:random_source_type\\: file: Entroopia lugemine failist.\n\n:random_source_path\\: `randomness_file`: Kasutatav fail.\n\n----\n\n:random_source_type\\: system: Operatsioonisüsteemi poolt pakutav\n entroopiaallikas (Linuxil `/dev/urandom`).\n\n----\n\n:random_source_type\\: DPRNG: Deterministlik pseudojuhuslik generaator (DPRNG) on\n mõeldud baidijadade genereerimiseks, kasutades\n etteantud seemneväärtust. Sama seemneväärtuse\n korral genereerib meetod alati sama jada.\n:random_source_path\\: `seed_file`: DPRNG seemneväärtus saadakse viidatud faili\n SHA256 räsides.\n\n----\n\n:random_source_type\\: stream: Entroopia lugemine voogseadmelt.\n\n:random_source_path\\: `/dev/urandom`: Kasutatav seade.\n\n----\n\n:random_source_type\\: user: Välise programmi käest üle sokli juhuslikkust hankiv\n entroopiaallikas. Kasutusel on IVXV-spetsiifiline\n protokoll.\n\n:random_source_path\\: `user_entropy.exe`: Tee programmini, mis tuleb\n juhuslikkuse hankimiseks käivitada.\n\n\nEntroopiaallikate kombineerimine kirjeldatud viisil võimaldab realiseerida\nerinevaid juhuarvude genereerimise stsenaariumeid. Näiteks häälte salastamise\nvõtme genereerimise korral on vaja tagada võtme konfidentsiaalsus ning olla\nkindel, et genereerimisprotsess ei ole hiljem korratav. Näitekonfiguratsioon\nkasutab välist programmi kasutaja sisendi lugemiseks ning süsteemset\njuhuarvugeneraatorit:\n\n:file:`rnd.init.yaml`:\n\n.. literalinclude:: config-examples/rnd.init.yaml\n :language: yaml\n :linenos:\n\n\nRakendus käivitatakse mitmelõimelisena::\n\n $ key init --conf usaldusjuur.asice --params rnd.init.asice\n\nHäälte salastamise võtme spetsifikatsioon on erinevalt häälte salastamise\nvõtmest avalik ning selle genereerimisel kasutatud juhuslikkuse võib samuti teha\navalikuks. Näitekonfiguratsioon kasutab DPRNG'd avaliku seemnefailiga.\n\n:file:`rnd.groupgen.yaml`:\n\n.. literalinclude:: config-examples/rnd.groupgen.yaml\n :language: yaml\n :linenos:\n\nKui eesmärk on genereerimisprotsessi korratavus, tuleb rakendus käivitada\nühelõimelisena::\n\n $ key groupgen --conf usaldusjuur.asice --params rnd.groupgen.asice --threads 1\n\n\n\n.. [BDPA10] G. Bertoni, J. Daemen, M. Peeters, G. Van Assche: Sponge-Based\n Pseudo-Random Number Generators. CHES 2010: 33-47\n\n.. [RFC3526] T. Kivinen, M. Kojo: More Modular Exponential (MODP) Diffie-Hellman\n groups for Internet Key Exchange (IKE). IETF RFC3526, 2003\n" }, { "path": "Documentation/et/seadistuste_koostejuhend/ylevaade.rst", "content": ".. IVXV kogumisteenuse haldusteenuse kirjeldus\n\nIVXV seadistused valimise korraldamise protsessis\n-------------------------------------------------\n\nIVXV kasutamiseks valimise kontekstis tuleb süsteem ja sellega seotud\nrakendused seadistada nii, et on võimalik valijatelt häälte vastuvõtmine ning\nnende käitlemine vastavalt süsteemile seatud terviklus-, konfidentsiaalsus ja\nkäideldavusnõuetele. Käesolev tehniline dokument annab ülevaate olulisimatest\nseadistustoimingutest ning on mõeldud täiendama elektroonilise hääletamise\nkäsiraamatu poolt kirjeldatud protseduurireeglite täitmist.\n\nSeadistuste koostamiseks vajalikud andmed\n*****************************************\n\nValimise üldparameetrid\n Valimise üldparameetrid määravad valimise unikaalse identifikaatori\n kasutamiseks kõigi seotud komponentide poolt, küsimuste arvu ning\n identifikaatorid, hääletamisperioodi alguse- ja lõpuaja ning hääle\n kontrollimise seadistuse. Valimise üldparameetrite spetsifikatsiooni\n käsitletakse käesolevas dokumendis.\n\nAlgne valijate nimekiri\n Algne valijate nimekiri on kohandatud vormingus fail, mille vorming ning\n seotud protokollid on defineeritud dokumendis \"IVXV protokollid\". Eesti\n riiklike valimiste korral tuleb algne valijate nimekiri Rahvastikuregistrist.\n\nValikute nimekiri\n Valikute nimekiri on JSON vormingus fail, mille vorming ning seotud\n protokollid on defineeritud dokumendis \"IVXV protokollid\". Eesti riiklike\n valimiste korral tuleb valikute nimekiri valimiste infosüsteemist.\n\nRingkondade nimekiri\n Ringkondade nimekiri on JSON vormingus fail, mille vorming ning seotud\n protokollid on defineeritud dokumendis \"IVXV protokollid\". Eesti riiklike\n valimiste korral tuleb ringkondade nimekiri valimiste infosüsteemist.\n\nRakenduste usaldusjuur\n Rakenduste usaldusjuur defineerib sertifitseerimishierarhiad, mille alusel\n IVXV rakendused verifitseerivad digitaalallkirju. Eesti riiklike valimiste\n korral määrab usaldusjuure koosseisu Riigi Valimisteenistus. Rakenduste\n usaldusjuure vormingut käsitletakse peatükis :numref:`ivxv-rakendused`.\n\nKogumisteenuse usaldusjuur\n Kogumisteenuse usaldusjuur defineerib sertifitseerimishierarhiad, mille\n alusel IVXV kogumisteenuse komponendid verifitseerivad digitaalallkirju. Eesti\n riiklike valimiste korral määrab usaldusjuure koosseisu Riigi\n Valimisteenistus. Kogumisteenuse usaldusjuure vormingut ning seotud protokolle\n käsitletakse peatükis :numref:`kogumisteenus`.\n\nKogumisteenuse tehniline seadistus\n Kogumisteenuse tehniline seadistus kirjeldab IVXV mikroteenuste seadistuse\n ning isendite jaotumise. Eesti riiklike valimiste korral leiab kogumisteenuse\n osutaja Riigi Valimisteenistus. Tehniline seadistus kooskõlastatakse\n valimiste omaniku ja kogumisteenuse osutaja vahel. Tehnilist seadistust\n käsitletakse peatükis :numref:`kt-technical`.\n\nKogumisteenuse võtmed ja sertifikaadid\n Kogumisteenuse mikroteenused suhtlevad omavahel TLS protokolli vahendusel.\n Vastavad sertifikaadid tuleb eksportida Valijarakendusse ja\n Kontrollrakendusse. Kogumisteenusega seotud võtmete loomist käsitletakse\n peatükis :numref:`kt-krypto`.\n\nHäälte salastamise võtme spetsifikatsioon\n Häälte salastamise võtme jaoks kasutatav algoritm ning seotud tehnilised\n parameetrid fikseeritakse enne häälte salastamise võtme genereerimist. Võtme\n spetsifikatsiooni käsitletakse peatükis :numref:`key-groupgen`.\n\nHääletamisperioodile eelnevad tegevused\n***************************************\n\nEnne hääletamisperioodi algust teostatakse lähtuvalt eelnevatest andmetest\njärgmised tegevused:\n\n#. :numref:`app-install`\n#. :numref:`app-trust`\n#. :numref:`key-groupgen`\n#. :numref:`key-init`\n#. :numref:`key-testkey`\n#. :numref:`kt-trust`\n#. :numref:`kt-technical`\n#. :numref:`kt-election`\n#. Ringkondade nimekirja laadimine Kogumisteenusesse\n#. Valikute nimekirja laadimine Kogumisteenusesse\n#. Valijate nimekirja (algne) laadimine Kogumisteenusesse\n#. :numref:`kt-management`\n#. :numref:`valijarakendus`\n#. :numref:`kontroll`\n\nHääletamisperioodi tegevused\n****************************\n\n#. Valijate nimekirjade (muudatused) laadimine Kogumisteenusesse\n\nHääletamisperioodile järgnevad tegevused\n****************************************\n\nE-valimiskasti töötlemine\n^^^^^^^^^^^^^^^^^^^^^^^^^\n\n#. :numref:`processor-check`\n#. :numref:`processor-squash`\n#. :numref:`processor-revoke`\n#. :numref:`processor-anonymize`\n\nHäälte miksimine\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n#. :numref:`mix-install`\n#. :numref:`mix-mix`\n#. :numref:`mix-verify`\n\nHääletamistulemuse väljaselgitamine ja andmeaudit\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n#. :numref:`key-decrypt`\n#. :numref:`auditor-convert`\n#. :numref:`auditor-mix`\n#. :numref:`auditor-decrypt`\n" }, { "path": "Documentation/et/votmerakendus/Makefile", "content": "include ../../common.mk\n" }, { "path": "Documentation/et/votmerakendus/index.rst", "content": ".. IVXV tehniline dokumentatsioon\n\n======================================================================\nIVXV tehniline dokumentatsioon\n======================================================================\n\n-------------\nVõtmerakendus\n-------------\n\n.. raw:: html\n\n

\n NB!\n See on HTML-versioon dokumendist.\n Tellijale antakse üle PDF-versioon.\n

\n\n.. toctree::\n :maxdepth: 3\n :numbered:\n\n sissejuhatus\n votmeosakute_protokollid\n viited\n" }, { "path": "Documentation/et/votmerakendus/sissejuhatus.rst", "content": ".. IVXV tehniline dokumentatsioon\n\nSissejuhatus\n============\n\nVõtmerakendus on Korraldaja põhitööriist, millega genereeritakse iga hääletamise jaoks häälte salastamise ja häälte avamise võti. Võtmerakenduse abil toimub ka häälte lugemine ja tulemuse väljastamine.\n\nDokumendis spetsifitseeritakse võtmerakenduse tehnilised detailid.\n" }, { "path": "Documentation/et/votmerakendus/viited.rst", "content": ".. IVXV tehniline dokumentatsioon\n\nViited\n======\n\n.. [DF89] Desmedt, Y. & Frankel, Y. Brassard, G. (Ed.). Threshold Cryptosystems.\n Advances in Cryptology - CRYPTO '89, 9th Annual International Cryptology\n Conference, Santa Barbara, California, USA, August 20-24, 1989,\n Proceedings, Springer, 1989, 435, 307-315\n.. [Shoup00] Shoup, V. Practical Threshold Signatures Advances in Cryptology -\n EUROCRYPT 2000, International Conference on the Theory and Application of\n Cryptographic Techniques, Bruges, Belgium, May 14-18, 2000, Proceeding, 2000,\n 207-220\n.. [RFC8017] PKCS #1: RSA Cryptography Specifications Version 2.2.\n https://tools.ietf.org/html/rfc8017\n" }, { "path": "Documentation/et/votmerakendus/votmeosakute_protokollid.rst", "content": ".. IVXV tehniline dokumentatsioon\n\nEritüübiliste võtmeosakute protokollide liidestamine\n====================================================\n\nVõtmeosakute genereerimise protokolli liides\n--------------------------------------------\n\nKlass `ee.ivxv.key.protocol.GenerationProtocol` defineerib liidese, mida\nElGamali või RSA võtmeosakute genereerimise protokoll peab täitma. Liides on\njärgnev::\n\n public interface GenerationProtocol {\n byte[] generateKey() throws ProtocolException;\n }\n\nEritüübiliste võtmeosakute genereerimiseks peab implementeerima `generateKey()`\nmeetodi, mis tagastab kodeeritud avaliku võtme X.509 sertifikaadina DER\nformaadis. Protokolli klass peab olema paki `ee.ivxv.key.protocol.generation`\nalampakis.\n\nProtokolli parameetrid tuleb määrata protokolli klassiinstantsi\ninitsialiseerimise ajal.\n\nDekrüpteerimise protokolli liides\n---------------------------------\n\nDekrüpteerimise ja võtmeosakute genereerimise protokoll ei pea olema üksüheses\nseoses, st. võtmeosakute genereerimise protokollile võib vastata mitu\ndekrüpteerimise protokolli. Seega on dekrüpteerimise protokolli liides\ndefineeritud sõltumatult võtmeosakute genereerimise liidesest. Protokoll peab\nimplementeerima `ee.ivxv.key.protocol.DecryptionProtocol` liidese::\n\n public interface DecryptionProtocol {\n ElGamalDecryptionProof decryptMessage(byte[] msg) throws ProtocolException;\n }\n\nMeetod `decryptMessage()` võtab sisendina krüptogrammi DER formaadis ning\nväljastab `ElGamalDecryptionProof` instantsi. Juhul kui protokoll ei toeta\nlugemistõendi väljastamist, siis on vastavad väljad väärtustatud tühiväärtusega\n(`null`).\n\nAnaloogselt võtmeosakute genereerimise protokollile tuleb protokolli\nparameetrid määrata klassiinstantsi initsialiseerimise ajal.\n\nAllkirjastamise protokolli liides\n---------------------------------\n\nLisaks dekrüpteerimise protokollile saab implementeerida ka allkirjastamise\nprotokolli. Sarnaselt dekrüpteerimisprotokollile võib ühele võtmegenereerimise\nmeetodile vastata mitu allkirjastamise protokolli. Protokoll peab\nimplementeerima `ee.ivxv.key.protocol.SigningProtocol` liidese::\n\n public interface SigningProtocol {\n byte[] sign(byte[] msg) throws ProtocolException;\n }\n\nMeetod `sign()` võtab sisendina sõnumi, mida soovitakse allkirjastada, ja\nväljastab RSA-PSS allkirja järgnevate parameetritega:\n\n.. _RSA-PSS parameetrid:\n\n- sõnumi räsifunktsioon: SHA2-256\n- maski genereerimise funktsioon: MGF1, maski räsifunktsioon SHA2-256 ja maski\n pikkus 32 baiti\n- soola pikkus: 32 baiti\n- sababait: `0xbc`\n\nAnaloogselt võtmeosakute genereerimise protokollile tuleb protokolli\nparameetrid määrata klassiinstantsi initsialiseerimise ajal.\n\nToetatud protokollid\n--------------------\n\nHetkel on teostatud järgnevad võtmeosakute genereerimise protokollid:\n\n* `ee.ivxv.key.protocol.generation.desmedt.DesmedtGeneration`: Võtmeosakud on\n sellised, et oleks võimalik kasutada [DF89]_ hajutatud\n dekrüpteerimisprotokolli. Võtmeosakud salvestatakse otse PKCS15 liidest\n toetavale pääsmikule. Klassiinstantsi initsialiseerimise ajal saab anda\n järgnevaid argumente:\n\n + `PKCS15Card[] cards`: järjend objektides mis implementeerivad PKCS15Card\n liidest (nt. kiipkaardid või tarkvaralised pääsmikud).\n + `ElGamalParameters params`: ElGamali krüptosüsteemi parameetrid.\n + `ThresholdParameters tparams`: läviskeemi parameetrid.\n + `Rnd rnd`: juhuslikkuse sisend võtmeosakute genereerimisel\n + `byte[] cardShareAID`: võtmeosaku ligipääsuidentifikaator PKCS15\n pääsmikul. Defineerib, millise ligipääsutunnusega pääseb võtmeosakule\n ligi.\n + `byte[] cardShareName`: võtmeosaku identifikaator PKCS15 pääsmikul.\n\n* `ee.ivxv.key.protocol.generation.shoup.ShoupGeneration`: Võtmeosakud on\n sellised, et oleks võimalik kasutada [Shoup00]_ põhinevat hajutatud\n allkirjastamisprotokolli. Võtmeosakud salvestatakse otse PKCS15 liidest\n toetavale pääsmikule. Klassiinstantsi initsialiseerimise ajal saab anda\n järgnevaid argumente:\n\n + `PKCS15Card[] cards`: järjend objektidest, mis implementeerivad PKCS15Card\n liidest (nt. kiipkaardid või tarkvaralised pääsmikud).\n + `int modLen`: RSA võtme pikkus bittides\n + `ThresholdParameters tparams`: läviskeemi parameetrid.\n + `Rnd rnd`: juhuslikkuse sisend võtmeosakute genereerimisel\n + `byte[] cardShareAID`: võtmeosaku ligipääsuidentifikaator PKCS15\n pääsmikul. Defineerib, millise ligipääsutunnusega pääseb võtmeosakule\n ligi.\n + `byte[] cardShareName`: võtmeosaku identifikaator PKCS15 pääsmikul.\n\nOn teostatud järgnevad dekrüpteerimise protokollid:\n\n* `ee.ivxv.key.protocol.decryption.recover.RecoverDecryption`: Loetakse PKCS15\n liidest toetavatelt pääsmikelt võtmeosakud, rekonstrueeritakse nende abil\n operatiivmälus salajane võti ning teostatakse dekrüpteerimine lugemistõendiga.\n Klassiinstantsi initsialiseerimise ajal saab anda järgnevaid argumente:\n\n + `PKCS15Card[] cards`: järjend objektides mis implementeerivad PKCS15Card\n liidest (nt. kiipkaardid või tarkvaralised pääsmikud).\n + `ThresholdParameters tparams`: läviskeemi parameetrid.\n + `byte[] cardShareAID`: võtmeosaku ligipääsuidentifikaator PKCS15\n pääsmikul. Defineerib, millise ligipääsutunnusega pääseb võtmeosakule\n ligi.\n + `byte[] cardShareName`: võtmeosaku identifikaator PKCS15 pääsmikul.\n\nOn teostatud järgnevad allkirjastamise protokollid:\n\n* `ee.ivxv.key.protocol.signing.shoup.ShoupSigning`: Loetakse PKCS15 liidest\n toetavatelt pääsmikelt võtmeosakud, konstrueeritakse mälus allkirjastamise\n osakud ilma võtit rekonstrueerimata ning kombineeritakse allkirjastamise\n osakud RSA-PSS allkirjaks. Klassiinstantsi initsialiseerimise ajal saab anda\n järgnevaid argumente:\n\n + `PKCS15Card[] cards`: järjend objektides mis implementeerivad PKCS15Card\n liidest (nt. kiipkaardid või tarkvaralised pääsmikud).\n + `ThresholdParameters tparams`: läviskeemi parameetrid.\n + `Rnd rnd`: juhuslikkuse sisend RSA-PSS allkirja soola genereerimisel.\n + `byte[] cardShareAID`: võtmeosaku ligipääsuidentifikaator PKCS15\n pääsmikul. Defineerib, millise ligipääsutunnusega pääseb võtmeosakule\n ligi.\n + `byte[] cardShareName`: võtmeosaku identifikaator PKCS15 pääsmikul.\n\nProtokollide võtmerakendusega liidestamine\n------------------------------------------\n\nJärgnev kirjeldus käib nii võtmeosakute genereerimise ja dekrüpteerimise\nprotokollide kohta.\n\n.. note:: Praegune kirjeldus on üldine. Kui konfi- ja argumentide parsimine on\n lõplikult välja töötatud ning protokollid võtmerakendusega liidestatud, siis\n tuleks järgnevat lõiku täiendada.\n\nLiidestamaks uut protokolli võtmerakendusega, tuleb kõigepealt teostada vastava\nprotokolli liidest täitev klass. Võtmerakendus peab töö alguses seadistuse\ntöötlemise käigus aru saama kas käsureaargumentidest või seadistusfailist,\nmillist protokolli soovitakse kasutada. Seejärel tuleb vastava klassi staatilise\nmeetodi abil ülejäänud käsureaargumentide või seadistusfaili abil\ninitsialiseerida uus protokolliklassi instants. Seejärel tuleb genereerida võti\nvõi dekrüpteerida sõnum.\n\nToetatud protokollide kirjeldused\n---------------------------------\n\nShamiri saladuse jagamise skeem\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nOlgu meil salajane väärtus :math:`s = a_0` ja soovime seda jagada :math:`n`\nosapoole vahel selliselt, et vähemalt :math:`t` osapoolt saaksid selle saladuse\nrekonstrueerida. Selleks valime koefitsiendid :math:`a_1` kuni :math:`a_{t-1}`\nning vaatame polünoomi muutuja :math:`x` suhtes:\n\n.. math::\n P(x) = a_{t-1} x^{t-1} + .. + a_1 x + a_0\n\nOlgu :math:`x_1` kuni :math:`x_n` nullist erinevad unikaalsed väärtused\n(üldiselt :math:`1` kuni :math:`n`), sellisel juhul saame osakud :math:`s_i =\nP(x_i)` ning salajase väärtuse :math:`s = P(0)`.\n\nGeomeetriliselt vaadates on :math:`P(x)` polünoom ning osakud punktid sellel\npolünoomil. Põhikoolimatemaatikast teame, et :math:`t-1` järku polünoomi\njoonistamiseks piisab meile :math:`t` punktist (sirge jaoks kaks punkti,\nparabooli jaoks kolm punkti jne.). Salajane väärtus on selle polünoomi väärtus\ny-telje lõikepunktis.\n\nVaadates rekonstrueerimist arvuliselt, mitte geomeetriliselt, saame kasutades\nLagrange interpoleerimise meetodit. Tähist :math:`\\prod` kasutame me mitme\nliikmega korrutise tähistamiseks ja tähist :math:`\\sum` kasutame me mitme\nliikmega summa tähistamiseks.\n\nNüüd, tähistame lisaks :math:`t` osapoolt, kes osalevad salajase väärtuse\nrekonstrueerimisel tähisega :math:`U`. Lagrange interpoleerimise valem ütleb:\n\n.. math::\n \\overline{P}(x) = \\sum\\limits_{j \\in U} s_j \\frac{\\prod\\limits_{i \\in U, j \\neq i}x-x_i}{\\prod\\limits_{i \\in U, j \\neq i}x_j-x_i}\n\nTõepoolest: fikseerime :math:`j` - paneme tähele, et kui :math:`x = x_j`, siis\nmurru väärtus on :math:`1` (kuna lugejas ja nimetajas olevad kordajad taandavad\nüksteist) ja kui :math:`x \\neq x_j`, kuid :math:`x = x_k`, mingi muu :math:`k\n\\in U` korral, siis murd on :math:`0` (kuna lugejas on :math:`x_k - x_i = 0`\nmingi :math:`i \\in U` korral). Seega:\n\n.. math::\n \\overline{P}(x_j) = s_j + 0 \\sum_{i \\in U, i \\neq j} s_i = s_j = P(x_j)\n\nKuna osapooled teavad väärtuseid :math:`s_i = P(x_i)` (osakud), siis\nkombineerides ning korrutades need läbi baaspolünoomiga\n\n.. math::\n L(U,x,j) = \\frac{\\prod\\limits_{i \\in U, j \\neq i}x - x_i}{\\prod\\limits_{i \\in U, j \\neq i}x_j - x_i}\n\nja fikseerides :math:`x = 0`, saame jagatud saladuse.\n\n`ee.ivxv.key.protocol.generation.desmedt.DesmedtGeneration`\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nArvestades, et ElGamali võtmeparameetriks on rühm :math:`G` koos generaatoriga\n:math:`g`, siis salajaseks võtmeks valitakse :math:`x`, mis on ülimalt\n:math:`ord(g)`, st. :math:`g` multiplikatiivne järk rühmas :math:`G`. Vastavaks\navalikuks võtmeks võetakse väärtus :math:`y = g^x`. Salajase võtme komplektiks\nsaab väärtus :math:`(G, g, x)` ja avaliku võtme komplektiks väärtus :math:`(G,\ng, y)`. Rühm :math:`G` valitakse selliselt, et tema järk on mingi algarv\n:math:`p` selliselt, et kehtib :math:`p = 2 q + 1`, kus :math:`q` on samuti\nalgarv. Selliselt juhul kirjeldab :math:`G` väärtust algarv :math:`p`.\n\nAlgebrast teame, et kui :math:`G` järk on :math:`2q + 1`, siis iga selle rühma\nelemendi järk on kas :math:`1`, :math:`2`, :math:`q` või :math:`2q`. Me oleme\nhuvitatud selliselt generaatorist, mille järk on :math:`q` ja mis on ruutjääk,\nkuna see genereerib piisavalt suure alamrühma, mille kõik elemendid on\nruutjäägid. Vastasel juhul võib toimuda ühe biti lekkimine krüpteeritud sõnumi\nkohta. Sellise generaatori leidmiseks vaatame me rühma suvalisi elemente ning\nkontrollime tema järku ning ruutjäägilisust kuni leiame sobiva elemendi. Sellise\nelemendi määrame generaatoriks.\n\nInstants genereerib juhusliku :math:`0\n NB!\n See on HTML-versioon dokumendist.\n Tellijale antakse üle PDF-versioon.\n

\n\n.. toctree::\n :maxdepth: 3\n :numbered:\n\n sissejuhatus\n jooksevnimekiri\n seadistamine" }, { "path": "Documentation/et/xteeteenus/jooksevnimekiri.rst", "content": ".. IVXV tehniline dokumentatsioon\n\nE-hääletamiste jooksev nimekiri\n===============================\n\nTeenus vahendab jooksvat nimekirja EHS-ist X-tee-le.\n\n.. figure:: model/xteevotesorder.png\n\n X-tee turvaserveri suhtlus EHS-iga\n\nTeenuses konfigureeritakse valimissündmused, mille nimekirja on võimalik küsida.\n\nTeenus pakub kolme otspunkti:\n\n1. ``Valimissündmuste loetelu`` - väljastab aktiivsete valimissündmuste loetelu\n\n2. ``Viimane järjenumber`` - väljastab konkreetse valimissündmuse viimase EHS-s registreeritud e-hääletamise järjenumbri.\n\n3. ``e-hääletamiste pakk`` - väljastab EHS-lt valimissündmuse e-hääletamiste paki, alatest e-hääletamisest järjenumbriga.\n" }, { "path": "Documentation/et/xteeteenus/model/Makefile", "content": "PLANTUML=env -u DISPLAY plantuml\n\nall: xteeivxv.png xteevotesorder.png\n\n%.png: %.pu\n\t$(PLANTUML) $<\n" }, { "path": "Documentation/et/xteeteenus/model/xteeivxv.pu", "content": "@startuml\n\nleft to right direction\n\n[X-tee teenus(xroad-service)] as xservice\n[X-tee turvaserver] as xsec\n[IVXV1] as ivxv1\n[IVXV2] as ivxv2\n[IVXV3] as ivxv3\n\nxsec --> xservice\nxservice--> ivxv1\nxservice--> ivxv2\nxservice--> ivxv3\n\n@enduml\n" }, { "path": "Documentation/et/xteeteenus/model/xteevotesorder.pu", "content": "@startuml\n\nleft to right direction\n\npackage \"IVXV\" {\n [Järjekorrateenus] as votesorder\n}\n\n[X-tee teenus(xroad-service)] as xservice\n[X-tee turvaserver] as xsec\n\nxsec --> xservice\nxservice--> votesorder\n\n@enduml\n" }, { "path": "Documentation/et/xteeteenus/seadistamine.rst", "content": ".. IVXV tehniline dokumentatsioon\n\nSeadistamine\n============\n\nTeenuse konfigureerimiseks kasutatakse ``xroad-service.json`` faili.\n\n``server.address`` - Serveri port\n\n``server.batchmaxsize`` - Paki suurus, soovitatud suurus 1000\n\n``server.openapipath`` - OpenAPI faili asukoht. Serveeritakse https://host/openapi.\n\n``server.tls`` - Serveri TLS konfiguratsioon\n\n``xroad.certificate`` - X-tee turvaserveri sertifikaat\n\n``elections``- Valimissündmuste list\n\n``elections.name``- Valimissündmuse nimi\n\n``elections.address`` - IVXV serveri aadress\n\n``elections.servername`` - Järjekorrateenuse SNI\n\n``elections.rootca`` - IVXV CA sertifikaat\n\n``elections.clientcert`` - Kliendi sertifikaat, kliendi CA tuleb lisada IVXV konfiguratsiooni\n\n``elections.clientkey`` - Kliendi võti\n\nKäivitamine\n===========\n\nTeenus ei lähe iseseisvalt püsti, ning kui \"Seadistamine\" on tehtud, tuleb juurkasutajalt käivitada `systemctl start xroad-service`.\n\nSeiskamine\n==========\n\nKui teenus läheb maha erinevatel põhjustel (masina taaskäivitamine, veaolukorrad, manuaalne seiskamine `systemctl stop xroad-service` abil), siis tuleb korrata \"Käivitamine\" protseduuri et teenust taas püsti ajada.\n" }, { "path": "Documentation/et/xteeteenus/sissejuhatus.rst", "content": ".. IVXV tehniline dokumentatsioon\n\nSissejuhatus\n============\n\nX-tee teenus on vahendamaks päringuid EHS-i(de) ja X-tee turvaserveri vahel.\n\n\n.. figure:: model/xteeivxv.png\n\n X-tee teenus turvaserveri ja EHS-ide vahel\n\nDokumendis spetsifitseeritakse teenuse tehnilised detailid.\n" }, { "path": "Documentation/ivxv-technical/ivxv-common.cls", "content": "% ivxv-common.cls\n\n% Class definition\n\\ProvidesClass{ivxv-common}\n\n% Class options for handling documents in different languages\n\\newcommand{\\@IVXVStringConfidential}{Konfidentsiaalne}\n\\newcommand{\\@IVXVStringDate}{Kuup\\\"aev:}\n\\newcommand{\\@IVXVStringDocumentType}{Tehniline dokument}\n\\newcommand{\\@IVXVStringVersion}{Versioon}\n\\newcommand{\\@IVXVStringPages}{lk}\n\\newcommand{\\@IVXVStringDocument}{Dok}\n\\newcommand{\\@IVXVStringBackofTitlePage}{\\copyright\\ RVT, \\the\\year}\n\\newcommand{\\@IVXVStringCopyrightFooter}{\\copyright\\ RVT, \\the\\year}\n\n\\DeclareOption{estonian}{%\n\t\\renewcommand{\\@IVXVStringConfidential}{Konfidentsiaalne}%\n\t\\renewcommand{\\@IVXVStringDate}{Kuup\\\"aev:}%\n\t\\renewcommand{\\@IVXVStringDocumentType}{Tehniline dokument}%\n\t\\renewcommand{\\@IVXVStringVersion}{Versioon}%\n\t\\renewcommand{\\@IVXVStringPages}{lk}%\n\t\\renewcommand{\\@IVXVStringDocument}{Dok}%\n}\n\\DeclareOption{english}{%\n\t\\renewcommand{\\@IVXVStringConfidential}{Confidential}%\n\t\\renewcommand{\\@IVXVStringDate}{Date:}%\n\t\\renewcommand{\\@IVXVStringDocumentType}{Technical document}%\n\t\\renewcommand{\\@IVXVStringVersion}{Version}%\n\t\\renewcommand{\\@IVXVStringPages}{pages}%\n\t\\renewcommand{\\@IVXVStringDocument}{Doc.}%\n}\n\n\\ProcessOptions\\relax\n\n\n% Base class, which we will modify\n% Add oldfontcommands for newer versions of memoir.\n%\\LoadClass[a4paper, twoside, 12pt, article]{memoir}\n\\LoadClass[a4paper, twoside, 12pt, article, oldfontcommands]{memoir}\n\n\\usepackage{cmap}\n\n% Make the figure and table captions separated by full stops rather than colons.\n\\usepackage{caption}\n\\captionsetup[table]{labelsep=period}\n\\captionsetup[figure]{labelsep=period}\n\n% margins\n\\usepackage[top=1in,bottom=1in,left=1in,right=1in,pdftex]{geometry}\n\n% For figuring out, how many pages there is in the document\n\\usepackage{lastpage}\n\n% We want to do later MakeUppercase for the section heads and when \\label{} is included in the section head, then it will break everything.\n% Textcase package provides more intelligent MakeUppercase command\n\\usepackage[overload]{textcase}\n\n% utf8 fileformat\n\\usepackage[utf8]{inputenc}\n\\usepackage[T1]{fontenc}\n% Times New Roman font for body text\n% Arial font for section headlines. The font can be installed\n% with ftp://tug.org/tex/getnonfreefonts/install-getnonfreefonts utility\n%\\usepackage[scaled]{uarial}\n\\renewcommand*{\\familydefault}{\\sfdefault}\n\n\\newcommand{\\IVXVArial}{\\fontfamily{phv} \\selectfont}\n\n% Commands for setting the document type, number, version, etc.\n\\newcommand{\\IVXVDefineDocumentType}[1]{\\def\\@IVXVStringDocumentType{#1}}\n\\newcommand{\\IVXVDefineDocumentNumber}[1]{\\def\\@IVXVDocumentNumber{#1}}\n\\newcommand{\\IVXVDefineDocumentVersion}[1]{\\def\\@IVXVDocumentVersion{#1}}\n\\newcommand{\\IVXVDefineDocumentSecurity}[1]{\\renewcommand{\\@IVXVStringConfidential}{#1}}\n\\newcommand{\\IVXVDefineAcknowledgement}[1]{\\def\\@IVXVAcknowledgement{#1}}\n\\newcommand{\\IVXVDefineCopyrightFooter}[1]{\\renewcommand{\\@IVXVStringCopyrightFooter}{#1}}\n\\newcommand{\\IVXVDefineBackofTitlePage}[1]{\\renewcommand{\\@IVXVStringBackofTitlePage}{#1}}\n\n% .. and initialize them to empty\n\\IVXVDefineDocumentNumber{}\n\\global\\let\\@IVXVDocumentNumber\\@empty\n\\IVXVDefineDocumentVersion{}\n\\global\\let\\@IVXVDocumentVersion\\@empty\n\\IVXVDefineAcknowledgement{}\n\\global\\let\\@IVXVAcknowledgement\\@empty\n\n% Pagestyle with headers and footers\n\\setlength{\\headwidth}{\\textwidth}\n\\makepagestyle{IVXVFancy}\n\\makerunningwidth{IVXVFancy}{\\headwidth}\n\n% No indent of paragraphs\n\\setlength{\\parindent}{0pt}\n\\setlength{\\parskip}{1.5ex}\n\n% TODO: Single command for this?\n\\makeoddhead{IVXVFancy}{}{}{\n\t\\IVXVArial \t\\tiny \\@IVXVStringConfidential}\n\\makeevenhead{IVXVFancy}{}{}{\n\t\\IVXVArial \\tiny \\@IVXVStringConfidential}\n\n\\makeoddfoot{IVXVFancy}{\n\t\\IVXVArial\n\t{\\tiny\n\t\t{\\bfseries \\hspace{-0.75em}\\@title} \\\\\n\t\t\t\\@date}}\n\t{}\n\t{\n\t\\IVXVArial\n\t{\\tiny\n\t\t\\@IVXVDocumentVersion \\\\\n\t\t\\thepage\\ / \\pageref{LastPage}}}\n\\makeevenfoot{IVXVFancy}{\n\t\\IVXVArial\n\t{\\tiny\n\t\t{\\bfseries \\hspace{-0.75em}\\@title} \\\\\n\t\t\t\\@date}}\n\t{}\n\t{\n\t\\IVXVArial\n\t{\\tiny\n\t\t\\@IVXVDocumentVersion \\\\\n\t\t\\thepage\\ / \\pageref{LastPage}}}\n\n\\makefootrule{IVXVFancy}{\\headwidth}{\\normalrulethickness}{0pt}\n\n% We have multiline headers, therefore less space is available\n% for text.\n\\addtolength{\\footskip}{2mm}\n\n% Enforce pagestyle for pages with new chapters as well\n\\aliaspagestyle{chapter}{IVXVFancy}\n\n% Set the new style as the default\n\\pagestyle{IVXVFancy}\n\n% Titlepage style with headings\n\\makepagestyle{IVXVTitle}\n\\makerunningwidth{IVXVTitle}{\\headwidth}\n\\makeoddhead{IVXVTitle}{\n\t\\begin{minipage}[t]{0.5\\textwidth}\n\t\t\\hspace{-7mm}\n\t\\end{minipage}\n\t}{}{\n\t\\raisebox{2.5mm}{\\IVXVArial \\scriptsize \\bfseries \\@IVXVStringConfidential}\n\t}\n% Chapter and section headline style\n\n\\renewcommand{\\printchapternum}{\\LARGE \\bfseries \\IVXVArial \\thechapter}\n\\renewcommand{\\printchaptertitle}[1]{\\LARGE \\bfseries \\IVXVArial #1}\n\\setlength{\\beforechapskip}{60pt}\n\\setlength{\\afterchapskip}{40pt}\n\n\\let\\stdchapter\\chapter\n\\renewcommand\\chapter{\\clearpage\\ \\stdchapter}\n\n\\setsecheadstyle{\\normalsize \\bfseries \\IVXVArial}\n\\setsubsecheadstyle{\\normalsize \\bfseries \\IVXVArial}\n\\setsubsubsecheadstyle{\\IVXVArial}\n\n\\usepackage{graphicx}\n% title page\n\\makeatletter\n\\renewcommand{\\maketitle}{%\n\t\\thispagestyle{IVXVTitle}\n\t% \\vspace{2cm}\n\n\t\\begin{minipage}[t]{0.5\\textwidth}\n\t\t%\\vspace{-6.5mm}\n\t\t%\\hfill\n\t\t\\vspace{31mm}\n\t\\end{minipage}\n\t\\vspace{4cm}\n\t\\begin{flushleft}\n\t\t\\IVXVArial\n\t\t{\\LARGE \\bfseries \\@title}\n\t\t\\vfill\n\t\t{\\Large \\bfseries\n\t\t\t\\@IVXVStringDocumentType\n\n\t\t\t\\ifx\\@IVXVDocumentVersion\\@empty\n\t\t\t\tDok. versiooninumber defineerimata. Kasuta IVXVDefineDocumentVersion käsku või IVXV-Document-Version stiili.\n\t\t\t\\else\n\t\t\t\t\\@IVXVStringVersion~\\@IVXVDocumentVersion\n\t\t\t\\fi\n\n\t\t\t\\@date\n\n\t\t\t\\pageref{LastPage} \\@IVXVStringPages\\\\[1.5ex]\n\n\t\t\t\\ifx\\@IVXVDocumentNumber\\@empty\n\t\t\t\tDok. hoidla ning järjenumber defineerimata. Kasuta IVXVDefineDocumentNumber käsku või IVXV-Document-Number stiili.\n\t\t\t\\else\n\t\t\t\t\\@IVXVStringDocument~\\@IVXVDocumentNumber\n\t\t\t\\fi\n\t\t}\\par\n\t\t\\vspace{2cm}\n\t\t{\\scriptsize \\@IVXVAcknowledgement}\n\t\\end{flushleft}\n\t\\pagebreak\n%\t\\thispagestyle{empty}\n%\t\\@IVXVStringBackofTitlePage\n%\t\\cleardoublepage\n}\n\\makeatother\n\n% Make dots appear in the table of contents also for chapters\n\\renewcommand{\\cftchapterdotsep}{\\cftdotsep}\n\n% URL formating, URL breaking and linked entries in the PDF\n\n\\usepackage{url}\n%%% XXX remove breakurl\n% \\usepackage{breakurl}\n%%% XXX \\usepackage[pdfborder={0 0 0}, pdftex, pdfpagelayout=TwoPageRight]{hyperref}\n% hyperref and memoir is incompatible, this fixes the problems\n\\usepackage{memhfixc}\n\n% make enumerate and itemize lists tighter\n\\firmlists\n% and change the numbering for nested lists\n\\renewcommand{\\labelenumi}{\\arabic{enumi}.}\n\\renewcommand{\\labelenumii}{\\arabic{enumi}.\\arabic{enumii}}\n\\renewcommand{\\labelenumiii}{\\arabic{enumi}.\\arabic{enumii}.\\arabic{enumiii}}\n\\renewcommand{\\labelenumiv}{\\arabic{enumi}.\\arabic{enumii}.\\arabic{enumiii}.\\arabic{enumiii}.\\arabic{enumiv}}\n% make LaTeX observe right margins at all costs:\n\\sloppy\n" }, { "path": "Documentation/ivxv-technical/ivxv-technical.cls", "content": "% ivxv-technical.cls\n\n\\ProvidesClass{ivxv-technical}\n\\DeclareOption*{\\PassOptionsToClass{\\CurrentOption}{ivxv-common}}\n\\ProcessOptions\\relax\n\\LoadClass{ivxv-common}\n" }, { "path": "Documentation/ivxv-technical/pandoc-extras.sty", "content": "% Style for pandoc generated latex output, related with docbook format.\n% It's needed for special formatting and may be only needed for docbook,\n% so probably you don't need this (e.g. for markdown -> latex conversion).\n\n% Highlighting\n\\usepackage{framed}\n\\usepackage{color}\n\\usepackage{fancyvrb}\n\\newcommand{\\VerbBar}{|}\n\\newcommand{\\VERB}{\\Verb[commandchars=\\\\\\{\\}]}\n\\DefineVerbatimEnvironment{Highlighting}{Verbatim}{commandchars=\\\\\\{\\}}\n\\newenvironment{Shaded}{\\begin{shaded}}{\\end{shaded}}\n\\definecolor{shadecolor}{gray}{0.9}\n\\newcommand{\\KeywordTok}[1]{\\textcolor[rgb]{0.00,0.44,0.13}{\\textbf{{#1}}}}\n\\newcommand{\\DataTypeTok}[1]{\\textcolor[rgb]{0.56,0.13,0.00}{{#1}}}\n\\newcommand{\\DecValTok}[1]{\\textcolor[rgb]{0.25,0.63,0.44}{{#1}}}\n\\newcommand{\\BaseNTok}[1]{\\textcolor[rgb]{0.25,0.63,0.44}{{#1}}}\n\\newcommand{\\FloatTok}[1]{\\textcolor[rgb]{0.25,0.63,0.44}{{#1}}}\n\\newcommand{\\ConstantTok}[1]{\\textcolor[rgb]{0.53,0.00,0.00}{{#1}}}\n\\newcommand{\\CharTok}[1]{\\textcolor[rgb]{0.25,0.44,0.63}{{#1}}}\n\\newcommand{\\SpecialCharTok}[1]{\\textcolor[rgb]{0.25,0.44,0.63}{{#1}}}\n\\newcommand{\\StringTok}[1]{\\textcolor[rgb]{0.25,0.44,0.63}{{#1}}}\n\\newcommand{\\VerbatimStringTok}[1]{\\textcolor[rgb]{0.25,0.44,0.63}{{#1}}}\n\\newcommand{\\SpecialStringTok}[1]{\\textcolor[rgb]{0.73,0.40,0.53}{{#1}}}\n\\newcommand{\\ImportTok}[1]{{#1}}\n\\newcommand{\\CommentTok}[1]{\\textcolor[rgb]{0.38,0.63,0.69}{\\textit{{#1}}}}\n\\newcommand{\\DocumentationTok}[1]{\\textcolor[rgb]{0.73,0.13,0.13}{\\textit{{#1}}}}\n\\newcommand{\\AnnotationTok}[1]{\\textcolor[rgb]{0.38,0.63,0.69}{\\textbf{\\textit{{#1}}}}}\n\\newcommand{\\CommentVarTok}[1]{\\textcolor[rgb]{0.38,0.63,0.69}{\\textbf{\\textit{{#1}}}}}\n\\newcommand{\\OtherTok}[1]{\\textcolor[rgb]{0.00,0.44,0.13}{{#1}}}\n\\newcommand{\\FunctionTok}[1]{\\textcolor[rgb]{0.02,0.16,0.49}{{#1}}}\n\\newcommand{\\VariableTok}[1]{\\textcolor[rgb]{0.10,0.09,0.49}{{#1}}}\n\\newcommand{\\ControlFlowTok}[1]{\\textcolor[rgb]{0.00,0.44,0.13}{\\textbf{{#1}}}}\n\\newcommand{\\OperatorTok}[1]{\\textcolor[rgb]{0.40,0.40,0.40}{{#1}}}\n\\newcommand{\\BuiltInTok}[1]{{#1}}\n\\newcommand{\\ExtensionTok}[1]{{#1}}\n\\newcommand{\\PreprocessorTok}[1]{\\textcolor[rgb]{0.74,0.48,0.00}{{#1}}}\n\\newcommand{\\AttributeTok}[1]{\\textcolor[rgb]{0.49,0.56,0.16}{{#1}}}\n\\newcommand{\\RegionMarkerTok}[1]{{#1}}\n\\newcommand{\\InformationTok}[1]{\\textcolor[rgb]{0.38,0.63,0.69}{\\textbf{\\textit{{#1}}}}}\n\\newcommand{\\WarningTok}[1]{\\textcolor[rgb]{0.38,0.63,0.69}{\\textbf{\\textit{{#1}}}}}\n\\newcommand{\\AlertTok}[1]{\\textcolor[rgb]{1.00,0.00,0.00}{\\textbf{{#1}}}}\n\\newcommand{\\ErrorTok}[1]{\\textcolor[rgb]{1.00,0.00,0.00}{\\textbf{{#1}}}}\n\\newcommand{\\NormalTok}[1]{{#1}}\n" }, { "path": "Documentation/podl/.gitignore", "content": "venv/\n" }, { "path": "Documentation/podl/podl.py", "content": "#!/usr/bin/env python3\n\n# IVXV Internet voting framework\n\n\"\"\"PO translator with Deepl\n\nTranslate PO files with Deepl\n\nUsage:\n podl --input --api [options]\n podl -h | --help\n podl -v | --version\n\nOptions:\n -h --help Request for help\n -v --version Show version information\n -i --input Input file or directory\n -s --source Source language [default: ET]\n -t --target Target language [default: EN-GB]\n -f --force Actually use API\n --fuzzy Override fuzzy translations [default: False]\n -a --api Deepl API token\n\"\"\"\n\nimport os\nimport deepl\nimport polib\n\nfrom docopt import docopt\nfrom schema import Or, Schema, SchemaError\n\n\nclass Translator:\n\n def __init__(self, api, source, target, force):\n self.__translator = deepl.Translator(api)\n self.__source_lang = source\n self.__target_lang = target\n self.__force = force\n\n def translate(self, source_msg):\n if self.__force:\n return str(self.__translator.translate_text(\n source_msg,\n source_lang = self.__source_lang,\n target_lang = self.__target_lang\n ))\n return None\n\n\ndef process_file(filename, translator, fuzzy):\n po = polib.pofile(filename)\n print(f\"File {filename} is {po.percent_translated()}% translated\")\n for entry in po.untranslated_entries():\n if not entry.msgstr:\n newmsg = translator.translate(entry.msgid)\n if newmsg is not None:\n entry.msgstr = newmsg\n po.save(filename)\n if fuzzy:\n for entry in po.fuzzy_entries():\n newmsg = translator.translate(entry.msgid)\n if newmsg is not None:\n entry.msgstr = newmsg\n po.save(filename)\n po.save(filename)\n\n\nif __name__ == '__main__':\n ARGS = docopt(__doc__, version='Deepl PO translator 1.0')\n SCHEMA = Schema({\n '--input': Or(os.path.isdir, os.path.isfile),\n '--source': str,\n '--target': str,\n '--api': str,\n '--force': bool,\n '--fuzzy': bool,\n '--help': Or(False),\n '--version': Or(False)\n })\n try:\n ARGS = SCHEMA.validate(ARGS)\n except SchemaError as err:\n exit(err)\n\n INPUT = ARGS['--input']\n DEEPL = Translator(\n ARGS['--api'], ARGS['--source'], ARGS['--target'], ARGS['--force'])\n\n if os.path.isfile(INPUT):\n process_file(INPUT, DEEPL, ARGS['--fuzzy'])\n elif os.path.isdir(INPUT):\n for root, dirs, files in os.walk(INPUT):\n for file in files:\n if file.endswith(\".po\"):\n file_path = os.path.join(root, file)\n process_file(file_path, DEEPL, ARGS['--fuzzy'])\n else:\n pass\n" }, { "path": "Documentation/podl/requirements.in", "content": "# We depend on pip-tools being installed to venv.\n#\n# Add dependencies to this file\n# pip-compile to update requirements.txt\n# pip-sync to update venv\n\ndocopt==0.6.2\nschema==0.7.7\npolib==1.2.0\ndeepl==1.19.1\n" }, { "path": "Documentation/podl/requirements.txt", "content": "#\n# This file is autogenerated by pip-compile with Python 3.10\n# by the following command:\n#\n# pip-compile requirements.in\n#\ncertifi==2024.8.30\n # via requests\ncharset-normalizer==3.4.0\n # via requests\ndeepl==1.19.1\n # via -r requirements.in\ndocopt==0.6.2\n # via -r requirements.in\nidna==3.10\n # via requests\npolib==1.2.0\n # via -r requirements.in\nrequests==2.32.3\n # via deepl\nschema==0.7.7\n # via -r requirements.in\nurllib3==2.2.3\n # via requests\n" }, { "path": "Documentation/public/arhitektuur/Makefile", "content": "include ../../common.mk\n" }, { "path": "Documentation/public/arhitektuur/etcd.rst", "content": ".. IVXV arhitektuur\n\nLisa - ETCD Andmemudel\n======================\n\nETCD on võti-väärtus andmebaas, kus talletatakse e-hääletamise\nsisendnimekirju, e-hääli ning statistikat.\n\nRingkondade nimekiri\n--------------------\n\n.. table:: Ringkondade nimekiri\n :widths: 30 35 35\n\n +----------------------------+---------------------------+-----------------------+\n | **Võti** | **Väärtus** | **Näide** |\n +============================+===========================+=======================+\n | /districts | Juurvõti | |\n +----------------------------+---------------------------+-----------------------+\n | /districts/ | Seab valija | /districts/05241 |\n | | EHAK-ringkond paarile | |\n | | vastavusse | 0000.1 |\n | | ringkonnaidentifikaatori, | |\n | | mis viitab /choices | |\n | | harusse | |\n +----------------------------+---------------------------+-----------------------+\n | /districts/counties | Väli counties | { |\n | | ringkondade | |\n | | nimekirjast | \"0068\": [ |\n | | | |\n | | | \"0809\", |\n | | | |\n | | | \"0624\" |\n | | | |\n | | | ], |\n | | | |\n | | | \"0784\": [ |\n | | | |\n | | | \"0524\" |\n | | | |\n | | | ], |\n | | | |\n | | | \"0079\": [ |\n | | | |\n | | | \"0796\" |\n | | | |\n | | | ], |\n | | | |\n | | | \"0793\": [ |\n | | | |\n | | | \"0793\" |\n | | | |\n | | | ] |\n | | | |\n | | | } |\n +----------------------------+---------------------------+-----------------------+\n | /districts/version | Nimekirja | [\"NIMESTE,NIMI,123456 |\n | | allkirjastajad | 78912 |\n | | | 2019-02-22T13:58:48Z\" |\n | | | ] |\n +----------------------------+---------------------------+-----------------------+\n\nValikute nimekiri\n-----------------\n\n.. table:: Valikute nimekiri\n :widths: 30 35 35\n\n +------------------------+-----------------------+-----------------------+\n | **Võti** | **Väärtus** | **Näide** |\n +========================+=======================+=======================+\n | /choices | Juurvõti | |\n +------------------------+-----------------------+-----------------------+\n | /choices/ | Ringkonnale | /choices/0000.1 |\n | | district-id vastav | |\n | | valikute nimekiri. | { |\n | | | |\n | | | \"Erakond 1\":{ |\n | | | |\n | | | \"0000.101\":\"Nimi |\n | | | Nimeste1\", |\n | | | |\n | | | \"0000.102\":\"Nimi |\n | | | Nimeste2\", |\n | | | |\n | | | \"0000.103\":\"Nimi |\n | | | Nimeste3\" |\n | | | |\n | | | }, |\n | | | |\n | | | \"Erakond 2\":{ |\n | | | |\n | | | \"0000.104\":\"Nimi |\n | | | Nimeste4\", |\n | | | |\n | | | \"0000.105\":\"Nimi |\n | | | Nimeste5\" |\n | | | |\n | | | }, |\n | | | |\n | | | \"Üksikkandidaadid\":{ |\n | | | |\n | | | \"0000.106\":\"Nimi |\n | | | Nimeste6\" |\n | | | |\n | | | } |\n | | | |\n | | | } |\n +------------------------+-----------------------+-----------------------+\n | /choices/version | Nimekirja | [\"NIMESTE,NIMI,123456 |\n | | allkirjastajad | 78912 |\n | | | 2019-02-22T13:58:59Z\" |\n | | | ] |\n +------------------------+-----------------------+-----------------------+\n\nValijate nimekiri\n-----------------\n\n.. table:: Valijate nimekiri\n :widths: 30 35 35\n\n +---------------------------------+-----------------------+-----------------------+\n | **Võti** | **Väärtus** | **Näide** |\n +=================================+=======================+=======================+\n | /voters | Juurvõti | |\n +---------------------------------+-----------------------+-----------------------+\n | /voters/ | Valijanimekirja | /voters/1 |\n | | versiooni juurvõti | |\n +---------------------------------+-----------------------+-----------------------+\n | /voters// | Valija | /voters/1/12345678912 |\n | | antud | |\n | | nimekirjas | 05241 |\n +---------------------------------+-----------------------+-----------------------+\n | /voters//version | Valijatenimekirja | [\"NIMESTE,NIMI,123456 |\n | | versioon | 78912 |\n | | | 2019-02-22T13:58:59Z\" |\n | | | ] |\n +---------------------------------+-----------------------+-----------------------+\n | /voters/version | Aktuaalse | 1 |\n | | valijatenimekirja | |\n | | versiooni ID | |\n +---------------------------------+-----------------------+-----------------------+\n | /voters/previous | Eelmise | 0 |\n | | valijanimekirja | |\n | | versiooni ID | |\n +---------------------------------+-----------------------+-----------------------+\n\nTalletatud e-hääl\n-----------------\n\n.. table:: Talletatud e-hääl\n :widths: 30 35 35\n\n +-------------------------+------------------------+-----------------------+\n | **Võti** | **Väärtus** | **Näide** |\n +=========================+========================+=======================+\n | /vote | Juurvõti | |\n +-------------------------+------------------------+-----------------------+\n | /vote/ | Hääle juurvõti, | 16 baiti binaarandmed |\n | | unikaalne | |\n | | identifikaator | |\n +-------------------------+------------------------+-----------------------+\n | /vote//count | Hääle kontrollimise | 0 |\n | | loendur | |\n +-------------------------+------------------------+-----------------------+\n | /vote//ocsp | Kehtivuskinnitus | DER kodeeringus OCSP |\n | | | vastus |\n +-------------------------+------------------------+-----------------------+\n | /vote//time | Hääle talletamise | 2019-03-03T10:56:28.8 |\n | | kellaaeg | 99925926Z |\n +-------------------------+------------------------+-----------------------+\n | /vote//tspreg | Registreerimiskinnitus | DER kodeeringus PKIX |\n | | | ajatempel |\n +-------------------------+------------------------+-----------------------+\n | /vote//type | Allkirjastatud hääle | BDOC |\n | | konteineri tüüp | |\n +-------------------------+------------------------+-----------------------+\n | /vote//version | Hääle andmisel | 0 |\n | | kehtinud valijate | |\n | | nimekirja versiooni | |\n | | ID | |\n +-------------------------+------------------------+-----------------------+\n | /vote//vote | E-hääl allkirjastatud | BDOC vormingus |\n | | konteineris | allkirjastatud hääl |\n +-------------------------+------------------------+-----------------------+\n | /vote//voter | Valija isikukood | 12345678912 |\n +-------------------------+------------------------+-----------------------+\n\nStatistikaliidesed\n------------------\n\n.. table:: Statistikaliidesed\n :widths: 30 35 35\n\n +-------------------------------+-----------------------+-----------------------+\n | **Võti** | **Väärtus** | **Näide** |\n +===============================+=======================+=======================+\n | /votes | Juurvõti | |\n +-------------------------------+-----------------------+-----------------------+\n | /votes/order | Hääletamisfaktide | |\n | | järjestuse juurvõti | |\n +-------------------------------+-----------------------+-----------------------+\n | /votes/order/ | Konkreetse | /votes/order/1 |\n | | hääletamisfakti | |\n | | juurvõti | |\n +-------------------------------+-----------------------+-----------------------+\n | /votes/order//admincode | Hääletamisfaktiga | 0796 |\n | | seotud EHAK | |\n +-------------------------------+-----------------------+-----------------------+\n | /votes/order//district | Hääletamisfaktiga | 10 |\n | | seotud ringkonna | |\n | | number | |\n +-------------------------------+-----------------------+-----------------------+\n | /votes/order//voterid | Hääletaja isikukood | 12345678901 |\n | | | |\n +-------------------------------+-----------------------+-----------------------+\n | /votes/order//votername | Hääletaja nimi | NIMI NIMESTE |\n | | | |\n +-------------------------------+-----------------------+-----------------------+\n | /votes/stats | Viimase | 12 |\n | | hääletamisfakti | |\n | | järjekorranumber | |\n +-------------------------------+-----------------------+-----------------------+\n | /voted | Juurvõti | |\n +-------------------------------+-----------------------+-----------------------+\n | /voted/latest | Viimati antud häälte | |\n | | indeksi juurvõti | |\n +-------------------------------+-----------------------+-----------------------+\n | /voted/latest/ | Hääletaja poolt | /voted/latest/1234567 |\n | | viimati antud hääle | 8901 |\n | | aeg ja identifikaator | |\n | | binaarkujul | <2019-03-03T12:15:59Z |\n | | | > |\n +-------------------------------+-----------------------+-----------------------+\n | /voted/stats | Jaoskonnapõhise | |\n | | statistika indeksi | |\n | | juurvõti | |\n +-------------------------------+-----------------------+-----------------------+\n | /voted/stats/ | Hääle andmise | /voted/stats/12345678 |\n | | kellaaeg koos | 901 |\n | | jaoskonnainfoga | |\n | | | <0796><2019-02-22T14: |\n | | | 17:23Z> |\n +-------------------------------+-----------------------+-----------------------+\n | /votes/voter/stats/ | Tühi baitide massiiv | /votes/voter/stats/ |\n | | (kasutatakse väärtuse | 394091044211 |\n | | versiooni, ning mitte | |\n | | väärtust ennast) | |\n +-------------------------------+-----------------------+-----------------------+\n\nHääletamisseansid\n-----------------\n\n.. table:: Hääletamisseansid\n :widths: 30 35 35\n\n +-----------------------+-----------------------+---------------------------+\n | **Võti** | **Väärtus** | **Näide** |\n +=======================+=======================+===========================+\n | /session | Juurvõti | |\n +-----------------------+-----------------------+---------------------------+\n | /session/ | RPC meetod, mis | ``/session/0149468d2866`` |\n | | kutsus antud | ``6fced7d73b32cc16225d`` |\n | | funktsiooni välja + | |\n | | ``x1F`` + kasutaja | |\n | | autentimismeetod | |\n +-----------------------+-----------------------+---------------------------+\n" }, { "path": "Documentation/public/arhitektuur/index.rst", "content": ".. IVXV arhitektuur\n\nIVXV arhitektuur\n========================================================\n\n.. raw:: html\n\n

\n NB!\n See on HTML-versioon dokumendist.\n Tellijale antakse üle PDF-versioon.\n

\n\n.. toctree::\n :maxdepth: 3\n :numbered:\n\n yldpohimotted\n kogumisteenus\n vallasrezhiim\n tehnoloogiad\n\n etcd\n viited\n" }, { "path": "Documentation/public/arhitektuur/kogumisteenus.rst", "content": ".. IVXV arhitektuur\n\nKogumisteenus\n=============\n\nÜldkirjelduse [ÜK2016]_ põhjal on Kogumisteenus:\n\n.. epigraph::\n\n Süsteemi keskne komponent, mida käitab Koguja. Teenus abistab Hääletajat\n e-hääle koostamisel ning registreerib selle enne salvestamist e-valimiskasti.\n Kogumisteenus kasutab väliseid teenuseid (tuvastamine, allkirjastamine,\n registreerimine). Kogumisteenusel on peale Koguja enda teisigi haldureid\n (Korraldaja, Klienditugi), kelle jaoks on Kogumisteenusel eraldi\n haldusliidesed.\n\nKogumisteenus töötab sidusrežiimis ning vähemalt valija- ja kontrollrakenduse\nsuunalised liidesed on avatud internetile. Seega töötleb Kogumisteenus\npotentsiaalselt ebausaldusväärsest allikast pärit päringuid. Tulenevalt\ntarkvarale seatavast turvatasemest, kõrgkäideldavuse, skaleeritavuse, kihilise\nevitatavuse ning laiendatavuse nõuetest on kogumisteenus omakorda liigendatud\nühte konkreetset teenust osutavateks mikroteenusteks, mida on võimalik\npaindlikult evitada.\n\nKõik kogumisteenuse komponendid programmeeritakse keeles `Go\n`_. Keelel Go on:\n\n- staatiline tüüpimine, mis võimaldab tüübivigade avastamist enne programmi\n käivitamist;\n\n- automaatne mäluhaldus, mis välistab rakenduse vigasest mäluhaldusest\n tulenevad turvaaugud;\n\n- kompilaator avatud lähtekoodiga;\n\n- ribastamine/rööprapse, mis võimaldab kasutada paralleelsust mitmetuumalistes\n süsteemides.\n\nKogumisteenuse andmeedastuseks kasutatakse üldjuhul JSON-vormingut, välja\narvatud olukordades, kus välised asjaolud tingivad mõne muu andmevormingu\nkasutamist (näiteks BDOC-vorming põhineb XML'il).\n\nKogumisteenus toetab Riigikogu valimisi, kohaliku omavalitsuse volikogu\nvalimisi, Euroopa parlamendi valimisi ning rahvahääletusi.\n\nKogumisteenuse komponendid arvestavad virtualiseerimistehnoloogiate\nkasutamisega ning kogumisteenust on võimalik evitada nii ühel virtuaalriistvara\ninstantsil, kui ka mikroteenuste kaupa erinevatel instantsidel. Kogumisteenuse\nkomponendid on evitatavad Ubuntu 22.04 LTS (Jammy Jellyfish)\noperatsioonisüsteemil 64-bitisel arhitektuuril.\n\nAndmesäilitus on teostatud kasutades võti-väärtus andmebaasi (etcd).\nTestotstarbel on teostatud ka andmesäilitus failisüsteemi ning mällu, kuid neid\nei ole soovituslik kasutada tootekeskkonnas. Lisaks on kogumisteenusel olemas\nliides uute talletusprotokollide lisamiseks. Lõplik otsus kasutatava lahenduse\nkohta tehakse kogumisteenuse haldurite poolt teenust seadistades.\n\nMikroteenused\n-------------\n\n.. figure:: model/img/collector_microservices.png\n\n Kogumisteenuse jaotus mikroteenusteks\n\nKogumisteenus on jaotatud põhiteenusteks ja abiteenusteks. Põhiteenused -\nvahendusteenus, nimekirjateenus, hääletamisteenus, kontrollteenus ning\ntalletamisteenus - on arhitektuuri tehnilise lihtsuse mõttes piiritletud ühe\nvalimisega, kuid ühel riistvaral, ühe operatsioonisüsteemi kontekstis võivad\nkäia mitme valimise mikroteenused. Täiendavalt võib kogumisteenuse juures\nkasutada abiteenuseid - tuvastusteenust hääletaja isiku tuvastamiseks ning\nallkirjateenust valijarakenduse poolt hääle allkirjastamise hõlbustamiseks.\n\nTeenuseid on võimalik evitada nii eraldatult kui koos erinevates\nkonfiguratsioonides, mis teeb võimalikuks kihilise arhitektuuri. Lähtudes\nfunktsioonist on otstarbekas hoida Vahendus- ning Talletamisteenused teistest\neraldi.\n\nTeenused kasutavad transpordiprotokollina TLS'i, ühendused on\nvähemalt serveripoolselt autenditud. Rakenduskihi protokoll on JSON-RPC.\n\nKõik teenused tekitavad tegevuslogi, mida säilitatakse nii lokaalselt kui\nlogitakse syslog protokolli vahendusel kesksesse logikogujasse.\n\nVahendusteenuse funktsioon ja tehniline liides\n``````````````````````````````````````````````\n\nVahendusteenuse põhifunktsioon on ühe sisenemispunkti (port 443) pakkumine\nValijarakendusele ja Kontrollrakendusele. Vahendusteenus on dispetšerteenus\nteiste komponentide vahel, mis võimaldab sisemiselt evitada kogumisteenust\nmikroteenustena, ent omada süsteemil ainult ühte sisenemispunkti. Lisaks suudab\nsee dubleeritud evituse puhul täita koormusjaoturi ülesannet.\n\nVahendusteenus ei termineeri TLS-ühendust vaid kasutab sihtpunkti tuvastamiseks\nTLS'i *Server Name Indication* (SNI) laiendust. Kliendid panevad TLS\n``ClientHello`` sõnumisse SNI-laiendi, kus avatekstis määravad, millise\nteenusega soovivad suhelda: vahendusteenus näeb seda, võtab ühendust vastavat\nteenust pakkuva isendiga ja hakkab kliendi ning teenuse vahelisi sõnumeid\nvahendama. Vahendusteenus EI termineeri TLS'i ning ei näe sõnumite sisu.\nVahendusteenusel on andmed kõigi teiste teenuste asukohtadest (aadress:port)\nning teenus vahendab sõnumivahetust kõigi osapoolte vahel.\n\nVahendusteenus on olekuvaba komponent, mida on võimalik horisontaalselt\nskaleerida.\n\nVahendusteenuse teostus\n'''''''''''''''''''''''\n\nVahendusteenuse teostus kasutab vabavaralist HAProxy serverit, mis on\nüldlevinud tarkvaraline koormusjaotur ja proksi. Kuna Vahendusteenus on\nesimene puutepunkt avalikust internetist tulevate ühenduste jaoks, siis on\nmõistlik kasutada tarkvara, mille töökindlus on juba tõestatud.\n\nKuigi HAProxyt kasutatakse tihti HTTP-režiimis, kus see analüüsib liiklust,\nsiis vahendusteenuse rollis on see TCP-režiimis ning ei näe vahendatava\nkrüpteeritud TLS-kanali sisse.\n\nIVXV seadistusest genereeritakse HAProxy seadistusfail, mis sisaldab teiste\nteenuste asukohti, ning ühenduste vahendamise ülesanne jääb viimase kanda.\nLisaks on võimalik HAProxyt ka seadistada ühenduste sagedusi piirama\nlähteaadressi või mõne muu nimetaja põhjal. See aga jääb süsteemihalduri\nülesandeks.\n\nKuigi HAProxy on võimeline ise teostama koormusjaoturi ülesannet, on seda\nvõimalik evitada ka teiste, potentsiaalselt riistvaraliste koormusjaoturite\ntaha, kus see jääb täitma ainult SNI põhjal vahendamise ülesannet.\n\nHAProxy lähtekood on avalik ja sobiva litsentsiga ning pakendatud\nkogumisteenuse alusplatvormi ametlikus hoidlas (vt. :ref:`tehnoloogiad`).\n\nNimekirjateenuse funktsioon ja tehniline liides\n```````````````````````````````````````````````\n\nNimekirjateenuse põhifunktsioon on valikute nimekirjade vahendamine\nValijarakendusele. Nimekirjateenusesse jõuab informatsioon tuvastatud valija\nkohta ning Nimekirjateenus väljastab valija ringkonnale vastava valikute\nnimekirja Talletamisteenusest Valijarakendusse.\n\nNimekirjateenus on olekuvaba komponent, mida on võimalik horisontaalselt\nskaleerida.\n\nKontrollteenuse funktsioon ja tehniline liides\n``````````````````````````````````````````````\n\nKontrollteenuse põhifunktsioon on kontrollpäringute töötlemine ning\nkontrollitava hääle väljastamine Talletamisteenusest Kontrollrakendusse.\n\nKontrollteenus on olekuvaba komponent, mida on võimalik horisontaalselt\nskaleerida.\n\nHääletamisteenuse funktsioon ja tehniline liides\n````````````````````````````````````````````````\n\nHääletamisteenuse põhifunktsioon on hääletamispäringute töötlemine.\nHääletamisteenus verifitseerib sissetuleva hääle, registreerib selle\nRegistreerimisteenuses ning talletab Talletamisteenusesse.\n\nHääletamisteenus on olekuvaba komponent, mida on võimalik horisontaalselt\nskaleerida.\n\nTalletamisteenuse funktsioon ja tehniline liides\n`````````````````````````````````````````````````\n\nTalletamisteenuse põhifunktsioon on valikute ja valijanimekirjade ning\nhäälte pikaajaline talletamine.\n\nTalletamisteenuse horisontaalseks skaleerimiseks kasutatakse\nhajustalletamist võimaldavat säilitustehnoloogiat.\n\nTalletamisteenuse teostus\n'''''''''''''''''''''''''\n\nTalletamisteenus ei ole teadlik IVXV protokollist ega talletatavate andmete\nspetsiifikast, vaid on üldkasutatav võti-väärtus andmebaas binaarandmete\nsäilitamiseks. Kogu teadmus talletatavate andmete struktuurist ja võtmete\nhierarhiast on teistes, Talletamisteenust kasutatavates teenustes, mis\nkäituvad nii-öelda \"tarkade\" klientidena.\n\nSelline lähenemine lubab ilma suurema vaevata kasutada Talletamisteenusena\nükskõik millist üldlevinud võti-väärtus andmebaasi: ainsateks ülesanneteks on\nIVXV seadistuse teisendamine andmebaasi jaoks sobilikku vormingusse ning\nteenuse käivitamine. Andmebaasi tarkvara peab võimaldama vaid võtme järgi\ntalletamist ja lugemist, võtmete prefiksi järgi loetlemist ning atomaarset\nvõrdle-ja-vaheta (*compare-and-swap*) operatsiooni.\n\nTalletamisteenus on kogumisteenuse töökiiruse oluliseks määrajaks, mistõttu\nmõjutab seda teenust pakkuv riistvara kogu süsteemi jõudlust ning see tuleks\nvastavalt kasutatavale andmebaasile dimensioneerida.\n\nHetkel ainus tooteks mõeldud Talletamisteenuse teostus kasutab hajusat\nvõti-väärtus andmebaasi etcd. Selle puhul tuleks järgida etcd autorite\n`riistvara soovitusi\n`_.\n\nTuvastusteenuse funktsioon ja tehniline liides\n``````````````````````````````````````````````\n\nTuvastusteenuse põhifunktsioon on valija identiteedi tuvastamine.\nTuvastusteenus on vajalik näiteks Mobiil-ID autentimise korral.\n\nWeb-eID abiteenuse teostus\n''''''''''''''''''''''''''\n\nIVXV koosseisu kuulub Web-eID abiteenus, mis realiseerib Tuvastusteenuse\nID-kaardi kasutamiseks Web-eID raamistikus.\n\nEduka Web-eID isikutuvastuse korral väljastab abiteenus Valijarakendusele\npileti, mille abil on võimalik teistele teenustele valija identiteeti\nkinnitada. Iga piletiga saab hääletada ainult ühe korra.\n\nWeb-eID ei paku allkirjateenust, hääle allkirjastamine toimub Valija seadmes\nlokaalselt analoogselt klassikalisele ID-kaardiga\nautentimisele/allkirjastamisele.\n\nWeb-eID abiteenus on olekuvaba komponent. Tänu sellele on võimalik Web-eID\nabiteenust horisontaalselt skaleerida.\n\n\nAllkirjateenuse funktsioon ja tehniline liides\n``````````````````````````````````````````````\n\nAllkirjateenuse funktsioon on Valijarakenduse toetamine hääle\nallkirjastamisel. Allkirjateenus on vajalik näiteks Mobiil-ID allkirjastamise\nkorral.\n\nMobiil-ID abiteenuse teostus\n''''''''''''''''''''''''''''\n\nIVXV koosseisu kuulub Mobiil-ID abiteenus, mis käitub Mobiil-ID jaoks nii\nTuvastusteenusena kui ka Allkirjateenusena. Valijarakendus esitab IVXV\npäringud Mobiil-ID abiteenusele, mis teisendab need Mobiil-ID päringuteks ning\nedastab Mobiil-ID teenusepakkujale.\n\nEduka Mobiil-ID isikutuvastuse korral väljastab abiteenus Valijarakendusele\npileti, mille abil on võimalik teistele teenustele valija identiteeti\nkinnitada. Iga piletiga saab hääletada ainult ühe korra.\n\nAllkirjastamise korral saadab Valijarakendus Mobiil-ID abiteenusele vaid\nallkirjastatava hääle räsi ning kasutab vastuseks saadud signatuuri samamoodi\nkui ID-kaardiga loodud signatuuri.\n\nMobiil-ID abiteenus sisaldab küll olekut pooleliolevate tuvastusseansside\nkohta, aga muus osas on tegu olekuvaba komponendiga. Tänu sellele on võimalik\nMobiil-ID abiteenust horisontaalselt skaleerida.\n\nSmart-ID abiteenuse teostus\n'''''''''''''''''''''''''''\n\nIVXV koosseisu kuulub Smart-ID abiteenus, mis käitub Smart-ID jaoks nii\nTuvastusteenusena kui ka Allkirjateenusena. Valijarakendus esitab IVXV\npäringud Smart-ID abiteenusele, mis teisendab need Smart-ID päringuteks ning\nedastab Smart-ID teenusepakkujale.\n\nEduka Smart-ID isikutuvastuse korral väljastab abiteenus Valijarakendusele\npileti, mille abil on võimalik teistele teenustele valija identiteeti\nkinnitada. Iga piletiga saab hääletada ainult ühe korra.\n\nAllkirjastamise korral saadab Valijarakendus Smart-ID abiteenusele vaid\nallkirjastatava hääle räsi ning kasutab vastuseks saadud signatuuri samamoodi\nkui ID-kaardiga loodud signatuuri.\n\nSmart-ID abiteenus sisaldab küll olekut pooleliolevate tuvastusseansside\nkohta, aga muus osas on tegu olekuvaba komponendiga. Tänu sellele on võimalik\nSmart-ID abiteenust horisontaalselt skaleerida.\n\n\nHääletamisfaktide järjekorrateenus\n``````````````````````````````````\n\nHääletamisfaktide järjekorrateenuse põhifunktsiooniks on hääletamisfaktide\nedastamine Valimiste Infosüsteemile X-tee abiteenuse vahendusel.\n\nKogumisteenuse mikroteenuste evitamine\n``````````````````````````````````````\n\nKogumisteenuse mikroteenused sõltuvad välistest pakkidest minimaalselt.\nVajalikud sõltuvused on:\n\n#. SSH-server haldustegevuste läbiviimiseks (seda kasutab mikroteenuste\n haldamiseks haldusteenus).\n\n#. rsyslog logide kogumiseks logikogumisteenustesse.\n\nKogumisteenuse mikroteenused pakendatakse deb-vormingus, neid on võimalik\nevitada ka docker'i-laadsete konteineritena.\n\nVälised teenused ja laiendatavus\n--------------------------------\n\n.. figure:: model/img/collector_extension.png\n\n Kogumisteenuse laiendusmoodulid ja välised teenused\n\nKogumisteenuse mikroteenused kasutavad laiendusmooduleid teostamaks erinevaid\nmehhanisme valija tuvastamiseks, digiallkirjade verifitseerimiseks ja\ntäiendamiseks, sealhulgas hääle registreerimiseks. Laiendusmoodulid võivad\nteostuse võimaldamiseks kasutada väliseid teenuseid. Mikroteenuste\nlaiendatavuse huvides on defineeritud Go API, mille alusel saab teostada\nka täiendavaid mooduleid. Hetkel on teostatud järgmised moodulid:\n\n- Autentimine TLS-sertifikaadiga (ID-kaart);\n\n- Autentimine Tuvastusteenuse piletiga (Mobiil-ID, Smart-ID, Web-eID);\n\n- BDOC verifitseerimine;\n\n- Kehtivuskinnitusteenus OCSP;\n\n- Ajatempliteenus RFC 3161;\n\n- Registreerimisteenus OCSP;\n\n- Registreerimisteenus RFC 3161.\n\nIVXV krüptograafilises protokollis on kesksel kohal Registreerimisteenus, mis\nosaleb samuti häälte pikaajalisel talletamisel.\n\nRegistreerimisteenuse funktsioon\n````````````````````````````````\n\nRegistreerimisteenuse põhifunktsioon on võtta Hääletamisteenuselt vastu\nallkirjastatud registreerimispäringuid, kinnitada need omapoolse allkirjastatud\nvastusega ning säilitada hilisemaks auditeerimiseks vähemalt hääletamisperioodi\nlõpuni.\n\nAuditeerimisel tekkivate võimalike erisuste lahendamiseks on oluline, et\n\n- Registreerimisteenus on võimeline tõestama, et igale tema poolt väljastatud\n kinnitusele eelnes Talletamisteenuse poolne registreerimispäring;\n\n- Talletamisteenus on võimeline tõestama, et iga tema poolt talletatud hääle\n kohta on olemas Registreerimisteenuse kinnitus.\n\nPiisav protokoll sellise tõendamistaseme saavutamiseks on, kus mõlemal\nosapoolel on olemas võtmepaar allkirjastamiseks, päringud ja vastused on\nallkirjastatud ning kumbki pool peab registrit teise poole teadete üle. Selline\nprotokoll on realiseeritav näiteks OCSP-põhise Registreerimisteenuse korral.\nSamas võib esineda juhtumeid, kus näiteks registreerimispäringute\nallkirjastamine ei ole standardsete vahenditega võimalik (RFC 3161 põhine\nregistreerimine). Sellisel juhul tuleb registreerimisteenusele vajalik\ntõendusmaterjal anda muude organisatsioonilis-tehniliste vahenditega.\n\nRegistreerimisteenusel on praegu kaks erinevat teostust:\n\n#. OCSP-liides eeldab Eestis rakendatava OCSP-põhise ajamärgendamisteenuse\n kasutamist, kus allkirjastatud OCSP-päringu nonsiks on Hääletamisteenuse\n poolt pandud hääle räsi. Päring on allkirjastatud standardsete OCSP\n vahenditega;\n\n#. RFC 3161 liides, mille korral ebastandardse lahendusena pannakse\n ajatemplipäringu nonsiks Hääletamisteenuse poolt allkirjastatud hääle räsi.\n\n\nKogumisteenuse laiendusmoodulite lisamine\n`````````````````````````````````````````\n\nKogumisteenuse API defineerib kuute tüüpi laiendusmooduleid:\n\n#. isikutuvastus (Go pakk ``ivxv.ee/auth``, näiteks ``tls``);\n\n#. tuvastatud isiku sertifikaadist valija identifikaatori tuletamine (Go pakk\n ``ivxv.ee/identity``, näiteks ``serialnumber``);\n\n#. valija identifikaatorist vanuse tuletamine (Go pakk ``ivxv.ee/age``, näiteks\n ``estpic``);\n\n#. allkirjastatud konteineri verifitseerimine (Go pakk ``ivxv.ee/container``,\n näiteks ``bdoc``);\n\n#. allkirja kvalifitseerimine (Go pakk ``ivxv.ee/q11n``, näiteks ``tspreg``);\n\n#. andmetalletusprotokoll (Go pakk ``ivxv.ee/storage``, näiteks ``etcd``).\n\nUue mooduli lisamiseks tuleb moodulpakki lisada mooduli identifikaator ning\nmooduli teostusega alampakk. Alampaki alglaadimisel tuleb mooduli\nregistreerimiseks kutsuda välja moodulpaki ``Register`` funktsioon.\n\nUue mooduli kasutamiseks tuleb selle identifikaator lisada seadistusse vastava\nmoodulitüübi seadistuse juurde koos alammooduli seadistusega. Laiendusmoodulile\nantakse ette tema identifikaatoriga viidatud seadistusblokk, mida see\nmooduli-siseselt edasi töötleb.\n\nMoodulpakid ja nende moodulitelt nõutavad liidesed on täpsemalt kirjeldatud\nvastavates lähtekoodifailides. Samuti on iga mooduli kohta olemas vähemalt üks\nteostus, mida saab kasutada eeskujuna.\n\n\nMonitooring\n-----------\n\n.. figure:: model/img/monitoring.png\n\n Monitooringulahendus\n\nLogimine\n````````\n\nIga mikroteenuse poolt genereeritav logi defineeritakse süstemaatiliselt,\nlähtudes protokollikirjeldusest ning teenuse osutamise olekudiagrammist.\nLogitakse minimaalselt:\n\n* iga päringu kättesaamise fakt ning töötlemise algus;\n\n* töötlemise üleandmine välisele komponendile;\n\n* töötlemisjärje naasmine komponenti;\n\n* päringu töötlemise lõpp ning tulemus;\n\n* täiendavalt oluliste etappide läbimine protsessi olekumudelis.\n\nLogimisel järgitakse järgmisi põhimõtteid:\n\n* Logimiseks kasutatakse rsyslog teenust, mis registreerib logiteate\n kirjutamise hetke millisekundi täpsusega;\n\n* Iga seansi alustamisel genereerib süsteem unikaalse identifikaatori, mida\n klientrakendus kasutab oma päringutel kesksüsteemi poole pöördumiseks;\n\n* Kõik ühe seansi alla kuuluvad logikirjed sisaldavad sama\n seansiidentifikaatorit;\n\n* Logikirje on unikaalselt identifitseeritav;\n\n* Iga logitava teate juures on võimalik unikaalse tunnuse abil üksüheselt\n tuvastada teate tekkimise koht monitooritavas süsteemis;\n\n* Logikirje on JSON vormingus, automaatse monitooringu jaoks on masinloetavus\n primaarne ning inimloetavus sekundaarne;\n\n* Logisse minev info saneeritakse (urlencode) ja sellele rakendatakse pikkuse\n piirangut (piirang terve logiteate ja samuti parameetri kaupa);\n\n* Süsteemiperimeetrist väljastpoolt pärinevat infot logitakse ainult\n saneerituna ja ainult etteantud pikkuses.\n\nKuna logimine toimub rsyslog vahendusel, on võimalik Guardtime mooduli\nkasutamine logide tervikluse tagamiseks.\n\n\nÜldstatistika\n`````````````\n\nJärgmise statistika jälgimiseks kasutatakse staatilist veebiliidest:\n\n* edukalt kogutud hääled/hääletajate hulk;\n\n* hääletajate jagunemine sugude, vanusegruppide, operatsioonisüsteemide ning\n autentimisvahendite kaupa;\n\n* edukalt kontrollitud häälte/hääletajate hulk;\n\n* korduvhääletamiste statistika;\n\n* hääletajate jagunemine riigiti IP-aadressi põhjal.\n\n\nDetailstatistika\n````````````````\n\nDetailstatistika agregeeritakse logide põhjal kasutades SCCEIV\nlogianalüsaatorit, mis analüüsib rakenduste tegevuslogi eeldefineeritud\nprofiili suhtes ning võimaldab seansi-/veatüübipõhist analüüsi.\n\nDetailstatistika on kättesaadav üle HTTPS-liidese.\n\n\n.. _kogumisteenuse-haldus:\n\nHaldus\n------\n\nKogumisteenuse haldamine toimub digitaalallkirjastatud seadistuspakkide abil.\n\nKogumisteenus pakub seadistuspakkide laadimiseks kahte liidest:\n\n* Käsurealiides – rakendus verifitseerib allkirja, valideerib korralduste\n vormingut, kooskõlalisust ja sobivust kogumisteenuse seisundi suhtes.\n Korralduse rakendamine toimub eraldi utiliidi abil.\n\n* Veebiliides – veebiliides vahendab seadistuspaki käsurealiidesele ja tagastab\n kasutajale info laadimise tulemuse kohta. Eduka laadimise korral toimub\n automaatselt ja samadel põhimõtetel ka seadistuspaki rakendamine.\n\nVeebiliidese funktsioonideks on:\n\n* Kogumisteenuse mikroteenuste seisundi jälgimine;\n\n* Valimiste nimekirjade haldus;\n\n* Statistika kuvamine e-hääletamise kulgemise kohta;\n\n* Haldusteenuse kasutajate haldus;\n\n* Kogumisteenuse halduse logi kuvamine.\n\nKõik rakendusele antud korraldused säilitatakse - ka need mida ei rakendatud.\nVigaseid (mittevalideeruvaid) korraldusi ei säilitata.\n\nKogumisteenuse haldusteenus sooritab järgmisi tegevusi automaatselt:\n\n#. Valijate nimekirjade muudatuste laadimine Valimiste Infosüsteemist;\n\n#. Hääletamise statistika kogumine hääletusteenusest ja eksportimine Valimiste\n Infosüsteemi;\n\n#. Talletatud häälte, logide ning seadistuste varundamine varundusteenusesse.\n\n\nHaldusteenuse komponendid\n`````````````````````````\n\n.. figure:: model/img/ms-management-service-components.png\n\n Kogumisteenuse haldusteenuse komponendid\n\n#. **Halduse veebiserver** on süsteemse kasutaja ``www-data``\n õigustes töötav Apache server, mille ülesanded on:\n\n #. Kasutajatelt tulevate HTTPS-päringute esmane teenindamine:\n\n #. Haldusteenuse usaldusväärsuse tõestamine (TLS-sertifikaat);\n\n #. Kasutajate autentimine;\n\n #. Valmisgenereeritud veebilehtede ja andmefailide serveerimine\n andmehoidlast.\n\n #. Üldiste taustaandmete päringu vastuse varustamine sisseloginud kasutaja\n andmetega (WSGI).\n\n #. Üleslaaditavate korralduste esmane valideerimine ja vahendamine\n haldusdeemonile ning haldusdeemoni sellekohaste vastuste vahendamine\n kliendile (WSGI).\n\n#. **Haldusdeemon** on kasutajakonto ``ivxv-admin`` õigustes töötav ja\n kohalikul (``localhost``) liidesel kuulav veebiserver mille ülesanded on:\n\n #. Üleslaaditavate korralduste valideerimine;\n\n #. Üleslaaditavate korralduste vahetu rakendamine (kasutajate haldus);\n\n #. Üleslaaditavate korralduste salvestamine hilisemaks rakendamiseks\n (seadistuse ja valimisnimekirjade rakendamiseks teenusele);\n\n #. E-valimiskasti allalaadimise vahendamine.\n\n#. **Agentdeemon** on kasutajakonto ``ivxv-admin``\n õigustes töötav deemon, mille ülesanded on:\n\n #. Andmete kogumine ja registreerimine:\n\n #. Teadaolevate mikroteenuste seisund;\n\n #. Tegevusmonitooringu statistika allalaadimine;\n\n#. **Andmehoidla** on failisüsteemis asuv kataloog, kuhu haldusteenuse\n komponendid hoiavad kogutud ja genereeritud andmeid (vaata üksikasjalist\n kirjeldust ``IVXV kogumisteenuse haldusjuhendi`` lisadest);\n\nVälised komponendid, millega haldusteenus kokku puutub:\n\n#. **Kogumisteenuse alamteenused** - paigaldamine, seadistamine ja seisundi\n andmete kogumine toimub agentdeemoni kaudu (SSH-ühendus teenuse masinasse);\n\n#. **Seireserver** - üldstatistika andmete allalaadimine haldusteenuses\n kuvamiseks;\n\n.. figure:: model/img/ms-upload-command.png\n\n Korralduste laadimine haldusteenusesse\n\n\nKogumisteenuse seisundid\n------------------------\n\nKogumisteenuse seisund kajastab teenuse kõigi alamteenuste seisundit,\nkasutuselolevate väliste teenuste seisundit ja eelneva põhjal tuletatud\nüldseisundit. Kogumisteenuse üldseisundi tuvastamisega tegeleb haldusteenus.\n\nÜldseisundi olekud on:\n\n#. **Paigaldamata** - alates haldusteenuse paigaldamisest kuni kõigi\n alamteenuste paigaldamiseni;\n\n#. **Paigaldatud** - kõik alamteenused on paigaldatud, neile on rakendatud\n tehnilised seadistused ja teenuse toimimiseks vajalikud krüptovõtmed.\n Valimiste seadistust pole rakendatud (kuid see võib olla laaditud\n haldusteenusesse);\n\n#. **Seadistatud** - kogumisteenus on seadistatud ja töökorras, sellega on\n võimalik häälte kogumist läbi viia ja e-valimiskasti väljastada.\n\n#. **Osaline tõrge** - kogumisteenus on seadistatud ja osaliselt töökorras,\n mõned alamteenused pole töökorras, kuid see ei takista kogumisteenuse\n toimimist.\n\n#. **Tõrge** - kogumisteenuse oluline sõlm pole töökorras, teenuse nõuetekohane\n osutamine pole võimalik.\n\n.. figure:: model/img/ms-collector-status.png\n :scale: 50%\n\n Kogumisteenuse olekudiagramm. Olekud vastavalt värvusele: kollane -\n seadistamisel, punane - viga, roheline - töökorras.\n\n\nKogumisteenuse alamteenuste seisundid\n`````````````````````````````````````\n\n.. figure:: model/img/ms-service-status.png\n :scale: 50%\n\n Haldusteenuse poolt registreeritud alamteenuse olekudiagramm. Olekud\n vastavalt värvusele: kollane - seadistamisel, punane - viga, roheline -\n töökorras.\n\n\nKogumisteenuse seisundi muutused\n````````````````````````````````\n\nKogumisteenuse seisund on jälgitav alates haldusteenuse edukast\npaigaldamisest, algne seisund on **Paigaldamata**.\n\n\nPaigaldamata\n''''''''''''\n\nToimub usaldusjuure ja tehnilise seadistuse rakendamine kogumisteenusele:\n\n#. Seadistuste laadimine kogumisteenusesse;\n\n#. Tehnilises seadistuses kirjeldatud alamteenuste paigaldus;\n\n#. Usaldusjuure ja tehniliste seadistuste rakendamine alamteenustele;\n\nSeadistuste eduka rakendamise tulemusena saab süsteemi uueks seisundiks\n**Paigaldatud**.\n\n\nPaigaldatud\n'''''''''''\n\nKogumisteenuse seadistused on rakendatud kõigile alamteenustele, valimiste\nseadistused pole rakendatud. Toimub valimiste seadistuse laadimine\nhaldusteenusesse ja rakendamine alamteenustele.\n\nValimiste seadistuse eduka rakendamise korral saab süsteemi uueks seisundiks\n**Seadistatud**.\n\n\nSeadistatud\n'''''''''''\n\nKõik kogumisteenuse alamteenused on seadistatud ja töökorras. Haldusteenusel on\nkõikidest alamteenustest värsked seisundiraportid. Süsteemiga on võimalik\nhääletust läbi viia ja e-valimiskasti väljastada.\n\nKui süsteemis tuvastatakse tõrge, saab süsteemi uueks **Osaline tõrge**.\n\n**Seadistatud** olekust ei pöörduta enam kunagi tagasi olekutesse\n**paigaldamata** või **paigaldatud**, kuigi uute alamteenuste lisamisel (kuni\nneed on olekus **paigaldamata/paigaldatud**) oleks vastavad tingimused\ntäidetud.\n\n\nOsaline tõrge\n'''''''''''''\n\nSüsteem on seadistatud ja osaliselt töökorras, mõned süsteemi dubleeritud osad\npole töökorras, kuid see ei takista süsteemil toimimast.\n\nRikke süvenemisel piirini, kus süsteem pole võimeline teenust osutama, saab\nsüsteemi uueks olekuks **Tõrge**. Kõigi rikete kõrvaldamise järel saab\nsüsteemi uueks olekuks **Seadistatud**.\n\n\nTõrge\n'''''\n\nSeadistatud süsteemil on tuvastatud rike, mis takistab teenuse osutamist.\n\nRikete kõrvaldamisel olukorrani, kus süsteemiga on võimalik teenust osutada,\nsaab süsteemi uueks olekuks **Osaline tõrge**.\n\n\nEemaldatud\n''''''''''\n\nTeenus on konfiguratsioonist eemaldatud.\n\n\nValijate nimekirjade olekud haldusteenuses\n------------------------------------------\n\nValijate nimekirja olek võib olla:\n\n#. **Rakendamise ootel** - nimekiri on laaditud haldusteenusesse;\n\n#. **Rakendatud** - nimekiri on rakendatud kogumisteenusele;\n\n#. **Vigane** - nimekiri on märgitud vigaseks, haldusteenus uusi valijate\n nimekirjade muudatusi ei laadi;\n\n#. **Vahele jäetud** - vigane nimekiri on märgitud vahelejätmiseks.\n\n.. figure:: model/img/ms-voter-list-status.png\n\n Valijate nimekirja olekudiagramm\n\nSiirdeprotsessid:\n\n#. Nimekirja laadimine haldusteenusesse:\n\n Algnimekirja laadib kogumisteenuse operaator, nimekirja olekuks saab\n **Rakendamise ootel**;\n\n Muudatusnimekirja laadib haldusteenus. Vastavalt valideerimise tulemusele\n saab nimekirja olekuks kas **Rakendamise ootel** või **Vigane**;\n\n#. **Rakendamine kogumisteenusele**: viib läbi haldusteenus **rakendamise\n ootel** olekus nimekirjaga. Õnnestumisel määratakse nimekirja olekuks\n **Rakendatud**, vea korral **Vigane**;\n\n#. **Vahelejätmine**: operaator määrab olekuga **Vigane** nimekirjale oleku\n **Vahele jäetud**.\n" }, { "path": "Documentation/public/arhitektuur/locales/en/LC_MESSAGES/etcd.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-03 15:28+0000\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language: en\\n\"\n\"Language-Team: en \\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../etcd.rst:4\nmsgid \"Lisa - ETCD Andmemudel\"\nmsgstr \"Appendix - ETCD datamodel\"\n\n#: ../../etcd.rst:6\nmsgid \"\"\n\"ETCD on võti-väärtus andmebaas, kus talletatakse e-hääletamise \"\n\"sisendnimekirju, e-hääli ning statistikat.\"\nmsgstr \"\"\n\"ETCD is key-value database used for storing input lists, votes and \"\n\"statistics of online voting\"\n\n#: ../../etcd.rst:10 ../../etcd.rst:12\nmsgid \"Ringkondade nimekiri\"\nmsgstr \"List of districts\"\n\n#: ../../etcd.rst:16 ../../etcd.rst:70 ../../etcd.rst:123 ../../etcd.rst:155\n#: ../../etcd.rst:196 ../../etcd.rst:258\nmsgid \"**Võti**\"\nmsgstr \"**Key**\"\n\n#: ../../etcd.rst:16 ../../etcd.rst:70 ../../etcd.rst:123 ../../etcd.rst:155\n#: ../../etcd.rst:196 ../../etcd.rst:258\nmsgid \"**Väärtus**\"\nmsgstr \"**Value**\"\n\n#: ../../etcd.rst:16 ../../etcd.rst:70 ../../etcd.rst:123 ../../etcd.rst:155\n#: ../../etcd.rst:196 ../../etcd.rst:258\nmsgid \"**Näide**\"\nmsgstr \"**Example**\"\n\n#: ../../etcd.rst:18\nmsgid \"/districts\"\nmsgstr \"/districts\"\n\n#: ../../etcd.rst:18 ../../etcd.rst:72 ../../etcd.rst:125 ../../etcd.rst:157\n#: ../../etcd.rst:198 ../../etcd.rst:224 ../../etcd.rst:260\nmsgid \"Juurvõti\"\nmsgstr \"Rootkey\"\n\n#: ../../etcd.rst:20\nmsgid \"/districts/\"\nmsgstr \"/districts/\"\n\n#: ../../etcd.rst:20\nmsgid \"\"\n\"Seab valija EHAK-ringkond paarile vastavusse ringkonnaidentifikaatori, \"\n\"mis viitab /choices harusse\"\nmsgstr \"\"\n\"Connects voter's EHAK-district pair with district identifier referring to\"\n\" the /choices branch\"\n\n#: ../../etcd.rst:20\nmsgid \"/districts/05241\"\nmsgstr \"/districts/05241\"\n\n#: ../../etcd.rst:22\nmsgid \"0000.1\"\nmsgstr \"0000.1\"\n\n#: ../../etcd.rst:27\nmsgid \"/districts/counties\"\nmsgstr \"/districts/counties\"\n\n#: ../../etcd.rst:27\nmsgid \"Väli counties ringkondade nimekirjast\"\nmsgstr \"Field counties from the district list\"\n\n#: ../../etcd.rst:27 ../../etcd.rst:76\nmsgid \"{\"\nmsgstr \"{\"\n\n#: ../../etcd.rst:29\nmsgid \"\\\"0068\\\": [\"\nmsgstr \"\\\"0068\\\": [\"\n\n#: ../../etcd.rst:31\nmsgid \"\\\"0809\\\",\"\nmsgstr \"\\\"0809\\\",\"\n\n#: ../../etcd.rst:33\nmsgid \"\\\"0624\\\"\"\nmsgstr \"\\\"0624\\\"\"\n\n#: ../../etcd.rst:35 ../../etcd.rst:41 ../../etcd.rst:47\nmsgid \"],\"\nmsgstr \"],\"\n\n#: ../../etcd.rst:37\nmsgid \"\\\"0784\\\": [\"\nmsgstr \"\\\"0784\\\": [\"\n\n#: ../../etcd.rst:39\nmsgid \"\\\"0524\\\"\"\nmsgstr \"\\\"0524\\\"\"\n\n#: ../../etcd.rst:43\nmsgid \"\\\"0079\\\": [\"\nmsgstr \"\\\"0079\\\": [\"\n\n#: ../../etcd.rst:45\nmsgid \"\\\"0796\\\"\"\nmsgstr \"\\\"0796\\\"\"\n\n#: ../../etcd.rst:49\nmsgid \"\\\"0793\\\": [\"\nmsgstr \"\\\"0793\\\": [\"\n\n#: ../../etcd.rst:51\nmsgid \"\\\"0793\\\"\"\nmsgstr \"\\\"0793\\\"\"\n\n#: ../../etcd.rst:53\nmsgid \"]\"\nmsgstr \"]\"\n\n#: ../../etcd.rst:55 ../../etcd.rst:106 ../../etcd.rst:108\nmsgid \"}\"\nmsgstr \"}\"\n\n#: ../../etcd.rst:57\nmsgid \"/districts/version\"\nmsgstr \"/districts/version\"\n\n#: ../../etcd.rst:57 ../../etcd.rst:110\nmsgid \"Nimekirja allkirjastajad\"\nmsgstr \"Signers of lists\"\n\n#: ../../etcd.rst:57\nmsgid \"[\\\"NIMESTE,NIMI,123456 78912 2019-02-22T13:58:48Z\\\" ]\"\nmsgstr \"[\\\"NIMESTE,NIMI,123456 78912 2019-02-22T13:58:48Z\\\" ]\"\n\n#: ../../etcd.rst:64 ../../etcd.rst:66\nmsgid \"Valikute nimekiri\"\nmsgstr \"Choices list\"\n\n#: ../../etcd.rst:72\nmsgid \"/choices\"\nmsgstr \"/choices\"\n\n#: ../../etcd.rst:74\nmsgid \"/choices/\"\nmsgstr \"/choices/\"\n\n#: ../../etcd.rst:74\nmsgid \"Ringkonnale district-id vastav valikute nimekiri.\"\nmsgstr \"Choices list corresponding to district-id\"\n\n#: ../../etcd.rst:74\nmsgid \"/choices/0000.1\"\nmsgstr \"/choices/0000.1\"\n\n#: ../../etcd.rst:78\nmsgid \"\\\"Erakond 1\\\":{\"\nmsgstr \"\\\"Party 1\\\":{\"\n\n#: ../../etcd.rst:80\nmsgid \"\\\"0000.101\\\":\\\"Nimi Nimeste1\\\",\"\nmsgstr \"\\\"0000.101\\\":\\\"Nimi Nimeste1\\\",\"\n\n#: ../../etcd.rst:83\nmsgid \"\\\"0000.102\\\":\\\"Nimi Nimeste2\\\",\"\nmsgstr \"\\\"0000.102\\\":\\\"Nimi Nimeste2\\\",\"\n\n#: ../../etcd.rst:86\nmsgid \"\\\"0000.103\\\":\\\"Nimi Nimeste3\\\"\"\nmsgstr \"\\\"0000.103\\\":\\\"Nimi Nimeste3\\\"\"\n\n#: ../../etcd.rst:89 ../../etcd.rst:99\nmsgid \"},\"\nmsgstr \"},\"\n\n#: ../../etcd.rst:91\nmsgid \"\\\"Erakond 2\\\":{\"\nmsgstr \"\\\"Party 2\\\":{\"\n\n#: ../../etcd.rst:93\nmsgid \"\\\"0000.104\\\":\\\"Nimi Nimeste4\\\",\"\nmsgstr \"\\\"0000.104\\\":\\\"Nimi Nimeste4\\\",\"\n\n#: ../../etcd.rst:96\nmsgid \"\\\"0000.105\\\":\\\"Nimi Nimeste5\\\"\"\nmsgstr \"\\\"0000.105\\\":\\\"Nimi Nimeste5\\\"\"\n\n#: ../../etcd.rst:101\nmsgid \"\\\"Üksikkandidaadid\\\":{\"\nmsgstr \"\\\"Independent candidates\\\":{\"\n\n#: ../../etcd.rst:103\nmsgid \"\\\"0000.106\\\":\\\"Nimi Nimeste6\\\"\"\nmsgstr \"\\\"0000.106\\\":\\\"Nimi Nimeste6\\\"\"\n\n#: ../../etcd.rst:110\nmsgid \"/choices/version\"\nmsgstr \"/choices/version\"\n\n#: ../../etcd.rst:110 ../../etcd.rst:134\nmsgid \"[\\\"NIMESTE,NIMI,123456 78912 2019-02-22T13:58:59Z\\\" ]\"\nmsgstr \"[\\\"NIMESTE,NIMI,123456 78912 2019-02-22T13:58:59Z\\\" ]\"\n\n#: ../../etcd.rst:117 ../../etcd.rst:119\nmsgid \"Valijate nimekiri\"\nmsgstr \"Voterlist\"\n\n#: ../../etcd.rst:125\nmsgid \"/voters\"\nmsgstr \"/voters\"\n\n#: ../../etcd.rst:127\nmsgid \"/voters/\"\nmsgstr \"/voters/\"\n\n#: ../../etcd.rst:127\nmsgid \"Valijanimekirja versiooni juurvõti\"\nmsgstr \"Rootkey of voterlist version\"\n\n#: ../../etcd.rst:127\nmsgid \"/voters/1\"\nmsgstr \"/voters/1\"\n\n#: ../../etcd.rst:130\nmsgid \"/voters//\"\nmsgstr \"/voters//\"\n\n#: ../../etcd.rst:130\nmsgid \"Valija antud nimekirjas\"\nmsgstr \"Voter in the list\"\n\n#: ../../etcd.rst:130\nmsgid \"/voters/1/12345678912\"\nmsgstr \"/voters/1/12345678912\"\n\n#: ../../etcd.rst:132\nmsgid \"05241\"\nmsgstr \"05241\"\n\n#: ../../etcd.rst:134\nmsgid \"/voters//version\"\nmsgstr \"/voters//version\"\n\n#: ../../etcd.rst:134\nmsgid \"Valijatenimekirja versioon\"\nmsgstr \"Voterlist version\"\n\n#: ../../etcd.rst:139\nmsgid \"/voters/version\"\nmsgstr \"/voters/version\"\n\n#: ../../etcd.rst:139\nmsgid \"Aktuaalse valijatenimekirja versiooni ID\"\nmsgstr \"ID of latest voterlist\"\n\n#: ../../etcd.rst:139\nmsgid \"1\"\nmsgstr \"1\"\n\n#: ../../etcd.rst:143\nmsgid \"/voters/previous\"\nmsgstr \"/voters/previous\"\n\n#: ../../etcd.rst:143\nmsgid \"Eelmise valijanimekirja versiooni ID\"\nmsgstr \"ID of previous voterlist\"\n\n#: ../../etcd.rst:143 ../../etcd.rst:163 ../../etcd.rst:178\nmsgid \"0\"\nmsgstr \"0\"\n\n#: ../../etcd.rst:149 ../../etcd.rst:151\nmsgid \"Talletatud e-hääl\"\nmsgstr \"Stored i-vote\"\n\n#: ../../etcd.rst:157\nmsgid \"/vote\"\nmsgstr \"/vote\"\n\n#: ../../etcd.rst:159\nmsgid \"/vote/\"\nmsgstr \"/vote/\"\n\n#: ../../etcd.rst:159\nmsgid \"Hääle juurvõti, unikaalne identifikaator\"\nmsgstr \"Rootkey of a vote, unique identifier\"\n\n#: ../../etcd.rst:159\nmsgid \"16 baiti binaarandmed\"\nmsgstr \"16 bytes binary\"\n\n#: ../../etcd.rst:163\nmsgid \"/vote//count\"\nmsgstr \"/vote//count\"\n\n#: ../../etcd.rst:163\nmsgid \"Hääle kontrollimise loendur\"\nmsgstr \"Vote verification counter\"\n\n#: ../../etcd.rst:166\nmsgid \"/vote//ocsp\"\nmsgstr \"/vote//ocsp\"\n\n#: ../../etcd.rst:166\nmsgid \"Kehtivuskinnitus\"\nmsgstr \"Proof-of-validity\"\n\n#: ../../etcd.rst:166\nmsgid \"DER kodeeringus OCSP vastus\"\nmsgstr \"DER encoded OCSP response\"\n\n#: ../../etcd.rst:169\nmsgid \"/vote//time\"\nmsgstr \"/vote//time\"\n\n#: ../../etcd.rst:169\nmsgid \"Hääle talletamise kellaaeg\"\nmsgstr \"Time of the vote storage\"\n\n#: ../../etcd.rst:169\nmsgid \"2019-03-03T10:56:28.8 99925926Z\"\nmsgstr \"2019-03-03T10:56:28.8 99925926Z\"\n\n#: ../../etcd.rst:172\nmsgid \"/vote//tspreg\"\nmsgstr \"/vote//tspreg\"\n\n#: ../../etcd.rst:172\nmsgid \"Registreerimiskinnitus\"\nmsgstr \"Registration confirmation\"\n\n#: ../../etcd.rst:172\nmsgid \"DER kodeeringus PKIX ajatempel\"\nmsgstr \"DER encoded PKIX timestamp\"\n\n#: ../../etcd.rst:175\nmsgid \"/vote//type\"\nmsgstr \"/vote//type\"\n\n#: ../../etcd.rst:175\nmsgid \"Allkirjastatud hääle konteineri tüüp\"\nmsgstr \"Type of signed container\"\n\n#: ../../etcd.rst:175\nmsgid \"BDOC\"\nmsgstr \"BDOC\"\n\n#: ../../etcd.rst:178\nmsgid \"/vote//version\"\nmsgstr \"/vote//version\"\n\n#: ../../etcd.rst:178\nmsgid \"Hääle andmisel kehtinud valijate nimekirja versiooni ID\"\nmsgstr \"ID of the voterlist valid at the time of voting\"\n\n#: ../../etcd.rst:183\nmsgid \"/vote//vote\"\nmsgstr \"/vote//vote\"\n\n#: ../../etcd.rst:183\nmsgid \"E-hääl allkirjastatud konteineris\"\nmsgstr \"I-vote in signed container\"\n\n#: ../../etcd.rst:183\nmsgid \"BDOC vormingus allkirjastatud hääl\"\nmsgstr \"Vote in BDOC format\"\n\n#: ../../etcd.rst:186\nmsgid \"/vote//voter\"\nmsgstr \"/vote//voter\"\n\n#: ../../etcd.rst:186\nmsgid \"Valija isikukood\"\nmsgstr \"Voter personal code\"\n\n#: ../../etcd.rst:186\nmsgid \"12345678912\"\nmsgstr \"12345678912\"\n\n#: ../../etcd.rst:190 ../../etcd.rst:192\nmsgid \"Statistikaliidesed\"\nmsgstr \"Statisticinterfaces\"\n\n#: ../../etcd.rst:198\nmsgid \"/votes\"\nmsgstr \"/votes\"\n\n#: ../../etcd.rst:200\nmsgid \"/votes/order\"\nmsgstr \"/votes/order\"\n\n#: ../../etcd.rst:200\nmsgid \"Hääletamisfaktide järjestuse juurvõti\"\nmsgstr \"Rootkey of votesorder\"\n\n#: ../../etcd.rst:203\nmsgid \"/votes/order/\"\nmsgstr \"/votes/order/\"\n\n#: ../../etcd.rst:203\nmsgid \"Konkreetse hääletamisfakti juurvõti\"\nmsgstr \"Rootkey of specific vote\"\n\n#: ../../etcd.rst:203\nmsgid \"/votes/order/1\"\nmsgstr \"/votes/order/1\"\n\n#: ../../etcd.rst:207\nmsgid \"/votes/order//admincode\"\nmsgstr \"/votes/order//admincode\"\n\n#: ../../etcd.rst:207\nmsgid \"Hääletamisfaktiga seotud EHAK\"\nmsgstr \"EHAK associated with vote\"\n\n#: ../../etcd.rst:207\nmsgid \"0796\"\nmsgstr \"0796\"\n\n#: ../../etcd.rst:210\nmsgid \"/votes/order//district\"\nmsgstr \"/votes/order//district\"\n\n#: ../../etcd.rst:210\nmsgid \"Hääletamisfaktiga seotud ringkonna number\"\nmsgstr \"District associated with vote\"\n\n#: ../../etcd.rst:210\nmsgid \"10\"\nmsgstr \"10\"\n\n#: ../../etcd.rst:214\nmsgid \"/votes/order//voterid\"\nmsgstr \"/votes/order//voterid\"\n\n#: ../../etcd.rst:214\nmsgid \"Hääletaja isikukood\"\nmsgstr \"Personal code\"\n\n#: ../../etcd.rst:214\nmsgid \"12345678901\"\nmsgstr \"12345678901\"\n\n#: ../../etcd.rst:217\nmsgid \"/votes/order//votername\"\nmsgstr \"/votes/order//votername\"\n\n#: ../../etcd.rst:217\nmsgid \"Hääletaja nimi\"\nmsgstr \"Voter name\"\n\n#: ../../etcd.rst:217\nmsgid \"NIMI NIMESTE\"\nmsgstr \"NIMI NIMESTE\"\n\n#: ../../etcd.rst:220\nmsgid \"/votes/stats\"\nmsgstr \"/votes/stats\"\n\n#: ../../etcd.rst:220\nmsgid \"Viimase hääletamisfakti järjekorranumber\"\nmsgstr \"Sequence number of last vote\"\n\n#: ../../etcd.rst:220\nmsgid \"12\"\nmsgstr \"12\"\n\n#: ../../etcd.rst:224\nmsgid \"/voted\"\nmsgstr \"/voted\"\n\n#: ../../etcd.rst:226\nmsgid \"/voted/latest\"\nmsgstr \"/voted/latest\"\n\n#: ../../etcd.rst:226\nmsgid \"Viimati antud häälte indeksi juurvõti\"\nmsgstr \"Rootkey of last vote index\"\n\n#: ../../etcd.rst:229\nmsgid \"/voted/latest/\"\nmsgstr \"/voted/latest/\"\n\n#: ../../etcd.rst:229\nmsgid \"Hääletaja poolt viimati antud hääle aeg ja identifikaator binaarkujul\"\nmsgstr \"The time and identifier of the last vote in binary\"\n\n#: ../../etcd.rst:229\nmsgid \"/voted/latest/1234567 8901\"\nmsgstr \"/voted/latest/1234567 8901\"\n\n#: ../../etcd.rst:232\nmsgid \"<2019-03-03T12:15:59Z >\"\nmsgstr \"<2019-03-03T12:15:59Z >\"\n\n#: ../../etcd.rst:235\nmsgid \"/voted/stats\"\nmsgstr \"/voted/stats\"\n\n#: ../../etcd.rst:235\nmsgid \"Jaoskonnapõhise statistika indeksi juurvõti\"\nmsgstr \"Station statistics rootkey\"\n\n#: ../../etcd.rst:239\nmsgid \"/voted/stats/\"\nmsgstr \"/voted/stats/\"\n\n#: ../../etcd.rst:239\nmsgid \"Hääle andmise kellaaeg koos jaoskonnainfoga\"\nmsgstr \"Time of voting with station info\"\n\n#: ../../etcd.rst:239\nmsgid \"/voted/stats/12345678 901\"\nmsgstr \"/voted/stats/12345678 901\"\n\n#: ../../etcd.rst:242\nmsgid \"<0796><2019-02-22T14: 17:23Z>\"\nmsgstr \"<0796><2019-02-22T14: 17:23Z>\"\n\n#: ../../etcd.rst:245\nmsgid \"/votes/voter/stats/\"\nmsgstr \"/votes/voter/stats/\"\n\n#: ../../etcd.rst:245\nmsgid \"\"\n\"Tühi baitide massiiv (kasutatakse väärtuse versiooni, ning mitte väärtust\"\n\" ennast)\"\nmsgstr \"Empty array - we use the version of the value, not value itself\"\n\n#: ../../etcd.rst:245\nmsgid \"/votes/voter/stats/ 394091044211\"\nmsgstr \"/votes/voter/stats/ 394091044211\"\n\n#: ../../etcd.rst:252 ../../etcd.rst:254\nmsgid \"Hääletamisseansid\"\nmsgstr \"Voting sessions\"\n\n#: ../../etcd.rst:260\nmsgid \"/session\"\nmsgstr \"/session\"\n\n#: ../../etcd.rst:262\nmsgid \"/session/\"\nmsgstr \"/session/\"\n\n#: ../../etcd.rst:262\nmsgid \"\"\n\"RPC meetod, mis kutsus antud funktsiooni välja + ``x1F`` + kasutaja \"\n\"autentimismeetod\"\nmsgstr \"RPC method called + ``x1F`` + authentication method\"\n\n#: ../../etcd.rst:262\nmsgid \"``/session/0149468d2866`` ``6fced7d73b32cc16225d``\"\nmsgstr \"``/session/0149468d2866`` ``6fced7d73b32cc16225d``\"\n\n" }, { "path": "Documentation/public/arhitektuur/locales/en/LC_MESSAGES/index.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2024-02-29 10:35+0200\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language-Team: en \\n\"\n\"Language: en\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"Generated-By: Babel 2.10.3\\n\"\n\n#: ../../index.rst:4\nmsgid \"IVXV arhitektuur\"\nmsgstr \"IVXV architecture\"\n" }, { "path": "Documentation/public/arhitektuur/locales/en/LC_MESSAGES/kogumisteenus.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-03 15:28+0000\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language: en\\n\"\n\"Language-Team: en \\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../kogumisteenus.rst:4\nmsgid \"Kogumisteenus\"\nmsgstr \"Collection service\"\n\n#: ../../kogumisteenus.rst:6\nmsgid \"Üldkirjelduse [ÜK2016]_ põhjal on Kogumisteenus:\"\nmsgstr \"Based on the general description [ÜK2016]_, the Collection Service is:\"\n\n#: ../../kogumisteenus.rst:10\nmsgid \"\"\n\"Süsteemi keskne komponent, mida käitab Koguja. Teenus abistab Hääletajat \"\n\"e-hääle koostamisel ning registreerib selle enne salvestamist \"\n\"e-valimiskasti. Kogumisteenus kasutab väliseid teenuseid (tuvastamine, \"\n\"allkirjastamine, registreerimine). Kogumisteenusel on peale Koguja enda \"\n\"teisigi haldureid (Korraldaja, Klienditugi), kelle jaoks on \"\n\"Kogumisteenusel eraldi haldusliidesed.\"\nmsgstr \"\"\n\"The central component of the system, operated by the Collector. The \"\n\"service assists the Voter in compiling the e-Vote and registers the vote before\"\n\" storing it in the digital ballotbox. The Collection Service makes use of\"\n\" external services (authentication, signing, registration). In addition \"\n\"to the Collector, the Collection Service has other administrators \"\n\"(Organiser, Customer Support) for which the Collection Service has \"\n\"separate administrative interfaces.\"\n\n#: ../../kogumisteenus.rst:17\nmsgid \"\"\n\"Kogumisteenus töötab sidusrežiimis ning vähemalt valija- ja \"\n\"kontrollrakenduse suunalised liidesed on avatud internetile. Seega \"\n\"töötleb Kogumisteenus potentsiaalselt ebausaldusväärsest allikast pärit \"\n\"päringuid. Tulenevalt tarkvarale seatavast turvatasemest, \"\n\"kõrgkäideldavuse, skaleeritavuse, kihilise evitatavuse ning laiendatavuse\"\n\" nõuetest on kogumisteenus omakorda liigendatud ühte konkreetset teenust \"\n\"osutavateks mikroteenusteks, mida on võimalik paindlikult evitada.\"\nmsgstr \"\"\n\"The collection service works in online mode and at least the interfaces \"\n\"to the voter and the verification application are open to the internet. \"\n\"Thus, the Collection Service processes queries from potentially \"\n\"unreliable sources. In turn, due to the security level, high \"\n\"availability, scalability, deployment and extensibility requirements of \"\n\"the software, the Collection Service is broken down into microservices \"\n\"providing one specific service, which can be flexibly extensible.\"\n\n#: ../../kogumisteenus.rst:25\nmsgid \"\"\n\"Kõik kogumisteenuse komponendid programmeeritakse keeles `Go \"\n\"`_. Keelel Go on:\"\nmsgstr \"\"\n\"All collection service components are programmed in `Go \"\n\"`_. The language Go is:\"\n\n#: ../../kogumisteenus.rst:28\nmsgid \"\"\n\"staatiline tüüpimine, mis võimaldab tüübivigade avastamist enne programmi\"\n\" käivitamist;\"\nmsgstr \"\"\n\"static typing, which allows typing errors to be detected before the \"\n\"program is run;\"\n\n#: ../../kogumisteenus.rst:31\nmsgid \"\"\n\"automaatne mäluhaldus, mis välistab rakenduse vigasest mäluhaldusest \"\n\"tulenevad turvaaugud;\"\nmsgstr \"\"\n\"automatic memory management, which eliminates security holes caused by \"\n\"incorrect memory management in the application;\"\n\n#: ../../kogumisteenus.rst:34\nmsgid \"kompilaator avatud lähtekoodiga;\"\nmsgstr \"open source compiler;\"\n\n#: ../../kogumisteenus.rst:36\nmsgid \"\"\n\"ribastamine/rööprapse, mis võimaldab kasutada paralleelsust \"\n\"mitmetuumalistes süsteemides.\"\nmsgstr \"goroutines, allowing parallelism to be used in multi-CPU systems.\"\n\n#: ../../kogumisteenus.rst:39\nmsgid \"\"\n\"Kogumisteenuse andmeedastuseks kasutatakse üldjuhul JSON-vormingut, välja\"\n\" arvatud olukordades, kus välised asjaolud tingivad mõne muu \"\n\"andmevormingu kasutamist (näiteks BDOC-vorming põhineb XML'il).\"\nmsgstr \"\"\n\"The JSON format will generally be used for the data transmission of the \"\n\"collection service, except in situations where external circumstances \"\n\"dictate the use of another data format (for example, the BDOC format is \"\n\"based on XML).\"\n\n#: ../../kogumisteenus.rst:43\nmsgid \"\"\n\"Kogumisteenus toetab Riigikogu valimisi, kohaliku omavalitsuse volikogu \"\n\"valimisi, Euroopa parlamendi valimisi ning rahvahääletusi.\"\nmsgstr \"\"\n\"The collection service supports elections to the Riigikogu, local council\"\n\" elections, European Parliament elections and referendums.\"\n\n#: ../../kogumisteenus.rst:46\nmsgid \"\"\n\"Kogumisteenuse komponendid arvestavad virtualiseerimistehnoloogiate \"\n\"kasutamisega ning kogumisteenust on võimalik evitada nii ühel \"\n\"virtuaalriistvara instantsil, kui ka mikroteenuste kaupa erinevatel \"\n\"instantsidel. Kogumisteenuse komponendid on evitatavad Ubuntu 22.04 LTS \"\n\"(Jammy Jellyfish) operatsioonisüsteemil 64-bitisel arhitektuuril.\"\nmsgstr \"\"\n\"The collection service components take into account the use of \"\n\"virtualisation technologies and the collection service can be hosted on a\"\n\" single virtual hardware instance or on a microservice-by-microservice \"\n\"basis on different instances. The collection service components are \"\n\"executable on Ubuntu 22.04 LTS (Jammy Jellyfish) operating system on \"\n\"64-bit architecture.\"\n\n#: ../../kogumisteenus.rst:52\nmsgid \"\"\n\"Andmesäilitus on teostatud kasutades võti-väärtus andmebaasi (etcd). \"\n\"Testotstarbel on teostatud ka andmesäilitus failisüsteemi ning mällu, \"\n\"kuid neid ei ole soovituslik kasutada tootekeskkonnas. Lisaks on \"\n\"kogumisteenusel olemas liides uute talletusprotokollide lisamiseks. \"\n\"Lõplik otsus kasutatava lahenduse kohta tehakse kogumisteenuse haldurite \"\n\"poolt teenust seadistades.\"\nmsgstr \"\"\n\"Data storage is performed using a key-value database (etcd). For testing \"\n\"purposes, data storage on the file system and in memory has also been \"\n\"implemented, but is not recommended for use in the production \"\n\"environment. In addition, the collection service has an interface for \"\n\"adding new storage protocols. The final decision on the solution to be \"\n\"used will be made by the collection administrators when configuring the \"\n\"service.\"\n\n#: ../../kogumisteenus.rst:59\nmsgid \"Mikroteenused\"\nmsgstr \"Microservices\"\n\n#: ../../kogumisteenus.rst:63\nmsgid \"Kogumisteenuse jaotus mikroteenusteks\"\nmsgstr \"Breakdown of collection service into microservices\"\n\n#: ../../kogumisteenus.rst:65\nmsgid \"\"\n\"Kogumisteenus on jaotatud põhiteenusteks ja abiteenusteks. Põhiteenused -\"\n\" vahendusteenus, nimekirjateenus, hääletamisteenus, kontrollteenus ning \"\n\"talletamisteenus - on arhitektuuri tehnilise lihtsuse mõttes piiritletud \"\n\"ühe valimisega, kuid ühel riistvaral, ühe operatsioonisüsteemi kontekstis\"\n\" võivad käia mitme valimise mikroteenused. Täiendavalt võib \"\n\"kogumisteenuse juures kasutada abiteenuseid - tuvastusteenust hääletaja \"\n\"isiku tuvastamiseks ning allkirjateenust valijarakenduse poolt hääle \"\n\"allkirjastamise hõlbustamiseks.\"\nmsgstr \"\"\n\"The collection service is broken down into basic and helper services. The\"\n\" basic services - dispatcher, choice-list, voting, verification and \"\n\"storage - are limited to a single election for the sake of technical \"\n\"simplicity of the architecture, but multiple election microservices can \"\n\"run on a single hardware, in the context of a single operating system. In\"\n\" addition, the collection service may use helper services - an \"\n\"authentication service to authenticate the voter, and a signature service\"\n\" to facilitate the signing of the vote by the voting application.\"\n\n#: ../../kogumisteenus.rst:73\nmsgid \"\"\n\"Teenuseid on võimalik evitada nii eraldatult kui koos erinevates \"\n\"konfiguratsioonides, mis teeb võimalikuks kihilise arhitektuuri. Lähtudes\"\n\" funktsioonist on otstarbekas hoida Vahendus- ning Talletamisteenused \"\n\"teistest eraldi.\"\nmsgstr \"\"\n\"Services can be provided both separately and together in different \"\n\"configurations, enabling a layered architecture. Based on the function, \"\n\"it makes sense to keep the dispatcher and storage services separate from \"\n\"each other.\"\n\n#: ../../kogumisteenus.rst:78\nmsgid \"\"\n\"Teenused kasutavad transpordiprotokollina TLS'i, ühendused on vähemalt \"\n\"serveripoolselt autenditud. Rakenduskihi protokoll on JSON-RPC.\"\nmsgstr \"\"\n\"The services use TLS as transport protocol, all connections are at least \"\n\"server-side authenticated. The application layer protocol is JSON-RPC.\"\n\n#: ../../kogumisteenus.rst:81\nmsgid \"\"\n\"Kõik teenused tekitavad tegevuslogi, mida säilitatakse nii lokaalselt kui\"\n\" logitakse syslog protokolli vahendusel kesksesse logikogujasse.\"\nmsgstr \"\"\n\"All services generate an activity log, which is both stored locally and \"\n\"logged via the syslog protocol to a central log collector.\"\n\n#: ../../kogumisteenus.rst:85\nmsgid \"Vahendusteenuse funktsioon ja tehniline liides\"\nmsgstr \"Dispatcher service function and technical interface\"\n\n#: ../../kogumisteenus.rst:87\nmsgid \"\"\n\"Vahendusteenuse põhifunktsioon on ühe sisenemispunkti (port 443) \"\n\"pakkumine Valijarakendusele ja Kontrollrakendusele. Vahendusteenus on \"\n\"dispetšerteenus teiste komponentide vahel, mis võimaldab sisemiselt \"\n\"evitada kogumisteenust mikroteenustena, ent omada süsteemil ainult ühte \"\n\"sisenemispunkti. Lisaks suudab see dubleeritud evituse puhul täita \"\n\"koormusjaoturi ülesannet.\"\nmsgstr \"\"\n\"The main function of the Dispatcher Service is to provide a single entry \"\n\"point (port 443) to the Voting Application and the Verification \"\n\"Application. The Dispatcher Service is dispatching between other \"\n\"components, allowing the collection service to be provided internally as \"\n\"microservices, but with only one entry point on the system. In addition, \"\n\"it is able to act as a load balancer in the case of distributed \"\n\"deployment.\"\n\n#: ../../kogumisteenus.rst:93\nmsgid \"\"\n\"Vahendusteenus ei termineeri TLS-ühendust vaid kasutab sihtpunkti \"\n\"tuvastamiseks TLS'i *Server Name Indication* (SNI) laiendust. Kliendid \"\n\"panevad TLS ``ClientHello`` sõnumisse SNI-laiendi, kus avatekstis \"\n\"määravad, millise teenusega soovivad suhelda: vahendusteenus näeb seda, \"\n\"võtab ühendust vastavat teenust pakkuva isendiga ja hakkab kliendi ning \"\n\"teenuse vahelisi sõnumeid vahendama. Vahendusteenus EI termineeri TLS'i \"\n\"ning ei näe sõnumite sisu. Vahendusteenusel on andmed kõigi teiste \"\n\"teenuste asukohtadest (aadress:port) ning teenus vahendab sõnumivahetust \"\n\"kõigi osapoolte vahel.\"\nmsgstr \"\"\n\"The dispatcher service does not terminate the TLS connection but uses the\"\n\" TLS *Server Name Indication* (SNI) extension to identify the \"\n\"destination. Clients put an SNI extension in the TLS ``ClientHello`` \"\n\"message, where they specify in the plain text which service they wish to \"\n\"communicate with: the dispatcher service sees this, contacts the host \"\n\"providing the corresponding service and starts dispatching messages \"\n\"between the client and the service. The dispatcher service does NOT \"\n\"terminate the TLS and does not see the content of the messages. The \"\n\"dispatcher service has information about the locations of all other \"\n\"services (address:port) and mediates the messaging between all parties.\"\n\n#: ../../kogumisteenus.rst:102\nmsgid \"\"\n\"Vahendusteenus on olekuvaba komponent, mida on võimalik horisontaalselt \"\n\"skaleerida.\"\nmsgstr \"\"\n\"The dispatcher service is a stateless component that can be scaled \"\n\"horizontally.\"\n\n#: ../../kogumisteenus.rst:106\nmsgid \"Vahendusteenuse teostus\"\nmsgstr \"Implementation of the dispatcher service\"\n\n#: ../../kogumisteenus.rst:108\nmsgid \"\"\n\"Vahendusteenuse teostus kasutab vabavaralist HAProxy serverit, mis on \"\n\"üldlevinud tarkvaraline koormusjaotur ja proksi. Kuna Vahendusteenus on \"\n\"esimene puutepunkt avalikust internetist tulevate ühenduste jaoks, siis \"\n\"on mõistlik kasutada tarkvara, mille töökindlus on juba tõestatud.\"\nmsgstr \"\"\n\"The dispatcher service is implemented using the freeware HAProxy server, \"\n\"which is a ubiquitous software load balancer and proxy. As the Dispatcher\"\n\" Service is the first point of contact for connections from the public \"\n\"Internet, it makes sense to use software that is already proven to be \"\n\"reliable.\"\n\n#: ../../kogumisteenus.rst:113\nmsgid \"\"\n\"Kuigi HAProxyt kasutatakse tihti HTTP-režiimis, kus see analüüsib \"\n\"liiklust, siis vahendusteenuse rollis on see TCP-režiimis ning ei näe \"\n\"vahendatava krüpteeritud TLS-kanali sisse.\"\nmsgstr \"\"\n\"While HAProxy is often used in HTTP mode, where it analyses traffic, in \"\n\"the role of a proxy service it is in TCP mode and does not see into the \"\n\"encrypted TLS channel being proxied.\"\n\n#: ../../kogumisteenus.rst:117\nmsgid \"\"\n\"IVXV seadistusest genereeritakse HAProxy seadistusfail, mis sisaldab \"\n\"teiste teenuste asukohti, ning ühenduste vahendamise ülesanne jääb \"\n\"viimase kanda. Lisaks on võimalik HAProxyt ka seadistada ühenduste \"\n\"sagedusi piirama lähteaadressi või mõne muu nimetaja põhjal. See aga jääb\"\n\" süsteemihalduri ülesandeks.\"\nmsgstr \"\"\n\"The IVXV configuration generates a HAProxy configuration file containing \"\n\"the locations of the other services, and leaves the connection brokering \"\n\"to the latter. In addition, it is also possible to configure HAProxy to \"\n\"limit connections based on the source address or some other denominator. \"\n\"This, however, is left to the system administrator.\"\n\n#: ../../kogumisteenus.rst:123\nmsgid \"\"\n\"Kuigi HAProxy on võimeline ise teostama koormusjaoturi ülesannet, on seda\"\n\" võimalik evitada ka teiste, potentsiaalselt riistvaraliste \"\n\"koormusjaoturite taha, kus see jääb täitma ainult SNI põhjal vahendamise \"\n\"ülesannet.\"\nmsgstr \"\"\n\"Although HAProxy is capable of performing the load balancer task itself, \"\n\"it can also be exported behind other, potentially hardware load \"\n\"balancers, where it remains to perform only the task of dispatching on \"\n\"the basis of SNI.\"\n\n#: ../../kogumisteenus.rst:127\nmsgid \"\"\n\"HAProxy lähtekood on avalik ja sobiva litsentsiga ning pakendatud \"\n\"kogumisteenuse alusplatvormi ametlikus hoidlas (vt. :ref:`tehnoloogiad`).\"\nmsgstr \"\"\n\"The HAProxy source code is public and suitably licensed and packaged in \"\n\"the official repository of the underlying collection service platform \"\n\"(see :ref:`tehnoloogiad`).\"\n\n#: ../../kogumisteenus.rst:131\nmsgid \"Nimekirjateenuse funktsioon ja tehniline liides\"\nmsgstr \"Functionality and technical interface of the choice-list service\"\n\n#: ../../kogumisteenus.rst:133\nmsgid \"\"\n\"Nimekirjateenuse põhifunktsioon on valikute nimekirjade vahendamine \"\n\"Valijarakendusele. Nimekirjateenusesse jõuab informatsioon tuvastatud \"\n\"valija kohta ning Nimekirjateenus väljastab valija ringkonnale vastava \"\n\"valikute nimekirja Talletamisteenusest Valijarakendusse.\"\nmsgstr \"\"\n\"The main function of the choice-list service is to provide choice list to\"\n\" the Voting application. The Choice List Service receives information \"\n\"about the authenticated voter and issues the corresponding list of \"\n\"choices to the voter's precinct to the Voting Application.\"\n\n#: ../../kogumisteenus.rst:138\nmsgid \"\"\n\"Nimekirjateenus on olekuvaba komponent, mida on võimalik horisontaalselt \"\n\"skaleerida.\"\nmsgstr \"\"\n\"The choice-list service is a stateless component that can be scaled \"\n\"horizontally.\"\n\n#: ../../kogumisteenus.rst:142\nmsgid \"Kontrollteenuse funktsioon ja tehniline liides\"\nmsgstr \"Verification service functionality and technical interface\"\n\n#: ../../kogumisteenus.rst:144\nmsgid \"\"\n\"Kontrollteenuse põhifunktsioon on kontrollpäringute töötlemine ning \"\n\"kontrollitava hääle väljastamine Talletamisteenusest Kontrollrakendusse.\"\nmsgstr \"\"\n\"The main function of the Verification Service is to process verification \"\n\"requests and output the vote to be verified from the Storage Service to \"\n\"the Verification Application.\"\n\n#: ../../kogumisteenus.rst:147\nmsgid \"\"\n\"Kontrollteenus on olekuvaba komponent, mida on võimalik horisontaalselt \"\n\"skaleerida.\"\nmsgstr \"\"\n\"The verification service is a stateless component that can be scaled \"\n\"horizontally.\"\n\n#: ../../kogumisteenus.rst:151\nmsgid \"Hääletamisteenuse funktsioon ja tehniline liides\"\nmsgstr \"Voting service function and technical interface\"\n\n#: ../../kogumisteenus.rst:153\nmsgid \"\"\n\"Hääletamisteenuse põhifunktsioon on hääletamispäringute töötlemine. \"\n\"Hääletamisteenus verifitseerib sissetuleva hääle, registreerib selle \"\n\"Registreerimisteenuses ning talletab Talletamisteenusesse.\"\nmsgstr \"\"\n\"The main function of the voting service is the processing of voting \"\n\"requests. The Voting Service verifies the incoming vote, registers it in \"\n\"the Registration Service and stores it in the Storage Service.\"\n\n#: ../../kogumisteenus.rst:157\nmsgid \"\"\n\"Hääletamisteenus on olekuvaba komponent, mida on võimalik horisontaalselt\"\n\" skaleerida.\"\nmsgstr \"\"\n\"The voting service is a stateless component that can be scaled \"\n\"horizontally.\"\n\n#: ../../kogumisteenus.rst:161\nmsgid \"Talletamisteenuse funktsioon ja tehniline liides\"\nmsgstr \"Functionality and technical interface of the storage service\"\n\n#: ../../kogumisteenus.rst:163\nmsgid \"\"\n\"Talletamisteenuse põhifunktsioon on valikute ja valijanimekirjade ning \"\n\"häälte pikaajaline talletamine.\"\nmsgstr \"\"\n\"The main function of the storage service is the long-term storage of \"\n\"lists of choices, lists of voters and votes.\"\n\n#: ../../kogumisteenus.rst:166\nmsgid \"\"\n\"Talletamisteenuse horisontaalseks skaleerimiseks kasutatakse \"\n\"hajustalletamist võimaldavat säilitustehnoloogiat.\"\nmsgstr \"\"\n\"Storage technology that enables distributed storage is used for \"\n\"horizontal scaling of the storage service.\"\n\n#: ../../kogumisteenus.rst:170\nmsgid \"Talletamisteenuse teostus\"\nmsgstr \"Implementation of storage service\"\n\n#: ../../kogumisteenus.rst:172\nmsgid \"\"\n\"Talletamisteenus ei ole teadlik IVXV protokollist ega talletatavate \"\n\"andmete spetsiifikast, vaid on üldkasutatav võti-väärtus andmebaas \"\n\"binaarandmete säilitamiseks. Kogu teadmus talletatavate andmete \"\n\"struktuurist ja võtmete hierarhiast on teistes, Talletamisteenust \"\n\"kasutatavates teenustes, mis käituvad nii-öelda \\\"tarkade\\\" klientidena.\"\nmsgstr \"\"\n\"The storage service is not aware of the IVXV protocol or the specifics of\"\n\" the data being stored, but is a public key-value database for storing \"\n\"binary data. All the knowledge about the structure of the stored data and\"\n\" the hierarchy of keys is in the other services using the Storage \"\n\"Service, which behave as \\\"smart\\\" clients.\"\n\n#: ../../kogumisteenus.rst:178\nmsgid \"\"\n\"Selline lähenemine lubab ilma suurema vaevata kasutada \"\n\"Talletamisteenusena ükskõik millist üldlevinud võti-väärtus andmebaasi: \"\n\"ainsateks ülesanneteks on IVXV seadistuse teisendamine andmebaasi jaoks \"\n\"sobilikku vormingusse ning teenuse käivitamine. Andmebaasi tarkvara peab \"\n\"võimaldama vaid võtme järgi talletamist ja lugemist, võtmete prefiksi \"\n\"järgi loetlemist ning atomaarset võrdle-ja-vaheta (*compare-and-swap*) \"\n\"operatsiooni.\"\nmsgstr \"\"\n\"This approach allows any common key-value database to be used as a \"\n\"Storage Service without much effort: the only tasks are to convert the \"\n\"IVXV configuration into a database-appropriate format and to start the \"\n\"service. The database software only needs to support key-by-key storage \"\n\"and read, key-by-prefix read, and atomic *compare-and-swap* operation.\"\n\n#: ../../kogumisteenus.rst:185\nmsgid \"\"\n\"Talletamisteenus on kogumisteenuse töökiiruse oluliseks määrajaks, \"\n\"mistõttu mõjutab seda teenust pakkuv riistvara kogu süsteemi jõudlust \"\n\"ning see tuleks vastavalt kasutatavale andmebaasile dimensioneerida.\"\nmsgstr \"\"\n\"The storage service is an important determinant of the performance of the\"\n\" collection service, so the hardware that provides this service affects \"\n\"the performance of the whole system and should be dimensioned according \"\n\"to the database used.\"\n\n#: ../../kogumisteenus.rst:189\nmsgid \"\"\n\"Hetkel ainus tooteks mõeldud Talletamisteenuse teostus kasutab hajusat \"\n\"võti-väärtus andmebaasi etcd. Selle puhul tuleks järgida etcd autorite \"\n\"`riistvara soovitusi `_.\"\nmsgstr \"\"\n\"Currently, the only Storage Service implementation for the production \"\n\"uses a distributed key-value database etcd. For this, the `hardware \"\n\"recommendations `_ of the etcd authors should be followed.\"\n\n#: ../../kogumisteenus.rst:195\nmsgid \"Tuvastusteenuse funktsioon ja tehniline liides\"\nmsgstr \"Authentication service function and technical interface\"\n\n#: ../../kogumisteenus.rst:197\nmsgid \"\"\n\"Tuvastusteenuse põhifunktsioon on valija identiteedi tuvastamine. \"\n\"Tuvastusteenus on vajalik näiteks Mobiil-ID autentimise korral.\"\nmsgstr \"\"\n\"The main function of the authentication service is to identify and \"\n\"authenticate the voter. For example, the authentication service must be \"\n\"implemented for Mobile-ID authentication.\"\n\n#: ../../kogumisteenus.rst:201\nmsgid \"Web-eID abiteenuse teostus\"\nmsgstr \"Implementation of the Web-eID authentication service\"\n\n#: ../../kogumisteenus.rst:203\nmsgid \"\"\n\"IVXV koosseisu kuulub Web-eID abiteenus, mis realiseerib Tuvastusteenuse \"\n\"ID-kaardi kasutamiseks Web-eID raamistikus.\"\nmsgstr \"\"\n\"IVXV includes Web-eID authentication service for using ID-card in the \"\n\"Web-eID framework\"\n\n#: ../../kogumisteenus.rst:206\nmsgid \"\"\n\"Eduka Web-eID isikutuvastuse korral väljastab abiteenus Valijarakendusele\"\n\" pileti, mille abil on võimalik teistele teenustele valija identiteeti \"\n\"kinnitada. Iga piletiga saab hääletada ainult ühe korra.\"\nmsgstr \"\"\n\"In case of a successful Web-eID authentication, the service issues a \"\n\"ticket to the Voting Application, which can be used to confirm the \"\n\"voter's identity to other services. Each ticket can be used to vote only \"\n\"once.\"\n\n#: ../../kogumisteenus.rst:210\nmsgid \"\"\n\"Web-eID ei paku allkirjateenust, hääle allkirjastamine toimub Valija \"\n\"seadmes lokaalselt analoogselt klassikalisele ID-kaardiga \"\n\"autentimisele/allkirjastamisele.\"\nmsgstr \"\"\n\"Web-eID does not provide signature service. The signing of the vote takes\"\n\" place in the Voting Application in the same way as with ID-card.\"\n\n#: ../../kogumisteenus.rst:214\nmsgid \"\"\n\"Web-eID abiteenus on olekuvaba komponent. Tänu sellele on võimalik Web-\"\n\"eID abiteenust horisontaalselt skaleerida.\"\nmsgstr \"\"\n\"The Web-eID service is a stateless component that can be scaled \"\n\"horizontally.\"\n\n#: ../../kogumisteenus.rst:219\nmsgid \"Allkirjateenuse funktsioon ja tehniline liides\"\nmsgstr \"Signature service functionality and technical interface\"\n\n#: ../../kogumisteenus.rst:221\nmsgid \"\"\n\"Allkirjateenuse funktsioon on Valijarakenduse toetamine hääle \"\n\"allkirjastamisel. Allkirjateenus on vajalik näiteks Mobiil-ID \"\n\"allkirjastamise korral.\"\nmsgstr \"\"\n\"The function of the Signature Service is to support the Voting \"\n\"Application in signing a vote. For example, the signature service is \"\n\"required for Mobile-ID signing.\"\n\n#: ../../kogumisteenus.rst:226\nmsgid \"Mobiil-ID abiteenuse teostus\"\nmsgstr \"Implementation of the Mobile-ID service\"\n\n#: ../../kogumisteenus.rst:228\nmsgid \"\"\n\"IVXV koosseisu kuulub Mobiil-ID abiteenus, mis käitub Mobiil-ID jaoks nii\"\n\" Tuvastusteenusena kui ka Allkirjateenusena. Valijarakendus esitab IVXV \"\n\"päringud Mobiil-ID abiteenusele, mis teisendab need Mobiil-ID päringuteks\"\n\" ning edastab Mobiil-ID teenusepakkujale.\"\nmsgstr \"\"\n\"IVXV includes the Mobile-ID Service, which acts as both an Authentication\"\n\" Service and a Signature Service for Mobile-ID. The Voting Application \"\n\"submits the IVXV requests to the Mobile-ID Service, which converts them \"\n\"into Mobile-ID requests and forwards them to the Mobile-ID Service \"\n\"Provider.\"\n\n#: ../../kogumisteenus.rst:233\nmsgid \"\"\n\"Eduka Mobiil-ID isikutuvastuse korral väljastab abiteenus \"\n\"Valijarakendusele pileti, mille abil on võimalik teistele teenustele \"\n\"valija identiteeti kinnitada. Iga piletiga saab hääletada ainult ühe \"\n\"korra.\"\nmsgstr \"\"\n\"In case of a successful Mobile-ID authentication, the help service issues\"\n\" a ticket to the Voting Application, which can be used to confirm the \"\n\"voter's identity to other services. Each ticket can be used to vote only \"\n\"once.\"\n\n#: ../../kogumisteenus.rst:237\nmsgid \"\"\n\"Allkirjastamise korral saadab Valijarakendus Mobiil-ID abiteenusele vaid \"\n\"allkirjastatava hääle räsi ning kasutab vastuseks saadud signatuuri \"\n\"samamoodi kui ID-kaardiga loodud signatuuri.\"\nmsgstr \"\"\n\"In the case of a signature, the Voting Application sends only the hash of\"\n\" the vote to be signed to the Mobile ID Service and uses the signature \"\n\"received in response in the same way as the signature created with an ID-\"\n\"card.\"\n\n#: ../../kogumisteenus.rst:241\nmsgid \"\"\n\"Mobiil-ID abiteenus sisaldab küll olekut pooleliolevate tuvastusseansside\"\n\" kohta, aga muus osas on tegu olekuvaba komponendiga. Tänu sellele on \"\n\"võimalik Mobiil-ID abiteenust horisontaalselt skaleerida.\"\nmsgstr \"\"\n\"The Mobile-ID service does contain a status for pending authentication \"\n\"sessions, but otherwise it is a stateless component. This makes it \"\n\"possible to horizontally scale the Mobile-ID Service.\"\n\n#: ../../kogumisteenus.rst:246\nmsgid \"Smart-ID abiteenuse teostus\"\nmsgstr \"Implementation of Smart-ID service\"\n\n#: ../../kogumisteenus.rst:248\nmsgid \"\"\n\"IVXV koosseisu kuulub Smart-ID abiteenus, mis käitub Smart-ID jaoks nii \"\n\"Tuvastusteenusena kui ka Allkirjateenusena. Valijarakendus esitab IVXV \"\n\"päringud Smart-ID abiteenusele, mis teisendab need Smart-ID päringuteks \"\n\"ning edastab Smart-ID teenusepakkujale.\"\nmsgstr \"\"\n\"IVXV includes the Smart-ID Service, which acts as both an Authentication \"\n\"Service and a Signature Service for Smart-ID. The Voting Application \"\n\"submits the IVXV requests to the Smart-ID Service, which converts them \"\n\"into Smart-ID requests and forwards them to the Smart-ID Service \"\n\"Provider.\"\n\n#: ../../kogumisteenus.rst:253\nmsgid \"\"\n\"Eduka Smart-ID isikutuvastuse korral väljastab abiteenus \"\n\"Valijarakendusele pileti, mille abil on võimalik teistele teenustele \"\n\"valija identiteeti kinnitada. Iga piletiga saab hääletada ainult ühe \"\n\"korra.\"\nmsgstr \"\"\n\"In case of a successful Smart-ID authentication, the help service issues \"\n\"a ticket to the Voting Application, which can be used to confirm the \"\n\"voter's identity to other services. Each ticket can be used to vote only \"\n\"once.\"\n\n#: ../../kogumisteenus.rst:257\nmsgid \"\"\n\"Allkirjastamise korral saadab Valijarakendus Smart-ID abiteenusele vaid \"\n\"allkirjastatava hääle räsi ning kasutab vastuseks saadud signatuuri \"\n\"samamoodi kui ID-kaardiga loodud signatuuri.\"\nmsgstr \"\"\n\"In the case of signing, the Voting App sends only the hash of the vote to\"\n\" be signed to the Smart-ID Service and uses the signature received in \"\n\"response in the same way as the signature created with an ID-card.\"\n\n#: ../../kogumisteenus.rst:261\nmsgid \"\"\n\"Smart-ID abiteenus sisaldab küll olekut pooleliolevate tuvastusseansside \"\n\"kohta, aga muus osas on tegu olekuvaba komponendiga. Tänu sellele on \"\n\"võimalik Smart-ID abiteenust horisontaalselt skaleerida.\"\nmsgstr \"\"\n\"The Smart-ID service does contain a status for pending authentication \"\n\"sessions, but otherwise it is a stateless component. This makes it \"\n\"possible to horizontally scale the Smart-ID Service.\"\n\n#: ../../kogumisteenus.rst:267\nmsgid \"Hääletamisfaktide järjekorrateenus\"\nmsgstr \"Votesorder service\"\n\n#: ../../kogumisteenus.rst:269\nmsgid \"\"\n\"Hääletamisfaktide järjekorrateenuse põhifunktsiooniks on \"\n\"hääletamisfaktide edastamine Valimiste Infosüsteemile X-tee abiteenuse \"\n\"vahendusel.\"\nmsgstr \"\"\n\"Main function of the votesorder service is to provide information about \"\n\"votes received to the Election Management System over X-road service\"\n\n#: ../../kogumisteenus.rst:273\nmsgid \"Kogumisteenuse mikroteenuste evitamine\"\nmsgstr \"Deployment of collection microservices\"\n\n#: ../../kogumisteenus.rst:275\nmsgid \"\"\n\"Kogumisteenuse mikroteenused sõltuvad välistest pakkidest minimaalselt. \"\n\"Vajalikud sõltuvused on:\"\nmsgstr \"\"\n\"Collection microservices rely minimally on external packages. The \"\n\"necessary dependencies are:\"\n\n#: ../../kogumisteenus.rst:278\nmsgid \"\"\n\"SSH-server haldustegevuste läbiviimiseks (seda kasutab mikroteenuste \"\n\"haldamiseks haldusteenus).\"\nmsgstr \"\"\n\"SSH server for administrative activities (used by the management service \"\n\"for microservices).\"\n\n#: ../../kogumisteenus.rst:281\nmsgid \"rsyslog logide kogumiseks logikogumisteenustesse.\"\nmsgstr \"rsyslog for log collection services.\"\n\n#: ../../kogumisteenus.rst:283\nmsgid \"\"\n\"Kogumisteenuse mikroteenused pakendatakse deb-vormingus, neid on võimalik\"\n\" evitada ka docker'i-laadsete konteineritena.\"\nmsgstr \"\"\n\"The collection microservices are packaged in deb format and can also be \"\n\"delivered in docker-like containers.\"\n\n#: ../../kogumisteenus.rst:287\nmsgid \"Välised teenused ja laiendatavus\"\nmsgstr \"External services and scalability\"\n\n#: ../../kogumisteenus.rst:291\nmsgid \"Kogumisteenuse laiendusmoodulid ja välised teenused\"\nmsgstr \"Collection Service Extensions and External Services\"\n\n#: ../../kogumisteenus.rst:293\nmsgid \"\"\n\"Kogumisteenuse mikroteenused kasutavad laiendusmooduleid teostamaks \"\n\"erinevaid mehhanisme valija tuvastamiseks, digiallkirjade \"\n\"verifitseerimiseks ja täiendamiseks, sealhulgas hääle registreerimiseks. \"\n\"Laiendusmoodulid võivad teostuse võimaldamiseks kasutada väliseid \"\n\"teenuseid. Mikroteenuste laiendatavuse huvides on defineeritud Go API, \"\n\"mille alusel saab teostada ka täiendavaid mooduleid. Hetkel on teostatud \"\n\"järgmised moodulid:\"\nmsgstr \"\"\n\"Collection microservices use plug-ins to perform various mechanisms for \"\n\"voter authentication, digital signature verification and qualification, \"\n\"including vote registration. The extension modules may use external \"\n\"services to enable the implementation. For the extensibility of the \"\n\"microservices, a Go API has been defined to allow the execution of \"\n\"additional modules. The following modules are currently implemented:\"\n\n#: ../../kogumisteenus.rst:300\nmsgid \"Autentimine TLS-sertifikaadiga (ID-kaart);\"\nmsgstr \"Authentication with TLS certificate (ID card);\"\n\n#: ../../kogumisteenus.rst:302\nmsgid \"Autentimine Tuvastusteenuse piletiga (Mobiil-ID, Smart-ID, Web-eID);\"\nmsgstr \"\"\n\"Authentication with an Authentication Service Ticket (Mobile-ID, Smart-\"\n\"ID, Web-eID);\"\n\n#: ../../kogumisteenus.rst:304\nmsgid \"BDOC verifitseerimine;\"\nmsgstr \"BDOC verification;\"\n\n#: ../../kogumisteenus.rst:306\nmsgid \"Kehtivuskinnitusteenus OCSP;\"\nmsgstr \"Certificate validity service OCSP;\"\n\n#: ../../kogumisteenus.rst:308\nmsgid \"Ajatempliteenus RFC 3161;\"\nmsgstr \"Timestamp Service RFC 3161;\"\n\n#: ../../kogumisteenus.rst:310\nmsgid \"Registreerimisteenus OCSP;\"\nmsgstr \"Registration service OCSP;\"\n\n#: ../../kogumisteenus.rst:312\nmsgid \"Registreerimisteenus RFC 3161.\"\nmsgstr \"Registration service RFC 3161.\"\n\n#: ../../kogumisteenus.rst:314\nmsgid \"\"\n\"IVXV krüptograafilises protokollis on kesksel kohal Registreerimisteenus,\"\n\" mis osaleb samuti häälte pikaajalisel talletamisel.\"\nmsgstr \"\"\n\"Central to the IVXV cryptographic protocol is the Registration Service, \"\n\"which is also involved in the long-term storage of votes.\"\n\n#: ../../kogumisteenus.rst:318\nmsgid \"Registreerimisteenuse funktsioon\"\nmsgstr \"Registration service function\"\n\n#: ../../kogumisteenus.rst:320\nmsgid \"\"\n\"Registreerimisteenuse põhifunktsioon on võtta Hääletamisteenuselt vastu \"\n\"allkirjastatud registreerimispäringuid, kinnitada need omapoolse \"\n\"allkirjastatud vastusega ning säilitada hilisemaks auditeerimiseks \"\n\"vähemalt hääletamisperioodi lõpuni.\"\nmsgstr \"\"\n\"The main function of the Registration Service is to receive signed \"\n\"registration requests from the Voting Service, validate them with a \"\n\"signed response from the Voting Service, and store them for later audit \"\n\"at least until the end of the voting period.\"\n\n#: ../../kogumisteenus.rst:325\nmsgid \"Auditeerimisel tekkivate võimalike erisuste lahendamiseks on oluline, et\"\nmsgstr \"\"\n\"In order to address possible differences in auditing, it is important \"\n\"that.\"\n\n#: ../../kogumisteenus.rst:327\nmsgid \"\"\n\"Registreerimisteenus on võimeline tõestama, et igale tema poolt \"\n\"väljastatud kinnitusele eelnes Talletamisteenuse poolne \"\n\"registreerimispäring;\"\nmsgstr \"\"\n\"The Registration service is able to prove that each confirmation issued \"\n\"by it was preceded by a registration request from the Storage;\"\n\n#: ../../kogumisteenus.rst:330\nmsgid \"\"\n\"Talletamisteenus on võimeline tõestama, et iga tema poolt talletatud \"\n\"hääle kohta on olemas Registreerimisteenuse kinnitus.\"\nmsgstr \"\"\n\"The Storage is able to prove that there is a confirmation from the \"\n\"Registration Service for each vote it has stored.\"\n\n#: ../../kogumisteenus.rst:333\nmsgid \"\"\n\"Piisav protokoll sellise tõendamistaseme saavutamiseks on, kus mõlemal \"\n\"osapoolel on olemas võtmepaar allkirjastamiseks, päringud ja vastused on \"\n\"allkirjastatud ning kumbki pool peab registrit teise poole teadete üle. \"\n\"Selline protokoll on realiseeritav näiteks OCSP-põhise \"\n\"Registreerimisteenuse korral. Samas võib esineda juhtumeid, kus näiteks \"\n\"registreerimispäringute allkirjastamine ei ole standardsete vahenditega \"\n\"võimalik (RFC 3161 põhine registreerimine). Sellisel juhul tuleb \"\n\"registreerimisteenusele vajalik tõendusmaterjal anda muude \"\n\"organisatsioonilis-tehniliste vahenditega.\"\nmsgstr \"\"\n\"A sufficient protocol to achieve this level of confirmation is where both\"\n\" parties have a key pair to sign, queries and responses are signed, and \"\n\"each party keeps a record of the other party's messages. Such a protocol \"\n\"is feasible, for example, in the case of an OCSP-based Registration \"\n\"Service. However, there may be cases where, for example, signing of \"\n\"registration requests is not possible by standard means (RFC 3161-based \"\n\"registration). In such cases, the necessary evidence for the Registration\"\n\" Service must be provided by other organisational/technical means.\"\n\n#: ../../kogumisteenus.rst:342\nmsgid \"Registreerimisteenusel on praegu kaks erinevat teostust:\"\nmsgstr \"The registration service currently has two different implementations:\"\n\n#: ../../kogumisteenus.rst:344\nmsgid \"\"\n\"OCSP-liides eeldab Eestis rakendatava OCSP-põhise ajamärgendamisteenuse \"\n\"kasutamist, kus allkirjastatud OCSP-päringu nonsiks on Hääletamisteenuse \"\n\"poolt pandud hääle räsi. Päring on allkirjastatud standardsete OCSP \"\n\"vahenditega;\"\nmsgstr \"\"\n\"The OCSP interface requires the use of the OCSP-based timemarking service\"\n\" implemented in Estonia, where the nonce of a signed OCSP request is the \"\n\"hash of the vote cast by the Voting Service. The query is signed using \"\n\"standard OCSP tools;\"\n\n#: ../../kogumisteenus.rst:349\nmsgid \"\"\n\"RFC 3161 liides, mille korral ebastandardse lahendusena pannakse \"\n\"ajatemplipäringu nonsiks Hääletamisteenuse poolt allkirjastatud hääle \"\n\"räsi.\"\nmsgstr \"\"\n\"RFC 3161 interface, where as a non-standard solution the nonce of a \"\n\"timestamp request is set to a hash of the vote signed by the Vote \"\n\"Service.\"\n\n#: ../../kogumisteenus.rst:354\nmsgid \"Kogumisteenuse laiendusmoodulite lisamine\"\nmsgstr \"Adding collection service extension modules\"\n\n#: ../../kogumisteenus.rst:356\nmsgid \"Kogumisteenuse API defineerib kuute tüüpi laiendusmooduleid:\"\nmsgstr \"The Collection API defines six types of extension modules:\"\n\n#: ../../kogumisteenus.rst:358\nmsgid \"isikutuvastus (Go pakk ``ivxv.ee/auth``, näiteks ``tls``);\"\nmsgstr \"authentication (Go package ``ivxv.ee/auth``, for example ``tls``);\"\n\n#: ../../kogumisteenus.rst:360\nmsgid \"\"\n\"tuvastatud isiku sertifikaadist valija identifikaatori tuletamine (Go \"\n\"pakk ``ivxv.ee/identity``, näiteks ``serialnumber``);\"\nmsgstr \"\"\n\"derivation of the voter identifier from the certificate of the \"\n\"authenticated person (Go package ``ivxv.ee/identity``, for example \"\n\"``serialnumber``);\"\n\n#: ../../kogumisteenus.rst:363\nmsgid \"\"\n\"valija identifikaatorist vanuse tuletamine (Go pakk ``ivxv.ee/age``, \"\n\"näiteks ``estpic``);\"\nmsgstr \"\"\n\"deriving the age of a voter from the voter's identifier (Go package \"\n\"``ivxv.ee/age``, for example ``estpic``);\"\n\n#: ../../kogumisteenus.rst:366\nmsgid \"\"\n\"allkirjastatud konteineri verifitseerimine (Go pakk \"\n\"``ivxv.ee/container``, näiteks ``bdoc``);\"\nmsgstr \"\"\n\"verification of a signed container (Go package ``ivxv.ee/container``, for\"\n\" example ``bdoc``);\"\n\n#: ../../kogumisteenus.rst:369\nmsgid \"allkirja kvalifitseerimine (Go pakk ``ivxv.ee/q11n``, näiteks ``tspreg``);\"\nmsgstr \"\"\n\"signature qualification (Go package ``ivxv.ee/q11n``, for example \"\n\"``tspreg``);\"\n\n#: ../../kogumisteenus.rst:371\nmsgid \"andmetalletusprotokoll (Go pakk ``ivxv.ee/storage``, näiteks ``etcd``).\"\nmsgstr \"storage protocol (Go package ``ivxv.ee/storage``, for example ``etcd``).\"\n\n#: ../../kogumisteenus.rst:373\nmsgid \"\"\n\"Uue mooduli lisamiseks tuleb moodulpakki lisada mooduli identifikaator \"\n\"ning mooduli teostusega alampakk. Alampaki alglaadimisel tuleb mooduli \"\n\"registreerimiseks kutsuda välja moodulpaki ``Register`` funktsioon.\"\nmsgstr \"\"\n\"In order to add a new module, the module identifier and the sub-package \"\n\"with the module implementation must be added to the module package. The \"\n\"``Register`` function of the module package must be called to register \"\n\"the module when the sub-package is initially loaded.\"\n\n#: ../../kogumisteenus.rst:377\nmsgid \"\"\n\"Uue mooduli kasutamiseks tuleb selle identifikaator lisada seadistusse \"\n\"vastava moodulitüübi seadistuse juurde koos alammooduli seadistusega. \"\n\"Laiendusmoodulile antakse ette tema identifikaatoriga viidatud \"\n\"seadistusblokk, mida see mooduli-siseselt edasi töötleb.\"\nmsgstr \"\"\n\"In order to use a new module, its identifier must be added to the \"\n\"configuration of the corresponding module type, together with the \"\n\"configuration of the sub-module. The extension module shall be provided \"\n\"with a configuration block referenced by its identifier, which it shall \"\n\"further process within the module.\"\n\n#: ../../kogumisteenus.rst:382\nmsgid \"\"\n\"Moodulpakid ja nende moodulitelt nõutavad liidesed on täpsemalt \"\n\"kirjeldatud vastavates lähtekoodifailides. Samuti on iga mooduli kohta \"\n\"olemas vähemalt üks teostus, mida saab kasutada eeskujuna.\"\nmsgstr \"\"\n\"The module packages and the interfaces required from these modules are \"\n\"described in more detail in the source code. There is also at least one \"\n\"implementation of each module that can be used as an example.\"\n\n#: ../../kogumisteenus.rst:388\nmsgid \"Monitooring\"\nmsgstr \"Monitoring\"\n\n#: ../../kogumisteenus.rst:392\nmsgid \"Monitooringulahendus\"\nmsgstr \"Monitoring solution\"\n\n#: ../../kogumisteenus.rst:395\nmsgid \"Logimine\"\nmsgstr \"Logging\"\n\n#: ../../kogumisteenus.rst:397\nmsgid \"\"\n\"Iga mikroteenuse poolt genereeritav logi defineeritakse süstemaatiliselt,\"\n\" lähtudes protokollikirjeldusest ning teenuse osutamise olekudiagrammist.\"\n\" Logitakse minimaalselt:\"\nmsgstr \"\"\n\"Each log generated by a microservice is systematically defined based on \"\n\"the protocol description and the service provision status diagram. Logs \"\n\"shall be kept to a minimum:\"\n\n#: ../../kogumisteenus.rst:401\nmsgid \"iga päringu kättesaamise fakt ning töötlemise algus;\"\nmsgstr \"the fact of receipt of each request and the start of processing;\"\n\n#: ../../kogumisteenus.rst:403\nmsgid \"töötlemise üleandmine välisele komponendile;\"\nmsgstr \"transfer of processing to an external component;\"\n\n#: ../../kogumisteenus.rst:405\nmsgid \"töötlemisjärje naasmine komponenti;\"\nmsgstr \"the processing stage return component;\"\n\n#: ../../kogumisteenus.rst:407\nmsgid \"päringu töötlemise lõpp ning tulemus;\"\nmsgstr \"the end of query processing and the result;\"\n\n#: ../../kogumisteenus.rst:409\nmsgid \"täiendavalt oluliste etappide läbimine protsessi olekumudelis.\"\nmsgstr \"additional key steps in the process status model.\"\n\n#: ../../kogumisteenus.rst:411\nmsgid \"Logimisel järgitakse järgmisi põhimõtteid:\"\nmsgstr \"Logging is based on the following principles:\"\n\n#: ../../kogumisteenus.rst:413\nmsgid \"\"\n\"Logimiseks kasutatakse rsyslog teenust, mis registreerib logiteate \"\n\"kirjutamise hetke millisekundi täpsusega;\"\nmsgstr \"\"\n\"Logging is done using the rsyslog service, which records the time of \"\n\"writing a log message to the nearest millisecond;\"\n\n#: ../../kogumisteenus.rst:416\nmsgid \"\"\n\"Iga seansi alustamisel genereerib süsteem unikaalse identifikaatori, mida\"\n\" klientrakendus kasutab oma päringutel kesksüsteemi poole pöördumiseks;\"\nmsgstr \"\"\n\"At the start of each session, the system generates a unique identifier \"\n\"that the client application uses in its queries to access the central \"\n\"system;\"\n\n#: ../../kogumisteenus.rst:419\nmsgid \"\"\n\"Kõik ühe seansi alla kuuluvad logikirjed sisaldavad sama \"\n\"seansiidentifikaatorit;\"\nmsgstr \"All the logs belonging to one session contain the same session identifier;\"\n\n#: ../../kogumisteenus.rst:422\nmsgid \"Logikirje on unikaalselt identifitseeritav;\"\nmsgstr \"The log record is uniquely identifiable;\"\n\n#: ../../kogumisteenus.rst:424\nmsgid \"\"\n\"Iga logitava teate juures on võimalik unikaalse tunnuse abil üksüheselt \"\n\"tuvastada teate tekkimise koht monitooritavas süsteemis;\"\nmsgstr \"\"\n\"For each logged message it is possible to uniquely identify, by means of \"\n\"a unique identifier, where the message originated in the monitored \"\n\"system;\"\n\n#: ../../kogumisteenus.rst:427\nmsgid \"\"\n\"Logikirje on JSON vormingus, automaatse monitooringu jaoks on \"\n\"masinloetavus primaarne ning inimloetavus sekundaarne;\"\nmsgstr \"\"\n\"The log record is in JSON format, with machine readability primary and \"\n\"human readability secondary for automatic monitoring;\"\n\n#: ../../kogumisteenus.rst:430\nmsgid \"\"\n\"Logisse minev info saneeritakse (urlencode) ja sellele rakendatakse \"\n\"pikkuse piirangut (piirang terve logiteate ja samuti parameetri kaupa);\"\nmsgstr \"\"\n\"The information that goes into the log is sanitized (urlencode) and a \"\n\"length limit is applied (limit per whole log message and also per \"\n\"parameter);\"\n\n#: ../../kogumisteenus.rst:433\nmsgid \"\"\n\"Süsteemiperimeetrist väljastpoolt pärinevat infot logitakse ainult \"\n\"saneerituna ja ainult etteantud pikkuses.\"\nmsgstr \"\"\n\"Information coming from outside the system perimeter is logged only as \"\n\"redundant and only at a predefined length.\"\n\n#: ../../kogumisteenus.rst:436\nmsgid \"\"\n\"Kuna logimine toimub rsyslog vahendusel, on võimalik Guardtime mooduli \"\n\"kasutamine logide tervikluse tagamiseks.\"\nmsgstr \"\"\n\"Since logging is done via rsyslog, it is possible to use the Guardtime \"\n\"module to ensure log integrity.\"\n\n#: ../../kogumisteenus.rst:441\nmsgid \"Üldstatistika\"\nmsgstr \"General statistics\"\n\n#: ../../kogumisteenus.rst:443\nmsgid \"Järgmise statistika jälgimiseks kasutatakse staatilist veebiliidest:\"\nmsgstr \"A static web interface is used to monitor the following statistics:\"\n\n#: ../../kogumisteenus.rst:445\nmsgid \"edukalt kogutud hääled/hääletajate hulk;\"\nmsgstr \"number of votes successfully collected/votes cast;\"\n\n#: ../../kogumisteenus.rst:447\nmsgid \"\"\n\"hääletajate jagunemine sugude, vanusegruppide, operatsioonisüsteemide \"\n\"ning autentimisvahendite kaupa;\"\nmsgstr \"\"\n\"breakdown of voters by gender, age group, operating system and \"\n\"authentication means;\"\n\n#: ../../kogumisteenus.rst:450\nmsgid \"edukalt kontrollitud häälte/hääletajate hulk;\"\nmsgstr \"the number of successfully verified votes/votes;\"\n\n#: ../../kogumisteenus.rst:452\nmsgid \"korduvhääletamiste statistika;\"\nmsgstr \"statistics on re-votes;\"\n\n#: ../../kogumisteenus.rst:454\nmsgid \"hääletajate jagunemine riigiti IP-aadressi põhjal.\"\nmsgstr \"breakdown of voters by country, based on IP address.\"\n\n#: ../../kogumisteenus.rst:458\nmsgid \"Detailstatistika\"\nmsgstr \"Detailed statistics\"\n\n#: ../../kogumisteenus.rst:460\nmsgid \"\"\n\"Detailstatistika agregeeritakse logide põhjal kasutades SCCEIV \"\n\"logianalüsaatorit, mis analüüsib rakenduste tegevuslogi eeldefineeritud \"\n\"profiili suhtes ning võimaldab seansi-/veatüübipõhist analüüsi.\"\nmsgstr \"\"\n\"Detailed statistics are aggregated from logs using the SCCEIV log \"\n\"analyser, which analyses the activity logs of applications against a \"\n\"predefined profile and allows for a session/vehicle type analysis.\"\n\n#: ../../kogumisteenus.rst:464\nmsgid \"Detailstatistika on kättesaadav üle HTTPS-liidese.\"\nmsgstr \"Detailed statistics are available over HTTPS.\"\n\n#: ../../kogumisteenus.rst:470\nmsgid \"Haldus\"\nmsgstr \"Administration\"\n\n#: ../../kogumisteenus.rst:472\nmsgid \"\"\n\"Kogumisteenuse haldamine toimub digitaalallkirjastatud seadistuspakkide \"\n\"abil.\"\nmsgstr \"\"\n\"The collection service is managed by means of digitally signed \"\n\"configuration packs.\"\n\n#: ../../kogumisteenus.rst:474\nmsgid \"Kogumisteenus pakub seadistuspakkide laadimiseks kahte liidest:\"\nmsgstr \"\"\n\"The collection service provides two interfaces for loading configuration \"\n\"packages:\"\n\n#: ../../kogumisteenus.rst:476\nmsgid \"\"\n\"Käsurealiides – rakendus verifitseerib allkirja, valideerib korralduste \"\n\"vormingut, kooskõlalisust ja sobivust kogumisteenuse seisundi suhtes. \"\n\"Korralduse rakendamine toimub eraldi utiliidi abil.\"\nmsgstr \"\"\n\"Command line interface - the application verifies the signature, \"\n\"validates the format, consistency and appropriateness of the orders \"\n\"against the status of the collection service. The execution of the order \"\n\"is done through a separate utility.\"\n\n#: ../../kogumisteenus.rst:480\nmsgid \"\"\n\"Veebiliides – veebiliides vahendab seadistuspaki käsurealiidesele ja \"\n\"tagastab kasutajale info laadimise tulemuse kohta. Eduka laadimise korral\"\n\" toimub automaatselt ja samadel põhimõtetel ka seadistuspaki rakendamine.\"\nmsgstr \"\"\n\"Web interface - the web interface passes the configuration package to the\"\n\" command line interface and returns information about the result of the \"\n\"loading to the user. In case of a successful load, the implementation of \"\n\"the configuration package is automatic and follows the same principles.\"\n\n#: ../../kogumisteenus.rst:484\nmsgid \"Veebiliidese funktsioonideks on:\"\nmsgstr \"The features of the web interface are:\"\n\n#: ../../kogumisteenus.rst:486\nmsgid \"Kogumisteenuse mikroteenuste seisundi jälgimine;\"\nmsgstr \"Monitoring the status of collection microservices;\"\n\n#: ../../kogumisteenus.rst:488\nmsgid \"Valimiste nimekirjade haldus;\"\nmsgstr \"Management of voter lists;\"\n\n#: ../../kogumisteenus.rst:490\nmsgid \"Statistika kuvamine e-hääletamise kulgemise kohta;\"\nmsgstr \"Displaying statistics on the progress of e-voting;\"\n\n#: ../../kogumisteenus.rst:492\nmsgid \"Haldusteenuse kasutajate haldus;\"\nmsgstr \"Management of users of the management service;\"\n\n#: ../../kogumisteenus.rst:494\nmsgid \"Kogumisteenuse halduse logi kuvamine.\"\nmsgstr \"Display the collection service management log.\"\n\n#: ../../kogumisteenus.rst:496\nmsgid \"\"\n\"Kõik rakendusele antud korraldused säilitatakse - ka need mida ei \"\n\"rakendatud. Vigaseid (mittevalideeruvaid) korraldusi ei säilitata.\"\nmsgstr \"\"\n\"All orders given to the application are kept - even those that were not \"\n\"applied. Incorrect (non-validated) orders are not retained.\"\n\n#: ../../kogumisteenus.rst:499\nmsgid \"Kogumisteenuse haldusteenus sooritab järgmisi tegevusi automaatselt:\"\nmsgstr \"\"\n\"The collection management service automatically performs the following \"\n\"actions:\"\n\n#: ../../kogumisteenus.rst:501\nmsgid \"Valijate nimekirjade muudatuste laadimine Valimiste Infosüsteemist;\"\nmsgstr \"\"\n\"Downloading changes to electoral rolls from the Election Information \"\n\"System;\"\n\n#: ../../kogumisteenus.rst:503\nmsgid \"\"\n\"Hääletamise statistika kogumine hääletusteenusest ja eksportimine \"\n\"Valimiste Infosüsteemi;\"\nmsgstr \"\"\n\"Collection of voting statistics from the voting service and export to the\"\n\" Election Information System;\"\n\n#: ../../kogumisteenus.rst:506\nmsgid \"Talletatud häälte, logide ning seadistuste varundamine varundusteenusesse.\"\nmsgstr \"Backing up saved voices, logs and settings to a backup service.\"\n\n#: ../../kogumisteenus.rst:510\nmsgid \"Haldusteenuse komponendid\"\nmsgstr \"Components of a management service\"\n\n#: ../../kogumisteenus.rst:514\nmsgid \"Kogumisteenuse haldusteenuse komponendid\"\nmsgstr \"Components of a collection management service\"\n\n#: ../../kogumisteenus.rst:516\nmsgid \"\"\n\"**Halduse veebiserver** on süsteemse kasutaja ``www-data`` õigustes \"\n\"töötav Apache server, mille ülesanded on:\"\nmsgstr \"\"\n\"The **Administrative Web Server** is an Apache server running as ``www-\"\n\"data`` for the system user, whose functions are:\"\n\n#: ../../kogumisteenus.rst:519\nmsgid \"Kasutajatelt tulevate HTTPS-päringute esmane teenindamine:\"\nmsgstr \"Serving HTTPS requests from users on a first-come, first-served basis:\"\n\n#: ../../kogumisteenus.rst:521\nmsgid \"Haldusteenuse usaldusväärsuse tõestamine (TLS-sertifikaat);\"\nmsgstr \"Proof of trustworthiness of the management service (TLS certificate);\"\n\n#: ../../kogumisteenus.rst:523\nmsgid \"Kasutajate autentimine;\"\nmsgstr \"User authentication;\"\n\n#: ../../kogumisteenus.rst:525\nmsgid \"\"\n\"Valmisgenereeritud veebilehtede ja andmefailide serveerimine \"\n\"andmehoidlast.\"\nmsgstr \"Serving pre-built web pages and data files from the repository.\"\n\n#: ../../kogumisteenus.rst:528\nmsgid \"\"\n\"Üldiste taustaandmete päringu vastuse varustamine sisseloginud kasutaja \"\n\"andmetega (WSGI).\"\nmsgstr \"\"\n\"Supplying the response to a general background query with the logged-in \"\n\"user's data (WSGI).\"\n\n#: ../../kogumisteenus.rst:531\nmsgid \"\"\n\"Üleslaaditavate korralduste esmane valideerimine ja vahendamine \"\n\"haldusdeemonile ning haldusdeemoni sellekohaste vastuste vahendamine \"\n\"kliendile (WSGI).\"\nmsgstr \"\"\n\"Initial validation and transmission of uploaded instructions to the \"\n\"management daemon and transmission of the management daemon's responses \"\n\"to the client (WSGI).\"\n\n#: ../../kogumisteenus.rst:535\nmsgid \"\"\n\"**Haldusdeemon** on kasutajakonto ``ivxv-admin`` õigustes töötav ja \"\n\"kohalikul (``localhost``) liidesel kuulav veebiserver mille ülesanded on:\"\nmsgstr \"\"\n\"The **administrative daemon** is a web server running under ``ivxv-\"\n\"admin`` privileges and listening on the local (``localhost``) interface \"\n\"with the following tasks:\"\n\n#: ../../kogumisteenus.rst:538\nmsgid \"Üleslaaditavate korralduste valideerimine;\"\nmsgstr \"Validation of downloadable orders;\"\n\n#: ../../kogumisteenus.rst:540\nmsgid \"Üleslaaditavate korralduste vahetu rakendamine (kasutajate haldus);\"\nmsgstr \"Immediate implementation of uploading instructions (user management);\"\n\n#: ../../kogumisteenus.rst:542\nmsgid \"\"\n\"Üleslaaditavate korralduste salvestamine hilisemaks rakendamiseks \"\n\"(seadistuse ja valimisnimekirjade rakendamiseks teenusele);\"\nmsgstr \"\"\n\"Saving of uploaded orders for later implementation (application of configurations and \"\n\"voter lists for the service);\"\n\n#: ../../kogumisteenus.rst:545\nmsgid \"E-valimiskasti allalaadimise vahendamine.\"\nmsgstr \"Facilitating the downloading of the digital ballot box.\"\n\n#: ../../kogumisteenus.rst:547\nmsgid \"\"\n\"**Agentdeemon** on kasutajakonto ``ivxv-admin`` õigustes töötav deemon, \"\n\"mille ülesanded on:\"\nmsgstr \"\"\n\"The **Agentdeemon** is a daemon with ``ivxv-admin`` privileges, whose \"\n\"tasks are:\"\n\n#: ../../kogumisteenus.rst:550\nmsgid \"Andmete kogumine ja registreerimine:\"\nmsgstr \"Data collection and recording:\"\n\n#: ../../kogumisteenus.rst:552\nmsgid \"Teadaolevate mikroteenuste seisund;\"\nmsgstr \"Status of known microservices;\"\n\n#: ../../kogumisteenus.rst:554\nmsgid \"Tegevusmonitooringu statistika allalaadimine;\"\nmsgstr \"Download statistics of activity;\"\n\n#: ../../kogumisteenus.rst:556\nmsgid \"\"\n\"**Andmehoidla** on failisüsteemis asuv kataloog, kuhu haldusteenuse \"\n\"komponendid hoiavad kogutud ja genereeritud andmeid (vaata üksikasjalist \"\n\"kirjeldust ``IVXV kogumisteenuse haldusjuhendi`` lisadest);\"\nmsgstr \"\"\n\"**Remote repository** is the directory in the file system where the \"\n\"components of the management service store the collected and generated \"\n\"data (see detailed description in the annexes of the ``IVXV Collection \"\n\"Management Guide``);\"\n\n#: ../../kogumisteenus.rst:560\nmsgid \"Välised komponendid, millega haldusteenus kokku puutub:\"\nmsgstr \"External components with which the management service comes into contact:\"\n\n#: ../../kogumisteenus.rst:562\nmsgid \"\"\n\"**Kogumisteenuse alamteenused** - paigaldamine, seadistamine ja seisundi \"\n\"andmete kogumine toimub agentdeemoni kaudu (SSH-ühendus teenuse \"\n\"masinasse);\"\nmsgstr \"\"\n\"**Collection Service Subservices** - installation, configuration and \"\n\"status data collection is done via agent daemon (SSH connection to the \"\n\"service machine);\"\n\n#: ../../kogumisteenus.rst:565\nmsgid \"\"\n\"**Seireserver** - üldstatistika andmete allalaadimine haldusteenuses \"\n\"kuvamiseks;\"\nmsgstr \"\"\n\"**Monitoring** - download of general statistics data for display in the \"\n\"administrative service;\"\n\n#: ../../kogumisteenus.rst:570\nmsgid \"Korralduste laadimine haldusteenusesse\"\nmsgstr \"Uploading orders to the management service\"\n\n#: ../../kogumisteenus.rst:574\nmsgid \"Kogumisteenuse seisundid\"\nmsgstr \"Collection service conditions\"\n\n#: ../../kogumisteenus.rst:576\nmsgid \"\"\n\"Kogumisteenuse seisund kajastab teenuse kõigi alamteenuste seisundit, \"\n\"kasutuselolevate väliste teenuste seisundit ja eelneva põhjal tuletatud \"\n\"üldseisundit. Kogumisteenuse üldseisundi tuvastamisega tegeleb \"\n\"haldusteenus.\"\nmsgstr \"\"\n\"The state of the collection service reflects the state of all sub-\"\n\"services of the service, the state of the external services in use and \"\n\"the overall state derived from the previous buffer. The identification of\"\n\" the overall status of the collection service is handled by the \"\n\"management service.\"\n\n#: ../../kogumisteenus.rst:580\nmsgid \"Üldseisundi olekud on:\"\nmsgstr \"The overall status is:\"\n\n#: ../../kogumisteenus.rst:582\nmsgid \"\"\n\"**Paigaldamata** - alates haldusteenuse paigaldamisest kuni kõigi \"\n\"alamteenuste paigaldamiseni;\"\nmsgstr \"\"\n\"**Uninstalled** - from the installation of the management service to the \"\n\"installation of all sub-services;\"\n\n#: ../../kogumisteenus.rst:585\nmsgid \"\"\n\"**Paigaldatud** - kõik alamteenused on paigaldatud, neile on rakendatud \"\n\"tehnilised seadistused ja teenuse toimimiseks vajalikud krüptovõtmed. \"\n\"Valimiste seadistust pole rakendatud (kuid see võib olla laaditud \"\n\"haldusteenusesse);\"\nmsgstr \"\"\n\"**Installed** - all sub-services have been installed, with the technical \"\n\"settings and cryptographic keys necessary for the service to work. The \"\n\"configuration for elections has not been applied (but may be loaded into \"\n\"the management service);\"\n\n#: ../../kogumisteenus.rst:590\nmsgid \"\"\n\"**Seadistatud** - kogumisteenus on seadistatud ja töökorras, sellega on \"\n\"võimalik häälte kogumist läbi viia ja e-valimiskasti väljastada.\"\nmsgstr \"\"\n\"**Set up** - the collection service is set up and operational, it is able\"\n\" to vote and issue digital ballot box.\"\n\n#: ../../kogumisteenus.rst:593\nmsgid \"\"\n\"**Osaline tõrge** - kogumisteenus on seadistatud ja osaliselt töökorras, \"\n\"mõned alamteenused pole töökorras, kuid see ei takista kogumisteenuse \"\n\"toimimist.\"\nmsgstr \"\"\n\"**Partial failure** - the collection service is configured and partially \"\n\"operational, some of the sub-services are not operational but this does \"\n\"not prevent the collection service from working.\"\n\n#: ../../kogumisteenus.rst:597\nmsgid \"\"\n\"**Tõrge** - kogumisteenuse oluline sõlm pole töökorras, teenuse \"\n\"nõuetekohane osutamine pole võimalik.\"\nmsgstr \"\"\n\"**Failure** - an essential node of the collection service is not in \"\n\"working order, the proper provision of the service is not possible.\"\n\n#: ../../kogumisteenus.rst:603\nmsgid \"\"\n\"Kogumisteenuse olekudiagramm. Olekud vastavalt värvusele: kollane - \"\n\"seadistamisel, punane - viga, roheline - töökorras.\"\nmsgstr \"\"\n\"Collection service status diagram. LEDs according to colour: yellow - in \"\n\"configuration, red - error, green - operational.\"\n\n#: ../../kogumisteenus.rst:608\nmsgid \"Kogumisteenuse alamteenuste seisundid\"\nmsgstr \"Collection sub-service statuses\"\n\n#: ../../kogumisteenus.rst:613\nmsgid \"\"\n\"Haldusteenuse poolt registreeritud alamteenuse olekudiagramm. Olekud \"\n\"vastavalt värvusele: kollane - seadistamisel, punane - viga, roheline - \"\n\"töökorras.\"\nmsgstr \"\"\n\"Status diagram of a sub-service registered by the management service. \"\n\"LEDs according to colour: yellow - in configuration, red - error, green -\"\n\" operational.\"\n\n#: ../../kogumisteenus.rst:619\nmsgid \"Kogumisteenuse seisundi muutused\"\nmsgstr \"Changes in the status of the collection service\"\n\n#: ../../kogumisteenus.rst:621\nmsgid \"\"\n\"Kogumisteenuse seisund on jälgitav alates haldusteenuse edukast \"\n\"paigaldamisest, algne seisund on **Paigaldamata**.\"\nmsgstr \"\"\n\"The status of the collection service is traceable from the successful \"\n\"installation of the management service, the initial status is \"\n\"**Uninstalled**.\"\n\n#: ../../kogumisteenus.rst:626\nmsgid \"Paigaldamata\"\nmsgstr \"Not yet installed\"\n\n#: ../../kogumisteenus.rst:628\nmsgid \"Toimub usaldusjuure ja tehnilise seadistuse rakendamine kogumisteenusele:\"\nmsgstr \"\"\n\"Implementation of the trust root and technical setup for the collection \"\n\"service:\"\n\n#: ../../kogumisteenus.rst:630\nmsgid \"Seadistuste laadimine kogumisteenusesse;\"\nmsgstr \"Uploading settings to the collection service;\"\n\n#: ../../kogumisteenus.rst:632\nmsgid \"Tehnilises seadistuses kirjeldatud alamteenuste paigaldus;\"\nmsgstr \"Installation of the sub-services described in the technical configuration;\"\n\n#: ../../kogumisteenus.rst:634\nmsgid \"Usaldusjuure ja tehniliste seadistuste rakendamine alamteenustele;\"\nmsgstr \"Implementation of trust root and technical settings for sub-services;\"\n\n#: ../../kogumisteenus.rst:636\nmsgid \"\"\n\"Seadistuste eduka rakendamise tulemusena saab süsteemi uueks seisundiks \"\n\"**Paigaldatud**.\"\nmsgstr \"\"\n\"Successful implementation of the settings will result in a new system \"\n\"status of **Installed**.\"\n\n#: ../../kogumisteenus.rst:641\nmsgid \"Paigaldatud\"\nmsgstr \"Installed\"\n\n#: ../../kogumisteenus.rst:643\nmsgid \"\"\n\"Kogumisteenuse seadistused on rakendatud kõigile alamteenustele, \"\n\"valimiste seadistused pole rakendatud. Toimub valimiste seadistuse \"\n\"laadimine haldusteenusesse ja rakendamine alamteenustele.\"\nmsgstr \"\"\n\"Collection service settings are applied to all sub-services, election \"\n\"settings are not applied. Election settings are being loaded into the \"\n\"management service and applied to sub-services.\"\n\n#: ../../kogumisteenus.rst:647\nmsgid \"\"\n\"Valimiste seadistuse eduka rakendamise korral saab süsteemi uueks \"\n\"seisundiks **Seadistatud**.\"\nmsgstr \"\"\n\"If the configuration is successfully implemented, the system will have a \"\n\"new status of **Set up**.\"\n\n#: ../../kogumisteenus.rst:652\nmsgid \"Seadistatud\"\nmsgstr \"Set up\"\n\n#: ../../kogumisteenus.rst:654\nmsgid \"\"\n\"Kõik kogumisteenuse alamteenused on seadistatud ja töökorras. \"\n\"Haldusteenusel on kõikidest alamteenustest värsked seisundiraportid. \"\n\"Süsteemiga on võimalik hääletust läbi viia ja e-valimiskasti väljastada.\"\nmsgstr \"\"\n\"All sub-services of the collection service are configured and \"\n\"operational. The management service has up-to-date status reports for all\"\n\" sub-services. The system is able to conduct voting and issue digital \"\n\"ballot box.\"\n\n#: ../../kogumisteenus.rst:658\nmsgid \"Kui süsteemis tuvastatakse tõrge, saab süsteemi uueks **Osaline tõrge**.\"\nmsgstr \"\"\n\"If a fault is detected in the system, the system will be reset to \"\n\"**Partial fault**.\"\n\n#: ../../kogumisteenus.rst:660\nmsgid \"\"\n\"**Seadistatud** olekust ei pöörduta enam kunagi tagasi olekutesse \"\n\"**paigaldamata** või **paigaldatud**, kuigi uute alamteenuste lisamisel \"\n\"(kuni need on olekus **paigaldamata/paigaldatud**) oleks vastavad \"\n\"tingimused täidetud.\"\nmsgstr \"\"\n\"The **Set-up** state will never return to the **Uninstalled** or \"\n\"**Installed** states, even if new sub-services are added (as long as they\"\n\" are in the **Uninstalled/Installed** state).\"\n\n#: ../../kogumisteenus.rst:667\nmsgid \"Osaline tõrge\"\nmsgstr \"Partial failure\"\n\n#: ../../kogumisteenus.rst:669\nmsgid \"\"\n\"Süsteem on seadistatud ja osaliselt töökorras, mõned süsteemi dubleeritud\"\n\" osad pole töökorras, kuid see ei takista süsteemil toimimast.\"\nmsgstr \"\"\n\"The system is configured and partially operational, some duplicated parts\"\n\" of the system are not operational, but this does not prevent the system \"\n\"from working.\"\n\n#: ../../kogumisteenus.rst:672\nmsgid \"\"\n\"Rikke süvenemisel piirini, kus süsteem pole võimeline teenust osutama, \"\n\"saab süsteemi uueks olekuks **Tõrge**. Kõigi rikete kõrvaldamise järel \"\n\"saab süsteemi uueks olekuks **Seadistatud**.\"\nmsgstr \"\"\n\"If the failure reaches the point where the system is unable to provide \"\n\"service, the system will be set to a new status of **Failure**. When all \"\n\"faults have been cleared, the system will be set to **Set up**.\"\n\n#: ../../kogumisteenus.rst:678\nmsgid \"Tõrge\"\nmsgstr \"Failure\"\n\n#: ../../kogumisteenus.rst:680\nmsgid \"Seadistatud süsteemil on tuvastatud rike, mis takistab teenuse osutamist.\"\nmsgstr \"\"\n\"A fault has been detected in the configured system, preventing the \"\n\"service from being provided.\"\n\n#: ../../kogumisteenus.rst:682\nmsgid \"\"\n\"Rikete kõrvaldamisel olukorrani, kus süsteemiga on võimalik teenust \"\n\"osutada, saab süsteemi uueks olekuks **Osaline tõrge**.\"\nmsgstr \"\"\n\"When the fault is rectified to a state where the system can provide \"\n\"service, the system will be set to a new status of **Partial failure**.\"\n\n#: ../../kogumisteenus.rst:687\nmsgid \"Eemaldatud\"\nmsgstr \"Removed\"\n\n#: ../../kogumisteenus.rst:689\nmsgid \"Teenus on konfiguratsioonist eemaldatud.\"\nmsgstr \"The service has been removed from the configuration.\"\n\n#: ../../kogumisteenus.rst:693\nmsgid \"Valijate nimekirjade olekud haldusteenuses\"\nmsgstr \"Statuses of electoral rolls in the administrative service\"\n\n#: ../../kogumisteenus.rst:695\nmsgid \"Valijate nimekirja olek võib olla:\"\nmsgstr \"The status of the voters list may be:\"\n\n#: ../../kogumisteenus.rst:697\nmsgid \"**Rakendamise ootel** - nimekiri on laaditud haldusteenusesse;\"\nmsgstr \"**Pending** - the list has been uploaded to the management service;\"\n\n#: ../../kogumisteenus.rst:699\nmsgid \"**Rakendatud** - nimekiri on rakendatud kogumisteenusele;\"\nmsgstr \"**Applied** - the list is applied to the collection service;\"\n\n#: ../../kogumisteenus.rst:701\nmsgid \"\"\n\"**Vigane** - nimekiri on märgitud vigaseks, haldusteenus uusi valijate \"\n\"nimekirjade muudatusi ei laadi;\"\nmsgstr \"\"\n\"**Invalid** - the list is marked as invalid, the administrative service \"\n\"does not create new voter list changes;\"\n\n#: ../../kogumisteenus.rst:704\nmsgid \"**Vahele jäetud** - vigane nimekiri on märgitud vahelejätmiseks.\"\nmsgstr \"**Skipped** - an invalid list is marked for skipping.\"\n\n#: ../../kogumisteenus.rst:708\nmsgid \"Valijate nimekirja olekudiagramm\"\nmsgstr \"Voters list status diagram\"\n\n#: ../../kogumisteenus.rst:710\nmsgid \"Siirdeprotsessid:\"\nmsgstr \"Transition processes:\"\n\n#: ../../kogumisteenus.rst:712\nmsgid \"Nimekirja laadimine haldusteenusesse:\"\nmsgstr \"Uploading the list to the management service:\"\n\n#: ../../kogumisteenus.rst:714\nmsgid \"\"\n\"Algnimekirja laadib kogumisteenuse operaator, nimekirja olekuks saab \"\n\"**Rakendamise ootel**;\"\nmsgstr \"\"\n\"The initial list will be loaded by the collection service operator, the \"\n\"status of the list will be **Pending**;\"\n\n#: ../../kogumisteenus.rst:717\nmsgid \"\"\n\"Muudatusnimekirja laadib haldusteenus. Vastavalt valideerimise tulemusele\"\n\" saab nimekirja olekuks kas **Rakendamise ootel** või **Vigane**;\"\nmsgstr \"\"\n\"The change list is loaded by the management service. Depending on the \"\n\"result of the validation, the status of the list will be either \"\n\"**Pending** or **Viable**;\"\n\n#: ../../kogumisteenus.rst:720\nmsgid \"\"\n\"**Rakendamine kogumisteenusele**: viib läbi haldusteenus **rakendamise \"\n\"ootel** olekus nimekirjaga. Õnnestumisel määratakse nimekirja olekuks \"\n\"**Rakendatud**, vea korral **Vigane**;\"\nmsgstr \"\"\n\"**Upgrading to collection service**: carries out a management service \"\n\"with a list in the **pending** state. If successful, the status of the \"\n\"list is set to **Applied**, if not successful, the status is set to \"\n\"**Invalid**;\"\n\n#: ../../kogumisteenus.rst:724\nmsgid \"\"\n\"**Vahelejätmine**: operaator määrab olekuga **Vigane** nimekirjale oleku \"\n\"**Vahele jäetud**.\"\nmsgstr \"\"\n\"**Skip**: the operator assigns the status **Invalid** to the list with \"\n\"the status **Skipped**.\"\n\n" }, { "path": "Documentation/public/arhitektuur/locales/en/LC_MESSAGES/tehnoloogiad.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-03 15:28+0000\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language: en\\n\"\n\"Language-Team: en \\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../tehnoloogiad.rst:6\nmsgid \"Kasutatavad tehnoloogiad\"\nmsgstr \"Technologies used\"\n\n#: ../../tehnoloogiad.rst:9\nmsgid \"Kogumisteenuse programmeerimiskeel\"\nmsgstr \"Collection service programming language\"\n\n#: ../../tehnoloogiad.rst:11\nmsgid \"\"\n\"Kogumisteenuse tuumikfunktsionaalsus on programmeeritud keeles Go, mis \"\n\"vastab järgmistele hanke nõuetele:\"\nmsgstr \"\"\n\"The core functionality of the collection service is programmed in the Go \"\n\"language, which meets the following procurement requirements:\"\n\n#: ../../tehnoloogiad.rst:14\nmsgid \"Staatiline tüüpimine;\"\nmsgstr \"Static typing;\"\n\n#: ../../tehnoloogiad.rst:16\nmsgid \"Automaatne mäluhaldus;\"\nmsgstr \"Automatic memory management;\"\n\n#: ../../tehnoloogiad.rst:18\nmsgid \"Kompilaator avatud lähtekoodiga;\"\nmsgstr \"Open source compiler;\"\n\n#: ../../tehnoloogiad.rst:20\nmsgid \"Ribastamine (rööprapse).\"\nmsgstr \"Parallel processing (co-routines).\"\n\n#: ../../tehnoloogiad.rst:22\nmsgid \"Kogumisteenuse haldusteenus on programmeeritud keeles Python.\"\nmsgstr \"The collection management service is programmed in Python.\"\n\n#: ../../tehnoloogiad.rst:26\nmsgid \"Rakenduste programmeerimiskeel\"\nmsgstr \"Programming language for applications\"\n\n#: ../../tehnoloogiad.rst:28\nmsgid \"\"\n\"Rakendused on programmeeritud keeles Java, mis vastab hanke nõuetele \"\n\"keele laia leviku ja jätkusuutlikkuse kohta.\"\nmsgstr \"\"\n\"The applications are programmed in Java, which fulfils the requirements \"\n\"of the call for tender for the wide distribution and sustainability of \"\n\"the language.\"\n\n#: ../../tehnoloogiad.rst:33\nmsgid \"Projekti sõltuvused\"\nmsgstr \"Project dependencies\"\n\n#: ../../tehnoloogiad.rst:35\nmsgid \"\"\n\"Projektis kasutatavad kolmandate osapoolte komponendid koos nende \"\n\"motiveeritud kasutamisvajadusega on üles loetletud järgnevates tabelites.\"\n\" Eraldi tabelid on raamistiku pakendamiseks ja töötamiseks ning \"\n\"raamistiku arenduseks ja testimiseks.\"\nmsgstr \"\"\n\"The third-party components used in the project, together with their \"\n\"motivated use, are listed in the tables below. Separate tables are \"\n\"provided for the packaging and operation of the framework and for the \"\n\"development and testing of the framework.\"\n\n#: ../../tehnoloogiad.rst:40\nmsgid \"\"\n\"Kõik IVXV projektis kasutatavad välised teegid asuvad ``ivxv-\"\n\"external.git`` hoidlas või on saadaval platvormil, kus rakendus tööle \"\n\"hakkab.\"\nmsgstr \"\"\n\"All external teegs used in the IVXV project are located in the ``ivxv-\"\n\"external.git`` repository or are available on the platform where the \"\n\"application will run.\"\n\n#: ../../tehnoloogiad.rst:43\nmsgid \"Kõik kogumisteenuses kasutatavad komponendid on avatud lähtekoodiga.\"\nmsgstr \"All components used in the collection service are open source.\"\n\n#: ../../tehnoloogiad.rst:46\nmsgid \"IVXV raamistiku tööks kasutatavad kolmandate osapoolte komponendid\"\nmsgstr \"Third party components used for the operation of the IVXV framework\"\n\n#: ../../tehnoloogiad.rst:50 ../../tehnoloogiad.rst:222\n#: ../../tehnoloogiad.rst:268\nmsgid \"Nimi\"\nmsgstr \"Name\"\n\n#: ../../tehnoloogiad.rst:51 ../../tehnoloogiad.rst:223\n#: ../../tehnoloogiad.rst:269\nmsgid \"Versioon\"\nmsgstr \"Version\"\n\n#: ../../tehnoloogiad.rst:52 ../../tehnoloogiad.rst:224\n#: ../../tehnoloogiad.rst:270\nmsgid \"Litsents (SPDX)\"\nmsgstr \"Licence\"\n\n#: ../../tehnoloogiad.rst:53 ../../tehnoloogiad.rst:225\n#: ../../tehnoloogiad.rst:271\nmsgid \"Kasutusvajadus\"\nmsgstr \"Requirement\"\n\n#: ../../tehnoloogiad.rst:55\nmsgid \"`Bootstrap `_\"\nmsgstr \"`Bootstrap `_\"\n\n#: ../../tehnoloogiad.rst:56\nmsgid \"3.4.1, JavaScript\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:57 ../../tehnoloogiad.rst:62\n#: ../../tehnoloogiad.rst:67 ../../tehnoloogiad.rst:72\n#: ../../tehnoloogiad.rst:87 ../../tehnoloogiad.rst:97\n#: ../../tehnoloogiad.rst:132 ../../tehnoloogiad.rst:137\n#: ../../tehnoloogiad.rst:153 ../../tehnoloogiad.rst:158\n#: ../../tehnoloogiad.rst:163 ../../tehnoloogiad.rst:168\n#: ../../tehnoloogiad.rst:178 ../../tehnoloogiad.rst:213\n#: ../../tehnoloogiad.rst:244 ../../tehnoloogiad.rst:254\nmsgid \"MIT\"\nmsgstr \"MIT\"\n\n#: ../../tehnoloogiad.rst:58 ../../tehnoloogiad.rst:214\nmsgid \"Kogumisteenuse haldusteenuse kasutajaliidese kujundus\"\nmsgstr \"Collection management service interface design\"\n\n#: ../../tehnoloogiad.rst:60\nmsgid \"Bouncy Castle\"\nmsgstr \"Bouncy Castle\"\n\n#: ../../tehnoloogiad.rst:61\nmsgid \"1.78.1, Java\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:63\nmsgid \"ASN1 käsitlemine, andmetüübi BigInteger abifunktsioonid\"\nmsgstr \"ASN1 handling, BigInteger data type support functions\"\n\n#: ../../tehnoloogiad.rst:65\nmsgid \"`Bottle `_\"\nmsgstr \"`Bottle `_\"\n\n#: ../../tehnoloogiad.rst:66\nmsgid \"0.13.2, Python\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:68\nmsgid \"Raamistik kogumisteenuse haldusteenuse veebiliidese teostamiseks\"\nmsgstr \"\"\n\"Framework for the implementation of the web interface for the collection \"\n\"management service\"\n\n#: ../../tehnoloogiad.rst:70\nmsgid \"CAL10N\"\nmsgstr \"CAL10N\"\n\n#: ../../tehnoloogiad.rst:71\nmsgid \"0.8.1, Java\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:73\nmsgid \"Mitmekeelsuse tugi, tõlkefailide valideerimine\"\nmsgstr \"Multilingual support, validation of translation files\"\n\n#: ../../tehnoloogiad.rst:75\nmsgid \"Digidoc 4j\"\nmsgstr \"Digidoc 4j\"\n\n#: ../../tehnoloogiad.rst:76\nmsgid \"5.3.1, Java\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:77\nmsgid \"LGPL-2.1-only\"\nmsgstr \"LGPL-2.1-only\"\n\n#: ../../tehnoloogiad.rst:78\nmsgid \"BDoc konteinerite käsitlemine\"\nmsgstr \"BDoc container handling\"\n\n#: ../../tehnoloogiad.rst:80\nmsgid \"Apache Commons (collections4 4.4)\"\nmsgstr \"Apache Commons (collections4 4.4)\"\n\n#: ../../tehnoloogiad.rst:81\nmsgid \"Java\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:82 ../../tehnoloogiad.rst:92\n#: ../../tehnoloogiad.rst:102 ../../tehnoloogiad.rst:112\n#: ../../tehnoloogiad.rst:122 ../../tehnoloogiad.rst:173\n#: ../../tehnoloogiad.rst:208 ../../tehnoloogiad.rst:239\n#: ../../tehnoloogiad.rst:280\nmsgid \"Apache-2.0\"\nmsgstr \"Apache 2.0\"\n\n#: ../../tehnoloogiad.rst:83\nmsgid \"Digidoc 4j ja PDFBox sõltuvused\"\nmsgstr \"Digidoc 4j and PDFBox dependencies\"\n\n#: ../../tehnoloogiad.rst:85\nmsgid \"`Docopt `_\"\nmsgstr \"`Docopt `_\"\n\n#: ../../tehnoloogiad.rst:86\nmsgid \"0.6.2, Python\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:88\nmsgid \"Kogumisteenuse haldusutiliitide käsurealiidese teostus\"\nmsgstr \"\"\n\"Command line interface for collection service management tool\"\n\n#: ../../tehnoloogiad.rst:90\nmsgid \"`Fasteners `_\"\nmsgstr \"`Fasteners `_\"\n\n#: ../../tehnoloogiad.rst:91\nmsgid \"0.19, Python\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:93\nmsgid \"Kogumisteenuse haldusteenuse protsesside lukustus\"\nmsgstr \"Locking processes for the collection management service\"\n\n#: ../../tehnoloogiad.rst:95\nmsgid \"`gin-gonic `_\"\nmsgstr \"`gin-gonic `_\"\n\n#: ../../tehnoloogiad.rst:96\nmsgid \"1.9.1, Go\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:98\nmsgid \"Veebiraamistik x-tee liidese jaoks\"\nmsgstr \"Web-framework for X-road service interface\"\n\n#: ../../tehnoloogiad.rst:100\nmsgid \"`etcd `_\"\nmsgstr \"`etcd `_\"\n\n#: ../../tehnoloogiad.rst:101\nmsgid \"3.5.9, Go\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:103\nmsgid \"Talletusteenusena kasutatav hajus võti-väärtus andmebaas\"\nmsgstr \"Distributed key-value database used as a storage service\"\n\n#: ../../tehnoloogiad.rst:105\nmsgid \"Glassfish JAXB\"\nmsgstr \"Glassfish JAXB\"\n\n#: ../../tehnoloogiad.rst:106\nmsgid \"4.0.5, Java\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:107 ../../tehnoloogiad.rst:203\n#: ../../tehnoloogiad.rst:229\nmsgid \"BSD-3-Clause\"\nmsgstr \"BSD 3 Clause\"\n\n#: ../../tehnoloogiad.rst:108\nmsgid \"Java XML teek\"\nmsgstr \"Java XML library\"\n\n#: ../../tehnoloogiad.rst:110\nmsgid \"Gradle\"\nmsgstr \"Gradle\"\n\n#: ../../tehnoloogiad.rst:111\nmsgid \"8.11, Java\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:113\nmsgid \"Java rakenduste ehitamise raamistik\"\nmsgstr \"Framework for building Java applications\"\n\n#: ../../tehnoloogiad.rst:115\nmsgid \"`HAProxy `_\"\nmsgstr \"`HAProxy `_\"\n\n#: ../../tehnoloogiad.rst:116\nmsgid \"2.4.24\"\nmsgstr \"2.4.24\"\n\n#: ../../tehnoloogiad.rst:117\nmsgid \"GPL-2.0-or-later\"\nmsgstr \"GPL-2.0-or-later\"\n\n#: ../../tehnoloogiad.rst:118\nmsgid \"Vahendusteenusena kasutatav TCP-proksi\"\nmsgstr \"TCP proxy used as an intermediary service\"\n\n#: ../../tehnoloogiad.rst:120\nmsgid \"Jackson\"\nmsgstr \"Jackson\"\n\n#: ../../tehnoloogiad.rst:121\nmsgid \"2.18.1, Java\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:123\nmsgid \"JSON vormingus failide lugemine ja kirjutamine\"\nmsgstr \"Read and write JSON format files\"\n\n#: ../../tehnoloogiad.rst:125\nmsgid \"Jinja2\"\nmsgstr \"Jinja2\"\n\n#: ../../tehnoloogiad.rst:126\nmsgid \"3.1.4, Python\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:127 ../../tehnoloogiad.rst:188\n#: ../../tehnoloogiad.rst:285\nmsgid \"BSD\"\nmsgstr \"BSD\"\n\n#: ../../tehnoloogiad.rst:128\nmsgid \"Jinja mallide kasutamine haldusteenuses\"\nmsgstr \"Using Jinja templates in collection management service\"\n\n#: ../../tehnoloogiad.rst:130\nmsgid \"`jQuery `_\"\nmsgstr \"`jQuery `_\"\n\n#: ../../tehnoloogiad.rst:131\nmsgid \"3.7.1, JavaScript\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:133 ../../tehnoloogiad.rst:159\n#: ../../tehnoloogiad.rst:164 ../../tehnoloogiad.rst:169\nmsgid \"Kogumisteenuse haldusteenuse kasutajaliides\"\nmsgstr \"Collection management service interface\"\n\n#: ../../tehnoloogiad.rst:135\nmsgid \"jsonschema\"\nmsgstr \"jsonschema\"\n\n#: ../../tehnoloogiad.rst:136\nmsgid \"4.23.0, Python\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:138\nmsgid \"JSON valideerimine haldusteenuses\"\nmsgstr \"JSON validation in collection management service\"\n\n#: ../../tehnoloogiad.rst:140\nmsgid \"Logback\"\nmsgstr \"Logback\"\n\n#: ../../tehnoloogiad.rst:141\nmsgid \"1.5.12, Java\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:142 ../../tehnoloogiad.rst:147\nmsgid \"EPL-1.0 or LGPL-v2.1-only\"\nmsgstr \"EPL-1.0 or LGPL-v2.1-only\"\n\n#: ../../tehnoloogiad.rst:143\nmsgid \"Logimise API teostus\"\nmsgstr \"Implementation of logging API\"\n\n#: ../../tehnoloogiad.rst:145\nmsgid \"Logback JSON\"\nmsgstr \"Logback JSON\"\n\n#: ../../tehnoloogiad.rst:146\nmsgid \"0.1.5, Java\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:148\nmsgid \"\"\n\"Logback logija laiendus JSON vormingus logikirjete koostamiseks Jackson \"\n\"teegi abil\"\nmsgstr \"\"\n\"Logback logger extension for generating JSON format log entries using \"\n\"Jackson library.\"\n\n#: ../../tehnoloogiad.rst:151\nmsgid \"`Logrus `_\"\nmsgstr \"`Logrus `_\"\n\n#: ../../tehnoloogiad.rst:152\nmsgid \"1.9.3, Go\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:154\nmsgid \"Logimisraamistik x-tee liidese jaoks\"\nmsgstr \"Logframework for X-road service interface\"\n\n#: ../../tehnoloogiad.rst:156\nmsgid \"`metisMenu `_\"\nmsgstr \"`metisMenu `_\"\n\n#: ../../tehnoloogiad.rst:157\nmsgid \"1.1.3, JavaScript\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:161\nmsgid \"`FontAwesome `_\"\nmsgstr \"`FontAwesome `_\"\n\n#: ../../tehnoloogiad.rst:162\nmsgid \"6.7.2, JavaScript\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:166\nmsgid \"`DataTables `_\"\nmsgstr \"`DataTables `_\"\n\n#: ../../tehnoloogiad.rst:167\nmsgid \"2.3.2, JavaScript\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:171\nmsgid \"PDFBox\"\nmsgstr \"PDFBox\"\n\n#: ../../tehnoloogiad.rst:172\nmsgid \"3.0.3, Java\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:174\nmsgid \"PDF vormingus raportite genereerimise tugi Java rakendustele\"\nmsgstr \"Support for generating PDF reports for Java applications\"\n\n#: ../../tehnoloogiad.rst:176\nmsgid \"`PyYAML `_\"\nmsgstr \"`PyYAML `_\"\n\n#: ../../tehnoloogiad.rst:177\nmsgid \"6.0.2, Python\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:179\nmsgid \"Kogumisteenuse seadistusfailide töötlemise tugi haldusteenusele\"\nmsgstr \"\"\n\"Support for processing configuration files for the collection service to \"\n\"the management service\"\n\n#: ../../tehnoloogiad.rst:181\nmsgid \"python-crontab\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:182\nmsgid \"3.3.0, Python\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:183\nmsgid \"LGPLv3\"\nmsgstr \"LGPLv3\"\n\n#: ../../tehnoloogiad.rst:184\nmsgid \"Crontab haldusteenuses\"\nmsgstr \"Crontab in collection management service\"\n\n#: ../../tehnoloogiad.rst:186\nmsgid \"python-dateutil\"\nmsgstr \"python-dateutil\"\n\n#: ../../tehnoloogiad.rst:187\nmsgid \"2.9.0, Python\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:189\nmsgid \"Kuupäevad ja kellaajad haldusteenuses\"\nmsgstr \"Dates and times in collection management service\"\n\n#: ../../tehnoloogiad.rst:191\nmsgid \"python-debian\"\nmsgstr \"python-debian\"\n\n#: ../../tehnoloogiad.rst:192\nmsgid \"0.1.49, Python\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:193\nmsgid \"GPLv2\"\nmsgstr \"GPLv2\"\n\n#: ../../tehnoloogiad.rst:194\nmsgid \"Debian pakkide lugemine haldusteenuses\"\nmsgstr \"Managing DEB files in collection management service\"\n\n#: ../../tehnoloogiad.rst:196\nmsgid \"pyopenssl\"\nmsgstr \"pyopenssl\"\n\n#: ../../tehnoloogiad.rst:197\nmsgid \"24.2.1, Python\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:198\nmsgid \"Apache\"\nmsgstr \"Apache\"\n\n#: ../../tehnoloogiad.rst:199\nmsgid \"OpenSSL kasutus haldusteenuses\"\nmsgstr \"OpenSSL in collection management service\"\n\n#: ../../tehnoloogiad.rst:201\nmsgid \"`Schematics `_\"\nmsgstr \"`Schematics `_\"\n\n#: ../../tehnoloogiad.rst:202\nmsgid \"2.1.1, Python\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:204\nmsgid \"Kogumisteenuse seadistusfailide valideerimise tugi haldusteenusele\"\nmsgstr \"\"\n\"Support for validation of collection service configuration files for the \"\n\"management service\"\n\n#: ../../tehnoloogiad.rst:206\nmsgid \"SnakeYAML\"\nmsgstr \"SnakeYAML\"\n\n#: ../../tehnoloogiad.rst:207\nmsgid \"2.3, Java\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:209\nmsgid \"YAML vormingus andmete lugemine\"\nmsgstr \"Reading data in YAML format\"\n\n#: ../../tehnoloogiad.rst:211\nmsgid \"\"\n\"`SB Admin 2 `_\"\nmsgstr \"\"\n\"`SB Admin 2 `_\"\n\n#: ../../tehnoloogiad.rst:212\nmsgid \"3.3.7+1, JavaScript\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:217\nmsgid \"IVXV raamistiku testide kasutatavad kolmandate osapoolte komponendid\"\nmsgstr \"Third-party components to be used for IVXV Framework tests\"\n\n#: ../../tehnoloogiad.rst:227\nmsgid \"Hamcrest\"\nmsgstr \"Hamcrest\"\n\n#: ../../tehnoloogiad.rst:228\nmsgid \"3.0, Java\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:230\nmsgid \"Loetavam assert-meetodite kasutamine Java üksuste testides\"\nmsgstr \"More readable use of assert methods in Java unit tests\"\n\n#: ../../tehnoloogiad.rst:232\nmsgid \"JUnit\"\nmsgstr \"JUnit\"\n\n#: ../../tehnoloogiad.rst:233\nmsgid \"5.10.0, Java\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:234\nmsgid \"EPL-1.0\"\nmsgstr \"EPL-1.0\"\n\n#: ../../tehnoloogiad.rst:235\nmsgid \"Java testimisraamistik\"\nmsgstr \"Java testing framework\"\n\n#: ../../tehnoloogiad.rst:237\nmsgid \"JUnitParams\"\nmsgstr \"JUnitParams\"\n\n#: ../../tehnoloogiad.rst:238\nmsgid \"1.1.1, Java\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:240\nmsgid \"Testide parametriseerimise tugi\"\nmsgstr \"Test parameterisation support\"\n\n#: ../../tehnoloogiad.rst:242\nmsgid \"Mockito\"\nmsgstr \"Mockito\"\n\n#: ../../tehnoloogiad.rst:243\nmsgid \"5.14.2, Java\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:245\nmsgid \"Testitava koodi sõltuvuste mockimise tugi\"\nmsgstr \"Support for mocking dependencies in code under test\"\n\n#: ../../tehnoloogiad.rst:247\nmsgid \"libdigidocpp-tools\"\nmsgstr \"libdigidocpp-tools\"\n\n#: ../../tehnoloogiad.rst:248\nmsgid \"3.14.5 .1404\"\nmsgstr \"3.14.5 .1404\"\n\n#: ../../tehnoloogiad.rst:249\nmsgid \"LGPL-2.1-or-later\"\nmsgstr \"LGPL-2.1-or-later\"\n\n#: ../../tehnoloogiad.rst:250\nmsgid \"Testandmete genereerimine\"\nmsgstr \"Test data generation\"\n\n#: ../../tehnoloogiad.rst:252\nmsgid \"PyTest\"\nmsgstr \"PyTest\"\n\n#: ../../tehnoloogiad.rst:253\nmsgid \"7.4.2, Python\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:255\nmsgid \"Üksuste testimise tugi Pythonile\"\nmsgstr \"Unit testing support for Python\"\n\n#: ../../tehnoloogiad.rst:257\nmsgid \"Requests\"\nmsgstr \"Requests\"\n\n#: ../../tehnoloogiad.rst:258\nmsgid \"2.32.3, Python\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:259\nmsgid \"Apache 2.0\"\nmsgstr \"Apache 2.0\"\n\n#: ../../tehnoloogiad.rst:260\nmsgid \"HTTP päringute moodul Pythoni testidele\"\nmsgstr \"HTTP request module for Python tests\"\n\n#: ../../tehnoloogiad.rst:263\nmsgid \"\"\n\"IVXV raamistiku arendamiseks ja/või testimiseks kasutatavad kolmandate \"\n\"osapoolte tööriistad\"\nmsgstr \"Third-party tools used to develop and/or test the IVXV framework\"\n\n#: ../../tehnoloogiad.rst:273\nmsgid \"`Behave `_\"\nmsgstr \"`Behave `_\"\n\n#: ../../tehnoloogiad.rst:274\nmsgid \"1.2.6, Python\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:275\nmsgid \"BSD-2-Clause\"\nmsgstr \"BSD 2 Clause\"\n\n#: ../../tehnoloogiad.rst:276\nmsgid \"Regressioonitestide käivitaja (*Behavior-driven development*)\"\nmsgstr \"Regression test trigger (*Behavior-driven development*)\"\n\n#: ../../tehnoloogiad.rst:278\nmsgid \"`Docker `_\"\nmsgstr \"`Docker `_\"\n\n#: ../../tehnoloogiad.rst:279\nmsgid \"18.06 (või uuem)\"\nmsgstr \"18.06 (or newer)\"\n\n#: ../../tehnoloogiad.rst:281\nmsgid \"Regressioonitestide läbiviimise keskkond - tarkvarakonteinerid\"\nmsgstr \"Regression testing environment - software containers\"\n\n#: ../../tehnoloogiad.rst:283\nmsgid \"`Sphinx `_\"\nmsgstr \"`Sphinx `_\"\n\n#: ../../tehnoloogiad.rst:284\nmsgid \"7.2.5, Python\"\nmsgstr \"\"\n\n#: ../../tehnoloogiad.rst:286\nmsgid \"Dokumentatsiooni genereerimine\"\nmsgstr \"Generating documentation\"\n" }, { "path": "Documentation/public/arhitektuur/locales/en/LC_MESSAGES/vallasrezhiim.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-03 19:48+0000\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language: en\\n\"\n\"Language-Team: en \\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../vallasrezhiim.rst:4\nmsgid \"Rakendused\"\nmsgstr \"Applications\"\n\n#: ../../vallasrezhiim.rst:8\nmsgid \"Üldpõhimõtted\"\nmsgstr \"General principles\"\n\n#: ../../vallasrezhiim.rst:10\nmsgid \"\"\n\"Kõik rakendused on käsurealiidesega rakendused, mis on pakendatud töötama\"\n\" operatsioonisüsteemi Windows 10 (või uuem) keskkonnas. Komponentide \"\n\"kasutajaliidesed on ühekeelsed. Komponendid tarnitakse eestikeelsetena, \"\n\"nende tõlkimine on võimalik tõlkefaili abil.\"\nmsgstr \"\"\n\"All applications are command-line applications, packaged to work in \"\n\"Windows 10 (or later) operating system environment. Component user \"\n\"interfaces are monolingual. The components are delivered in Estonian, and\"\n\" can be translated using a translation file.\"\n\n#: ../../vallasrezhiim.rst:15\nmsgid \"Rakendused on programmeeritud Java keeles.\"\nmsgstr \"The applications are developed in Java programming language.\"\n\n#: ../../vallasrezhiim.rst:17\nmsgid \"\"\n\"Väliste infosüsteemidega suhtlevad rakendused kasutavad maksimaalselt \"\n\"olemasolevaid liideseid/andmestruktuure.\"\nmsgstr \"\"\n\"Applications interacting with external information systems make maximum \"\n\"use of existing interfaces/data structures.\"\n\n#: ../../vallasrezhiim.rst:20\nmsgid \"\"\n\"Rakendused saavad oma sisendi rakenduste seadistustest ja seadistustes \"\n\"näidatud failidest failisüsteemis ning salvestavad oma väljundi kasutaja \"\n\"näidatud kausta failisüsteemis. Failid võivad paikneda ka operatiiv-\"\n\"mälukettal.\"\nmsgstr \"\"\n\"Applications get their input from the application settings and the files \"\n\"in the file system indicated in the settings, and store their output in \"\n\"the folder in the file system indicated by the user. Files may also be \"\n\"located on the memory-disk.\"\n\n#: ../../vallasrezhiim.rst:24\nmsgid \"\"\n\"Relevantsed rakendused toetavad ElGamal krüptosüsteemi \"\n\"täisarvujäägikorpustel ning P-384 elliptkõveral. Lugemistõend on \"\n\"realiseeritud Schnorri nullteadmustõestusel põhineval protokollil.\"\nmsgstr \"\"\n\"Relevant applications support the ElGamal cryptosystem on prime order \"\n\"fields and the P-384 elliptic curve. The decryption proof is implemented \"\n\"using the Schnorr zero-knowledge protocol.\"\n\n#: ../../vallasrezhiim.rst:30\nmsgid \"Rakenduste abimoodulid\"\nmsgstr \"Applications support modules\"\n\n#: ../../vallasrezhiim.rst:32\nmsgid \"\"\n\"Valimise liides on rakenduste jaoks unifitseeritud, see võimaldab \"\n\"erinevate valimistüüpide realiseerimist moodulitena. Digiallkirja \"\n\"verifitseerimise funktsionaalsus on loodud `digidoc4j `_ teegi abil. Abimoodulite kasutamist alljärgnevatel\"\n\" skeemidel eraldi välja ei tooda.\"\nmsgstr \"\"\n\"The election interface is unified for applications, allowing different \"\n\"types of elections to be implemented as modules. The digital signature \"\n\"verification functionality has been created using the `digidoc4j \"\n\"`_ library. The use of the \"\n\"auxiliary modules is not explicitly described in the following diagrams.\"\n\n#: ../../vallasrezhiim.rst:39\nmsgid \"Rakenduste seadistamine\"\nmsgstr \"Setting up applications\"\n\n#: ../../vallasrezhiim.rst:41\nmsgid \"\"\n\"Rakendused seadistatakse kas digitaalallkirjastatud \"\n\"konfiguratsioonipakiga või käsureavõtmetega. Käsureavõtmed ei toeta \"\n\"hierarhilise struktuuriga seadistuste sisestamist. Seadistused \"\n\"konfiguratsioonipakis kirjeldatakse YAML-keeles:\"\nmsgstr \"\"\n\"The applications are configured either with a digitally signed \"\n\"configuration package or with command line parameters. The latter do not \"\n\"support the entry of hierarchically structured configurations. The \"\n\"settings in the configuration package shall be described in YAML:\"\n\n#: ../../vallasrezhiim.rst:88\nmsgid \"Sisendite kooskõlalisuse kontroll\"\nmsgstr \"Input consistency check\"\n\n#: ../../vallasrezhiim.rst:90\nmsgid \"\"\n\"Kõik rakendused teostavad konfiguratsioonile sisendite kooskõlalisuse \"\n\"kontrolli vastavalt nende poolt kasutatavale konfiguratsioonile:\"\nmsgstr \"\"\n\"All applications perform configuration consistency checks on the inputs \"\n\"according to the configuration they use:\"\n\n#: ../../vallasrezhiim.rst:93\nmsgid \"sertifikaatide konfiguratsiooni laadimine;\"\nmsgstr \"loading certificate configuration;\"\n\n#: ../../vallasrezhiim.rst:95\nmsgid \"konfiguratsiooni digiallkirja verifitseerimine;\"\nmsgstr \"Digital signature verification of the configuration;\"\n\n#: ../../vallasrezhiim.rst:97\nmsgid \"ringkondade nimekirja verifitseerimine;\"\nmsgstr \"verification of the list of districts;\"\n\n#: ../../vallasrezhiim.rst:99\nmsgid \"ringkondade nimekirja kooskõlalisuse kontroll;\"\nmsgstr \"checking the consistency of the list of districts;\"\n\n#: ../../vallasrezhiim.rst:101\nmsgid \"ringkondade nimekirja laadimine;\"\nmsgstr \"loading the list of districts;\"\n\n#: ../../vallasrezhiim.rst:103\nmsgid \"valikute nimekirja verifitseerimine;\"\nmsgstr \"verification of the list of choices;\"\n\n#: ../../vallasrezhiim.rst:105\nmsgid \"valikute nimekirja kooskõlalisuse kontroll;\"\nmsgstr \"checking the consistency of the list of choices;\"\n\n#: ../../vallasrezhiim.rst:107\nmsgid \"valikute nimekirja laadimine;\"\nmsgstr \"loading the list of choices;\"\n\n#: ../../vallasrezhiim.rst:109\nmsgid \"valijate nimekirjade verifitseerimine;\"\nmsgstr \"verification of voter lists;\"\n\n#: ../../vallasrezhiim.rst:111\nmsgid \"valijate nimekirjade kooskõlalisus kontroll;\"\nmsgstr \"a check on the consistency of voter lists;\"\n\n#: ../../vallasrezhiim.rst:113\nmsgid \"valijate nimekirjade laadimine.\"\nmsgstr \"loading the voter lists.\"\n\n#: ../../vallasrezhiim.rst:117\nmsgid \"Võtmerakendus\"\nmsgstr \"Key application\"\n\n#: ../../vallasrezhiim.rst:121\nmsgid \"Võtmerakenduse liidesed\"\nmsgstr \"Key application interfaces\"\n\n#: ../../vallasrezhiim.rst:123\nmsgid \"\"\n\"Võtmerakendusega genereeritakse iga hääletamise jaoks häälte salastamise \"\n\"ja häälte avamise võti, samuti toimub selle abil häälte lugemine ja \"\n\"tulemuse väljastamine.\"\nmsgstr \"\"\n\"The key application generates a key for encrypting and decrypting votes, \"\n\"as well as counting votes and issuing the result.\"\n\n#: ../../vallasrezhiim.rst:127\nmsgid \"\"\n\"Võtmerakendus kasutab [DesmedtF89]_ läviskeemi, mis põhineb usaldataval \"\n\"osakujagajal ning rakendab Shamiri osakujagamist, mis on \"\n\"informatsiooniteoreetiliselt turvaline :math:`t < M` osapoole korral, kus\"\n\" M on lävipiir.\"\nmsgstr \"\"\n\"The key application uses the [DesmedtF89]_ threshold scheme based on a \"\n\"trusted dealer and implements Shamir secret-sharing, which is \"\n\"information-theoretically secure for :math:`t < M`, where M is the \"\n\"threshold.\"\n\n#: ../../vallasrezhiim.rst:132\nmsgid \"\"\n\"Võtmeosakud genereeritakse operatiivmälus ning talletatakse \"\n\"PKCS15-liidese vahendusel kiipkaardile.\"\nmsgstr \"\"\n\"The key shares are generated in the operational memory and stored on the \"\n\"smart card via the PKCS15 interface.\"\n\n#: ../../vallasrezhiim.rst:135\nmsgid \"Võtmerakenduse sisend võtme genereerimisel on:\"\nmsgstr \"The input to the key application when generating a key is:\"\n\n#: ../../vallasrezhiim.rst:137 ../../vallasrezhiim.rst:161\nmsgid \"Võtmepaari identifikaator;\"\nmsgstr \"Key pair identifier;\"\n\n#: ../../vallasrezhiim.rst:139\nmsgid \"\"\n\"Krüptosüsteemi ElGamal spetsifikatsioon – täisarvujäägikorpus või P-384 \"\n\"elliptkõver ning võtmepikkus;\"\nmsgstr \"\"\n\"Specification of the ElGamal cryptosystem - prime order field or P-384 \"\n\"elliptic curve and key length;\"\n\n#: ../../vallasrezhiim.rst:142\nmsgid \"\"\n\"M-N läviskeemi spetsifikatsioon, mis peab vastama reeglile :math:`N >= 2 \"\n\"* M - 1`;\"\nmsgstr \"\"\n\"Specification of the M-N threshold scheme, which must satisfy the rule \"\n\":math:`N >= 2 * M - 1`;\"\n\n#: ../../vallasrezhiim.rst:145\nmsgid \"N PKCS15-ühilduvat kiipkaarti;\"\nmsgstr \"N PKCS15-compatible smart card;\"\n\n#: ../../vallasrezhiim.rst:147\nmsgid \"Võtmerakenduse väljund võtme genereerimisel on:\"\nmsgstr \"The output of the key application when generating a key is:\"\n\n#: ../../vallasrezhiim.rst:149\nmsgid \"Isesigneeritud sertifikaat;\"\nmsgstr \"Self-signed certificate;\"\n\n#: ../../vallasrezhiim.rst:151\nmsgid \"N võtmeosakut talletatuna kiipkaartidel;\"\nmsgstr \"N key shares stored on smart cards;\"\n\n#: ../../vallasrezhiim.rst:153 ../../vallasrezhiim.rst:174\nmsgid \"Rakenduse detailne tegevuslogi;\"\nmsgstr \"Detailed activity log of the application;\"\n\n#: ../../vallasrezhiim.rst:155 ../../vallasrezhiim.rst:176\nmsgid \"Rakenduse detailne vealogi.\"\nmsgstr \"A detailed error log for the application.\"\n\n#: ../../vallasrezhiim.rst:157\nmsgid \"Võtmerakenduse sisend häälte lugemisel on:\"\nmsgstr \"The key application input for vote counting is:\"\n\n#: ../../vallasrezhiim.rst:159\nmsgid \"Miksitud hääled;\"\nmsgstr \"Mixed ballots;\"\n\n#: ../../vallasrezhiim.rst:163\nmsgid \"M võtmeosakut vastavalt läviskeemi spetsifikatsioonile.\"\nmsgstr \"M key shares according to the threshold scheme specification.\"\n\n#: ../../vallasrezhiim.rst:165\nmsgid \"Võtmerakenduse väljund häälte lugemisel on:\"\nmsgstr \"The output of the key application for counting votes is:\"\n\n#: ../../vallasrezhiim.rst:167\nmsgid \"Signeeritud hääletamistulemus;\"\nmsgstr \"Signed results;\"\n\n#: ../../vallasrezhiim.rst:169\nmsgid \"Kehtetute häälte loend;\"\nmsgstr \"List of invalid votes;\"\n\n#: ../../vallasrezhiim.rst:171\nmsgid \"\"\n\"Lugemistõend (Schnorri nullteadmustõestusel põhinev protokoll vastavalt \"\n\"hankedokumentides viidatule);\"\nmsgstr \"\"\n\"Decryption proof (Schnorr's zero knowledge protocol as referred to in the\"\n\" contract documents);\"\n\n#: ../../vallasrezhiim.rst:179\nmsgid \"Töötlemisrakendus\"\nmsgstr \"Processing application\"\n\n#: ../../vallasrezhiim.rst:181\nmsgid \"\"\n\"Töötlemisrakendusega verifitseeritakse, tühistatakse ning anonüümitakse \"\n\"hääletamisperioodil kogutud hääli vastavalt Üldkirjelduse jaotisele 7.6.\"\nmsgstr \"\"\n\"The processing application verifies, revokes and anonymises the votes \"\n\"collected during the voting period in accordance with Section 7.6 of the \"\n\"General Description.\"\n\n#: ../../vallasrezhiim.rst:184\nmsgid \"Töötlemisrakenduse sisendid on:\"\nmsgstr \"The inputs to the processing application are:\"\n\n#: ../../vallasrezhiim.rst:186\nmsgid \"kogumisteenuse poolt talletatud elektroonilised hääled;\"\nmsgstr \"electronic votes recorded by the collection service;\"\n\n#: ../../vallasrezhiim.rst:188\nmsgid \"registreerimisteenuse poolt väljastatud ajamärgendid;\"\nmsgstr \"time stamps issued by the registration service;\"\n\n#: ../../vallasrezhiim.rst:190\nmsgid \"valijate nimekirjad;\"\nmsgstr \"voter lists;\"\n\n#: ../../vallasrezhiim.rst:192\nmsgid \"ringkondade nimekiri;\"\nmsgstr \"list of districts;\"\n\n#: ../../vallasrezhiim.rst:194\nmsgid \"tühistusnimekirjad;\"\nmsgstr \"revocation lists;\"\n\n#: ../../vallasrezhiim.rst:196\nmsgid \"ennistusnimekirjad.\"\nmsgstr \"restoration lists.\"\n\n#: ../../vallasrezhiim.rst:198\nmsgid \"Töötlemisrakenduse väljundid on:\"\nmsgstr \"The outputs of the processing application are:\"\n\n#: ../../vallasrezhiim.rst:200\nmsgid \"rakenduse detailne tegevuslogi;\"\nmsgstr \"detailed activity log of the application;\"\n\n#: ../../vallasrezhiim.rst:202\nmsgid \"rakenduse detailne vealogi;\"\nmsgstr \"detailed error log of the application;\"\n\n#: ../../vallasrezhiim.rst:204\nmsgid \"e-hääletanute nimekiri PDF-vormingus, vastavalt töötlemise etapile;\"\nmsgstr \"the list of e-voters in PDF format, according to the stage of processing;\"\n\n#: ../../vallasrezhiim.rst:206\nmsgid \"\"\n\"e-hääletanute nimekiri masintöödeldaval kujul, vastavalt töötlemise \"\n\"etapile;\"\nmsgstr \"\"\n\"the list of e-voters in a machine-processable format, according to the \"\n\"stage of processing;\"\n\n#: ../../vallasrezhiim.rst:208\nmsgid \"anonüümitud hääled.\"\nmsgstr \"anonymised ballots.\"\n\n#: ../../vallasrezhiim.rst:210\nmsgid \"\"\n\"Lisaks varem defineeritud liidestele ja sõltuvustele kasutab \"\n\"töötlemisrakendus kolmanda osapoole teeki PDF'ide väljastamise \"\n\"funktsionaalsuse teostamiseks.\"\nmsgstr \"\"\n\"In addition to the interfaces and dependencies defined earlier, the \"\n\"processing application uses a third-party library to perform PDF output \"\n\"functionality.\"\n\n#: ../../vallasrezhiim.rst:215\nmsgid \"Töötlemisrakenduse liidesed\"\nmsgstr \"Processing application interfaces\"\n\n#: ../../vallasrezhiim.rst:218\nmsgid \"Elektrooniliste häälte täielik töötlemine\"\nmsgstr \"Complete processing of electronic voices\"\n\n#: ../../vallasrezhiim.rst:220\nmsgid \"\"\n\"Elektrooniliste häälte täielik töötlemine on tegevus, mille käigus \"\n\"töötlemisrakendus võrdleb Kogumisteenuse poolt talletatud häälte hulka \"\n\"registreerimisteenuse poolt talletatud häälte hulgaga, kontrollib \"\n\"talletatud häälte vastavust valimiste konfiguratsioonile, tuvastab \"\n\"loendamisele minevad hääled ning anonüümib need Võtmerakendusele üle \"\n\"andmiseks.\"\nmsgstr \"\"\n\"Complete processing of electronic ballots is the process whereby the \"\n\"processing application compares the number of ballots stored by the \"\n\"Collection Service with the number of ballots stored by the Registration \"\n\"Service, verifies that the stored ballots match the election \"\n\"configuration, identifies the ballots to be counted and anonymizes them \"\n\"for delivery to the Key Application.\"\n\n#: ../../vallasrezhiim.rst:226 ../../vallasrezhiim.rst:254\nmsgid \"rakenduse seadistuste laadimine;\"\nmsgstr \"loading app settings;\"\n\n#: ../../vallasrezhiim.rst:228 ../../vallasrezhiim.rst:256\nmsgid \"elektrooniliste häälte digitaalallkirjade verifitseerimine;\"\nmsgstr \"verification of digital signatures of electronic votes;\"\n\n#: ../../vallasrezhiim.rst:230\nmsgid \"registreerimisteenuse kinnituste verifitseerimine;\"\nmsgstr \"verification of registration service confirmations;\"\n\n#: ../../vallasrezhiim.rst:232\nmsgid \"ajatemplite verifitseerimine;\"\nmsgstr \"verification of time stamps;\"\n\n#: ../../vallasrezhiim.rst:234\nmsgid \"iga valija kohta viimase kehtiva hääle tuvastamine;\"\nmsgstr \"identifying the last valid vote for each voter;\"\n\n#: ../../vallasrezhiim.rst:236\nmsgid \"algse elektrooniliselt hääletanute nimekirja väljastamine PDF-vormingus;\"\nmsgstr \"issuing the original list of electronic voters in PDF format;\"\n\n#: ../../vallasrezhiim.rst:238\nmsgid \"tühistus- ja ennistusnimekirjade verifitseerimine;\"\nmsgstr \"verification of revocation and restoration lists;\"\n\n#: ../../vallasrezhiim.rst:240\nmsgid \"tühistus- ja ennistusnimekirjade kooskõlalisuse kontroll;\"\nmsgstr \"checking the consistency of cancellation and reinstatement lists;\"\n\n#: ../../vallasrezhiim.rst:242\nmsgid \"tühistus- ja ennistusnimekirjade rakendamine;\"\nmsgstr \"the implementation of revocation and restoration lists;\"\n\n#: ../../vallasrezhiim.rst:244\nmsgid \"\"\n\"miksimisele minevate häälte nimekirja koostamine, krüptogrammide \"\n\"eraldamine digitaalallkirjadest;\"\nmsgstr \"\"\n\"drawing up a list of votes to be mixed, separating ciphertexts from \"\n\"digital signatures;\"\n\n#: ../../vallasrezhiim.rst:247\nmsgid \"\"\n\"lõpliku elektrooniliselt hääletanute nimekirja väljastamine masinloetavas\"\n\" vormingus.\"\nmsgstr \"issuing the final list of electronic voters in machine-readable format.\"\n\n#: ../../vallasrezhiim.rst:252\nmsgid \"Elektrooniliselt hääletanute nimekirja genereerimine\"\nmsgstr \"Generating a list of voters electronically\"\n\n#: ../../vallasrezhiim.rst:258\nmsgid \"algse elektrooniliselt hääletanute nimekirja väljastamine PDF-vormingus.\"\nmsgstr \"issuing the original list of electronic voters in PDF format.\"\n\n#: ../../vallasrezhiim.rst:262\nmsgid \"Auditirakendus\"\nmsgstr \"Audit application\"\n\n#: ../../vallasrezhiim.rst:266\nmsgid \"Auditirakenduse liidesed\"\nmsgstr \"Audit application interfaces\"\n\n#: ../../vallasrezhiim.rst:268\nmsgid \"\"\n\"Auditirakendusega (joonis 9) verifitseeritakse matemaatiliselt häälte \"\n\"kokkulugemise korrektsust ning miksimise kasutamisel ka miksimise \"\n\"korrektsust.\"\nmsgstr \"\"\n\"The audit application (Figure 9) mathematically verifies the correctness \"\n\"of the voice aggregation and, when mixing is used, the correctness of the\"\n\" mixing.\"\n\n#: ../../vallasrezhiim.rst:271\nmsgid \"Auditirakenduse sisendid on;\"\nmsgstr \"The inputs to the audit application are;\"\n\n#: ../../vallasrezhiim.rst:273\nmsgid \"anonüümitud hääled;\"\nmsgstr \"anonymised ballots;\"\n\n#: ../../vallasrezhiim.rst:275\nmsgid \"miksitud hääled;\"\nmsgstr \"mixed ballots;\"\n\n#: ../../vallasrezhiim.rst:277\nmsgid \"Verificatumi miksimistõend;\"\nmsgstr \"Verificatum mixing proof;\"\n\n#: ../../vallasrezhiim.rst:279\nmsgid \"hääletamistulemus.\"\nmsgstr \"the tally.\"\n\n#: ../../vallasrezhiim.rst:281\nmsgid \"\"\n\"Auditirakenduse väljund on rakenduse detailne tegevuslogi, mis sisaldab \"\n\"ka hinnangut auditi tervikliku õnnestumise kohta. Vajadusel väljastatakse\"\n\" ka rakenduse detailne vealogi.\"\nmsgstr \"\"\n\"The output of the audit application is a detailed log of the \"\n\"application's activities, including an assessment of the overall success \"\n\"of the audit. If required, a detailed error log of the application is \"\n\"also output.\"\n\n" }, { "path": "Documentation/public/arhitektuur/locales/en/LC_MESSAGES/viited.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-03 18:28+0000\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language: en\\n\"\n\"Language-Team: en \\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../viited.rst:4\nmsgid \"\"\n\"Desmedt, Y. & Frankel, Y. Brassard, G. (Ed.) Threshold Cryptosystems \"\n\"Advances in Cryptology - CRYPTO '89, 9th Annual International Cryptology \"\n\"Conference, Santa Barbara, California, USA, August 20-24, 1989, \"\n\"Proceedings, Springer, 1989, 435, 307-315.\"\nmsgstr \"\"\n\"Desmedt, Y. & Frankel, Y. Brassard, G. (Ed.) Threshold Cryptosystems \"\n\"Advances in Cryptology - CRYPTO '89, 9th Annual International Cryptology \"\n\"Conference, Santa Barbara, California, USA, August 20-24, 1989, \"\n\"Proceedings, Springer, 1989, 435, 307-315.\"\n\n#: ../../viited.rst:9\nmsgid \"\"\n\"Sven Heiberg, Tarvi Martens, Priit Vinkel, Jan Willemson, Improving the \"\n\"verifiability of the Estonian Internet Voting scheme. In Robert Krimmer, \"\n\"Melanie Volkamer, Jordi Barrat, Josh Benaloh, Nicole Goodman, Peter Y.A. \"\n\"Ryan, Oliver Spycher, Vanessa Teague, Gregor Wenda (Eds.), The \"\n\"International Conference on Electronic Voting E-Vote-ID 2016, 18-21 \"\n\"October 2016, Lochau/Bregenz, Austria, TUT Press, pp. 213-229, ISBN \"\n\"978-9949-83-022-0\"\nmsgstr \"\"\n\"Sven Heiberg, Tarvi Martens, Priit Vinkel, Jan Willemson, Improving the \"\n\"verifiability of the Estonian Internet Voting scheme. In Robert Krimmer, \"\n\"Melanie Volkamer, Jordi Barrat, Josh Benaloh, Nicole Goodman, Peter Y.A. \"\n\"Ryan, Oliver Spycher, Vanessa Teague, Gregor Wenda (Eds.), The \"\n\"International Conference on Electronic Voting E-Vote-ID 2016, 18-21 \"\n\"October 2016, Lochau/Bregenz, Austria, TUT Press, pp. 213-229, ISBN \"\n\"978-9949-83-022-0\"\n\n#: ../../viited.rst:16\nmsgid \"\"\n\"Tehniline kirjeldus. Elektroonilise hääletamise infosüsteemi arenduse \"\n\"hange, Vabariigi Valimiskomisjon, 2016\"\nmsgstr \"\"\n\"Technical description. Tender for the development of an electronic voting\"\n\" information system, National Electoral Committee, 2016\"\n\n#: ../../viited.rst:19\nmsgid \"\"\n\"Elektroonilise hääletamise üldraamistik ja selle kasutamine Eesti \"\n\"riiklikel valimistel. Elektroonilise Hääletamise Komisjon, Tallinn 2016\"\nmsgstr \"\"\n\"General framework for electronic voting and its use in Estonian national \"\n\"elections. Electronic Voting Commission, Tallinn 2016\"\n" }, { "path": "Documentation/public/arhitektuur/locales/en/LC_MESSAGES/yldpohimotted.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-03 15:28+0000\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language: en\\n\"\n\"Language-Team: en \\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../yldpohimotted.rst:4\nmsgid \"Sissejuhatus\"\nmsgstr \"Introduction\"\n\n#: ../../yldpohimotted.rst:6\nmsgid \"\"\n\"Elektroonilise hääletamise infosüsteem IVXV on loodud lähtuvalt \"\n\"e-hääletamise raamistikust [ÜK2016]_ ja riigihanke 171780 tehnilisest \"\n\"kirjeldusest [TK2016]_. Käesolevas dokumendis kirjeldatakse IVXV \"\n\"arhitektuurset lahendust. Elektroonilise hääletamise infosüsteem koosneb \"\n\"vallasrežiimirakendustest ning sidusrežiimikomponentidest. Täiendavalt \"\n\"sõltub infosüsteem välistest infosüsteemidest ning mõjutab vahetult \"\n\"elektrooniliseks hääletamiseks ja hääle kontrollimiseks kasutatavaid \"\n\"komponente.\"\nmsgstr \"\"\n\"The IVXV electronic voting information system has been developed on the \"\n\"basis of the e-voting framework [ÜK2016]_ and the technical specification\"\n\" of public procurement 171780 [TK2016]_. This document describes the \"\n\"architectural design of IVXV. The eVoting Information System consists of \"\n\"the offline applications and the online components. In addition, the \"\n\"information system depends on external information systems and directly \"\n\"affects the components used for electronic voting and vote verification.\"\n\n#: ../../yldpohimotted.rst:14\nmsgid \"\"\n\"Arhitektuuridokument kirjeldab IVXV komponente, nende omavahelisi \"\n\"liideseid ja liideseid väliste süsteemidega ning komponentide poolt \"\n\"realiseeritavaid protokolle.\"\nmsgstr \"\"\n\"The architecture document describes the IVXV components, their interfaces\"\n\" with each other and with external systems, and the protocols implemented\"\n\" by the components.\"\n\n#: ../../yldpohimotted.rst:18\nmsgid \"IVXV kontseptsioon\"\nmsgstr \"IVXV Concept\"\n\n#: ../../yldpohimotted.rst:20\nmsgid \"\"\n\"Üldine, kuid terviklik ülevaade elektroonilise hääletamise raamistiku \"\n\"(\\\"IVXV\\\") tehnilisest ja organisatsioonilisest poolest ning selle \"\n\"rakendamisest Eesti riiklikel valimistel on antud e-hääletamise \"\n\"raamistiku üldkirjelduses [ÜK2016]_.\"\nmsgstr \"\"\n\"A general but comprehensive overview of the technical and organisational \"\n\"aspects of the electronic voting framework (\\\"IVXV\\\") and its \"\n\"implementation in Estonian national elections is given in the general \"\n\"description of the e-voting framework [ÜK2016]_.\"\n\n#: ../../yldpohimotted.rst:25\nmsgid \"\"\n\"IVXV infosüsteemina teostab \\\"ümbrikuskeemil\\\" põhinevat e-hääletamise \"\n\"protokolli. IVXV toimib hääletamiseelsel etapil, hääletamisetapil, \"\n\"töötlusetapil ning lugemisetapil ja pakub vahendeid elektroonilise \"\n\"hääletamise protsessis osalemiseks Korraldajale, Lugejale, Hääletajale, \"\n\"Kogujale, Töötlejale, Miksijale, Audiitorile, Klienditoele, Valijate \"\n\"nimekirja koostajale ja täiendajale.\"\nmsgstr \"\"\n\"As an information system, IVXV implements an e-voting protocol based on \"\n\"an \\\"double-envelope scheme\\\". IVXV operates at the pre-voting stage, the\"\n\" voting stage, the processing stage and the counting stage, and provides \"\n\"the tools for the participation in the electronic voting process of the \"\n\"Organiser, Tallier, Voter, Collector, Processor, Registrar, Auditor, \"\n\"Client Support and Voter List manager.\"\n\n#: ../../yldpohimotted.rst:32\nmsgid \"\"\n\"Infosüsteemi komponendid on Kogumisteenus, Töötlemisrakendus, \"\n\"Võtmerakendus ning Auditirakendus. Infosüsteemiga on tihedalt seotud \"\n\"Valijarakendus, Kontrollrakendus ning Miksimisrakendus.\"\nmsgstr \"\"\n\"The components of the information system are the Collection Service, the \"\n\"Processing Application, the Key Application and the Audit Application. \"\n\"Closely linked to the Information System are the Voting Application, the \"\n\"Verification Application and the Mixing Application.\"\n\n#: ../../yldpohimotted.rst:36\nmsgid \"\"\n\"Infosüsteem kasutab oma töös väliseid teenuseid - Tuvastusteenus, \"\n\"Allkirjastamisteenus, Registreerimisteenus, Valimiste Infosüsteem ning \"\n\"X-tee.\"\nmsgstr \"\"\n\"The information system uses external services - Authentication Service, \"\n\"Signature Service, Registration Service, Election Management System and \"\n\"X-Road.\"\n\n#: ../../yldpohimotted.rst:40\nmsgid \"IVXV krüptograafiline protokoll\"\nmsgstr \"IVXV Cryptographic Protocol\"\n\n#: ../../yldpohimotted.rst:42\nmsgid \"\"\n\"Elektroonilise hääletamise turvalisuse, verifitseeritavuse ning \"\n\"hääletamise salajasuse, hääletamise korrektsuse ja hääletaja sõltumatuse \"\n\"saavutamiseks on rangelt kirjeldatud elektroonilise hääletamise \"\n\"krüptograafiline protokoll [HMVW16]_. Protokoll annab vajaliku ja piisava\"\n\" ülevaate IVXV ülesehitusest ning selle turvaaspektidest. IVXV \"\n\"komponendid realiseerivad krüptograafilise protokolli alamosi.\"\nmsgstr \"\"\n\"In order to achieve the security, verifiability and secrecy of electronic\"\n\" voting, the correctness of the voting and the independence of the voter,\"\n\" the cryptographic protocol for electronic voting [HMVW16]_ is strictly \"\n\"described. The protocol provides a necessary and sufficient overview of \"\n\"the IVXV architecture and its security aspects. The components of IVXV \"\n\"implement sub-components of the cryptographic protocol.\"\n\n#: ../../yldpohimotted.rst:50\nmsgid \"Notatsioon\"\nmsgstr \"Notation\"\n\n#: ../../yldpohimotted.rst:52\nmsgid \"\"\n\"Arhitektuurse lahenduse visandi illustreerimiseks kasutatakse dokumendis \"\n\"UML-skeeme, kus eristame värvide ja märgenditega ``<<>>`` kodeeritult \"\n\"olemite – tegijad, liidesed, komponendid – järgmisi aspekte:\"\nmsgstr \"\"\n\"To illustrate a sketch of the architectural solution, the document uses \"\n\"UML diagrams, where we distinguish the following aspects of entities - \"\n\"actors, interfaces, components - coded with colours and ``<<>>``:\"\n\n#: ../../yldpohimotted.rst:56\nmsgid \"\"\n\"Märgend ``<>`` (Kollane) – infosüsteemi liides või komponent \"\n\"defineeritakse/realiseeritakse konkreetse pakkumuse raames tehtavate \"\n\"tööde käigus\"\nmsgstr \"\"\n\"Mark ``<>`` (Yellow) - The information system interface or \"\n\"component will be defined/realised during the works of a specific tender.\"\n\n#: ../../yldpohimotted.rst:60\nmsgid \"\"\n\"Märgend ``<>`` (Punane) – infosüsteem sõltub mingi \"\n\"funktsionaalsuse realiseerimisel kolmanda osapoole komponendist või \"\n\"olemasolevast liidesest, mille ümberdefineerimine eeldab ka kolmandate \"\n\"osapoolte tööd.\"\nmsgstr \"\"\n\"``<<>`` (Red) - The information system depends on a third-party\"\n\" component or an existing interface for the implementation of some \"\n\"functionality, the redefinition of which also requires third-party work.\"\n\n#: ../../yldpohimotted.rst:64\nmsgid \"\"\n\"Märgend ``<>`` (Pruun) – sarnane eelmisele, kuid liidese/komponendi \"\n\"omanikuks on VVK.\"\nmsgstr \"\"\n\"Flag ``<<>`` (Brown) - similar to the previous one, but the \"\n\"interface/component is owned by NEC.\"\n\n#: ../../yldpohimotted.rst:67\nmsgid \"\"\n\"Märgend ``<>`` (Must) – infosüsteemi jaoks oluline liides \"\n\"on määratlemata.\"\nmsgstr \"\"\n\"Flag ``<>`` (Black) - Interface relevant to the information \"\n\"system is undefined.\"\n\n#: ../../yldpohimotted.rst:72\nmsgid \"Näiteskeem\"\nmsgstr \"Example scheme\"\n" }, { "path": "Documentation/public/arhitektuur/model/Makefile", "content": "\n# Source diagrams are all in different .pu files\nSRC_DIAG=example ms-collector-status ms-management-service-components \\\n\t\t ms-service-status-changes ms-service-status ms-upload-command \\\n\t\t ms-voter-list-status\n\nPARENT=development\n\n# Sub-diagrams are generated from $(PARENT).pu\nSUB_DIAG=processing collector_microservices collector_extension monitoring \\\n\t\t app_modules key audit\n\n\ninclude ../../../common-model.mk\n\n\n# Set environment variables for subdiagrams\ncollector_extension.env:\n\t$(eval DIAGRAM_DEF=-DCOLLECTOR_EXTENSION)\n\ncollector_microservices.env:\n\t$(eval DIAGRAM_DEF=-DCOLLECTOR_MICROSERVICES)\n\nprocessing.env:\n\t$(eval DIAGRAM_DEF=-DPROCESSING_APPLICATION)\n\nkey.env:\n\t$(eval DIAGRAM_DEF=-DKEY_APPLICATION)\n\naudit.env:\n\t$(eval DIAGRAM_DEF=-DAUDIT_APPLICATION)\n\nmonitoring.env:\n\t$(eval DIAGRAM_DEF=-DMONITORING)\n\napp_modules.env:\n\t$(eval DIAGRAM_DEF=-DAPP_MODULES)\n" }, { "path": "Documentation/public/arhitektuur/model/actors.pu", "content": "\n@startuml\n\n :Omanik: as Omanik <>\n actor Hääletaja <>\n actor Töötleja <>\n actor Andmeaudiitor <>\n actor Klienditugi <>\n actor Kogumisteenus <>\n actor Registreerimisteenus <>\n actor Autentimisteenus <>\n actor Allkirjateenus <>\n\n\n\n@enduml\n" }, { "path": "Documentation/public/arhitektuur/model/collector-if.pu", "content": "@startuml\n\nleft to right direction\n\n[Kogumisteenus] as collector\n\n\npackage \"Keskkonnateenused\" {\n [Registreerimisteenus] as tsa\n [Autentimisteenus] as auth\n [Allkirjateenus] as sign\n}\n\n[Nimekirjad] as voterlist\n[Varundamine] as backup\n\n\nactor Omanik as owner\nactor Töötleja as offline\n\nactor Klienditeenindaja as helpdesk\n\nactor Hääletaja as voter\n\nactor :Kogumisteenuse admin: as admin\nactor :Kogumisteenuse kaugadmin: as radmin\n\n\ninterface \"Valimise defineerimine\" as i_define\ninterface \"Ümbrikute väljastamine\" as i_export\ninterface \"Hääletamine\" as i_vote\ninterface \"Kontrollimine\" as i_verify\ninterface \"Valikute nimekiri\" as i_cls\ninterface \"Käsurida\" as i_localadmin\ninterface \"Kaughaldus\" as i_remoteadmin\ninterface \"Monitooring\" as i_monitor\ninterface \"Helpdesk\" as i_helpdesk\n\ninterface \"Varundamine\" as i_backup\ninterface \"Nimekirjade uuendused\" as i_voterlist\n\ncollector -down- i_cls\ncollector -down- i_vote\ncollector -down- i_verify\nvoter -up-> i_vote\nvoter -up-> i_verify\nvoter -up-> i_cls\n\n\ncollector -up- i_localadmin\ncollector -up- i_helpdesk\ncollector -up- i_monitor\ncollector -up- i_remoteadmin\n\nadmin -down-> i_localadmin\nhelpdesk -down-> i_helpdesk\nradmin -down-> i_monitor\nradmin -left-> i_remoteadmin\n\n\ncollector -right- i_define\ncollector -right- i_export\nowner -left-> i_define\noffline -left-> i_export\nowner -up-> i_remoteadmin\n\n\nvoterlist -right- i_voterlist\nbackup -right- i_backup\n\n\ncollector .left.> i_backup\ncollector .left.> i_voterlist\n\n@enduml\n" }, { "path": "Documentation/public/arhitektuur/model/collector-in.pu", "content": "@startuml\n\nleft to right direction\n\npackage \"Kogumisteenus\" {\n [Storage] as collector\n [Log] as log\n [Eligibility] as elig\n [Verification] as verif\n [Admin] as adminc\n\n\ninterface \"Valimise defineerimine\" as i_define\ninterface \"Ümbrikute väljastamine\" as i_export\ninterface \"Hääletamine\" as i_vote\ninterface \"Kontrollimine\" as i_verify\ninterface \"Valikute nimekiri\" as i_cls\ninterface \"Käsurida\" as i_localadmin\ninterface \"Kaughaldus\" as i_remoteadmin\ninterface \"Monitooring\" as i_monitor\ninterface \"Helpdesk\" as i_helpdesk\n\n\n\n}\n\nelig -- collector\nverif -- collector\n\nverif ..> log\nelig ..> log\ncollector ..> log\n\npackage \"Keskkonnateenused\" {\n [Registreerimisteenus] as tsa\n [Autentimisteenus] as auth\n [Allkirjateenus] as sign\n}\n\n[Nimekirjad] as voterlist\n[Varundamine] as backup\n\n\ncollector ..> tsa\n\ni_vote ..> sign\ni_cls ..> auth\n\ninterface \"Varundamine\" as i_backup\ninterface \"Nimekirjade uuendused\" as i_voterlist\n\nelig -up- i_cls\nelig -up- i_vote\nverif -up- i_verify\n\n\ncollector -down- i_localadmin\nlog -down- i_helpdesk\nlog -down- i_monitor\nadminc -down- i_remoteadmin\n\n\n\nadminc -down- i_define\nadminc -down- i_export\n\n\nvoterlist -right- i_voterlist\nbackup -right- i_backup\n\n\ncollector .left.> i_backup\nelig .left.> i_voterlist\n\n@enduml\n" }, { "path": "Documentation/public/arhitektuur/model/development.pu", "content": "@startuml\n\n!ifdef MONITORING\n !define COLLECTOR\n !define OWNER\n!endif\n\n!ifdef KEY_APPLICATION\n !define OWNER\n !define GENERIC_APP\n!endif\n\n!ifdef AUDIT_APPLICATION\n !define EXTERNAL_MODULES\n !define GENERIC_APP\n!endif\n\n!ifdef PROCESSING_APPLICATION\n !define GENERIC_APP\n !define EXTERNAL_MODULES\n!endif\n\n!ifdef APP_MODULES\n !define EXTERNAL_MODULES\n !define HELPER_MODULES\n!endif\n\n!ifdef COLLECTOR_MICROSERVICES\n !define COLLECTOR\n !define SERVICES\n !define VOTER\n!endif\n\n!ifdef COLLECTOR_EXTENSION\n !define COLLECTOR\n !define EXTENSION_MODULES\n !define EXTERNAL_INTERFACES\n!endif\n\n\n!include skin.inc\n\n!ifdef GENERIC_APP\n interface \"TR_APP_LOG()\" <> as i_app_log\n!endif\n\n!ifdef PROCESSING_APPLICATION\n interface \"TR_IVOTERS_PDF()\" <> as i_ivoters_pdf\n !define ENCRYPTED_VOTES\n!endif\n\n\n\n!ifdef KEY_APPLICATION\n interface \"TR_KEY_SHARE()\" <> as i_key_share\n interface \"TR_INVALID_VOTES()\" <> as i_invalid_votes\n interface \"TR_CERTIFICATE()\" <> as i_certificate\n !define AUDITABLE\n!endif\n\n\n!ifdef AUDIT_APPLICATION\n interface \"TR_MIXING_PROOF()\" <> as i_mixing_proof\n !define AUDITABLE\n!endif\n\n\n!ifdef AUDITABLE\n interface \"TR_DECRYPTION_PROOF()\" <> as i_decryption_proof\n interface \"TR_VOTING_RESULT()\" <> as i_voting_result\n interface \"TR_MIXED_VOTES()\" <> as i_mixed_votes\n !define ENCRYPTED_VOTES\n!endif\n\n\n!ifdef ENCRYPTED_VOTES\n interface \"TR_ENCRYPTED_VOTES()\" <> as i_encrypted_votes\n!endif\n\n'interface \"TR_CONF_BUNDLE()\" <> as i_conf_bundle\n\n\n/'\n '\n ' ACTORS\n '\n '/\n\n!ifdef OWNER\n actor \"TR_A_OWNER()\" <> as a_owner\n!endif\n\n!ifdef MONITORING\n actor \"TR_A_HELPDESK()\" <> as a_helpdesk\n actor \"TR_A_SYSADMIN()\" <> as a_sysadmin\n!endif\n\n!ifdef KEY_APPLICATION\n actor \"TR_A_KEYMANAGER()\" <> as a_keymanager\n a_keymanager ..> i_key_share\n!endif\n\n!ifdef PROCESSING_APPLICATION\n actor \"TR_A_OFFLINE_PROCESSOR()\" <> as a_offline_processor\n!endif\n\n!ifdef AUDIT_APPLICATION\n actor \"TR_A_AUDITOR()\" <> as a_auditor\n!endif\n\n/'\n '\n ' EXTERNAL SERVICES\n '\n '/\n\n!ifdef EXTERNAL_INTERFACES\ninterface \"TR_SK_OCSP()\" <> as i_sk_ocsp\ninterface \"TR_SK_AUTH()\" <> as i_sk_auth\ninterface \"TR_RFC_3161()\" <> as i_rfc_3161\ninterface \"TR_MID()\" <> as i_mid\n!endif\n\n\n!ifdef PROCESSING_APPLICATION\ninterface \"TR_REGISTERED_VOTES()\" <> as i_registered_votes\n!endif\n\n!ifdef EXTERNAL_SERVICES\n[TR_SK_OCSP()] <> as sk_ocsp\nsk_ocsp -up- i_sk_ocsp\nsk_ocsp -down- i_registered_votes\n\n[TR_RFC_3161()] <> as rfc_3161\nrfc_3161 -up- i_rfc_3161\nrfc_3161 -down- i_registered_votes\n\n\n[TR_DDOC_SERVICE()] <> as ddoc_service\nddoc_service -up- i_mid\n\n!endif\n\n!ifdef MONITORING\n[TR_ELECTION_WWW()] <> as election_www\n[TR_ZABBIX_EXT()] <> as zabbix_ext\n'[TR_MESSENTE()] <> as messente\n'interface \"TR_MESSENTE()\" <> as i_messente\n\n interface \"TR_MONITOR()\" <> as i_monitor\n interface \"TR_HELPDESK()\" <> as i_helpdesk\n'messente -up- i_messente\n\n!endif\n\n\n\n\n\n\n!ifdef PROCESSING_APPLICATION\ninterface \"TR_VIS_VOTERS()\" <> as i_vis_voters\ninterface \"TR_VIS_REVOKE()\" <> as i_vis_revoke\ninterface \"TR_POP_VOTERS()\" <> as i_pop_voters\ninterface \"TR_VIS_DIST()\" <> as i_vis_dist\n!endif\n\n\n'[TR_VIS()] <> as vis\n'interface \"TR_VIS_RESULTS()\" <> as i_vis_results\n'vis -up- i_vis_results\n'interface \"TR_VIS_CANDS()\" <> as i_vis_cands\n'vis - i_vis_cands\n'vis -up- i_vis_dist\n\n\n!ifdef VIS\nvis -up- i_vis_voters\nvis -up- i_vis_revoke\n\n[TR_POP()] <> as pop\npop -up- i_pop_voters\n!endif\n\n\n!ifdef EXTERNAL_MODULES\n[TR_JDIGIDOC()] <> as jdigidoc\ninterface \"TR_JAVA()\" <> as i_java\ni_java -right- jdigidoc\n!endif\n\n\n!ifdef HELPER_MODULES\npackage \"TR_P_HELPERS()\" as p_helpers {\n\n interface \"TR_ELEC()\" <> as elec\n [TR_RK_ELEC()] <> as rk_elec\n [TR_RH_ELEC()] <> as rh_elec\n [TR_EP_ELEC()] <> as ep_elec\n [TR_KOV_ELEC()] <> as kov_elec\n\n rk_elec -up- elec\n rh_elec -up- elec\n ep_elec -up- elec\n kov_elec -up- elec\n}\n!endif\n\n\n\n\n!ifdef PROCESSING_APPLICATION\ninterface \"TR_EXPORT_VOTES()\" <> as i_export_votes\n!endif\n\n\n!ifdef COLLECTOR\n\npackage \"TR_P_COLLECTOR()\" as p_collector {\n\n\n\n\n\n!ifdef SUPPORT\n [TR_ADMIN_APP()] <> as admin_app\n' admin_app - i_export_votes\n interface \"TR_LOCALADMIN()\" <> as i_localadmin\n interface \"TR_REMOTEADMIN()\" <> as i_remoteadmin\n admin_app -up- i_localadmin\n admin_app -left- i_remoteadmin\n\n\n [TR_BACKUP()] <> as backup\n\n\n\n interface \"TR_BACKUP()\" <> as i_backup\n backup - i_backup\n!endif\n\n!ifdef MONITORING\n\n interface \"TR_LOG_INT()\" <> as i_log_int\n interface \"TR_ZABBIX()\" <> as i_zabbix\n\n rectangle \"TR_R_MONITORING()\" as r_monitoring {\n [TR_IVXV_MONITOR()] <> as ivxv_monitor\n\n database \"TR_MONITOR_DB()\" as monitor_db {\n }\n\n interface \"TR_LOG_EXT()\" <> as i_log_ext\n' interface \"TR_LOG_SMTP()\" <> as i_log_smtp\n' interface \"TR_LOG_SMS()\" <> as i_log_sms\n ivxv_monitor -down- i_log_int\n' ivxv_monitor -down- i_log_smtp\n' ivxv_monitor -down- i_log_sms\n ivxv_monitor -up- i_log_ext\n ivxv_monitor -up- i_zabbix\n ivxv_monitor -left-> monitor_db\n\n zabbix_ext <-left- i_monitor\n zabbix_ext <-left- i_helpdesk\n' i_log_sms -> i_messente\n\n }\n\n a_helpdesk -down-> i_helpdesk\n a_owner -down-> i_monitor\n a_sysadmin -down-> i_monitor\n\n election_www --> i_log_ext\n zabbix_ext --> i_zabbix\n\n!endif\n\n\n!ifdef EXTENSION_MODULES\n\n interface \"TR_API_INT()\" <> as i_api_int\n\n rectangle \"TR_R_MID_AUTH()\" as r_mid_auth {\n [TR_MID_AUTH()] <> as mid_auth\n [TR_MID_SIGN()] <> as mid_sign\n\n interface \"TR_MID()\" <> as i_mid\n\n mid_auth -up- i_mid\n mid_sign -up- i_mid\n\n mid_auth -down-> i_mid\n mid_sign -down-> i_mid\n }\n\n rectangle \"TR_R_EXTENSION()\" as r_extension {\n [TR_TLS()] <> as tls\n [TR_TICKET()] <> as ticket\n [TR_BDOC()] <> as bdoc\n [TR_OCSP()] <> as ocsp\n [TR_TSP()] <> as tsp\n [TR_REG()] <> as reg\n\n interface \"TR_AUTH()\" <> as i_auth\n interface \"TR_VERIFY()\" <> as i_verify\n interface \"TR_Q11N()\" <> as i_q11n\n\n tls -up- i_auth\n ticket -up- i_auth\n bdoc -up- i_verify\n ocsp -up- i_q11n\n tsp -up- i_q11n\n reg -up- i_q11n\n\n tls -down-> i_sk_auth\n ocsp -down-> i_sk_ocsp\n tsp -down-> i_rfc_3161\n reg -down-> i_sk_ocsp\n reg -down-> i_rfc_3161\n }\n\n i_api_int -down-> i_mid\n i_api_int -down-> i_auth\n i_api_int -down-> i_verify\n i_api_int -down-> i_q11n\n!endif\n\n!ifdef SERVICES\n rectangle \"TR_R_STORAGE()\" as r_storage {\n [TR_STORAGE()] <> as storage\n\n database \"TR_STORAGE_DB()\" as storage_db {\n }\n\n database \"TR_CONF_DB_STORAGE()\" as conf_db_storage {\n }\n\n\n storage -> storage_db\n\n interface \"TR_TLS_STORAGE()\" <> as i_tls_storage\n i_tls_storage -- storage\n\n }\n\n\n\n rectangle \"TR_R_CLS()\" as r_cls {\n interface \"TR_TLS_CLS()\" <> as i_tls_cls\n [TR_CLS()] <> as cls\n\n database \"TR_CONF_DB_CLS()\" as conf_db_cls {\n }\n cls --> i_tls_storage\n\n cls -up- i_tls_cls\n }\n\n rectangle \"TR_R_VERIFY()\" as r_verify {\n interface \"TR_TLS_VERIFY()\" <> as i_tls_verify\n [TR_VERIFY()] <> as verify\n\n database \"TR_CONF_DB_VERIFY()\" as conf_db_verify {\n }\n verify --> i_tls_storage\n\n verify -up- i_tls_verify\n }\n\n rectangle \"TR_R_VOTING()\" as r_voting {\n interface \"TR_TLS_VOTE()\" <> as i_tls_vote\n [TR_VOTE()] <> as vote\n\n database \"TR_CONF_DB_VOTE()\" as conf_db_vote {\n }\n vote --> i_tls_storage\n\n vote -up- i_tls_vote\n }\n\n rectangle \"TR_R_DISPATCH()\" as r_dispatch {\n interface \"TR_HTTPS_EXT()\" <> as i_https_ext\n interface \"TR_TLS_INT()\" <> as i_tls_int\n [TR_FORWARDER()] <> as forwarder\n\n database \"TR_CONF_DB_FORWARDER()\" as conf_db_forwarder {\n }\n\n i_tls_int --> i_tls_cls\n i_tls_int --> i_tls_vote\n i_tls_int --> i_tls_verify\n\n forwarder -up- i_https_ext\n forwarder -down-> i_tls_int\n }\n\n!endif\n\n}\n\n!endif\n\n\n/'\n '\n ' VÕTMERAKENDUS\n '\n '/\n\n!ifdef KEY_APPLICATION\npackage \"TR_P_KEY()\" as p_key {\n [TR_KEY_APP()] <> as key_app\n\n interface \"TR_KEY_IN()\" <> as i_key_in\n interface \"TR_KEY_OUT()\" <> as i_key_out\n interface \"TR_PKCS15()\" <> as i_pkcs15\n interface \"TR_KEY_GUI()\" <> as i_key_gui\n\n key_app -down-> i_pkcs15\n key_app -left-> i_key_in\n key_app -up-> i_key_out\n key_app -right-> i_key_gui\n\n\n i_pkcs15 -- i_key_share\n i_key_in ..> i_mixed_votes\n i_key_out .up.> i_voting_result\n i_key_out .up.> i_decryption_proof\n i_key_out .up.> i_app_log\n i_key_out .up.> i_certificate\n i_key_out .up.> i_invalid_votes\n}\n\na_owner -> i_key_gui\n!endif\n\n\n/'\n '\n ' TÖÖTLEMISRAKENDUS\n '\n '/\n\n!ifdef PROCESSING_APPLICATION\npackage \"TR_P_PROCESSOR()\" as p_processor {\n [TR_OFFLINE_PROCESSOR()] <> as offline_processor\n [TR_PDF_API()] <> as pdf_api\n\n offline_processor -> pdf_api\n\n interface \"TR_PROCESSOR_IN()\" <> as i_processor_in\n interface \"TR_PROCESSOR_OUT()\" <> as i_processor_out\n interface \"TR_PROCESSOR_GUI()\" <> as i_processor_gui\n offline_processor -down-> i_processor_in\n offline_processor -left- i_processor_gui\n offline_processor -up-> i_processor_out\n offline_processor -right-> i_java\n\n i_processor_in ..> i_registered_votes\n i_processor_in ..> i_vis_revoke\n i_processor_in ..> i_vis_dist\n i_processor_in ..> i_pop_voters\n i_processor_in ..> i_export_votes\n\n i_processor_out .up.> i_vis_voters\n i_processor_out .up.> i_ivoters_pdf\n i_processor_out .up.> i_encrypted_votes\n i_processor_out .up.> i_app_log\n}\n\na_offline_processor -> i_processor_gui\n!endif\n\n/'\n '\n ' AUDITIRAKENDUS\n '\n '/\n\n!ifdef AUDIT_APPLICATION\npackage \"TR_P_AUDIT()\" as p_audit {\n [TR_OFFLINE_AUDIT()] <> as offline_audit\n [TR_DECRYPTION_VERIFIER()] <> as decryption_verifier\n interface \"TR_MIXING_VERIFIER()\" <> as i_mixing_verifier\n interface \"TR_AUDIT_IN()\" <> as i_audit_in\n interface \"TR_AUDIT_OUT()\" <> as i_audit_out\n interface \"TR_AUDIT_GUI()\" <> as i_audit_gui\n\n offline_audit --> decryption_verifier\n offline_audit --> i_mixing_verifier\n\n offline_audit -down-> i_audit_in\n offline_audit -left- i_audit_gui\n offline_audit -up-> i_audit_out\n offline_audit -right-> i_java\n\n i_audit_in ..> i_encrypted_votes\n i_audit_in ..> i_mixed_votes\n i_audit_in ..> i_decryption_proof\n i_audit_in ..> i_mixing_proof\n i_audit_in ..> i_voting_result\n\n\n i_audit_out ..> i_app_log\n\n}\n\na_auditor -> i_audit_gui\n!endif\n\n/'\n '\n ' SEADISTUSRAKENDUS\n '\n '/\n\n!ifdef CONFIG_APPLICATION\npackage \"TR_P_CONFIG()\" as p_config {\n [TR_CONF_APP()] <> as conf_app\n\n database \"TR_CONF_DB()\" as conf_db {\n }\n\n conf_app -> conf_db\n\n interface \"TR_CONF_IN()\" <> as i_conf_in\n interface \"TR_CONF_OUT()\" <> as i_conf_out\n\n interface \"TR_SMTP()\" <> as i_smtp\n interface \"TR_CONF_GUI()\" <> as i_conf_gui\n\n conf_app -up- i_smtp\n conf_app -down- i_conf_in\n conf_app -down- i_conf_out\n conf_app -down- i_conf_gui\n\n i_conf_out --> i_conf_bundle\n i_conf_out --> i_app_log\n\n i_conf_in --> i_vis_dist\n i_conf_in --> i_vis_cands\n i_conf_in --> i_pop_voters\n}\n\na_owner --> i_conf_gui\n!endif\n\n\n\n\n\n\n\n/'\nactor \"TR_A_ADMIN()\" <> as admin\nowner -left-> i_remoteadmin\nadmin -down-> i_localadmin\nadmin -down-> i_backup\n'/\n\n!ifdef VOTER\nactor \"TR_A_VOTER()\" <> as voter\ninterface \"TR_VOTE()\" <> as i_vote\ninterface \"TR_INDVERIFY()\" <> as i_indverify\ni_https_ext -up- i_vote\ni_https_ext -up- i_indverify\nvoter -down-> i_vote\nvoter -down-> i_indverify\n!endif\n\n\n@enduml\n" }, { "path": "Documentation/public/arhitektuur/model/elec-vote.pu", "content": "@startuml\n\ntitle \"Hääletamisfaas\"\n\nactor Valija as Voter\nparticipant VER\nparticipant VA\n\nparticipant Auth\nparticipant Sign\nparticipant CAVA\nparticipant TSA\n\nbox \"Collector Service\"\n participant AuthProxy\n participant SignProxy\n participant VerProxy\n participant CLS\n participant VSS\nend box\n\n== Hääletamine ==\n\nVA -> CLS: Valija identifikaator, id\n\nalt Võimalik autentimine\n CLS --> VA\n VA --> AuthProxy\n AuthProxy --> Auth\n Auth --> Voter\n AuthProxy --> VA\n VA --> CLS: AUTH(id)\nend\n\nCLS -> VA: Valikute nimekiri, C_id\n\nVA -> Voter: Valikute kuvamine, C_id\nVoter -> VA: Valiku tegemine, choice_id\n\nVA -> VA: r = GEN()\nVA -> VA: ballot_id = ENC(choice_id;r)\n\nalt Allkirjastamine lokaalselt\n VA --> VA: vote_id = SIGN(ballot_id, id)\nelse Allkirjastamine läbi proksi\n VA --> SignProxy\n SignProxy --> Sign\n Sign --> Voter\n SignProxy --> VA: vote_id = SIGN(ballot_id, id)\nend\n\nVA -> VSS: vote_id\n\nVSS -> CAVA: id\nCAVA -> VSS: val_id = Valid(id)\n\nVSS -> TSA: vote_id\nTSA -> VSS: tok_id = Timestamp(vote_id)\n\nVSS -> VSS: vote_ref = Store(vote_id, val_id, tok_id)\n\nVSS -> VA: tok_id, vote_ref\n\nVA -> VA: VerTimestamp(tok_id)\nVA -> Voter: vote_ref, r\n\n== Hääle kontroll ==\n\nVoter -> VER: vote_ref, r\n\nVER -> VerProxy: vote_ref\nVerProxy -> VSS: vote_ref\nVSS -> VerProxy: vote_id, tok_id, val_id\nVerProxy -> VER: vote_id, tok_id, val_id\nVER -> VER: id, choice = VerifyVote(vote_id, tok_id, val_id)\nVER -> Voter: id, choice\n\n@enduml\n" }, { "path": "Documentation/public/arhitektuur/model/election.pu", "content": "@startuml\n\nactor Voter\nparticipant VER\nparticipant VA\n\nparticipant Auth\nparticipant Sign\n\nbox \"Collector Service\"\n participant AuthProxy\n participant SignProxy\n participant CLS\n participant VSS\nend box\n\nparticipant CAVA\nparticipant TSA\n\nparticipant CONF\nparticipant WORKER\nparticipant MIX\nparticipant DECRYPT\nactor Owner\nactor Auditor\n\n\n== Setup phase ==\n\n== Voting phase ==\n\nVA -> CLS: Valija identifikaator, id\n\nalt Võimalik autentimine\n CLS --> VA\n VA --> AuthProxy\n AuthProxy --> Auth\n Auth --> Voter\n Voter --> Auth\n Auth --> AuthProxy\n AuthProxy --> VA\n VA --> CLS: AUTH(id)\nend\n\nCLS -> VA: Valikute nimekiri, C_id\n\nVA -> Voter: Valikute kuvamine, C_id\nVoter -> VA: Valiku tegemine, choice_id\n\nVA -> VA: r = GEN()\nVA -> VA: ballot_id = ENC(choice_id;r)\n\nalt Allkirjastamine lokaalselt\n VA --> VA: vote_id = SIGN(ballot_id, id)\nelse Allkirjastamine läbi proksi\n VA --> SignProxy\n SignProxy --> Sign\n Sign --> Voter\n Voter --> Sign\n Sign --> SignProxy\n SignProxy --> VA: vote_id = SIGN(ballot_id, id)\nend\n\nVA -> VSS: vote_id\n\nVSS -> CAVA: id\nCAVA -> VSS: val_id = Valid(id)\n\nVSS -> TSA: vote_id\nTSA -> VSS: tok_id = Timestamp(vote_id)\n\nVSS -> VSS: vote_ref = Store(vote_id, val_id, tok_id)\n\nVSS -> VA: tok_id, vote_ref\n\n\n== Tallying phase ==\n\n== Auditing phase ==\n\n\n@enduml\n" }, { "path": "Documentation/public/arhitektuur/model/en/lang.pu", "content": "\n' SKIN.INC\n\n!define TR_EXTERNAL() External\n!define TR_UNSPECIFIED() Unspecified\n!define TR_NEC() NEC\n!define TR_IVXV() IVXV\n\n\n' EXAMPLE.PU\n\n!define TR_STAKEHOLDER() Stakeholder\n\n!define TR_APPLICATION() Application\n!define TR_SERVICE() Service\n\n!define TR_INTERFACE() Interface\n!define TR_UNSPECIFIED_INTERFACE() Unspecified interface\n\n!define TR_COMPONENT() Component\n!define TR_IVXV_COMPONENT() IVXV Component\n!define TR_EXTERNAL_COMPONENT() External component\n!define TR_DATABASE() Database\n\n\n' DEVELOPMENT.PU\n\n!define TR_MONITOR_DB() Logs\n!define TR_STORAGE_DB() Lists and votes\n!define TR_CONF_DB_CLS() Settings\n!define TR_CONF_DB_FORWARDER() Settings\n!define TR_CONF_DB_STORAGE() Settings\n!define TR_CONF_DB_VERIFY() Settings\n!define TR_CONF_DB_VOTE() Settings\n!define TR_CONF_DB() Settings\n!define TR_P_HELPERS() Helper modules\n!define TR_P_AUDIT() Audit application\n!define TR_P_COLLECTOR() Collection service\n!define TR_P_CONFIG() Configuration application\n!define TR_P_PROCESSOR() Processor\n!define TR_P_KEY() Key application\n!define TR_R_VOTING() Voting service\n!define TR_R_VERIFY() Verification service\n!define TR_R_EXTENSION() Extension modules\n!define TR_R_MID_AUTH() Mobiil-ID helper service\n!define TR_R_MONITORING() Monitoring\n!define TR_R_CLS() Choicelist service\n!define TR_R_STORAGE() Storage\n!define TR_R_DISPATCH() Dispatcher\n\n!define TR_ADMIN_APP() Management\n!define TR_BACKUP() Backup\n!define TR_BDOC() BDOC\n!define TR_CLS() Choicelist service\n!define TR_CONF_APP() Configuration app\n!define TR_DDOC_SERVICE() Mobile ID Service\n!define TR_DECRYPTION_VERIFIER() Decryption proof verifier\n!define TR_ELECTION_WWW() Election WWW\n!define TR_EP_ELEC() Europarliament\n!define TR_FORWARDER() Dispatcher\n!define TR_IVXV_MONITOR() Logmonitor\n!define TR_JDIGIDOC() DigiDoc4J\n!define TR_KEY_APP() Key app\n!define TR_KOV_ELEC() Local government\n!define TR_MESSENTE() Messente SMS\n!define TR_MID_AUTH() Authentication\n!define TR_MID_SIGN() Signing\n!define TR_OCSP() OCSP\n!define TR_OFFLINE_AUDIT() Audit\n!define TR_OFFLINE_PROCESSOR() Processor\n!define TR_PDF_API() PDF API\n!define TR_POP() Population register\n!define TR_REG() Registering service\n!define TR_RFC_3161() RFC3161 Registering service\n!define TR_RH_ELEC() Referendum\n!define TR_RK_ELEC() Riigikogu\n!define TR_SK_OCSP() OCSP Registering service\n!define TR_STORAGE() Storage\n!define TR_TICKET() Authentication, ticket\n!define TR_TLS() Authentication, TLS\n!define TR_TSP() Timestamp\n!define TR_VERIFY() Verification service\n!define TR_VIS() VIS\n!define TR_VOTE() Voting\n!define TR_ZABBIX_EXT() External monitoring\n\n!define TR_A_ADMIN() Local admin\n!define TR_A_AUDITOR() Auditor\n!define TR_A_HELPDESK() Helpdesk\n!define TR_A_KEYMANAGER() Keymanager\n!define TR_A_OFFLINE_PROCESSOR() Processor\n!define TR_A_OWNER() Election owner\n!define TR_A_SYSADMIN() System admin\n!define TR_A_VOTER() Voter\n\n!define TR_API_INT() IVXV API\n!define TR_APP_LOG() Application log\n!define TR_AUDIT_GUI() GUI\n!define TR_AUDIT_IN() FS Import\n!define TR_AUDIT_OUT() FS Export\n!define TR_AUTH() Authentication\n!define TR_BACKUP() Backup\n!define TR_CERTIFICATE() Certificate\n!define TR_CONF_BUNDLE() Configuration bundle\n!define TR_CONF_GUI() GUI\n!define TR_CONF_IN() FS Import\n!define TR_CONF_OUT() FS Export\n!define TR_DECRYPTION_PROOF() Decryption proof\n!define TR_ELEC() Election interface\n!define TR_ENCRYPTED_VOTES() Anonymized votes\n!define TR_EXPORT_VOTES() Votes export\n!define TR_HELPDESK() Helpdesk\n!define TR_HTTPS_EXT() HTTPS\n!define TR_INDVERIFY() Verification application\n!define TR_INVALID_VOTES() List of invalid votes\n!define TR_IVOTERS_PDF() List of i-voters, PDF\n!define TR_JAVA() DigiDoc4J\n!define TR_KEY_GUI() GUI\n!define TR_KEY_IN() FS Import\n!define TR_KEY_OUT() FS Export\n!define TR_KEY_SHARE() Key share\n!define TR_LOCALADMIN() Command line administration\n!define TR_LOG_EXT() HTTPS\n!define TR_LOG_INT() RELP-JSON\n!define TR_LOG_SMS() SMS\n!define TR_LOG_SMTP() SMTP\n!define TR_MESSENTE() Messente\n!define TR_MID() Mobile ID Service\n!define TR_MIXED_VOTES() Shuffled ballots\n!define TR_MIXING_PROOF() Proof of shuffle\n!define TR_MIXING_VERIFIER() Shuffle verifier\n!define TR_MONITOR() Monitoring\n!define TR_PKCS15() PKCS15\n!define TR_POP_VOTERS() Voterlist\n!define TR_PROCESSOR_GUI() GUI\n!define TR_PROCESSOR_IN() FS Import\n!define TR_PROCESSOR_OUT() FS Export\n!define TR_Q11N() Qualification\n!define TR_REGISTERED_VOTES() Registered votes\n!define TR_REMOTEADMIN() Remote administration\n!define TR_RFC_3161() RFC3161\n!define TR_SK_AUTH() Authentication OCSP\n!define TR_SK_OCSP() OCSP\n!define TR_SMTP() Urgent command (SMTP)\n!define TR_TLS_CLS() Choices\n!define TR_TLS_INT() TLS-SNI\n!define TR_TLS_STORAGE() TLS\n!define TR_TLS_VERIFY() Verification\n!define TR_TLS_VOTE() Voting\n!define TR_VERIFY() Verification\n!define TR_VIS_CANDS() List of choices\n!define TR_VIS_DIST() List of districts\n!define TR_VIS_RESULTS() Tally import\n!define TR_VIS_REVOKE() Revokation/restoration list\n!define TR_VIS_VOTERS() List of i-voters\n!define TR_VOTE() Voting application\n!define TR_VOTING_RESULT() Voting result\n!define TR_ZABBIX() Zabbix\n\n' MS\n\n!define TR_MS_STATE_TITLE() Collection service states\n\n\n!define TR_MS_S_UNINSTALLED() Uninstalled\n!define TR_MS_S_INSTALLED() Installed\n!define TR_MS_S_SETUP() Set up\n!define TR_MS_S_FAILURE() Failure\n!define TR_MS_S_PARTIAL_FAILURE() Partial failure\n\n\n!define TR_MS_S_UNINSTALLED_TXT() - Management service is installed, \\\n\\n- Collector services are uninstalled.\n\n!define TR_MS_S_INSTALLED_TXT() All collector services are installed \\\n\\nand technical configuration applied. \\\n\\nElection configuration has not been applied.\n\n!define TR_MS_S_SETUP_TXT() Election configuration has been applied \\\n\\nto the Collection service \\\n\\nit is possible to vote \\\n\\nand export digital ballot box\n\n!define TR_MS_S_FAILURE_TXT() At least one collector service has failed. \\\n\\nCollection service is unfunctional\n\n!define TR_MS_S_PARTIAL_FAILURE_TXT() At least one replicated collector service \\\n\\nhas failed, Collection service is functional.\n\n\n!define TR_MS_TRANS_INSTALL() Installation of services\n!define TR_MS_TRANS_SETUP() Application of election configuration\n!define TR_MS_TRANS_FAIL() Failure detection\n!define TR_MS_TRANS_RECOVERY() Recovery detection\n" }, { "path": "Documentation/public/arhitektuur/model/et/lang.pu", "content": "\n' SKIN.INC\n\n!define TR_EXTERNAL() Väline\n!define TR_UNSPECIFIED() Määratlemata\n!define TR_NEC() VVK\n!define TR_IVXV() IVXV\n\n\n' EXAMPLE.PU\n\n!define TR_STAKEHOLDER() Osapool\n\n!define TR_APPLICATION() Rakendus\n!define TR_SERVICE() Teenus\n\n!define TR_INTERFACE() Liides\n!define TR_UNSPECIFIED_INTERFACE() Määratlemata liides\n\n!define TR_COMPONENT() Komponent\n!define TR_IVXV_COMPONENT() IVXV komponent\n!define TR_EXTERNAL_COMPONENT() Väline komponent\n!define TR_DATABASE() Andmebaas\n\n\n' DEVELOPMENT.PU\n\n!define TR_MONITOR_DB() Logid\n!define TR_STORAGE_DB() Nimekirjad ja hääled\n!define TR_CONF_DB_CLS() Seaded\n!define TR_CONF_DB_FORWARDER() Seaded\n!define TR_CONF_DB_STORAGE() Seaded\n!define TR_CONF_DB_VERIFY() Seaded\n!define TR_CONF_DB_VOTE() Seaded\n!define TR_CONF_DB() Seadistused\n!define TR_P_HELPERS() Abimoodulid\n!define TR_P_AUDIT() Auditirakendus\n!define TR_P_COLLECTOR() Kogumisteenus\n!define TR_P_CONFIG() Seadistusrakendus\n!define TR_P_PROCESSOR() Töötlemisrakendus\n!define TR_P_KEY() Võtmerakendus\n!define TR_R_VOTING() Hääletamisteenus\n!define TR_R_VERIFY() Kontrollteenus\n!define TR_R_EXTENSION() Laiendusmoodulid\n!define TR_R_MID_AUTH() Mobiil-ID abiteenus\n!define TR_R_MONITORING() Monitooring\n!define TR_R_CLS() Nimekirjateenus\n!define TR_R_STORAGE() Talletamisteenus\n!define TR_R_DISPATCH() Vahendusteenus\n\n!define TR_ADMIN_APP() Haldus\n!define TR_BACKUP() Varundamine\n!define TR_BDOC() BDOC\n!define TR_CLS() Nimekirjateenus\n!define TR_CONF_APP() Seadistusrakendus\n!define TR_DDOC_SERVICE() Mobile ID Service\n!define TR_DECRYPTION_VERIFIER() Lugemistõendi kontroll\n!define TR_ELECTION_WWW() Valimiste veebiserver\n!define TR_EP_ELEC() Europarlament\n!define TR_FORWARDER() Vahendusteenus\n!define TR_IVXV_MONITOR() Logianalüsaator\n!define TR_JDIGIDOC() DigiDoc4J\n!define TR_KEY_APP() Võtmerakendus\n!define TR_KOV_ELEC() Kohaliku omavalitsuse volikogu\n!define TR_MESSENTE() Messente SMS\n!define TR_MID_AUTH() Autentimine\n!define TR_MID_SIGN() Allkirjastamine\n!define TR_OCSP() Kehtivuskinnitus\n!define TR_OFFLINE_AUDIT() Audit\n!define TR_OFFLINE_PROCESSOR() Töötlemisrakendus\n!define TR_PDF_API() PDF API\n!define TR_POP() Rahvastikuregister\n!define TR_REG() Registreerimine\n!define TR_RFC_3161() RFC3161 Registreerimisteenus\n!define TR_RH_ELEC() Rahvahääletus\n!define TR_RK_ELEC() Riigikogu\n!define TR_SK_OCSP() OCSP Registreerimisteenus\n!define TR_STORAGE() Talletamisteenus\n!define TR_TICKET() Autentimine, pilet\n!define TR_TLS() Autentimine, TLS\n!define TR_TSP() Ajatempel\n!define TR_VERIFY() Kontrollteenus\n!define TR_VIS() VIS\n!define TR_VOTE() Hääletamisteenus\n!define TR_ZABBIX_EXT() Väline monitooringuserver\n\n!define TR_A_ADMIN() Admin\n!define TR_A_AUDITOR() Audiitor\n!define TR_A_HELPDESK() Klienditugi\n!define TR_A_KEYMANAGER() Võtmehaldur\n!define TR_A_OFFLINE_PROCESSOR() Töötleja\n!define TR_A_OWNER() Korraldaja\n!define TR_A_SYSADMIN() Süs.admin\n!define TR_A_VOTER() Valija\n\n!define TR_API_INT() IVXV API\n!define TR_APP_LOG() Rakenduse logi\n!define TR_AUDIT_GUI() GUI\n!define TR_AUDIT_IN() FS Import\n!define TR_AUDIT_OUT() FS Export\n!define TR_AUTH() Tuvastamine\n!define TR_BACKUP() Varundamine\n!define TR_CERTIFICATE() Sertifikaat\n!define TR_CONF_BUNDLE() Konfiguratsioonifail\n!define TR_CONF_GUI() GUI\n!define TR_CONF_IN() FS Import\n!define TR_CONF_OUT() FS Export\n!define TR_DECRYPTION_PROOF() Lugemistõend\n!define TR_ELEC() Valimise liides\n!define TR_ENCRYPTED_VOTES() Anonüümitud hääled\n!define TR_EXPORT_VOTES() Häälte eksport\n!define TR_HELPDESK() Helpdesk\n!define TR_HTTPS_EXT() HTTPS\n!define TR_INDVERIFY() Kontrollrakendus\n!define TR_INVALID_VOTES() Kehtetute häälte loend\n!define TR_IVOTERS_PDF() E-hääletanute nimekiri PDF\n!define TR_JAVA() DigiDoc4J\n!define TR_KEY_GUI() GUI\n!define TR_KEY_IN() FS Import\n!define TR_KEY_OUT() FS Export\n!define TR_KEY_SHARE() Võtmeosak\n!define TR_LOCALADMIN() Käsurida\n!define TR_LOG_EXT() HTTPS\n!define TR_LOG_INT() RELP-JSON\n!define TR_LOG_SMS() SMS\n!define TR_LOG_SMTP() SMTP\n!define TR_MESSENTE() Messente\n!define TR_MID() Mobiil-ID abiteenus\n!define TR_MIXED_VOTES() Miksitud hääled\n!define TR_MIXING_PROOF() Miksimistõend\n!define TR_MIXING_VERIFIER() Miksimistõendi kontroll\n!define TR_MONITOR() Monitooring\n!define TR_PKCS15() PKCS15\n!define TR_POP_VOTERS() Valijate nimekiri\n!define TR_PROCESSOR_GUI() GUI\n!define TR_PROCESSOR_IN() FS Import\n!define TR_PROCESSOR_OUT() FS Export\n!define TR_Q11N() Täiendamine\n!define TR_REGISTERED_VOTES() Registreeritud hääled\n!define TR_REMOTEADMIN() Kaughaldus\n!define TR_RFC_3161() RFC3161\n!define TR_SK_AUTH() Autentimise OCSP\n!define TR_SK_OCSP() OCSP\n!define TR_SMTP() Kiirkorraldus (SMTP)\n!define TR_TLS_CLS() Valikud\n!define TR_TLS_INT() TLS-SNI\n!define TR_TLS_STORAGE() TLS\n!define TR_TLS_VERIFY() Kontrollimine\n!define TR_TLS_VOTE() Hääletamine\n!define TR_VERIFY() Verifitseerimine\n!define TR_VIS_CANDS() Kandidaatide nimekiri\n!define TR_VIS_DIST() Ringkondade nimekiri\n!define TR_VIS_RESULTS() Tulemuste sisestamine\n!define TR_VIS_REVOKE() Tühistus-ennistusnimekiri\n!define TR_VIS_VOTERS() E-hääletanute nimekiri\n!define TR_VOTE() Valijarakendus\n!define TR_VOTING_RESULT() Hääletamistulemus\n!define TR_ZABBIX() Zabbix\n\n\n'MS\n\n!define TR_MS_STATE_TITLE() Kogumisteenuse olek\n\n\n!define TR_MS_S_UNINSTALLED() Paigaldamata\n!define TR_MS_S_INSTALLED() Paigaldatud\n!define TR_MS_S_SETUP() Seadistatud\n!define TR_MS_S_FAILURE() Tõrge\n!define TR_MS_S_PARTIAL_FAILURE() Osaline tõrge\n\n\n!define TR_MS_S_UNINSTALLED_TXT() - Haldusteenus on paigaldatud, \\\n\\n- Alamteenused on paigaldamata.\n\n!define TR_MS_S_INSTALLED_TXT() Kõik alamteenused on paigaldatud \\\n\\nja tehniliselt seadistatud. \\\n\\nValimiste seadistust pole rakendatud.\n\n!define TR_MS_S_SETUP_TXT() Kogumisteenusele on rakendatud \\\n\\nvalimiste seadistused, teenusega \\\n\\non võimalik hääletust läbi viia \\\n\\nja e-valimiskasti väljastada.\n\n!define TR_MS_S_FAILURE_TXT() Üks või mitu alamteenust ei tööta, \\\n\\nkogumisteenuse oluline sõlm \\\n\\npole töökorras.\n\n!define TR_MS_S_PARTIAL_FAILURE_TXT() Üks või mitu dubleeritud \\\n\\nalamteenust ei tööta, \\\n\\nkogumisteenus töötab.\n\n\n!define TR_MS_TRANS_INSTALL() Teenuste \\n paigaldamine\n!define TR_MS_TRANS_SETUP() Valimiste \\n seadistuse \\n rakendamine \\n teenustele\n!define TR_MS_TRANS_FAIL() Teenuse \\n tõrkeoleku \\n tuvastamine\n!define TR_MS_TRANS_RECOVERY() Kõikide \\n teenuste \\n korrasoleku \\n tuvastamine\n" }, { "path": "Documentation/public/arhitektuur/model/example.pu", "content": "@startuml\n\n!include skin.inc\n\nactor \"TR_STAKEHOLDER()\" <> as a_owner\n\n\npackage TR_APPLICATION() {\n\n interface \"TR_INTERFACE()\" <> as liides_1\n interface \"TR_UNSPECIFIED_INTERFACE()\" <> as liides_3\n [TR_COMPONENT()] <> as komponent_1\n\n komponent_1 - liides_1\n komponent_1 -up- liides_3\n}\n\na_owner --> liides_3\n\npackage TR_SERVICE() {\n\n interface \"TR_INTERFACE()\" <> as liides_2\n [TR_IVXV_COMPONENT()] <> as komponent_2\n [TR_EXTERNAL_COMPONENT()] <> as komponent_3\n\n komponent_2 --> komponent_3\n komponent_2 - liides_2\n\n database \"TR_DATABASE()\" as andmebaas {\n }\n\n komponent_2 --> andmebaas\n\n}\n\nliides_1 --> liides_2\n\n\n@enduml\n" }, { "path": "Documentation/public/arhitektuur/model/general.pu", "content": "\n\n\n\nOsapooled\n\nOmanik\nHääletaja\nTöötleja\nAudiitor\n\n\nKlienditugi\n\n\nCollector\nATO\nVA-STO\nAuth\nSign\n" }, { "path": "Documentation/public/arhitektuur/model/ms-collector-status.pu", "content": "@startuml\n\nTitle TR_MS_STATE_TITLE()\n\nskinparam state {\n BackgroundColor<> LightGreen\n BackgroundColor<> LightCoral\n}\n\nstate \"TR_MS_S_UNINSTALLED()\" as s_uninstalled\ns_uninstalled : TR_MS_S_UNINSTALLED_TXT()\n\nstate \"TR_MS_S_INSTALLED()\" as s_installed <>\ns_installed : TR_MS_S_INSTALLED_TXT()\n\nstate \"TR_MS_S_SETUP()\" as s_setup <>\ns_setup : TR_MS_S_SETUP_TXT()\n\nstate \"TR_MS_S_FAILURE()\" as s_failure <>\ns_failure : TR_MS_S_FAILURE_TXT()\n\nstate \"TR_MS_S_PARTIAL_FAILURE()\" as s_partial_failure\ns_partial_failure : TR_MS_S_PARTIAL_FAILURE_TXT()\n\n\n[*] --> s_uninstalled\n\ns_uninstalled --> s_installed : TR_MS_TRANS_INSTALL()\n\ns_installed --> s_setup : TR_MS_TRANS_SETUP()\n\ns_setup --> s_partial_failure : TR_MS_TRANS_FAIL()\ns_setup --> [*]\n\ns_partial_failure --> s_setup : TR_MS_TRANS_RECOVERY()\ns_partial_failure --> s_failure\ns_partial_failure --> [*]\n\ns_failure --> s_partial_failure\ns_failure --> [*]\n\n@enduml\n" }, { "path": "Documentation/public/arhitektuur/model/ms-management-service-components.en.pu", "content": "@startuml\n\n!include skin.inc\n\nTitle Components of the Collection Service Management Service\n\n[User Web Browser] as User\n\nframe IVXV {\n [Statistics Server]\n interface \"HTTP\" as StatisticsHTTP\n [Statistics Server] -down- StatisticsHTTP\n\n frame \"Collection Service\" {\n node \"Management Service\" {\n [Utilities]\n [Web Server \\n (Apache)] as WebServer\n interface HTTPS\n WebServer -u- HTTPS\n [User] -> HTTPS\n\n [Management Daemon]\n interface \"HTTP\" as ManagementDaemonHTTP\n ManagementDaemonHTTP -- [Management Daemon]\n [Agent Daemon]\n database \"Data Catalog\" {\n [Service \\n data files] as DataFiles\n }\n }\n\n [Microservice]\n interface \"SSH\" as ServiceSSH\n [Microservice] -l- ServiceSSH\n }\n}\n\n/' External Sources '/\nStatisticsHTTP -> [Agent Daemon]\n\n/' Management Service '/\n[Agent Daemon] --> [Data Files] : Writing \\n collected \\n data\n[Management Daemon] --> [Data Files] : 1. Adding and \\n modifying users \\n 2. Saving digital \\n ballot-box\n\n[Data Files] --> [Web Server] : Reading \\n generated \\n data\n\n[Web Server] --> [Data Files] : Loading commands\n[Web Server] --> ManagementDaemonHTTP : Implementing \\n commands\n\n[Data Files] --> [Web Server] : Loading digital \\n ballot-box\n\n/' Service Servers '/\nServiceSSH --> [Management Daemon] : Loading digital \\n ballot-box \\n from storage service\n[Utilities] --> ServiceSSH : 1. Installing service \\n 2. Configuring service \\n 3. Applying list\n[Agent Daemon] --> ServiceSSH : Service monitoring\n\n@enduml\n" }, { "path": "Documentation/public/arhitektuur/model/ms-management-service-components.et.pu", "content": "@startuml\n\n!include skin.inc\n\nTitle Kogumisteenuse haldusteenuse komponendid\n\n[Kasutaja veebisirvija] as Kasutaja\n\nframe IVXV {\n [Statistikaserver]\n interface \"HTTP\" as StatistikaHTTP\n [Statistikaserver] -down- StatistikaHTTP\n\n frame Kogumisteenus {\n node \"Haldusteenus\" {\n [Utiliidid]\n [Veebiserver \\n (Apache)] as Veebiserver\n interface HTTPS\n Veebiserver -u- HTTPS\n [Kasutaja] -> HTTPS\n\n [Haldusdeemon]\n interface \"HTTP\" as HaldusdeemonHTTP\n HaldusdeemonHTTP -- [Haldusdeemon]\n [Agentdeemon]\n database \"Andmekataloog\" {\n [Haldusteenuse \\n andmefailid] as Andmefailid\n }\n }\n\n [Mikroteenus]\n interface \"SSH\" as TeenusSSH\n [Mikroteenus] -l- TeenusSSH\n }\n}\n\n/' Välised allikad '/\nStatistikaHTTP -> [Agentdeemon]\n\n/' Haldusteenus '/\n[Agentdeemon] --> [Andmefailid] : Kogutud \\n andmete \\n kirjutamine\n[Haldusdeemon] --> [Andmefailid] : 1. Kasutaja \\n lisamine ja \\n muutmine \\n 2. e-valimiskasti \\n salvestamine\n\n[Andmefailid] --> [Veebiserver] : Genereeritud \\n andmete \\n lugemine\n\n[Veebiserver] --> [Andmefailid] : Korralduste \\n laadimine\n[Veebiserver] --> HaldusdeemonHTTP : Korralduste \\n rakendamine\n\n[Andmefailid] --> [Veebiserver] : E-valimiskasti \\n laadimine\n\n/' Teenusserverid '/\nTeenusSSH --> [Haldusdeemon] : E-valimiskasti \\n laadimine \\n talletusteenusest\n[Utiliidid] --> TeenusSSH : 1. Teenuse paigaldus \\n 2. Teenuse seadistamine \\n 3. Nimekirja rakendamine\n[Agentdeemon] --> TeenusSSH : Teenuse seire\n\n@enduml\n" }, { "path": "Documentation/public/arhitektuur/model/ms-service-status-changes.en.pu", "content": "@startuml\n\nTitle Collector Service Component State Change on Management Server\n\npartition Installation {\n :NEW;\n\n while (Can the service state be queried under the service account?) is (no)\n if (Can the service package state be queried under the root account of the service machine?) then (yes)\n :Install the service package;\n :Create access to the service account;\n else (no)\n :Set new state to FAULTY;\n stop\n endif\n endwhile (yes)\n\n while (Can access be granted to the root account of the service machine?) is (yes)\n :Remove access to the root account of the service machine;\n endwhile (no)\n}\n\npartition Configuration {\n :INSTALLED;\n while (Are the latest configurations applied to the service?) is (no)\n :Load configurations into the service machine;\n :Apply configurations to the service;\n endwhile (yes)\n}\n\npartition Execution {\n :CONFIGURED;\n while (Is it possible to query the service state?) is (yes)\n :Load the latest data into the management service;\n :Wait;\n if (Is the service disabled by the administrator?) then (yes)\n :Set new state to DISABLED;\n stop\n else (no)\n endif\n endwhile (no)\n}\n\n:FAULTY;\n\n@enduml\n\n" }, { "path": "Documentation/public/arhitektuur/model/ms-service-status-changes.et.pu", "content": "@startuml\n\nTitle Koguja teenusekomponendi olekumuutus haldusserveris\n\npartition Paigaldamine {\n :UUS;\n\n while (Kas teenuse konto alt õnnestub teenuse olekut küsida?) is (ei)\n if (Kas teenusmasina juurkonto alt \\n õnnestub teenuspaki olekut küsida?) then (jah)\n :Paigalda teenuse pakk;\n :Loo ligipääs teenuse kontole;\n else (ei)\n :Määra uus olek VIGANE;\n stop\n endif\n endwhile (jah)\n\n while (Kas teenusmasina juurkontole õnnestub ligi pääseda?) is (jah)\n :eemalda ligipääs teenusmasina juurkontole;\n endwhile (ei)\n}\n\npartition Seadistamine {\n :PAIGALDATUD;\n while (Kas teenusele on rakendatud värskeimad seadistused?) is (ei)\n :Laadi seadistused teenusmasinasse;\n :Rakenda seadistused teenusele;\n endwhile (jah)\n}\n\npartition Käitamine {\n :SEADISTATUD;\n while (Kas teenuse oleku küsimine õnnestub) is (jah)\n :Laadi haldusteenusesse teenuse viimased andmed;\n :Oota;\n if (Kui haldur keelab teenuse?) then (jah)\n :Määra uus olek KEELATUD;\n stop\n else (ei)\n endif\n endwhile (ei)\n}\n\n:VIGANE;\n\n@enduml\n" }, { "path": "Documentation/public/arhitektuur/model/ms-service-status.en.pu", "content": "@startuml\n\nTitle Subservice State Diagram of the Collection Service\n\nskinparam state {\n BackgroundColor<> LightGreen\n BackgroundColor<> LightCoral\n}\n\nstate NotInstalled\nstate Installed\nstate Configured <>\nstate Error <>\nstate Removed\n\nNotInstalled: Service described in technical settings,\nNotInstalled: but the service software is not installed or\nNotInstalled: no technical settings have been applied to the service.\n\nInstalled : Service software is installed and the status of applied configurations is:\nInstalled : - root certificates are applied;\nInstalled : - technical settings are applied;\nInstalled : - election settings are not applied.\n\nConfigured : Service is operational\n\nError : Service is not operational\n\nRemoved : Service has been removed from the collection service\nRemoved : composition\n\n[*] --> NotInstalled\n\nNotInstalled --> Installed : Management service installs \\n service software and \\n applies root and \\n technical settings\n\nInstalled --> Configured : Management service applies \\n election settings to the service\nInstalled --> Removed : Service is removed \\n from the collection service\n\nConfigured --> Error : Management service \\n loses connection \\n to the service\nConfigured --> Removed : Service is removed \\n from the collection service\n\nError --> Configured : Error in the \\n configured service \\n is resolved\nError --> Removed : Service is removed \\n from the collection service\nError --> [*] : Voting period \\n ends\n\nConfigured --> [*] : Voting period \\n ends\n\nRemoved --> [*]\n\n@enduml\n\n" }, { "path": "Documentation/public/arhitektuur/model/ms-service-status.et.pu", "content": "@startuml\n\nTitle Kogumisteenuse alamteenuse olekudiagramm\n\nskinparam state {\n BackgroundColor<> LightGreen\n BackgroundColor<> LightCoral\n}\n\nstate Paigaldamata\nstate Paigaldatud\nstate Seadistatud <>\nstate Tõrge <>\nstate Eemaldatud\n\nPaigaldamata: Teenus kirjeldatud tehnilistes seadistustes,\nPaigaldamata: kuid teenuse tarkvara on paigaldamata või\nPaigaldamata: pole teenusele tehnilisi seadistusi rakendatud.\n\nPaigaldatud : Teenuse tarkvara on paigaldatud ja teenusele\nPaigaldatud : rakendatud seadistuste seisund on:\nPaigaldatud : - usaldusjuure seadistused on rakendatud;\nPaigaldatud : - tehnilised seadistused on rakendatud;\nPaigaldatud : - valimiste seadistused on rakendamata.\n\nSeadistatud : Teenus on töökorras\n\nTõrge : Teenus pole töökorras\n\nEemaldatud : Teenus on kogumisteenuse\nEemaldatud : koosseisust eemaldatud\n\n[*] --> Paigaldamata\n\nPaigaldamata --> Paigaldatud : Haldusteenus paigaldab \\n teenuse tarkvara ning \\n rakendab usaldusjuure ja \\n tehnilised seadistused\n\nPaigaldatud --> Seadistatud : Haldusteenus rakendab \\n teenusele \\n valimiste seadistused\nPaigaldatud --> Eemaldatud : Teenus eemaldatakse \\n kogumisteenusest\n\nSeadistatud --> Tõrge : Haldusteenusel \\n kaob ühendus \\n teenusega\nSeadistatud --> Eemaldatud : Teenus eemaldatakse \\n kogumisteenusest\n\nTõrge --> Seadistatud : Seadistatud \\n teenuse \\n tõrge \\n kõrvaldatakse\nTõrge --> Eemaldatud : Teenus eemaldatakse \\n kogumisteenusest\nTõrge --> [*] : Hääletusperiood \\n lõppeb\n\nSeadistatud --> [*] : Hääletusperiood \\n lõppeb\n\nEemaldatud --> [*]\n\n@enduml\n" }, { "path": "Documentation/public/arhitektuur/model/ms-upload-command.en.pu", "content": "@startuml\n\nTitle Execution of Commands in the Management Service\n\nActor \"User (Browser)\" as Browser\nparticipant \"Web Server \\n (Apache)\" as WSGI\nparticipant \"Daemon \\n (HTTP)\" as Daemon_HTTP\nparticipant \"Management \\n Library\" as Util\nDatabase \"File System\" as FS\nparticipant Service\n\nBrowser -> WSGI : Uploading \\n command\nActivate Browser\nActivate WSGI\n\nWSGI -> FS : Saving command\n\nalt Command is valid\n\n WSGI -> Daemon_HTTP : Request to \\n apply command\n Activate Daemon_HTTP\n Daemon_HTTP -> Util : Request to apply \\n command\n\n Activate Util\n Util <- FS : Reading command\n Util -> Util : Validating command\n alt Immediate application\n Util -> Service : Applying command\n else Issuing digital ballot-box\n Service -> Util : Loading digital ballot-box\n end\n Util -> Daemon_HTTP : Response to apply \\n command\n Deactivate Util\n\n Daemon_HTTP -> WSGI : Sending response\n Deactivate Daemon_HTTP\nend\n\nWSGI -> Browser : Sending response\n\nDeactivate WSGI\nDeactivate Browser\n\n@enduml\n" }, { "path": "Documentation/public/arhitektuur/model/ms-upload-command.et.pu", "content": "@startuml\n\nTitle Korralduste täitmine haldusteenuses\n\nActor \"Kasutaja (Brauser)\" as Brauser\nparticipant \"Veebiserver \\n (Apache)\" as WSGI\nparticipant \"Deemon \\n (HTTP)\" as Deemon_HTTP\nparticipant \"Halduse \\n teek\" as Util\nDatabase \"Failisüsteem\" as FS\nparticipant Teenus\n\nBrauser -> WSGI : Korralduse \\n üleslaadimine\nActivate Brauser\nActivate WSGI\n\nWSGI -> FS : Korralduse salvestamine\n\nalt Korraldus on valiidne\n\n WSGI -> Deemon_HTTP : Korralduse \\n rakendamise \\n päring\n\n Activate Deemon_HTTP\n Deemon_HTTP -> Util : Korralduse \\n rakendamise päring\n\n Activate Util\n Util <- FS : Korralduse lugemine\n Util -> Util : Korralduse valideerimine\n alt Vahetu rakendamine\n Util -> Teenus : Korralduse rakendamine\n else E-valimiskasti väljastamine\n Teenus -> Util : E-valimiskasti laadimine\n end\n Util -> Deemon_HTTP : Korralduse \\n rakendamise vastus\n Deactivate Util\n\n Deemon_HTTP -> WSGI : Vastuse \\n edastamine\n Deactivate Deemon_HTTP\nend\n\nWSGI -> Brauser : Vastuse \\n edastamine\n\nDeactivate WSGI\nDeactivate Brauser\n\n@enduml\n" }, { "path": "Documentation/public/arhitektuur/model/ms-voter-list-status.en.pu", "content": "@startuml\ntitle Voter List State Diagram\n\nskinparam state {\n BackgroundColor<> LightGray\n BackgroundColor<> LightGreen\n BackgroundColor<> LightCoral\n}\n\nstate \"Available\" as AVAILABLE <>\nstate \"Pending Application\" as PENDING\nstate \"Applied\" as APPLIED <>\nstate \"Invalid\" as INVALID <>\nstate \"Skipped\" as SKIPPED <>\n\nnote right of AVAILABLE\n External system state not\n registered in the management\n service database\nend note\n\n[*] --> AVAILABLE : Detection of list availability\nAVAILABLE : List is available in the Voting Information System\n\nAVAILABLE --> PENDING : Loading of correct list \\n into the management service\nPENDING : List is Loaded into the management service\n\nAVAILABLE --> INVALID : Loading of \\n invalid list \\n into the management service\nPENDING --> INVALID : Failed application of \\n the change list \\n to the list service\nINVALID : List is marked as invalid\n\nPENDING --> APPLIED : Application of the list \\n to the list service\nAPPLIED : List is applied to the collection service\n\nINVALID --> SKIPPED : Marking the list as skipped\nSKIPPED : List is marked as skipped\n\nSKIPPED --> [*]\nAPPLIED --> [*]\n\n@enduml\n\n" }, { "path": "Documentation/public/arhitektuur/model/ms-voter-list-status.et.pu", "content": "@startuml\ntitle Valijate nimekirja olekudiagramm\n\nskinparam state {\n BackgroundColor<> LightGray\n BackgroundColor<> LightGreen\n BackgroundColor<> LightCoral\n}\n\nstate \"Saadaval\" as AVAILABLE <>\nstate \"Rakendamise ootel\" as PENDING\nstate \"Rakendatud\" as APPLIED <>\nstate \"Vigane\" as INVALID <>\nstate \"Vahele jäetud\" as SKIPPED <>\n\nnote right of AVAILABLE\n Süsteemiväline seisund, mida\n haldusteenuse andmebaasis\n ei registreerita\nend note\n\n[*] --> AVAILABLE : Nimekirja saadavaloleku tuvastamine\nAVAILABLE : Nimekiri on saadaval Valimiste Infosüsteemis\n\nAVAILABLE --> PENDING : Korrektse nimekirja \\n laadimine \\n haldusteenusesse\nPENDING : Nimekiri on Laaditud haldusteenusesse\n\nAVAILABLE --> INVALID : Vigase \\n muudatusnimekirja \\n laadimine \\n haldusteenusesse\nPENDING --> INVALID : Muudatusnimekirja \\n nurjunud rakendamine \\n nimekirjateenusele\nINVALID : Nimekiri on märgitud vigaseks\n\nPENDING --> APPLIED : Nimekirja \\n rakendamine \\n nimekirjateenusele\nAPPLIED : Nimekiri on rakendatud kogumisteenusele\n\nINVALID --> SKIPPED : Nimekirja \\n märkimine \\n vahelejätmiseks\nSKIPPED : Nimekirja on märgitud vahelejätmiseks\n\nSKIPPED --> [*]\nAPPLIED --> [*]\n\n@enduml\n" }, { "path": "Documentation/public/arhitektuur/model/skin.inc", "content": "skinparam interface {\n backgroundColor<> Gold\n backgroundColor<> LightSalmon\n backgroundColor<> DarkGoldenRod\n backgroundColor<> Black\n}\n\nskinparam actor {\n backgroundColor<> Gold\n backgroundColor<> LightSalmon\n backgroundColor<> DarkGoldenRod\n backgroundColor<> Black\n}\n\nskinparam component {\n backgroundColor<> Gold\n backgroundColor<> DarkGoldenRod\n backgroundColor<> LightSalmon\n backgroundColor<> Black\n}\n" }, { "path": "Documentation/public/arhitektuur/model/uc-audit.pu", "content": "\n@startuml\n\ntitle \"Auditirakendus - offline\"\n\nusecase (Kogumisteenuse auditimaterjali import)\nusecase (Lugemisteenuse auditimaterjali import)\nusecase (Miksimisteenuse auditimaterjali import)\nusecase (Ajatembeldusteenuse auditimaterjali import)\nusecase (Auditi läbiviimine)\n\n@enduml\n" }, { "path": "Documentation/public/arhitektuur/model/uc-offline.pu", "content": "\n@startuml\n\ntitle \"Lugemisfaas - offline\"\n\npackage \"Töötleja\" {\n usecase (Allkirjastatud häälte import)\n usecase (Ajamärgendite import)\n usecase (Kontrollimine - ver, ATO)\n usecase (Korduvate häälte tühistamine)\n usecase (E-hääletanute nimekiri jaoskondade kaupa)\n\n usecase (Tühistusavalduste import)\n usecase (Tühistamise ennistusavalduste import)\n usecase (Anonümiseerimine)\n usecase (Anonüümsete häälte eksport)\n usecase (Lugemisele läinud E-hääletanute nimekiri jaoskondade kaupa)\n}\n\npackage \"Miksimine\" {\n usecase (Auditeeritud random)\n usecase (Anonüümsete häälte import)\n usecase (Häälte miksimine)\n usecase (Miksitud häälte eksport)\n usecase (Miksimistõestuse eksport)\n}\n\npackage \"Lugemine\" {\n usecase (Krüpteeritud häälte import)\n usecase (E-häälte kokkulugemine)\n usecase (E-hääletamise tulemuste eksport)\n usecase (Dekrüptimistõestuse eksport)\n}\n\npackage \"Võtmehaldus\" {\n usecase (Privaatvõtme aktiveerimine)\n}\n\npackage \"Audit\" {\n usecase (Kogumisteenuse auditimaterjali import)\n usecase (Lugemisteenuse auditimaterjali import)\n usecase (Ajatembeldusteenuse auditimaterjali import)\n usecase (Auditi läbiviimine)\n}\n\npackage \"Valimise lõpetamine\" {\n usecase (Arhiveerimine)\n usecase (Privaatvõtme ja koopiate hävitamine)\n}\n\n@enduml\n" }, { "path": "Documentation/public/arhitektuur/model/uc-online.pu", "content": "\n@startuml\n\ntitle \"Hääletamisfaas hostingus\"\n\nusecase (*) as UC0\n\nnote left of UC0\n* Ainult talletamiskomponent ja ajatembeldus säilitavad olekut\n* Muud komponendid on stateless - loadbalancing on võimalik\n* Talletamiskomponendi veakindlus - HadoopFSi või byzantine?\n* On-line komponentide väliste liideste definitsioon ja valideerimine\n* Nõue TLSi kasutamiseks ja 443 pordiga piirdumiskes\n* HTTP ei ole hädavajalik kuid võib aidata\nendnote\n\npackage \"Support\" {\n usecase (Varundamine hääletamisperioodi peatamata)\n usecase (Taastamine puhtale süsteemile)\n usecase (Logimine monitooringusüsteemi)\n usecase (Süsteemi seisundi kaugvaatlus)\n usecase (Süsteemi seisundi vaatlus käsurealt) as UC1.5\n note left of UC1.5\n * pseudograafika asemel git laadne käsustik\n * võimalusel süsteemsete lahenduste kasutamine iseleiutamise asemel\n endnote\n}\n\npackage \"Hääletamisperioodi eelne\" {\n usecase (Proovihääletamine ühenduste testimiseks)\n usecase (Hääletamisperioodi kaugkäivitamine)\n}\n\npackage \"Hääletamisperiood\" {\n usecase (Valijate nimekirja perioodiline uuendamine)\n usecase (Häälte talletamine) as UC2.2\n usecase (Kontrollpäringutele vastamine)\n usecase (Vaheaudit)\n usecase (Serverite ühtsuse kontroll)\n usecase (Hääletamisperioodi järkjärguline kaugpeatamine)\n\n note left of UC2.2\n * isikute autentimine\n * valimisõigus(t)e tuvastamine\n * valikute väljastamine\n * häälte vastu võtmine ja talletamine\n * kontrollidentifikaatorite väljastamine\n endnote\n\n}\n\n' osa vähemalt häältest eesti pinnal vähemalt 1 kord päevas, võib ka logiandmed\n' eesti pinnal olev backup peab olema loetav\n\npackage \"Hääletamisperioodi järgne\" {\n usecase (E-hääletanute nimekirja koostamine valimisjaoskondade kaupa)\n usecase (Häälte eksport kogumisteenusest)\n usecase (Auditimaterjali eksport kogumisteenusest)\n' usecase (Auditimaterjali eksport ajatempliteenusest)\n usecase (Logi eksport kogumisteenusest)\n}\n\n\npackage \"Valija tegevused\" {\n usecase (Valijarakenduse paigaldamine autentsest allikast)\n usecase (Kontrollrakenduse paigaldamine autentsest allikast)\n usecase (E-hääletamine)\n usecase (E-hääle kontrollimine)\n}\n\n@enduml\n" }, { "path": "Documentation/public/arhitektuur/model/uc-prep.pu", "content": "@startuml\n\ntitle \"Ettevalmistusfaas kontoris\"\n\nusecase (*) as UC0\n\nnote left of UC0\nMujal menetlemata nüansid\n* Võimekus mitme samaaegse eritüübilise valimise korraldamiseks\n* Võimekus null-autentimismeetodite ja nimekirjade kasutamiseks\n* Andmevormingute spetsifikatsioon\n* Väliste liideste ja sõltuvuste spetsifikatsioon\nend note\n\nactor Omanik\nactor Hääletaja\nactor Koguja\nactor Töötleja\nactor Audiitor\nactor IDP\nactor ATO\nactor STO\nactor Klienditugi\n\n\n\n\npackage \"Konfiguratsiooni haldamine\" {\n usecase (Tekstide haldus) as UC1.5\n usecase (Valimisinfo laadimine) as UC1.1\n usecase (Tehniliste parameetrite haldus) as UC1.4\n usecase (Autentimisteenuse seadistamine) as UC1.6\n usecase (Kehtivuskinnitusteenuse seadistamine) as UC1.7\n usecase (Ajatempliteenuse seadistamine) as UC1.8\n usecase (Konfiguratsiooni valideerimine) as UC1.9\n usecase (Konfiguratsiooni allkirjastamine) as UC1.10\n usecase (Konfiguratsiooni eksport) as UC1.11\n\n usecase (Allkirja moodustamine, ajatempli saamine, kehtivuses veendumine meetodite määramine)\n\n usecase (Algoritmi ja votme määramine)\n\nnote bottom of UC1.11\nKomponentide põhiste allkirjastatud konfipakkide loomine\nendnote\n\nnote bottom of UC1.1\n* Valimine\n* Reeglid\n* Valijad\n* Valikud\n* Jaoskonnad\nendnote\n\n}\n\nOmanik -> UC1.10\nKoguja -> UC1.5\n\nnote left of UC1.9\n* Olemasolu kontroll\n* Vormingu kontroll\n* Kooskõlalisuse kontroll\nendnote\n\nnote top of UC1.5\n* Kontrollrakendus\n* Valijarakendus\nendnote\n\n\npackage \"Võtmehaldus\" {\n usecase (Võtmepaari ja PIN-ide genereerimine) as UC2.1\n usecase (Võtmepaari varukoopia loomine) as UC2.2\n usecase (Avaliku komponendi transport valijarakendusele) as UC2.3\n usecase (Valijarakenduse ettevalmistamine) as UC2.4\n\n ' osad pinniga osad mitte\n\n note left of UC2.1\n * MofN\n * kiipkaart vs. HSM\n endnote\n\n}\n\npackage \"Keskkonna ettevalmistamine\" {\n usecase (Paigalduspakkide haldamine) as UC3.1\n usecase (Süsteemi paigaldamine) as UC3.2\n usecase (Usaldusnimekiri) as UC3.3\n usecase (Volitatud isikute sertifikaatide haldus)\n usecase (Konfiguratsiooni laadmine) as UC3.4\n}\n\npackage \"Laua peal testimine\" {\n usecase (Võtmepaari kontroll, testhääletamine) as UC4.1\n}\n\n@enduml\n" }, { "path": "Documentation/public/arhitektuur/model/uc-tootleja.pu", "content": "\n@startuml\n\ntitle \"Töötleja\"\n\nusecase (Töötleja usaldusjuurte laadimine)\nusecase (Töötleja seadistuse import)\nusecase (Allkirjastatud häälte import)\nusecase (Ajamärgendite import)\nusecase (Kontrollimine - ver, ATO)\nusecase (Korduvate häälte tühistamine)\nusecase (E-hääletanute nimekiri jaoskondade kaupa)\nusecase (Tühistusavalduste import)\nusecase (Tühistamise ennistusavalduste import)\nusecase (Anonümiseerimine)\nusecase (Anonüümsete häälte eksport)\nusecase (Lugemisele läinud E-hääletanute nimekiri jaoskondade kaupa)\nusecase (Tegevuslogi)\nusecase (Tulemuslogi)\nusecase (Hääle olekulogi)\n\nusecase (Korrektse korduvhääle tühistamise tõestamine)\nusecase (Korrektse hääle tühistamise tõestamine p-hääle tõttu)\nusecase (Miksimissisendi autentsuse tõestamine)\n\n@enduml\n" }, { "path": "Documentation/public/arhitektuur/model/uc-votmerakendus.pu", "content": "\n@startuml\n\ntitle \"Võtmerakendus\"\n\n usecase (Verifitseerimiskonfiguratsiooni import)\n usecase (Kandidaatide ja ringkondade nimekirja import)\n usecase (Krüpteeritud häälte import)\n usecase (E-häälte dekrüpteerimine)\n usecase (E-häälte kokkulugemine)\n usecase (Sisendinfo verifitseerimine)\n usecase (Väljundinfo signeerimine)\n usecase (E-hääletamise tulemuste eksport)\n usecase (Kehtetute sedelite loendi eksport)\n usecase (Dekrüptimistõestuse eksport)\n usecase (Tegevuslogi eksport)\n usecase (Hääle olekulogi)\n\n usecase (Võtmepaari genereerimine)\n usecase (Juhuslikkuse lisamine)\n usecase (Juhuslikkuse mõõtmine)\n usecase (Sertifikaadi allkirjastamine)\n usecase (Privaatvõtme aktiveerimine)\n usecase (Privaatvõtme ja koopiate hävitamine)\n\n@enduml\n\n\n' Rakenduse konfigureerimine\n' Võtme genereerimine\n' Sertifikaadi väljastamine\n' Hääletamistulemuse väljastamine\n" }, { "path": "Documentation/public/arhitektuur/spelling_wordlist.txt", "content": "\nAdvances\nAnnual\nCryptosystems\nImproving\nOctober\npp\nth\nThreshold\n\n\nPDF'ide\n\nBouncy\nCastle\n\nIP\nXML'il\nTLS'i\nSSH\nSNI\nTCP\n\napache\nBDoc\nclause\ncrontab\ndeb\ndebian\ndigidoc\ndocker'i\netcd\ngo\njammy\njellyfish\njinja\nlibdigidocpp\nlogback\npython\nrsyslog\nubuntu\nurlencode\n\nGuardtime\n\nGradle\nJackson\n\nadmincode\ncc\nchoices\ncount\ncounties\ndistrict\ndistricts\nid\nEHAK\nNimeste\nocsp\nprevious\nseq\nstats\ntime\ntspreg\ntype\nversion\nvote\nvoted\nvoter\nvotername\nvoters\nvotes\n\n\nSven\nHeiberg\nTarvi\nMartens\nPriit\nVinkel\nJan\nWillemson\n\nOliver\nSpycher\nVanessa\nTeague\nGregor\nWenda\n\nMelanie\nVolkamer\nJordi\nBarrat\nJosh\nBenaloh\nNicole\nGoodman\nPeter\nRyan\n\nInternational\nConference\nElectronic\nVoting\n\nCryptology\nSanta\nBarbara\nCalifornia\nUSA\n\nDesmedt\nFrankel\nBrassard\n\ned\neds\nthe\nof\nin\nor\npdf\n\nverifiability\nEstonian\nInternet\nVoting\nscheme\n\nRobert\nKrimmer\n\n\nAustria\n\nBregenz\n\nLochau\n\nProceedings\n\nSpringer\n\nSchnorri\nShamir\nShamiri\n\nassert\ncollections\ncommons\ndateutil\nglassfish\nhamcrest\nJUnit\nlater\nmockimise\nMockito\npyopenssl\npythoni\npythonile\nrequests\ntools\nx\n\nparametriseerimise\nhaldusutiliitide\nvallasrežiimis\n" }, { "path": "Documentation/public/arhitektuur/tehnoloogiad.rst", "content": ".. IVXV arhitektuur\n\n.. _tehnoloogiad:\n\nKasutatavad tehnoloogiad\n========================\n\nKogumisteenuse programmeerimiskeel\n----------------------------------\n\nKogumisteenuse tuumikfunktsionaalsus on programmeeritud keeles Go, mis vastab\njärgmistele hanke nõuetele:\n\n* Staatiline tüüpimine;\n\n* Automaatne mäluhaldus;\n\n* Kompilaator avatud lähtekoodiga;\n\n* Ribastamine (rööprapse).\n\nKogumisteenuse haldusteenus on programmeeritud keeles Python.\n\n\nRakenduste programmeerimiskeel\n------------------------------\n\nRakendused on programmeeritud keeles Java, mis vastab hanke nõuetele keele laia\nleviku ja jätkusuutlikkuse kohta.\n\n\nProjekti sõltuvused\n-------------------\n\nProjektis kasutatavad kolmandate osapoolte komponendid koos nende motiveeritud\nkasutamisvajadusega on üles loetletud järgnevates tabelites. Eraldi tabelid on\nraamistiku pakendamiseks ja töötamiseks ning raamistiku arenduseks ja\ntestimiseks.\n\nKõik IVXV projektis kasutatavad välised teegid asuvad ``ivxv-external.git``\nhoidlas või on saadaval platvormil, kus rakendus tööle hakkab.\n\nKõik kogumisteenuses kasutatavad komponendid on avatud lähtekoodiga.\n\n.. tabularcolumns:: |p{0.2\\linewidth}|p{0.1\\linewidth}|p{0.15\\linewidth}|p{0.55\\linewidth}|\n.. list-table::\n IVXV raamistiku tööks kasutatavad kolmandate osapoolte komponendid\n :header-rows: 1\n\n * - Nimi\n - Versioon\n - Litsents (SPDX)\n - Kasutusvajadus\n\n * - `Bootstrap `_\n - 3.4.1, JavaScript\n - MIT\n - Kogumisteenuse haldusteenuse kasutajaliidese kujundus\n\n * - Bouncy Castle\n - 1.78.1, Java\n - MIT\n - ASN1 käsitlemine, andmetüübi BigInteger abifunktsioonid\n\n * - `Bottle `_\n - 0.13.2, Python\n - MIT\n - Raamistik kogumisteenuse haldusteenuse veebiliidese teostamiseks\n\n * - CAL10N\n - 0.8.1, Java\n - MIT\n - Mitmekeelsuse tugi, tõlkefailide valideerimine\n\n * - Digidoc 4j\n - 5.3.1, Java\n - LGPL-2.1-only\n - BDoc konteinerite käsitlemine\n\n * - Apache Commons (collections4 4.4)\n - Java\n - Apache-2.0\n - Digidoc 4j ja PDFBox sõltuvused\n\n * - `Docopt `_\n - 0.6.2, Python\n - MIT\n - Kogumisteenuse haldusutiliitide käsurealiidese teostus\n\n * - `Fasteners `_\n - 0.19, Python\n - Apache-2.0\n - Kogumisteenuse haldusteenuse protsesside lukustus\n\n * - `gin-gonic `_\n - 1.9.1, Go\n - MIT\n - Veebiraamistik x-tee liidese jaoks\n\n * - `etcd `_\n - 3.5.9, Go\n - Apache-2.0\n - Talletusteenusena kasutatav hajus võti-väärtus andmebaas\n\n * - Glassfish JAXB\n - 4.0.5, Java\n - BSD-3-Clause\n - Java XML teek\n\n * - Gradle\n - 8.11, Java\n - Apache-2.0\n - Java rakenduste ehitamise raamistik\n\n * - `HAProxy `_\n - 2.4.24\n - GPL-2.0-or-later\n - Vahendusteenusena kasutatav TCP-proksi\n\n * - Jackson\n - 2.18.1, Java\n - Apache-2.0\n - JSON vormingus failide lugemine ja kirjutamine\n\n * - Jinja2\n - 3.1.4, Python\n - BSD\n - Jinja mallide kasutamine haldusteenuses\n\n * - `jQuery `_\n - 3.7.1, JavaScript\n - MIT\n - Kogumisteenuse haldusteenuse kasutajaliides\n\n * - jsonschema\n - 4.23.0, Python\n - MIT\n - JSON valideerimine haldusteenuses\n\n * - Logback\n - 1.5.12, Java\n - EPL-1.0 or LGPL-v2.1-only\n - Logimise API teostus\n\n * - Logback JSON\n - 0.1.5, Java\n - EPL-1.0 or LGPL-v2.1-only\n - Logback logija laiendus JSON vormingus logikirjete koostamiseks\n Jackson teegi abil\n\n * - `Logrus `_\n - 1.9.3, Go\n - MIT\n - Logimisraamistik x-tee liidese jaoks\n\n * - `metisMenu `_\n - 1.1.3, JavaScript\n - MIT\n - Kogumisteenuse haldusteenuse kasutajaliides\n\n * - `FontAwesome `_\n - 6.7.2, JavaScript\n - MIT\n - Kogumisteenuse haldusteenuse kasutajaliides\n\n * - `DataTables `_\n - 2.3.2, JavaScript\n - MIT\n - Kogumisteenuse haldusteenuse kasutajaliides\n\n * - PDFBox\n - 3.0.3, Java\n - Apache-2.0\n - PDF vormingus raportite genereerimise tugi Java rakendustele\n\n * - `PyYAML `_\n - 6.0.2, Python\n - MIT\n - Kogumisteenuse seadistusfailide töötlemise tugi haldusteenusele\n\n * - python-crontab\n - 3.3.0, Python\n - LGPLv3\n - Crontab haldusteenuses\n\n * - python-dateutil\n - 2.9.0, Python\n - BSD\n - Kuupäevad ja kellaajad haldusteenuses\n\n * - python-debian\n - 0.1.49, Python\n - GPLv2\n - Debian pakkide lugemine haldusteenuses\n\n * - pyopenssl\n - 24.2.1, Python\n - Apache\n - OpenSSL kasutus haldusteenuses\n\n * - `Schematics `_\n - 2.1.1, Python\n - BSD-3-Clause\n - Kogumisteenuse seadistusfailide valideerimise tugi haldusteenusele\n\n * - SnakeYAML\n - 2.3, Java\n - Apache-2.0\n - YAML vormingus andmete lugemine\n\n * - `SB Admin 2 `_\n - 3.3.7+1, JavaScript\n - MIT\n - Kogumisteenuse haldusteenuse kasutajaliidese kujundus\n\n.. tabularcolumns:: |p{0.2\\linewidth}|p{0.1\\linewidth}|p{0.15\\linewidth}|p{0.55\\linewidth}|\n.. list-table::\n IVXV raamistiku testide\n kasutatavad kolmandate osapoolte komponendid\n :header-rows: 1\n\n * - Nimi\n - Versioon\n - Litsents (SPDX)\n - Kasutusvajadus\n\n * - Hamcrest\n - 3.0, Java\n - BSD-3-Clause\n - Loetavam assert-meetodite kasutamine Java üksuste testides\n\n * - JUnit\n - 5.10.0, Java\n - EPL-1.0\n - Java testimisraamistik\n\n * - JUnitParams\n - 1.1.1, Java\n - Apache-2.0\n - Testide parametriseerimise tugi\n\n * - Mockito\n - 5.14.2, Java\n - MIT\n - Testitava koodi sõltuvuste mockimise tugi\n\n * - libdigidocpp-tools\n - 3.14.5 .1404\n - LGPL-2.1-or-later\n - Testandmete genereerimine\n\n * - PyTest\n - 7.4.2, Python\n - MIT\n - Üksuste testimise tugi Pythonile\n\n * - Requests\n - 2.32.3, Python\n - Apache 2.0\n - HTTP päringute moodul Pythoni testidele\n\n.. tabularcolumns:: |p{0.2\\linewidth}|p{0.1\\linewidth}|p{0.15\\linewidth}|p{0.55\\linewidth}|\n.. list-table::\n IVXV raamistiku arendamiseks ja/või testimiseks\n kasutatavad kolmandate osapoolte tööriistad\n :header-rows: 1\n\n * - Nimi\n - Versioon\n - Litsents (SPDX)\n - Kasutusvajadus\n\n * - `Behave `_\n - 1.2.6, Python\n - BSD-2-Clause\n - Regressioonitestide käivitaja (*Behavior-driven development*)\n\n * - `Docker `_\n - 18.06 (või uuem)\n - Apache-2.0\n - Regressioonitestide läbiviimise keskkond - tarkvarakonteinerid\n\n * - `Sphinx `_\n - 7.2.5, Python\n - BSD\n - Dokumentatsiooni genereerimine\n" }, { "path": "Documentation/public/arhitektuur/vallasrezhiim.rst", "content": ".. IVXV arhitektuur\n\nRakendused\n==========\n\n\nÜldpõhimõtted\n-------------\n\nKõik rakendused on käsurealiidesega rakendused, mis on pakendatud töötama\noperatsioonisüsteemi Windows 10 (või uuem) keskkonnas. Komponentide\nkasutajaliidesed on ühekeelsed. Komponendid tarnitakse eestikeelsetena, nende\ntõlkimine on võimalik tõlkefaili abil.\n\nRakendused on programmeeritud Java keeles.\n\nVäliste infosüsteemidega suhtlevad rakendused kasutavad maksimaalselt\nolemasolevaid liideseid/andmestruktuure.\n\nRakendused saavad oma sisendi rakenduste seadistustest ja seadistustes näidatud\nfailidest failisüsteemis ning salvestavad oma väljundi kasutaja näidatud kausta\nfailisüsteemis. Failid võivad paikneda ka operatiiv-mälukettal.\n\nRelevantsed rakendused toetavad ElGamal krüptosüsteemi täisarvujäägikorpustel\nning P-384 elliptkõveral. Lugemistõend on realiseeritud Schnorri\nnullteadmustõestusel põhineval protokollil.\n\n.. figure:: model/img/app_modules.png\n\n Rakenduste abimoodulid\n\nValimise liides on rakenduste jaoks unifitseeritud, see võimaldab erinevate\nvalimistüüpide realiseerimist moodulitena. Digiallkirja verifitseerimise\nfunktsionaalsus on loodud `digidoc4j `_\nteegi abil. Abimoodulite kasutamist alljärgnevatel skeemidel eraldi välja ei\ntooda.\n\nRakenduste seadistamine\n```````````````````````\n\nRakendused seadistatakse kas digitaalallkirjastatud konfiguratsioonipakiga või\nkäsureavõtmetega. Käsureavõtmed ei toeta hierarhilise struktuuriga seadistuste\nsisestamist. Seadistused konfiguratsioonipakis kirjeldatakse YAML-keeles:\n\n.. code-block:: yaml\n\n check:\n ballotbox: votes.zip\n ballotbox_checksum: votes.zip.sha256sum.bdoc\n districts: TESTKOV2017.districts.json\n registrationlist: register.zip\n registrationlist_checksum: register.zip.sha256sum.bdoc\n tskey: ts.pub.key\n vlkey: test.gen.pub.key\n voterlists:\n -\n path: 00.TESTKOV2017.gen.voters\n signature: 00.TESTKOV2017.gen.voters.signature\n -\n path: 03.TESTKOV2017.gen.voters\n signature: 03.TESTKOV2017.gen.voters.signature\n -\n path: 06.TESTKOV2017.gen.voters\n signature: 06.TESTKOV2017.gen.voters.signature\n -\n path: 09.TESTKOV2017.gen.voters\n signature: 09.TESTKOV2017.gen.voters.signature\n election_start: 2017-05-01T12:00:00+03:00\n out: out-1\n squash:\n ballotbox: out-1/bb-1.json\n ballotbox_checksum: out-1/bb-1.json.sha256sum.bdoc\n districts: TESTKOV2017.districts.json\n out: out-2\n revoke:\n ballotbox: out-2/bb-2.json\n ballotbox_checksum: out-2/bb-2.json.sha256sum.bdoc\n districts: TESTKOV2017.districts.json\n revocationlists:\n - 12.TESTKOV2017.gen.revoke.json\n - 13.TESTKOV2017.gen.revoke.json\n - 14.TESTKOV2017.gen.revoke.json\n - 15.TESTKOV2017.gen.revoke.json\n out: out-3\n\n\nSisendite kooskõlalisuse kontroll\n`````````````````````````````````\n\nKõik rakendused teostavad konfiguratsioonile sisendite kooskõlalisuse kontrolli\nvastavalt nende poolt kasutatavale konfiguratsioonile:\n\n#. sertifikaatide konfiguratsiooni laadimine;\n\n#. konfiguratsiooni digiallkirja verifitseerimine;\n\n#. ringkondade nimekirja verifitseerimine;\n\n#. ringkondade nimekirja kooskõlalisuse kontroll;\n\n#. ringkondade nimekirja laadimine;\n\n#. valikute nimekirja verifitseerimine;\n\n#. valikute nimekirja kooskõlalisuse kontroll;\n\n#. valikute nimekirja laadimine;\n\n#. valijate nimekirjade verifitseerimine;\n\n#. valijate nimekirjade kooskõlalisus kontroll;\n\n#. valijate nimekirjade laadimine.\n\n\nVõtmerakendus\n-------------\n\n.. figure:: model/img/key.png\n\n Võtmerakenduse liidesed\n\nVõtmerakendusega genereeritakse iga hääletamise jaoks häälte salastamise ja\nhäälte avamise võti, samuti toimub selle abil häälte lugemine ja tulemuse\nväljastamine.\n\nVõtmerakendus kasutab [DesmedtF89]_ läviskeemi, mis põhineb usaldataval\nosakujagajal ning rakendab Shamiri osakujagamist, mis on\ninformatsiooniteoreetiliselt turvaline :math:`t < M` osapoole korral, kus M on\nlävipiir.\n\nVõtmeosakud genereeritakse operatiivmälus ning talletatakse PKCS15-liidese\nvahendusel kiipkaardile.\n\nVõtmerakenduse sisend võtme genereerimisel on:\n\n- Võtmepaari identifikaator;\n\n- Krüptosüsteemi ElGamal spetsifikatsioon – täisarvujäägikorpus või P-384\n elliptkõver ning võtmepikkus;\n\n- M-N läviskeemi spetsifikatsioon, mis peab vastama reeglile\n :math:`N >= 2 * M - 1`;\n\n- N PKCS15-ühilduvat kiipkaarti;\n\nVõtmerakenduse väljund võtme genereerimisel on:\n\n- Isesigneeritud sertifikaat;\n\n- N võtmeosakut talletatuna kiipkaartidel;\n\n- Rakenduse detailne tegevuslogi;\n\n- Rakenduse detailne vealogi.\n\nVõtmerakenduse sisend häälte lugemisel on:\n\n- Miksitud hääled;\n\n- Võtmepaari identifikaator;\n\n- M võtmeosakut vastavalt läviskeemi spetsifikatsioonile.\n\nVõtmerakenduse väljund häälte lugemisel on:\n\n- Signeeritud hääletamistulemus;\n\n- Kehtetute häälte loend;\n\n- Lugemistõend (Schnorri nullteadmustõestusel põhinev protokoll vastavalt\n hankedokumentides viidatule);\n\n- Rakenduse detailne tegevuslogi;\n\n- Rakenduse detailne vealogi.\n\nTöötlemisrakendus\n-----------------\n\nTöötlemisrakendusega verifitseeritakse, tühistatakse ning anonüümitakse\nhääletamisperioodil kogutud hääli vastavalt Üldkirjelduse jaotisele 7.6.\n\nTöötlemisrakenduse sisendid on:\n\n- kogumisteenuse poolt talletatud elektroonilised hääled;\n\n- registreerimisteenuse poolt väljastatud ajamärgendid;\n\n- valijate nimekirjad;\n\n- ringkondade nimekiri;\n\n- tühistusnimekirjad;\n\n- ennistusnimekirjad.\n\nTöötlemisrakenduse väljundid on:\n\n- rakenduse detailne tegevuslogi;\n\n- rakenduse detailne vealogi;\n\n- e-hääletanute nimekiri PDF-vormingus, vastavalt töötlemise etapile;\n\n- e-hääletanute nimekiri masintöödeldaval kujul, vastavalt töötlemise etapile;\n\n- anonüümitud hääled.\n\nLisaks varem defineeritud liidestele ja sõltuvustele kasutab töötlemisrakendus\nkolmanda osapoole teeki PDF'ide väljastamise funktsionaalsuse teostamiseks.\n\n.. figure:: model/img/processing.png\n\n Töötlemisrakenduse liidesed\n\nElektrooniliste häälte täielik töötlemine\n`````````````````````````````````````````\n\nElektrooniliste häälte täielik töötlemine on tegevus, mille käigus\ntöötlemisrakendus võrdleb Kogumisteenuse poolt talletatud häälte hulka\nregistreerimisteenuse poolt talletatud häälte hulgaga, kontrollib talletatud\nhäälte vastavust valimiste konfiguratsioonile, tuvastab loendamisele minevad\nhääled ning anonüümib need Võtmerakendusele üle andmiseks.\n\n#. rakenduse seadistuste laadimine;\n\n#. elektrooniliste häälte digitaalallkirjade verifitseerimine;\n\n#. registreerimisteenuse kinnituste verifitseerimine;\n\n#. ajatemplite verifitseerimine;\n\n#. iga valija kohta viimase kehtiva hääle tuvastamine;\n\n#. algse elektrooniliselt hääletanute nimekirja väljastamine PDF-vormingus;\n\n#. tühistus- ja ennistusnimekirjade verifitseerimine;\n\n#. tühistus- ja ennistusnimekirjade kooskõlalisuse kontroll;\n\n#. tühistus- ja ennistusnimekirjade rakendamine;\n\n#. miksimisele minevate häälte nimekirja koostamine, krüptogrammide eraldamine\n digitaalallkirjadest;\n\n#. lõpliku elektrooniliselt hääletanute nimekirja väljastamine masinloetavas\n vormingus.\n\n\nElektrooniliselt hääletanute nimekirja genereerimine\n````````````````````````````````````````````````````\n\n#. rakenduse seadistuste laadimine;\n\n#. elektrooniliste häälte digitaalallkirjade verifitseerimine;\n\n#. algse elektrooniliselt hääletanute nimekirja väljastamine PDF-vormingus.\n\n\nAuditirakendus\n--------------\n\n.. figure:: model/img/audit.png\n\n Auditirakenduse liidesed\n\nAuditirakendusega (joonis 9) verifitseeritakse matemaatiliselt häälte\nkokkulugemise korrektsust ning miksimise kasutamisel ka miksimise korrektsust.\n\nAuditirakenduse sisendid on;\n\n- anonüümitud hääled;\n\n- miksitud hääled;\n\n- Verificatumi miksimistõend;\n\n- hääletamistulemus.\n\nAuditirakenduse väljund on rakenduse detailne tegevuslogi, mis sisaldab ka\nhinnangut auditi tervikliku õnnestumise kohta. Vajadusel väljastatakse ka\nrakenduse detailne vealogi.\n" }, { "path": "Documentation/public/arhitektuur/viited.rst", "content": ".. IVXV arhitektuur\n\n\n.. [DesmedtF89] Desmedt, Y. & Frankel, Y. Brassard, G. (Ed.) Threshold\n Cryptosystems Advances in Cryptology - CRYPTO '89, 9th Annual International\n Cryptology Conference, Santa Barbara, California, USA, August 20-24, 1989,\n Proceedings, Springer, 1989, 435, 307-315.\n\n.. [HMVW16] Sven Heiberg, Tarvi Martens, Priit Vinkel, Jan Willemson, Improving\n the verifiability of the Estonian Internet Voting scheme. In Robert Krimmer,\n Melanie Volkamer, Jordi Barrat, Josh Benaloh, Nicole Goodman, Peter Y.A. Ryan,\n Oliver Spycher, Vanessa Teague, Gregor Wenda (Eds.), The International\n Conference on Electronic Voting E-Vote-ID 2016, 18-21 October 2016,\n Lochau/Bregenz, Austria, TUT Press, pp. 213-229, ISBN 978-9949-83-022-0\n\n.. [TK2016] Tehniline kirjeldus. Elektroonilise hääletamise infosüsteemi\n arenduse hange, Vabariigi Valimiskomisjon, 2016\n\n.. [ÜK2016] Elektroonilise hääletamise üldraamistik ja selle kasutamine Eesti\n riiklikel valimistel. Elektroonilise Hääletamise Komisjon, Tallinn 2016\n" }, { "path": "Documentation/public/arhitektuur/yldpohimotted.rst", "content": ".. IVXV arhitektuur\n\nSissejuhatus\n============\n\nElektroonilise hääletamise infosüsteem IVXV on loodud lähtuvalt e-hääletamise\nraamistikust [ÜK2016]_ ja riigihanke 171780 tehnilisest kirjeldusest [TK2016]_.\nKäesolevas dokumendis kirjeldatakse IVXV arhitektuurset lahendust. Elektroonilise\nhääletamise infosüsteem koosneb vallasrežiimirakendustest ning\nsidusrežiimikomponentidest. Täiendavalt sõltub infosüsteem välistest\ninfosüsteemidest ning mõjutab vahetult elektrooniliseks hääletamiseks ja hääle\nkontrollimiseks kasutatavaid komponente.\n\nArhitektuuridokument kirjeldab IVXV komponente, nende omavahelisi liideseid ja\nliideseid väliste süsteemidega ning komponentide poolt realiseeritavaid protokolle.\n\nIVXV kontseptsioon\n------------------\n\nÜldine, kuid terviklik ülevaade elektroonilise hääletamise raamistiku (\"IVXV\")\ntehnilisest ja organisatsioonilisest poolest ning selle rakendamisest Eesti\nriiklikel valimistel on antud e-hääletamise raamistiku üldkirjelduses\n[ÜK2016]_.\n\nIVXV infosüsteemina teostab \"ümbrikuskeemil\" põhinevat e-hääletamise\nprotokolli. IVXV toimib hääletamiseelsel etapil, hääletamisetapil,\ntöötlusetapil ning lugemisetapil ja pakub vahendeid elektroonilise hääletamise\nprotsessis osalemiseks Korraldajale, Lugejale, Hääletajale, Kogujale,\nTöötlejale, Miksijale, Audiitorile, Klienditoele, Valijate nimekirja koostajale\nja täiendajale.\n\nInfosüsteemi komponendid on Kogumisteenus, Töötlemisrakendus, Võtmerakendus\nning Auditirakendus. Infosüsteemiga on tihedalt seotud Valijarakendus,\nKontrollrakendus ning Miksimisrakendus.\n\nInfosüsteem kasutab oma töös väliseid teenuseid - Tuvastusteenus,\nAllkirjastamisteenus, Registreerimisteenus, Valimiste Infosüsteem ning X-tee.\n\nIVXV krüptograafiline protokoll\n-------------------------------\n\nElektroonilise hääletamise turvalisuse, verifitseeritavuse ning hääletamise\nsalajasuse, hääletamise korrektsuse ja hääletaja sõltumatuse saavutamiseks on\nrangelt kirjeldatud elektroonilise hääletamise krüptograafiline protokoll\n[HMVW16]_. Protokoll annab vajaliku ja piisava ülevaate IVXV ülesehitusest ning\nselle turvaaspektidest. IVXV komponendid realiseerivad krüptograafilise\nprotokolli alamosi.\n\nNotatsioon\n----------\n\nArhitektuurse lahenduse visandi illustreerimiseks kasutatakse dokumendis\nUML-skeeme, kus eristame värvide ja märgenditega ``<<>>`` kodeeritult olemite –\ntegijad, liidesed, komponendid – järgmisi aspekte:\n\n* Märgend ``<>`` (Kollane) – infosüsteemi liides või komponent\n defineeritakse/realiseeritakse konkreetse pakkumuse raames tehtavate tööde\n käigus\n\n* Märgend ``<>`` (Punane) – infosüsteem sõltub mingi funktsionaalsuse\n realiseerimisel kolmanda osapoole komponendist või olemasolevast liidesest,\n mille ümberdefineerimine eeldab ka kolmandate osapoolte tööd.\n\n* Märgend ``<>`` (Pruun) – sarnane eelmisele, kuid liidese/komponendi\n omanikuks on VVK.\n\n* Märgend ``<>`` (Must) – infosüsteemi jaoks oluline liides on\n määratlemata.\n\n.. figure:: model/img/example.png\n\n Näiteskeem\n" }, { "path": "Documentation/public/liidesed/Makefile", "content": "include ../../common.mk\n" }, { "path": "Documentation/public/liidesed/examples.rst", "content": "\nSkeemid ja näited\n=================\n\n---------------------------\nValimisringkondade nimekiri\n---------------------------\n\nSkeem\n-----\n\n.. literalinclude:: VIS3-EHS/1_Valimisringkondade_nimekiri/districts.schema\n :language: json\n :linenos:\n\nNäide: KOV\n----------\n\n.. literalinclude:: VIS3-EHS/1_Valimisringkondade_nimekiri/district_KOV.json\n :language: json\n :linenos:\n\nNäide: EP\n---------\n\n.. literalinclude:: VIS3-EHS/1_Valimisringkondade_nimekiri/districts_EP.json\n :language: json\n :linenos:\n\nNäide: RH\n---------\n\n.. literalinclude:: VIS3-EHS/1_Valimisringkondade_nimekiri/districts_RH.json\n :language: json\n :linenos:\n\nNäide: RK\n---------\n.. literalinclude:: VIS3-EHS/1_Valimisringkondade_nimekiri/districts_RK.json\n :language: json\n :linenos:\n\n-----------------\nValikute nimekiri\n-----------------\n\nSkeem\n-----\n\n.. literalinclude:: VIS3-EHS/2_Valikute_nimekiri/choices.schema\n :language: json\n :linenos:\n\nNäide: EP\n---------\n.. literalinclude:: VIS3-EHS/2_Valikute_nimekiri/choices_EP.json\n :language: json\n :linenos:\n\nNäide: KOV\n----------\n\n.. literalinclude:: VIS3-EHS/2_Valikute_nimekiri/choices_KOV.json\n :language: json\n :linenos:\n\nNäide: RH\n---------\n.. literalinclude:: VIS3-EHS/2_Valikute_nimekiri/choices_RH.json\n :language: json\n :linenos:\n\nNäide: RK\n---------\n.. literalinclude:: VIS3-EHS/2_Valikute_nimekiri/choices_RK.json\n :language: json\n :linenos:\n\n----------------------\nE-hääletanute nimekiri\n----------------------\n\nSkeem\n-----\n\n.. literalinclude:: VIS3-EHS/4_e_haaletanute_nimekiri/onlinevoters.schema\n :language: json\n :linenos:\n\nNäide: EP\n---------\n.. literalinclude:: VIS3-EHS/4_e_haaletanute_nimekiri/onlinevoters_EP.json\n :language: json\n :linenos:\n\nNäide: KOV\n----------\n.. literalinclude:: VIS3-EHS/4_e_haaletanute_nimekiri/onlinevoters_KOV.json\n :language: json\n :linenos:\n\nNäide: RH\n---------\n.. literalinclude:: VIS3-EHS/4_e_haaletanute_nimekiri/onlinevoters_RH.json\n :language: json\n :linenos:\n\nNäide: RK\n---------\n.. literalinclude:: VIS3-EHS/4_e_haaletanute_nimekiri/onlinevoters_RK.json\n :language: json\n :linenos:\n\n----------------\nTühistusnimekiri\n----------------\n\nSkeem\n-----\n\n.. literalinclude:: VIS3-EHS/5_Tyhistusnimekiri/revoke.schema\n :language: json\n :linenos:\n\nNäide: EP\n---------\n.. literalinclude:: VIS3-EHS/5_Tyhistusnimekiri/revoke_EP.json\n :language: json\n :linenos:\n\nNäide: KOV\n----------\n.. literalinclude:: VIS3-EHS/5_Tyhistusnimekiri/revoke_KOV.json\n :language: json\n :linenos:\n\nNäide: RH\n---------\n.. literalinclude:: VIS3-EHS/5_Tyhistusnimekiri/revoke_RH.json\n :language: json\n :linenos:\n\nNäide: RK\n---------\n.. literalinclude:: VIS3-EHS/5_Tyhistusnimekiri/revoke_RK.json\n :language: json\n :linenos:\n\n---------------------\nE-hääletamise tulemus\n---------------------\n\nSkeem\n-----\n\n.. literalinclude:: VIS3-EHS/6_e_haaletamise_tulemus/results.schema\n :language: json\n :linenos:\n\nNäide: EP\n---------\n.. literalinclude:: VIS3-EHS/6_e_haaletamise_tulemus/results_EP.json\n :language: json\n :linenos:\n\nNäide: KOV\n----------\n.. literalinclude:: VIS3-EHS/6_e_haaletamise_tulemus/results_KOV.json\n :language: json\n :linenos:\n\nNäide: RH\n---------\n.. literalinclude:: VIS3-EHS/6_e_haaletamise_tulemus/results_RH.json\n :language: json\n :linenos:\n\nNäide: RK\n---------\n.. literalinclude:: VIS3-EHS/6_e_haaletamise_tulemus/results_RK.json\n :language: json\n :linenos:\n\n---------------------------\nE-hääletamise üldstatistika\n---------------------------\n\nSkeem\n-----\n\n.. literalinclude:: VIS3-EHS/7_e_haaletamise_yldstatistika/online-voters-total.schema\n :language: json\n :linenos:\n\nNäide\n-----\n.. literalinclude:: VIS3-EHS/7_e_haaletamise_yldstatistika/online-voters-total.json\n :language: json\n :linenos:\n\n------------------------------\nE-hääletamise detailstatistika\n------------------------------\n\nSkeem\n-----\n\n.. literalinclude:: VIS3-EHS/8_e_haaletamise_detailstatistika/online-voters-counties.schema\n :language: json\n :linenos:\n\n-----------------------\nE-hääletamiste nimekiri\n-----------------------\n\nSkeem\n-----\n\n.. literalinclude:: VIS3-EHS/9_e_haaletamiste_nimekiri/ehs-xroad-api.yaml\n :language: yaml\n :linenos:\n\n" }, { "path": "Documentation/public/liidesed/index.rst", "content": ".. IVXV registreerimisteenus\n\nIVXV registreerimisteenus\n=================================================================\n\n.. raw:: html\n\n

\n NB!\n See on HTML-versioon dokumendist.\n Tellijale antakse üle PDF-versioon.\n

\n\n\n.. toctree::\n :maxdepth: 3\n :numbered:\n\n VIS3-EHS/README.md\n VIS3-EHS/valimissündmuse_identifikaator\n VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md\n VIS3-EHS/2_Valikute_nimekiri/SPEC.md\n VIS3-EHS/3_Valijate_nimekiri/SPEC.md\n VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md\n VIS3-EHS/5_Tyhistusnimekiri/SPEC.md\n VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md\n VIS3-EHS/7_e_haaletamise_yldstatistika/SPEC.md\n VIS3-EHS/8_e_haaletamise_detailstatistika/SPEC.md\n VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md\n examples\n" }, { "path": "Documentation/public/liidesed/locales/en/LC_MESSAGES/VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2024, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\n#, fuzzy\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.9.1\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2024-03-02 12:43+0200\\n\"\n\"PO-Revision-Date: 2024-03-02 13:31+0200\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: en \\n\"\n\"Language: en\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"Generated-By: Babel 2.10.3\\n\"\n\"X-Generator: Poedit 3.4.2\\n\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:1\nmsgid \"1 Valimisringkondade nimekiri\"\nmsgstr \"List of constituencies\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:3\nmsgid \"Protseduur\"\nmsgstr \"Procedure\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:5\nmsgid \"VIS3 edastab EHS-le teabe valimisringkondade kohta.\"\nmsgstr \"VIS3 transmits constituency information to EHS.\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:7\nmsgid \"Andmed edastatakse inim-masin-protseduuriga:\"\nmsgstr \"The data are transmitted by human-machine procedure:\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:9\nmsgid \"VIS peakasutaja laeb JSON faili VIS3-st alla;\"\nmsgstr \"The VIS head user downloads the JSON file from VIS3;\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:11\nmsgid \"\"\n\"VIS peakasutaja allkirjastab faili digitaalselt väljaspool VIS-i ja annab \"\n\"selle EHS operaatorile;\"\nmsgstr \"\"\n\"The VIS head user digitally signs the file outside the VIS and gives it to \"\n\"the EHS operator;\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:13\nmsgid \"EHS operaator laeb digiallkirjastatud faili EHS-i.\"\nmsgstr \"The EHS operator uploads the digitally signed file to the EHS.\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:15\nmsgid \"Fail on JSON-formaadis. Faili ei allkirjastata.\"\nmsgstr \"The file is in JSON format. The file will not be signed.\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:17\nmsgid \"\"\n\"Faili struktuur on kirjeldatud JSON schema-ga. Kirjeldus on kooskõlastatud \"\n\"EHS omanikuga.\"\nmsgstr \"\"\n\"The file structure is described by a JSON schema. The description has been \"\n\"agreed with the EHS owner.\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:19\nmsgid \"\"\n\"EHS senine liides VIS2-ga on spetsifitseeritud dokumendis \\\"IVXV \"\n\"protokollide kirjeldus\\\" (v 1.5.0, IVXV-PR-1.5.0, 20.04.2019), [https://www.\"\n\"valimised.ee/sites/default/files/uploads/eh/IVXV-protokollid.pdf](https://\"\n\"www.valimised.ee/sites/default/files/uploads/eh/IVXV-protokollid.pdf), \"\n\"jaotises 3.2 \\\"Valimisjaoskondade ja -ringkondade nimekiri\\\".\"\nmsgstr \"\"\n\"The current interface of the EHS with VIS2 is specified in the document \"\n\"\\\"Description of the IVXV protocols\\\" (v 1.5.0, IVXV-PR-1.5.0, 20.04.2019), \"\n\"[https://www.valimised.ee/sites/default/files/uploads/eh/IVXV-protokollid.\"\n\"pdf](https://www.valimised.ee/sites/default/files/uploads/eh/IVXV-\"\n\"protokollid.pdf), section 3.2 \\\"List of polling stations and \"\n\"constituencies\\\".\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:21\nmsgid \"\"\n\"Valimistel, kus saavad osaleda alaliselt välisriigis elavad valijad \"\n\"kantakse nad valijate nimekirja tunnusega `FOREIGN`. Sellisel juhul peab \"\n\"valimisringkondade nimekiri sisaldama regiooni nende valijate jaoks ning \"\n\"iga ringkond peab sisaldama eraldi jaoskonda, kus nende häälte üle \"\n\"arvestust peetakse. Nii selle regiooni kui jaoskondade tunnuseks on \"\n\"fiktiivne EHAK: `0000`. Näitefailis [districts_RK.json](districts_RK.json) \"\n\"on näha nii regiooni korrektne lisamine kui ka välishääletajate jaoskonna \"\n\"korrektne lisamine igasse ringkonda.\"\nmsgstr \"\"\n\"In elections where voters permanently resident abroad are eligible, they \"\n\"are entered on the electoral roll with the symbol `FOREIGN`. In this case, \"\n\"the list of constituencies must include the region for these voters and \"\n\"each constituency must include a separate polling station where their votes \"\n\"are counted. Both this region and the precincts shall be identified by the \"\n\"fictitious EHAK: `0000'. The example file [districts_RK.json](districts_RK.\"\n\"json) shows both the correct inclusion of a region and the correct \"\n\"inclusion of an out-of-town voter precinct in each district.\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:25\nmsgid \"Edastatav fail\"\nmsgstr \"Transmitted file\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:27\nmsgid \"\"\n\"Valimissündmuse identifikaator peab vastama formaadile [Valimissündmuse \"\n\"identifikaator](../valimissündmuse_identifikaator.md).\"\nmsgstr \"\"\n\"The election event identifier must conform to the format [Election event \"\n\"identifier](../valimissündmuse_identifikaator.md).\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:29\nmsgid \"Faili struktuur (JSON-skeem): [districts.schema](districts.schema)\"\nmsgstr \"File structure (JSON schema): [districts.schema](districts.schema)\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:31\nmsgid \"Näited (JSON):\"\nmsgstr \"Examples (JSON):\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:33\nmsgid \"[district_KOV.json](district_KOV.json)\"\nmsgstr \"[district_KOV.json](district_KOV.json)\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:34\nmsgid \"[districts_EP.json](districts_EP.json)\"\nmsgstr \"[districts_EP.json](districts_EP.json)\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:35\nmsgid \"[districts_RH.json](districts_RH.json)\"\nmsgstr \"[districts_RH.json](districts_RH.json)\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:36\nmsgid \"[districts_RK.json](districts_RK.json)\"\nmsgstr \"[districts_RK.json](districts_RK.json)\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:38\nmsgid \"Taustainfo\"\nmsgstr \"Background information\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:40\nmsgid \"\"\n\"Kandidaate on võimalik valimisele üles seada ainult konkreetses \"\n\"valimisringkonnas. Ringkondade järgi antakse valijatele hääletamise valikud:\"\nmsgstr \"\"\n\"For any voter it is only possible to vote for candidates from a single \"\n\"constituency. Voters are given voting options by constituency:\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:42\nmsgid \"Iga valija kuulub talle määratud valimisringkonda;\"\nmsgstr \"Each voter belongs to the constituency assigned to him or her;\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:43\nmsgid \"\"\n\"Kõigis ühe ringkonna jaoskondades saavad valijad teha valiku vaid selle \"\n\"ringkonna valikute vahel;\"\nmsgstr \"\"\n\"In each of the polling station in a district, voters can only choose \"\n\"between the options for that district;\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:45\nmsgid \"\"\n\"Eesti riiklikel valimistel eristatakse kohalike omavalitsuste volikogude \"\n\"(KOV) valimisi, Riigikogu valimisi, Euroopa Parlamendi valimisi ning \"\n\"rahvahääletusi.\"\nmsgstr \"\"\n\"In Estonian national elections, a distinction is made between local \"\n\"government elections, Riigikogu elections, European Parliament elections \"\n\"and referendums.\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:47\nmsgid \"\"\n\"KOV valimised korraldatakse vastavalt seadusele „Kohaliku omavalitsuse \"\n\"volikogu valimise seadus“. Valimine toimub kohaliku omavalitsuse tasandil, \"\n\"igal omavalitsusel on oma hääletamistulemus. Valimisringkonnad \"\n\"moodustatakse omavalitsuse tasemel vastavalt seaduses kirjeldatud \"\n\"reeglitele.\"\nmsgstr \"\"\n\"Local elections are organised in accordance with the law \\\"Law on the \"\n\"election of local government councils\\\". Elections are held at the level of \"\n\"the local municipality, each municipality has its own voting results. \"\n\"Constituencies are formed at the municipal level according to the rules \"\n\"described in the law.\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:49\nmsgid \"\"\n\"Riigikogu valimised korraldatakse vastavalt seadusele „Riigikogu valimise \"\n\"seadus“. Valimine toimub riigi tasandil. Riik jaguneb 12 \"\n\"valimisringkonnaks. Hääletamistulemus tehakse kindlaks iga valimisringkonna \"\n\"kohta.\"\nmsgstr \"\"\n\"Elections to the Riigikogu are organised in accordance with the Act on the \"\n\"Election of the Riigikogu. Elections are held at the national level. The \"\n\"country is divided into 12 constituencies. The result of the vote is \"\n\"determined for each constituency.\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:51\nmsgid \"\"\n\"Europarlamendi valimised korraldatakse vastavalt seadusele „Euroopa \"\n\"Parlamendi valimise seadus“. Valimine toimub riigi tasandil, \"\n\"hääletamistulemus on kõigile kohalikele omavalitsustele ühine. Terve riik \"\n\"on üks valimisringkond.\"\nmsgstr \"\"\n\"The elections to the European Parliament are organised in accordance with \"\n\"the law \\\"Law on the election of the European Parliament\\\". Elections are \"\n\"held at national level, with the result of the vote being common to all \"\n\"local authorities. The whole country is one constituency.\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:53\nmsgid \"\"\n\"Rahvahääletused korraldatakse vastavalt seadusele „Rahvahääletuse seadus“. \"\n\"Valimine toimub riigi tasandil, hääletamistulemus on kõigile kohalikele \"\n\"omavalitsustele ühine. Terve riik on üks valimisringkond.\"\nmsgstr \"\"\n\"Referendums are organised in accordance with the law \\\"Referendums Act\\\". \"\n\"Elections are held at the national level, and the result of the vote is \"\n\"common to all local authorities. The whole country is one constituency.\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:55\nmsgid \"\"\n\"Erinevad valimised ei erine elektroonilise hääletamise andmevormingute ja \"\n\"protseduuride poolest. Erinevad ringkondade jaotused hallatakse VIS3 poolt.\"\nmsgstr \"\"\n\"The different elections do not differ in terms of electronic voting data \"\n\"formats and procedures. The different constituency breakdowns are managed \"\n\"by VIS3.\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:57\nmsgid \"\"\n\"Kandidaate on võimalik valimisele üles seada ainult konkreetses \"\n\"valimisringkonnas. Valijad on jaotatud valimisringkondade vahel. Valija \"\n\"saab teha valiku ainult tema ringkonnas kandideerivate kandidaatide vahel.\"\nmsgstr \"\"\n\"It is only possible to stand as a candidate in a particular constituency. \"\n\"Voters are allocated between constituencies. Voters can only choose between \"\n\"candidates standing in their constituency.\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:59\nmsgid \"\"\n\"Kuna kohaliku omavalitsuse volikogude valimisel toimub valimine Eesti \"\n\"omavalitsuste (vallad, linnad) tasemel, siis kasutatakse elektroonilise \"\n\"hääletamise protokollistikus valimisringkondade kirjeldamisel ning valijate \"\n\"ja valikute ringkonnakuuluvuse näitamisel Eesti haldus- ja asustusjaotuse \"\n\"klassifikaatorit EHAK\"\nmsgstr \"\"\n\"Since the election of local government councils is held at the level of \"\n\"Estonian local governments (municipalities, cities), the Estonian \"\n\"Administrative and Settlement Classification of Estonia (EHAK) is used in \"\n\"the electronic voting protocol to describe the electoral districts and to \"\n\"indicate the district coverage of voters and choices\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:61\nmsgid \"\"\n\"Näiteks: • Tallinna linna Pirita linnaosa EHAK kood on 0596; • Anija valla \"\n\"EHAK kood on 0141.\"\nmsgstr \"\"\n\"For example: - the EHAK code of Pirita district of Tallinn is 0596; - the \"\n\"EHAK code of Anija municipality is 0141.\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:65\nmsgid \"\"\n\"Riigi tasemel toimuvatel valimistel pannakse ringkonna EHAK koodiks \"\n\"kokkuleppeliselt 0.\"\nmsgstr \"\"\n\"For national elections, the district EHAK code is set to 0 by convention.\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:67\nmsgid \"\"\n\"Riigikogu ja europarlamendi valimistel ning rahvahääletusel moodustatakse \"\n\"nimekirjas igasse ringkonda fiktiivne üksus alaliselt välisriigis elavate \"\n\"valijate tarbeks. Selle üksuse number on 0 ning vastav EHAK kood on 0000.\"\nmsgstr \"\"\n\"In Riigikogu and European Parliament elections and in referendums, a \"\n\"fictitious unit is created in each district for voters permanently resident \"\n\"abroad. The number of this unit is 0 and the corresponding EHAK code is \"\n\"0000.\"\n" }, { "path": "Documentation/public/liidesed/locales/en/LC_MESSAGES/VIS3-EHS/2_Valikute_nimekiri/SPEC.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2024, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\n#, fuzzy\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.9.1\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2024-03-02 12:43+0200\\n\"\n\"PO-Revision-Date: 2024-03-02 13:34+0200\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: en \\n\"\n\"Language: en\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"Generated-By: Babel 2.10.3\\n\"\n\"X-Generator: Poedit 3.4.2\\n\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:1\nmsgid \"2 Valikute nimekiri (kandidaatide nimekiri)\"\nmsgstr \"List of Candidates\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:3\nmsgid \"Protseduur\"\nmsgstr \"Procedure\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:5\nmsgid \"\"\n\"VIS3 edastab EHS-le andmed registreeritud kandidaatide (valimistel) või \"\n\"vastusevariantide (rahvahääletusel) kohta.\"\nmsgstr \"\"\n\"VIS3 transmits to EHS data on registered candidates (in elections) or \"\n\"options (in referendums).\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:7\nmsgid \"Andmed edastatakse inim-masin-protseduuriga:\"\nmsgstr \"The data are transmitted by human-machine procedure:\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:9\nmsgid \"\"\n\"VIS peakasutaja laeb JSON faili VIS3-st alla; Kasutaja peab valima \"\n\"aktiivsete valimissündmuste seast soovitud sündmuse, mille kohta infot alla \"\n\"laadida. Valimissündmus on aktiivne, kui tema staatus pole `closed` ega \"\n\"`deleted`.\"\nmsgstr \"\"\n\"The VIS head user downloads a JSON file from VIS3; the user has to select \"\n\"the desired event to download information about from the list of active \"\n\"election events. An election event is active if its status is neither \"\n\"`closed` nor `deleted`.\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:10\nmsgid \"\"\n\"VIS peakasutaja allkirjastab faili digitaalselt väljaspool VIS-i ja annab \"\n\"selle EHS operaatorile;\"\nmsgstr \"\"\n\"The VIS head user digitally signs the file outside the VIS and gives it to \"\n\"the EHS operator;\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:11\nmsgid \"EHS operaator laeb digiallkirjastatud faili EHS-i.\"\nmsgstr \"The EHS operator uploads the digitally signed file to the EHS.\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:13\nmsgid \"\"\n\"Fail on JSON-formaadis (näidis lisatud tööülesandele). Faili ei \"\n\"allkirjastata.\"\nmsgstr \"\"\n\"The file is in JSON format (sample attached to the assignment). The file is \"\n\"not signed.\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:15\nmsgid \"Edastatav fail\"\nmsgstr \"Transmitted file\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:17\nmsgid \"\"\n\"Aluseks on EHS senine liides VIS2-ga, mis on spetsifitseeritud dokumendis \"\n\"\\\"IVXV protokollide kirjeldus\\\" (v 1.5.0, IVXV-PR-1.5.0, 20.04.2019), \"\n\"[https://www.valimised.ee/sites/default/files/uploads/eh/IVXV-protokollid.\"\n\"pdf](https://www.valimised.ee/sites/default/files/uploads/eh/IVXV-\"\n\"protokollid.pdf), jaotises \\\"Valikute nimekiri\\\" (jaotis 3.4).\"\nmsgstr \"\"\n\"It is based on the current interface of the EHS with VIS2, as specified in \"\n\"the document \\\"Description of the IVXV protocols\\\" (v 1.5.0, IVXV-PR-1.5.0, \"\n\"20.04.2019), [https://www.valimised.ee/sites/default/files/uploads/eh/IVXV-\"\n\"protokollid.pdf](https://www.valimised.ee/sites/default/files/uploads/eh/\"\n\"IVXV-protokollid.pdf), section \\\"List of options\\\" (section 3.4).\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:19\nmsgid \"\"\n\"Valimissündmuse identifikaator peab vastama formaadile [Valimissündmuse \"\n\"identifikaator](../valimissündmuse_identifikaator.md).\"\nmsgstr \"\"\n\"The election event identifier must conform to the format [Election event \"\n\"identifier](../valimissündmuse_identifikaator.md).\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:21\nmsgid \"Faili struktuur (JSON-skeem): [choices.schema](choices.schema)\"\nmsgstr \"File structure (JSON schema): [choices.schema](choices.schema)\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:23\nmsgid \"Faili näited (JSON):\"\nmsgstr \"File examples (JSON):\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:25\nmsgid \"[choices_KOV.json](choices_KOV.json)\"\nmsgstr \"[choices_KOV.json](choices_KOV.json)\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:26\nmsgid \"[choices_EP.json](choices_EP.json)\"\nmsgstr \"[choices_EP.json](choices_EP.json)\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:27\nmsgid \"[choices_RK.json](choices_RK.json)\"\nmsgstr \"[choices_RK.json](choices_RK.json)\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:29\nmsgid \"Taustainfo\"\nmsgstr \"Background information\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:31\nmsgid \"\"\n\"Valikute nimekiri sisaldab andmeid kandidaatide (valimistel) või \"\n\"vastusevariantide (rahvahääletusel) kohta. Valimiste korral on lisaks \"\n\"kandidaadi andmetele nimekirjas ka tema erakonna või valimisliidu nimi, \"\n\"mille nimekirjas ta kandideerib.\"\nmsgstr \"\"\n\"The list of choices contains information on the candidates (in the \"\n\"election) or the options (in the referendum). In the case of an election, \"\n\"the list includes, in addition to the candidate's details, the name of the \"\n\"political party or electoral alliance on whose list he or she is standing.\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:34\nmsgid \"\"\n\"Valijale elektroonilise hääletamise käigus nähtavaid valimiste vahelisi \"\n\"süsteemseid erinevusi on kaks:\"\nmsgstr \"\"\n\"There are two systemic differences between elections that are visible to \"\n\"the voter when voting electronically:\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:36\nmsgid \"\"\n\"Rahvahääletusel ei valita erakondadesse kuuluvate kandidaatide vahel vaid \"\n\"vastatakse „JAH“/“EI“ rahvahääletuse küsimusele;\"\nmsgstr \"\"\n\"The referendum is not a choice between candidates belonging to political \"\n\"parties, but a \\\"YES\\\"/\\\"NO\\\" answer to a referendum question;\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:38\nmsgid \"\"\n\"Riigikogu, KOV ja Euroopa Parlamendi valimistel antakse hääl ühele \"\n\"kandidaadile, kes võib, aga ei pruugi kuuluda poliitilise ühenduse \"\n\"nimekirja.\"\nmsgstr \"\"\n\"In the elections to the Riigikogu, Municipalities and the European \"\n\"Parliament, votes are cast for one candidate, who may or may not be on the \"\n\"list of a political association.\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:40\nmsgid \"\"\n\"Protokollistik kodeerib valija võimalikud valikud ringkonnas kuni 11-\"\n\"kohalise arvväärtusena, mis valikute nimekirjas kodeeritakse koos ringkonna \"\n\"EHAK-koodiga. Valijale tohivad kättesaadavad olla ainult tema \"\n\"ringkonnakohased valikud. Valijarakendus peab seda omadust tagama ning \"\n\"hääletamistulemust arvutav rakendus kontrollima.\"\nmsgstr \"\"\n\"The protocol encodes the voter's possible choices in the district as a \"\n\"numeric value of up to 11 digits, which in the list of choices is encoded \"\n\"together with the district's EHAK code. A voter may only have options \"\n\"available for his/her district. The voter application must guarantee this \"\n\"property and the application calculating the vote result must check it.\"\n" }, { "path": "Documentation/public/liidesed/locales/en/LC_MESSAGES/VIS3-EHS/3_Valijate_nimekiri/SPEC.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2024, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\n#, fuzzy\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.9.1\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-03 23:04+0000\\n\"\n\"PO-Revision-Date: 2024-03-02 13:43+0200\\n\"\n\"Last-Translator: \\n\"\n\"Language: en\\n\"\n\"Language-Team: en \\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:1\nmsgid \"3 Valijate nimekiri EHS-le\"\nmsgstr \"Voters list for the EHS\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:3\nmsgid \"1. Annotatsioon\"\nmsgstr \"Annotation\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:5\nmsgid \"\"\n\"Spetsifikatsioon määratleb Valimiste infosüsteemi (VIS3) ja e-hääletamise\"\n\" süsteemi (EHS) vahelise liidese, mille kaudu VIS3 edastab EHS-le \"\n\"valijate algnimekirja ja valijate nimekirja muudatusi ehk \"\n\"muudatusnimekirju.\"\nmsgstr \"\"\n\"The specification defines the interface between the Election Information \"\n\"System (VIS3) and the e-voting system (EHS), through which VIS3 transmits\"\n\" to EHS the initial voters' list and changes to the voters' list, or \"\n\"change lists.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:9\nmsgid \"\"\n\"Spetsifikatsioon on avalik. Spetsifikatsioon ei käsitle VIS3 ega EHS \"\n\"konfidentsiaalset siseehitust ega liidese konfidentsiaalseid elemente.\"\nmsgstr \"\"\n\"The specification is public. The specification does not address the \"\n\"confidential internal architecture of VIS3 or EHS, nor the confidential \"\n\"elements of the interface.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:12\nmsgid \"\"\n\"Käesolevat spetsifikatsiooni tuleb kasutada koos VIS3 EHS API OpenAPI \"\n\"spetsifikatsiooniga (asub käesolevas repos, failis `vis-ehs-api.yaml`).\"\nmsgstr \"\"\n\"This specification should be used in conjunction with the VIS3 EHS API \"\n\"OpenAPI specification (located in this repo, in the file `vis-ehs-\"\n\"api.yaml`).\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:14\nmsgid \"2. Sõnumivahetus nimekirjade edastamiseks\"\nmsgstr \"Exchange of messages for the transmission of lists\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:16\nmsgid \"\"\n\"Valijate nimekirja põhjal tuvastab EHS isiku hääleõiguse ja \"\n\"ringkonnakuuluvuse. Valijate nimekiri võib hääletamisperioodi jooksul \"\n\"muutuda, sellest tulenevalt võib valija saada hääleõiguse, jääda oma \"\n\"hääleõigusest ilma või saada hääleõiguse senisest erinevas ringkonnas. \"\n\"EHS peab nende muutustega arvestama. Muudatused saab EHS VIS3 vahendusel \"\n\"muudatusnimekirjadena.\"\nmsgstr \"\"\n\"Based on the voters' list, the EHS determines a person's eligibility to \"\n\"vote and district eligibility. The electoral roll may change during the \"\n\"voting period, and as a result, a voter may become eligible to vote, be \"\n\"disenfranchised, or become eligible to vote in a different district. The \"\n\"EHS must take these changes into account. The changes can be obtained by \"\n\"EHS via VIS3 as change lists.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:22\nmsgid \"\"\n\"Spetsifikatsioonis defineeritud liidese vahendusel suhtlevad vahetult EHS\"\n\" ja VIS3:\"\nmsgstr \"\"\n\"EHS and VIS3 communicate directly via the interface defined in the \"\n\"specification:\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:25\nmsgid \"\"\n\"VIS3 liidestub Rahvastikuregistri andmekoguga ning hangib seal nii \"\n\"valijate algnimekirja kui ka muudatusnimekirjad.\"\nmsgstr \"\"\n\"VIS3 interfaces with the Population Register database and retrieves both \"\n\"the initial voters' list and the amended voters' lists.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:27\nmsgid \"EHS esitab VIS3-le päringuid muudatusnimekirjade saamiseks.\"\nmsgstr \"The EHS will query VIS3 for change lists.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:29\nmsgid \"Kaudselt on liidesega seotud:\"\nmsgstr \"Indirectly linked to the interface:\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:31\nmsgid \"Rahvastikuregister, kus toimub nimekirjade haldamine;\"\nmsgstr \"Population register, where the lists are managed;\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:32\nmsgid \"\"\n\"VIS3 ja EHS operaatorid, kes vahetavad taustakanalis algnimekirja ning \"\n\"suhtlevad võimalike tõrgete lahendamisel;\"\nmsgstr \"\"\n\"VIS3 and EHS operators exchanging the initial list in the background \"\n\"channel and communicating on possible glitches;\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:34\nmsgid \"Audiitor, kes veendub et EHS on VIS3 poolt tarnitud nimekirjad rakendanud;\"\nmsgstr \"\"\n\"An auditor who makes sure that EHS has implemented the lists delivered by\"\n\" VIS3;\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:35\nmsgid \"\"\n\"EHS vallasrežiimis töötlemisrakendus, mis verifitseerib EHS sidusrežiimi \"\n\"komponentide poolt üle antud urni.\"\nmsgstr \"\"\n\"A processing application in EHS standalone mode that verifies the ballot \"\n\"box passed by the EHS online mode components.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:38\nmsgid \"2.1 Ettevalmistused nimekirjade edastamiseks\"\nmsgstr \"Preparations for the transmission of lists\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:40\nmsgid \"![Joonis 1: Sõnumivahetuse ettevalmistamine](model/list_prepare.png)\"\nmsgstr \"![Figure 1: Preparing a message exchange](model/list_prepare.png)\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:40\nmsgid \"Joonis 1: Sõnumivahetuse ettevalmistamine\"\nmsgstr \"Figure 1: Preparing the exchange of messages\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:42\nmsgid \"\"\n\"Valijate alg- ja muudatusnimekirjade vahetamisele eelnevalt tuleb \"\n\"vahetada nimekirjadele juurdepääsuks ja nimekirjade autentsuse \"\n\"kontrolliks vajalikud võtmed ja sertifikaadid (sammud 1-5)\"\nmsgstr \"\"\n\"Prior to the exchange of the voters' initial and amended lists, the keys \"\n\"and certificates needed to access the lists and to verify their \"\n\"authenticity must be exchanged (steps 1-5).\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:46\nmsgid \"2.2 Valijate algnimekirja edastamine\"\nmsgstr \"Transmission of the initial list of voters\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:48\nmsgid \"![Joonis 2: Algnimekirja edastamine](model/list_initial.png)\"\nmsgstr \"![Figure 2: Transmitting the initial list](model/list_initial.png)\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:48\nmsgid \"Joonis 2: Algnimekirja edastamine\"\nmsgstr \"Figure 2: Transmission of the initial list\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:50\nmsgid \"\"\n\"Valijate algnimekiri järjekorranumbriga 0 laetakse EHSi haldusliidese \"\n\"veebiliidesest. Valijate algnimekirja laadimine on eelduseks \"\n\"muudatusnimekirjade edasiseks automaatseks laadimiseks.\"\nmsgstr \"\"\n\"The initial list of voters with order number 0 is downloaded from the web\"\n\" interface of the EHS management interface. The loading of the initial \"\n\"list of voters is a prerequisite for further automatic loading of the \"\n\"modification lists.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:54\nmsgid \"Valijate algnimekirja laadimine toimub järgmistes etappides:\"\nmsgstr \"\"\n\"The loading of the initial list of voters will take place in the \"\n\"following steps:\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:56\nmsgid \"\"\n\"VIS3 kasutab Rahvastikuregistri X-tee teenust valijate algnimekirja \"\n\"laadimiseks (sammud 1-3).\"\nmsgstr \"\"\n\"VIS3 uses the Population Register X-Road service to load the initial list\"\n\" of voters (steps 1-3).\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:58\nmsgid \"\"\n\"VIS3 peakasutaja pärib allkirjastatud algnimekirja VIS3 teenusest, ning \"\n\"allkirjastab algnimekirja täiendavalt ID-kaardiga (sammud 4-6).\"\nmsgstr \"\"\n\"The VIS3 end-user inherits the signed initial list from the VIS3 service,\"\n\" and additionally signs the initial list with an ID card (steps 4-6).\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:60\nmsgid \"\"\n\"VIS3 peakasutaja edastab allkirjastatud algnimekirja EHS operaatorile \"\n\"(samm 7)\"\nmsgstr \"\"\n\"The VIS3 head user forwards the signed initial list to the EHS operator \"\n\"(step 7).\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:62\nmsgid \"\"\n\"EHS operaator laeb digitaalselt allkirjastatud algnimekirja EHSi, kus see\"\n\" rakendatakse (sammud 8-9).\"\nmsgstr \"\"\n\"The EHS operator uploads the digitally signed initial list to the EHS \"\n\"where it is implemented (steps 8-9).\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:65\nmsgid \"2.3 Valijate muudatusnimekirja edastamine\"\nmsgstr \"Transmission of the voters' change list\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:67\nmsgid \"![Joonis 3: Muudatusnimekirja edastamine](model/list_changeset.png)\"\nmsgstr \"![Figure 3: Forwarding a change list](model/list_changeset.png)\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:67\nmsgid \"Joonis 3: Muudatusnimekirja edastamine\"\nmsgstr \"Figure 3: Forwarding the revision list\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:69\nmsgid \"\"\n\"Valijate nimekirja muudatusnimekirja laadimise algatab EHS. \"\n\"Muudatusnimekirjad on järjestatud, nii EHS kui ka VIS3 peavad arvet, \"\n\"milline on viimane loodud muudatusnimekiri.\"\nmsgstr \"\"\n\"The EHS initiates the loading of the voters' list. The changelists are \"\n\"ordered, both EHS and VIS3 keep a record of the last changelist created.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:73\nmsgid \"\"\n\"EHS algatab uue muudatusnimekirja laadimise pöördudes uue \"\n\"järjekorranumbriga VIS3 vastava otspunkti poole. EHS võib varasemaid \"\n\"muudatusnimekirju uuesti pärida, kasutades varasemat järjekorranumbrit.\"\nmsgstr \"\"\n\"EHS initiates the loading of the new changelist by addressing the \"\n\"corresponding VIS3 endpoint with the new queue number. EHS may re-request\"\n\" previous changelists using the previous sequence number.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:77\nmsgid \"\"\n\"VIS3 saab muudatused Rahvastikuregistri X-tee teenusest. VIS3 poolne \"\n\"muudatuste hankimine on EHSile muudatuste esitamisest sõltumatu \"\n\"paralleelprotsess. See tähendab, et üks EHSile minev muudatusnimekiri \"\n\"võib sisaldada mitut Rahvastikuregistrist tulnud muudatust.\"\nmsgstr \"\"\n\"The VIS3 will receive changes from the X-Road service of the Population \"\n\"Register. The retrieval of amendments by VIS3 is a parallel process \"\n\"independent of the submission of amendments to the EHS. This means that a\"\n\" single list of changes going to the EHS may contain several changes \"\n\"coming from the Population Register.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:82\nmsgid \"Muudatusnimekirjade edastamine EHSi käib järgmiselt:\"\nmsgstr \"The transmission of the changelists to the ETS takes place as follows:\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:84\nmsgid \"EHS esitab päringu muudatusnimekirja saamiseks (samm 1)\"\nmsgstr \"EHS will submit a request for a change list (step 1).\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:85\nmsgid \"Kui muudatusi ei ole, siis ei ole ka muudatusnimekirja (samm 2)\"\nmsgstr \"If there are no changes, there is no changelist (step 2).\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:86\nmsgid \"\"\n\"EHS kordab mingi aja möödudes päringut muudatusnimekirja saamiseks (samm \"\n\"3)\"\nmsgstr \"EHS repeats the query after some time to get the changelist (step 3).\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:87\nmsgid \"\"\n\"VIS3 edastab vahepeal saabunud muudatused EHSile ning EHS rakendab need \"\n\"edukalt (sammud 4-5)\"\nmsgstr \"\"\n\"VIS3 forwards the changes that have arrived in the meantime to EHS and \"\n\"EHS successfully implements them (steps 4-5).\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:89\nmsgid \"\"\n\"Nii VIS3 kui EHS suurendavad muudatusnimekirjade järjekorranumbrit ning \"\n\"mõne aja möödudes edastatakse uus muudatusnimekiri (sammud 6-8)\"\nmsgstr \"\"\n\"Both VIS3 and EHS will increment the queue number of the changelists and \"\n\"after some time a new changelist will be transmitted (steps 6-8).\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:92\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:96\nmsgid \"**Märkused**\"\nmsgstr \"**Notes**\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:93\nmsgid \"\"\n\"Kui järjekorras järgmise muudatusnimekirja pärimisel muudatuskirjed \"\n\"puuduvad vastatakse HTTP staatusega `404` (not found).\"\nmsgstr \"\"\n\"If the next in the queue of changelists is queried and no changelists are\"\n\" found, the HTTP status `404` (not found) is returned.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:97\nmsgid \"\"\n\"Kui päritakse muudatusnimekirja suurema järjenumbriga, kui tegelik \"\n\"järgmise muudatusnimekirja järjenumber, vastatakse HTTP staatusega `409` \"\n\"(conflict).\"\nmsgstr \"\"\n\"If a changelist with a higher sequence number than the actual sequence \"\n\"number of the next changelist is received, HTTP status `409` (conflict) \"\n\"is returned.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:100\nmsgid \"2.4 Veajuhtumite lahendamine\"\nmsgstr \"Troubleshooting situations\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:102\nmsgid \"![Joonis 4: Veajuhtumite lahendamine](model/list_errors.png)\"\nmsgstr \"![Figure 4: Error handling](model/list_errors.png)\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:102\nmsgid \"Joonis 4: Veajuhtumite lahendamine\"\nmsgstr \"Figure 4: Error handling\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:104\nmsgid \"\"\n\"Muudatusnimekirjade edastamisel ei saa välistada vigu. Olenevalt vea \"\n\"iseloomust on võimalik taaste, keerulisematel juhtudel tuleb mõni \"\n\"vigaseks osutunud nimekiri vahele jätta. Veajuhtumi menetlemise ajal \"\n\"muudatusnimekirju ei edastata.\"\nmsgstr \"\"\n\"Errors cannot be excluded in the transmission of changelists. Depending \"\n\"on the nature of the error, it may be possible to revert, in more complex\"\n\" cases some lists that are found to contain errors should be skipped. No \"\n\"changelists will be forwarded during the processing of an error.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:109\nmsgid \"Veajuhtumite lahendamine toimub järgmiselt:\"\nmsgstr \"Error handling is as follows:\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:111\nmsgid \"\"\n\"EHS ja VIS3 käivitavad protokolli muudatusnimekirja edastamiseks (sammud \"\n\"1-3).\"\nmsgstr \"\"\n\"EHS and VIS3 will trigger a protocol for the transmission of the \"\n\"changelist (steps 1-3).\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:113\nmsgid \"\"\n\"EHS tunnistab nimekirja vigaseks ning teavitab sellest operaatorit (samm \"\n\"4).\"\nmsgstr \"EHS will declare the list as corrupt and inform the operator (step 4).\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:114\nmsgid \"\"\n\"Probleemi analüüsides tuvastatakse EHS-poolne tõrge, mida on võimalik \"\n\"lahendada. Tõrge lahendatakse ning EHS ja VIS3 kordavad edukalt \"\n\"protokolli (sammud 5-7).\"\nmsgstr \"\"\n\"Analysis of the problem identifies an EHS failure that can be resolved. \"\n\"The fault is resolved and EHS and VIS3 successfully replicate the \"\n\"protocol (steps 5-7).\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:117\nmsgid \"\"\n\"EHS ja VIS3 käivitavad protokolli muudatusnimekirja edastamiseks (sammud \"\n\"8-10).\"\nmsgstr \"\"\n\"EHS and VIS3 will trigger a protocol for the transmission of the \"\n\"changelist (steps 8-10).\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:119\nmsgid \"\"\n\"EHS tunnistab nimekirja vigaseks ning teavitab sellest operaatorit (samm \"\n\"11).\"\nmsgstr \"EHS will declare the list as corrupt and inform the operator (step 11).\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:121\nmsgid \"\"\n\"Probleemi analüüsides tuvastatakse sisuline probleem nimekirjas. Vigast \"\n\"nimekirja ei muudeta, luuakse uus korrektne nimekiri. EHS operaator laeb \"\n\"digitaalselt allkirjastatud korralduse vigase nimekirja vahele jätmiseks \"\n\"(samm 12)\"\nmsgstr \"\"\n\"Analysing the problem identifies a substantive problem with the list. The\"\n\" incorrect list is not modified, a new correct list is created. The EHS \"\n\"operator uploads a digitally signed order to skip the incorrect list \"\n\"(step 12).\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:125\nmsgid \"\"\n\"EHS ja VIS3 suurendavad järjekorranumbrit ning käivitavad protokolli \"\n\"muudatusnimekirja edastamiseks (sammud 13-15).\"\nmsgstr \"\"\n\"EHS and VIS3 increment the queue number and start a protocol to transmit \"\n\"the changelist (steps 13-15).\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:127\nmsgid \"\"\n\"EHS ja VIS3 suurendavad järjekorranumbrit ning käivitavad protokolli \"\n\"muudatusnimekirja edastamiseks (sammud 16-17). VIS3 vastab HTTP \"\n\"staatusega 409 (conflict).\"\nmsgstr \"\"\n\"EHS and VIS3 increment the queue number and start a protocol to transmit \"\n\"the changelist (steps 16-17). VIS3 responds with HTTP status 409 \"\n\"(conflict).\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:130\nmsgid \"\"\n\"EHS tuvastab vale järjenumbriga nimekirja laadimise ning teavitab sellest\"\n\" operaatorit (samm 18).\"\nmsgstr \"\"\n\"The EHS detects the loading of a list with the wrong sequence number and \"\n\"informs the operator (step 18).\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:132\nmsgid \"\"\n\"Tõrge lahendatakse ning EHS ja VIS3 kordavad edukalt protokolli (sammud \"\n\"19-21).\"\nmsgstr \"\"\n\"The failure is resolved and EHS and VIS3 successfully repeat the protocol\"\n\" (steps 19-21).\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:134\nmsgid \"2.5 Nimekirjade loendi edastamine\"\nmsgstr \"Transmission of the list of lists\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:136\nmsgid \"3. Nimekirja andmevorming\"\nmsgstr \"Data format of the list\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:138\nmsgid \"\"\n\"Nimekirja andmevorming on sama nii valijate algnimekirja kui \"\n\"muudatusnimekirjade jaoks.\"\nmsgstr \"\"\n\"The list data format is the same for both the initial list of voters and \"\n\"the amended lists.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:141\nmsgid \"\"\n\"Nimekiri esitatakse UTF-8-NOBOM vormingus tekstifailina. \"\n\"Andmestruktuuride eraldajaks kasutatakse reavahetusmärki `LF` (ASCII-kood\"\n\" `0x0A`). Andmestruktuuride väljade eraldajaks kasutatakse tabeldusmärki \"\n\"`TAB` (ASCII-kood `0x09`).\"\nmsgstr \"\"\n\"The list is presented as a UTF-8-NOBOM text file. The separator of the \"\n\"data structures shall be the space character `LF` (ASCII code `0x0A`). \"\n\"Fields of data structures shall be delimited by the tab delimiter `TAB` \"\n\"(ASCII code `0x09`).\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:146\nmsgid \"Nimekiri koosneb päiseridadest ja kirjetest.\"\nmsgstr \"The list consists of headers and entries.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:148\nmsgid \"Päiseridade sisu on järgmine:\"\nmsgstr \"The content of the headlines is as follows:\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:150\nmsgid \"\"\n\"`version` - andmestruktuuri versiooninumber, mille pikkus on piiratud 2 \"\n\"tähemärgiga. Spetsifikatsioonile vastava nimekirja korral on selle välja \"\n\"väärtus 2.\"\nmsgstr \"\"\n\"`version` - version number of the data structure, limited to 2 \"\n\"characters. For a specification conforming list, its field value is 2.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:153\nmsgid \"\"\n\"`election_identifier` - valimissündmuse identifikaator, mille pikkus on \"\n\"piiratud 28 tähemärgiga ASCII kooditabelist. Nimekirja rakendamine toimub\"\n\" ainult vastava identifikaatoriga valimissündmuse kontekstis. \"\n\"Valimissündmuse identifikaator peab vastama formaadile [Valimissündmuse \"\n\"identifikaator](../valimissündmuse_identifikaator.md).\"\nmsgstr \"\"\n\"`election_identifier` - election event identifier, limited to 28 \"\n\"characters from the ASCII code table. The implementation of the \"\n\"enumeration shall only take place in the context of an election event \"\n\"with the corresponding identifier. The election event identifier must \"\n\"conform to the format [Election event \"\n\"identifier](../valimissündmuse_identifikaator.md).\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:156\nmsgid \"\"\n\"`changeset` - nimekirja järjekorranumber. Rangelt kasvav number (0, 1, 2,\"\n\" ...), mis defineerib nimekirjade rakendamise järjekorra. Algnimekirja \"\n\"järjekorranumbriks on 0.\"\nmsgstr \"\"\n\"`changeset` - the sequence number of the list. An ordinal number (0, 1, \"\n\"2, ...) that defines the order in which lists are implemented. The queue \"\n\"number of the initial list is 0.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:159\nmsgid \"\"\n\"`period` - nimekirjas kajastuvate muudatuste ajavahemik. Esimene väli \"\n\"sisaldab perioodi algust, teine lõppu. Algnimekirja puhul on perioodi \"\n\"algus ja lõpu väärtused võrdsed. Väli on informatiivne.\"\nmsgstr \"\"\n\"`period` - the period of time of the changes in the list. The first field\"\n\" contains the start of the period, the second the end. In the case of a \"\n\"sub-list, the start and end values of the period are equal. The field is \"\n\"informative.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:163\nmsgid \"Kirje koosneb väljadest, mille sisu on järgmine:\"\nmsgstr \"The record consists of fields, the content of which is as follows:\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:165\nmsgid \"\"\n\"`person_code` - isikukood on valija unikaalne identifikaator, mille \"\n\"alusel EHS tuvastab isiku hääleõiguse ja ringkonnakuuluvuse.\"\nmsgstr \"\"\n\"`person_code` - the person code is the unique identifier of the voter, \"\n\"which EHS uses to determine the person's eligibility to vote and to be \"\n\"elected.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:167\nmsgid \"\"\n\"`voter_name` - valija nimi, informaalne väli, otsuste tegemisel ei \"\n\"kasutata.\"\nmsgstr \"\"\n\"`voter_name` - name of voter, informal field, not used for decision \"\n\"making.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:168\nmsgid \"\"\n\"`action` - kirjega seotud tegevus. `lisamine` tähendab uue valija \"\n\"lisamist ja `kustutamine` olemasoleva valija eemaldamist.\"\nmsgstr \"\"\n\"`action` - action related to an item. An `add' action is an action to add\"\n\" a new selector and a `delete' action is an action to remove an existing \"\n\"voter.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:170\nmsgid \"\"\n\"`kov_code` - haldusüksus, kuhu valija kuulub. Haldusüksuse \"\n\"identifitseerimiseks kasutatakse kohaliku omavalitsuse EHAK-koodi, \"\n\"Tallinna korral linnaosa EHAK-koodi, alaliselt välisriigis elava valija \"\n\"korral kasutatakse väärtust `FOREIGN`.\"\nmsgstr \"\"\n\"`kov_code` - the administrative unit to which the voter belongs. To \"\n\"identify the administrative unit, the EHAK code of the local municipality\"\n\" is used, in the case of Tallinn the EHAK code of the district, in the \"\n\"case of a voter permanently resident abroad the value `FOREIGN` is used.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:174\nmsgid \"\"\n\"`electoral_district_id` - valimisringkonna number identifitseerib \"\n\"valimisringkonna, kus valija hääletab. KOV valimiste korral kehtib \"\n\"identifikaator haldusüksuse sees. RK, EP ja RH valimiste korral on \"\n\"identifikaator haldusüksuste ülene.\"\nmsgstr \"\"\n\"`electoral_district_id` - the electoral district number identifies the \"\n\"electoral district where the voter votes. In the case of local elections,\"\n\" the identifier is valid within the municipality. In the case of CoR, EP \"\n\"and EPP elections, the identifier is supra-administrative.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:179\nmsgid \"\"\n\"Välju `voter_name`, `kov_code` ja `electoral_district_id` kasutatakse \"\n\"ainult lisamiskirjes (`action` väärtus `lisamine`).\"\nmsgstr \"\"\n\"The fields `voter_name`, `kov_code` and `electoral_district_id` are only \"\n\"used in the addition record (`action` value `add`).\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:182\nmsgid \"Andmevormingu formaalne kirjeldus Backus-Naur notatsioonis:\"\nmsgstr \"Formal description of the data format in Backus-Naur notation:\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:212\nmsgid \"3.1 Nimekirja tõlgendamine\"\nmsgstr \"Interpreting the list\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:214\nmsgid \"Nimekirju töötlev rakendus lähtub järgmistest reeglitest:\"\nmsgstr \"The application that processes the lists follows these rules:\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:216\nmsgid \"Nimekiri rakendatakse tervikuna.\"\nmsgstr \"The list will be implemented in its entirety.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:217\nmsgid \"\"\n\"Nimekirja rakendamisele eelnevad vormingu ja kooskõlalisuse kontrollid, \"\n\"vigaseid nimekirju ei rakendata.\"\nmsgstr \"\"\n\"The implementation of the list is preceded by formatting and consistency \"\n\"checks, and incorrect lists are not implemented.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:219\nmsgid \"Rakendus kontrollib nimekirja versiooni.\"\nmsgstr \"The application checks the version of the list.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:220\nmsgid \"Rakendus kontrollib valimissündmuse identifikaatorit.\"\nmsgstr \"The application checks the election event identifier.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:221\nmsgid \"Rakendus kontrollib nimekirja järjekorranumbrit.\"\nmsgstr \"The application checks the order number of the list.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:222\nmsgid \"\"\n\"Rakendus kontrollib nimekirja kõigi kirjete kooskõlalisust oma \"\n\"andmebaasiga.\"\nmsgstr \"\"\n\"The application checks the consistency of all the entries in the list \"\n\"with its database.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:223\nmsgid \"Kooskõlalisust kontrollitakse kirjete esinemisjärjekorras.\"\nmsgstr \"Coordination is checked in the order of occurrence of the records.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:224\nmsgid \"\"\n\"Kui tegevus on `lisamine`, siis ei tohi vastava isikukoodiga kirjet \"\n\"rakenduse andmebaasis olla.\"\nmsgstr \"\"\n\"If the activity is an `addition', then there must be no record with the \"\n\"corresponding ID in the application database.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:226\nmsgid \"\"\n\"Kui tegevus on `kustutamine`, siis rakendus kontrollib, kas vastava \"\n\"isikukoodiga kirje on rakenduse andmebaasis olemas. Kui ei ole, siis \"\n\"rakendus logib veateate ja jätkab järgmiste kirjete töötlust.\"\nmsgstr \"\"\n\"If the action is 'delete', the application will check if the \"\n\"corresponding record with the personal identification code exists in the \"\n\"application database. If not, the application logs an error message and \"\n\"continues processing the following records.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:229\nmsgid \"\"\n\"Kui valijaga soetud andmeid on vaja muuta, näiteks valija liigub ühest \"\n\"haldusüksusest või valimisringkonnast teise, siis kantakse valijate \"\n\"nimekirja muudatuste hulka üks kustutamise kirje, millega valija oma \"\n\"eelmisest üksusest kustutatakse ja üks lisamise kirje, millega valija \"\n\"uues üksuses valijate nimekirja lisatakse. Ka kõik teised muudatused \"\n\"valija andmetes - näiteks nimemuutus - toimuvad läbi vana kirje \"\n\"kustutamise ja uue lisamise.\"\nmsgstr \"\"\n\"If it is necessary to modify the voter's record, for example, if the \"\n\"voter moves from one municipality or constituency to another, a deletion \"\n\"entry to delete the voter from his/her previous unit and an addition \"\n\"entry to add the voter to the voter list in the new unit are included in \"\n\"the changes to the voter list. All other changes to the voter's details -\"\n\" such as a name change - are also made by deleting the old record and \"\n\"adding the new one.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:236\nmsgid \"\"\n\"Valijate algnimekirjas on ainult lisamiskirjed, iga valija kohta \"\n\"maksimaalselt üks kirje. Muudatusnimekirjas peavad ühe valija kohta \"\n\"käivad kirjed olema nimekirjas loogilises järjestuses ning liiasuseta. \"\n\"Ehk kustutamine enne lisamist ning maksimaalselt üks kustutamise-lisamise\"\n\" paar.\"\nmsgstr \"\"\n\"The initial list of voters contains only additions, with a maximum of one\"\n\" entry per voter. In the amendment list, the entries per voter must be in\"\n\" a logical order in the list and must not be redundant. Perhaps a \"\n\"deletion before an addition, and a maximum of one deletion-addition pair.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:241\nmsgid \"\"\n\"On võimalik, et valimise ajal muutub valija isikukood. Sellisel juhul \"\n\"lisatakse nimekirja vana isikukoodiga kustutamise kirje ning uue \"\n\"isikukoodiga lisamise kirje. Täiendav korduvhääletamise kontroll ei ole \"\n\"selle liidese skoobis ja teostakse VIS3 poolt eraldi.\"\nmsgstr \"\"\n\"It is possible that the voter's personal identification number will \"\n\"change during the election. In such a case, a deletion entry with the old\"\n\" ID will be added to the list, and an addition entry with the new ID will\"\n\" be added. The additional re-vote check is not in the scope of this \"\n\"interface and is performed separately by VIS3.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:247\nmsgid \"3.2 Näited nimekirjadest\"\nmsgstr \"Examples of lists\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:249\nmsgid \"Valijate algnimekiri, 0.\"\nmsgstr \"Initial list of voters, 0.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:267\nmsgid \"Muudatusnimekiri, 1:\"\nmsgstr \"List of changes, 1:\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:269\nmsgid \"Muutub valija 20000000002 haldusüksus.\"\nmsgstr \"Change the municipality of the voter 20000000002.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:270\nmsgid \"Valija 30000000003 kaotab hääleõiguse.\"\nmsgstr \"The voter 30000000003 loses the right to vote.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:271\nmsgid \"Valijale 11000000011 antakse hääleõigus.\"\nmsgstr \"The voter 11000000011 is given the right to vote.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:285\nmsgid \"Muudatusnimekiri, 2:\"\nmsgstr \"List of changes, 2:\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:287\nmsgid \"Muutub valija 20000000002 nimi.\"\nmsgstr \"The name of the website 20000000002 will change.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:288\nmsgid \"Valija 60000000006 kaotab hääleõiguse.\"\nmsgstr \"The voter 60000000006 loses the right to vote.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:300\nmsgid \"Muudatusnimekiri, 3:\"\nmsgstr \"List of changes, 3:\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:302\nmsgid \"Muutub valija 20000000003->10000000003 isikukood koos nimega.\"\nmsgstr \"\"\n\"The voter's 20000000003->10000000003 personal identification number will \"\n\"be changed together with the name.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:303\nmsgid \"Valija 60000000006 saab hääleõiguse.\"\nmsgstr \"The voter 60000000006 gets the right to vote.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:315\nmsgid \"4. Nimekirja signeerimine\"\nmsgstr \"Signing the list\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:317\nmsgid \"\"\n\"Nii algnimekirjaga kui muudatusnimekirjadega kaasatakse allkirjafail \"\n\"(FIPS 186-4), mille moodustab andmeallikas, arvutades algsest valijate \"\n\"nimekirjast SHA256-räsi ning allkirjastades selle räsi ECDSA võtmega \"\n\"(kasutame P-256 kõverat). Andmeallika poolt genereeritud avalik võti \"\n\"tehakse taustakanalis kättesaadavaks EHSile ning selle võtme alusel \"\n\"kontrollitakse EHS komponentides valijate nimekirjade terviklust.\"\nmsgstr \"\"\n\"Both the initial list and the changelists are accompanied by a signature \"\n\"file (FIPS 186-4), which is formed by the data source by computing the \"\n\"SHA256 hash from the initial voter list and signing this hash with the \"\n\"ECDSA key (we use the P-256 curve). The public key generated by the data \"\n\"source is made available in the background channel to the EHS and is used\"\n\" by the EHS components to verify the integrity of the voter lists.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:324\nmsgid \"\"\n\"Võtmete genereerimiseks, signeerimiseks ning verifitseerimiseks võib \"\n\"kasutada tööriista OpenSSL:\"\nmsgstr \"The OpenSSL tool can be used to generate, sign and verify keys:\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:327\nmsgid \"\"\n\"Võtme genereerimine: `openssl ecparam -name prime256v1 -genkey -noout \"\n\"-out private.key.pem`\"\nmsgstr \"\"\n\"Key generation: `openssl ecparam -name prime256v1 -genkey -noout -out \"\n\"private.key.pem`\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:329\nmsgid \"\"\n\"Avaliku võtme eraldamine: `openssl ec -in private.key.pem -pubout -out \"\n\"public.key.pem`\"\nmsgstr \"\"\n\"Public key extraction: `openssl ec -in private.key.pem -pubout -out \"\n\"public.key.pem`\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:331\nmsgid \"\"\n\"Andmefaili signeerimine: `openssl dgst -sha256 -sign private.key.pem -out\"\n\" data.sig data.txt`\"\nmsgstr \"\"\n\"Signing a data file: `openssl dgst -sha256 -sign private.key.pem -out \"\n\"data.sig data.txt`\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:333\nmsgid \"\"\n\"Signatuuri verifitseerimine: `openssl dgst -sha256 -verify public.key.pem\"\n\" -signature data.sig data.txt`\"\nmsgstr \"\"\n\"Signature verification: `openssl dgst -sha256 -verify public.key.pem \"\n\"-signature data.sig data.txt`\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:336\nmsgid \"\"\n\"Näide antud meetodi kasutamiseks golang keeles on leitav repositooriumis \"\n\"[DigiSign](https://github.com/e-gov/DigiSign)\"\nmsgstr \"\"\n\"An example of using this method in golang can be found in the repository \"\n\"[DigiSign](https://github.com/e-gov/DigiSign).\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:339\nmsgid \"5. Transpordiprotokoll\"\nmsgstr \"Transport protocol\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:341\nmsgid \"VIS3-EHS käesolev masinliides koosneb kahest API otspunktist.\"\nmsgstr \"This VIS3-EHS machine interface consists of two API endpoints.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:343\nmsgid \"\"\n\"API otspunkt `ehs-voters-changeset` konkreetse muudatusnimekirja \"\n\"laadimiseks VIS3-st\"\nmsgstr \"\"\n\"API endpoint `ehs-voters-changeset` to load a specific changelist from \"\n\"VIS3.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:345\nmsgid \"\"\n\"API otspunkt `ehs-list-election-changesets` ülevaate saamiseks \"\n\"avalikustatud nimekirjadest\"\nmsgstr \"\"\n\"API endpoint `ehs-list-election-changesets` for an overview of published \"\n\"lists\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:348\nmsgid \"\"\n\"Transpordiprotokoll on HTTPS, kuna volitamata ligipääs nimekirjadele \"\n\"tuleb tõkestada kasutatakse mõlemapoolselt autenditud TLS ühendusi.\"\nmsgstr \"\"\n\"The transport protocol is HTTPS, since unauthorised access to the lists \"\n\"must be blocked using mutually authenticated TLS connections.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:351\nmsgid \"5.1 `ehs-voters-changeset`\"\nmsgstr \"`ehs-voters-changeset`\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:353\nmsgid \"\"\n\"HTTP meetod on GET. Päringu tegemisel tuleb kasutada kohustuslikke \"\n\"parameetreid `changeset` ja `election_identifier`, kus\"\nmsgstr \"\"\n\"The HTTP method is GET. When making a query, you must use the mandatory \"\n\"parameters `changeset` and `election_identifier`, where\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:356\nmsgid \"`changeset` on muudatusnimekirja `integer` tüüpi järjekorranumber.\"\nmsgstr \"`changeset` is the `integer` type sequence number of the changelist.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:357\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:379\nmsgid \"`election_identifier` on `string` tüüpi valimissündmuse identifikaator.\"\nmsgstr \"\"\n\"`election_identifier` is an identifier of type `string` for an election \"\n\"event.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:359\nmsgid \"\"\n\"Kui EHS teeb API otspunkti GET päringu, siis juhul kui vastava \"\n\"identifikaatori ja järjekorranumbriga nimekiri eksisteerib, vastab VIS3 \"\n\"`application/octet-stream` tüüpi baidijadaga, mis esitab kahest failist \"\n\"koosnevat ZIP konteinerit:\"\nmsgstr \"\"\n\"When the EHS makes an API endpoint GET request, if a list with the \"\n\"corresponding identifier and sequence number exists, VIS3 will respond \"\n\"with a `application/octet-stream` type byte string representing a ZIP \"\n\"container of two files:\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:364\nmsgid \"nimekirjafail nimega `-voters-.utf`\"\nmsgstr \"listfile named `-voters-.utf`\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:366\nmsgid \"signatuurifail nimega `election_identifier<>-voters-.sig`\"\nmsgstr \"signature file named `election_identifier<>-voters-.sig`\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:369\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:414\nmsgid \"Sellise vastuse korral on HTTP status 200.\"\nmsgstr \"The HTTP status for this response is 200.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:371\nmsgid \"\"\n\"Juhul kui vastava järjekorranumbriga muudatusnimekirja veel ei eksisteeri\"\n\" antakse vastuses HTTP status 404.\"\nmsgstr \"\"\n\"If the corresponding changelist with the corresponding queue number does \"\n\"not yet exist, the HTTP status 404 is returned.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:374\nmsgid \"5.1 `ehs-list-election-changesets`\"\nmsgstr \"`ehs-list-election-changesets`\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:376\nmsgid \"\"\n\"HTTP meetod on GET. Päringu tegemisel tuleb kasutada kohustuslikku \"\n\"parameetrit `election_identifier`:\"\nmsgstr \"\"\n\"The HTTP method is GET. When making a query, the mandatory \"\n\"`election_identifier` parameter must be used:\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:381\nmsgid \"\"\n\"Kui EHS teeb API otspunkti, siis juhul kui vastava identifikaatoriga \"\n\"valimine eksisteerib, vastab VIS3 `application/json` tüüpi baidijadaga, \"\n\"mis sisaldab endas JSON vormingus viiteid kõigile väljastatud \"\n\"muudatusnimekirjadele.\"\nmsgstr \"\"\n\"When EHS makes an API endpoint, if a election with the corresponding \"\n\"identifier exists, VIS3 will respond with a `application/json` type byte \"\n\"string containing JSON format references to all issued changelists.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:385\nmsgid \"\"\n\"MÄRKUS. Viidetes tarnitavad URL-id ei ole õiged ja seetõttu \"\n\"mittekasutatavad. EHS peab konkreetse muudatuste nimekirja poole \"\n\"pöördumise URL-i koostama vastavalt VIS3 EHS API OpenAPI vormingus \"\n\"spetsifikatsioonile (asub käesolevas repos, failis `vis3-ehs-api.yaml`). \"\n\"VIS3 edasisestes versioonides eemaldame viidetest URL-id. 20.07.2021.\"\nmsgstr \"\"\n\"NOTE. The URLs supplied in the references are not correct and therefore \"\n\"cannot be used. The URL to a specific changelist must be generated by EHS\"\n\" according to the VIS3 EHS API OpenAPI format specification (located in \"\n\"this repo, in the file `vis3-ehs-api.yaml`). In future versions of VIS3, \"\n\"we will remove URLs from the references. 20.07.2021.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:387\nmsgid \"\"\n\"MÄRKUS. Viidetes tarnitavate URL-de käsitlust muudetud: elemendis `url` \"\n\"tarnitakse mitte täis-URL, vaid ainult _path_ ja -query_ osa.\"\nmsgstr \"\"\n\"NOTE. Changed the handling of URLs supplied in references: the `url` \"\n\"element does not supply the full URL, but only the _path_ and -query_ \"\n\"parts.\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:416\nmsgid \"6. Näited\"\nmsgstr \"Examples\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:418\nmsgid \"7. Viited\"\nmsgstr \"References\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:420\nmsgid \"\"\n\"[\\\"DigiSign\\\" - lihtne protokoll edastatavate failide allkirjastamiseks, \"\n\"koos teostusnäitega](https://github.com/e-gov/DigiSign)\"\nmsgstr \"\"\n\"[\\\"DigiSign\\\" - a simple protocol for signing files in transit, with \"\n\"examples](https://github.com/e-gov/DigiSign)\"\n\n" }, { "path": "Documentation/public/liidesed/locales/en/LC_MESSAGES/VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2024, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\n#, fuzzy\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.9.1\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2024-02-29 10:34+0200\\n\"\n\"PO-Revision-Date: 2024-03-02 13:44+0200\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: en \\n\"\n\"Language: en\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"Generated-By: Babel 2.10.3\\n\"\n\"X-Generator: Poedit 3.4.2\\n\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:1\nmsgid \"E-hääletanute nimekiri\"\nmsgstr \"List of e-voters\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:3\nmsgid \"Protseduur\"\nmsgstr \"Procedure\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:5\nmsgid \"\"\n\"E-hääletanute nimekiri on pärast e-hääletamise lõppu EHS poolt genereeritav \"\n\"ja väljastatav nimekiri e-hääletanud isikutest. E-hääletanute nimekiri \"\n\"loetakse sisse VIS3-e (moodul NIM).\"\nmsgstr \"\"\n\"The e-vote list is the list of e-voters generated and issued by EHS after \"\n\"the end of e-voting. The list of e-voters shall be read into VIS3 (module \"\n\"NIM).\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:7\nmsgid \"E-hääletanute nimekiri edastakse inim-masin-protseduuriga:\"\nmsgstr \"The list of e-voters is transmitted by human-machine procedure:\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:9\nmsgid \"EHS operaator laeb JSON-faili EHS-st alla;\"\nmsgstr \"The EHS operator downloads the JSON file from the EHS;\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:11\nmsgid \"\"\n\"EHS operaator allkirjastab faili digitaalselt väljaspool EHS-i ja annab \"\n\"selle VIS peakasutajale;\"\nmsgstr \"\"\n\"The EHS operator digitally signs the file outside the EHS and gives it to \"\n\"the VIS head user;\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:13\nmsgid \"VIS peakasutaja laeb digikonteinerist välja võetud faili VIS3-i.\"\nmsgstr \"\"\n\"The VIS head user uploads the file taken from the digital container to VIS3.\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:15\nmsgid \"Fail on JSON-formaadis. Faili näidised on tööülesandes.\"\nmsgstr \"The file is in JSON format. File examples are in the appendix.\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:17\nmsgid \"Faili struktuur on kirjeldatud JSON-skeemiga.\"\nmsgstr \"The file structure is described by a JSON schema.\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:19\nmsgid \"Edastatav fail\"\nmsgstr \"Transmitted file\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:21\nmsgid \"\"\n\"Aluseks on EHS senine liides VIS2-ga, mis on spetsifitseeritud dokumendis \"\n\"\\\"IVXV protokollide kirjeldus\\\" (v 1.5.0, IVXV-PR-1.5.0, 20.04.2019), \"\n\"[https://www.valimised.ee/sites/default/files/uploads/eh/IVXV-protokollid.\"\n\"pdf](https://www.valimised.ee/sites/default/files/uploads/eh/IVXV-\"\n\"protokollid.pdf), jaotises \\\"E-hääletanute nimekiri\\\" (jaotis 9.2).\"\nmsgstr \"\"\n\"It is based on the current interface of the EHS with VIS2, as specified in \"\n\"the document \\\"Description of the IVXV protocols\\\" (v 1.5.0, IVXV-PR-1.5.0, \"\n\"20.04.2019), [https://www.valimised.ee/sites/default/files/uploads/eh/IVXV-\"\n\"protokollid.pdf](https://www.valimised.ee/sites/default/files/uploads/eh/\"\n\"IVXV-protokollid.pdf), section \\\"E-voting list\\\" (section 9.2).\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:23\nmsgid \"\"\n\"Faili struktuur (JSON-skeem): [onlinevoters.schema](onlinevoters.schema)\"\nmsgstr \"\"\n\"File structure (JSON schema): [onlinevoters.schema](onlinevoters.schema)\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:25\nmsgid \"\"\n\"Valimissündmuse identifikaator peab vastama formaadile [Valimissündmuse \"\n\"identifikaator](../valimissündmuse_identifikaator.md).\"\nmsgstr \"\"\n\"The election event identifier must conform to the format [Election event \"\n\"identifier](../valimissündmuse_identifikaator.md).\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:27\nmsgid \"Faili näited (JSON):\"\nmsgstr \"File examples (JSON):\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:29\nmsgid \"[onlinevoters_EP.json](onlinevoters_EP.json)\"\nmsgstr \"[onlinevoters_EP.json](onlinevoters_EP.json)\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:30\nmsgid \"[onlinevoters_KOV.json](onlinevoters_KOV.json)\"\nmsgstr \"[onlinevoters_KOV.json](onlinevoters_KOV.json)\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:31\nmsgid \"[onlinevoters_RH.json](onlinevoters_RH.json)\"\nmsgstr \"[onlinevoters_RH.json](onlinevoters_RH.json)\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:32\nmsgid \"[onlinevoters_RK.json](onlinevoters_RK.json)\"\nmsgstr \"[onlinevoters_RK.json](onlinevoters_RK.json)\"\n" }, { "path": "Documentation/public/liidesed/locales/en/LC_MESSAGES/VIS3-EHS/5_Tyhistusnimekiri/SPEC.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2024, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\n#, fuzzy\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.9.1\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2024-02-29 10:34+0200\\n\"\n\"PO-Revision-Date: 2024-03-02 13:46+0200\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: en \\n\"\n\"Language: en\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"Generated-By: Babel 2.10.3\\n\"\n\"X-Generator: Poedit 3.4.2\\n\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:1\nmsgid \"5 Tühistus- ja ennistusnimekiri\"\nmsgstr \"5 Revokation and Restoration list\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:3\nmsgid \"\"\n\"VIS3 edastab EHS-le tühistus- ja ennistusnimekirja (lühidalt - \"\n\"tühistusnimekiri).\"\nmsgstr \"\"\n\"VIS3 transmits to the EHS the revocation and restoration list (in short - \"\n\"the revokation list).\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:5\nmsgid \"\"\n\"Tühistusnimekiri sisaldab andmeid isikute kohta, kelle e-hääl tuleb \"\n\"tühistada (on paberhääletanud ja sellest tulenevalt ei lähe e-hääl arvesse \"\n\"valimistulemuste kokkulugemisel) või ennistada (s.t. tühistatakse eelnev \"\n\"tühistamine ning häälte uuesti üle lugemisel võetakse ennistatud e-hääl \"\n\"arvesse).\"\nmsgstr \"\"\n\"The revokation list contains the details of persons whose e-vote is to be \"\n\"cancelled (they have voted by paper ballot and therefore their e-vote will \"\n\"not be counted in the recount) or restored (i.e. the previous revokation is \"\n\"cancelled and the restored e-vote is counted in the tally).\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:7\nmsgid \"Fail on JSON-formaadis.\"\nmsgstr \"The file is in JSON format.\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:9\nmsgid \"Protseduur\"\nmsgstr \"Procedure\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:11\nmsgid \"Tühistusnimekiri edastakse inim-masin-protseduuriga:\"\nmsgstr \"The revokation list is transmitted by human-machine procedure:\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:13\nmsgid \"EHS operaator laeb JSON-faili EHS-st alla;\"\nmsgstr \"The EHS operator downloads the JSON file from the EHS;\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:15\nmsgid \"\"\n\"EHS operaator allkirjastab faili digitaalselt väljaspool EHS-i ja annab \"\n\"selle VIS peakasutajale;\"\nmsgstr \"\"\n\"The EHS operator digitally signs the file outside the EHS and gives it to \"\n\"the VIS head user;\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:17\nmsgid \"VIS peakasutaja laeb digikonteinerist välja võetud faili VIS3-i.\"\nmsgstr \"\"\n\"The VIS head user uploads the file taken from the digital container to VIS3.\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:19\nmsgid \"Edastatav fail\"\nmsgstr \"Transmitted file\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:21\nmsgid \"\"\n\"Aluseks on EHS senine liides VIS2-ga, mis on spetsifitseeritud dokumendis \"\n\"\\\"IVXV protokollide kirjeldus\\\" (v 1.5.0, IVXV-PR-1.5.0, 20.04.2019), \"\n\"[https://www.valimised.ee/sites/default/files/uploads/eh/IVXV-protokollid.\"\n\"pdf](https://www.valimised.ee/sites/default/files/uploads/eh/IVXV-\"\n\"protokollid.pdf), jaotises \\\"Tühistus- ja ennistusnimekiri\\\" (jaotis 9.1).\"\nmsgstr \"\"\n\"It is based on the EHS current interface with VIS2, as specified in the \"\n\"document \\\"Description of the IVXV Protocols\\\" (v 1.5.0, IVXV-PR-1.5.0, \"\n\"20.04.2019), [https://www.valimised.ee/sites/default/files/uploads/eh/IVXV-\"\n\"protokollid.pdf](https://www.valimised.ee/sites/default/files/uploads/eh/\"\n\"IVXV-protokollid.pdf), section \\\"Cancellation and Restoration \"\n\"List\\\" (section 9.1).\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:23\nmsgid \"\"\n\"Valimissündmuse identifikaator peab vastama formaadile [Valimissündmuse \"\n\"identifikaator](../valimissündmuse_identifikaator.md).\"\nmsgstr \"\"\n\"The election event identifier must conform to the format [Election event \"\n\"identifier](../valimissündmuse_identifikaator.md).\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:25\nmsgid \"Faili struktuur (JSON-skeem): [revoke.schema](revoke.schema)\"\nmsgstr \"File structure (JSON schema): [revoke.schema](revoke.schema)\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:27\nmsgid \"Faili näited (JSON):\"\nmsgstr \"File examples (JSON):\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:29\nmsgid \"[revoke_EP.json](revoke_EP.json)\"\nmsgstr \"[revoke_EP.json](revoke_EP.json)\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:30\nmsgid \"[revoke_KOV.json](revoke_KOV.json)\"\nmsgstr \"[revoke_KOV.json](revoke_KOV.json)\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:31\nmsgid \"[revoke_RH.json](revoke_RH.json)\"\nmsgstr \"[revoke_RH.json](revoke_RH.json)\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:32\nmsgid \"[revoke_RK.json](revoke_RK.json)\"\nmsgstr \"[revoke_RK.json](revoke_RK.json)\"\n" }, { "path": "Documentation/public/liidesed/locales/en/LC_MESSAGES/VIS3-EHS/6_e_haaletamise_tulemus/SPEC.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2024, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\n#, fuzzy\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.9.1\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2024-02-29 10:34+0200\\n\"\n\"PO-Revision-Date: 2024-03-02 13:47+0200\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: en \\n\"\n\"Language: en\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"Generated-By: Babel 2.10.3\\n\"\n\"X-Generator: Poedit 3.4.2\\n\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:1\nmsgid \"E-hääletamise tulemus\"\nmsgstr \"Result of e-voting\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:3\nmsgid \"\"\n\"E-hääletamise lõppedes genereerib EHS e-hääletamise tulemuste faili \"\n\"(hääletamistulemuse fail). Fail laetakse VIS3-e (valimistulemuse moodulisse \"\n\"TUL).\"\nmsgstr \"\"\n\"At the end of the e-voting, the EHS generates an e-voting results file \"\n\"(voting result file). The file is uploaded to VIS3 (in the election result \"\n\"module TUL).\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:5\nmsgid \"Protseduur\"\nmsgstr \"Procedure\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:7\nmsgid \"Fail edastatakse inim-masin-protseduuriga:\"\nmsgstr \"The file is transmitted by human-machine procedure:\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:9\nmsgid \"EHS operaator laeb JSON-faili EHS-st alla;\"\nmsgstr \"The EHS operator downloads the JSON file from the EHS;\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:11\nmsgid \"\"\n\"EHS operaator allkirjastab faili digitaalselt väljaspool EHS-i ja annab \"\n\"selle VIS peakasutajale;\"\nmsgstr \"\"\n\"The EHS operator digitally signs the file outside the EHS and gives it to \"\n\"the VIS head user;\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:13\nmsgid \"VIS peakasutaja laeb digikonteinerist välja võetud faili VIS3-i.\"\nmsgstr \"\"\n\"The VIS head user uploads the file taken from the digital container to VIS3.\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:15\nmsgid \"Fail on JSON-formaadis.\"\nmsgstr \"The file is in JSON format.\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:17\nmsgid \"Edastatav fail\"\nmsgstr \"Transmitted file\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:19\nmsgid \"\"\n\"Aluseks on EHS senine liides VIS2-ga, mis on spetsifitseeritud dokumendis \"\n\"\\\"IVXV protokollide kirjeldus\\\" (v 1.5.0, IVXV-PR-1.5.0, 20.04.2019), \"\n\"[https://www.valimised.ee/sites/default/files/uploads/eh/IVXV-protokollid.\"\n\"pdf](https://www.valimised.ee/sites/default/files/uploads/eh/IVXV-\"\n\"protokollid.pdf), jaotises \\\"E-hääletamise tulemus\\\" (jaotis 9.3).\"\nmsgstr \"\"\n\"It is based on the current interface of the EHS with VIS2, as specified in \"\n\"the document \\\"Description of the IVXV protocols\\\" (v 1.5.0, IVXV-PR-1.5.0, \"\n\"20.04.2019), [https://www.valimised.ee/sites/default/files/uploads/eh/IVXV-\"\n\"protokollid.pdf](https://www.valimised.ee/sites/default/files/uploads/eh/\"\n\"IVXV-protokollid.pdf), section \\\"E-voting result\\\" (section 9.3).\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:21\nmsgid \"\"\n\"Valimissündmuse identifikaator peab vastama formaadile [Valimissündmuse \"\n\"identifikaator](../valimissündmuse_identifikaator.md).\"\nmsgstr \"\"\n\"The election event identifier must conform to the format [Election event \"\n\"identifier](../valimissündmuse_identifikaator.md).\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:23\nmsgid \"Faili struktuur (JSON-skeem): [results.schema](results.schema)\"\nmsgstr \"File structure (JSON schema): [results.schema](results.schema)\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:25\nmsgid \"Faili näited (JSON):\"\nmsgstr \"File examples (JSON):\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:27\nmsgid \"[results_EP.json](results_EP.json)\"\nmsgstr \"[results_EP.json](results_EP.json)\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:28\nmsgid \"[results_KOV.json](results_KOV.json)\"\nmsgstr \"[results_KOV.json](results_KOV.json)\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:29\nmsgid \"[results_RH.json](results_RH.json)\"\nmsgstr \"[results_RH.json](results_RH.json)\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:30\nmsgid \"[results_RK.json](results_RK.json)\"\nmsgstr \"[results_RK.json](results_RK.json)\"\n" }, { "path": "Documentation/public/liidesed/locales/en/LC_MESSAGES/VIS3-EHS/7_e_haaletamise_yldstatistika/SPEC.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2024, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\n#, fuzzy\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.9.1\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2024-02-29 10:34+0200\\n\"\n\"PO-Revision-Date: 2024-03-02 13:48+0200\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: en \\n\"\n\"Language: en\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"Generated-By: Babel 2.10.3\\n\"\n\"X-Generator: Poedit 3.4.2\\n\"\n\n#: ../../VIS3-EHS/7_e_haaletamise_yldstatistika/SPEC.md:1\nmsgid \"7 E-hääletamisest osavõtu üldstatistika\"\nmsgstr \"General statistics on participation in e-voting\"\n\n#: ../../VIS3-EHS/7_e_haaletamise_yldstatistika/SPEC.md:3\nmsgid \"\"\n\"EHS annab lühikese perioodiga (nt 15 min) VIS3-le andmeid kui palju \"\n\"valijaid on e-hääletanud.\"\nmsgstr \"\"\n\"The EHS will provide VIS3 with information on how many voters have e-voted \"\n\"in a short period of time (e.g. 15 min).\"\n\n#: ../../VIS3-EHS/7_e_haaletamise_yldstatistika/SPEC.md:5\nmsgid \"EHS teeb seda HTTPS päringutega VIS3 poolt pakutava otspunkti vastu.\"\nmsgstr \"\"\n\"EHS does this by HTTPS requests against the endpoint provided by VIS3.\"\n\n#: ../../VIS3-EHS/7_e_haaletamise_yldstatistika/SPEC.md:7\nmsgid \"Päringu vastuses tagastatav fail:\"\nmsgstr \"The file to be returned in response to the query:\"\n\n#: ../../VIS3-EHS/7_e_haaletamise_yldstatistika/SPEC.md:9\nmsgid \"JSON-skeem: [online-voters-total.schema](online-voters-total.schema)\"\nmsgstr \"JSON schema: [online-voters-total.schema](online-voters-total.schema)\"\n\n#: ../../VIS3-EHS/7_e_haaletamise_yldstatistika/SPEC.md:11\nmsgid \"\"\n\"Valimissündmuse identifikaator peab vastama formaadile [Valimissündmuse \"\n\"identifikaator](../valimissündmuse_identifikaator.md).\"\nmsgstr \"\"\n\"The election event identifier must conform to the format [Election event \"\n\"identifier](../valimissündmuse_identifikaator.md).\"\n\n#: ../../VIS3-EHS/7_e_haaletamise_yldstatistika/SPEC.md:13\nmsgid \"Näide (JSON): [online-voters-total.json](online-voters-total.json)\"\nmsgstr \"Example (JSON): [online-voters-total.json](online-voters-total.json)\"\n" }, { "path": "Documentation/public/liidesed/locales/en/LC_MESSAGES/VIS3-EHS/8_e_haaletamise_detailstatistika/SPEC.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2024, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\n#, fuzzy\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.9.1\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2024-02-29 10:34+0200\\n\"\n\"PO-Revision-Date: 2024-03-02 13:49+0200\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: en \\n\"\n\"Language: en\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"Generated-By: Babel 2.10.3\\n\"\n\"X-Generator: Poedit 3.4.2\\n\"\n\n#: ../../VIS3-EHS/8_e_haaletamise_detailstatistika/SPEC.md:1\nmsgid \"8 E-hääletamisest osavõtu detailne statistika\"\nmsgstr \"Detailed statistics on participation in e-voting\"\n\n#: ../../VIS3-EHS/8_e_haaletamise_detailstatistika/SPEC.md:3\nmsgid \"\"\n\"E-hääletamise lõppedes annab EHS VIS3-le e-hääletamisest osavõtu detailse \"\n\"statistika.\"\nmsgstr \"\"\n\"At the end of e-voting, EHS will provide VIS3 with detailed statistics on \"\n\"e-voting participation.\"\n\n#: ../../VIS3-EHS/8_e_haaletamise_detailstatistika/SPEC.md:5\nmsgid \"\"\n\"E-hääletamisest osavõtu statistikat kuvatakse valimiste veebilehel, samuti \"\n\"edastatakse masintöödeldaval kujul meediaorganisatsioonidele ja lõpuks \"\n\"publitseeritakse avaandmetena.\"\nmsgstr \"\"\n\"The e-voting statistics will be displayed on the election website, as well \"\n\"as being provided in a machine-readable format to media organisations and \"\n\"eventually published as open data.\"\n\n#: ../../VIS3-EHS/8_e_haaletamise_detailstatistika/SPEC.md:7\nmsgid \"Protseduur\"\nmsgstr \"Procedure\"\n\n#: ../../VIS3-EHS/8_e_haaletamise_detailstatistika/SPEC.md:9\nmsgid \"EHS operaator laeb faili alla.\"\nmsgstr \"The EHS operator downloads the file.\"\n\n#: ../../VIS3-EHS/8_e_haaletamise_detailstatistika/SPEC.md:11\nmsgid \"EHS operaator edastab faili VIS3 peakasutajale.\"\nmsgstr \"The EHS operator forwards the file to the VIS3 head user.\"\n\n#: ../../VIS3-EHS/8_e_haaletamise_detailstatistika/SPEC.md:13\nmsgid \"VIS3 peakasutaja laeb faili VIS3-e üles.\"\nmsgstr \"The VIS3 head user uploads the file to VIS3.\"\n\n#: ../../VIS3-EHS/8_e_haaletamise_detailstatistika/SPEC.md:15\nmsgid \"Faili edastatakse eelhääletamise ajal, kord päevas.\"\nmsgstr \"The file will be transmitted during the advance voting, once a day.\"\n\n#: ../../VIS3-EHS/8_e_haaletamise_detailstatistika/SPEC.md:17\nmsgid \"Edastatav fail\"\nmsgstr \"Transmitted file\"\n\n#: ../../VIS3-EHS/8_e_haaletamise_detailstatistika/SPEC.md:19\nmsgid \"\"\n\"JSON-skeem: [online-voters-counties.schema](online-voters-counties.schema)\"\nmsgstr \"\"\n\"JSON-skeem: [online-voters-counties.schema](online-voters-counties.schema)\"\n\n#: ../../VIS3-EHS/8_e_haaletamise_detailstatistika/SPEC.md:21\nmsgid \"\"\n\"Valimissündmuse identifikaator peab vastama formaadile [Valimissündmuse \"\n\"identifikaator](../valimissündmuse_identifikaator.md).\"\nmsgstr \"\"\n\"The polling event identifier must conform to the format [Polling event \"\n\"identifier](../polling_event_identifier.md).\"\n\n#: ../../VIS3-EHS/8_e_haaletamise_detailstatistika/SPEC.md:23\nmsgid \"\"\n\"Näide (JSON): [online-voters-counties.json](online-voters-counties.json)\"\nmsgstr \"\"\n\"Example (JSON): [online-voters-counties.json](online-voters-counties.json)\"\n" }, { "path": "Documentation/public/liidesed/locales/en/LC_MESSAGES/VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2024, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\n#, fuzzy\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.9.1\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2024-02-29 10:34+0200\\n\"\n\"PO-Revision-Date: 2024-03-02 13:55+0200\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: en \\n\"\n\"Language: en\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"Generated-By: Babel 2.10.3\\n\"\n\"X-Generator: Poedit 3.4.2\\n\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:1\nmsgid \"E-hääletamiste nimekiri\"\nmsgstr \"List of e-votes\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:3\nmsgid \"kavand v0.4\"\nmsgstr \"draft v0.4\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:5\nmsgid \"Muutelugu\"\nmsgstr \"Migration story\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:7\nmsgid \"Eemaldatud sõna \\\"jooksev\\\" / Priit Parmakson, 23.11.2022\"\nmsgstr \"Removed the word \\\"current\\\" / Priit Parmakson, 23.11.2022\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:8\nmsgid \"\"\n\"Lisatud OpenAPI kirjelduse publitseerimise teave. / Priit Parmakson, \"\n\"13.12.2022\"\nmsgstr \"\"\n\"Added information on the publication of the OpenAPI specification / Priit \"\n\"Parmakson, 13.12.2022\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:9\nmsgid \"\"\n\"Täpsustatud e-hääletamiste väljanäitamist VIS3-s. / Priit Parmakson, \"\n\"15.11.2022\"\nmsgstr \"\"\n\"The e-voting field in VIS3 has been specified. / Priit Parmakson, 15.11.2022\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:10\nmsgid \"Lisatud jõudluskaalutlused. / Priit Parmakson, 01.11.2022\"\nmsgstr \"Performance scales added / Priit Parmakson, 01.11.2022\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:11\nmsgid \"\"\n\"Asendatud \\\"e-hääletanu\\\" -> \\\"e-hääletamine\\\". Põhjus: inimene võib e-\"\n\"hääletada mitu korda (ümberhääletamine); vastavalt korrigeeritud JSON \"\n\"väljanimesid \\\"evotersbatch\\\" -> \\\"evotingsbatch\\\". / Priit Parmakson, \"\n\"01.09.2022\"\nmsgstr \"\"\n\"Replaced \\\"e-vote\\\" -> \\\"e-voting\\\". Reason: a person can e-vote multiple \"\n\"times (re-vote); corrected JSON field names \\\"evotersbatch\\\" -> \"\n\"\\\"evotingsbatch\\\" accordingly. / Priit Parmakson, 01.09.2022\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:12\nmsgid \"\"\n\"Eemaldatud: hääletamise kuupäeva/aja edastamine. Põhjus: turvakaalutlus \"\n\"(häälemüügi takistamine). / Priit Parmakson, 01.09.2022 (Sven Heibergiga \"\n\"arutelu alusel)\"\nmsgstr \"\"\n\"Removed: transmission of voting date/time. Reason: security considerations \"\n\"(to prevent the sale of votes) / Priit Parmakson, 01.09.2022 (in discussion \"\n\"with Sven Heiberg).\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:13\nmsgid \"\"\n\"Lisatud: 1) ärivajaduse täpsustus; 2) e-hääletamise fakti aja edastamine; 3) \"\n\"edastuse kontroll ja vajadusel täiendamine või parandamine lõpliku faili \"\n\"abil. / Priit Parmakson, 04.05.2022\"\nmsgstr \"\"\n\"Attached: 1) specification of the business need; 2) transmission of the e-\"\n\"voting fact time; 3) checking of the transmission and, if necessary, \"\n\"completion or correction by means of the final file / Priit Parmakson, \"\n\"04.05.2022\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:14\nmsgid \"Arutelu - RVT ja RIA inimesed, 04.05.2022\"\nmsgstr \"Debate - RVT and RIA people, 04.05.2022\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:15\nmsgid \"\"\n\"\\\"E-hääletanute jooksev nimekiri\\\", kavand v0.2. / Priit Parmakson, 02.05.2022\"\nmsgstr \"\\\"Rolling list of e-voters\\\", draft v0.2. / Priit Parmakson, 02.05.2022\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:16\nmsgid \"Arutelu: X-tee kasutamine, JSON - Tarmo Hanga, Priit Parmakson, apr 2022\"\nmsgstr \"Discussion: using X-tee, JSON - Tarmo Hanga, Priit Parmakson, Apr 2022\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:17\nmsgid \"\\\"EHS- VIS3 liidestus\\\" (kavand) - Indrek Leesi, apr 2022\"\nmsgstr \"\\\"EHS- VIS3 interface\\\" (draft) - Indrek Leesi, Apr 2022\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:19\nmsgid \"Ülevaade\"\nmsgstr \"Overview\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:21\nmsgid \"\"\n\"Käesolev spetsifikatsioon määratleb protokolli e-hääletamiste nimekirja \"\n\"edastamiseks e-hääletamise süsteemist (edaspidi - EHS) Valimiste infosüsteemi \"\n\"(edaspidi - VIS3).\"\nmsgstr \"\"\n\"This specification defines the protocol for the transfer of the list of e-\"\n\"votes from the e-voting system (hereinafter referred to as EHS) to the \"\n\"Election Information System (hereinafter referred to as VIS3).\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:23\nmsgid \"\"\n\"Varasematel valimistel (k.a KOV 2021) on peale hääletamise lõppu, \"\n\"valimispäeval edastatud EHS-st VIS3-le e-hääletanute nimekiri (edaspidi - e-\"\n\"hääletanute lõplik nimekiri). See edastus on spetsifitseeritud: [E-\"\n\"hääletanute nimekiri](https://github.com/e-gov/VIS3-EHS/blob/\"\n\"main/4_e_haaletanute_nimekiri/SPEC.md).\"\nmsgstr \"\"\n\"In previous elections (including Municipal elections 2021), the list of e-\"\n\"voters (hereafter referred to as the final list of e-voters) has been \"\n\"transmitted from the EHS to VIS3 after the end of voting on the day of the \"\n\"election. This transmission is specified in [e-vote list](https://github.com/\"\n\"e-gov/VIS3-EHS/blob/main/4_e_haaletanute_nimekiri/SPEC.md).\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:25\nmsgid \"\"\n\"Siiski on vajadus VIS3-s saada teavet, kas valija on e-hääletanud, juba enne \"\n\"ülalnimetatud lõplikku edastust. Valija, kes on e-hääletanud, võib tulla \"\n\"eelhääletamise perioodil valimisjaoskonda ja soovida paberil hääletada. \"\n\"Valimisjaoskonna töötajal oleks hea omada võimalust VIS3-st vaadata, kas \"\n\"valija on e-hääletanud. Seda teavet saab muuhulgas kasutada valija \"\n\"hoiatamiseks, et paberhääletamisega tema e-hääletamine tühistub.\"\nmsgstr \"\"\n\"However, there is a need to obtain information in VIS3 on whether the voter \"\n\"has e-voted, even before the final transmission mentioned above. A voter who \"\n\"has e-voted may come to a polling station during the early voting period and \"\n\"wish to vote by paper ballot. It would be useful for the polling station \"\n\"staff to have the possibility to check in VIS3 whether the voter has e-voted. \"\n\"This information can be used, among other things, to warn the voter that his/\"\n\"her e-vote will be cancelled if he/she votes by paper ballot.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:27\nmsgid \"E-hääletamiste nimekiri edastatakse EHS-st VIS3-e X-tee teenusega.\"\nmsgstr \"\"\n\"The list of e-votes will be transmitted from the EHS to VIS3 via the X-road \"\n\"service.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:29\nmsgid \"\"\n\"Teenust pakub EHS. VIS3 pöördub regulaarselt teenuse poole. EHS edastab e-\"\n\"hääletamiste andmete paki. VIS3 saab paki ja salvestab andmed VIS3 andmebaasi.\"\nmsgstr \"\"\n\"The service is provided by EHS. VIS3 regularly calls on the service. EHS will \"\n\"transmit the e-voting data packet. VIS3 receives the packet and stores the \"\n\"data in the VIS3 database.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:31\nmsgid \"Sünkroonimiseks kasutatakse e-hääletamiste nummerdamist.\"\nmsgstr \"Numbering of e-votes is used for synchronisation.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:33\nmsgid \"Kaalutlused\"\nmsgstr \"Reflections\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:35\nmsgid \"\"\n\"Teenus on arendatud X-tee REST võimalusi kasutades, vastavalt X-tee REST \"\n\"sõnumiprotokollile ([X-Road: Message Protocol for REST](https://www.x-tee.ee/\"\n\"docs/live/xroad/pr-rest_x-road_message_protocol_for_rest.html)). Andmed \"\n\"väljastatakse JSON-vormingus.\"\nmsgstr \"\"\n\"The service has been developed using the REST capabilities of the X-Road, \"\n\"according to the X-Road REST message protocol ([X-Road: Message Protocol for \"\n\"REST](https://www.x-tee.ee/docs/live/xroad/pr-rest_x-\"\n\"road_message_protocol_for_rest.html)). The data is output in JSON format.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:37\nmsgid \"\"\n\"X-teed on otstarbekas kasutada, sest kuigi VIS3 ja EHS võivad olla käitatud \"\n\"samas taristus, on ikkagi vaja tagada usaldus, logimine ja paindlikkus - \"\n\"omadused, mille tagamine X-tee kasutamisega kokkuvõttes tõenäoliselt ei saaks \"\n\"olema ei lihtsam ega odavam.\"\nmsgstr \"\"\n\"The X-road makes sense because, although VIS3 and EHS can be run on the same \"\n\"infrastructure, there is still a need to ensure trust, logging and \"\n\"flexibility - features that, in the end, using the X-road is unlikely to be \"\n\"easier or cheaper to provide.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:39\nmsgid \"\"\n\"Protokollis on arvesse võetud Rahvastikuregistri ja VIS3 vaheliste X-tee \"\n\"teenuste kasutamise kogemust (REST sõnumiprotokoll, JSON, OpenAPI).\"\nmsgstr \"\"\n\"The protocol takes into account the experience of using X-Road services \"\n\"between the Population Register and VIS3 (REST message protocol, JSON, \"\n\"OpenAPI).\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:41\nmsgid \"\"\n\"Erilist tähelepanu on pööratud andmete re-sünkroonimise võimalusele tõrgete \"\n\"korral. Selleks on pakkide pärimine kavandatud idenmpotentsena.\"\nmsgstr \"\"\n\"Particular attention has been paid to the possibility of re-synchronising \"\n\"data in case of failures. For this purpose, packet inheritance is designed as \"\n\"an idempotent.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:43\nmsgid \"\"\n\"E-hääletanute nimekirja \\\"peegeldamiseks\\\" EHS-st VIS3-e võiks \"\n\"põhimõtteliselt kasutada ka mõnda standardset sünkroonimisprotokolli (nt Git, \"\n\"Rsync vms, vt \\\\[1], \\\\[2], \\\\[3]). Kuna vajadus on suhteliselt lihtne, siis \"\n\"seda ei ole tehtud.\"\nmsgstr \"\"\n\"To \\\"mirror\\\" the list of e-voters from the EHS to VIS3, in principle a \"\n\"standard synchronisation protocol could also be used (e.g. Git, Rsync etc., \"\n\"see \\\\[1], \\\\[2], \\\\[3]). Since the need is relatively simple, this has not \"\n\"been done.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:45\nmsgid \"\"\n\"Jõudluskaalutlused: E-hääletamise jooksvat nimekirja edastatakse e-\"\n\"hääletamise perioodil (6 päeva). E-hääletamise fakte edastatakse kokku u 300 \"\n\"000. E-hääletamise perioodi esimesel tunnil võib oodata u 5000 e-hääletamist; \"\n\"perioodi viimasel tunnil u 10 000 e-hääletamist.\"\nmsgstr \"\"\n\"Performance considerations: the e-voting rolling list will be made available \"\n\"during the e-voting period (6 days). The total number of e-voting files to be \"\n\"transmitted will be around 300 000. Approximately 5,000 e-votes can be \"\n\"expected in the first hour of the e-voting period; approximately 10,000 e-\"\n\"votes in the last hour of the period.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:47\nmsgid \"E-hääletamiste järjenumbrid\"\nmsgstr \"E-vote sequential numbers\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:49\nmsgid \"\"\n\"Tagamaks, et e-hääletamiste nimekiri kantakse EHS-st VIS3-e õigeaegselt ja \"\n\"täielikult, kasutatakse järjenumbreid. EHS omistab igale e-hääletamisele \"\n\"järjenumbri (ingl Sequence Number).\"\nmsgstr \"\"\n\"Sequential numbers will be used to ensure that the list of e-votes is \"\n\"transferred from the EHS to VIS3 in a timely and complete manner. The EHS \"\n\"assigns a Sequence Number to each e-vote.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:51\nmsgid \"\"\n\"Järjenumber on naturaalarv, alates ühest. Väärtus `0` tähistab olukorda, kus \"\n\"e-hääletamisi veel ei ole toimunud.\"\nmsgstr \"\"\n\"The sequence number is a natural number, starting from one. The value `0` \"\n\"indicates a situation where no e-voting has yet taken place.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:53\nmsgid \"Igas valimissündmuses on oma numeratsioon.\"\nmsgstr \"Each election event has its own numbering.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:55\nmsgid \"Teenus\"\nmsgstr \"Service\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:57\nmsgid \"\"\n\"Teenuse vastutav töötleja on Riigi Valimisteenistus (RVT). Teenuse volitatud \"\n\"töötleja on Riigi Infosüsteemi Amet (RIA). Teenust osutav süsteem on EHS.\"\nmsgstr \"\"\n\"The controller of the service is the State Election Service (RVT). The \"\n\"authorised processor of the service is the State Information System Authority \"\n\"(RIA). The system providing the service is EHS.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:59\nmsgid \"\"\n\"Teenust kasutav süsteem on VIS3. Teenust kasutava süsteemi vastutav töötleja \"\n\"on RIA.\"\nmsgstr \"\"\n\"The system using the service is VIS3. The system using the service is the RIA.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:61\nmsgid \"\"\n\"Teenuse ärinimi on \\\"E-hääletamiste nimekiri\\\". Teenuse tehniline nimi (X-tee \"\n\"REST teenusekood, Service Code) on `e-votings-running-list`.\"\nmsgstr \"\"\n\"The business name of the service is \\\"E-voting list\\\". The technical name of \"\n\"the service (X-way REST Service Code) is `e-votings-running-list`.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:63\nmsgid \"Teenus pakub järgmisi otspunkte:\"\nmsgstr \"The service offers the following endpoints:\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:65\nmsgid \"\"\n\"1 `GET /elections`. \\\"Valimissündmuste loetelu\\\" väljastab aktiivsete \"\n\"valimissündmuste loetelu. Aktiivne valimissündmus teenuse kontekstis on \"\n\"selline, mille kohta EHS on valmis väljastama e-hääletamiste nimekirja.\"\nmsgstr \"\"\n\"1 `GET /elections`. \\\"List of election events\\\" outputs a list of active \"\n\"election events. An active election event in the context of the service is \"\n\"one for which EHS is ready to issue a list of e-votes.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:67\nmsgid \"\"\n\"2 `GET /elections/{electionId}/lastseqno`. \\\"Viimane järjenumber\\\" väljastab \"\n\"konkreetse valimissündmuse viimase EHS-s registreeritud e-hääletamise \"\n\"järjenumbri.\"\nmsgstr \"\"\n\"2 `GET /elections/{electionId}/lastseqno`. \\\"Last Sequence Number\\\" gives the \"\n\"last e-voting sequence number registered in the EHS for a particular election \"\n\"event.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:69\nmsgid \"\"\n\"3 `GET /elections/{electionId}/evotingsbatchfrom/{fromseqno}`. \\\"e-\"\n\"hääletamiste pakk\\\". Selle päringuga pärib VIS3 EHS-lt valimissündmuse \"\n\"`{electionId}` e-hääletamiste paki, alatest e-hääletamisest järjenumbriga \"\n\"`{fromseqno}`.\"\nmsgstr \"\"\n\"3 `GET /elections/{electionId}/evotingsbatchfrom/{fromseqno}`. \\\"e-voting \"\n\"pack\\\". With this query, VIS3 shall inherit from EHS the e-voting batch for \"\n\"the election event `{electionId}`, starting from e-voting with the suffix \"\n\"`{fromseqno}`.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:71\nmsgid \"\"\n\"Päringute ja vastuste andmestruktuuride ja samuti vastuskoodide \"\n\"spetsifikatsiooni vt OpenAPI spetsifikatsioonis: [ehs-xroad-api.yaml](ehs-\"\n\"xroad-api.yaml).\"\nmsgstr \"\"\n\"For the specification of the query and response data structures and also the \"\n\"response codes, see the OpenAPI specification: [ehs-xroad-api.yaml](ehs-xroad-\"\n\"api.yaml).\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:73\nmsgid \"\"\n\"Teenuse OpenAPI spetsifikatsioon publitseeritakse turvaserveris, vastavalt \"\n\"spetsifikatsioonile [https://www.x-tee.ee/docs/live/xroad/pr-mrest_x-\"\n\"road_service_metadata_protocol_for_rest.html#4-retrieving-list-of-services](X-\"\n\"Road: Service Metadata Protocol for REST), jaotis 5 \\\"Retrieving the OpenAPI \"\n\"description of a Service\\\".\"\nmsgstr \"\"\n\"The OpenAPI specification of a Service is published in the Security Server, \"\n\"according to the specification [https://www.x-tee.ee/docs/live/xroad/pr-\"\n\"mrest_x-road_service_metadata_protocol_for_rest.html#4-retrieving-list-of-\"\n\"services](X-Road: Service Metadata Protocol for REST), section 5 \\\"Retrieving \"\n\"the OpenAPI description of a Service\\\".\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:75\nmsgid \"Teenuse OpenAPI spetsifikatsioon näitepäring:\"\nmsgstr \"OpenAPI service specification example request:\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:77\nmsgid \"\"\n\"`curl -H \\\"accept: application/json\\\" -H \\\"X-Road-Client:ee-dev/COM//\"\n\"dev\\\" \\\"https://.../r1/ee-dev/COM//ehs/getOpenAPI?serviceCode=e-\"\n\"votings-running-list\\\"`\"\nmsgstr \"\"\n\"`curl -H \\\"accept: application/json\\\" -H \\\"X-Road-Client:ee-dev/COM//\"\n\"dev\\\" \\\"https://.../r1/ee-dev/COM//ehs/getOpenAPI?serviceCode=e-\"\n\"votings-running-list\\\"`\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:79\nmsgid \"Otspunkt \\\"Valimissündmuste loetelu\\\"\"\nmsgstr \"Endpoint \\\"List of electoral events\\\"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:81\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:99\nmsgid \"Näide.\"\nmsgstr \"Example.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:83\nmsgid \"Päring: `GET /elections`\"\nmsgstr \"Query: `GET /elections`\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:85\nmsgid \"VIS3 pärib EHS-lt aktiivsete valimissündmuste loetelu.\"\nmsgstr \"VIS3 will query the list of active electoral events from EHS.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:87\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:105\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:128\nmsgid \"Vastus:\"\nmsgstr \"Answer:\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:93\nmsgid \"EHS vastab, et aktiivseid valimissündmusi on üks - `RK_2023`.\"\nmsgstr \"EHS replies that there is one active election event - `RK_2023`.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:95\nmsgid \"\"\n\"Kui aktiivseid valimissündmusi ei ole, siis EHS peab vastuses saatma tühja \"\n\"massiivi (JSON Array).\"\nmsgstr \"\"\n\"If there are no active election events, EHS must send an empty array (JSON \"\n\"Array) in the response.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:97\nmsgid \"Otspunkt \\\"Viimane järjenumber\\\"\"\nmsgstr \"Endpoint \\\"Last serial\\\"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:101\nmsgid \"Päring: `GET /elections/RK_2023/lastseqno`\"\nmsgstr \"Query: `GET /elections/RK_2023/lastseqno`\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:103\nmsgid \"VIS3 pärib valimissündmuse `RK_2023` viimase e-hääletamise järjenumbrit.\"\nmsgstr \"\"\n\"VIS3 will query the last e-voting sequence number of the election event \"\n\"`RK_2023`.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:114\nmsgid \"\"\n\"EHS vastab, et valimissündmuse `RK_2023` viimase e-hääletamise järjenumber on \"\n\"`54002`.\"\nmsgstr \"\"\n\"The EHS replies that the last e-voting sequence number for the election event \"\n\"`RK_2023` is `54002`.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:116\nmsgid \"\"\n\"Kui valimissündmus on EHS-le tundmatu, siis EHS vastab HTTP vastuskoodiga \"\n\"`404 Not Found`.\"\nmsgstr \"\"\n\"If the election event is unknown to EHS, EHS will respond with the HTTP \"\n\"response code `404 Not Found`.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:118\nmsgid \"\"\n\"Järjenumbrid algavad ühest (`1`). Kui valimisündmuses ei ole veel ükski \"\n\"valija e-hääletanud, siis vastab EHS `lastseqno` väärtusega `0`.\"\nmsgstr \"\"\n\"Sequential numbers start with one (`1`). If no voter has yet e-voted in the \"\n\"election event, the EHS will match `lastseqno` with a value of `0`.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:120\nmsgid \"Otspunkt \\\"e-hääletanute pakk\\\"\"\nmsgstr \"Endpoint \\\"e-vote pack\\\"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:122\nmsgid \"Näide 3.\"\nmsgstr \"Example 3.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:124\nmsgid \"Päring: `G /elections/RK_2023/evotingsbatchfrom/54001`\"\nmsgstr \"Query: `G /elections/RK_2023/evotingsbatchfrom/54001`\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:126\nmsgid \"\"\n\"VIS3 pärib valimissündmuse `RK_2023` e-hääletamiste andmeid, alates \"\n\"järjenumbrist `54001`.\"\nmsgstr \"\"\n\"VIS3 will query the e-voting data for the election event 'RK_2023', starting \"\n\"with the sequence number '54001'.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:155\nmsgid \"\"\n\"EHS vastab, et saadab valimissündmuse `RK_2023` e-hääletamiste andmeid, \"\n\"alates järjenumbrist `54001`, pakina, milles on kuni `100` kirjet. \"\n\"Konkreetses pakis on kaks kirjet, kuna paki moodustamise hetkel on viimase \"\n\"EHS-s registreeritud e-hääletamise järjenumber `54002`. Esimene kirje \"\n\"tähendab, et valija `LEO KASS`, isikukoodiga `38101010020` on valimistel \"\n\"`RK_2023` e-hääletanud. Kirjes on ka valija KOV EHAK-kood ja valimisringkonna \"\n\"number.\"\nmsgstr \"\"\n\"The EHS replies that it will send the e-voting data for the election event \"\n\"`RK_2023`, starting with the sequence number `54001`, as a packet with up to \"\n\"`100` records. There will be two records in a particular packet, as the last \"\n\"e-voting sequence number registered in the EHS at the time the packet is \"\n\"formed is '54002'. The first record means that the voter `LEO KASS`, with the \"\n\"personal identification number `38101010020` has e-voted in the election \"\n\"`RK_2023`. The record also contains the voter's Municipal Electoral \"\n\"Registration Number and the constituency number.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:157\nmsgid \"\"\n\"E-hääletamise fakti kohta EHS e-hääletamise aega ei saada - turvakaalutlustel.\"\nmsgstr \"\"\n\"The fact of e-voting will not be reported to EHS at the time of e-voting - \"\n\"for security reasons.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:159\nmsgid \"\"\n\"Paki maksimaalsuuruse `batchmaxsize` määrab EHS, arvestusega, et andmed \"\n\"saadetakse X-tee vastussõnumi kehas (mitte manuses). Vastussõnumi töötlemisel \"\n\"turvaserveris loetakse keha üheaegselt põhimällu. Seetõttu ei tohi \"\n\"vastusõnumi keha suurus ületada 10 MB (turvaserveri vaikeseadistus).\"\nmsgstr \"\"\n\"The maximum batch size `batchmaxsize` is determined by the EHS, taking into \"\n\"account that the data is sent in the body of the X-road response message (not \"\n\"in the attachment). When processing the response message in the security \"\n\"server, the body is read simultaneously into the main memory. Therefore, the \"\n\"body size of the response message shall not exceed 10 MB (default setting of \"\n\"the security server).\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:161\nmsgid \"\"\n\"Vastuses võib olla kuni `batchmaxsize` kirjet. Kui vastuses on kirjeid vähem \"\n\"kui `batchmaxsize`, siis see tähendab, et EHS-l ei ole vastuse koostamise \"\n\"hetkel rohkem andmeid e-hääletamiste kohta.\"\nmsgstr \"\"\n\"The response can contain up to `batchmaxsize` records. If there are fewer \"\n\"than `batchmaxsize` items in the response, this means that the EHS does not \"\n\"have any more data on e-voting at the time the response is generated.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:163\nmsgid \"VIS3 peab suutma töödelda erineva `batchmaxsize` väärtusega vastuseid.\"\nmsgstr \"\"\n\"VIS3 must be able to handle responses with different `batchmaxsize` values.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:165\nmsgid \"Töötluse ülevaade\"\nmsgstr \"Overview of treatment\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:167\nmsgid \"\"\n\"EHS registreerib e-hääletamise fakte. Igale e-hääletamisele omistab EHS \"\n\"järjenumbri. E-hääletamise fakte võib hoida nt järjenumbri järgi \"\n\"indekseeritud tabelis - siis on VIS3-i päringutele vastamine kiire ja \"\n\"efektiivne - kuid see on EHS siseasi. Paki maksimaalsuurus peaks olema EHS \"\n\"seadistuses määratav.\"\nmsgstr \"\"\n\"EHS records the facts of e-voting. EHS assigns a serial number to each e-\"\n\"vote. E-voting files could be kept in a table indexed by e.g. sequence number \"\n\"- then the response to VIS3 queries is fast and efficient - but this is an \"\n\"internal matter for EHS. The maximum packet size should be configurable in \"\n\"the EHS configuration.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:169\nmsgid \"\"\n\"VIS3 saadab valimiste aktiivsel perioodil regulaarselt päringuid EHS-i X-tee \"\n\"teenuse otspunkti \\\"Viimane järjenumber\\\". EHS saadab vastuses viimase e-\"\n\"hääletamise järjenumbri.\"\nmsgstr \"\"\n\"During the active period of the elections, VIS3 will regularly send queries \"\n\"to the EHS X-Road service endpoint \\\"Last Sequence Number\\\". EHS will send \"\n\"the last e-voting sequential number in the response.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:171\nmsgid \"\"\n\"Viimase järjenumbri alusel leiab VIS3, kas VIS3-e kantud e-hääletamiste \"\n\"andmed on EHS-iga sünkroonis. Kui viimane järjenumber osutab, et EHS-s on \"\n\"lisandunud kirjeid, mis vajavad VIS3-e kandmist, siis saadab VIS3 järjest \"\n\"päringud EHS X-tee teenuse otspunkti \\\"e-hääletamiste pakk\\\", alates \"\n\"esimesest järjenumbrist, mis on VIS3-s puudu; EHS saadab küsitud paki; VIS3 \"\n\"salvestab saadud andmed ja saadab järgmise paki päringu.\"\nmsgstr \"\"\n\"Based on the last sequential number, VIS3 will find out whether the e-voting \"\n\"data entered in VIS3 are in sync with EHS. If the last sequential number \"\n\"indicates that there are additional records in EHS that need to be entered in \"\n\"VIS3, VIS3 will send successive queries to the EHS X-Road service endpoint 'e-\"\n\"voting batch', starting from the first sequential number that is missing in \"\n\"VIS3; EHS will send the requested batch; VIS3 will store the received data \"\n\"and send the next batch query.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:173\nmsgid \"\"\n\"Päringute \\\"e-hääletamiste pakk\\\" töötlusloogika EHS-i poolel peab võimaldama \"\n\"VIS3-l päringuid esitada mistahes järjekorras ja kuitahes palju kordi.\"\nmsgstr \"\"\n\"The processing logic of the 'e-voting packet' of queries on the EHS side must \"\n\"allow VIS3 to query in any order and as many times as necessary.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:175\nmsgid \"\"\n\"Töötlus peab olema idempotentne (samajõuline) - selles mõttes, et VIS3 võib \"\n\"päritud andmeid igal ajal uuesti küsida. Uuesti pärimisega ei tohi tekkida \"\n\"duubelandmeid, tähendusnihkeid ega kinnijooksmisi.\"\nmsgstr \"\"\n\"The processing must be idempotent (concurrent) - in the sense that VIS3 can \"\n\"retrieve the requested data at any time. The re-query must not result in \"\n\"duplicates, semantic ambiguities, or stalls.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:177\nmsgid \"\"\n\"Tehnilise taustateabena märgime, et EHS hoiab e-hääletamise fakte mitte \"\n\"relatsioonilises andmebaasis, vaid etcd mäluteenuses.\"\nmsgstr \"\"\n\"As a technical background, EHS stores e-voting facts not in a relational \"\n\"database but in the etcd storage service.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:179\nmsgid \"Kohaletoimetamise garantii\"\nmsgstr \"Delivery guarantee\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:180\nmsgid \"\"\n\"Sõltuvalt e-hääletamise sagedusest ja EHS jõudlusest ning seadistusest võib \"\n\"EHS-s juhtuda, et e-hääletamise väga suure sageduse perioodil e-hääletamise \"\n\"faktile järjenumbri omistamine ajalõpu (ingl timeout) tõttu ebaõnnestub. \"\n\"Selline e-hääletamise fakt jääb e-hääletamiste nimekirjas VIS3-e edastamata.\"\nmsgstr \"\"\n\"Depending on the frequency of e-voting and the performance and configuration \"\n\"of the EHS, it is possible that during a period of very high frequency of e-\"\n\"voting, the assignment of a sequential number to the e-voting fact may fail \"\n\"due to a timeout. Such an e-voting fact will not be transmitted to VIS3 in \"\n\"the list of e-votes.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:182\nmsgid \"\"\n\"Seega e-hääletamiste nimekiri ei anna kõigi e-hääletamiste VIS3-e jooksvalt \"\n\"kohaletoimetamise garantiid. VIS3-e kohaletoimetatud fakte tuleb käsitada \"\n\"informatiivsetena. E-hääletamise faktid toimetatakse VIS3-e kindlalt \"\n\"täielikus koosseisus e-hääletanute (lõplikus) nimekirjas, pärast e-\"\n\"hääletamise perioodi lõppu (eraldi liides EHS ja VIS3 vahel).\"\nmsgstr \"\"\n\"Therefore, the list of e-votes does not guarantee the delivery of all e-votes \"\n\"VIS3s on a rolling basis. Facts delivered to the VIS3 must be considered as \"\n\"informative. The facts of an e-vote will be delivered to the VIS3 in the \"\n\"(final) list of e-voters in its definitive complete composition, after the \"\n\"end of the e-voting period (separate interface between EHS and VIS3).\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:184\nmsgid \"Teenuse pakkumise ajaline ulatus\"\nmsgstr \"Time scale for the provision of the service\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:186\nmsgid \"\"\n\"Konkreetse valimissündmuse kohta pakub EHS e-hääletamiste nimekirja ainult \"\n\"piiratud perioodil. See periood hõlmab e-hääletamise perioodi (kehtiva õiguse \"\n\"kohaselt 6 päeva) koos lühikeste siirdeperioodidega enne ja pärast.\"\nmsgstr \"\"\n\"For a specific election event, the EHS only offers a list of e-votes for a \"\n\"limited period. This period includes the e-voting period (6 days under \"\n\"current law) with short transition periods before and after.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:188\nmsgid \"\"\n\"Kui EHS valimissündmuse kohta e-hääletamiste nimekirja enam ei paku, siis \"\n\"päringud otspunktidesse \\\"Viimane järjenumber\\\" ja \\\"e-hääletanute pakk\\\" \"\n\"saavad HTTP vastuskoodi `410 Gone`.\"\nmsgstr \"\"\n\"If the EHS no longer provides a list of e-votes for an election event, \"\n\"queries to the endpoints \\\"Last Sequence Number\\\" and \\\"e-vote pack\\\" will \"\n\"receive the HTTP response code `410 Gone`.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:190\nmsgid \"\"\n\"Valimissündmuste loetelu pakub EHS pidevalt (otspunkt \\\"Valimissündmuste \"\n\"loetelu\\\"). Loetelus on valimissündmused, mille kohta EHS on valmis e-\"\n\"hääletamiste nimekirja pakkuma.\"\nmsgstr \"\"\n\"A list of electoral events is provided by EHS on an ongoing basis (under \"\n\"\\\"List of electoral events\\\"). The list includes election events for which \"\n\"EHS is ready to provide a list of e-voting events.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:192\nmsgid \"Kontroll ja veaolukordade käsitlemine\"\nmsgstr \"Control and error handling\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:194\nmsgid \"\"\n\"Eeldatakse, et EHS-i poolt VIS3-le väljastatav on korrektne ja muutumatu (e-\"\n\"hääletamiste nimekirja piires). Parandus- ja muutmiskirjeid käesolev \"\n\"protokoll ei sisalda.\"\nmsgstr \"\"\n\"It is assumed that the EHS output to VIS3 is correct and unchanged (within \"\n\"the limits of the list of e-votes). Letters of correction and amendment are \"\n\"not included in these minutes.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:196\nmsgid \"\"\n\"Pärast e-hääletamise lõppu, valimispäeval, edastatakse EHS-st VIS3-le e-\"\n\"hääletanute lõplik nimekiri). See edastus on spetsifitseeritud: [E-\"\n\"hääletanute nimekiri](https://github.com/e-gov/VIS3-EHS/blob/\"\n\"main/4_e_haaletanute_nimekiri/SPEC.md).\"\nmsgstr \"\"\n\"After the end of e-voting, on election day, the final list of e-voters is \"\n\"transmitted from the EHS to VIS3). This transmission is specific: [e-vote \"\n\"list](https://github.com/e-gov/VIS3-EHS/blob/main/4_e_haaletanute_nimekiri/\"\n\"SPEC.md).\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:198\nmsgid \"VIS3 operaator laeb e-hääletanute lõpliku nimekirja VIS3-e.\"\nmsgstr \"The VIS3 operator uploads the final list of e-voters to VIS3.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:200\nmsgid \"\"\n\"Jooksva nimekirja ja lõpliku nimekirja erinevuse korral loetakse \\\"tõe \"\n\"allikaks\\\" lõplik nimekiri. Seega: 1) kui lõplikus nimekirjas on isik, kes \"\n\"hääletamisperioodil edastatud nimekirjas puudub, siis loetakse isik e-\"\n\"hääletanuks; 2) kui hääletamisaegses nimekirjas on isik, kes lõplikus \"\n\"nimekirjas puudub, siis märge sellise isiku kohta VIS3-s küll säilitatakse, \"\n\"kuid töötluses ja toimingutes lähtutakse lõplikust nimekirjast, s.t loetakse, \"\n\"et isik ei ole e-hääletanud. VIS3 peab omama võimekust hääletamisaegse ja \"\n\"lõpliku nimekirja erinevust avastada ja operaatorile teada anda.\"\nmsgstr \"\"\n\"In the event of a discrepancy between the current list and the definitive \"\n\"list, the definitive list is considered to be the \\\"source of truth\\\". Thus: \"\n\"1) if the final list contains a person who is not on the list transmitted \"\n\"during the voting period, the person is considered to have e-voted; 2) if the \"\n\"voting period list contains a person who is not on the final list, the record \"\n\"of such person is kept in VIS3, but processing and operations are based on \"\n\"the final list, i.e. the person is considered not to have e-voted. The VIS3 \"\n\"shall have the capability to detect a discrepancy between the voting list and \"\n\"the final list and to inform the operator.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:203\nmsgid \"\"\n\"EHS-st VIS3-e edastatud e-hääletamise faktid on VIS3 kasutajaliideses \"\n\"nähtavad valimiste korraldajale, vaates \\\"Valijaga seotud toimingute \"\n\"ajalugu\\\". Kui valija e-hääletas mitu korda, siis on valijaga seotud \"\n\"toimingute ajaloos esitatud kõik valija e-hääletamised. E-hääletamise juures \"\n\"on näha kuupäev ja kellaaeg, millal e-hääletamise fakt EHS-st VIS3-e edastati.\"\nmsgstr \"\"\n\"The e-voting facts transmitted from the EHS to VIS3 will be visible to the \"\n\"election organiser in the VIS3 interface, in the 'Voter History' view. If a \"\n\"voter has e-voted more than once, all e-votes of the voter are shown in the \"\n\"voter activity history. The date and time at which the fact of the e-vote was \"\n\"transmitted from the EHS to VIS3 is shown next to the e-vote.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:205\nmsgid \"Kirjandus\"\nmsgstr \"Literature\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:207\nmsgid \"\\\\[1] Git. https://git-scm.com/.\"\nmsgstr \"\\\\[1] Git. https://git-scm.com/.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:209\nmsgid \"\"\n\"\\\\[2] CouchDB Replication Protocol, https://guide.couchdb.org/draft/\"\n\"replication.html.\"\nmsgstr \"\"\n\"\\\\[2] CouchDB Replication Protocol, https://guide.couchdb.org/draft/\"\n\"replication.html.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:211\nmsgid \"\"\n\"\\\\[3] Principle and application of Rsync algorithm. https://developpaper.com/\"\n\"principle-and-application-of-rsync-algorithm/.\"\nmsgstr \"\"\n\"\\\\[3] Principle and application of Rsync algorithm. https://developpaper.com/\"\n\"principle-and-application-of-rsync-algorithm/.\"\n" }, { "path": "Documentation/public/liidesed/locales/en/LC_MESSAGES/VIS3-EHS/README.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2024, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.9.1\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2024-05-13 21:04+0000\\n\"\n\"PO-Revision-Date: 2024-03-02 13:27+0200\\n\"\n\"Last-Translator: \\n\"\n\"Language: en\\n\"\n\"Language-Team: en \\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../VIS3-EHS/README.md:1\nmsgid \"VIS3-EHS liideste spetsifikatsioonid\"\nmsgstr \"VIS3-EHS interface specifications\"\n\n#: ../../VIS3-EHS/README.md:3\nmsgid \"\"\n\"Eesti riiklikel valimistel toimub e-hääletamine Valimiste infosüsteemi \"\n\"(VIS3) ja e-hääletamise süsteemi (EHS) koostöös. EHS roll on \"\n\"elektroonilise hääletamise läbiviimine lähtudes valimise definitsioonist,\"\n\" mis koostatakse valimise korraldaja poolt VIS3 abil. E-hääletamise ajal \"\n\"vahetavad EHS ja VIS3 informatsiooni - võivad muutuda valijate nimekirjad\"\n\" ning liigub info e-häälte laekumise kohta.\"\nmsgstr \"\"\n\"In Estonian national elections, e-voting takes place in cooperation \"\n\"between the Election Information System (VIS3) and the e-voting system \"\n\"(EHS). The role of the EHS is to carry out electronic voting based on the\"\n\" definition of an election, which is drawn up by the election organiser \"\n\"using VIS3. During e-voting, the EHS and VIS3 exchange information - \"\n\"voters' lists may change and information on the collection of e-votes is \"\n\"passed on.\"\n\n#: ../../VIS3-EHS/README.md:5\nmsgid \"\"\n\"Dokument esitab VIS3 ja e-hääletamise süsteemi EHS vaheliste liideste \"\n\"spetsifikatsioonid.\"\nmsgstr \"\"\n\"The document sets out the specifications for the interfaces between VIS3 \"\n\"and the e-voting system EHS.\"\n\n#: ../../VIS3-EHS/README.md:7\nmsgid \"\"\n\"Spetsifikatsioonid on avalikud. Spetsifikatsioonid ei käsitle VIS3 ega \"\n\"EHS konfidentsiaalset siseehitust ega liideste konfidentsiaalseid \"\n\"elemente.\"\nmsgstr \"\"\n\"The specifications are public. The specifications do not deal with the \"\n\"confidential internal architecture of VIS3 and EHS, nor with the \"\n\"confidential elements of the interfaces.\"\n\n#: ../../VIS3-EHS/README.md:10\nmsgid \"Ülevaade\"\nmsgstr \"Overview\"\n\n#: ../../VIS3-EHS/README.md:12\nmsgid \"![VIS3 ja EHS liidesed (ülevaade)](img/vis-ehs.png)\"\nmsgstr \"![VIS3 and EHS interfaces (overview)](img/vis-ehs.png)\"\n\n#: ../../VIS3-EHS/README.md:12\nmsgid \"VIS3 ja EHS liidesed (ülevaade)\"\nmsgstr \"VIS3 and EHS interfaces (overview)\"\n\n#: ../../VIS3-EHS/README.md:14\nmsgid \"Joonis 1. VIS3 ja EHS liidesed (ülevaade).\"\nmsgstr \"Figure 1. VIS3 and EHS interfaces (overview).\"\n\n#: ../../VIS3-EHS/README.md:16\nmsgid \"Märkus: Joonise originaal vt VIS3 dok-s RIAs, fail \\\"EHS\\\".\"\nmsgstr \"Note: For the original drawing, see VIS3 doc in RIA, file \\\"EHS\\\".\"\n\n#: ../../VIS3-EHS/README.md:18\nmsgid \"Vasakul on VIS3, mooduli täpsusega:\"\nmsgstr \"On the left is VIS3, with module precision:\"\n\n#: ../../VIS3-EHS/README.md:20\nmsgid \"KAN - Kandidaadimoodul\"\nmsgstr \"KAN - Candidate module\"\n\n#: ../../VIS3-EHS/README.md:21\nmsgid \"NIM - Nimekirjamoodul\"\nmsgstr \"NIM - List module\"\n\n#: ../../VIS3-EHS/README.md:22\nmsgid \"TUL - Valimistulemuse moodul\"\nmsgstr \"TUL - Election results module\"\n\n#: ../../VIS3-EHS/README.md:23\nmsgid \"VAL - Valimissündmuse moodul\"\nmsgstr \"VAL - Election event module\"\n\n#: ../../VIS3-EHS/README.md:24\nmsgid \"VTA - Valimistulemuse avalikustamise moodul.\"\nmsgstr \"VTA - Election result publishing module.\"\n\n#: ../../VIS3-EHS/README.md:26\nmsgid \"\"\n\"Andmed liiguvad noole suunas. HTTPS masinliidestes on teenust pakkuvad \"\n\"otspunktid VIS3 poolel. X-tee liideses on teenusepakkujaks EHS. Inim-\"\n\"masinliides tähendab seda, et ühe süsteemi operaator laeb faili \"\n\"süsteemist alla ja edastab teise süsteemi operaatorile, kes laeb faili \"\n\"teise süsteemi üles.\"\nmsgstr \"\"\n\"The data moves in the direction of the arrow. In HTTPS machine \"\n\"interfaces, the service-providing endpoints are on the VIS3 side. In an \"\n\"X-road interface, the service provider is EHS. A human machine interface \"\n\"means that an operator on one system downloads a file from one system and\"\n\" forwards it to an operator on another system, who uploads the file to \"\n\"the other system.\"\n\n#: ../../VIS3-EHS/README.md:29\nmsgid \"Liidesed on täpsemalt kirjeldatud allpool.\"\nmsgstr \"The interfaces are described in more detail below.\"\n\n#: ../../VIS3-EHS/README.md:31\nmsgid \"Spetsifikatsioonid\"\nmsgstr \"Specifications\"\n\n#: ../../VIS3-EHS/README.md:33\nmsgid \"[1 Valimisringkondade nimekiri](1_Valimisringkondade_nimekiri/SPEC.md)\"\nmsgstr \"[1 List of constituencies](1_Valimisringkondade_nimekiri/SPEC.md)\"\n\n#: ../../VIS3-EHS/README.md:35\nmsgid \"[2 Valikute nimekiri (kandidaatide nimekiri)](2_Valikute_nimekiri/SPEC.md)\"\nmsgstr \"[2 List of candidates (list of candidates)](2_Valikute_nimekiri/SPEC.md)\"\n\n#: ../../VIS3-EHS/README.md:37\nmsgid \"[3 Valijate nimekiri EHS-le](3_Valijate_nimekiri/SPEC.md)\"\nmsgstr \"[3 Voters list for EHS](3_Valijate_nimekiri/SPEC.md)\"\n\n#: ../../VIS3-EHS/README.md:39\nmsgid \"[4 E-hääletanute nimekiri](4_e_haaletanute_nimekiri/SPEC.md)\"\nmsgstr \"[4 List of e-voters](4_e_haaletanute_nimekiri/SPEC.md)\"\n\n#: ../../VIS3-EHS/README.md:41\nmsgid \"[5 Tühistus- ja ennistusnimekiri](5_Tyhistusnimekiri/SPEC.md)\"\nmsgstr \"[5 Revokation and Restoration List](5_Tyhistusnimekiri/SPEC.md)\"\n\n#: ../../VIS3-EHS/README.md:43\nmsgid \"[6 E-hääletamise tulemus](6_e_haaletamise_tulemus/SPEC.md)\"\nmsgstr \"[6 Result of the e-voting](6_e_haaletamise_tulemus/SPEC.md)\"\n\n#: ../../VIS3-EHS/README.md:45\nmsgid \"\"\n\"[7 E-hääletamisest osavõtu \"\n\"üldstatistika](7_e_haaletamise_yldstatistika/SPEC.md)\"\nmsgstr \"\"\n\"[7 General statistics on e-voting \"\n\"participation](7_e_haaletamise_uldstatistika/SPEC.md)\"\n\n#: ../../VIS3-EHS/README.md:47\nmsgid \"\"\n\"[8 E-hääletamisest osavõtu \"\n\"detailstatistika](8_e_haaletamise_detailstatistika/SPEC.md)\"\nmsgstr \"\"\n\"[8 Detailed statistics on e-voting \"\n\"participation](8_e_haaletamise_detailstatistika/SPEC.md)\"\n\n#: ../../VIS3-EHS/README.md:49\nmsgid \"[9 E-hääletamiste nimekiri](9_e_haaletamiste_nimekiri/SPEC.md)\"\nmsgstr \"[9 e-vote list](9_e_haaletamiste_nimekiri/SPEC.md)\"\n\n#: ../../VIS3-EHS/README.md:51\nmsgid \"\"\n\"Spetsifikatsioonides kasutatav valimissündmuse identifikaator peab \"\n\"vastama formaadile [Valimissündmuse \"\n\"identifikaator](valimissündmuse_identifikaator.md).\"\nmsgstr \"\"\n\"The election event identifier used in the specifications must conform to \"\n\"the format [Election event \"\n\"identifier](valimissündmuse_identifikaator.md).\"\n\n#: ../../VIS3-EHS/README.md:53\nmsgid \"Usalduse loomine masinliidestes\"\nmsgstr \"Building trust in machine interfaces\"\n\n#: ../../VIS3-EHS/README.md:55\nmsgid \"Masinliidesed kaitstakse HTTPS-ga ja TLS mõlemapoolse autentimisega.\"\nmsgstr \"Machine interfaces are protected by HTTPS and TLS two-way authentication.\"\n\n#: ../../VIS3-EHS/README.md:57\nmsgid \"\"\n\"Lisaks piiratakse VIS3 seadistusega EHS pääs ainult EHS-le määratud \"\n\"otspunktidele (3b ja 7).\"\nmsgstr \"\"\n\"In addition, the VIS3 setting restricts EHS access to the endpoints \"\n\"assigned to EHS only (3b and 7).\"\n\n#: ../../VIS3-EHS/README.md:59\nmsgid \"Veakäsitlus masinliidestes\"\nmsgstr \"Error handling in machine interfaces\"\n\n#: ../../VIS3-EHS/README.md:61\nmsgid \"\"\n\"VIS3 peab andma HTTP standardi kohase vastuskoodi ja veateate, kui EHS \"\n\"saadetud päring on ebakorrektne või VIS3 ei suuda päringut teenendada.\"\nmsgstr \"\"\n\"The VIS3 must provide an HTTP standard response code and an error message\"\n\" if the request sent by the EHS is incorrect or if the VIS3 fails to \"\n\"serve the request.\"\n\n#: ../../VIS3-EHS/README.md:63\nmsgid \"\"\n\"EHS peab arvestama VIS3 tõrke võimalusega. Standardne reaktsioon tõrkele \"\n\"on päringu uuestisaatmine.\"\nmsgstr \"\"\n\"EHS must take into account the possibility of a VIS3 failure. The \"\n\"standard response to a failure is to resend the request.\"\n\n#: ../../VIS3-EHS/README.md:65\nmsgid \"Veakäsitlus faili inimese poolt edastamise liidestes\"\nmsgstr \"Error handling in human file transfer interfaces\"\n\n#: ../../VIS3-EHS/README.md:67\nmsgid \"\"\n\"VIS3 peab kontrollima üleslaetud faili süntaksit ja kus võimalik, kas \"\n\"semantikat. Ebakorrektse faili kohta tuleb anda operaatorile teada. \"\n\"Ebakorrektse faili andmeid ei kanta VIS3 andmebaasi.\"\nmsgstr \"\"\n\"VIS3 must check the syntax and, where possible, the semantics of the \"\n\"uploaded file. An incorrect file must be reported to the operator. The \"\n\"data of an incorrect file shall not be entered into the VIS3 database.\"\n\n#: ../../VIS3-EHS/README.md:69\nmsgid \"\"\n\"Korrektse, kuid eksitusena üleslaetud faili andmeid saab VIS3 \"\n\"andmebaasist kustutada ja õige fail uuesti üles laadida.\"\nmsgstr \"\"\n\"The data of a correct file uploaded in error can be deleted from the VIS3\"\n\" database and the correct file uploaded again.\"\n\n#: ../../VIS3-EHS/README.md:71\nmsgid \"Muudatused võrreldes VIS2-EHS-ga\"\nmsgstr \"Changes compared to VIS2-EHS\"\n\n#: ../../VIS3-EHS/README.md:73\nmsgid \"VIS3-EHS liideses on võrreldes VIS2-ga muudetud ja ajakohastatud:\"\nmsgstr \"The VIS3-EHS interface has been modified and updated compared to VIS2:\"\n\n#: ../../VIS3-EHS/README.md:75\nmsgid \"\"\n\"osapoolte vahetumisest (valijate nimekirja hakkab EHS-le saame mitte RR\"\n\"/SMIT-ist, vaid RIA VIS3-st)\"\nmsgstr \"\"\n\"change of parties (we will get the list of voters for EHS not from \"\n\"RR/SMIT but from RIA VIS3).\"\n\n#: ../../VIS3-EHS/README.md:76\nmsgid \"valimisõiguse muutumisest (jaoskondade tähenduse muutumine)\"\nmsgstr \"changes to electoral law (changing the meaning of polling stations)\"\n\n#: ../../VIS3-EHS/README.md:77\nmsgid \"valijate nimekirja ja selle uuenduste edastamisest üle liidese.\"\nmsgstr \"the transmission of the electoral roll and its updates over the interface.\"\n\n#: ../../VIS3-EHS/README.md:79\nmsgid \"\"\n\"VIS2 ja EHS omavahelisi liideseid spetsifitseerib \\\"IVXV protokollide \"\n\"kirjeldus\\\" (v 1.5.0, 20.04.2019), \"\n\"[https://www.valimised.ee/sites/default/files/uploads/eh/IVXV-\"\n\"protokollid.pdf](https://www.valimised.ee/sites/default/files/uploads/eh\"\n\"/IVXV-protokollid.pdf). \\\"Elektroonilise hääletamise protokollistik \"\n\"defineerib elektroonilise hääletamise süsteemi komponentide vahelise \"\n\"sõnumivahetuse, kasutatavad andmestruktuurid, algoritmid ning liidesed \"\n\"väliste süsteemidega.\\\" Spetsifitseeritud on:\"\nmsgstr \"\"\n\"The interfaces between VIS2 and EHS are specified in the \\\"Specification \"\n\"of the IVXV Protocols\\\" (v 1.5.0, 20.04.2019), \"\n\"[https://www.valimised.ee/sites/default/files/uploads/eh/IVXV-\"\n\"protokollid.pdf](https://www.valimised.ee/sites/default/files/uploads/eh\"\n\"/IVXV-protokollid.pdf). \\\"The Electronic Voting Protocol Specification \"\n\"defines the messaging between the components of the electronic voting \"\n\"system, the data structures to be used, the algorithms, and the \"\n\"interfaces to external systems.\\\" Specified are:\"\n\n#: ../../VIS3-EHS/README.md:81\nmsgid \"liides \\\"Valimisringkondade nimekiri\\\" (jaotis 3.2)\"\nmsgstr \"the interface \\\"List of constituencies\\\" (section 3.2).\"\n\n#: ../../VIS3-EHS/README.md:82\nmsgid \"liides \\\"Valikute nimekiri\\\" (jaotis 3.4)\"\nmsgstr \"the \\\"List of choices\\\" interface (section 3.4)\"\n\n#: ../../VIS3-EHS/README.md:83\nmsgid \"liides \\\"Valijate nimekiri\\\" (jaotis 3.3)\"\nmsgstr \"the \\\"Voters' list\\\" interface (section 3.3)\"\n\n#: ../../VIS3-EHS/README.md:84\nmsgid \"liides \\\"Tühistus- ja ennistusnimekiri\\\" (jaotis 9.1)\"\nmsgstr \"the interface \\\"Revokation and Restoration List\\\" (section 9.1).\"\n\n#: ../../VIS3-EHS/README.md:85\nmsgid \"liides \\\"E-hääletanute nimekiri\\\" (jaotis 9.2)\"\nmsgstr \"the interface \\\"E-vote list\\\" (section 9.2).\"\n\n#: ../../VIS3-EHS/README.md:86\nmsgid \"liides \\\"E-hääletamise tulemus\\\" (jaotis 9.3)\"\nmsgstr \"the interface \\\"Result of e-voting\\\" (section 9.3).\"\n\n#: ../../VIS3-EHS/README.md:88\nmsgid \"\"\n\"Käesolevad spetsifikatsioonid tuginevad ülalnimetatud \"\n\"spetsifikatsioonidele. Täpsemalt vt konkreetsete spetsifikatsioonide \"\n\"juures.\"\nmsgstr \"\"\n\"These specifications are based on the above specifications. For more \"\n\"details, see the specific specifications.\"\n\n#: ../../VIS3-EHS/README.md:90\nmsgid \"\"\n\"EHS lähtekood on kättesaadav: [https://github.com/vvk-\"\n\"ehk/ivxv](https://github.com/vvk-ehk/ivxv).\"\nmsgstr \"\"\n\"The EHS source code is available at: \"\n\"[https://github.com/valimised/ivxv](https://github.com/valimised/ivxv).\"\n\n" }, { "path": "Documentation/public/liidesed/locales/en/LC_MESSAGES/VIS3-EHS/Taustateave/README.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2025.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-03 22:58+0000\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language: en\\n\"\n\"Language-Team: en \\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../VIS3-EHS/Taustateave/README.md:1\nmsgid \"\"\n\"Kaustas on spetsifikatsioonid X-tee teenustele, millega VIS3 pärib \"\n\"Rahvastikuregistrist valijate nimekirja ja nimekirja muudatused:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/Taustateave/README.md:4\nmsgid \"\"\n\"`RRValimisteAlgNimekiri_kirjeldus.pdf` - Rahvastikuregistri poolt \"\n\"osutatava Valimiste algnimekirja X-tee teenuse spetsifikatsioon.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/Taustateave/README.md:7\nmsgid \"\"\n\"`RRValimisteNimekirjaMuudatused.pdf` - Rahvastikuregistri poolt osutatava\"\n\" Valimiste algnimekirja muudatuste X-tee teenuse spetsifikatsioon.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/Taustateave/README.md:10\nmsgid \"\"\n\"Spetsifikatsioonid võivad aidata mõista VIS3 poolt EHS-le pakutavate \"\n\"andmete koosseisu ja tähendust.\"\nmsgstr \"\"\n\n" }, { "path": "Documentation/public/liidesed/locales/en/LC_MESSAGES/VIS3-EHS/valimissündmuse_identifikaator.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2024, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\n#, fuzzy\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.9.1\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2024-03-02 12:43+0200\\n\"\n\"PO-Revision-Date: 2024-03-02 13:19+0200\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: en \\n\"\n\"Language: en\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"Generated-By: Babel 2.10.3\\n\"\n\"X-Generator: Poedit 3.4.2\\n\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:1\nmsgid \"Valimissündmuse identifikaator\"\nmsgstr \"Election event identifier\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:3\nmsgid \"\"\n\"Üht valimist puudutav andmestik on seotud unikaalse valimissündmuse \"\n\"identifikaatori abil.\"\nmsgstr \"\"\n\"A set of data relating to a single election is linked by a unique election \"\n\"event identifier.\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:5\nmsgid \"\"\n\"Valimissündmuse identifikaator on sõne, mis koosneb kahest kohustuslikust \"\n\"ja kahest valikulisest osast:\"\nmsgstr \"\"\n\"The election event identifier is a string consisting of two mandatory and \"\n\"two optional parts:\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:6\nmsgid \"valimissündmuse tüüp, vastavalt allolevale tabelile, nt `RK`.\"\nmsgstr \"the type of event, according to the table below, e.g. `RK'.\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:7\nmsgid \"aastanumbrist (nt `2023`)\"\nmsgstr \"from the year (e.g. `2023`)\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:8\nmsgid \"valikulisest erakorraliste valimiste tunnusest `_E` ja\"\nmsgstr \"the optional special election flag `_E` and\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:9\nmsgid \"valikulisest järjenumbrist , nt `2`.\"\nmsgstr \"from an optional sequence number , e.g. `2`.\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:11\nmsgid \"Ülalnimetatud osad eraldatakse üksteisest allkriipsudega `_`.\"\nmsgstr \"The above parts are separated by underscores `_'.\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:13\nmsgid \"\"\n\"Järjenummerdatakse tüüpide kaupa. Seejuures aasta esimese samatüübilise \"\n\"valimissündmuse korral järjenumbrit ei näidata.\"\nmsgstr \"\"\n\"Sequence numbering by type. The sequence number is not shown for the first \"\n\"election event of the same type in the year.\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:15\nmsgid \"Näited:\"\nmsgstr \"Examples:\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:16\nmsgid \"`KOV_2021`\"\nmsgstr \"'KOV_2021\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:17\nmsgid \"`RH_2021`\"\nmsgstr \"'RH_2021\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:18\nmsgid \"`RH_2021_2` (2021. a teine rahvahääletus)\"\nmsgstr \"`RH_2021_2` (second referendum in 2021)\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:19\nmsgid \"`RK_2023`\"\nmsgstr \"'RK_2023\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:20\nmsgid \"`RK_2023_E` (2023. a Riigikogu erakorralised valimised)\"\nmsgstr \"`RK_2023_E` (2023 special elections to the Riigikogu)\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:21\nmsgid \"`RK_2023_E_2` (2023. a Riigikogu teised erakorralised valimised).\"\nmsgstr \"`RK_2023_E_2` (other special elections to the Riigikogu in 2023).\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:23\nmsgid \"\"\n\"EHSi jaoks on valimise identifikaator kuni 28 ASCII-tähemärgi pikkune sõne \"\n\"ning eelnevalt kirjeldatud struktuuri põhjal EHS otsuseid ei tee.\"\nmsgstr \"\"\n\"For the EHS, the election identifier is a string up to 28 ASCII characters \"\n\"long, and the EHS does not make decisions based on the structure described \"\n\"above.\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:25\nmsgid \"Valimissündmuse tüüp\"\nmsgstr \"Type of election event\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:27\nmsgid \"Valimissündmuse tüüp esitatakse koodiga:\"\nmsgstr \"The type of the election event is indicated by a code:\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:29\nmsgid \"`KOV` - Kohaliku omavalitsuse volikogu valimised\"\nmsgstr \"`KOV` - Local government council elections\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:30\nmsgid \"`EP` - Euroopa Parlamendi valimised\"\nmsgstr \"`EP` - European Parliament elections\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:31\nmsgid \"`RK` - Riigikogu valimised\"\nmsgstr \"`RK` - Riigikogu elections\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:32\nmsgid \"`RH` - Rahvahääletus.\"\nmsgstr \"`RH` - Referendum.\"\n" }, { "path": "Documentation/public/liidesed/locales/en/LC_MESSAGES/examples.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2024, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\n#, fuzzy\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.9.1\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2024-03-02 12:43+0200\\n\"\n\"PO-Revision-Date: 2024-03-02 13:16+0200\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: en \\n\"\n\"Language: en\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"Generated-By: Babel 2.10.3\\n\"\n\"X-Generator: Poedit 3.4.2\\n\"\n\n#: ../../examples.rst:3\nmsgid \"Skeemid ja näited\"\nmsgstr \"Schemes and examples\"\n\n#: ../../examples.rst:7\nmsgid \"Valimisringkondade nimekiri\"\nmsgstr \"List of constituencies\"\n\n#: ../../examples.rst:10 ../../examples.rst:48 ../../examples.rst:84\n#: ../../examples.rst:119 ../../examples.rst:154 ../../examples.rst:189\n#: ../../examples.rst:206 ../../examples.rst:217\nmsgid \"Skeem\"\nmsgstr \"Scheme\"\n\n#: ../../examples.rst:17 ../../examples.rst:61 ../../examples.rst:97\n#: ../../examples.rst:132 ../../examples.rst:167\nmsgid \"Näide: KOV\"\nmsgstr \"Example: KOV\"\n\n#: ../../examples.rst:24 ../../examples.rst:55 ../../examples.rst:91\n#: ../../examples.rst:126 ../../examples.rst:161\nmsgid \"Näide: EP\"\nmsgstr \"Example: EP\"\n\n#: ../../examples.rst:31 ../../examples.rst:68 ../../examples.rst:103\n#: ../../examples.rst:138 ../../examples.rst:173\nmsgid \"Näide: RH\"\nmsgstr \"Example: RH\"\n\n#: ../../examples.rst:38 ../../examples.rst:74 ../../examples.rst:109\n#: ../../examples.rst:144 ../../examples.rst:179\nmsgid \"Näide: RK\"\nmsgstr \"Example: RK\"\n\n#: ../../examples.rst:45\nmsgid \"Valikute nimekiri\"\nmsgstr \"List of choices\"\n\n#: ../../examples.rst:81\nmsgid \"E-hääletanute nimekiri\"\nmsgstr \"List of e-voters\"\n\n#: ../../examples.rst:116\nmsgid \"Tühistusnimekiri\"\nmsgstr \"Revokation list\"\n\n#: ../../examples.rst:151\nmsgid \"E-hääletamise tulemus\"\nmsgstr \"Result of e-voting\"\n\n#: ../../examples.rst:186\nmsgid \"E-hääletamise üldstatistika\"\nmsgstr \"General statistics on e-voting\"\n\n#: ../../examples.rst:196\nmsgid \"Näide\"\nmsgstr \"Example\"\n\n#: ../../examples.rst:203\nmsgid \"E-hääletamise detailstatistika\"\nmsgstr \"Detailed statistics on e-voting\"\n\n#: ../../examples.rst:214\nmsgid \"E-hääletamiste nimekiri\"\nmsgstr \"List of e-votes\"\n" }, { "path": "Documentation/public/liidesed/locales/en/LC_MESSAGES/index.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2024, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\n#, fuzzy\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.9.1\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2024-02-29 10:34+0200\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language-Team: en \\n\"\n\"Language: en\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"Generated-By: Babel 2.10.3\\n\"\n\n#: ../../index.rst:4\nmsgid \"IVXV registreerimisteenus\"\nmsgstr \"IVXV registration service\"\n" }, { "path": "Documentation/public/liidesed/locales/et/LC_MESSAGES/VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2025.\n#\n#, fuzzy\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-03 23:20+0000\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language: et\\n\"\n\"Language-Team: et \\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:1\nmsgid \"1 Valimisringkondade nimekiri\"\nmsgstr \"Valimisringkondade nimekiri\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:3\nmsgid \"Protseduur\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:5\nmsgid \"VIS3 edastab EHS-le teabe valimisringkondade kohta.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:7\nmsgid \"Andmed edastatakse inim-masin-protseduuriga:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:9\nmsgid \"VIS peakasutaja laeb JSON faili VIS3-st alla;\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:11\nmsgid \"\"\n\"VIS peakasutaja allkirjastab faili digitaalselt väljaspool VIS-i ja annab\"\n\" selle EHS operaatorile;\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:13\nmsgid \"EHS operaator laeb digiallkirjastatud faili EHS-i.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:15\nmsgid \"Fail on JSON-formaadis. Faili ei allkirjastata.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:17\nmsgid \"\"\n\"Faili struktuur on kirjeldatud JSON schema-ga. Kirjeldus on \"\n\"kooskõlastatud EHS omanikuga.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:19\nmsgid \"\"\n\"EHS senine liides VIS2-ga on spetsifitseeritud dokumendis \\\"IVXV \"\n\"protokollide kirjeldus\\\" (v 1.5.0, IVXV-PR-1.5.0, 20.04.2019), \"\n\"[https://www.valimised.ee/sites/default/files/uploads/eh/IVXV-\"\n\"protokollid.pdf](https://www.valimised.ee/sites/default/files/uploads/eh\"\n\"/IVXV-protokollid.pdf), jaotises 3.2 \\\"Valimisjaoskondade ja -ringkondade\"\n\" nimekiri\\\".\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:21\nmsgid \"\"\n\"Valimistel, kus saavad osaleda alaliselt välisriigis elavad valijad \"\n\"kantakse nad valijate nimekirja tunnusega `FOREIGN`. Sellisel juhul peab \"\n\"valimisringkondade nimekiri sisaldama regiooni nende valijate jaoks ning \"\n\"iga ringkond peab sisaldama eraldi jaoskonda, kus nende häälte üle \"\n\"arvestust peetakse. Nii selle regiooni kui jaoskondade tunnuseks on \"\n\"fiktiivne EHAK: `0000`. Näitefailis \"\n\"[districts_RK.json](districts_RK.json) on näha nii regiooni korrektne \"\n\"lisamine kui ka välishääletajate jaoskonna korrektne lisamine igasse \"\n\"ringkonda.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:25\nmsgid \"Edastatav fail\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:27\nmsgid \"\"\n\"Valimissündmuse identifikaator peab vastama formaadile [Valimissündmuse \"\n\"identifikaator](../valimissündmuse_identifikaator.md).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:29\nmsgid \"Faili struktuur (JSON-skeem): [districts.schema](districts.schema)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:31\nmsgid \"Näited (JSON):\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:33\nmsgid \"[district_KOV.json](district_KOV.json)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:34\nmsgid \"[districts_EP.json](districts_EP.json)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:35\nmsgid \"[districts_RH.json](districts_RH.json)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:36\nmsgid \"[districts_RK.json](districts_RK.json)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:38\nmsgid \"Taustainfo\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:40\nmsgid \"\"\n\"Kandidaate on võimalik valimisele üles seada ainult konkreetses \"\n\"valimisringkonnas. Ringkondade järgi antakse valijatele hääletamise \"\n\"valikud:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:42\nmsgid \"Iga valija kuulub talle määratud valimisringkonda;\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:43\nmsgid \"\"\n\"Kõigis ühe ringkonna jaoskondades saavad valijad teha valiku vaid selle \"\n\"ringkonna valikute vahel;\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:45\nmsgid \"\"\n\"Eesti riiklikel valimistel eristatakse kohalike omavalitsuste volikogude \"\n\"(KOV) valimisi, Riigikogu valimisi, Euroopa Parlamendi valimisi ning \"\n\"rahvahääletusi.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:47\nmsgid \"\"\n\"KOV valimised korraldatakse vastavalt seadusele „Kohaliku omavalitsuse \"\n\"volikogu valimise seadus“. Valimine toimub kohaliku omavalitsuse \"\n\"tasandil, igal omavalitsusel on oma hääletamistulemus. Valimisringkonnad \"\n\"moodustatakse omavalitsuse tasemel vastavalt seaduses kirjeldatud \"\n\"reeglitele.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:49\nmsgid \"\"\n\"Riigikogu valimised korraldatakse vastavalt seadusele „Riigikogu valimise\"\n\" seadus“. Valimine toimub riigi tasandil. Riik jaguneb 12 \"\n\"valimisringkonnaks. Hääletamistulemus tehakse kindlaks iga \"\n\"valimisringkonna kohta.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:51\nmsgid \"\"\n\"Europarlamendi valimised korraldatakse vastavalt seadusele „Euroopa \"\n\"Parlamendi valimise seadus“. Valimine toimub riigi tasandil, \"\n\"hääletamistulemus on kõigile kohalikele omavalitsustele ühine. Terve riik\"\n\" on üks valimisringkond.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:53\nmsgid \"\"\n\"Rahvahääletused korraldatakse vastavalt seadusele „Rahvahääletuse \"\n\"seadus“. Valimine toimub riigi tasandil, hääletamistulemus on kõigile \"\n\"kohalikele omavalitsustele ühine. Terve riik on üks valimisringkond.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:55\nmsgid \"\"\n\"Erinevad valimised ei erine elektroonilise hääletamise andmevormingute ja\"\n\" protseduuride poolest. Erinevad ringkondade jaotused hallatakse VIS3 \"\n\"poolt.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:57\nmsgid \"\"\n\"Kandidaate on võimalik valimisele üles seada ainult konkreetses \"\n\"valimisringkonnas. Valijad on jaotatud valimisringkondade vahel. Valija \"\n\"saab teha valiku ainult tema ringkonnas kandideerivate kandidaatide \"\n\"vahel.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:59\nmsgid \"\"\n\"Kuna kohaliku omavalitsuse volikogude valimisel toimub valimine Eesti \"\n\"omavalitsuste (vallad, linnad) tasemel, siis kasutatakse elektroonilise \"\n\"hääletamise protokollistikus valimisringkondade kirjeldamisel ning \"\n\"valijate ja valikute ringkonnakuuluvuse näitamisel Eesti haldus- ja \"\n\"asustusjaotuse klassifikaatorit EHAK\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:61\nmsgid \"\"\n\"Näiteks: • Tallinna linna Pirita linnaosa EHAK kood on 0596; • Anija \"\n\"valla EHAK kood on 0141.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:65\nmsgid \"\"\n\"Riigi tasemel toimuvatel valimistel pannakse ringkonna EHAK koodiks \"\n\"kokkuleppeliselt 0.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/1_Valimisringkondade_nimekiri/SPEC.md:67\nmsgid \"\"\n\"Riigikogu ja europarlamendi valimistel ning rahvahääletusel moodustatakse\"\n\" nimekirjas igasse ringkonda fiktiivne üksus alaliselt välisriigis \"\n\"elavate valijate tarbeks. Selle üksuse number on 0 ning vastav EHAK kood \"\n\"on 0000.\"\nmsgstr \"\"\n\n" }, { "path": "Documentation/public/liidesed/locales/et/LC_MESSAGES/VIS3-EHS/2_Valikute_nimekiri/SPEC.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2025.\n#\n#, fuzzy\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-03 23:20+0000\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language: et\\n\"\n\"Language-Team: et \\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:1\nmsgid \"2 Valikute nimekiri (kandidaatide nimekiri)\"\nmsgstr \"Valikute nimekiri (kandidaatide nimekiri)\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:3\nmsgid \"Protseduur\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:5\nmsgid \"\"\n\"VIS3 edastab EHS-le andmed registreeritud kandidaatide (valimistel) või \"\n\"vastusevariantide (rahvahääletusel) kohta.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:7\nmsgid \"Andmed edastatakse inim-masin-protseduuriga:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:9\nmsgid \"\"\n\"VIS peakasutaja laeb JSON faili VIS3-st alla; Kasutaja peab valima \"\n\"aktiivsete valimissündmuste seast soovitud sündmuse, mille kohta infot \"\n\"alla laadida. Valimissündmus on aktiivne, kui tema staatus pole `closed` \"\n\"ega `deleted`.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:10\nmsgid \"\"\n\"VIS peakasutaja allkirjastab faili digitaalselt väljaspool VIS-i ja annab\"\n\" selle EHS operaatorile;\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:11\nmsgid \"EHS operaator laeb digiallkirjastatud faili EHS-i.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:13\nmsgid \"\"\n\"Fail on JSON-formaadis (näidis lisatud tööülesandele). Faili ei \"\n\"allkirjastata.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:15\nmsgid \"Edastatav fail\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:17\nmsgid \"\"\n\"Aluseks on EHS senine liides VIS2-ga, mis on spetsifitseeritud dokumendis\"\n\" \\\"IVXV protokollide kirjeldus\\\" (v 1.5.0, IVXV-PR-1.5.0, 20.04.2019), \"\n\"[https://www.valimised.ee/sites/default/files/uploads/eh/IVXV-\"\n\"protokollid.pdf](https://www.valimised.ee/sites/default/files/uploads/eh\"\n\"/IVXV-protokollid.pdf), jaotises \\\"Valikute nimekiri\\\" (jaotis 3.4).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:19\nmsgid \"\"\n\"Valimissündmuse identifikaator peab vastama formaadile [Valimissündmuse \"\n\"identifikaator](../valimissündmuse_identifikaator.md).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:21\nmsgid \"Faili struktuur (JSON-skeem): [choices.schema](choices.schema)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:23\nmsgid \"Faili näited (JSON):\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:25\nmsgid \"[choices_KOV.json](choices_KOV.json)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:26\nmsgid \"[choices_EP.json](choices_EP.json)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:27\nmsgid \"[choices_RK.json](choices_RK.json)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:29\nmsgid \"Taustainfo\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:31\nmsgid \"\"\n\"Valikute nimekiri sisaldab andmeid kandidaatide (valimistel) või \"\n\"vastusevariantide (rahvahääletusel) kohta. Valimiste korral on lisaks \"\n\"kandidaadi andmetele nimekirjas ka tema erakonna või valimisliidu nimi, \"\n\"mille nimekirjas ta kandideerib.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:34\nmsgid \"\"\n\"Valijale elektroonilise hääletamise käigus nähtavaid valimiste vahelisi \"\n\"süsteemseid erinevusi on kaks:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:36\nmsgid \"\"\n\"Rahvahääletusel ei valita erakondadesse kuuluvate kandidaatide vahel vaid\"\n\" vastatakse „JAH“/“EI“ rahvahääletuse küsimusele;\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:38\nmsgid \"\"\n\"Riigikogu, KOV ja Euroopa Parlamendi valimistel antakse hääl ühele \"\n\"kandidaadile, kes võib, aga ei pruugi kuuluda poliitilise ühenduse \"\n\"nimekirja.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/2_Valikute_nimekiri/SPEC.md:40\nmsgid \"\"\n\"Protokollistik kodeerib valija võimalikud valikud ringkonnas kuni \"\n\"11-kohalise arvväärtusena, mis valikute nimekirjas kodeeritakse koos \"\n\"ringkonna EHAK-koodiga. Valijale tohivad kättesaadavad olla ainult tema \"\n\"ringkonnakohased valikud. Valijarakendus peab seda omadust tagama ning \"\n\"hääletamistulemust arvutav rakendus kontrollima.\"\nmsgstr \"\"\n\n" }, { "path": "Documentation/public/liidesed/locales/et/LC_MESSAGES/VIS3-EHS/3_Valijate_nimekiri/SPEC.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2025.\n#\n#, fuzzy\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-03 23:20+0000\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language: et\\n\"\n\"Language-Team: et \\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:1\nmsgid \"3 Valijate nimekiri EHS-le\"\nmsgstr \"Valijate nimekiri EHS-le\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:3\nmsgid \"1. Annotatsioon\"\nmsgstr \"Annotatsioon\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:5\nmsgid \"\"\n\"Spetsifikatsioon määratleb Valimiste infosüsteemi (VIS3) ja e-hääletamise\"\n\" süsteemi (EHS) vahelise liidese, mille kaudu VIS3 edastab EHS-le \"\n\"valijate algnimekirja ja valijate nimekirja muudatusi ehk \"\n\"muudatusnimekirju.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:9\nmsgid \"\"\n\"Spetsifikatsioon on avalik. Spetsifikatsioon ei käsitle VIS3 ega EHS \"\n\"konfidentsiaalset siseehitust ega liidese konfidentsiaalseid elemente.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:12\nmsgid \"\"\n\"Käesolevat spetsifikatsiooni tuleb kasutada koos VIS3 EHS API OpenAPI \"\n\"spetsifikatsiooniga (asub käesolevas repos, failis `vis-ehs-api.yaml`).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:14\nmsgid \"2. Sõnumivahetus nimekirjade edastamiseks\"\nmsgstr \"Sõnumivahetus nimekirjade edastamiseks\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:16\nmsgid \"\"\n\"Valijate nimekirja põhjal tuvastab EHS isiku hääleõiguse ja \"\n\"ringkonnakuuluvuse. Valijate nimekiri võib hääletamisperioodi jooksul \"\n\"muutuda, sellest tulenevalt võib valija saada hääleõiguse, jääda oma \"\n\"hääleõigusest ilma või saada hääleõiguse senisest erinevas ringkonnas. \"\n\"EHS peab nende muutustega arvestama. Muudatused saab EHS VIS3 vahendusel \"\n\"muudatusnimekirjadena.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:22\nmsgid \"\"\n\"Spetsifikatsioonis defineeritud liidese vahendusel suhtlevad vahetult EHS\"\n\" ja VIS3:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:25\nmsgid \"\"\n\"VIS3 liidestub Rahvastikuregistri andmekoguga ning hangib seal nii \"\n\"valijate algnimekirja kui ka muudatusnimekirjad.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:27\nmsgid \"EHS esitab VIS3-le päringuid muudatusnimekirjade saamiseks.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:29\nmsgid \"Kaudselt on liidesega seotud:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:31\nmsgid \"Rahvastikuregister, kus toimub nimekirjade haldamine;\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:32\nmsgid \"\"\n\"VIS3 ja EHS operaatorid, kes vahetavad taustakanalis algnimekirja ning \"\n\"suhtlevad võimalike tõrgete lahendamisel;\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:34\nmsgid \"Audiitor, kes veendub et EHS on VIS3 poolt tarnitud nimekirjad rakendanud;\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:35\nmsgid \"\"\n\"EHS vallasrežiimis töötlemisrakendus, mis verifitseerib EHS sidusrežiimi \"\n\"komponentide poolt üle antud urni.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:38\nmsgid \"2.1 Ettevalmistused nimekirjade edastamiseks\"\nmsgstr \"Ettevalmistused nimekirjade edastamiseks\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:40\nmsgid \"![Joonis 1: Sõnumivahetuse ettevalmistamine](model/list_prepare.png)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:40\nmsgid \"Joonis 1: Sõnumivahetuse ettevalmistamine\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:42\nmsgid \"\"\n\"Valijate alg- ja muudatusnimekirjade vahetamisele eelnevalt tuleb \"\n\"vahetada nimekirjadele juurdepääsuks ja nimekirjade autentsuse \"\n\"kontrolliks vajalikud võtmed ja sertifikaadid (sammud 1-5)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:46\nmsgid \"2.2 Valijate algnimekirja edastamine\"\nmsgstr \"Valijate algnimekirja edastamine\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:48\nmsgid \"![Joonis 2: Algnimekirja edastamine](model/list_initial.png)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:48\nmsgid \"Joonis 2: Algnimekirja edastamine\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:50\nmsgid \"\"\n\"Valijate algnimekiri järjekorranumbriga 0 laetakse EHSi haldusliidese \"\n\"veebiliidesest. Valijate algnimekirja laadimine on eelduseks \"\n\"muudatusnimekirjade edasiseks automaatseks laadimiseks.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:54\nmsgid \"Valijate algnimekirja laadimine toimub järgmistes etappides:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:56\nmsgid \"\"\n\"VIS3 kasutab Rahvastikuregistri X-tee teenust valijate algnimekirja \"\n\"laadimiseks (sammud 1-3).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:58\nmsgid \"\"\n\"VIS3 peakasutaja pärib allkirjastatud algnimekirja VIS3 teenusest, ning \"\n\"allkirjastab algnimekirja täiendavalt ID-kaardiga (sammud 4-6).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:60\nmsgid \"\"\n\"VIS3 peakasutaja edastab allkirjastatud algnimekirja EHS operaatorile \"\n\"(samm 7)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:62\nmsgid \"\"\n\"EHS operaator laeb digitaalselt allkirjastatud algnimekirja EHSi, kus see\"\n\" rakendatakse (sammud 8-9).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:65\nmsgid \"2.3 Valijate muudatusnimekirja edastamine\"\nmsgstr \"Valijate muudatusnimekirja edastamine\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:67\nmsgid \"![Joonis 3: Muudatusnimekirja edastamine](model/list_changeset.png)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:67\nmsgid \"Joonis 3: Muudatusnimekirja edastamine\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:69\nmsgid \"\"\n\"Valijate nimekirja muudatusnimekirja laadimise algatab EHS. \"\n\"Muudatusnimekirjad on järjestatud, nii EHS kui ka VIS3 peavad arvet, \"\n\"milline on viimane loodud muudatusnimekiri.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:73\nmsgid \"\"\n\"EHS algatab uue muudatusnimekirja laadimise pöördudes uue \"\n\"järjekorranumbriga VIS3 vastava otspunkti poole. EHS võib varasemaid \"\n\"muudatusnimekirju uuesti pärida, kasutades varasemat järjekorranumbrit.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:77\nmsgid \"\"\n\"VIS3 saab muudatused Rahvastikuregistri X-tee teenusest. VIS3 poolne \"\n\"muudatuste hankimine on EHSile muudatuste esitamisest sõltumatu \"\n\"paralleelprotsess. See tähendab, et üks EHSile minev muudatusnimekiri \"\n\"võib sisaldada mitut Rahvastikuregistrist tulnud muudatust.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:82\nmsgid \"Muudatusnimekirjade edastamine EHSi käib järgmiselt:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:84\nmsgid \"EHS esitab päringu muudatusnimekirja saamiseks (samm 1)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:85\nmsgid \"Kui muudatusi ei ole, siis ei ole ka muudatusnimekirja (samm 2)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:86\nmsgid \"\"\n\"EHS kordab mingi aja möödudes päringut muudatusnimekirja saamiseks (samm \"\n\"3)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:87\nmsgid \"\"\n\"VIS3 edastab vahepeal saabunud muudatused EHSile ning EHS rakendab need \"\n\"edukalt (sammud 4-5)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:89\nmsgid \"\"\n\"Nii VIS3 kui EHS suurendavad muudatusnimekirjade järjekorranumbrit ning \"\n\"mõne aja möödudes edastatakse uus muudatusnimekiri (sammud 6-8)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:92\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:96\nmsgid \"**Märkused**\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:93\nmsgid \"\"\n\"Kui järjekorras järgmise muudatusnimekirja pärimisel muudatuskirjed \"\n\"puuduvad vastatakse HTTP staatusega `404` (not found).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:97\nmsgid \"\"\n\"Kui päritakse muudatusnimekirja suurema järjenumbriga, kui tegelik \"\n\"järgmise muudatusnimekirja järjenumber, vastatakse HTTP staatusega `409` \"\n\"(conflict).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:100\nmsgid \"2.4 Veajuhtumite lahendamine\"\nmsgstr \"Veajuhtumite lahendamine\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:102\nmsgid \"![Joonis 4: Veajuhtumite lahendamine](model/list_errors.png)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:102\nmsgid \"Joonis 4: Veajuhtumite lahendamine\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:104\nmsgid \"\"\n\"Muudatusnimekirjade edastamisel ei saa välistada vigu. Olenevalt vea \"\n\"iseloomust on võimalik taaste, keerulisematel juhtudel tuleb mõni \"\n\"vigaseks osutunud nimekiri vahele jätta. Veajuhtumi menetlemise ajal \"\n\"muudatusnimekirju ei edastata.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:109\nmsgid \"Veajuhtumite lahendamine toimub järgmiselt:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:111\nmsgid \"\"\n\"EHS ja VIS3 käivitavad protokolli muudatusnimekirja edastamiseks (sammud \"\n\"1-3).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:113\nmsgid \"\"\n\"EHS tunnistab nimekirja vigaseks ning teavitab sellest operaatorit (samm \"\n\"4).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:114\nmsgid \"\"\n\"Probleemi analüüsides tuvastatakse EHS-poolne tõrge, mida on võimalik \"\n\"lahendada. Tõrge lahendatakse ning EHS ja VIS3 kordavad edukalt \"\n\"protokolli (sammud 5-7).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:117\nmsgid \"\"\n\"EHS ja VIS3 käivitavad protokolli muudatusnimekirja edastamiseks (sammud \"\n\"8-10).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:119\nmsgid \"\"\n\"EHS tunnistab nimekirja vigaseks ning teavitab sellest operaatorit (samm \"\n\"11).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:121\nmsgid \"\"\n\"Probleemi analüüsides tuvastatakse sisuline probleem nimekirjas. Vigast \"\n\"nimekirja ei muudeta, luuakse uus korrektne nimekiri. EHS operaator laeb \"\n\"digitaalselt allkirjastatud korralduse vigase nimekirja vahele jätmiseks \"\n\"(samm 12)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:125\nmsgid \"\"\n\"EHS ja VIS3 suurendavad järjekorranumbrit ning käivitavad protokolli \"\n\"muudatusnimekirja edastamiseks (sammud 13-15).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:127\nmsgid \"\"\n\"EHS ja VIS3 suurendavad järjekorranumbrit ning käivitavad protokolli \"\n\"muudatusnimekirja edastamiseks (sammud 16-17). VIS3 vastab HTTP \"\n\"staatusega 409 (conflict).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:130\nmsgid \"\"\n\"EHS tuvastab vale järjenumbriga nimekirja laadimise ning teavitab sellest\"\n\" operaatorit (samm 18).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:132\nmsgid \"\"\n\"Tõrge lahendatakse ning EHS ja VIS3 kordavad edukalt protokolli (sammud \"\n\"19-21).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:134\nmsgid \"2.5 Nimekirjade loendi edastamine\"\nmsgstr \"Nimekirjade loendi edastamine\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:136\nmsgid \"3. Nimekirja andmevorming\"\nmsgstr \"Nimekirja andmevorming\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:138\nmsgid \"\"\n\"Nimekirja andmevorming on sama nii valijate algnimekirja kui \"\n\"muudatusnimekirjade jaoks.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:141\nmsgid \"\"\n\"Nimekiri esitatakse UTF-8-NOBOM vormingus tekstifailina. \"\n\"Andmestruktuuride eraldajaks kasutatakse reavahetusmärki `LF` (ASCII-kood\"\n\" `0x0A`). Andmestruktuuride väljade eraldajaks kasutatakse tabeldusmärki \"\n\"`TAB` (ASCII-kood `0x09`).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:146\nmsgid \"Nimekiri koosneb päiseridadest ja kirjetest.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:148\nmsgid \"Päiseridade sisu on järgmine:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:150\nmsgid \"\"\n\"`version` - andmestruktuuri versiooninumber, mille pikkus on piiratud 2 \"\n\"tähemärgiga. Spetsifikatsioonile vastava nimekirja korral on selle välja \"\n\"väärtus 2.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:153\nmsgid \"\"\n\"`election_identifier` - valimissündmuse identifikaator, mille pikkus on \"\n\"piiratud 28 tähemärgiga ASCII kooditabelist. Nimekirja rakendamine toimub\"\n\" ainult vastava identifikaatoriga valimissündmuse kontekstis. \"\n\"Valimissündmuse identifikaator peab vastama formaadile [Valimissündmuse \"\n\"identifikaator](../valimissündmuse_identifikaator.md).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:156\nmsgid \"\"\n\"`changeset` - nimekirja järjekorranumber. Rangelt kasvav number (0, 1, 2,\"\n\" ...), mis defineerib nimekirjade rakendamise järjekorra. Algnimekirja \"\n\"järjekorranumbriks on 0.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:159\nmsgid \"\"\n\"`period` - nimekirjas kajastuvate muudatuste ajavahemik. Esimene väli \"\n\"sisaldab perioodi algust, teine lõppu. Algnimekirja puhul on perioodi \"\n\"algus ja lõpu väärtused võrdsed. Väli on informatiivne.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:163\nmsgid \"Kirje koosneb väljadest, mille sisu on järgmine:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:165\nmsgid \"\"\n\"`person_code` - isikukood on valija unikaalne identifikaator, mille \"\n\"alusel EHS tuvastab isiku hääleõiguse ja ringkonnakuuluvuse.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:167\nmsgid \"\"\n\"`voter_name` - valija nimi, informaalne väli, otsuste tegemisel ei \"\n\"kasutata.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:168\nmsgid \"\"\n\"`action` - kirjega seotud tegevus. `lisamine` tähendab uue valija \"\n\"lisamist ja `kustutamine` olemasoleva valija eemaldamist.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:170\nmsgid \"\"\n\"`kov_code` - haldusüksus, kuhu valija kuulub. Haldusüksuse \"\n\"identifitseerimiseks kasutatakse kohaliku omavalitsuse EHAK-koodi, \"\n\"Tallinna korral linnaosa EHAK-koodi, alaliselt välisriigis elava valija \"\n\"korral kasutatakse väärtust `FOREIGN`.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:174\nmsgid \"\"\n\"`electoral_district_id` - valimisringkonna number identifitseerib \"\n\"valimisringkonna, kus valija hääletab. KOV valimiste korral kehtib \"\n\"identifikaator haldusüksuse sees. RK, EP ja RH valimiste korral on \"\n\"identifikaator haldusüksuste ülene.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:179\nmsgid \"\"\n\"Välju `voter_name`, `kov_code` ja `electoral_district_id` kasutatakse \"\n\"ainult lisamiskirjes (`action` väärtus `lisamine`).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:182\nmsgid \"Andmevormingu formaalne kirjeldus Backus-Naur notatsioonis:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:212\nmsgid \"3.1 Nimekirja tõlgendamine\"\nmsgstr \"Nimekirja tõlgendamine\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:214\nmsgid \"Nimekirju töötlev rakendus lähtub järgmistest reeglitest:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:216\nmsgid \"Nimekiri rakendatakse tervikuna.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:217\nmsgid \"\"\n\"Nimekirja rakendamisele eelnevad vormingu ja kooskõlalisuse kontrollid, \"\n\"vigaseid nimekirju ei rakendata.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:219\nmsgid \"Rakendus kontrollib nimekirja versiooni.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:220\nmsgid \"Rakendus kontrollib valimissündmuse identifikaatorit.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:221\nmsgid \"Rakendus kontrollib nimekirja järjekorranumbrit.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:222\nmsgid \"\"\n\"Rakendus kontrollib nimekirja kõigi kirjete kooskõlalisust oma \"\n\"andmebaasiga.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:223\nmsgid \"Kooskõlalisust kontrollitakse kirjete esinemisjärjekorras.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:224\nmsgid \"\"\n\"Kui tegevus on `lisamine`, siis ei tohi vastava isikukoodiga kirjet \"\n\"rakenduse andmebaasis olla.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:226\nmsgid \"\"\n\"Kui tegevus on `kustutamine`, siis rakendus kontrollib, kas vastava \"\n\"isikukoodiga kirje on rakenduse andmebaasis olemas. Kui ei ole, siis \"\n\"rakendus logib veateate ja jätkab järgmiste kirjete töötlust.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:229\nmsgid \"\"\n\"Kui valijaga soetud andmeid on vaja muuta, näiteks valija liigub ühest \"\n\"haldusüksusest või valimisringkonnast teise, siis kantakse valijate \"\n\"nimekirja muudatuste hulka üks kustutamise kirje, millega valija oma \"\n\"eelmisest üksusest kustutatakse ja üks lisamise kirje, millega valija \"\n\"uues üksuses valijate nimekirja lisatakse. Ka kõik teised muudatused \"\n\"valija andmetes - näiteks nimemuutus - toimuvad läbi vana kirje \"\n\"kustutamise ja uue lisamise.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:236\nmsgid \"\"\n\"Valijate algnimekirjas on ainult lisamiskirjed, iga valija kohta \"\n\"maksimaalselt üks kirje. Muudatusnimekirjas peavad ühe valija kohta \"\n\"käivad kirjed olema nimekirjas loogilises järjestuses ning liiasuseta. \"\n\"Ehk kustutamine enne lisamist ning maksimaalselt üks kustutamise-lisamise\"\n\" paar.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:241\nmsgid \"\"\n\"On võimalik, et valimise ajal muutub valija isikukood. Sellisel juhul \"\n\"lisatakse nimekirja vana isikukoodiga kustutamise kirje ning uue \"\n\"isikukoodiga lisamise kirje. Täiendav korduvhääletamise kontroll ei ole \"\n\"selle liidese skoobis ja teostakse VIS3 poolt eraldi.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:247\nmsgid \"3.2 Näited nimekirjadest\"\nmsgstr \"Näited nimekirjadest\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:249\nmsgid \"Valijate algnimekiri, 0.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:267\nmsgid \"Muudatusnimekiri, 1:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:269\nmsgid \"Muutub valija 20000000002 haldusüksus.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:270\nmsgid \"Valija 30000000003 kaotab hääleõiguse.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:271\nmsgid \"Valijale 11000000011 antakse hääleõigus.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:285\nmsgid \"Muudatusnimekiri, 2:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:287\nmsgid \"Muutub valija 20000000002 nimi.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:288\nmsgid \"Valija 60000000006 kaotab hääleõiguse.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:300\nmsgid \"Muudatusnimekiri, 3:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:302\nmsgid \"Muutub valija 20000000003->10000000003 isikukood koos nimega.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:303\nmsgid \"Valija 60000000006 saab hääleõiguse.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:315\nmsgid \"4. Nimekirja signeerimine\"\nmsgstr \"Nimekirja signeerimine\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:317\nmsgid \"\"\n\"Nii algnimekirjaga kui muudatusnimekirjadega kaasatakse allkirjafail \"\n\"(FIPS 186-4), mille moodustab andmeallikas, arvutades algsest valijate \"\n\"nimekirjast SHA256-räsi ning allkirjastades selle räsi ECDSA võtmega \"\n\"(kasutame P-256 kõverat). Andmeallika poolt genereeritud avalik võti \"\n\"tehakse taustakanalis kättesaadavaks EHSile ning selle võtme alusel \"\n\"kontrollitakse EHS komponentides valijate nimekirjade terviklust.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:324\nmsgid \"\"\n\"Võtmete genereerimiseks, signeerimiseks ning verifitseerimiseks võib \"\n\"kasutada tööriista OpenSSL:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:327\nmsgid \"\"\n\"Võtme genereerimine: `openssl ecparam -name prime256v1 -genkey -noout \"\n\"-out private.key.pem`\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:329\nmsgid \"\"\n\"Avaliku võtme eraldamine: `openssl ec -in private.key.pem -pubout -out \"\n\"public.key.pem`\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:331\nmsgid \"\"\n\"Andmefaili signeerimine: `openssl dgst -sha256 -sign private.key.pem -out\"\n\" data.sig data.txt`\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:333\nmsgid \"\"\n\"Signatuuri verifitseerimine: `openssl dgst -sha256 -verify public.key.pem\"\n\" -signature data.sig data.txt`\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:336\nmsgid \"\"\n\"Näide antud meetodi kasutamiseks golang keeles on leitav repositooriumis \"\n\"[DigiSign](https://github.com/e-gov/DigiSign)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:339\nmsgid \"5. Transpordiprotokoll\"\nmsgstr \"Transpordiprotokoll\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:341\nmsgid \"VIS3-EHS käesolev masinliides koosneb kahest API otspunktist.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:343\nmsgid \"\"\n\"API otspunkt `ehs-voters-changeset` konkreetse muudatusnimekirja \"\n\"laadimiseks VIS3-st\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:345\nmsgid \"\"\n\"API otspunkt `ehs-list-election-changesets` ülevaate saamiseks \"\n\"avalikustatud nimekirjadest\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:348\nmsgid \"\"\n\"Transpordiprotokoll on HTTPS, kuna volitamata ligipääs nimekirjadele \"\n\"tuleb tõkestada kasutatakse mõlemapoolselt autenditud TLS ühendusi.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:351\nmsgid \"5.1 `ehs-voters-changeset`\"\nmsgstr \"`ehs-voters-changeset`\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:353\nmsgid \"\"\n\"HTTP meetod on GET. Päringu tegemisel tuleb kasutada kohustuslikke \"\n\"parameetreid `changeset` ja `election_identifier`, kus\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:356\nmsgid \"`changeset` on muudatusnimekirja `integer` tüüpi järjekorranumber.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:357\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:379\nmsgid \"`election_identifier` on `string` tüüpi valimissündmuse identifikaator.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:359\nmsgid \"\"\n\"Kui EHS teeb API otspunkti GET päringu, siis juhul kui vastava \"\n\"identifikaatori ja järjekorranumbriga nimekiri eksisteerib, vastab VIS3 \"\n\"`application/octet-stream` tüüpi baidijadaga, mis esitab kahest failist \"\n\"koosnevat ZIP konteinerit:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:364\nmsgid \"nimekirjafail nimega `-voters-.utf`\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:366\nmsgid \"signatuurifail nimega `election_identifier<>-voters-.sig`\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:369\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:414\nmsgid \"Sellise vastuse korral on HTTP status 200.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:371\nmsgid \"\"\n\"Juhul kui vastava järjekorranumbriga muudatusnimekirja veel ei eksisteeri\"\n\" antakse vastuses HTTP status 404.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:374\nmsgid \"5.1 `ehs-list-election-changesets`\"\nmsgstr \"`ehs-list-election-changesets`\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:376\nmsgid \"\"\n\"HTTP meetod on GET. Päringu tegemisel tuleb kasutada kohustuslikku \"\n\"parameetrit `election_identifier`:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:381\nmsgid \"\"\n\"Kui EHS teeb API otspunkti, siis juhul kui vastava identifikaatoriga \"\n\"valimine eksisteerib, vastab VIS3 `application/json` tüüpi baidijadaga, \"\n\"mis sisaldab endas JSON vormingus viiteid kõigile väljastatud \"\n\"muudatusnimekirjadele.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:385\nmsgid \"\"\n\"MÄRKUS. Viidetes tarnitavad URL-id ei ole õiged ja seetõttu \"\n\"mittekasutatavad. EHS peab konkreetse muudatuste nimekirja poole \"\n\"pöördumise URL-i koostama vastavalt VIS3 EHS API OpenAPI vormingus \"\n\"spetsifikatsioonile (asub käesolevas repos, failis `vis3-ehs-api.yaml`). \"\n\"VIS3 edasisestes versioonides eemaldame viidetest URL-id. 20.07.2021.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:387\nmsgid \"\"\n\"MÄRKUS. Viidetes tarnitavate URL-de käsitlust muudetud: elemendis `url` \"\n\"tarnitakse mitte täis-URL, vaid ainult _path_ ja -query_ osa.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:416\nmsgid \"6. Näited\"\nmsgstr \"Näited\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:418\nmsgid \"7. Viited\"\nmsgstr \"Viited\"\n\n#: ../../VIS3-EHS/3_Valijate_nimekiri/SPEC.md:420\nmsgid \"\"\n\"[\\\"DigiSign\\\" - lihtne protokoll edastatavate failide allkirjastamiseks, \"\n\"koos teostusnäitega](https://github.com/e-gov/DigiSign)\"\nmsgstr \"\"\n\n" }, { "path": "Documentation/public/liidesed/locales/et/LC_MESSAGES/VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2025.\n#\n#, fuzzy\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-03 23:20+0000\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language: et\\n\"\n\"Language-Team: et \\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:1\nmsgid \"E-hääletanute nimekiri\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:3\nmsgid \"Protseduur\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:5\nmsgid \"\"\n\"E-hääletanute nimekiri on pärast e-hääletamise lõppu EHS poolt \"\n\"genereeritav ja väljastatav nimekiri e-hääletanud isikutest. \"\n\"E-hääletanute nimekiri loetakse sisse VIS3-e (moodul NIM).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:7\nmsgid \"E-hääletanute nimekiri edastakse inim-masin-protseduuriga:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:9\nmsgid \"EHS operaator laeb JSON-faili EHS-st alla;\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:11\nmsgid \"\"\n\"EHS operaator allkirjastab faili digitaalselt väljaspool EHS-i ja annab \"\n\"selle VIS peakasutajale;\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:13\nmsgid \"VIS peakasutaja laeb digikonteinerist välja võetud faili VIS3-i.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:15\nmsgid \"Fail on JSON-formaadis. Faili näidised on tööülesandes.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:17\nmsgid \"Faili struktuur on kirjeldatud JSON-skeemiga.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:19\nmsgid \"Edastatav fail\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:21\nmsgid \"\"\n\"Aluseks on EHS senine liides VIS2-ga, mis on spetsifitseeritud dokumendis\"\n\" \\\"IVXV protokollide kirjeldus\\\" (v 1.5.0, IVXV-PR-1.5.0, 20.04.2019), \"\n\"[https://www.valimised.ee/sites/default/files/uploads/eh/IVXV-\"\n\"protokollid.pdf](https://www.valimised.ee/sites/default/files/uploads/eh\"\n\"/IVXV-protokollid.pdf), jaotises \\\"E-hääletanute nimekiri\\\" (jaotis 9.2).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:23\nmsgid \"Faili struktuur (JSON-skeem): [onlinevoters.schema](onlinevoters.schema)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:25\nmsgid \"\"\n\"Valimissündmuse identifikaator peab vastama formaadile [Valimissündmuse \"\n\"identifikaator](../valimissündmuse_identifikaator.md).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:27\nmsgid \"Faili näited (JSON):\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:29\nmsgid \"[onlinevoters_EP.json](onlinevoters_EP.json)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:30\nmsgid \"[onlinevoters_KOV.json](onlinevoters_KOV.json)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:31\nmsgid \"[onlinevoters_RH.json](onlinevoters_RH.json)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/4_e_haaletanute_nimekiri/SPEC.md:32\nmsgid \"[onlinevoters_RK.json](onlinevoters_RK.json)\"\nmsgstr \"\"\n\n" }, { "path": "Documentation/public/liidesed/locales/et/LC_MESSAGES/VIS3-EHS/5_Tyhistusnimekiri/SPEC.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2025.\n#\n#, fuzzy\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-03 23:20+0000\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language: et\\n\"\n\"Language-Team: et \\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:1\nmsgid \"5 Tühistus- ja ennistusnimekiri\"\nmsgstr \"Tühistus- ja ennistusnimekiri\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:3\nmsgid \"\"\n\"VIS3 edastab EHS-le tühistus- ja ennistusnimekirja (lühidalt - \"\n\"tühistusnimekiri).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:5\nmsgid \"\"\n\"Tühistusnimekiri sisaldab andmeid isikute kohta, kelle e-hääl tuleb \"\n\"tühistada (on paberhääletanud ja sellest tulenevalt ei lähe e-hääl \"\n\"arvesse valimistulemuste kokkulugemisel) või ennistada (s.t. tühistatakse\"\n\" eelnev tühistamine ning häälte uuesti üle lugemisel võetakse ennistatud \"\n\"e-hääl arvesse).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:7\nmsgid \"Fail on JSON-formaadis.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:9\nmsgid \"Protseduur\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:11\nmsgid \"Tühistusnimekiri edastakse inim-masin-protseduuriga:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:13\nmsgid \"EHS operaator laeb JSON-faili EHS-st alla;\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:15\nmsgid \"\"\n\"EHS operaator allkirjastab faili digitaalselt väljaspool EHS-i ja annab \"\n\"selle VIS peakasutajale;\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:17\nmsgid \"VIS peakasutaja laeb digikonteinerist välja võetud faili VIS3-i.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:19\nmsgid \"Edastatav fail\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:21\nmsgid \"\"\n\"Aluseks on EHS senine liides VIS2-ga, mis on spetsifitseeritud dokumendis\"\n\" \\\"IVXV protokollide kirjeldus\\\" (v 1.5.0, IVXV-PR-1.5.0, 20.04.2019), \"\n\"[https://www.valimised.ee/sites/default/files/uploads/eh/IVXV-\"\n\"protokollid.pdf](https://www.valimised.ee/sites/default/files/uploads/eh\"\n\"/IVXV-protokollid.pdf), jaotises \\\"Tühistus- ja ennistusnimekiri\\\" \"\n\"(jaotis 9.1).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:23\nmsgid \"\"\n\"Valimissündmuse identifikaator peab vastama formaadile [Valimissündmuse \"\n\"identifikaator](../valimissündmuse_identifikaator.md).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:25\nmsgid \"Faili struktuur (JSON-skeem): [revoke.schema](revoke.schema)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:27\nmsgid \"Faili näited (JSON):\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:29\nmsgid \"[revoke_EP.json](revoke_EP.json)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:30\nmsgid \"[revoke_KOV.json](revoke_KOV.json)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:31\nmsgid \"[revoke_RH.json](revoke_RH.json)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/5_Tyhistusnimekiri/SPEC.md:32\nmsgid \"[revoke_RK.json](revoke_RK.json)\"\nmsgstr \"\"\n\n" }, { "path": "Documentation/public/liidesed/locales/et/LC_MESSAGES/VIS3-EHS/6_e_haaletamise_tulemus/SPEC.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2025.\n#\n#, fuzzy\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-03 23:20+0000\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language: et\\n\"\n\"Language-Team: et \\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:1\nmsgid \"E-hääletamise tulemus\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:3\nmsgid \"\"\n\"E-hääletamise lõppedes genereerib EHS e-hääletamise tulemuste faili \"\n\"(hääletamistulemuse fail). Fail laetakse VIS3-e (valimistulemuse \"\n\"moodulisse TUL).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:5\nmsgid \"Protseduur\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:7\nmsgid \"Fail edastatakse inim-masin-protseduuriga:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:9\nmsgid \"EHS operaator laeb JSON-faili EHS-st alla;\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:11\nmsgid \"\"\n\"EHS operaator allkirjastab faili digitaalselt väljaspool EHS-i ja annab \"\n\"selle VIS peakasutajale;\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:13\nmsgid \"VIS peakasutaja laeb digikonteinerist välja võetud faili VIS3-i.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:15\nmsgid \"Fail on JSON-formaadis.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:17\nmsgid \"Edastatav fail\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:19\nmsgid \"\"\n\"Aluseks on EHS senine liides VIS2-ga, mis on spetsifitseeritud dokumendis\"\n\" \\\"IVXV protokollide kirjeldus\\\" (v 1.5.0, IVXV-PR-1.5.0, 20.04.2019), \"\n\"[https://www.valimised.ee/sites/default/files/uploads/eh/IVXV-\"\n\"protokollid.pdf](https://www.valimised.ee/sites/default/files/uploads/eh\"\n\"/IVXV-protokollid.pdf), jaotises \\\"E-hääletamise tulemus\\\" (jaotis 9.3).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:21\nmsgid \"\"\n\"Valimissündmuse identifikaator peab vastama formaadile [Valimissündmuse \"\n\"identifikaator](../valimissündmuse_identifikaator.md).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:23\nmsgid \"Faili struktuur (JSON-skeem): [results.schema](results.schema)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:25\nmsgid \"Faili näited (JSON):\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:27\nmsgid \"[results_EP.json](results_EP.json)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:28\nmsgid \"[results_KOV.json](results_KOV.json)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:29\nmsgid \"[results_RH.json](results_RH.json)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/6_e_haaletamise_tulemus/SPEC.md:30\nmsgid \"[results_RK.json](results_RK.json)\"\nmsgstr \"\"\n\n" }, { "path": "Documentation/public/liidesed/locales/et/LC_MESSAGES/VIS3-EHS/7_e_haaletamise_yldstatistika/SPEC.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2025.\n#\n#, fuzzy\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-03 23:20+0000\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language: et\\n\"\n\"Language-Team: et \\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../VIS3-EHS/7_e_haaletamise_yldstatistika/SPEC.md:1\nmsgid \"7 E-hääletamisest osavõtu üldstatistika\"\nmsgstr \"E-hääletamisest osavõtu üldstatistika\"\n\n#: ../../VIS3-EHS/7_e_haaletamise_yldstatistika/SPEC.md:3\nmsgid \"\"\n\"EHS annab lühikese perioodiga (nt 15 min) VIS3-le andmeid kui palju \"\n\"valijaid on e-hääletanud.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/7_e_haaletamise_yldstatistika/SPEC.md:5\nmsgid \"EHS teeb seda HTTPS päringutega VIS3 poolt pakutava otspunkti vastu.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/7_e_haaletamise_yldstatistika/SPEC.md:7\nmsgid \"Päringu vastuses tagastatav fail:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/7_e_haaletamise_yldstatistika/SPEC.md:9\nmsgid \"JSON-skeem: [online-voters-total.schema](online-voters-total.schema)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/7_e_haaletamise_yldstatistika/SPEC.md:11\nmsgid \"\"\n\"Valimissündmuse identifikaator peab vastama formaadile [Valimissündmuse \"\n\"identifikaator](../valimissündmuse_identifikaator.md).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/7_e_haaletamise_yldstatistika/SPEC.md:13\nmsgid \"Näide (JSON): [online-voters-total.json](online-voters-total.json)\"\nmsgstr \"\"\n\n" }, { "path": "Documentation/public/liidesed/locales/et/LC_MESSAGES/VIS3-EHS/8_e_haaletamise_detailstatistika/SPEC.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2025.\n#\n#, fuzzy\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-03 23:20+0000\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language: et\\n\"\n\"Language-Team: et \\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../VIS3-EHS/8_e_haaletamise_detailstatistika/SPEC.md:1\nmsgid \"8 E-hääletamisest osavõtu detailne statistika\"\nmsgstr \"E-hääletamisest osavõtu detailne statistika\"\n\n#: ../../VIS3-EHS/8_e_haaletamise_detailstatistika/SPEC.md:3\nmsgid \"\"\n\"E-hääletamise lõppedes annab EHS VIS3-le e-hääletamisest osavõtu detailse\"\n\" statistika.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/8_e_haaletamise_detailstatistika/SPEC.md:5\nmsgid \"\"\n\"E-hääletamisest osavõtu statistikat kuvatakse valimiste veebilehel, \"\n\"samuti edastatakse masintöödeldaval kujul meediaorganisatsioonidele ja \"\n\"lõpuks publitseeritakse avaandmetena.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/8_e_haaletamise_detailstatistika/SPEC.md:7\nmsgid \"Protseduur\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/8_e_haaletamise_detailstatistika/SPEC.md:9\nmsgid \"EHS operaator laeb faili alla.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/8_e_haaletamise_detailstatistika/SPEC.md:11\nmsgid \"EHS operaator edastab faili VIS3 peakasutajale.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/8_e_haaletamise_detailstatistika/SPEC.md:13\nmsgid \"VIS3 peakasutaja laeb faili VIS3-e üles.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/8_e_haaletamise_detailstatistika/SPEC.md:15\nmsgid \"Faili edastatakse eelhääletamise ajal, kord päevas.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/8_e_haaletamise_detailstatistika/SPEC.md:17\nmsgid \"Edastatav fail\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/8_e_haaletamise_detailstatistika/SPEC.md:19\nmsgid \"JSON-skeem: [online-voters-counties.schema](online-voters-counties.schema)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/8_e_haaletamise_detailstatistika/SPEC.md:21\nmsgid \"\"\n\"Valimissündmuse identifikaator peab vastama formaadile [Valimissündmuse \"\n\"identifikaator](../valimissündmuse_identifikaator.md).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/8_e_haaletamise_detailstatistika/SPEC.md:23\nmsgid \"Näide (JSON): [online-voters-counties.json](online-voters-counties.json)\"\nmsgstr \"\"\n\n" }, { "path": "Documentation/public/liidesed/locales/et/LC_MESSAGES/VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2025.\n#\n#, fuzzy\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-03 23:20+0000\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language: et\\n\"\n\"Language-Team: et \\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:1\nmsgid \"E-hääletamiste nimekiri\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:3\nmsgid \"kavand v0.4\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:5\nmsgid \"Muutelugu\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:7\nmsgid \"Eemaldatud sõna \\\"jooksev\\\" / Priit Parmakson, 23.11.2022\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:8\nmsgid \"\"\n\"Lisatud OpenAPI kirjelduse publitseerimise teave. / Priit Parmakson, \"\n\"13.12.2022\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:9\nmsgid \"\"\n\"Täpsustatud e-hääletamiste väljanäitamist VIS3-s. / Priit Parmakson, \"\n\"15.11.2022\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:10\nmsgid \"Lisatud jõudluskaalutlused. / Priit Parmakson, 01.11.2022\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:11\nmsgid \"\"\n\"Asendatud \\\"e-hääletanu\\\" -> \\\"e-hääletamine\\\". Põhjus: inimene võib \"\n\"e-hääletada mitu korda (ümberhääletamine); vastavalt korrigeeritud JSON \"\n\"väljanimesid \\\"evotersbatch\\\" -> \\\"evotingsbatch\\\". / Priit Parmakson, \"\n\"01.09.2022\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:12\nmsgid \"\"\n\"Eemaldatud: hääletamise kuupäeva/aja edastamine. Põhjus: turvakaalutlus \"\n\"(häälemüügi takistamine). / Priit Parmakson, 01.09.2022 (Sven Heibergiga \"\n\"arutelu alusel)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:13\nmsgid \"\"\n\"Lisatud: 1) ärivajaduse täpsustus; 2) e-hääletamise fakti aja edastamine;\"\n\" 3) edastuse kontroll ja vajadusel täiendamine või parandamine lõpliku \"\n\"faili abil. / Priit Parmakson, 04.05.2022\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:14\nmsgid \"Arutelu - RVT ja RIA inimesed, 04.05.2022\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:15\nmsgid \"\"\n\"\\\"E-hääletanute jooksev nimekiri\\\", kavand v0.2. / Priit Parmakson, \"\n\"02.05.2022\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:16\nmsgid \"Arutelu: X-tee kasutamine, JSON - Tarmo Hanga, Priit Parmakson, apr 2022\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:17\nmsgid \"\\\"EHS- VIS3 liidestus\\\" (kavand) - Indrek Leesi, apr 2022\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:19\nmsgid \"Ülevaade\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:21\nmsgid \"\"\n\"Käesolev spetsifikatsioon määratleb protokolli e-hääletamiste nimekirja \"\n\"edastamiseks e-hääletamise süsteemist (edaspidi - EHS) Valimiste \"\n\"infosüsteemi (edaspidi - VIS3).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:23\nmsgid \"\"\n\"Varasematel valimistel (k.a KOV 2021) on peale hääletamise lõppu, \"\n\"valimispäeval edastatud EHS-st VIS3-le e-hääletanute nimekiri (edaspidi -\"\n\" e-hääletanute lõplik nimekiri). See edastus on spetsifitseeritud: \"\n\"[E-hääletanute \"\n\"nimekiri](https://github.com/e-gov/VIS3-EHS/blob/main/4_e_haaletanute_nimekiri/SPEC.md).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:25\nmsgid \"\"\n\"Siiski on vajadus VIS3-s saada teavet, kas valija on e-hääletanud, juba \"\n\"enne ülalnimetatud lõplikku edastust. Valija, kes on e-hääletanud, võib \"\n\"tulla eelhääletamise perioodil valimisjaoskonda ja soovida paberil \"\n\"hääletada. Valimisjaoskonna töötajal oleks hea omada võimalust VIS3-st \"\n\"vaadata, kas valija on e-hääletanud. Seda teavet saab muuhulgas kasutada \"\n\"valija hoiatamiseks, et paberhääletamisega tema e-hääletamine tühistub.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:27\nmsgid \"E-hääletamiste nimekiri edastatakse EHS-st VIS3-e X-tee teenusega.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:29\nmsgid \"\"\n\"Teenust pakub EHS. VIS3 pöördub regulaarselt teenuse poole. EHS edastab \"\n\"e-hääletamiste andmete paki. VIS3 saab paki ja salvestab andmed VIS3 \"\n\"andmebaasi.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:31\nmsgid \"Sünkroonimiseks kasutatakse e-hääletamiste nummerdamist.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:33\nmsgid \"Kaalutlused\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:35\nmsgid \"\"\n\"Teenus on arendatud X-tee REST võimalusi kasutades, vastavalt X-tee REST \"\n\"sõnumiprotokollile ([X-Road: Message Protocol for \"\n\"REST](https://www.x-tee.ee/docs/live/xroad/pr-rest_x-\"\n\"road_message_protocol_for_rest.html)). Andmed väljastatakse JSON-\"\n\"vormingus.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:37\nmsgid \"\"\n\"X-teed on otstarbekas kasutada, sest kuigi VIS3 ja EHS võivad olla \"\n\"käitatud samas taristus, on ikkagi vaja tagada usaldus, logimine ja \"\n\"paindlikkus - omadused, mille tagamine X-tee kasutamisega kokkuvõttes \"\n\"tõenäoliselt ei saaks olema ei lihtsam ega odavam.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:39\nmsgid \"\"\n\"Protokollis on arvesse võetud Rahvastikuregistri ja VIS3 vaheliste X-tee \"\n\"teenuste kasutamise kogemust (REST sõnumiprotokoll, JSON, OpenAPI).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:41\nmsgid \"\"\n\"Erilist tähelepanu on pööratud andmete re-sünkroonimise võimalusele \"\n\"tõrgete korral. Selleks on pakkide pärimine kavandatud idenmpotentsena.\"\nmsgstr \"\"\n\"Erilist tähelepanu on pööratud andmete re-sünkroonimise võimalusele \"\n\"tõrgete korral. Selleks on pakkide pärimine kavandatud idempotentsena.\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:43\nmsgid \"\"\n\"E-hääletanute nimekirja \\\"peegeldamiseks\\\" EHS-st VIS3-e võiks \"\n\"põhimõtteliselt kasutada ka mõnda standardset sünkroonimisprotokolli (nt \"\n\"Git, Rsync vms, vt \\\\[1], \\\\[2], \\\\[3]). Kuna vajadus on suhteliselt \"\n\"lihtne, siis seda ei ole tehtud.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:45\nmsgid \"\"\n\"Jõudluskaalutlused: E-hääletamise jooksvat nimekirja edastatakse \"\n\"e-hääletamise perioodil (6 päeva). E-hääletamise fakte edastatakse kokku \"\n\"u 300 000. E-hääletamise perioodi esimesel tunnil võib oodata u 5000 \"\n\"e-hääletamist; perioodi viimasel tunnil u 10 000 e-hääletamist.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:47\nmsgid \"E-hääletamiste järjenumbrid\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:49\nmsgid \"\"\n\"Tagamaks, et e-hääletamiste nimekiri kantakse EHS-st VIS3-e õigeaegselt \"\n\"ja täielikult, kasutatakse järjenumbreid. EHS omistab igale \"\n\"e-hääletamisele järjenumbri (ingl Sequence Number).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:51\nmsgid \"\"\n\"Järjenumber on naturaalarv, alates ühest. Väärtus `0` tähistab olukorda, \"\n\"kus e-hääletamisi veel ei ole toimunud.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:53\nmsgid \"Igas valimissündmuses on oma numeratsioon.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:55\nmsgid \"Teenus\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:57\nmsgid \"\"\n\"Teenuse vastutav töötleja on Riigi Valimisteenistus (RVT). Teenuse \"\n\"volitatud töötleja on Riigi Infosüsteemi Amet (RIA). Teenust osutav \"\n\"süsteem on EHS.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:59\nmsgid \"\"\n\"Teenust kasutav süsteem on VIS3. Teenust kasutava süsteemi vastutav \"\n\"töötleja on RIA.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:61\nmsgid \"\"\n\"Teenuse ärinimi on \\\"E-hääletamiste nimekiri\\\". Teenuse tehniline nimi \"\n\"(X-tee REST teenusekood, Service Code) on `e-votings-running-list`.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:63\nmsgid \"Teenus pakub järgmisi otspunkte:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:65\nmsgid \"\"\n\"1 `GET /elections`. \\\"Valimissündmuste loetelu\\\" väljastab aktiivsete \"\n\"valimissündmuste loetelu. Aktiivne valimissündmus teenuse kontekstis on \"\n\"selline, mille kohta EHS on valmis väljastama e-hääletamiste nimekirja.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:67\nmsgid \"\"\n\"2 `GET /elections/{electionId}/lastseqno`. \\\"Viimane järjenumber\\\" \"\n\"väljastab konkreetse valimissündmuse viimase EHS-s registreeritud \"\n\"e-hääletamise järjenumbri.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:69\nmsgid \"\"\n\"3 `GET /elections/{electionId}/evotingsbatchfrom/{fromseqno}`. \"\n\"\\\"e-hääletamiste pakk\\\". Selle päringuga pärib VIS3 EHS-lt \"\n\"valimissündmuse `{electionId}` e-hääletamiste paki, alatest \"\n\"e-hääletamisest järjenumbriga `{fromseqno}`.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:71\nmsgid \"\"\n\"Päringute ja vastuste andmestruktuuride ja samuti vastuskoodide \"\n\"spetsifikatsiooni vt OpenAPI spetsifikatsioonis: [ehs-xroad-api.yaml\"\n\"](ehs-xroad-api.yaml).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:73\nmsgid \"\"\n\"Teenuse OpenAPI spetsifikatsioon publitseeritakse turvaserveris, \"\n\"vastavalt spetsifikatsioonile [https://www.x-tee.ee/docs/live/xroad/pr-\"\n\"mrest_x-road_service_metadata_protocol_for_rest.html#4-retrieving-list-\"\n\"of-services](X-Road: Service Metadata Protocol for REST), jaotis 5 \"\n\"\\\"Retrieving the OpenAPI description of a Service\\\".\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:75\nmsgid \"Teenuse OpenAPI spetsifikatsioon näitepäring:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:77\nmsgid \"\"\n\"`curl -H \\\"accept: application/json\\\" -H \\\"X-Road-Client:ee-\"\n\"dev/COM//dev\\\" \\\"https://.../r1/ee-\"\n\"dev/COM//ehs/getOpenAPI?serviceCode=e-votings-running-list\\\"`\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:79\nmsgid \"Otspunkt \\\"Valimissündmuste loetelu\\\"\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:81\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:99\nmsgid \"Näide.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:83\nmsgid \"Päring: `GET /elections`\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:85\nmsgid \"VIS3 pärib EHS-lt aktiivsete valimissündmuste loetelu.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:87\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:105\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:128\nmsgid \"Vastus:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:93\nmsgid \"EHS vastab, et aktiivseid valimissündmusi on üks - `RK_2023`.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:95\nmsgid \"\"\n\"Kui aktiivseid valimissündmusi ei ole, siis EHS peab vastuses saatma \"\n\"tühja massiivi (JSON Array).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:97\nmsgid \"Otspunkt \\\"Viimane järjenumber\\\"\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:101\nmsgid \"Päring: `GET /elections/RK_2023/lastseqno`\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:103\nmsgid \"VIS3 pärib valimissündmuse `RK_2023` viimase e-hääletamise järjenumbrit.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:114\nmsgid \"\"\n\"EHS vastab, et valimissündmuse `RK_2023` viimase e-hääletamise \"\n\"järjenumber on `54002`.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:116\nmsgid \"\"\n\"Kui valimissündmus on EHS-le tundmatu, siis EHS vastab HTTP vastuskoodiga\"\n\" `404 Not Found`.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:118\nmsgid \"\"\n\"Järjenumbrid algavad ühest (`1`). Kui valimisündmuses ei ole veel ükski \"\n\"valija e-hääletanud, siis vastab EHS `lastseqno` väärtusega `0`.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:120\nmsgid \"Otspunkt \\\"e-hääletanute pakk\\\"\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:122\nmsgid \"Näide 3.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:124\nmsgid \"Päring: `G /elections/RK_2023/evotingsbatchfrom/54001`\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:126\nmsgid \"\"\n\"VIS3 pärib valimissündmuse `RK_2023` e-hääletamiste andmeid, alates \"\n\"järjenumbrist `54001`.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:155\nmsgid \"\"\n\"EHS vastab, et saadab valimissündmuse `RK_2023` e-hääletamiste andmeid, \"\n\"alates järjenumbrist `54001`, pakina, milles on kuni `100` kirjet. \"\n\"Konkreetses pakis on kaks kirjet, kuna paki moodustamise hetkel on \"\n\"viimase EHS-s registreeritud e-hääletamise järjenumber `54002`. Esimene \"\n\"kirje tähendab, et valija `LEO KASS`, isikukoodiga `38101010020` on \"\n\"valimistel `RK_2023` e-hääletanud. Kirjes on ka valija KOV EHAK-kood ja \"\n\"valimisringkonna number.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:157\nmsgid \"\"\n\"E-hääletamise fakti kohta EHS e-hääletamise aega ei saada - \"\n\"turvakaalutlustel.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:159\nmsgid \"\"\n\"Paki maksimaalsuuruse `batchmaxsize` määrab EHS, arvestusega, et andmed \"\n\"saadetakse X-tee vastussõnumi kehas (mitte manuses). Vastussõnumi \"\n\"töötlemisel turvaserveris loetakse keha üheaegselt põhimällu. Seetõttu ei\"\n\" tohi vastusõnumi keha suurus ületada 10 MB (turvaserveri \"\n\"vaikeseadistus).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:161\nmsgid \"\"\n\"Vastuses võib olla kuni `batchmaxsize` kirjet. Kui vastuses on kirjeid \"\n\"vähem kui `batchmaxsize`, siis see tähendab, et EHS-l ei ole vastuse \"\n\"koostamise hetkel rohkem andmeid e-hääletamiste kohta.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:163\nmsgid \"VIS3 peab suutma töödelda erineva `batchmaxsize` väärtusega vastuseid.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:165\nmsgid \"Töötluse ülevaade\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:167\nmsgid \"\"\n\"EHS registreerib e-hääletamise fakte. Igale e-hääletamisele omistab EHS \"\n\"järjenumbri. E-hääletamise fakte võib hoida nt järjenumbri järgi \"\n\"indekseeritud tabelis - siis on VIS3-i päringutele vastamine kiire ja \"\n\"efektiivne - kuid see on EHS siseasi. Paki maksimaalsuurus peaks olema \"\n\"EHS seadistuses määratav.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:169\nmsgid \"\"\n\"VIS3 saadab valimiste aktiivsel perioodil regulaarselt päringuid EHS-i \"\n\"X-tee teenuse otspunkti \\\"Viimane järjenumber\\\". EHS saadab vastuses \"\n\"viimase e-hääletamise järjenumbri.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:171\nmsgid \"\"\n\"Viimase järjenumbri alusel leiab VIS3, kas VIS3-e kantud e-hääletamiste \"\n\"andmed on EHS-iga sünkroonis. Kui viimane järjenumber osutab, et EHS-s on\"\n\" lisandunud kirjeid, mis vajavad VIS3-e kandmist, siis saadab VIS3 \"\n\"järjest päringud EHS X-tee teenuse otspunkti \\\"e-hääletamiste pakk\\\", \"\n\"alates esimesest järjenumbrist, mis on VIS3-s puudu; EHS saadab küsitud \"\n\"paki; VIS3 salvestab saadud andmed ja saadab järgmise paki päringu.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:173\nmsgid \"\"\n\"Päringute \\\"e-hääletamiste pakk\\\" töötlusloogika EHS-i poolel peab \"\n\"võimaldama VIS3-l päringuid esitada mistahes järjekorras ja kuitahes \"\n\"palju kordi.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:175\nmsgid \"\"\n\"Töötlus peab olema idempotentne (samajõuline) - selles mõttes, et VIS3 \"\n\"võib päritud andmeid igal ajal uuesti küsida. Uuesti pärimisega ei tohi \"\n\"tekkida duubelandmeid, tähendusnihkeid ega kinnijooksmisi.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:177\nmsgid \"\"\n\"Tehnilise taustateabena märgime, et EHS hoiab e-hääletamise fakte mitte \"\n\"relatsioonilises andmebaasis, vaid etcd mäluteenuses.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:179\nmsgid \"Kohaletoimetamise garantii\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:180\nmsgid \"\"\n\"Sõltuvalt e-hääletamise sagedusest ja EHS jõudlusest ning seadistusest \"\n\"võib EHS-s juhtuda, et e-hääletamise väga suure sageduse perioodil \"\n\"e-hääletamise faktile järjenumbri omistamine ajalõpu (ingl timeout) tõttu\"\n\" ebaõnnestub. Selline e-hääletamise fakt jääb e-hääletamiste nimekirjas \"\n\"VIS3-e edastamata.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:182\nmsgid \"\"\n\"Seega e-hääletamiste nimekiri ei anna kõigi e-hääletamiste VIS3-e \"\n\"jooksvalt kohaletoimetamise garantiid. VIS3-e kohaletoimetatud fakte \"\n\"tuleb käsitada informatiivsetena. E-hääletamise faktid toimetatakse \"\n\"VIS3-e kindlalt täielikus koosseisus e-hääletanute (lõplikus) nimekirjas,\"\n\" pärast e-hääletamise perioodi lõppu (eraldi liides EHS ja VIS3 vahel).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:184\nmsgid \"Teenuse pakkumise ajaline ulatus\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:186\nmsgid \"\"\n\"Konkreetse valimissündmuse kohta pakub EHS e-hääletamiste nimekirja \"\n\"ainult piiratud perioodil. See periood hõlmab e-hääletamise perioodi \"\n\"(kehtiva õiguse kohaselt 6 päeva) koos lühikeste siirdeperioodidega enne \"\n\"ja pärast.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:188\nmsgid \"\"\n\"Kui EHS valimissündmuse kohta e-hääletamiste nimekirja enam ei paku, siis\"\n\" päringud otspunktidesse \\\"Viimane järjenumber\\\" ja \\\"e-hääletanute \"\n\"pakk\\\" saavad HTTP vastuskoodi `410 Gone`.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:190\nmsgid \"\"\n\"Valimissündmuste loetelu pakub EHS pidevalt (otspunkt \\\"Valimissündmuste \"\n\"loetelu\\\"). Loetelus on valimissündmused, mille kohta EHS on valmis \"\n\"e-hääletamiste nimekirja pakkuma.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:192\nmsgid \"Kontroll ja veaolukordade käsitlemine\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:194\nmsgid \"\"\n\"Eeldatakse, et EHS-i poolt VIS3-le väljastatav on korrektne ja muutumatu \"\n\"(e-hääletamiste nimekirja piires). Parandus- ja muutmiskirjeid käesolev \"\n\"protokoll ei sisalda.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:196\nmsgid \"\"\n\"Pärast e-hääletamise lõppu, valimispäeval, edastatakse EHS-st VIS3-le \"\n\"e-hääletanute lõplik nimekiri). See edastus on spetsifitseeritud: \"\n\"[E-hääletanute \"\n\"nimekiri](https://github.com/e-gov/VIS3-EHS/blob/main/4_e_haaletanute_nimekiri/SPEC.md).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:198\nmsgid \"VIS3 operaator laeb e-hääletanute lõpliku nimekirja VIS3-e.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:200\nmsgid \"\"\n\"Jooksva nimekirja ja lõpliku nimekirja erinevuse korral loetakse \\\"tõe \"\n\"allikaks\\\" lõplik nimekiri. Seega: 1) kui lõplikus nimekirjas on isik, \"\n\"kes hääletamisperioodil edastatud nimekirjas puudub, siis loetakse isik \"\n\"e-hääletanuks; 2) kui hääletamisaegses nimekirjas on isik, kes lõplikus \"\n\"nimekirjas puudub, siis märge sellise isiku kohta VIS3-s küll \"\n\"säilitatakse, kuid töötluses ja toimingutes lähtutakse lõplikust \"\n\"nimekirjast, s.t loetakse, et isik ei ole e-hääletanud. VIS3 peab omama \"\n\"võimekust hääletamisaegse ja lõpliku nimekirja erinevust avastada ja \"\n\"operaatorile teada anda.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:203\nmsgid \"\"\n\"EHS-st VIS3-e edastatud e-hääletamise faktid on VIS3 kasutajaliideses \"\n\"nähtavad valimiste korraldajale, vaates \\\"Valijaga seotud toimingute \"\n\"ajalugu\\\". Kui valija e-hääletas mitu korda, siis on valijaga seotud \"\n\"toimingute ajaloos esitatud kõik valija e-hääletamised. E-hääletamise \"\n\"juures on näha kuupäev ja kellaaeg, millal e-hääletamise fakt EHS-st \"\n\"VIS3-e edastati.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:205\nmsgid \"Kirjandus\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:207\nmsgid \"\\\\[1] Git. https://git-scm.com/.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:209\nmsgid \"\"\n\"\\\\[2] CouchDB Replication Protocol, \"\n\"https://guide.couchdb.org/draft/replication.html.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/9_e_haaletamiste_nimekiri/SPEC.md:211\nmsgid \"\"\n\"\\\\[3] Principle and application of Rsync algorithm. \"\n\"https://developpaper.com/principle-and-application-of-rsync-algorithm/.\"\nmsgstr \"\"\n\n" }, { "path": "Documentation/public/liidesed/locales/et/LC_MESSAGES/VIS3-EHS/README.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2025.\n#\n#, fuzzy\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-03 23:20+0000\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language: et\\n\"\n\"Language-Team: et \\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../VIS3-EHS/README.md:1\nmsgid \"VIS3-EHS liideste spetsifikatsioonid\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:3\nmsgid \"\"\n\"Eesti riiklikel valimistel toimub e-hääletamine Valimiste infosüsteemi \"\n\"(VIS3) ja e-hääletamise süsteemi (EHS) koostöös. EHS roll on \"\n\"elektroonilise hääletamise läbiviimine lähtudes valimise definitsioonist,\"\n\" mis koostatakse valimise korraldaja poolt VIS3 abil. E-hääletamise ajal \"\n\"vahetavad EHS ja VIS3 informatsiooni - võivad muutuda valijate nimekirjad\"\n\" ning liigub info e-häälte laekumise kohta.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:5\nmsgid \"\"\n\"Dokument esitab VIS3 ja e-hääletamise süsteemi EHS vaheliste liideste \"\n\"spetsifikatsioonid.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:7\nmsgid \"\"\n\"Spetsifikatsioonid on avalikud. Spetsifikatsioonid ei käsitle VIS3 ega \"\n\"EHS konfidentsiaalset siseehitust ega liideste konfidentsiaalseid \"\n\"elemente.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:10\nmsgid \"Ülevaade\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:12\nmsgid \"![VIS3 ja EHS liidesed (ülevaade)](img/vis-ehs.png)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:12\nmsgid \"VIS3 ja EHS liidesed (ülevaade)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:14\nmsgid \"Joonis 1. VIS3 ja EHS liidesed (ülevaade).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:16\nmsgid \"Märkus: Joonise originaal vt VIS3 dok-s RIAs, fail \\\"EHS\\\".\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:18\nmsgid \"Vasakul on VIS3, mooduli täpsusega:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:20\nmsgid \"KAN - Kandidaadimoodul\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:21\nmsgid \"NIM - Nimekirjamoodul\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:22\nmsgid \"TUL - Valimistulemuse moodul\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:23\nmsgid \"VAL - Valimissündmuse moodul\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:24\nmsgid \"VTA - Valimistulemuse avalikustamise moodul.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:26\nmsgid \"\"\n\"Andmed liiguvad noole suunas. HTTPS masinliidestes on teenust pakkuvad \"\n\"otspunktid VIS3 poolel. X-tee liideses on teenusepakkujaks EHS. Inim-\"\n\"masinliides tähendab seda, et ühe süsteemi operaator laeb faili \"\n\"süsteemist alla ja edastab teise süsteemi operaatorile, kes laeb faili \"\n\"teise süsteemi üles.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:29\nmsgid \"Liidesed on täpsemalt kirjeldatud allpool.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:31\nmsgid \"Spetsifikatsioonid\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:33\nmsgid \"[1 Valimisringkondade nimekiri](1_Valimisringkondade_nimekiri/SPEC.md)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:35\nmsgid \"[2 Valikute nimekiri (kandidaatide nimekiri)](2_Valikute_nimekiri/SPEC.md)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:37\nmsgid \"[3 Valijate nimekiri EHS-le](3_Valijate_nimekiri/SPEC.md)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:39\nmsgid \"[4 E-hääletanute nimekiri](4_e_haaletanute_nimekiri/SPEC.md)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:41\nmsgid \"[5 Tühistus- ja ennistusnimekiri](5_Tyhistusnimekiri/SPEC.md)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:43\nmsgid \"[6 E-hääletamise tulemus](6_e_haaletamise_tulemus/SPEC.md)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:45\nmsgid \"\"\n\"[7 E-hääletamisest osavõtu \"\n\"üldstatistika](7_e_haaletamise_yldstatistika/SPEC.md)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:47\nmsgid \"\"\n\"[8 E-hääletamisest osavõtu \"\n\"detailstatistika](8_e_haaletamise_detailstatistika/SPEC.md)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:49\nmsgid \"[9 E-hääletamiste nimekiri](9_e_haaletamiste_nimekiri/SPEC.md)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:51\nmsgid \"\"\n\"Spetsifikatsioonides kasutatav valimissündmuse identifikaator peab \"\n\"vastama formaadile [Valimissündmuse \"\n\"identifikaator](valimissündmuse_identifikaator.md).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:53\nmsgid \"Usalduse loomine masinliidestes\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:55\nmsgid \"Masinliidesed kaitstakse HTTPS-ga ja TLS mõlemapoolse autentimisega.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:57\nmsgid \"\"\n\"Lisaks piiratakse VIS3 seadistusega EHS pääs ainult EHS-le määratud \"\n\"otspunktidele (3b ja 7).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:59\nmsgid \"Veakäsitlus masinliidestes\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:61\nmsgid \"\"\n\"VIS3 peab andma HTTP standardi kohase vastuskoodi ja veateate, kui EHS \"\n\"saadetud päring on ebakorrektne või VIS3 ei suuda päringut teenendada.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:63\nmsgid \"\"\n\"EHS peab arvestama VIS3 tõrke võimalusega. Standardne reaktsioon tõrkele \"\n\"on päringu uuestisaatmine.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:65\nmsgid \"Veakäsitlus faili inimese poolt edastamise liidestes\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:67\nmsgid \"\"\n\"VIS3 peab kontrollima üleslaetud faili süntaksit ja kus võimalik, kas \"\n\"semantikat. Ebakorrektse faili kohta tuleb anda operaatorile teada. \"\n\"Ebakorrektse faili andmeid ei kanta VIS3 andmebaasi.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:69\nmsgid \"\"\n\"Korrektse, kuid eksitusena üleslaetud faili andmeid saab VIS3 \"\n\"andmebaasist kustutada ja õige fail uuesti üles laadida.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:71\nmsgid \"Muudatused võrreldes VIS2-EHS-ga\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:73\nmsgid \"VIS3-EHS liideses on võrreldes VIS2-ga muudetud ja ajakohastatud:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:75\nmsgid \"\"\n\"osapoolte vahetumisest (valijate nimekirja hakkab EHS-le saame mitte RR\"\n\"/SMIT-ist, vaid RIA VIS3-st)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:76\nmsgid \"valimisõiguse muutumisest (jaoskondade tähenduse muutumine)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:77\nmsgid \"valijate nimekirja ja selle uuenduste edastamisest üle liidese.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:79\nmsgid \"\"\n\"VIS2 ja EHS omavahelisi liideseid spetsifitseerib \\\"IVXV protokollide \"\n\"kirjeldus\\\" (v 1.5.0, 20.04.2019), \"\n\"[https://www.valimised.ee/sites/default/files/uploads/eh/IVXV-\"\n\"protokollid.pdf](https://www.valimised.ee/sites/default/files/uploads/eh\"\n\"/IVXV-protokollid.pdf). \\\"Elektroonilise hääletamise protokollistik \"\n\"defineerib elektroonilise hääletamise süsteemi komponentide vahelise \"\n\"sõnumivahetuse, kasutatavad andmestruktuurid, algoritmid ning liidesed \"\n\"väliste süsteemidega.\\\" Spetsifitseeritud on:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:81\nmsgid \"liides \\\"Valimisringkondade nimekiri\\\" (jaotis 3.2)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:82\nmsgid \"liides \\\"Valikute nimekiri\\\" (jaotis 3.4)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:83\nmsgid \"liides \\\"Valijate nimekiri\\\" (jaotis 3.3)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:84\nmsgid \"liides \\\"Tühistus- ja ennistusnimekiri\\\" (jaotis 9.1)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:85\nmsgid \"liides \\\"E-hääletanute nimekiri\\\" (jaotis 9.2)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:86\nmsgid \"liides \\\"E-hääletamise tulemus\\\" (jaotis 9.3)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:88\nmsgid \"\"\n\"Käesolevad spetsifikatsioonid tuginevad ülalnimetatud \"\n\"spetsifikatsioonidele. Täpsemalt vt konkreetsete spetsifikatsioonide \"\n\"juures.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/README.md:90\nmsgid \"\"\n\"EHS lähtekood on kättesaadav: [https://github.com/vvk-\"\n\"ehk/ivxv](https://github.com/vvk-ehk/ivxv).\"\nmsgstr \"\"\n\n" }, { "path": "Documentation/public/liidesed/locales/et/LC_MESSAGES/VIS3-EHS/Taustateave/README.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2025.\n#\n#, fuzzy\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-03 23:20+0000\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language: et\\n\"\n\"Language-Team: et \\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../VIS3-EHS/Taustateave/README.md:1\nmsgid \"\"\n\"Kaustas on spetsifikatsioonid X-tee teenustele, millega VIS3 pärib \"\n\"Rahvastikuregistrist valijate nimekirja ja nimekirja muudatused:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/Taustateave/README.md:4\nmsgid \"\"\n\"`RRValimisteAlgNimekiri_kirjeldus.pdf` - Rahvastikuregistri poolt \"\n\"osutatava Valimiste algnimekirja X-tee teenuse spetsifikatsioon.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/Taustateave/README.md:7\nmsgid \"\"\n\"`RRValimisteNimekirjaMuudatused.pdf` - Rahvastikuregistri poolt osutatava\"\n\" Valimiste algnimekirja muudatuste X-tee teenuse spetsifikatsioon.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/Taustateave/README.md:10\nmsgid \"\"\n\"Spetsifikatsioonid võivad aidata mõista VIS3 poolt EHS-le pakutavate \"\n\"andmete koosseisu ja tähendust.\"\nmsgstr \"\"\n\n" }, { "path": "Documentation/public/liidesed/locales/et/LC_MESSAGES/VIS3-EHS/valimissündmuse_identifikaator.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2025.\n#\n#, fuzzy\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-03 23:20+0000\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language: et\\n\"\n\"Language-Team: et \\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:1\nmsgid \"Valimissündmuse identifikaator\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:3\nmsgid \"\"\n\"Üht valimist puudutav andmestik on seotud unikaalse valimissündmuse \"\n\"identifikaatori abil.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:5\nmsgid \"\"\n\"Valimissündmuse identifikaator on sõne, mis koosneb kahest kohustuslikust\"\n\" ja kahest valikulisest osast:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:6\nmsgid \"valimissündmuse tüüp, vastavalt allolevale tabelile, nt `RK`.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:7\nmsgid \"aastanumbrist (nt `2023`)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:8\nmsgid \"valikulisest erakorraliste valimiste tunnusest `_E` ja\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:9\nmsgid \"valikulisest järjenumbrist , nt `2`.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:11\nmsgid \"Ülalnimetatud osad eraldatakse üksteisest allkriipsudega `_`.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:13\nmsgid \"\"\n\"Järjenummerdatakse tüüpide kaupa. Seejuures aasta esimese samatüübilise \"\n\"valimissündmuse korral järjenumbrit ei näidata.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:15\nmsgid \"Näited:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:16\nmsgid \"`KOV_2021`\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:17\nmsgid \"`RH_2021`\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:18\nmsgid \"`RH_2021_2` (2021. a teine rahvahääletus)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:19\nmsgid \"`RK_2023`\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:20\nmsgid \"`RK_2023_E` (2023. a Riigikogu erakorralised valimised)\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:21\nmsgid \"`RK_2023_E_2` (2023. a Riigikogu teised erakorralised valimised).\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:23\nmsgid \"\"\n\"EHSi jaoks on valimise identifikaator kuni 28 ASCII-tähemärgi pikkune \"\n\"sõne ning eelnevalt kirjeldatud struktuuri põhjal EHS otsuseid ei tee.\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:25\nmsgid \"Valimissündmuse tüüp\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:27\nmsgid \"Valimissündmuse tüüp esitatakse koodiga:\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:29\nmsgid \"`KOV` - Kohaliku omavalitsuse volikogu valimised\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:30\nmsgid \"`EP` - Euroopa Parlamendi valimised\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:31\nmsgid \"`RK` - Riigikogu valimised\"\nmsgstr \"\"\n\n#: ../../VIS3-EHS/valimissündmuse_identifikaator.md:32\nmsgid \"`RH` - Rahvahääletus.\"\nmsgstr \"\"\n\n" }, { "path": "Documentation/public/liidesed/locales/et/LC_MESSAGES/examples.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2025.\n#\n#, fuzzy\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-03 23:20+0000\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language: et\\n\"\n\"Language-Team: et \\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../examples.rst:3\nmsgid \"Skeemid ja näited\"\nmsgstr \"\"\n\n#: ../../examples.rst:7\nmsgid \"Valimisringkondade nimekiri\"\nmsgstr \"\"\n\n#: ../../examples.rst:10 ../../examples.rst:48 ../../examples.rst:84\n#: ../../examples.rst:119 ../../examples.rst:154 ../../examples.rst:189\n#: ../../examples.rst:206 ../../examples.rst:217\nmsgid \"Skeem\"\nmsgstr \"\"\n\n#: ../../examples.rst:17 ../../examples.rst:61 ../../examples.rst:97\n#: ../../examples.rst:132 ../../examples.rst:167\nmsgid \"Näide: KOV\"\nmsgstr \"\"\n\n#: ../../examples.rst:24 ../../examples.rst:55 ../../examples.rst:91\n#: ../../examples.rst:126 ../../examples.rst:161\nmsgid \"Näide: EP\"\nmsgstr \"\"\n\n#: ../../examples.rst:31 ../../examples.rst:68 ../../examples.rst:103\n#: ../../examples.rst:138 ../../examples.rst:173\nmsgid \"Näide: RH\"\nmsgstr \"\"\n\n#: ../../examples.rst:38 ../../examples.rst:74 ../../examples.rst:109\n#: ../../examples.rst:144 ../../examples.rst:179\nmsgid \"Näide: RK\"\nmsgstr \"\"\n\n#: ../../examples.rst:45\nmsgid \"Valikute nimekiri\"\nmsgstr \"\"\n\n#: ../../examples.rst:81\nmsgid \"E-hääletanute nimekiri\"\nmsgstr \"\"\n\n#: ../../examples.rst:116\nmsgid \"Tühistusnimekiri\"\nmsgstr \"\"\n\n#: ../../examples.rst:151\nmsgid \"E-hääletamise tulemus\"\nmsgstr \"\"\n\n#: ../../examples.rst:186\nmsgid \"E-hääletamise üldstatistika\"\nmsgstr \"\"\n\n#: ../../examples.rst:196\nmsgid \"Näide\"\nmsgstr \"\"\n\n#: ../../examples.rst:203\nmsgid \"E-hääletamise detailstatistika\"\nmsgstr \"\"\n\n#: ../../examples.rst:214\nmsgid \"E-hääletamiste nimekiri\"\nmsgstr \"\"\n\n" }, { "path": "Documentation/public/liidesed/locales/et/LC_MESSAGES/index.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2025.\n#\n#, fuzzy\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-03 23:20+0000\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language: et\\n\"\n\"Language-Team: et \\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../index.rst:4\nmsgid \"IVXV registreerimisteenus\"\nmsgstr \"\"\n\n" }, { "path": "Documentation/public/liidesed/spelling_wordlist.txt", "content": "com\netcd\ngit\nhtml\nhttps\nrsync\nscm\nwww\ndocs\n\ni\nb\ndok\nle\ningl\nof\nga\nlt\n\nedasisestes\nevotersbatch\nevotingsbatch\n\nedastakse\n\nliidestus\n\nid\nquery\ntabeldusmärki\ndigikonteinerist\nschema\nrepos\nretrieving\nlist\narray\ngolang\nliidestub\nnot\nfound\nconflict\nduubelandmeid\nidempotentne\ninformaalne\nsünkroonis\nsünkroonimisprotokolli\nteenendada\ntähelepanu\n\nEHS\nRR\nSMIT\nURL\nVIS\n\nlive\nmrest\ntimeout\nprinciple\napplication\ndraft\nreplication\ndeveloppaper\nalgorithm\nx\nRoad\nService\nmetadata\nprotocol\nfor\nREST\nRetrieving\nthe\nOpenAPI\ndescription\nservice\nservices\nCouchDB\nReplication\nguide\ncouchdb\nsequence\ncode\n\nAnija\nIndrek\nLeesi\nParmakson\nTarmo\nHanga\nBackus\nNaur\nPirita\nHeibergiga\n" }, { "path": "Documentation/public/protokollid/01-annotatsioon.rst", "content": ".. IVXV protokollid\n\n\n================================================================================\nAnnotatsioon\n================================================================================\n\nKäesolev dokument kirjeldab elektroonilise hääletamise infosüsteemi IVXV\nprotokollistikku.\n\nDokument annab üldise ülevaate elektroonilise hääletamise süsteemi tehnilisest\nülesehitusest ja kasutatavatest protokollidest. Dokumendis defineeritakse\nprotokollides kasutatavad ühised mõisted ja andmestruktuurid.\n" }, { "path": "Documentation/public/protokollid/02-ylevaade.rst", "content": ".. IVXV protokollid\n\n================================================================================\nÜlevaade\n================================================================================\n\nElektroonilise hääletamise protokollistik (edaspidi protokollistik) defineerib\nelektroonilise hääletamise süsteemi komponentide vahelise sõnumivahetuse,\nkasutatavad andmestruktuurid, algoritmid ning liidesed väliste süsteemidega.\nSõnumivahetus esitatakse UML suhtlusskeemidena, mis üheselt defineerivad\nsõnumite järgnevuse. Andmestruktuuride kirjeldused on varustatud BNF, ASN.1\nvõi JSON-schema notatsioonis spetsifikatsioonidega. Algoritmid esitatakse\npseudokoodina.\n\nNB! Kõigis protokollistiku andmestruktuuride väljades tuleb rangelt kinni pidada\nlubatud märkidest ning väljade minimaalsetest ja maksimaalsetest pikkustest.\nTäiendavate tühikute, tabulaatorite jms. kasutamine on keelatud ning\nspetsifikatsiooni realiseerivad rakendused peavad vorminguga mitte-vastavate\nandmete töötlemisest keelduma.\n\nProtokollistik defineerib elektroonilise hääletamise protokolli ning selle\nprotokolli realiseerimiseks vajalikud tugistruktuurid.\n\nElektroonilise hääletamise protokoll\n====================================\n\nElektroonilise hääletamise protokoll spetsifitseerib:\n\n#. elektroonilise hääle vormingu, mis võimaldab üheselt määratleda valija tahte\n konkreetsel valimisel;\n\n#. elektroonilise hääle krüpteerimise hääle salajasuse tagamiseks;\n\n#. elektroonilise hääle digitaalse allkirjastamise tervikluse ja valija\n identifitseerimise tagamiseks;\n\n#. elektroonilise hääle kvalifitseerimise kogumisteenuse poolt, hääle\n vastuvõtmise tähistamiseks;\n\nProtokoll eeldab, et valimise korraldaja defineerib valimise ning genereerib\nhäälte salastamise võtmepaari, mille avalik komponent tehakse valijarakendusele\nkättesaadavaks.\n\nProtokolli vahendusel liigub valija tahe kogumisteenuses talletatavasse e-valimiskasti\nning võetakse tulemuse kujunemisel arvesse järgmist sündmusterida pidi:\n\n#. Valija kasutab valijarakendust oma tahteavalduse elektrooniliseks\n vormistamiseks:\n\n #. tahteavaldus vormistatakse elektroonilise häälena;\n\n #. vormistatud hääl krüpteeritakse;\n\n #. krüpteeritud hääl signeeritakse valija arvutis.\n\n#. Kogumisteenus talletab elektroonilise hääle, moodustades selle käigus\n häälele kvalifitseeritud digitaalallkirja:\n\n #. elektrooniline hääl registreeritakse välises registreerimisteenuses;\n\n #. elektroonilisele häälele võetakse digitaalne ajatempel;\n\n #. elektroonilisele häälele võetakse valija sertifikaadi\n kehtivuskinnitus;\n\n #. elektroonilist häält kvalifitseerivad elemendid tagastatakse mh. ka\n valijarakendusele kontrollimiseks ning valija informeerimiseks\n kvalifitseerimise tulemustest;\n\n #. valijale võimaldatakse kvalifitseeritud elektroonilise hääle\n kontrollimine kontrollrakenduse abil.\n\n.. note::\n\n Elektroonilise hääle digitaalne allkirjastamine erineb tavapärasest\n dokumentide digitaalallkirjastamisest, kus kõik allkirja kvalifitseerimiseks\n vajalikud toimingud algatatakse vahetult allkirjastaja seadmes.\n Elektroonilise hääle kvalifitseerimise kohustus on kogumisteenusel, kelle\n ülesanne on veenduda vastuvõetavate häälte korrektses allkirjastatuses. Kuna\n e-hääletamise perioodil on koormus seotud teenustele kõrge, võimaldab\n kogumisteenuse poolt juhitud kvalifitseerimine tagada paremat teenuse\n kvaliteeti.\n\n#. Valija võib kasutada kontrollrakendust veendumaks oma hääle korrektses\n käitlemises kogumisteenuse poolt;\n\n#. Hääletamisperioodi lõppedes väljastab kogumisteenus valimise korraldajale\n e-valimiskasti ning registreerimisteenus väljavõtte kogumisteenuse poolt\n registreeritud häältest;\n\n #. e-valimiskasti koosseisus antakse valimise korraldajale üle:\n\n #. valija krüpteeritud tahteavaldus koos signatuuriga;\n\n #. registreerimisteenuse kinnitus hääle registreerimisest;\n\n #. ajatempliteenuse poolt väljastatud digitaalne ajatempel\n elektroonilisele häälele;\n\n #. kehtivuskinnitusteenuse poolt väljastatud kinnitus valija sertifikaadi\n kehtivuse kohta;\n\n #. registreerimisteenuse väljavõtte koosseisus antakse valimise korraldajale üle:\n\n #. kõik e-hääletamise perioodil kogumisteenuse poolt\n registreerimisteenusele saadetud päringud elektrooniliste häälte\n registreerimiseks.\n\n#. Valimise korraldaja arvutab hääletamistulemuse:\n\n #. kontrollitaks üle antud elektrooniliste häälte allkirjade kehtivust\n\n #. kontrollitakse, et kõik registreerimisteenuses registreeritud hääled on\n e-valimiskasti koosseisus üle antud;\n\n #. eraldatakse krüpteeritud hääled ja digitaalallkirjad;\n\n #. anonüümitakse krüpteeritud hääled krüptograafiliselt;\n\n #. dekrüpteeritakse krüpteeritud hääled;\n\n #. dekrüpteeritud häälte põhjal arvutatakse hääletamistulemus.\n\nProtokoll on analoogne paberil posti teel hääletamise protokolliga, kus valija\ntahe liigub valimiskomisjonini kahes ümbrikus – välimise ümbriku sees on\nsisemine ümbrik, mis omakorda sisaldab valija tahteavaldusega hääletussedelit.\nVälimine ümbrik kannab valijat identifitseerivat infot ning võimaldab\nmh. kontrollida valija õigust hääletada. Sisemine ümbrik on anonüümne ning\nkaitseb hääle salajasust. Enne häälte kokkulugemist eraldatakse sisemised\nümbrikud välimistest.\n\nElektroonilise hääletamise kontekstis on sisemine ümbrik vormistatud\nkrüpteeritud häälena ning välimine ümbrik digitaalselt allkirjastatud\ndokumendina.\n" }, { "path": "Documentation/public/protokollid/04-seadistus.rst", "content": ".. IVXV protokollid\n\n================================================================================\nValimise definitsioon\n================================================================================\n\nValimise defineerib valimise korraldaja. Eesti riiklikel valimistel jagunevad\nkõik hääleõiguslikud isikud ühte või mitmesse valimisringkonda. Valijal on\nvõimalik hääletamisel valida ainult selle ringkonna kandidaatide vahel, kuhu ta\nkuulub.\n\nValimise defineerimiseks tuleb määratleda vähemalt\n\n#. valimise unikaalne identifikaator ning küsimuste unikaalsed identifikaatorid;\n\n#. täielik loend valimisringkondadest ja -jaoskondadest;\n\n#. hääleõiguslike isikute nimekiri ja jagunemine valimisringkondadesse;\n\n#. kandidaatide nimekiri ja jagunemine valimisringkondadesse.\n\nValimise sisendandmed koostatakse Valimise Infosüsteemis (VIS), vormingukirjeldused on\nspetsifitseeritud `VIS ja EHS ühisspetsifikatsioonis `_.\n" }, { "path": "Documentation/public/protokollid/05-ehaal.rst", "content": ".. IVXV protokollid\n\n===================\nElektrooniline hääl\n===================\n\nIVXV hääletamisprotokoll põhineb topeltümbrikuskeemil, mis tähendab, et valija\navakujul tahteavaldus krüpteeritakse valimise korraldaja poolt levitatud\navaliku võtmega. Krüpteeritud tahteavaldus allkirjastatakse digitaalselt valija\nkäsutuses oleva allkirjastamisvahendiga ning edastatakse kogumisteenusesse\nmingis kokkulepitud konteinervormingus. Kogumisteenus võib valija poolt\nallkirjastatud häält täiendavalt kvalifitseerida, veendudes näiteks\nallkirjastamissertifikaadi kehtivuses. IVXV protokollistik näeb mh. ette\nkogumisteenuse poolt vastuvõetud häälte registreerimise välises\nregistreerimisteenuses.\n\nKogumisteenuse poolt talletamisele võetud hääl koos kvalifitseerivate\nelementidega tehakse kättesaadavaks nii valijarakendusele kui\nkontrollrakendusele, mis teostavad üksiku hääle peal samad kontrollid, mida\nhilisem valimise korraldaja töötlemisrakendus teostab kõigi häälte peal.\nKvalifitseerivate elementide kontrollimise võimalus annab valijale kindluse, et\ntema häält on hilisemates protsessides korrektselt menetletud.\n\n\nValija tahteavaldus avakujul\n============================\n\nValija tahteavaldus avakujul eksisteerib valijarakenduses ning hiljem ka\nkontrollrakenduses ja häälte kokkulugemisel võtmerakenduses. Tahteavaldus\nsisaldab valiku koodi ringkonnas ja ringkonna EHAK-koodi. Eraldajana\nkasutatakse ASCII kooditabeli sümbolit `0x2E` ehk \".\".\nVormingus spetsifitseerimata sümbolite kasutamine ei ole lubatud, vormingule\nmittevastavad sedelid loetakse kehtetuks.\n\n.. code-block:: bnf\n\n ::= \"0\" | \"1\" | \"2\" | \"3\" | \"4\" | \"5\" | \"6\" | \"7\" | \"8\" | \"9\"\n\n ::= \n\n ::= \n | \n\n ::= 0x2E\n\n ::= \n\n\nJärgmised tahteavaldused on vormistatud korrektselt:\n\n.. code-block:: bnf\n\n 0000.123\n 0321.1234\n 0000.1234\n\nJärgmised tahteavaldused ei ole vormistatud korrektselt:\n\n.. code-block:: bnf\n\n 0000 . 123 (* vorming ei näe ette tühikute kasutamist *)\n 0000-123 (* vorming lubab eraldajana vaid sümbolit \".\" *)\n 123 (* mõlemad vormingukomponendid tuleb esitada *)\n 321.1234 (* EHAK kood on 4-kohaline identifikaator *)\n\n\nKrüpteeritud sedel\n==================\n\nValija tahteavaldus avakujul :token:`ballot` krüpteeritakse valijarakenduse\npoolt valimise korraldaja genereeritud avaliku võtmega. IVXV vajab\nkrüpteerimiseks mitte-deterministlikku, homomorfset avaliku võtme\nkrüptosüsteemi. Selliseks süsteemiks sobib ElGamal krüptosüsteem, mida täna\nrakendatakse IVXV kontekstis nii jäägiklassiringi `Zp` multiplikatiivsel rühmal\n`Zp*` (MODP tüüpi rühmad) kui ka elliptkõveratel (ECC tüüpi rühmad).\n\nElGamal avalik võti kodeeritakse koos ElGamal krüptosüsteemi parameetritega ning\nkonkreetset valimist iseloomustava identifikaatoriga. Krüptosüsteemi parameetrid\non osaks algoritmi identifikaatori struktuurist, avalik võti on kodeeritud X509\nstandardis kirjeldatud :token:`SubjectPublicKeyInfo` struktuuri\n:token:`subjectPublicKey` välja.\n\n::\n\n SubjectPublicKeyInfo ::= SEQUENCE {\n algorithm AlgorithmIdentifier,\n subjectPublicKey BIT STRING\n }\n\nMODP tüüpi rühmade korral identifitseerib algoritmi identifikaator\n:token:`id-ivxv-modp-elgamal`. Parameetrid vastavad struktuurile\n:token:`IVXVModPElGamalParameters` ning avalik võti struktuurile\n:token:`IVXVModPElGamalPublicKey` (:ref:`asn-modp`).\n\nECC tüüpi rühmade korral identifitseerib algoritmi identifikaator\n:token:`id-ivxv-ecc-elgamal`. Parameetrid vastavad struktuurile\n:token:`IVXVECCElGamalParameters` ning avalik võti struktuurile\n:token:`IVXVECCElGamalPublicKey` (:ref:`asn-ecc`).\n\nValija tahteavalduse krüpteerimiseks võetakse UTF-8 kodeeringus struktuur\n:token:`ballot` ning teisendatakse see ElGamal parameetrite poolt kirjeldatud\nrühma elemendiks vastavalt MODP või ECC algoritmidele. Rühma elemendiks\nteisendatud tahteavaldus krüpteeritakse ElGamal algoritmiga ning kodeeritakse\nMODP korral struktuuri :token:`IVXVModPElGamalCiphertext` (:ref:`asn-modp`) ja\nECC korral struktuuri :token:`IVXVECCElGamalCiphertext` (:ref:`asn-ecc`).\nLõplik krüpteeritud tahteavaldus esitatakse struktuuris\n:token:`IVXVElGamalCiphertext` (:ref:`asn-general`), kus väli\n:token:`algorithm` viitab rühma tüübile ning väli :token:`ciphertext`\nrühmaspetsiifilisele krüptogrammile. Andmestruktuuri\n:token:`IVXVElGamalCiphertext` DER-kodeering on krüpteeritud sedel ehk sisemine\nümbrik topeltümbriku skeemis.\n\n..\n NB! Nende algoritmide spetsifikatsioonidele tuleb viidata.\n\nTahteavalduse krüpteerimise käigus genereeritakse valijarakenduses juhuarv, mida\nElGamal krüpteerimisel kasutab. Sama juhuarv avalikustatakse hiljem\nkontrollrakendusele. Tulenevalt ElGamal krüptosüsteemi eripärast funktsioneerib\nsee juhuarv nö. teise võtmena ning võimaldab krüptogrammi dekodeerimist\nkontrollrakenduses.\n\n.. _signed-vote:\n\nValija poolt allkirjastatud hääl\n================================\n\nKrüpteeritud sedel tuleb enne kogumisteenusesse talletamisele saatmist\ndigitaalselt allkirjastada, milleks on võimalik kasutada kõiki Eesti Vabariigis\nkehtivaid digitaalallkirjavahendeid – ID-kaart, Digi-ID, Mobiil-ID, Smart-ID.\nID-kaarti saab kasutada nii TLS-CCA kui Web-eID protokolliga.\n\n.. attention::\n\n Loend digitaalallkirjavahenditest ja nendega seotud protokollidest on\n tehniliselt korrektne, kuid valimiste korraldajal on võimalus kasutada vaid\n mõnda alamhulka nimetatud vahenditest.\n\nKäesolev spetsifikatsioon näeb ette Eesti Vabariigi Standardikavandis [BDOC2.1]\ndefineeritud BDOC allkirjavormingu kasutamise. BDOC allkirjavorming koosneb ETSI\nstandardi TS 101 903 (XadES) profiilist ning OpenDocument konteineri vormingust.\n\nOlenevalt käimasoleval valimisel esitatud küsimuste arvust võib digitaalselt\nallkirjastatud hääl sisaldada ühte või mitut andmefaili MIME-tüübiga\n``application/octet-stream``. Iga andmefaili sisuks on krüpteeritud sedel.\nAndmefaili ja teiste signeeritavate andmeobjektide räsimiseks enne\nallkirjastamist kasutatakse räsifunktsiooni SHA-256. Andmefaili nimi\nmoodustatakse laiendist '``ballot``' ning valimise identifikaatorist ja\nküsimuse identifikaatorist. Kõik viidatud andmefailid peavad sisalduma\nallkirjakonteineris. Digitaalselt allkirjastatud hääl ei tohi sisaldada muid\nandmefaile kui neid, mis sisaldavad hääli mõne käimasoleva valimise kontekstis.\nSeadistusele mittevastavate häälte vastuvõtmisest, talletamisest ja\ntöötlemisest peab kogumisteenus keelduma.\n\n.. attention::\n\n Valimise identifikaator ja küsimuse identifikaator on defineeritud valimise\n korraldaja poolt loodud seadistustes ning töötlevad rakendused peavad\n lähtuma neist seadistustest otsustamaks, millised vormingule vastavad\n identifikaatorid on konkreetse sündmuse kontekstis lubatud ja millised\n mitte.\n\n\n.. code-block:: bnf\n\n ::= [ASCII]\n\n ::= 1..28 \n\n ::= 1..28 \n\n ::= \"ballot\"\n\n ::= 0x2E\n\n ::= \n\n\nValija poolt valijarakenduses allkirjastatud hääl moodustatakse nii, et on\nvõimalik selle edasine kvalifitseerimine kogumisteenuses. Käesolev\nspetsifikatsioon näeb ette hääle kvalifitseerimiseks nii PKIX ajatempli kui\nOCSP kehtivuskinnituse võtmise. Sellisena on lõplik kvalifitseeritud hääl\nvastav BDOC-TS profiilile.\n\nKui hääl allkirjastatakse ID-kaardi või Digi-ID'ga, siis toimub algse\nallkirjastatud konteineri moodustamine valijarakenduses. Kui hääl\nallkirjastatakse Mobiil-ID või Smart-ID'ga, siis toimub konteineri moodustamine\nvalijarakenduse ning kogumisteenuse poolt vahendatava Mobiil-ID/Smart-ID\nteenuse koostöös. Mobiil-ID/Smart-ID juhtumil kasutab kogumisteenus\nMobiil-ID/Smart-ID teenust ainult signatuuri saamiseks krüpteeritud sedelile.\nKõik hääle kvalifitseerimiseks vajalikud elemendid hangitakse vastavatelt\nteenustelt alles siis kui valijarakendus on saatnud signeeritud hääle\ntalletamiseks. Kvalifitseeritud hääl esitatakse kogumisteenuse poolt\nvalijarakendusele verifitseerimiseks, ainult kvalifitseeritud hääl peab vastama\nBDOC 2.1 standardi tingimustele -- valijarakenduse poolt moodustatud hääl on\nvaheetapp kvalifitseeritud hääleni jõudmiseks.\n\nValijarakenduses signeeritud häälel peab olema üks ja ainult üks allkiri, mida\nhoitakse signatuurifailis :file:`META-INF/signature0.xml`. Häält ja allkirja\nsisaldav konteiner (edaspidi viidatud kui ``SignedVote``) moodustatakse BDOC 2.1\nstandardis kirjeldatud meetodit kasutades.\n\nSpetsifitseerime valijarakenduses allkirjastatud hääle vormingu ühe\nküsimuse korral.\n\nRäsialgoritmina ``DIGEST_ALG`` on kasutusel SHA-256\n(http://www.w3.org/2001/04/xmlenc#sha256). XML kanoniseerimiseks\n(``CANON_ALG``) kasutatakse meetodit ``c14n11``\n(http://www.w3.org/2006/12/xml-c14n11).\n\nECC võtmete korral on allkirjastamismeetodiks\nhttp://www.w3.org/2001/04/xmldsig-more#ecdsa-sha256. RSA võtmeid enam ei\nkasutata.\n\nIdentifikaatorite `VOTE_REF`, `SP_REF`, `SP_URI` ning `SV_URI` täpne väärtus ei\nole fikseeritud.\n\nElement `SignedProperties`\n---------------------------\n\nElement ``SignedProperties`` moodustatakse kooskõlas BDOC 2.1 standardiga. Kui\nkvalifitseerimisel kasutatakse ajatemplit, siis elementi\n``SignaturePolicyIdentifier`` ei kasutata. Ühtegi mitte-kohustuslikku elementi\nei kasutata. Allkirjastamise kellaaja fikseerib andmestruktuuri täitev arvuti\nning valija X509-sertifikaat saadakse kas ID-kaardilt, Mobiil-ID, Smart-ID\nvõi Web eID teenuse vahendusel.\n\n\n.. literalinclude:: ../../common/xmltemplates/sp.template\n :language: xml\n :linenos:\n\n\nElement `SignedInfo`\n---------------------\n\nElement ``SignedInfo`` moodustatakse kooskõlas BDOC 2.1 standardiga, viidates\nnii krüpteeritud sedelile (``VOTE_DIGEST``) kui elemendile ``SignedProperties``\n(``SP_DIGEST``).\n\n.. literalinclude:: ../../common/xmltemplates/si.template\n :language: xml\n :linenos:\n\n\nElement `SignatureValue`\n------------------------\n\nElement ``SignatureValue`` moodustatakse kooskõlas BDOC 2.1 standardiga.\nKanoniseeritud elemendist ``SignedInfo`` arvutatakse räsi, mis allkirjastatakse\nPKCS1-meetodiga.\n\n.. literalinclude:: ../../common/xmltemplates/sv.template\n :language: xml\n :linenos:\n\n\nElement `XAdESSignatures`\n-------------------------\n\nElement ``XAdESSignatures`` sisaldab ühte ``Signature`` elementi, mis on\nkoostatud lähtudes kõigist eelmistest elementidest ning valija X509\nsertifikaadist. Elementi ``UnsignedProperties`` ei kasutata.\n\n.. literalinclude:: ../../common/xmltemplates/sig.template\n :language: xml\n :linenos:\n" }, { "path": "Documentation/public/protokollid/06-talletamine.rst", "content": ".. IVXV protokollid\n\n====================================================\nElektroonilise hääle kvalifitseerimine talletamiseks\n====================================================\n\nKvalifitseeritud hääl\n=====================\n\nValijarakenduse töö tulemusena saadetakse kogumisteenusesse talletamiseks\ntopeltümbrik, mis sisaldab endas valija tahteavaldust krüpteeritud kujul, valija\nallkirja krüpteeritud tahteavaldusel kooskõlastatud allkirja- ja\nkonteinervormingus ning valija allkirjastamissertifikaati X509-vormingus.\n\nHääle edukaks talletamiseks näeb IVXV protokoll ette hääle registreerimise\nvälise registreerimisteenuse osutaja juures ning registreerimistõendi\nvalijarakendusele kättesaadavaks tegemise. Valimise korraldaja võib hääle\nkvalifitseerimiseks näha ette täiendavaid samme lisaks registreerimisele --\nnäiteks kehtivuskinnituse hankimist hääle allkirjastanud sertifikaadi kohta.\n\nKõik kogumisteenuse poolt hangitavad kvalifitseerivad elemendid, mis määravad\nhääle staatuse hilisemates töötlusetappides, tuleb esitada valijarakendusele ning\nnõudmise korral ka kontrollrakendusele tagamaks, et valija saab oma hääle\nkorrektse menetlemise võimalikkusest õigeaegselt teada.\n\nOCSP kehtivuskinnitus\n---------------------\n\nOCSP (*Online Certificate Status Protocol*) on standartne protokoll\nX509-sertifikaatide kehtivusinfo pärimiseks. Kogumisteenus võib seda protokolli\nkasutada hääle allkirjastanud sertifikaadi kehtivuse teadasaamiseks. OCSP\nvastus ütleb, et sertifikaat kehtis päringu tegemise ajahetkel, kuid ei seosta\nOCSP vastust konkreetse allkirjaga.\n\nRFC3161 ajatempel\n-----------------\n\nRFC3161 ajatempli protokolliga saadakse usaldusteenuse pakkujalt kinnitus, et\nmingi andmekogum eksisteeris enne teatud ajahetke. BDOC-TS kontekstis\najatembeldatakse allkirja element ``SignatureValue`` kanoniseeritud kujul.\nKlassikaline OCSP vastus koos RFC 3161 vormingus ajatempliga kvalifitseerivad\nBDOC-TS allkirja.\n\nTalletamine\n====================================================\n\nElektroonilise hääle talletamine kogumisteenuses tähendab:\n\n#. hääle vastuvõtmist valijarakenduselt ning hääletaja allkirja\n verifitseerimist;\n\n#. hääle võimalikku kvalifitseerimist -- näiteks sertifikaadi kehtivuse\n tõendamist hääle allkirjastamisele lähedasel ajahetkel;\n\n#. hääle registreerimist sõltumatus registreerimisteenuses;\n\n#. häält kvalifitseerivate elementide vahendamist valijarakendusele.\n\nErinevad kombinatsioonid allkirjavormingust ning hääli kvalifitseerivatest\nteenustest võivad tekitada erinevaid IVXV-profiile. Konkreetse dokumendi raames\non IVXV profiil:\n\n#. Allkirjastatud hääle vorming on BDOC-TS;\n\n#. Kehtivuskinnitusprotokolliks on standartne OCSP;\n\n#. BDOC-TS kvalifitseerimiseks kasutatav RFC3161 ajatempel on kasutusel ka\n registreerimistõendina.\n" }, { "path": "Documentation/public/protokollid/06a-regteenus.rst", "content": ".. IVXV registreerimisteenus\n\n====================================\nElektroonilise hääle registreerimine\n====================================\n\nHääle edukaks talletamiseks näeb IVXV protokoll ette hääle registreerimise\nvälise registreerimisteenuse osutaja juures ning registreerimistõendi\nvalijarakendusele kättesaadavaks tegemise. Registreerimisteenus toimub RFC3161\najatempli protokolli baasil. Protokolli on laiendatud selliselt, et\nkogumisteenus saab ajatempli päringule anda oma signatuuri, mis teeb võimalikuks\nhilisema võrdleva väljavõtte registreerimisteenusest. Sõltumatu\nregistreerimisteenuse olemasolu vähendab häälte kogumisteenuse poolt \"kaotamise\"\nriski.\n\nRegistreerimisteenus\n====================\n\nRegistreerimisteenus on teenus, mille abil Kogumisteenus registreerib kõik\nHääletajatelt saadud hääled. Pärast hääletamisperioodi lõppu edastab\nKogumisteenus talletatud hääled Töötlejale ning Registreerimisteenus edastab\nregistreeritud hääled Töötlejale.\n\nRegistreerimisteenus aitab tagada e-valimiskasti terviklust. Eeldame et Kogumisteenusel\npuudub võimalus võltsida digitaalallkirja ning sellisel moel tekitada juurde\nhääli või muuta juba talletatud hääli. Riskina säilib võimalus, et Kogumisteenus\nei anna kõiki talletatud hääli Töötlejale üle. Häälte valikulise üleandmise\nriski maandamiseks kasutab IVXV protokoll täiendavat Registreerimisteenust, kuhu\nKogumisteenus iga talletatud hääle registreerib. Hääletajal on\nprotokollikohaselt võimalus korrektses registreerimises veenduda --\nRegistreerimisteenuse digitaalselt allkirjastatud kinnitus konkreetse hääle\nregistreerimise kohta esitatakse ka konkreetsele hääletajale.\n\nRegistreerimisteenus protokollis\n--------------------------------\n\nKogumisteenus saadab Registreerimisteenusele enda poolt allkirjastatud\nregistreerimiskorralduse (edaspidi KORRALDUS), mis sisaldab hääle\nidentifikaatorit ja allkirjastatud hääle räsi::\n\n KORRALDUS = Sign_K(V_id, Hash(VOTE))\n\nRegistreerimisteenus talletab KORRALDUSE hilisemaks väljastamiseks ning vastab\nKogumisteenusele oma poolt allkirjastatud registreerimiskinnitusega (edaspidi\nKINNITUS), mis allkirjastab algset KORRALDUST ning KINNITUSE väljastamise aega::\n\n KINNITUS = Sign_R(Hash(KORRALDUS), t)\n\nKogumisteenus tagastab nii KINNITUSE kui KORRALDUSE valijarakendusele, Hääletaja\nsaab teate hääle positiivsest talletamisest ainult KINNITUSE ja selle aluseks\nolnud KORRALDUSE edukal verifitseerimisel.\n\nHääletamisperioodi lõppedes edastab Registreerimisteenus Kogumisteenuse poolt\ntehtud KORRALDUSED Töötlejale.\n\nRegistreerimisteenus peab Töötlejale algselt andma üle vähemalt loendi::\n\n (V_id, Hash(VOTE))\n\nKui Registreerimisteenus annab üle ainult ülalkirjeldatud loendi, siis peab ta\nhiljem oleme võimeline andma loendi nõutud elemendile vastava korralduse::\n\n (V_id, Hash(VOTE)), Sign_K(V_id, Hash(VOTE))\n\n\n.. figure:: model/img/phase1.png\n\n Registreerimisteenuse roll hääletamisel\n\n\n.. figure:: model/img/phase2.png\n\n Registreerimisteenuse roll hääle kontrollimisel\n\n\n.. figure:: model/img/phase3.png\n\n Registreerimisteenuse roll häälte üleandmisel\n\n\nRegistreerimisteenuse liidesed\n------------------------------\n\nRegistreerimisteenusel on kaks liidest\n\n#. KORRALDUSTE vastuvõtmise ja KINNITUSTE väljastamise liides;\n\n#. KORRALDUSE alusel väljastatud KINNITUSTE loetelu ja nende aluseks olnud\n KORRALDUSTE väljastamise liides.\n\nRegistreerimisteenuse funktsionaalsuseks on Kogumisteenusele KINNITUSTE\nväljastamine, väljastatud KINNITUSTE ja neile aluseks olevate KORRALDUSTE\nsäilitamine ja hilisem Töötlejale üleandmine.\n\nKui Registreerimisteenus osutab teenust mitmele erinevale osapoolele, siis peab\nolema garanteeritud, et konkreetse valimisega seotud Kogumisteenuse KORRALDUSED\nja neile vastavad KINNITUSED on Valijarakenduse ja Kontrollrakenduse poolt\nkontrollitavalt eristatavad teiste osapoolte KORRALDUSTEST ning neile\nvastavatest KINNITUSTEST. Vastasel juhul võib tekkida olukord, kus Kogumisteenus\nküll registreerib hääle, kuid info sellest ei jõua Töötlejani.\n\nRegistreerimisteenus peab olema võimeline kõiki Kogumisteenuse poolt tulnud\nKORRALDUSI üle andma.\n\nOsapoolte nõuded registreerimisteenusele\n----------------------------------------\n\nTöötleja\n````````\n\nTöötleja ülesanne on muuhulgas tuvastada,\n\n#. millised Kogumisteenuse poolt üle antud hääled lähevad lugemisele ja\n\n#. kas Kogumisteenus on jätnud hääli üle andmata.\n\nTöötleja töö tulemusena selguvaid erisusi tuleb lahendada ning siin on järgmised\n3 juhtumit:\n\n#. Kogumisteenus annab Töötlejale üle allkirjastatud hääle koos KINNITUSega,\n Registreerimisteenus annab Töötlejale üle Kogumisteenuse KORRALDUSE, mille\n alusel KINNITUS anti - vaidlust ei ole, kui konkreetne hääl oli antud\n Hääletaja jaoks viimane, siis suunatakse ta lugemisele.\n\n#. Kogumisteenus annab Töötlejale üle allkirjastatud hääle koos KINNITUSega,\n Registreerimisteenus ei anna Töötlejale selle hääle kohta midagi üle. Kuna\n KINNITUS on Registreerimisteenuse poolt allkirjastatud, siis on viga\n Registreerimisteenuse poolel. Kui konkreetne hääl oli antud Hääletaja jaoks\n viimane, siis suunatakse ta lugemisele.\n\n#. Registreerimisteenus annab Töötlejale üle Kogumisteenuse KORRALDUSE,\n Kogumisteenus ei anna Töötlejale vastava räsiga häält üle. Kuna KORRALDUS on\n Kogumisteenuse poolt allkirjastatud, siis on viga Kogumisteenuse poolel ning\n antud hääl tuleb üles otsida.\n\nHääletaja\n`````````\n\nHääletaja jaoks on oht, et Kogumisteenus võib tema hääle 'unustada'.\nNõuetekohase KINNITUSE nägemine annab Hääletajale kindluse, et väline osapool\ngaranteerib tema hääle Töötlejani jõudmist. Kindluse jaoks on oluline:\n\n#. KINNITUS on Registreerimisteenuse poolt allkirjastatud;\n\n#. KINNITUSES sisalduv algne KORRALDUS on Kogumisteenuse poolt allkirjastatud;\n\n#. usaldus, et Registreerimisteenus on võimeline KINNITUSE andmise fakti meeles\n pidama;\n\n#. usaldus, et Registreerimisteenus on võimeline KINNITUSE andmise kohasust\n Töötlejale tõestama;\n\n#. usaldus, et Kogumisteenusel ei ole võimalik hankida alternatiivset\n valekinnitust, mis Valijarakenduses verifitseerub, kuid Töötlejani ei jõua.\n\nKogumisteenus\n`````````````\n\nKogumisteenuse jaoks on oht, et Registreerimisteenuse poolt üleantud KINNITUSTE\nja talletatud häälte vaated erinevad. Kogumisteenuse poolt KORRALDUSELE antud\nallkiri on Kogumisteenuse garantii, et Registreerimisteenuse poolt ei saa\ntekkida fiktiivseid KINNITUSI, mida Kogumisteenus tegelikult nõudnud pole.\n\nKogumisteenus talletab kõiki Registreerimisteenuse vastuseid. Kuna need on\nallkirjastatud, siis on täiendav info oluline vaid siis kui Kogumisteenus\nväidab, et mingit KORRALDUST ei ole antud, kuigi Registreerimisteenus on ``(v_id,\nHash(VOTE))`` esitanud. Sellisel juhul saab Registreerimisteenus esitada terve\nKogumisteenuse KORRALDUSE (või vähemalt selle allkirjastatud komponendi)\n\nRegistreerimisteenus\n````````````````````\n\nRegistreerimisteenus on huvitatud, et vaidlusolukordades, kus Kogumisteenus\njätab midagi üle andmata, oleks tal võimalik oma tegevuse korrektsust tõestada.\nOluline on tagada:\n\n#. Kogumisteenuse poolt konkreetse valimise raames antavad KORRALDUSED on\n teiste klientide poolt esitatud KORRALDUSTEST kontrollitavalt eristatavad.\n\n#. Kogumisteenus ei saa juba esitatud KORRALDUSTE kohta väita, et ta neid ei\n esitanud.\n\nRegistreerimisteenuse realiseerimine RFC 3161 protokolli raamistikus\n--------------------------------------------------------------------\n\nPKIX on ajatembeldusprotokoll, kus usaldatav kolmas osapool (ajatempliteenuse\nosutaja ehk ATO) kinnitab oma allkirjaga andmete eksisteerimist konkreetsel\najahetkel. Protokoll koosneb ühest päringust ja vastusest.\n\nAjatemplipäring::\n\n TimeStampReq ::= SEQUENCE {\n version INTEGER { v1(1) },\n messageImprint MessageImprint,\n --a hash algorithm OID and the hash value of the data to be\n --time-stamped\n reqPolicy TSAPolicyId OPTIONAL,\n nonce INTEGER OPTIONAL,\n certReq BOOLEAN DEFAULT FALSE,\n extensions [0] IMPLICIT Extensions OPTIONAL }\n\nAjatembeldatavad andmed esitatakse teenusele ``messageImprint`` koosseisus räsina.\n``TimeStampReq`` ei sisalda endas päringu esitaja allkirja.\n\nATO vastus ajatemplipäringule::\n\n TimeStampResp ::= SEQUENCE {\n status PKIStatusInfo,\n timeStampToken TimeStampToken OPTIONAL }\n\n TimeStampToken ::= ContentInfo\n -- contentType is id-signedData ([CMS])\n -- content is SignedData ([CMS])\n\n TSTInfo ::= SEQUENCE {\n version INTEGER { v1(1) },\n policy TSAPolicyId,\n messageImprint MessageImprint,\n -- MUST have the same value as the similar field in\n -- TimeStampReq\n serialNumber INTEGER,\n -- Time-Stamping users MUST be ready to accommodate integers\n -- up to 160 bits.\n genTime GeneralizedTime,\n accuracy Accuracy OPTIONAL,\n ordering BOOLEAN DEFAULT FALSE,\n nonce INTEGER OPTIONAL,\n -- MUST be present if the similar field was present\n -- in TimeStampReq. In that case it MUST have the same value.\n tsa [0] GeneralName OPTIONAL,\n extensions [1] IMPLICIT Extensions OPTIONAL }\n\n\n``TimeStampResp`` on ATO poolt digitaalselt allkirjastatud konteiner, mis sisaldab\nendas päringu koosseisus saadud välja ``messageImprint`` ning nonssi.\n\nRegistreerimisteenuse huvides on, et Kogumisteenuse päring oleks signeeritud.\nKuna RFC 3161 ei toeta allkirjastatud päringuid on alternatiiviks kasutada mõnda\nlaiendust, mis võimaldab Kogumisteenuse signatuuri edastamist. See laiendus\ntuleks teenuse poolt ajatempli koosseisus ka tagasi saata. Kuna RFC 3161 ei\nsõnasta laienduste tagasipeegeldamise nõuet ühemõtteliselt on reaalne võimalus\nkasutada protokolli laiendamiseks ajatemplipäringu nonssi. Nonss on ASN.1\nINTEGER andmetüüp kuhu saab kodeerida suvalise struktuuriga andmeid, mis teeb\nvõimalikuks järgmise skeemi:\n\nEnne hääletamist:\n\n#. Kogumisteenus genereerib allkirjastamisvõtme ja sertifikaadi.\n\n#. Kogumisteenus annab sertifikaadi Korraldajale üle.\n\n#. Kogumisteenus seadistab ennast ATO'd kasutama.\n\nHääletamise ajal:\n\n#. Valija saadab hääle talletamiseks.\n\n#. Kogumisteenus räsib hääle, allkirjastab räsi ning võtab räsile ajatempli,\n kasutades ajatemplipäringu TimeStampReq nonsina oma allkirja sellel räsil.\n\n#. ATO töötleb ajatemplipäringut kooskõlas RFC 3161 nõuetega ning väljastab\n allkirjastatud ajatempli.\n\n#. Kogumisteenus vahendab ajatempli Valijarakendusele, mis teostab järgmised\n kontrollid:\n\n a) ajatempel on ATO poolt allkirjastatud,\n b) ajatempel sisaldab nonssi,\n c) ajatempel sisaldab tema hääle räsi,\n d) nonss on Kogumisteenuse poolt allkirjastatud valija hääle räsi.\n\nPeale hääletamist:\n\n#. Korraldaja annab ATO'le ajavahemiku ja Kogumisteenuse sertifikaadi\n\n#. ATO otsib kõigi selle ajavahemiku ajatemplipäringute ja vastuste hulgast\n neid, millel\n\n a) on nonss,\n b) nonss dekodeerub kokkuleppeliseks andmestruktuuriks,\n c) andmestruktuur verifitseerub Kogumisteenuse sertifikaadiga.\n\n#. ATO annab üle kõik leitud ajatemplipäringud ja ajatemplid.\n\n#. Kogumisteenus annab üle kõik ajatemplipäringud, ajatemplid ja hääled.\n\n#. Töötleja analüüsib andmeid vastavalt protokollile\n\n#. KINNITUS on Registreerimisteenuse poolt allkirjastatud;\n\n#. KINNITUSES sisalduv algne KORRALDUS on Kogumisteenuse poolt allkirjastatud;\n\n#. Usaldus, et Registreerimisteenus on võimeline KINNITUSE andmise fakti meeles\n pidama;\n\n#. Usaldus, et Kogumisteenusel ei ole võimalik hankida alternatiivset\n valekinnitust, mis Valijarakenduses verifitseerub, kuid Töötlejani ei jõua\n\n#. Usaldus, et Registreerimisteenus on võimeline KINNITUSE andmise kohasust\n Töötlejale tõestama;\n\n#. Registreerimisteenuse poolt ei saa tekkida fiktiivseid KINNITUSI, mida\n Kogumisteenus tegelikult nõudnud pole\n\n#. Kogumisteenus ei saa juba esitatud KORRALDUSTE kohta väita, et ta neid ei\n esitanud\n\nNonsi vorming::\n\n Signature ::= SEQUENCE {\n signingAlgorithm AlgorithmIdentifier,\n signature ANY DEFINED BY signingAlgorithm\n }\n\n AlgorithmIdentifier ::= SEQUENCE {\n algorithm OBJECT IDENTIFIER,\n parameters ANY DEFINED BY algorithm OPTIONAL\n }\n\nSõnumiks on TimeStampReq.messageImprint DER-kodeering::\n\n MessageImprint ::= SEQUENCE {\n hashAlgorithm AlgorithmIdentifier,\n hashedMessage OCTET STRING\n }\n\nRSA kasutamisel allkirjastamiseks. välja\n``Signature.signingAlgorithm.algorithm`` väärtus sõltub sõnumi\n``hashAlgorithm`` välja väärtusest::\n\n pkcs-1 OBJECT IDENTIFIER ::= { iso(1) member-body(2) US(840) rsadsi(113549) pkcs(1) 1 }\n\n sha-1WithRSAEncryption OBJECT IDENTIFIER ::= { pkcs-1 5 }\n sha224WithRSAEncryption OBJECT IDENTIFIER ::= { pkcs-1 14 }\n sha256WithRSAEncryption OBJECT IDENTIFIER ::= { pkcs-1 11 }\n sha384WithRSAEncryption OBJECT IDENTIFIER ::= { pkcs-1 12 }\n sha512WithRSAEncryption OBJECT IDENTIFIER ::= { pkcs-1 13 }\n\nVäli ``Signature.signingAlgorithm.parameters`` puudub või on NULL.\n\nVäli ``Signature.signature`` on OCTET STRING, mis sisaldab RSA signatuuri sõnumil.\n\nATO väljavõte\n-------------\n\nATO väljavõte Kogumisteenuse poolt esitatud TimeStampReq vormingus päringutest\nesitatakse ZIP failina, kus iga päring on salvestatud ühte faili, mis vastab\njärgmistele tingimustele:\n\n* Kaustastruktuur puudub, ükski fail ei paikne kaustas.\n* Failinimed on unikaalsed (failinimedele samas tähendust ei omistata).\n\nÜleantav andmekomplekt on:\n\n * Andmefail: `.zip`\n * Kontrollsummafail: `.zip.sha256sum.asice`\n\nÜherealise kontrollsummafaili sisu on HEX kodeeringus SHA256 räsi andmefailist.\n\n" }, { "path": "Documentation/public/protokollid/07-kontrollimine.rst", "content": ".. IVXV protokollid\n\n================================================================================\nElektroonilise hääle kontrollimine eraldi ja e-valimiskasti koosseisus\n================================================================================\n\nElektroonilist häält kontrollitakse töötlemisrakenduses, kogumisteenuses,\nvalijarakenduses ja kontrollrakenduses.\n\nKõige põhjalikuma kontrolli läbib elektrooniline hääl e-valimiskasti koosseisus\ntöötlemisrakenduses, kus otsustatakse konkreetse hääle lugemisele saatmine või\nmittesaatmine. Nende kontrollide käigus vaadeldakse e-häält nii eraldi kui ka\nsuhtes kõigi teiste sama valija poolt antud häältega. Täiendavalt kõrvutatakse\ne-valimiskasti registreerimisteenuse väljavõttega.\n\nIga üksiku hääle kohta läbitakse töötlemisrakendusega analoogsel tasemel\nkontroll valijarakenduses, kus veendutakse, et kogumisteenus on hääle\nkvalifitseerinud selliselt, et töötlemisrakenduses tehtavad kontrollid\nõnnestuvad. Valijarakenduse kontrollidega samaväärsed kontrollid viib läbi\nkontrollrakendus.\n\nKogumisteenus on lisaks vastutav mitme hääle lõplikuks kvalifitseerumiseks\nvajaliku elemendi hankimise eest ning teostab ka nende hankimise järgselt kontrollid.\n\n\nLõpliku elektroonilise hääle komponendid\n----------------------------------------\n\nElemendid, mis on kättesaadavad otsustamise hetkel, kas hääl kvalifitseerub\nlugemisele saatmiseks või mitte:\n\n #. elektroonilist häält sisaldav konteiner - :ref:`entity-haale-konteiner`;\n\n #. krüpteeritud sedel - :ref:`entity-krypteeritud-sedel`;\n\n #. valija signatuur krüpteeritud sedelil - :ref:`entity-haale-signatuur`;\n\n #. valija allkiri krüpteeritud sedelil - :ref:`entity-haale-allkiri`;\n\n #. valija allkirjastamissertifikaat - :ref:`entity-valija-sertifikaat`;\n\n #. valija isikukood - :ref:`entity-valija-identiteet`;\n\n #. kvalifitseeriv element - valija sertifikaadi kehtivuskinnitus -\n :ref:`entity-kehtivuskinnitus`;\n\n #. kvalifitseeriv element - ajatempel allkirjastatud krüpteeritud sedelile -\n :ref:`entity-ajatempel`;\n\n #. kvalifitseeriv element - registreerimispäringu konteiner\n :ref:`entity-registreerimisparing-konteiner`;\n\n #. kvalifitseeriv element - registreerimispäring allkirjastatud\n krüpteeritud sedelile - :ref:`entity-registreerimisparing`;\n\n #. kvalifitseeriv element - registreerimistõend allkirjastatud krüpteeritud\n sedeli kohta - :ref:`entity-registreerimistoend`;\n\n #. valija ringkonnakuuluvuse tõend hääle andmise hetkel -\n :ref:`entity-nimekirjatunnus`.\n\n\nElemendid, mis on kättesaadavad otsustamise hetkel, kuidas häält kokkulugemisel\narvesse võtta:\n\n #. miksitud krüpteeritud sedel - :ref:`entity-miksitud-krypteeritud-sedel`;\n\n #. valija tahteavaldus avakujul - :ref:`entity-tahteavaldus`;\n\n #. ringkonnakuuluvuse tunnus - :ref:`entity-ringkonnatunnus`;\n\n #. ringkonnapõhine valikute nimekiri - :ref:`entity-ringkonna-valikutenimekiri`.\n\n\nTäiendavad elemendid:\n\n #. krüpteerimisel kasutatud juhuslikkus - :ref:`entity-juhuslikkus`; -\n luuakse valijarakenduses hääle krüpteerimisel ning vahendatakse ainult\n kontrollrakendusele.\n\n\n.. _entity-tahteavaldus:\n\n````````````\nTAHTEAVALDUS\n````````````\n\nOlem moodustatakse valijarakenduses ning tuvastatakse võtmerakenduses. Tegemist\non EHS spetsiifilises vormingus UTF-8 kodeeringus baidijadaga.\n\n.. _check-tahteavaldus-correctness:\n\nTAHTEAVALDUS, vormingu korrektsus\n`````````````````````````````````\n\nTahteavalduse vormingu korrektsuse kontroll käesoleva spetsifikatsiooni suhtes.\n\n\n.. _check-tahteavaldus-ringkonnatunnus-valikutenimekiri-consistency:\n\nTAHTEAVALDUS, RINGKONNATUNNUS, RINGKONNA VALIKUTENIMEKIRI kooskõlalisus\n```````````````````````````````````````````````````````````````````````\n\nTahteavalduses sisalduva valiku kontroll ringkonnatunnuse ja valikute nimekirja\nsuhtes. Kontroll õnnestub, kui tuvastatud valik on kättesaadav antud\nringkonnas.\n\n.. _check-tahteavaldus-ringkonna-valikutenimekiri-consistency:\n\nTAHTEAVALDUS, RINGKONNA VALIKUTENIMEKIRI, kooskõlalisus\n```````````````````````````````````````````````````````\n\nTahteavalduses sisalduva valiku kontroll ringkonnapõhise valikute nimekirja\nsuhtes. Kontroll õnnestub, kui tuvastatud valik on kättesaadav antud ringkonnas.\n\n\n.. _entity-juhuslikkus:\n\n```````````\nJUHUSLIKKUS\n```````````\n\nOlem moodustatakse valijarakenduses ning kasutatakse ka kontrollrakenduses.\nOlem esitatakse EHS spetsiifilises vormingus baidijadana ning peab olema\nühilduv avaliku võtme parameetrite poolt määratud matemaatilise rühmaga.\n\n.. _check-juhuslikkus-correctness:\n\nJUHUSLIKKUS, vormingu korrektsus\n````````````````````````````````\n\nJuhuslikkuse vormingu korrektsuse kontroll käesoleva spetsifikatsiooni suhtes.\n\n.. _check-juhuslikkus-public-key-consistency:\n\nJUHUSLIKKUS, kooskõlalisus avaliku võtmega\n``````````````````````````````````````````\n\nJuhuslikkuse kooskõlalisuse kontroll avaliku võtmega. Kontroll õnnestub kui\njuhuslikkus on kasutatav skalaarina arvutusteks avaliku võtme parameetrite\npoolt määratud matemaatilises rühmas.\n\n.. _entity-krypteeritud-sedel:\n\n``````````````````\nKRÜPTEERITUD SEDEL\n``````````````````\n\nOlem moodustatakse valijarakenduses. Tegemist on EHS spetsiifilises vormingus\nDER-kodeeritud andmestruktuuriga, mille kontrollimise aluseks on EHS avalik\nvõti, mis muuhulgas määratleb krüpteerimisel kasutatud matemaatilise rühma.\n\n.. _check-krypteeritud-sedel-correctness:\n\nKRÜPTEERITUD SEDEL, vormingu korrektsus\n```````````````````````````````````````\n\nKrüpteeritud sedeli vormingu korrektsuse kontroll käesoleva spetsifikatsiooni suhtes.\n\n\n.. _check-krypteeritud-sedel-public-key-consistency:\n\nKRÜPTEERITUD SEDEL, kooskõlalisus avaliku võtmega\n`````````````````````````````````````````````````\n\nKrüpteeritud sedeli kooskõlalisuse kontroll avaliku võtmega. Kontroll õnnestub kui\nkrüpteeritud sedeli komponendid on kasutatavad rühma liikmetena arvutusteks\navaliku võtme parameetrite poolt määratud matemaatilises rühmas.\n\n.. _check-krypteeritud-sedel-juhuslikkus-consistency:\n\nKRÜPTEERITUD SEDEL, JUHUSLIKKUS, kooskõlalisus\n``````````````````````````````````````````````\n\nKrüpteeritud sedeli kooskõlalisuse kontroll juhuslikkusega lähtudes rühma\nparameetritest. Kontroll õnnestub kui õnnestub näidata, et antud juhuslikkust\non kasutatud krüpteeritud sedeli komponendi `uBlind` arvutamiseks antud rühma\nparameetrite järgi.\n\n\n.. _entity-valija-sertifikaat:\n\n``````````````````\nVALIJA SERTIFIKAAT\n``````````````````\n\nOlem on valijale omistatud süsteemiväliselt. Tegemist on X.509 vormingus\nsertifikaadiga, mille kehtivuse kontrolli aluseks on samasse avaliku võtme\ninfrastruktuuri kuuluvad juursertifikaadid ja kehtivuskinnitusteenuse osutaja.\n\n.. _check-valija-sertifikaat-correctness:\n\nVALIJA SERTIFIKAAT, vormingu korrektsus\n```````````````````````````````````````\n\nValija sertifikaadi vormingu korrektsuse kontroll lähtudes X.509 spetsifikatsioonist.\n\n.. _check-valija-sertifikaat-consistency-protocol-settings:\n\nVALIJA SERTIFIKAAT, protokollikohane kooskõlalisus valimise seadistustega\n`````````````````````````````````````````````````````````````````````````\n\nValija sertifikaadi protokollikohase kooskõlalisuse kontroll valimise\nseadistustega. Kontroll õnnestub kui:\n\n #. Valija sertifikaat on kehtiv lähtudes sertifikaadis sisalduvast kehtivusajast;\n\n #. Valija sertifikaat kuulub mõnda valimise seadistustes kirjeldatud\n sertifitseerimishierarhiatest.\n\n\n.. _check-valija-sertifikaat-kehtivuskinnitus-consistency:\n\nVALIJA SERTIFIKAAT, KEHTIVUSKINNITUS, protokollikohane kooskõlalisus valimise seadistustega\n```````````````````````````````````````````````````````````````````````````````````````````\n\nValija sertifikaadi ja kehtivuskinnituse protokollikohase kooskõlalisuse\nkontroll valimise seadistustega. Kontroll õnnestub kui:\n\n #. Kehtivuskinnitus on korrektselt allkirjastatud kehtivuskinnituse teenuse\n osutaja poolt, kellel on seadistuste kohaselt voli valija sertifikaadi\n kehtivust tõendada\n\n #. Kehtivuskinnitus on väljastatud valija sertifikaadi kohta;\n\n #. Kehtivuskinnitus näitab valija sertifikaadi OCSP olekuks 'Kehtiv'.\n\n\n.. _entity-valija-identiteet:\n\n`````````````````\nVALIJA IDENTITEET\n`````````````````\n\nOlem on valijale omistatud süsteemiväliselt. Tegemist on isikukoodiga, mille\nkontrollimise aluseks on VALIJA SERTIFIKAAT.\n\n.. _check-valija-identiteet-correctness:\n\nVALIJA IDENTITEET, vormingu korrektsus\n``````````````````````````````````````\n\nValija identiteedi vormingu korrektsuse kontroll lähtudes Eesti Vabariigi\nisikukoodi vormingust.\n\n.. _check-valija-identiteet-nimekirjatunnus-eligibility:\n\nVALIJA IDENTITEET, NIMEKIRJATUNNUS, hääleõigus\n``````````````````````````````````````````````\n\nHääleõiguse kontroll valija identiteedi ja nimekirjatunnuse alusel. Kontroll\nõnnestub, kui valija identiteet on kantud nimekirjatunnusele vastavasse\nvalijate nimekirja. Sellisel juhul on identiteedile omistatud ka\nringkonnatunnus, mis määrab ringkonnaspetsiifilise valikute nimekirja.\n\n.. _entity-haale-signatuur:\n\n```````````````\nHÄÄLE SIGNATUUR\n```````````````\n\nOlem arvutatakse allkirjastamise vahendi poolt lähtudes valijarakenduse poolt\nsisendiks antud KRÜPTEERITUD SEDELI räsist.\n\n.. _check-haale-signatuur-correctness:\n\nHÄÄLE SIGNATUUR, vormingu korrektsus\n````````````````````````````````````\n\nHääle signatuuri vormingu korrektsuse kontroll lähtudes konkreetsest\nsigneerimismeetodist.\n\n.. _check-haale-signatuur-krypteeritud-sedel-valija-sertifikaat-consistency:\n\nHÄÄLE SIGNATUUR, KRÜPTEERITUD SEDEL, VALIJA SERTIFIKAAT, kooskõlalisus\n``````````````````````````````````````````````````````````````````````\n\nKontroll, mis õnnestub siis ja ainult siis kui õnnestub verifitseerida, et\nhääle signatuur on arvutatud krüpteeritud sedeli räsist kasutades valija\nsertifikaadis leiduvale avalikule võtmele vastavat privaatvõtit.\n\n.. _entity-haale-allkiri:\n\n`````````````\nHÄÄLE ALLKIRI\n`````````````\n\nOlem moodustatakse valijarakenduses, talletades hääle signatuuri allkirja vormingusse.\n\n.. _check-haale-allkiri-correctness:\n\nHÄÄLE ALLKIRI, vormingu korrektsus\n``````````````````````````````````\n\nHääle allkirja vormingu korrektsuse kontroll käesoleva spetsifikatsiooni suhtes.\n\n.. _check-haale-allkiri-haale-signatuur-consistency:\n\nHÄÄLE ALLKIRI, HÄÄLE SIGNATUUR, kooskõlalisus\n`````````````````````````````````````````````\n\nHääle allkirja ja hääle signatuuri kooskõlalisuse kontroll. Kontroll õnnestub,\nkui antud allkiri sisaldab antud signatuuri.\n\n.. _entity-haale-konteiner:\n\n```````````````\nHÄÄLE KONTEINER\n```````````````\n\nOlem moodustatakse valijarakenduses, luues vormingukohane konteiner, mis\nsisaldab muuhulgas krüpteeritud sedelit, hääle allkirja ja valija sertifikaati.\n\n.. _check-haale-konteiner-correctness:\n\nHÄÄLE KONTEINER, vormingu korrektsus\n````````````````````````````````````\n\nHääle konteineri vormingu korrektsuse kontroll käesoleva spetsifikatsiooni suhtes.\n\n.. _check-haale-konteiner-haale-allkiri-valija-sertifikaat-krypteeritud-sedel-consistency:\n\nHÄÄLE KONTEINER, HÄÄLE ALLKIRI, VALIJA SERTIFIKAAT, KRÜPTEERITUD SEDEL, kooskõlalisus\n`````````````````````````````````````````````````````````````````````````````````````\n\nHääle konteineri, hääle allkirja, valija sertifikaadi ja krüpteeritud sedeli\nkooskõlalisuse kontroll. Kontroll õnnestub kui antud konteiner sisaldab\nkonkreetset hääle allkirja, valija sertifikaati ja krüpteeritud sedelit.\n\n.. _entity-kehtivuskinnitus:\n\n````````````````\nKEHTIVUSKINNITUS\n````````````````\n\nOlemi hankimise eest vastutab kogumisteenus. Tegemist on OCSP vormingus\nkinnitusega valija sertifikaadi oleku kohta.\n\n.. _check-kehtivuskinnitus-correctness:\n\nKEHTIVUSKINNITUS, vormingu korrektsus\n`````````````````````````````````````\n\nKehtivuskinnituse vormingu korrektsuse kontroll OCSP spetsifikatsiooni suhtes.\n\n\n.. _check-kehtivuskinnitus-ajatempel-order:\n\nKEHTIVUSKINNITUS, AJATEMPEL, ajaline järgnevus\n``````````````````````````````````````````````\n\nKehtivuskinnituse ja ajatempli ajalise järgnevuse kontroll. Kontroll õnnestub, kui\n\n #. ajatempel ei ole väljastatud hiljem kui kehtivuskinnitus;\n\n #. ajatempli ja kehtivuskinnituse väljastamise ajaline vahe on väiksem kui\n valimise seadistustes ette nähtud aeg.\n\n\n.. _entity-ajatempel:\n\n`````````\nAJATEMPEL\n`````````\n\nOlemi hankimise eest vastutab kogumisteenus. Tegemist on PKIX vormingus ajatempliga.\n\n.. _check-ajatempel-correctness:\n\nAJATEMPEL, vormingu korrektsus\n``````````````````````````````\n\nAjatempli vormingu korrektsuse kontroll PKIX spetsifikatsiooni suhtes.\n\n\n.. _check-ajatempel-consistency-protocol-settings:\n\nAJATEMPEL, HÄÄLE ALLKIRI, protokollikohane kooskõlalisus valimise seadistustega\n```````````````````````````````````````````````````````````````````````````````\n\nAjatempli protokollikohase kooskõlalisuse kontroll valimise seadistustega.\nKontroll õnnestub kui:\n\n #. ajatempel on korrektselt allkirjastatud valimise seadistuses volitatud\n ajatempliteenuse osutaja poolt;\n\n #. ajatempel on võetud hääle allkirjale.\n\n.. _entity-registreerimisparing:\n\n````````````````````\nREGISTREERIMISPÄRING\n````````````````````\n\nOlem moodustatakse kogumisteenuses. Olemi talletamise eest vastutab\nregistreerimisteenuse osutaja.\n\n.. _check-registreerimisparing-correctness:\n\nREGISTREERIMISPÄRING, vormingu korrektsus\n`````````````````````````````````````````\n\nRegistreerimispäringu vormingu korrektsuse kontroll käesoleva spetsifikatsiooni suhtes.\n\n\n.. _check-registreerimisparing-haale-allkiri-consistency:\n\nREGISTREERIMISPÄRING, HÄÄLE ALLKIRI, protokollikohane kooskõlalisus valimise seadistustega\n``````````````````````````````````````````````````````````````````````````````````````````\n\nRegistreerimispäringu ja hääle allkirja protokollikohase kooskõlalisuse\nkontroll valimise seadistustega. Kontroll õnnestub kui:\n\n #. Registreerimispäring on koostatud hääle allkirjale;\n\n #. Registreerimispäring on korrektselt allkirjastatud valimise seadistuses\n viidatud kogumisteenuse poolt.\n\n\n.. _check-registreerimisparing-registreerimistoend-consistency:\n\nREGISTREERIMISPÄRING, REGISTREERIMISTÕEND, kooskõlalisus\n```````````````````````````````````````````````````````````````````````\n\nRegistreerimispäringu ja registreerimistõendi protokollikohase kooskõlalisuse\nkontroll valimise seadistustega. Kontroll õnnestub kui:\n\n #. Registreerimispäring on korrektselt allkirjastatud valimise seadistuses\n viidatud kogumisteenuse poolt.\n\n #. Registreerimistõend on koostatud vastuseks samale registreerimispäringule;\n\n #. Registreerimistõend on korrektselt allkirjastatud valimise seadistuses\n viidatud registreerimisteenuse poolt.\n\n\n.. _entity-registreerimisparing-konteiner:\n\n```````````````````````````````\nREGISTREERIMISPÄRINGU KONTEINER\n```````````````````````````````\n\nOlem moodustatakse kogumisteenuses. Olemi talletamise eest vastutab\nregistreerimisteenuse osutaja.\n\n.. _check-registreerimisparing-konteiner-correctness:\n\nREGISTREERIMISPÄRINGU KONTEINER, vormingu korrektsus\n````````````````````````````````````````````````````\n\nRegistreerimispäringu konteineri vormingu korrektsuse kontroll käesoleva\nspetsifikatsiooni suhtes.\n\n\n.. _check-registreerimisparing-konteiner-registreerimispäring-consistency:\n\nREGISTREERIMISPÄRINGU KONTEINER, REGISTREERIMISPÄRING, protokollikohane kooskõlalisus valimise seadistustega\n````````````````````````````````````````````````````````````````````````````````````````````````````````````\n\nRegistreerimispäringu konteineri ja registreerimispäringu protokollikohase kooskõlalisuse\nkontroll valimise seadistustega. Kontroll õnnestub kui:\n\n #. Registreerimispäringu konteiner sisaldab registreerimispäringut;\n\n #. Registreerimispäring on korrektselt allkirjastatud valimise seadistuses\n viidatud kogumisteenuse poolt.\n\n\n.. _entity-registreerimistoend:\n\n```````````````````\nREGISTREERIMISTÕEND\n```````````````````\n\nOlemi hankimise eest vastutab kogumisteenus, olemi moodustab\nregistreerimisteenuse osutaja.\n\n.. _check-registreerimistoend-correctness:\n\nREGISTREERIMISTÕEND, vormingu korrektsus\n````````````````````````````````````````\n\nRegistreerimistõendi vormingu korrektsuse kontroll käesoleva spetsifikatsiooni suhtes.\n\n\n.. _check-registreerimistoend-haale-allkiri-consistency:\n\nREGISTREERIMISTÕEND, HÄÄLE ALLKIRI, protokollikohane kooskõlalisus valimise seadistustega\n`````````````````````````````````````````````````````````````````````````````````````````\n\nRegistreerimistõendi ja hääle allkirja protokollikohase kooskõlalisuse\nkontroll valimise seadistustega. Kontroll õnnestub kui:\n\n #. Registreerimistõend on koostatud hääle allkirjale;\n\n #. Registreerimistõend sisaldab kogumisteenuse poolt korrektselt\n allkirjastatud registreerimispäringut;\n\n #. Registreerimistõend on korrektselt allkirjastatud valimise seadistuses\n viidatud registreerimisteenuse poolt.\n\n\n.. _entity-nimekirjatunnus:\n\n```````````````\nNIMEKIRJATUNNUS\n```````````````\n\nOlem moodustatakse kogumisteenuses ning identifitseerib ühe konkreetse\nversiooni valijate nimekirjast.\n\n.. _check-nimekirjatunnus-correctness:\n\nNIMEKIRJATUNNUS, vormingu korrektsus\n````````````````````````````````````\n\nNimekirjatunnuse vormingu korrektsuse kontroll käesoleva spetsifikatsiooni suhtes.\n\n.. _check-nimekirjatunnus-consistency-protocol-settings:\n\nNIMEKIRJATUNNUS, protokollikohane kooskõlalisus valimise seadistusega\n`````````````````````````````````````````````````````````````````````\n\nNimekirjatunnuse protokollikohase kooskõlalisuse kontroll valimise\nseadistusega. Kontroll õnnestub kui valimise seadistuses sisalduvate\nmuudatusnimekirjade alusel on võimalik koostada nimekirjatunnusele vastav\nnimekiri.\n\n\n.. _entity-miksitud-krypteeritud-sedel:\n\n```````````````````````````\nMIKSITUD KRÜPTEERITUD SEDEL\n```````````````````````````\n\nOlem moodustatakse miksimisrakenduses. Miksitud krüpteeritud sedel on\nsisuliselt krüpteeritud sedel ning rakenduvad samad kontrollid, mis\nkrüpteeritud sedelilegi.\n\n.. _check-miksitud-krypteeritud-sedel-correctness:\n\nMIKSITUD KRÜPTEERITUD SEDEL, vormingu korrektsus\n````````````````````````````````````````````````\n\nMiksitud krüpteeritud sedeli vormingu korrektsuse kontroll käesoleva\nspetsifikatsiooni suhtes.\n\n.. _check-miksitud-krypteeritud-sedel-public-key-consistency:\n\nMIKSITUD KRÜPTEERITUD SEDEL, kooskõlalisus avaliku võtmega\n``````````````````````````````````````````````````````````\n\nMiksitud krüpteeritud sedeli kooskõlalisuse kontroll avaliku võtmega. Kontroll\nõnnestub kui miksitud krüpteeritud sedeli komponendid on kasutatavad rühma\nliikmetena arvutusteks avaliku võtme parameetrite poolt määratud matemaatilises\nrühmas.\n\n\n.. _entity-ringkonnatunnus:\n\n```````````````\nRINGKONNATUNNUS\n```````````````\n\nOlem moodustatakse töötlemisrakenduses ning viitab ringkonnapõhisele valikute\nnimekirjale.\n\n.. _check-ringkonnatunnus-correctness:\n\nRINGKONNATUNNUS, vormingu korrektsus\n````````````````````````````````````\n\nRingkonnatunnuse vormingu korrektsuse kontroll käesoleva spetsifikatsiooni suhtes.\n\n.. _entity-ringkonna-valikutenimekiri:\n\n`````````````````````````````````\nRINGKONNAPÕHINE VALIKUTE NIMEKIRI\n`````````````````````````````````\n\nOlem on valijale omistatud süsteemiväliselt.\n\n.. _check-ringkonna-valikutenimekiri-correctness:\n\nRINGKONNAPÕHINE VALIKUTE NIMEKIRI, vormingu korrektsus\n``````````````````````````````````````````````````````\n\nRingkonnapõhise valikute nimekirja vormingu korrektsuse kontroll VIS liideste\nspetsifikatsiooni suhtes.\n\nKontrollid kogumisteenuses\n--------------------------\n\nKogumisteenus käsitleb talletatavat häält sõltumatult teistest häältest.\nKogumisteenuse ülesandeks on hääle talletamine kogu hääletamisperioodi vältel\nja häälele töötlemise käigus kvalifitseerumiseks vajalike elementide hankimine.\n\nKogumisteenus saab valijarakenduselt järgmised olemid:\n\n #. :ref:`entity-krypteeritud-sedel`\n\n #. :ref:`entity-valija-sertifikaat`\n\n #. :ref:`entity-valija-identiteet`\n\n #. :ref:`entity-haale-signatuur`\n\n #. :ref:`entity-haale-allkiri`\n\n #. :ref:`entity-haale-konteiner`\n\nKogumisteenus hangib hääle töötlemise käigus välistelt teenustelt järgmised olemid:\n\n #. :ref:`entity-kehtivuskinnitus`\n\n #. :ref:`entity-ajatempel`\n\n #. :ref:`entity-registreerimistoend`\n\nKogumisteenus tuvastab / loob ise järgmised olemid:\n\n #. :ref:`entity-registreerimisparing`\n\n #. :ref:`entity-registreerimisparing-konteiner`\n\n #. :ref:`entity-nimekirjatunnus`\n\n #. :ref:`entity-ringkonnatunnus`\n\n #. :ref:`entity-ringkonna-valikutenimekiri`\n\nKogumisteenus ei puutu vahetult kokku järgmiste olemitega:\n\n #. :ref:`entity-tahteavaldus`\n\n #. :ref:`entity-juhuslikkus`\n\n #. :ref:`entity-miksitud-krypteeritud-sedel`\n\nKogumisteenus viib läbi järgmised tegevused ja teostab järgmised kontrollid:\n\n #. Hääle talletamise päringu vastuvõtmine valijarakenduselt\n\n #. :ref:`check-valija-sertifikaat-correctness`\n #. :ref:`check-valija-sertifikaat-consistency-protocol-settings`\n #. :ref:`check-valija-identiteet-correctness`\n #. :ref:`check-valija-identiteet-nimekirjatunnus-eligibility`\n #. :ref:`check-haale-signatuur-correctness`\n #. :ref:`check-haale-signatuur-krypteeritud-sedel-valija-sertifikaat-consistency`\n #. :ref:`check-haale-allkiri-correctness`\n #. :ref:`check-haale-allkiri-haale-signatuur-consistency`\n #. :ref:`check-haale-konteiner-correctness`\n #. :ref:`check-haale-konteiner-haale-allkiri-valija-sertifikaat-krypteeritud-sedel-consistency`\n #. :ref:`check-krypteeritud-sedel-correctness`\n #. :ref:`check-krypteeritud-sedel-public-key-consistency`\n\n #. Kehtivuskinnituse hankimine - :ref:`entity-kehtivuskinnitus`\n\n #. :ref:`check-kehtivuskinnitus-correctness`\n #. :ref:`check-valija-sertifikaat-kehtivuskinnitus-consistency`\n\n #. Ajatempli hankimine - :ref:`entity-ajatempel`\n\n #. :ref:`check-ajatempel-correctness`\n #. :ref:`check-ajatempel-consistency-protocol-settings`\n\n #. Registreerimispäringu loomine - :ref:`entity-registreerimisparing`\n\n #. Registreerimistõendi hankimine - :ref:`entity-registreerimistoend`\n\n #. :ref:`check-registreerimisparing-registreerimistoend-consistency`\n #. :ref:`check-registreerimistoend-correctness`\n #. :ref:`check-registreerimistoend-haale-allkiri-consistency`\n #. :ref:`check-kehtivuskinnitus-ajatempel-order`\n\n #. Hääle talletamine, kvalifitseerivate elementide ja unikaalse\n identifikaatori tagastamine valijarakendusele.\n\nKontrollid valijarakenduses\n---------------------------\n\nValijarakendus moodustab valija avakujul tahteavalduse põhjal krüpteeritud\nsedeli ning allkirjastab selle valija allkirja andmise vahendiga.\n\nValijarakenduse rolliks peale hääle allkirjastamist on veenduda, et\nkogumisteenus käitus häält kvalifitseerivate elementide võtmisel\nprotokollikohaselt ning et hääl on talletatud selliselt, et ta saab\ntöötlemisrakenduse poolt arvesse võetud.\n\nValijarakendus viib läbi minimaalselt järgmised kontrollid:\n\n#. Kogumisteenus võttis kehtivuskinnituse valija sertifikaadile volitatud\n kehtivuskinnitusteenuselt. Valijarakendus kontrollib allkirja\n kehtivuskinnitusteenuse vastusel.\n\n#. Kogumisteenus registreeris valija poolt allkirjastatud hääle volitatud\n registreerimisteenuses. Valijarakendus kontrollib, et kogumisteenuse poolt\n moodustatud päring oli kogumisteenuse poolt signeeritud ning viitas\n korrektselt allkirjastatud häälele. Valijarakendus kontrollib, et\n registreerimisteenuse vastus on allkirjastatud õige registreerimisteenuse\n osutaja poolt ning sisaldab kogumisteenuse poolt allkirjastatud päringut.\n\nKui hääle kvalifitseerimiseks vajalike elementide kontroll ei õnnestu, siis\nteavitab valijarakendus sellest kasutajat.\n\nValijarakendus loob ise järgmised olemid:\n\n #. :ref:`entity-tahteavaldus`\n\n #. :ref:`entity-juhuslikkus`\n\n #. :ref:`entity-krypteeritud-sedel`\n\n #. :ref:`entity-haale-allkiri`\n\n #. :ref:`entity-haale-konteiner`\n\nValijarakendus saab järgmised olemid teistelt osapooltelt:\n\n #. :ref:`entity-valija-sertifikaat`\n\n #. :ref:`entity-valija-identiteet`\n\n #. :ref:`entity-ringkonna-valikutenimekiri`\n\n #. :ref:`entity-haale-signatuur`\n\n #. :ref:`entity-kehtivuskinnitus`\n\n #. :ref:`entity-ajatempel`\n\n #. :ref:`entity-registreerimistoend`\n\n #. :ref:`entity-registreerimisparing`\n\nValijarakendus ei puutu vahetult kokku järgmiste olemitega:\n\n #. :ref:`entity-registreerimisparing-konteiner`\n\n #. :ref:`entity-nimekirjatunnus`\n\n #. :ref:`entity-ringkonnatunnus`\n\n #. :ref:`entity-miksitud-krypteeritud-sedel`\n\nValijarakendus viib läbi järgmised tegevused ja teostab järgmised kontrollid:\n\n #. eID vahendi aktiveerimine ja valija identiteedi tuvastamine\n\n #. :ref:`entity-valija-sertifikaat`\n #. :ref:`entity-valija-identiteet`\n\n #. :ref:`check-valija-sertifikaat-correctness`\n #. :ref:`check-valija-sertifikaat-consistency-protocol-settings`\n #. :ref:`check-valija-identiteet-correctness`\n\n #. Ringkonnapõhise valikutenimekirja tuvastamine -\n :ref:`entity-ringkonna-valikutenimekiri`\n\n #. Tahteavalduse moodustamine - :ref:`entity-tahteavaldus`\n\n #. Juhuarvu genereerimine - :ref:`entity-juhuslikkus`\n\n #. Sedeli krüpteerimine - :ref:`entity-krypteeritud-sedel`\n\n #. Krüpteeritud sedeli signeerimine - :ref:`entity-haale-signatuur`\n\n #. Allkirja moodustamine signatuurist - :ref:`entity-haale-allkiri`\n\n #. :ref:`check-haale-signatuur-correctness`\n #. :ref:`check-haale-signatuur-krypteeritud-sedel-valija-sertifikaat-consistency`\n\n #. Allkirjastatud konteineri moodustamine - :ref:`entity-haale-konteiner`\n\n #. Allkirjastatud konteineri edastamine kogumisteenusele.\n\n #. Kogumisteenuse vastuse kontrollimine\n\n #. :ref:`entity-kehtivuskinnitus`\n #. :ref:`entity-ajatempel`\n #. :ref:`entity-registreerimistoend`\n #. :ref:`entity-registreerimisparing`\n\n #. :ref:`check-kehtivuskinnitus-correctness`\n #. :ref:`check-valija-sertifikaat-kehtivuskinnitus-consistency`\n #. :ref:`check-ajatempel-correctness`\n #. :ref:`check-ajatempel-consistency-protocol-settings`\n #. :ref:`check-kehtivuskinnitus-ajatempel-order`\n\n #. :ref:`check-registreerimisparing-correctness`\n #. :ref:`check-registreerimisparing-haale-allkiri-consistency`\n #. :ref:`check-registreerimisparing-registreerimistoend-consistency`\n #. :ref:`check-registreerimistoend-correctness`\n #. :ref:`check-registreerimistoend-haale-allkiri-consistency`\n\nKontrollid kontrollrakenduses\n-----------------------------\n\nSarnaselt valijarakendusele on kontrollrakenduse rolliks peale hääle\nallkirjastamist veenduda, et kogumisteenus käitus häält kvalifitseerivate\nelementide võtmisel protokollikohaselt ning et hääl on talletatud selliselt, et\nta saab töötlemisrakenduse poolt arvesse võetud.\n\nTäiendavalt on kontrollrakenduse ülesandeks anda valijale tagasisidet, kas tema\ntahteavaldus sai valijarakenduse poolt korrektselt hääleks vormistatud.\n\nKui hääle kvalifitseerimiseks vajalike elementide kontroll ei õnnestu, siis\nteavitab kontrollrakendus sellest kasutajat. Tahteavalduse korrektsuses peab\nvalija ise veenduma.\n\nKontrollrakendus tuvastab ise järgmised olemid:\n\n #. :ref:`entity-tahteavaldus`\n\nKontrollrakendus saab järgmised olemid teistelt osapooltelt:\n\n #. :ref:`entity-juhuslikkus`\n\n #. :ref:`entity-krypteeritud-sedel`\n\n #. :ref:`entity-valija-sertifikaat`\n\n #. :ref:`entity-valija-identiteet`\n\n #. :ref:`entity-haale-signatuur`\n\n #. :ref:`entity-haale-allkiri`\n\n #. :ref:`entity-haale-konteiner`\n\n #. :ref:`entity-kehtivuskinnitus`\n\n #. :ref:`entity-ajatempel`\n\n #. :ref:`entity-registreerimistoend`\n\n #. :ref:`entity-registreerimisparing`\n\n #. :ref:`entity-ringkonna-valikutenimekiri`\n\nKontrollrakendus ei puutu vahetult kokku järgmiste olemitega:\n\n #. :ref:`entity-registreerimisparing-konteiner`\n\n #. :ref:`entity-nimekirjatunnus`\n\n #. :ref:`entity-ringkonnatunnus`\n\n #. :ref:`entity-miksitud-krypteeritud-sedel`\n\nKontrollrakendus viib läbi järgmised tegevused ja teostab järgmised kontrollid:\n\n #. :ref:`check-valija-sertifikaat-correctness`\n #. :ref:`check-valija-sertifikaat-consistency-protocol-settings`\n #. :ref:`check-valija-sertifikaat-kehtivuskinnitus-consistency`\n #. :ref:`check-valija-identiteet-correctness`\n #. :ref:`check-haale-signatuur-correctness`\n #. :ref:`check-haale-signatuur-krypteeritud-sedel-valija-sertifikaat-consistency`\n #. :ref:`check-haale-allkiri-correctness`\n #. :ref:`check-haale-allkiri-haale-signatuur-consistency`\n #. :ref:`check-haale-konteiner-correctness`\n #. :ref:`check-haale-konteiner-haale-allkiri-valija-sertifikaat-krypteeritud-sedel-consistency`\n #. :ref:`check-kehtivuskinnitus-correctness`\n #. :ref:`check-ajatempel-correctness`\n #. :ref:`check-ajatempel-consistency-protocol-settings`\n #. :ref:`check-kehtivuskinnitus-ajatempel-order`\n #. :ref:`check-registreerimisparing-correctness`\n #. :ref:`check-registreerimisparing-haale-allkiri-consistency`\n #. :ref:`check-registreerimisparing-registreerimistoend-consistency`\n #. :ref:`check-registreerimistoend-correctness`\n #. :ref:`check-registreerimistoend-haale-allkiri-consistency`\n #. :ref:`check-ringkonna-valikutenimekiri-correctness`\n #. :ref:`check-juhuslikkus-correctness`\n #. :ref:`check-juhuslikkus-public-key-consistency`\n #. :ref:`check-krypteeritud-sedel-correctness`\n #. :ref:`check-krypteeritud-sedel-public-key-consistency`\n #. :ref:`check-krypteeritud-sedel-juhuslikkus-consistency`\n #. :ref:`check-tahteavaldus-correctness`\n #. :ref:`check-tahteavaldus-ringkonna-valikutenimekiri-consistency`\n\nKontrollid töötlemisrakenduses\n------------------------------\n\nTöötlemisrakenduse sisendiks on e-valimiskast ja registreerimisteenuse\nväljavõte registreerimispäringutest. Töötlemisrakendus kontrollib mõlema\nandmehulga elemente kõigepealt eraldi ning seejärel püüab luua vastavuse nende\nvahel.\n\nTöötlemisrakendus otsustab, milline valija häältest oli viimane ning liigub\ntöötlemise järgmisesse etappi. S.t. üks häält kvalifitseerivatest elementidest\ntäidab hääle talletamise aja fikseerimise rolli ning selle elemendi põhjal\nmoodustatakse üksikute häälte ajaline järgnevus. Olenevalt IVXV profiilist võib\nsee element olla kehtivuskinnituse koosseisus (BDOC-TM), eraldi ajatemplina\n(BDOC-TS) või registreerimistõendi koosseisus (BDOC-TS).\n\nTöötlemisrakendusele tehakse kättesaadavaks järgmised olemid:\n\n #. :ref:`entity-krypteeritud-sedel`\n\n #. :ref:`entity-valija-sertifikaat`\n\n #. :ref:`entity-valija-identiteet`\n\n #. :ref:`entity-haale-signatuur`\n\n #. :ref:`entity-haale-allkiri`\n\n #. :ref:`entity-haale-konteiner`\n\n #. :ref:`entity-kehtivuskinnitus`\n\n #. :ref:`entity-ajatempel`\n\n #. :ref:`entity-registreerimisparing`\n\n #. :ref:`entity-registreerimisparing-konteiner`\n\n #. :ref:`entity-registreerimistoend`\n\n #. :ref:`entity-nimekirjatunnus`\n\n #. :ref:`entity-ringkonna-valikutenimekiri`\n\nTöötlemisrakendus tuvastab/loob järgmised olemid:\n\n #. :ref:`entity-ringkonnatunnus`\n\n\nTöötlemisrakendus ei puutu vahetult kokku järgmiste olemitega:\n\n #. :ref:`entity-miksitud-krypteeritud-sedel`\n\n #. :ref:`entity-tahteavaldus`\n\n #. :ref:`entity-juhuslikkus`\n\nTöötlemisrakenduse töö jaguneb neljaks etapiks:\n\n #. Kontrollimine\n\n #. Korduvhäälte eemaldamine\n\n #. Tühistamine/-ennistamine\n\n #. Anonüümimine\n\n\nTöötlemisrakendus teostab kontrollimise etapis järgmised kontrollid:\n\n #. e-valimiskasti elementide kontrollid teostatakse kõigi hääle elementide kohta:\n\n #. :ref:`check-valija-sertifikaat-correctness`\n #. :ref:`check-valija-sertifikaat-consistency-protocol-settings`\n #. :ref:`check-valija-identiteet-correctness`\n #. :ref:`check-nimekirjatunnus-correctness`\n #. :ref:`check-nimekirjatunnus-consistency-protocol-settings`\n #. :ref:`check-valija-identiteet-nimekirjatunnus-eligibility`\n #. :ref:`check-ringkonnatunnus-correctness`\n #. :ref:`check-haale-signatuur-correctness`\n #. :ref:`check-haale-signatuur-krypteeritud-sedel-valija-sertifikaat-consistency`\n #. :ref:`check-haale-allkiri-correctness`\n #. :ref:`check-haale-allkiri-haale-signatuur-consistency`\n #. :ref:`check-haale-konteiner-correctness`\n #. :ref:`check-haale-konteiner-haale-allkiri-valija-sertifikaat-krypteeritud-sedel-consistency`\n #. :ref:`check-kehtivuskinnitus-correctness`\n #. :ref:`check-valija-sertifikaat-kehtivuskinnitus-consistency`\n #. :ref:`check-ajatempel-correctness`\n #. :ref:`check-ajatempel-consistency-protocol-settings`\n #. :ref:`check-kehtivuskinnitus-ajatempel-order`\n #. :ref:`check-registreerimistoend-correctness`\n #. :ref:`check-registreerimistoend-haale-allkiri-consistency`\n\n #. registreerimisteenuse väljavõtte kontrollid teostatakse iga\n registreerimispäringu kohta\n\n #. :ref:`check-registreerimisparing-correctness`\n #. :ref:`check-registreerimisparing-konteiner-correctness`\n #. :ref:`check-registreerimisparing-konteiner-registreerimispäring-consistency`\n\n #. Töötlemisrakendus loob vastavuse e-valimiskasti ja registreerimisteenuse\n väljavõtte vahel võttes aluseks olemi\n :ref:`entity-registreerimisparing-konteiner` registreerimisteenuse\n väljavõttest ning olemi :ref:`entity-registreerimistoend`\n e-valimiskastist. Ühendavaks lüliks kahe vaate vahel on\n :ref:`entity-registreerimisparing`.\n\n #. e-valimiskasti ja registreerimisteenuse väljavõtte vastavuskontrollid\n\n #. :ref:`check-registreerimisparing-haale-allkiri-consistency`\n #. :ref:`check-registreerimisparing-registreerimistoend-consistency`\n\nTöötlemisrakendus teostab korduvhäälte eemaldamise etapis järgmised kontrollid:\n\n #. Töötlemisrakendus tuvastab iga valija häälte hulgast ajaliselt viimase.\n\n #. Töötlemisrakendus viib läbi krüpteeritud sedeli korrektsuse kontrollid.\n\n #. :ref:`check-krypteeritud-sedel-correctness`\n #. :ref:`check-krypteeritud-sedel-public-key-consistency`\n\n\nTöötlemisrakenduse töö järgmistes etappides täiendavaid kontrolle ei teostata.\nTühistamis-/ennistamisetapis eemaldatakse/taastatakse isikukoodile vastavaid\nhääli korduvhäältest puhastatud e-valimiskastist. Anonüümimisetapis\neemaldatakse e-häältelt kvalifitseerivad elemendid ning saadud loend\nkrüpteeritud sedelitest suunatakse miksimisrakendusse.\n\nKontrollid miksimisrakenduses\n-----------------------------\n\nMiksimisrakendusele tehakse kättesaadavaks järgmised olemid:\n\n #. :ref:`entity-krypteeritud-sedel`\n\n #. :ref:`entity-ringkonnatunnus`\n\nMiksimisrakendus loob järgmised olemid:\n\n #. :ref:`entity-miksitud-krypteeritud-sedel`\n\nMiksimisrakendus ei puutu vahetult kokku järgmiste olemitega:\n\n #. :ref:`entity-tahteavaldus`\n\n #. :ref:`entity-juhuslikkus`\n\n #. :ref:`entity-valija-sertifikaat`\n\n #. :ref:`entity-valija-identiteet`\n\n #. :ref:`entity-haale-signatuur`\n\n #. :ref:`entity-haale-allkiri`\n\n #. :ref:`entity-haale-konteiner`\n\n #. :ref:`entity-kehtivuskinnitus`\n\n #. :ref:`entity-ajatempel`\n\n #. :ref:`entity-registreerimisparing`\n\n #. :ref:`entity-registreerimisparing-konteiner`\n\n #. :ref:`entity-registreerimistoend`\n\n #. :ref:`entity-nimekirjatunnus`\n\n #. :ref:`entity-ringkonna-valikutenimekiri`\n\n\nMiksimisrakendus viib läbi järgmised tegevused ja kontrollid:\n\n #. :ref:`check-ringkonnatunnus-correctness`\n #. :ref:`check-krypteeritud-sedel-correctness`\n #. :ref:`check-krypteeritud-sedel-public-key-consistency`\n\n #. Miksimisrakendus grupeerib sisendiks antud krüpteeritud sedelid\n ringkonnatunnuste kaupa ning järjestab krüpteeritud sedelid ringkonnas\n ringi.\n\n #. Miksimisrakendus arvutab iga ümberjärjestatud krüpteeritud sedeli kohta\n uue miksitud krüpteeritud sedeli.\n\n #. Miksimisrakendus koostab nullteadmustõestused sedelite korrektse miksimise kohta.\n\nKontrollid võtmerakenduses\n--------------------------\n\nVõtmerakendusele tehakse kättesaadavaks järgmised olemid:\n\n #. :ref:`entity-miksitud-krypteeritud-sedel`\n\n #. :ref:`entity-ringkonnatunnus`\n\n #. :ref:`entity-ringkonna-valikutenimekiri`\n\nVõtmerakendus tuvastab järgmised olemid:\n\n #. :ref:`entity-tahteavaldus`\n\nVõtmerakendus ei puutu vahetult kokku järgmiste olemitega:\n\n #. :ref:`entity-juhuslikkus`\n\n #. :ref:`entity-krypteeritud-sedel`\n\n #. :ref:`entity-valija-sertifikaat`\n\n #. :ref:`entity-valija-identiteet`\n\n #. :ref:`entity-haale-signatuur`\n\n #. :ref:`entity-haale-allkiri`\n\n #. :ref:`entity-haale-konteiner`\n\n #. :ref:`entity-kehtivuskinnitus`\n\n #. :ref:`entity-ajatempel`\n\n #. :ref:`entity-registreerimisparing`\n\n #. :ref:`entity-registreerimisparing-konteiner`\n\n #. :ref:`entity-registreerimistoend`\n\n #. :ref:`entity-nimekirjatunnus`\n\n\nVõtmerakendus viib läbi järgmised tegevused ja kontrollid:\n\n #. :ref:`check-miksitud-krypteeritud-sedel-correctness`\n #. :ref:`check-miksitud-krypteeritud-sedel-public-key-consistency`\n #. Häälte dekrüpteerimine\n #. :ref:`check-ringkonnatunnus-correctness`\n #. :ref:`check-tahteavaldus-correctness`\n #. :ref:`check-tahteavaldus-ringkonnatunnus-valikutenimekiri-consistency`\n" }, { "path": "Documentation/public/protokollid/08-haaletamine.rst", "content": ".. IVXV protokollid\n\n===================\nSuhtlusprotokollid\n===================\n\nLiides\n------\n\nKogumisteenuse valijale suunatud mikroteenused suhtlevad valijarakendusega ja\nkontrollrakendusega JSON-RPC protokolli vahendusel.\n\n:id: JSON-RPC päringuidentifikaator\n:method: RPC-meetod\n:params: Konkreetse RPC-meetodi parameetrid\n\n.. literalinclude:: ../../common/examples/json.rpc.method.query.json\n :language: json\n :linenos:\n\n:error: Võimalik veainfo või ``null`` vea puudumisel\n:id: JSON-RPC päringuidentifikaator, peab ühtima päringus kasutatud id'ga\n:result: Meetodipõhine vastusandmestruktuur\n\n.. literalinclude:: ../../common/examples/json.rpc.method.response.json\n :language: json\n :linenos:\n\nEsimese päringuvahetuse käigus mõne IVXV mikroteenusega väljastatakse suhtlevale\nrakendusele HEX-kodeeritud unikaalne seansiidentifikaator (``result.SessionID``),\nmida rakendus kasutab edaspidi kõigis kogumisteenuse suunalistes päringutes\n(``params.SessionID``). Seansiidentifikaatori abil seostatakse\nhääletamisega seotud RPC-päringud üheks seansiks. Seostamine on informatiivne\nning selle eesmärk on logianalüüsi lihtsustamine, hääle ringkonnakuuluvust jm.\nsisulisi aspekte puudutavad otsused tehakse digiallkirjastatud andmete põhjal.\n\nTranspordiprotokollina on kasutusel TLS. Krüpteeritud kanali termineerimine\ntoimub konkreetses mikroteenuses. Võimaldamaks koormuse jaotamist ning\nmikroteenuste paindlikku evitamist kasutatakse TLS-SNI laiendust, mis lubab\nvahendusteenusel TLS voogu termineerimata õigesse mikroteenusinstantsi suunata.\nVahendusteenus on tüüpiliselt kättesaadav kogumisteenuse välise liidese pordis\n443.\n\nValikute nimekirja hankimine\n----------------------------\n\nValikute nimekirja hankimine tähendab valijarakenduse suhtlemist\nnimekirjateenusega (SNI ``choices.ivxv.invalid``). Valikute nimekirja hankimine\neeldab valija autentimist ning tema ringkonnakuuluvuse tuvastamist.\n\nValijarakendus teeb päringu ``RPC.VoterChoices`` nimekirjade hankimiseks.\n\n:params.AuthMethod: Toetatud valikud on meetodid ``tls`` ja ``ticket``.\n:params.OS: Operatsioonisüsteem, millel valijarakendust kasutatakse.\n\nPäring ``RPC.VoterChoices`` ID-kaardiga autentimise korral - autentimine toimub\nTLS-protokolli tasemel päringu töötlemise ajal kasutades ID-kaardi\nautentimissertifikaati.\n\n.. literalinclude:: ../../common/examples/id.rpc.voterchoices.query.json\n :language: json\n :linenos:\n\nPäring ``RPC.VoterChoices`` Mobiil-ID'ga autentimise korral - päringu\nsooritamiseks tuleb eelnevalt kasutada Mobiil-ID vahendusteenuse (SNI\n``mid.ivxv.invalid``) abi allkirjastatud autentimistõendi saamiseks.\n\n:params.AuthToken: Autentimisteenuse vahendusel allkirjastatud tõend, mis\n sisaldab endas valija unikaalset identifikaatorit.\n\n:params.SessionID: Kuna Mobiil-ID korral on nimekirja hankimisele eelnenud\n interaktsioon autentimistõendi saamiseks, on olemas\n seansiidentifikaator, mida tuleb kasutada.\n\n.. literalinclude:: ../../common/examples/mid.rpc.voterchoices.query.json\n :language: json\n :linenos:\n\nPäring ``RPC.VoterChoices`` Smart-ID'ga autentimise korral - päringu\nsooritamiseks tuleb eelnevalt kasutada Smart-ID vahendusteenuse (SNI\n``smartid.ivxv.invalid``) abi allkirjastatud autentimistõendi saamiseks.\n\n:params.AuthToken: Autentimisteenuse vahendusel allkirjastatud tõend, mis\n sisaldab endas valija unikaalset identifikaatorit.\n\n:params.SessionID: Kuna Smart-ID korral on nimekirja hankimisele eelnenud\n interaktsioon autentimistõendi saamiseks, on olemas\n seansiidentifikaator, mida tuleb kasutada.\n\n.. literalinclude:: ../../common/examples/smartid.rpc.voterchoices.query.json\n :language: json\n :linenos:\n\nPäring ``RPC.VoterChoices`` Web eID'ga autentimise korral - päringu\nsooritamiseks tuleb eelnevalt kasutada Web eID vahendusteenuse (SNI\n``webeid.ivxv.invalid``) abi allkirjastatud autentimistõendi saamiseks.\n\n:params.AuthToken: Autentimisteenuse vahendusel allkirjastatud tõend, mis\n sisaldab endas valija unikaalset identifikaatorit.\n\n:params.SessionID: Kuna Web eID korral on nimekirja hankimisele eelnenud\n interaktsioon autentimistõendi saamiseks, on olemas\n seansiidentifikaator, mida tuleb kasutada.\n\n.. literalinclude:: ../../common/examples/webeid.rpc.voterchoices.query.json\n :language: json\n :linenos:\n\nNimekirjateenuse vastus päringule ``RPC.VoterChoices``.\n\n:result.Choices: Valija ringkonnakuuluvuse identifikaator ``VoterDistrict``\n:result.List: BASE64-kodeeritud ringkonna valikute nimekiri ``DistrictChoices``\n:result.Voted: Kui valija on juba hääletanud, siis ``true``, vastasel juhul\n seda välja vastuses ei ole.\n\n.. literalinclude:: ../../common/examples/id.rpc.voterchoices.response.json\n :language: json\n :linenos:\n\nVõimalikud veateated päringu ``RPC.VoterChoices`` korral.\n\n:BAD_CERTIFICATE: Viga valija isikutuvastussertifikaadiga.\n:BAD_REQUEST: Vigane päring.\n:INELIGIBLE_VOTER: Valijal pole õigust hääletada.\n:INTERNAL_SERVER_ERROR: Viga serveri sisemises töös.\n:UNAUTHENTICATED: Autentimata päring.\n:VOTER_TOO_YOUNG: Valija on liiga noor.\n:VOTING_END: Hääletusperiood on lõppenud.\n\n\nAllkirjastatud hääle saatmine talletamiseks\n-------------------------------------------\n\nAllkirjastatud hääle saatmine talletamiseks tähendab valijarakenduse suhtlemist\nhääletamisteenusega (SNI ``voting.ivxv.invalid``).\n\nValijarakendus teeb päringu ``RPC.Vote`` allkirjastatud hääle talletamiseks\nsaatmiseks.\n\n:params.AuthMethod: Toetatud valikud on meetodid ``tls`` ja ``ticket``.\n:params.Choices: Valija ringkonnakuuluvuse identifikaator ``VoterDistrict`` mis\n kehtis valikute nimekirja hankimise ajal. Parameetri korrektne\n kasutamine võimaldab kogumisteenusel valijat hoiatada kui tema\n ringkonnakuuluvus on võrreldes hääletamise algushetkega\n muutunud.\n:params.OS: Operatsioonisüsteem, millel valijarakendust kasutatakse.\n:params.Type: Allkirjastatud hääle vorming. Hetkel on ainus toetatud väärtus\n ``bdoc``.\n:params.Vote: BASE64-kodeeritud hääl ``SignedVote`` eelpoolmääratud vormingus\n (:ref:`signed-vote`).\n\nPäring ``RPC.Vote`` ID-kaardiga autentimise korral.\n\n.. literalinclude:: ../../common/examples/id.rpc.vote.query.json\n :language: json\n :linenos:\n\nPäring ``RPC.Vote`` Mobiil-ID'ga autentimise korral.\n\n.. literalinclude:: ../../common/examples/mid.rpc.vote.query.json\n :language: json\n :linenos:\n\nPäring ``RPC.Vote`` Smart-ID'ga autentimise korral.\n\n.. literalinclude:: ../../common/examples/smartid.rpc.vote.query.json\n :language: json\n :linenos:\n\nPäring ``RPC.Vote`` Web eID'ga autentimise korral.\n\n.. literalinclude:: ../../common/examples/webeid.rpc.vote.query.json\n :language: json\n :linenos:\n\nHääletamisteenuse vastus päringule ``RPC.Vote``.\n\n:result.Qualification.ocsp:\n:result.Qualification.tspreg:\n Kogumisteenuse poolt hangitud täiendavad tõendid valijarakenduse poolt\n loodud hääle ``SignedVote`` (:ref:`signed-vote`) kvalifitseerimiseks ning\n korrektseks registreerimiseks. Vastuse koosseis sõltub kogumisteenuse\n konkreetsest seadistusest, antud juhul kasutatakse standardset OCSP\n protokolli valija allkirjasertifikaadi kehtivuse kontrolliks ning PKIX\n ajatempliprotokolli põhist registreerimisteenust nii hääle andmise aja\n fikseerimiseks kui elektroonilise hääle registreerimiseks välises sõltumatus\n teenuses. Valijarakendusele kontrollimiseks edastatakse nii OCSP vastus kui\n PKIX vormingus ajatempel koos registreerimisteenusele vajalike täiendustega.\n:result.TestVote: Kui hääl esitati enne hääletamise algust ning läks arvesse\n proovihäälena, siis ``true``, vastasel juhul seda välja\n vastuses ei ole. Valijarakendus kuvab valijale proovihääle\n korral sellekohase hoiatuse.\n:result.VoteID: Hääle identifikaator talletusteenuses, mille alusel on\n kontrollrakendusel võimalik häält hilisemaks analüüsiks välja\n nõuda.\n\n.. literalinclude:: ../../common/examples/id.rpc.vote.response.json\n :language: json\n :linenos:\n\nVõimalikud veateated päringu ``RPC.Vote`` korral.\n\n:BAD_CERTIFICATE: Viga valija isikutuvastus- või allkirjastamissertifikaadiga.\n:BAD_REQUEST: Vigane päring.\n:IDENTITY_MISMATCH: Isikutuvastus- ning allkirjastamissertifikaadi isikukoodid\n ei kattu.\n:INELIGIBLE_VOTER: Valijal pole õigust hääletada.\n:INTERNAL_SERVER_ERROR: Viga serveri sisemises töös.\n:OUTDATED_CHOICES: Valija ringkonnakuuluvus on nimekirja hankimisest muutunud.\n:UNAUTHENTICATED: Autentimata päring.\n:VOTER_TOO_YOUNG: Valija on liiga noor.\n:VOTING_END: Hääletusperiood on lõppenud.\n\n\nHääletamine Mobiil-ID'ga\n------------------------\n\nMobiil-ID kasutamine allkirjastamis- ning autentimisvahendina tingib Mobiil-ID\nteenusega liidestuva abiteenuse (SNI ``mid.ivxv.invalid``) kasutamise\nautentimistõendi hankimiseks enne valikute nimekirja hankimist ning hääle\nallkirjastamiseks enne talletamist.\n\n\nAutentimistõendi hankimine\n**************************\n\nValijarakendus teeb päringu ``RPC.Authenticate`` Mobiil-ID autentimise\nalgatamiseks.\n\n:params.OS: Operatsioonisüsteem, millel valijarakendust kasutatakse.\n:params.IDCode: Mobiil-ID kasutaja isikukood.\n:params.PhoneNo: Mobiil-ID kasutaja telefoninumber.\n\n.. literalinclude:: ../../common/examples/mid.rpc.authenticate.query.json\n :language: json\n :linenos:\n\n:result.Challenge: Räsi, millest arvutada Mobiil-ID kontrollkood valijarakenduses\n kuvamiseks\n:result.SessionCode: Mobiil-ID seansiidentifikaator edasiste poll-päringute\n jaoks\n\n.. literalinclude:: ../../common/examples/mid.rpc.authenticate.response.json\n :language: json\n :linenos:\n\nVõimalikud veateated päringu ``RPC.Authenticate`` korral.\n\n:BAD_REQUEST: Vigane päring.\n:INTERNAL_SERVER_ERROR: Viga serveri sisemises töös.\n:VOTING_END: Hääletusperiood on lõppenud.\n\nValijarakendus teeb päringu ``RPC.AuthenticateStatus`` autentimisprotsessi oleku\nhindamiseks.\n\n:params.OS: Operatsioonisüsteem, millel valijarakendust kasutatakse.\n:params.SessionCode: Autentimisseansi identifikaator\n\n.. literalinclude:: ../../common/examples/mid.rpc.authenticatestatus.query.json\n :language: json\n :linenos:\n\n\n:result.AuthToken: Autentimistõend teistele IVXV teenustele esitamiseks või\n ``null``, kui päringu töötlemine alles käib.\n:result.GivenName: Eduka autentimise korral valija eesnimi\n:result.PersonalCode: Eduka autentimise korral valija isikukood\n:result.Status: Päringu staatus - ``POLL`` viitab vajadusele päringut korrata, ``OK``\n viitab edukale autentimisele. Vastuse muud väljad sisaldavad\n infot vaid siis kui väärtus on ``OK``.\n:result.Surname: Eduka autentimise korral valija perekonnanimi\n\n\n.. literalinclude:: ../../common/examples/mid.rpc.authenticatestatus.response.json\n :language: json\n :linenos:\n\n.. literalinclude:: ../../common/examples/mid.rpc.authenticatestatus2.response.json\n :language: json\n :linenos:\n\nVõimalikud veateated päringu ``RPC.AuthenticateStatus`` korral.\n\n:BAD_REQUEST: Vigane päring.\n:INTERNAL_SERVER_ERROR: Viga serveri sisemises töös.\n:MID_BAD_CERTIFICATE: Viga valija Mobiil-ID isikutuvastussertifikaadiga.\n:MID_NOT_USER: Telefoninumber ei kuulu Mobiil-ID kliendile.\n:MID_OPERATOR: Probleem valija mobiiltelefoni SIM kaardiga, mille lahendamiseks\n tuleb pöörduda mobiilioperaatori poole.\n:MID_ABSENT: Valija mobiiltelefon ei ole kättesaadav.\n:MID_CANCELED: Valija katkestas Mobiil-ID seansi.\n:MID_EXPIRED: Mobiil-ID seanss on aegunud.\n:MID_GENERAL: Viga Mobiil-ID teenuse töös.\n:VOTING_END: Hääletusperiood on lõppenud.\n\n\nHääle allkirjastamine\n*********************\n\nValijarakendus teeb päringu ``RPC.GetCertificate`` allkirjastamissertifikaadi\nhankimiseks.\n\n:params.AuthMethod: Toetatud ainult autentimismeetod ``ticket``.\n:params.AuthToken: Mobiil-ID autentimistõend.\n:params.OS: Operatsioonisüsteem, millel valijarakendust kasutatakse.\n:params.PhoneNo: Hääle allkirjastaja telefoninumber\n\n.. literalinclude:: ../../common/examples/mid.rpc.getcertificate.query.json\n :language: json\n :linenos:\n\n\n:result.Certificate: Allkirjastamissertifikaat X509-vormingus\n\n.. literalinclude:: ../../common/examples/mid.rpc.getcertificate.response.json\n :language: json\n :linenos:\n\nVõimalikud veateated päringu ``RPC.GetCertificate`` korral.\n\n:BAD_REQUEST: Vigane päring.\n:INTERNAL_SERVER_ERROR: Viga serveri sisemises töös.\n:MID_BAD_CERTIFICATE: Viga valija Mobiil-ID allkirjastamissertifikaadiga.\n:MID_GENERAL: Viga Mobiil-ID teenuse töös.\n:MID_NOT_USER: Telefoninumber ei kuulu Mobiil-ID kliendile.\n:VOTING_END: Hääletusperiood on lõppenud.\n\n\nValijarakendus teeb päringu ``RPC.Sign`` hääle allkirjastamise algatamiseks.\nMobiil-ID kontrollkoodi arvutab valijarakendus andmevälja ``Hash`` väärtusest.\n\n:params.AuthMethod: Toetatud ainult autentimismeetod ``ticket``.\n:params.AuthToken: Mobiil-ID autentimistõend.\n:params.Hash: BASE64-kodeeritud elektroonilise hääle räsi\n:params.HashType: Räsifunktsiooni nimi Mobiil-ID teenusele edastamiseks, kas\n ``SHA256``, ``SHA384`` või ``SHA512``\n:params.OS: Operatsioonisüsteem, millel valijarakendust kasutatakse.\n:params.PhoneNo: Hääle allkirjastaja telefoninumber\n\n.. literalinclude:: ../../common/examples/mid.rpc.sign.query.json\n :language: json\n :linenos:\n\n:result.SessionCode: Mobiil-ID seansiidentifikaator edasiste poll-päringute\n jaoks.\n\n.. literalinclude:: ../../common/examples/mid.rpc.sign.response.json\n :language: json\n :linenos:\n\nVõimalikud veateated päringu ``RPC.Sign`` korral.\n\n:BAD_REQUEST: Vigane päring.\n:INTERNAL_SERVER_ERROR: Viga serveri sisemises töös.\n:VOTING_END: Hääletusperiood on lõppenud.\n\n\nValijarakendus teeb päringu ``RPC.SignStatus`` allkirjastamisprotsessi seisundi\nhindamiseks.\n\n:params.OS: Operatsioonisüsteem, millel valijarakendust kasutatakse.\n:params.SessionCode: Mobiil-ID seansiidentifikaator\n\n.. literalinclude:: ../../common/examples/mid.rpc.signstatus.query.json\n :language: json\n :linenos:\n\n:result.Signature: Juhul kui vastuse ``Status`` väli on ``OK``, BASE-64 kodeeritud\n PKCS1-vormingus signatuur, vastasel juhul ``null``.\n:result.Algorithm: Juhul kui vastuse ``Status`` väli on ``OK``, Mobiil-ID teenuse\n poolt tagastatud signatuuri algoritm. Võimalikud väärtused on\n ``SHA256WithECEncryption``, ``SHA256WithRSAEncryption``,\n ``SHA384WithECEncryption``, ``SHA384WithRSAEncryption``,\n ``SHA512WithECEncryption`` ja ``SHA512WithRSAEncryption``.\n:result.Status: Päringu staatus - ``POLL`` viitab vajadusele päringut korrata, ``OK``\n viitab edukale allkirjastamisele. Vastuse muud väljad sisaldavad\n infot vaid siis kui väärtus on ``OK``.\n\n.. literalinclude:: ../../common/examples/mid.rpc.signstatus.response.json\n :language: json\n :linenos:\n\n.. literalinclude:: ../../common/examples/mid.rpc.signstatus2.response.json\n :language: json\n :linenos:\n\nVõimalikud veateated päringu ``RPC.SignStatus`` korral.\n\n:BAD_REQUEST: Vigane päring.\n:INTERNAL_SERVER_ERROR: Viga serveri sisemises töös.\n:MID_ABSENT: Valija mobiiltelefon ei ole kättesaadav.\n:MID_BAD_CERTIFICATE: Viga valija Mobiil-ID allkirjastamissertifikaadiga.\n:MID_OPERATOR: Probleem valija mobiiltelefoni SIM kaardiga, mille lahendamiseks\n tuleb pöörduda mobiilioperaatori poole.\n:MID_CANCELED: Valija katkestas Mobiil-ID seansi.\n:MID_EXPIRED: Mobiil-ID seanss on aegunud.\n:MID_GENERAL: Viga Mobiil-ID teenuse töös.\n:VOTING_END: Hääletusperiood on lõppenud.\n\n\nHääletamine Smart-ID'ga\n------------------------\n\nSmart-ID kasutamine allkirjastamis- ning autentimisvahendina tingib Smart-ID\nteenusega liidestuva abiteenuse (SNI ``smartid.ivxv.invalid``) kasutamise\nautentimistõendi hankimiseks enne valikute nimekirja hankimist ning hääle\nallkirjastamiseks enne talletamist.\n\n\nAutentimistõendi hankimine\n**************************\n\nValijarakendus teeb päringu ``RPC.Challenge`` Smart-ID kontrollkoodi hankimiseks.\n\n:params.OS: Operatsioonisüsteem, millel valijarakendust kasutatakse.\n\n.. literalinclude:: ../../common/examples/smartid.rpc.challenge.query.json\n :language: json\n :linenos:\n\n:result.Challenge: Räsi, millest arvutada Smart-ID kontrollkood valijarakenduses\n kuvamiseks\n:result.XSmartIDAuth: Päringu küpsis, kus talletatakse Smart-ID kontrollkoodi\n räsi, selle eluea ajatempel ja seansiidentifikaator\n\n.. literalinclude:: ../../common/examples/smartid.rpc.challenge.response.json\n :language: json\n :linenos:\n\nVõimalikud veateated päringu ``RPC.Authenticate`` korral.\n\n:BAD_REQUEST: Vigane päring.\n:INTERNAL_SERVER_ERROR: Viga serveri sisemises töös.\n:VOTING_END: Hääletusperiood on lõppenud.\n\nValijarakendus teeb päringu ``RPC.Authenticate`` Smart-ID autentimise\nalgatamiseks.\n\n:params.OS: Operatsioonisüsteem, millel valijarakendust kasutatakse.\n:params.XSmartIDAuth: Päringu küpsis, kus talletatakse Smart-ID kontrollkoodi\n räsi, selle eluea ajatempel ja seansiidentifikaator\n:params.Identifier: Smart-ID kasutaja isikukood.\n\n.. literalinclude:: ../../common/examples/smartid.rpc.authenticate.query.json\n :language: json\n :linenos:\n\n:result.SessionCode: Smart-ID seansiidentifikaator edasiste poll-päringute\n jaoks\n\n.. literalinclude:: ../../common/examples/smartid.rpc.authenticate.response.json\n :language: json\n :linenos:\n\nVõimalikud veateated päringu ``RPC.Authenticate`` korral.\n\n:BAD_REQUEST: Vigane päring.\n:INTERNAL_SERVER_ERROR: Viga serveri sisemises töös.\n:VOTING_END: Hääletusperiood on lõppenud.\n\nValijarakendus teeb päringu ``RPC.AuthenticateStatus`` autentimisprotsessi oleku\nhindamiseks.\n\n:params.OS: Operatsioonisüsteem, millel valijarakendust kasutatakse.\n:params.XSmartIDAuth: Päringu küpsis, kus talletatakse Smart-ID kontrollkoodi\n räsi, selle eluea ajatempel ja seansiidentifikaator\n:params.SessionCode: Autentimisseansi identifikaator\n\n.. literalinclude:: ../../common/examples/smartid.rpc.authenticatestatus.query.json\n :language: json\n :linenos:\n\n\n:result.AuthToken: Autentimistõend teistele IVXV teenustele esitamiseks või\n ``null``, kui päringu töötlemine alles käib.\n:result.DataToken: Hääletaja Smart-ID dokumendi number või\n ``null``, kui päringu töötlemine alles käib.\n:result.GivenName: Eduka autentimise korral valija eesnimi\n:result.PersonalCode: Eduka autentimise korral valija isikukood\n:result.Status: Päringu staatus - ``POLL`` viitab vajadusele päringut korrata, ``OK``\n viitab edukale autentimisele. Vastuse muud väljad sisaldavad\n infot vaid siis kui väärtus on ``OK``.\n:result.Surname: Eduka autentimise korral valija perekonnanimi\n\n\n.. literalinclude:: ../../common/examples/smartid.rpc.authenticatestatus.response.json\n :language: json\n :linenos:\n\n.. literalinclude:: ../../common/examples/smartid.rpc.authenticatestatus2.response.json\n :language: json\n :linenos:\n\nVõimalikud veateated päringu ``RPC.AuthenticateStatus`` korral.\n\n:BAD_REQUEST: Vigane päring.\n:INTERNAL_SERVER_ERROR: Viga serveri sisemises töös.\n:SMARTID_BAD_CERTIFICATE: Viga valija Smart-ID isikutuvastussertifikaadiga.\n:SMARTID_VERIFICATION: Valija valis vale verifitseerimiskoodi.\n:SMARTID_ACCOUNT: Viga valija Smart-ID kontos.\n:SMARTID_CANCELED: Valija katkestas Smart-ID seansi.\n:SMARTID_EXPIRED: Smart-ID seanss on aegunud.\n:SMARTID_GENERAL: Viga Smart-ID teenuse töös.\n:VOTING_END: Hääletusperiood on lõppenud.\n\n\nHääle allkirjastamine\n*********************\n\nValijarakendus teeb päringu ``RPC.GetCertificateChoice`` allkirjastamissertifikaadi\nvalikuks.\n\n:params.AuthMethod: Toetatud ainult autentimismeetod ``ticket``.\n:params.AuthToken: Smart-ID autentimistõend.\n:params.DataToken: Hääletaja Smart-ID dokumendi number.\n:params.OS: Operatsioonisüsteem, millel valijarakendust kasutatakse.\n\n.. literalinclude:: ../../common/examples/smartid.rpc.getcertificatechoice.query.json\n :language: json\n :linenos:\n\n:result.SessionCode: Smart-ID seansiidentifikaator edasiste poll-päringute\n jaoks\n\n.. literalinclude:: ../../common/examples/smartid.rpc.getcertificatechoice.response.json\n :language: json\n :linenos:\n\nValijarakendus teeb päringu ``RPC.GetCertificateChoiceStatus`` allkirjastamissertifikaadi\noleku hindamiseks.\n\n\n:params.OS: Operatsioonisüsteem, millel valijarakendust kasutatakse.\n:params.SessionCode: Autentimisseansi identifikaator\n\n.. literalinclude:: ../../common/examples/smartid.rpc.getcertificatechoicestatus.query.json\n :language: json\n :linenos:\n\n:result.Certificate: Allkirjastamissertifikaat X509-vormingus\n:result.Status: Päringu staatus - ``POLL`` viitab vajadusele päringut korrata, ``OK``\n viitab edukale autentimisele. Vastuse muud väljad sisaldavad\n infot vaid siis kui väärtus on ``OK``.\n\n.. literalinclude:: ../../common/examples/smartid.rpc.getcertificatechoicestatus.response.json\n :language: json\n :linenos:\n\n.. literalinclude:: ../../common/examples/smartid.rpc.getcertificatechoicestatus2.response.json\n :language: json\n :linenos:\n\nVõimalikud veateated päringu ``RPC.GetCertificateChoiceStatus`` korral.\n\n:BAD_REQUEST: Vigane päring.\n:INTERNAL_SERVER_ERROR: Viga serveri sisemises töös.\n:SMARTID_BAD_CERTIFICATE: Viga valija Smart-ID allkirjastamissertifikaadiga.\n:SMARTID_GENERAL: Viga Smart-ID teenuse töös.\n:VOTING_END: Hääletusperiood on lõppenud.\n\n\nValijarakendus teeb päringu ``RPC.Sign`` hääle allkirjastamise algatamiseks.\nSmart-ID kontrollkoodi arvutab valijarakendus andmevälja ``Hash`` väärtusest.\n\n:params.AuthMethod: Toetatud ainult autentimismeetod ``ticket``.\n:params.AuthToken: Smart-ID autentimistõend.\n:params.Hash: BASE64-kodeeritud elektroonilise hääle räsi\n:params.HashType: Räsifunktsiooni nimi Smart-ID teenusele edastamiseks, kas\n ``SHA256``, ``SHA384`` või ``SHA512``\n:params.OS: Operatsioonisüsteem, millel valijarakendust kasutatakse.\n:params.DataToken: Hääletaja Smart-ID dokumendi number.\n\n.. literalinclude:: ../../common/examples/smartid.rpc.sign.query.json\n :language: json\n :linenos:\n\n:result.SessionCode: Smart-ID seansiidentifikaator edasiste poll-päringute\n jaoks.\n\n.. literalinclude:: ../../common/examples/smartid.rpc.sign.response.json\n :language: json\n :linenos:\n\nVõimalikud veateated päringu ``RPC.Sign`` korral.\n\n:BAD_REQUEST: Vigane päring.\n:INTERNAL_SERVER_ERROR: Viga serveri sisemises töös.\n:VOTING_END: Hääletusperiood on lõppenud.\n\n\nValijarakendus teeb päringu ``RPC.SignStatus`` allkirjastamisprotsessi seisundi\nhindamiseks.\n\n:params.OS: Operatsioonisüsteem, millel valijarakendust kasutatakse.\n:params.SessionCode: Smart-ID seansiidentifikaator\n\n.. literalinclude:: ../../common/examples/smartid.rpc.signstatus.query.json\n :language: json\n :linenos:\n\n:result.Signature: Juhul kui vastuse ``Status`` väli on ``OK``, BASE-64 kodeeritud\n signatuur, vastasel juhul ``null``.\n:result.Algorithm: Juhul kui vastuse ``Status`` väli on ``OK``, Smart-ID teenuse\n poolt tagastatud signatuuri algoritm. Võimalikud väärtused on\n ``sha256WithRSAEncryption``, ``sha384WithRSAEncryption``,\n ja ``sha512WithRSAEncryption``.\n:result.Status: Päringu staatus - ``POLL`` viitab vajadusele päringut korrata, ``OK``\n viitab edukale allkirjastamisele. Vastuse muud väljad sisaldavad\n infot vaid siis kui väärtus on ``OK``.\n\n.. literalinclude:: ../../common/examples/smartid.rpc.signstatus.response.json\n :language: json\n :linenos:\n\n.. literalinclude:: ../../common/examples/smartid.rpc.signstatus2.response.json\n :language: json\n :linenos:\n\nVõimalikud veateated päringu ``RPC.SignStatus`` korral.\n\n:BAD_REQUEST: Vigane päring.\n:INTERNAL_SERVER_ERROR: Viga serveri sisemises töös.\n:SMARTID_BAD_CERTIFICATE: Viga valija Smart-ID isikutuvastussertifikaadiga.\n:SMARTID_VERIFICATION: Valija valis vale verifitseerimiskoodi.\n:SMARTID_ACCOUNT: Viga valija Smart-ID kontos.\n:SMARTID_CANCELED: Valija katkestas Smart-ID seansi.\n:SMARTID_EXPIRED: Smart-ID seanss on aegunud.\n:SMARTID_GENERAL: Viga Smart-ID teenuse töös.\n:VOTING_END: Hääletusperiood on lõppenud.\n\nHääletamine Web eID'ga\n------------------------\n\nWeb eID kasutamine autentimisvahendina tingib Web eID\nteenusega liidestuva abiteenuse (SNI ``webeid.ivxv.invalid``) kasutamise\nautentimistõendi hankimiseks enne valikute nimekirja hankimist.\n\n\nAutentimistõendi hankimine\n**************************\n\nValijarakendus teeb päringu ``RPC.Challenge`` Web eID autentimise\nalgatamiseks.\n\n:params.OS: Operatsioonisüsteem, millel valijarakendust kasutatakse.\n\n.. literalinclude:: ../../common/examples/webeid.rpc.challenge.query.json\n :language: json\n :linenos:\n\n:result.Challenge: Base64 kodeeritud räsi, mille dekodeeritud väärtust peab\n valijarakendus kasutama autentimistõendi allkirja loomiseks.\n:params.SessionID: Seansiidentifikaator.\n:params.Bearer: Küpsis, mida server kasutab räsi verifitseerimiseks.\n\n.. literalinclude:: ../../common/examples/webeid.rpc.challenge.response.json\n :language: json\n :linenos:\n\nVõimalikud veateated päringu ``RPC.Challenge`` korral.\n\n:BAD_REQUEST: Vigane päring.\n:INTERNAL_SERVER_ERROR: Viga serveri sisemises töös.\n:VOTING_END: Hääletusperiood on lõppenud.\n\nValijarakendus teeb päringu ``RPC.Token`` autentimistõendi valideerimiseks.\n\n:params.OS: Operatsioonisüsteem, millel valijarakendust kasutatakse.\n:params.SessionID: Seansiidentifikaator.\n:params.Token: Web eID autentimistõend.\n:params.Bearer: Küpsis, mida server kasutab räsi verifitseerimiseks.\n\n.. literalinclude:: ../../common/examples/webeid.rpc.token.query.json\n :language: json\n :linenos:\n\n:result.AuthToken: Autentimistõend teistele IVXV teenustele esitamiseks\n:result.GivenName: Eduka autentimise korral valija eesnimi\n:result.PersonalCode: Eduka autentimise korral valija isikukood\n:result.Status: Päringu staatus - ``OK`` viitab edukale autentimisele.\n Vastuse muud väljad sisaldavad infot vaid siis kui\n väärtus on ``OK``.\n:result.Surname: Eduka autentimise korral valija perekonnanimi\n\n\n.. literalinclude:: ../../common/examples/webeid.rpc.token.response.json\n :language: json\n :linenos:\n\nVõimalikud veateated päringu ``RPC.Token`` korral.\n\n:BAD_REQUEST: Vigane päring.\n:INTERNAL_SERVER_ERROR: Viga serveri sisemises töös.\n:BAD_CERTIFICATE: Viga valija Web eID isikutuvastussertifikaadiga.\n:VOTING_END: Hääletusperiood on lõppenud.\n\nHääle kontrollimine\n-------------------\n\nKontrollrakendus teeb päringu ``RPC.Verify`` allkirjastatud hääle ning häält\nkvalifitseerivate tõendite allalaadimiseks kogumisteenusest.\n\n:params.OS: Operatsioonisüsteem, millel kontrollrakendust kasutatakse.\n:params.VoteID: QR-koodi vahendusel valijarakendusest saadud hääle\n identifikaator talletusteenuses.\n\n.. literalinclude:: ../../common/examples/ver.rpc.verify.query.json\n :language: json\n :linenos:\n\n:result.Qualification.ocsp:\n:result.Qualification.tspreg:\n Vaata peatükki hääle verifitseerimisest\n\n\n:result.Type: Allkirjastatud hääle vorming. Hetkel on ainus toetatud väärtus\n ``bdoc``.\n:result.Vote: BASE64-kodeeritud hääl ``SignedVote`` eelpoolmääratud vormingus\n (:ref:`signed-vote`).\n:result.ChoicesList: JSON-vormingus ringkonnapõhine valikute nimekiri.\n\n.. literalinclude:: ../../common/examples/ver.rpc.verify.response.json\n :language: json\n :linenos:\n\nVõimalikud veateated päringu ``RPC.Verify`` korral.\n\n:BAD_REQUEST: Vigane päring.\n:INTERNAL_SERVER_ERROR: Viga serveri sisemises töös.\n:VOTING_END: Hääletusperiood on lõppenud.\n\n\nE-hääletamise jooksev nimekiri\n------------------------------\n\nX-tee teenusega(xroad-service) liidestuva abiteenuse (SNI ``votesorder.ivxv.invalid``) kasutatakse\ninformatsiooni edastamiseks X-tee turvaserverile.\n\n\nViimane järjenumber\n*******************\nX-tee teenus(xroad-service) teeb päringu ``RPC.VotesSeqNo`` viimase järjenumbri saamiseks.\n\n.. literalinclude:: ../../common/examples/votesorder.rpc.votesseqno.query.json\n :language: json\n :linenos:\n\n:result.SeqNo:\n Viimane järjenumber.\n\n.. literalinclude:: ../../common/examples/votesorder.rpc.votesseqno.response.json\n :language: json\n :linenos:\n\nVõimalikud veateated päringu ``RPC.VotesSeqNo`` korral.\n\n:INTERNAL_SERVER_ERROR: Viga serveri sisemises töös.\n:VOTING_END: Hääletusperiood on lõppenud.\n\nE-hääletamiste pakk\n*******************\nX-tee teenus(xroad-service) teeb päringu ``RPC.Votes`` e-hääletamise paki saamiseks.\n\n:params.VotesFrom: E-hääled alates sellest järjenumbrist.\n:params.BatchMaxSize: E-hääletamise paki suurus.\n\n.. literalinclude:: ../../common/examples/votesorder.rpc.votes.query.json\n :language: json\n :linenos:\n\n:result.batchRecords:\n E-häälte loend\n:result.batchRecords.seqNo:\n Hääle järjenumber\n:result.batchRecords.idCode:\n Hääletaja isikukood\n:result.batchRecords.voterName:\n Hääletaja nimi\n:result.batchRecords.kovCode:\n KOV EHAK kood\n:result.batchRecords.electoralDistrictNo:\n Valimisringkonna number\n\n.. literalinclude:: ../../common/examples/votesorder.rpc.votes.response.json\n :language: json\n :linenos:\n\nVõimalikud veateated päringu ``RPC.Votes`` korral.\n\n:BAD_REQUEST: Vigane päring.\n:INTERNAL_SERVER_ERROR: Viga serveri sisemises töös.\n:VOTING_END: Hääletusperiood on lõppenud.\n" }, { "path": "Documentation/public/protokollid/09-tootlemine.rst", "content": ".. IVXV protokollid\n\n==============================================\nE-valimiskasti töötlemisetapi andmestruktuurid\n==============================================\n\n\nTühistus- ja ennistusnimekiri\n-----------------------------\n\nTühistus- ja ennistusnimekiri sisaldab andmeid isikute kohta, kelle e-hääl tuleb tühistada (ei lähe arvesse valimistulemuste kokkulugemisel) või ennistada (s.t. tühistatakse eelnev tühistamine ning häälte uuesti üle lugemisel võetakse ennistatud e-hääl arvesse). Nimekiri laaditakse süsteemi digitaalselt allkirjastatud dokumendina, mille andmefaili vorming on järgmine:\n\n.. literalinclude:: ../../common/schema/ivxv.revoke.schema\n :language: json\n :linenos:\n\nNäide:\n\n.. literalinclude:: ../../common/schema/ivxv.revoke.schema.example\n :language: json\n\n\nE-hääletanute nimekiri\n----------------------\n\nE-hääletanute nimekiri on pärast e-hääletamise lõppu väljastatav nimekiri\ne-hääletanud isikutest, sordituna valimisjaoskondade kaupa. Dokument\ngenereeritakse töötlemisrakenduse poolt.\n\n.. literalinclude:: ../../common/schema/ivxv.voterlist.schema\n :language: json\n :linenos:\n\n\nNäide:\n\n.. literalinclude:: ../../common/schema/ivxv.voterlist.schema.example\n :language: json\n\n\nHääletamistulemus\n-----------------\n\nVõtmerakenduse poolt dekrüpteeritud ning summeeritud hääled jagatud\nvalimisringkondade ja jaoskondade kaupa.\n\nHääletamistulemuste failis peavad iga jaoskonna kohta olema järgmised andmed.\n\n#. Rikutud ja kehtetute häälte arvu näitav kirje. Seda ka juhul, kui\n valimisjaoskonnas polnud ühtki rikutud või kehtetut häält: sellisel juhul on\n häälte arv null.\n\n#. Iga valiku poolt antud häälte arvu näitav kirje. Seda ka juhul, kui\n valimisjaoskonnas ei antud selle valiku poolt ühtki häält: sellisel juhul on\n häälte arv null.\n\n.. literalinclude:: ../../common/schema/ivxv.result.schema\n :language: json\n :linenos:\n\nNäide:\n\n.. literalinclude:: ../../common/schema/ivxv.result.schema.example\n :language: json\n\n\n\nE-valimiskast\n-------------\n\nFail sisaldab kogumisteenuse poolt vastu võetud hääli koos häälte juurde\nkuuluvate andmetega.\n\nFaili vorming on Zip64 konteiner.\n\nValija-spetsiifilised kaustad asuvad vahetult juurkausta `votes` all.\n\nFaili sisu:\n\n* :file:`votes//`\n\n * :file:`.version`\n\n * :file:`.`\n\n * :file:`.*`\n\nkus:\n\n* ```` on valija identifikaator, Eesti puhul isikukood;\n\n* ```` on hääle esitamise kellaaeg vormingus\n ``yyyymmddhhmmssmmm±zzzz``;\n\n * see kellaaeg kajastab hetke, mil päring kogumisteenusesse tehti, ja on\n antud lihtsalt valimiskasti inimloetavuse parandamiseks; hääle tegelik ajamärk või\n -tempel on mõne kvalifitseeriva vastuse sees;\n\n* ```` on valikute konteineri tüüp, Eesti puhul BDOC;\n\n * kusjuures BDOC ise on lihtsalt põhiprofiiliga ja ei sisalda\n kvalifitseerivad parameetreid (kehtivuskinnitusi, ajamärgendeid,\n ajatempleid),\n\n* ```` on häält kvalifitseeriva protokolli tüüp, millest hetkel\n võimalikud on:\n\n * ``ocsp`` - *Online Certificate Status Protocol* (kehtivuskinnitus, `RFC\n 6960 `_) kinnitab valija\n allkirjastamissertifikaadi kehtivust hääle andmise hetkel,\n\n * ``tsp`` - *Time-Stamp Protocol* (ajatempel, `RFC 3161\n `_) kinnitab, et päringu tegemise\n hetkeks oli hääl olemas,\n\n * ``tspreg`` - sama, mis ``tsp``, aga nonsiks pannakse kogumisteenuse\n allkiri päringu ``MessageImprint`` elemendil, et häält registreerida.\n\n* Iga hääle kohta esinevad failid on:\n\n * ``.version`` - hääle andmise ajal kehtinud valijate nimekirja\n versioon;\n\n * ``.`` - valikute konteiner, mille sees on valiku\n identifikaator kujul ``..ballot``. Eesti puhul\n BDOC-konteineris olev vastava nimega fail;\n\n * ``.`` - häält kvalifitseeriva protokolli päringu\n vastus; neid võib esineda mitu, aga iga protokolli kohta maksimaalselt\n üks.\n\n\nAnonüümistatud e-valimiskast\n----------------------------\n\nValimisringkondade ja jaoskondade järgi grupeeritud krüpteeritud hääled.\nAnonüümistatud e-valimiskastis puudub informatsioon valijate kohta.\n\nAnonüümistatud e-valimiskast on töötlemisrakenduse väljund ning võtmerakenduse\ndekrüpteerimise tööriista sisend.\n\n.. literalinclude:: ../../common/schema/ivxv.anon-bb.schema\n :language: json\n :linenos:\n\nNäide:\n\n.. literalinclude:: ../../common/schema/ivxv.anon-bb.schema.example\n :language: json\n" }, { "path": "Documentation/public/protokollid/11-audit.rst", "content": ".. IVXV protokollid\n\n========================\nHääletamistulemuse audit\n========================\n\nMiksimistõendi kontroll\n=======================\n\nMiksimistõendi kontrollimiseks kasutatakse algoritmi nagu on defineeritud\n`Verificatumi verifitseerija implementeerimise manuaalis\n`_.\n\nMärgime, et miksimistõendi koostamisel lisatakse krüptogrammile andmed valimiste,\nringkonna, jaoskonna ja küsimuse identifikaatori kohta. Lisamiseks kodeeritakse\nvastav väli rühma elemendina, kasutades pimendamiseks juhuslikkust 0. Näitena,\nkui esialgu on krüptogramm :math:`c_0 = (c_{00}, c_{01})`, kasutades avalikku\nvõtit :math:`pk = (g, y)`, siis Verificatumi sisendina kasutatakse laia\nkrüptogrammi :math:`C = (c_{id}, c_d, c_s, c_q, c_0)`, kus:\n\n* valimiste identifikaatori pseudokrüptogramm on antud kujul :math:`c_{id} = (1,\n encode(id))`, kus funktsioon :math:`encode` kodeerib sõne vastava rühma\n elemendina ja `id` on valimiste identifikaatori sõne.\n* ringkonna identifikaatori pseudokrüptogramm on antud kujul :math:`c_d = (1,\n encode(d))`, kus `d` on ringkonna identifikaatori sõne.\n* jaoskonna identifikaatori pseudokrüptogramm on antud kujul :math:`c_s = (1,\n encode(s))`, kus `s` on jaoskonna identifikaatori sõne.\n* küsimuse identifikaatori pseudokrüptogramm on antud kujul :math:`c_q = (1,\n encode(q))`, kus `q` on küsimuse identifikaatori sõne.\n\nSellisel juhul defineeritakse laia krüptogrammile vastava avaliku võtmena\n:math:`((g,1), (g,1), (g,1), (g,1), (g,y))`.\n\nKorrektse dekrüpteerimise tõendi kontroll\n=========================================\n\nOlgu antud krüptogramm :math:`c = (c_0, c_1)`, mis dekrüpteeritakse väärtuseks\n:math:`d` antud avaliku võtmega :math:`pk` üle parameetrite :math:`(p,g)` ja\ndekrüpteerimistõendiga :math:`(a,b,s)`.\n\nKorrektse dekrüpteerimise kontrollimise jaoks on tarvis arvutada\nmitte-interaktiivne kontrollija väljakutse. Selle jaoks kodeeritakse\n:math:`\"DECRYPTION\" || pk || c || d || a || b` DER-kodeeringus. Baidijada\nkasutatakse deterministliku juhuarvugeneraatori initsialiseerimiseks ja selle\nväljundist loetakse rühma järgu pikkune täisarv :math:`k`.\n\nDekrüpteerimistõendi kontrolliks tuleb veenduda, et :math:`c_0^s\n= a * (c_1/d)^k` ja :math:`g^s = b * y^k`.\n\nKorrektse teisendamise kontroll\n===============================\n\nKontrollimaks, et teisendus IVXV e-valimiskasti ja Verificatumi krüptogrammide vahel on\ntehtud korrektselt, tuleb korrata teisendust sõltumatult. Pärast sõltumatut\nteisendust tuleb võrrelda saadud väljundeid. Kuna teisendamine on deterministlik\nprotseduur, siis garanteerib kordamine tegevuse õigsuse.\n" }, { "path": "Documentation/public/protokollid/12-lisad.rst", "content": ".. IVXV protokollid\n\n=====\nLisad\n=====\n\nAndmestruktuuride ASN.1 spetsifikatsioon\n========================================\n\n.. literalinclude:: ivxv-elgamal-general.asn1\n :language: asn1\n :name: asn-general\n :linenos:\n :caption: IVXV ElGamal üldised andmestruktuurid\n\n.. literalinclude:: ivxv-elgamal-modp.asn1\n :language: asn1\n :name: asn-modp\n :linenos:\n :caption: IVXV ElGamal ModP spetsiifilised andmestruktuurid\n\n.. literalinclude:: ivxv-elgamal-ecc.asn1\n :language: asn1\n :name: asn-ecc\n :linenos:\n :caption: IVXV ElGamal ECC spetsiifilised andmestruktuurid\n\n\n\nElektroonilise hääle vormingu spetsifikatsioon\n==============================================\n\nKäesoleva protokolliversiooniga kooskõlaline ettepanek VVK otsuseks\nhääletamissedeli ja elektroonilise hääle vormi kehtestamiseks.\n\n.. literalinclude:: paragraph.txt\n\n\nVead töötlemisprotsessis\n========================\n\nAnname ülevaate veakoodidest töötlemisprotsessis. Veakoodid kirjeldavad vigu\nüksiku elemendi verifitseerimisel - hääl, registreerimistõend,\nregistreerimispäring - ning häälte, registreerimistõendite ja\nregistreerimispäringute vahelise vastavuse loomisel.\n\nEnamus veaolukordi on pigem hüpoteetilised (nt. `REG_NO_NONCE`), siiski on\ntegemist olukordadega, mis programselt võivad esineda ning seetõttu tuleb neid\nka käsitleda.\n\nVeaolukord tähendab, et konkreetne element ei liigu edasi töötlemise järgmisesse faasi.\n\n.. list-table:: Töötlemisprotsessi veakoodid\n :widths: 40 60\n :header-rows: 1\n\n * - Veakood\n - Selgitus\n * - ``INVALID_FILE_NAME``\n - Failinimi ei vasta oodatud mustrile. Viitab tundmatule failile urnis.\n * - ``MISSING_FILE``\n - Mõni hääle koosseisuks vajalik fail puudub. Nt. ajatempel.\n * - ``REPEATED_FILE``\n - Mõnda hääle koosseisuks vajalikku faili on mitu. Nt. kehtivuskinnitus.\n * - ``UNKNOWN_FILE_TYPE``\n - Faili tüüp on tundmatu või mittetoetatud.\n * - ``INVALID_FILE_SIZE``\n - Allkirjastatud hääle faili suurus ei vasta seadistustes nõutud kriteeriumitele.\n * - ``INVALID_BALLOT_SIGNATURE``\n - Hääl on vigase allkirjaga.\n * - ``MISSING_VOTER_SIGNATURE``\n - Hääl ei sisalda valija allkirja.\n * - ``VOTER_NOT_FOUND``\n - Valija ei olnud hääletamise hetkel valijate nimekirjas.\n * - ``VOTERLIST_NOT_FOUND``\n - Versioonile vastavat valijate nimekirja ei leitud.\n * - ``TIME_BEFORE_START``\n - Hääl on antud enne hääletamisperioodi algust. Viitab testhäälele.\n * - ``REG_RESP_INVALID``\n - Registreerimistõend/ajatempel on vigane. Viga ATOs või töötlejas.\n * - ``REG_REQ_INVALID``\n - Registreerimispäring on vigane. Viga kogumisteenuses või töötlejas.\n * - ``REG_RESP_NOT_UNIQUE``\n - Registreerimistõend ei ole unikaalne. Viga kogumisteenuses või töötlejas.\n * - ``REG_REQ_NOT_UNIQUE``\n - Registreerimispäring ei ole unikaalne. Sama räsiga häält on esitatud korduvalt.\n * - ``REG_NO_NONCE``\n - Registreerimistõendis puudub nonss.\n * - ``REG_NONCE_NOT_SIG``\n - Esitatud nonss ei ole IVXV protokolli kohaselt allkirjastatud.\n * - ``REG_NONCE_ALG_MISMATCH``\n - Nonssi allkirjastamisel kasutatud algoritm ei vasta oodatule.\n * - ``REG_NONCE_SIG_INVALID``\n - Nonssi allkiri on vigane.\n * - ``UNKNOWN_FILE_IN_VOTE_CONTAINER``\n - Hääle konteineris on tundmatu fail.\n * - ``TECHNICAL_ERROR``\n - Töötlemise ajal tekkis tehniline viga.\n * - ``REG_RESP_REQ_UNMATCH``\n - Registreerimistõendi andmed ei vasta registreerimispäringu andmetele.\n * - ``REG_REQ_WITHOUT_BALLOT``\n - Esitatud on registreerimispäring, kuid hääl puudub urnist. Kogumisteenuse viga.\n * - ``BALLOT_WITHOUT_REG_REQ``\n - Hääl on esitatud ilma vastava registreerimispäringuta. ATO viga.\n * - ``SAME_TIME_AS_LATEST``\n - Kaks häält samalt valijalt võivad olla arvesse võetavad viimasena.\n * - ``INVALID_SIGNATURE_PROFILE``\n - Hääle allkirjaprofiil on vigane.\n\n\nTöötlemise käigus tuvastatakse kehtetud sedelid sellisel määral, mil seda\nvõimaldavad kontrollid avaliku võtmega. Kuigi kogumisteenus ei luba kehtetuid\nsedeleid talletada, peab töötlemisrakendus kontrolle siiski kordama tagamaks\nmh. võimalike tarkvaravigade vältimise.\n\n\n.. list-table:: Krüptogrammide kehtivuse kontrolli veakoodid\n :widths: 30 70\n :header-rows: 1\n\n * - Veakood\n - Selgitus\n * - ``INVALID_BYTES``\n - Baidijada ei ole dekodeeritav ElGamalCiphertext'na\n * - ``INVALID_GROUP``\n - Väärtus ei ole oodatud rühma element\n * - ``INVALID_RANGE``\n - Väärtus on lubatud vahemikust väljas.\n * - ``INVALID_QR``\n - Väärtus ei ole ruutjääk (MODP).\n * - ``INVALID_POINT``\n - Väärtus ei ole kõvera punkt (ECC).\n * - ``INVALID``\n - Vigane šifreeritud tekst.\n\n" }, { "path": "Documentation/public/protokollid/Makefile", "content": "include ../../common.mk\n" }, { "path": "Documentation/public/protokollid/index.rst", "content": ".. IVXV seadistuste koostamise juhend\n\n========================================================\nIVXV protokollid\n========================================================\n\n.. raw:: html\n\n

\n NB!\n See on HTML-versioon dokumendist.\n Tellijale antakse üle PDF-versioon.\n

\n\n.. toctree::\n :maxdepth: 4\n\n 01-annotatsioon\n 02-ylevaade\n 04-seadistus\n 05-ehaal\n 06-talletamine\n 06a-regteenus\n 07-kontrollimine\n 08-haaletamine\n 09-tootlemine\n 11-audit\n 12-lisad\n" }, { "path": "Documentation/public/protokollid/ivxv-elgamal-ecc.asn1", "content": "id-ivxv-ecc-elgamal OBJECT IDENTIFIER ::= { iso(1) identified-organization(3) dod(6) internet(1) private(4) enterprise(1) 99999 1 }\n\nIVXVECCElGamalParameters ::= SEQUENCE {\n curve GeneralString,\n electionId GeneralString\n}\n\nIVXVECCElGamalPublicKey ::= SEQUENCE {\n pubY OCTET STRING\n}\n\nIVXVECCElGamalCiphertext ::= SEQUENCE {\n uBlind OCTET STRING,\n vBlindedMessage OCTET STRING\n}\n\nIVXVECCElGamalDecryptionProof ::= SEQUENCE {\n aMsgCommitment OCTET STRING,\n bKeyCommitment OCTET STRING,\n sResponse INTEGER\n}\n\nIVXVECCElGamalDecryptionChallenge ::= SEQUENCE {\n niProofDomain GeneralString,\n publicKey SubjectPublicKeyInfo,\n ciphertextInfo IVXVElGamalCiphertextInfo,\n encodedPlaintext OCTET STRING,\n aMsgCommitment OCTET STRING,\n bKeyCommitment OCTET STRING\n}\n" }, { "path": "Documentation/public/protokollid/ivxv-elgamal-general.asn1", "content": "IVXVElGamalCiphertextInfo ::= SEQUENCE {\n algorithm AlgorithmIdentifier,\n ciphertext ANY DEFINED BY algorithm\n}\n" }, { "path": "Documentation/public/protokollid/ivxv-elgamal-modp.asn1", "content": "id-ivxv-modp-elgamal OBJECT IDENTIFIER ::= { iso(1) identified-organization(3) dod(6) internet(1) private(4) enterprise(1) cryptlib(3029) mechanism(2) 1 }\n\nIVXVModPElGamalParameters ::= SEQUENCE {\n modP INTEGER,\n gen INTEGER,\n electionId GeneralString\n}\n\nIVXVModPElGamalPublicKey ::= SEQUENCE {\n pubY INTEGER\n}\n\nIVXVModPElGamalCiphertext ::= SEQUENCE {\n uBlind INTEGER,\n vBlindedMessage INTEGER\n}\n\nIVXVModPElGamalDecryptionProof ::= SEQUENCE {\n aMsgCommitment INTEGER,\n bKeyCommitment INTEGER,\n sResponse INTEGER\n}\n\nIVXVModPElGamalDecryptionChallenge ::= SEQUENCE {\n niProofDomain GeneralString,\n publicKey SubjectPublicKeyInfo,\n ciphertextInfo IVXVElGamalCiphertextInfo,\n encodedPlaintext INTEGER,\n aMsgCommitment INTEGER,\n bKeyCommitment INTEGER\n}\n" }, { "path": "Documentation/public/protokollid/locales/en/LC_MESSAGES/01-annotatsioon.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2024-02-29 10:34+0200\\n\"\n\"PO-Revision-Date: 2024-02-29 16:35+0200\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: en \\n\"\n\"Language: en\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"Generated-By: Babel 2.10.3\\n\"\n\"X-Generator: Poedit 3.4.2\\n\"\n\n#: ../../01-annotatsioon.rst:6\nmsgid \"Annotatsioon\"\nmsgstr \"Annotation\"\n\n#: ../../01-annotatsioon.rst:8\nmsgid \"\"\n\"Käesolev dokument kirjeldab elektroonilise hääletamise infosüsteemi IVXV \"\n\"protokollistikku.\"\nmsgstr \"\"\n\"This document specifies the protocols of the online voting system IVXV.\"\n\n#: ../../01-annotatsioon.rst:11\nmsgid \"\"\n\"Dokument annab üldise ülevaate elektroonilise hääletamise süsteemi \"\n\"tehnilisest ülesehitusest ja kasutatavatest protokollidest. Dokumendis \"\n\"defineeritakse protokollides kasutatavad ühised mõisted ja andmestruktuurid.\"\nmsgstr \"\"\n\"The document gives a general overview of the technical architecture of the \"\n\"online voting system and the protocols used. It defines common concepts and \"\n\"data structures used in the protocols.\"\n" }, { "path": "Documentation/public/protokollid/locales/en/LC_MESSAGES/02-ylevaade.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-03 08:56+0000\\n\"\n\"PO-Revision-Date: 2024-02-29 17:09+0200\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: en \\n\"\n\"Language: en\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../02-ylevaade.rst:5\nmsgid \"Ülevaade\"\nmsgstr \"Overview\"\n\n#: ../../02-ylevaade.rst:7\nmsgid \"\"\n\"Elektroonilise hääletamise protokollistik (edaspidi protokollistik) \"\n\"defineerib elektroonilise hääletamise süsteemi komponentide vahelise \"\n\"sõnumivahetuse, kasutatavad andmestruktuurid, algoritmid ning liidesed \"\n\"väliste süsteemidega. Sõnumivahetus esitatakse UML suhtlusskeemidena, mis \"\n\"üheselt defineerivad sõnumite järgnevuse. Andmestruktuuride kirjeldused on \"\n\"varustatud BNF, ASN.1 või JSON-schema notatsioonis spetsifikatsioonidega. \"\n\"Algoritmid esitatakse pseudokoodina.\"\nmsgstr \"\"\n\"The online voting protocol suite (hereafter referred to as the protocol \"\n\"suite) defines the messaging between the components of an online voting \"\n\"system, the data structures used, the algorithms, and the interfaces to \"\n\"external systems. The message exchange is represented as UML interaction \"\n\"diagrams that unambiguously define the sequence of messages. Data structure \"\n\"descriptions are provided with specifications in Backus-Naur or JSON schema \"\n\"notation. Algorithms shall be presented in pseudo-code form.\"\n\n#: ../../02-ylevaade.rst:15\nmsgid \"\"\n\"NB! Kõigis protokollistiku andmestruktuuride väljades tuleb rangelt kinni \"\n\"pidada lubatud märkidest ning väljade minimaalsetest ja maksimaalsetest \"\n\"pikkustest. Täiendavate tühikute, tabulaatorite jms. kasutamine on keelatud \"\n\"ning spetsifikatsiooni realiseerivad rakendused peavad vorminguga mitte-\"\n\"vastavate andmete töötlemisest keelduma.\"\nmsgstr \"\"\n\"NOTE: The allowed characters and the minimum and maximum lengths of the \"\n\"fields must be strictly respected in all fields of the protocol data \"\n\"structures. The use of additional spaces, tabs, etc. is prohibited, and \"\n\"applications implementing the specification must refuse to process data that\"\n\" does not conform to the format.\"\n\n#: ../../02-ylevaade.rst:21\nmsgid \"\"\n\"Protokollistik defineerib elektroonilise hääletamise protokolli ning selle \"\n\"protokolli realiseerimiseks vajalikud tugistruktuurid.\"\nmsgstr \"\"\n\"The protocol suite defines the protocol for online voting and the support \"\n\"structures needed to implement this protocol.\"\n\n#: ../../02-ylevaade.rst:25\nmsgid \"Elektroonilise hääletamise protokoll\"\nmsgstr \"Online Voting Protocol\"\n\n#: ../../02-ylevaade.rst:27\nmsgid \"Elektroonilise hääletamise protokoll spetsifitseerib:\"\nmsgstr \"The online voting protocol specifies:\"\n\n#: ../../02-ylevaade.rst:29\nmsgid \"\"\n\"elektroonilise hääle vormingu, mis võimaldab üheselt määratleda valija tahte\"\n\" konkreetsel valimisel;\"\nmsgstr \"\"\n\"the electronic ballot format that allows defining the voter’s intent \"\n\"unambiguously at a specific election;\"\n\n#: ../../02-ylevaade.rst:32\nmsgid \"elektroonilise hääle krüpteerimise hääle salajasuse tagamiseks;\"\nmsgstr \"electronic ballot encryption to ensure ballot secrecy;\"\n\n#: ../../02-ylevaade.rst:34\nmsgid \"\"\n\"elektroonilise hääle digitaalse allkirjastamise tervikluse ja valija \"\n\"identifitseerimise tagamiseks;\"\nmsgstr \"\"\n\"the digital signing of an electronic vote to ensure integrity and voter \"\n\"identification;\"\n\n#: ../../02-ylevaade.rst:37\nmsgid \"\"\n\"elektroonilise hääle kvalifitseerimise kogumisteenuse poolt, hääle \"\n\"vastuvõtmise tähistamiseks;\"\nmsgstr \"\"\n\"electronic vote qualification by the collection service, to mark the \"\n\"acceptance of a vote;\"\n\n#: ../../02-ylevaade.rst:40\nmsgid \"\"\n\"Protokoll eeldab, et valimise korraldaja defineerib valimise ning genereerib\"\n\" häälte salastamise võtmepaari, mille avalik komponent tehakse \"\n\"valijarakendusele kättesaadavaks.\"\nmsgstr \"\"\n\"The protocol assumes that the election organizer has defined the election \"\n\"and generated a key pair for vote encryption, the public component of which \"\n\"has been made available to the voting application.\"\n\n#: ../../02-ylevaade.rst:44\nmsgid \"\"\n\"Protokolli vahendusel liigub valija tahe kogumisteenuses talletatavasse \"\n\"e-valimiskasti ning võetakse tulemuse kujunemisel arvesse järgmist \"\n\"sündmusterida pidi:\"\nmsgstr \"\"\n\"Through the protocol, the voter's intent will be transferred to the digital \"\n\"ballot box stored in the collection service and will be taken into account \"\n\"in the following sequence of events:\"\n\n#: ../../02-ylevaade.rst:47\nmsgid \"\"\n\"Valija kasutab valijarakendust oma tahteavalduse elektrooniliseks \"\n\"vormistamiseks:\"\nmsgstr \"The voter uses the voting application to vote online:\"\n\n#: ../../02-ylevaade.rst:50\nmsgid \"tahteavaldus vormistatakse elektroonilise häälena;\"\nmsgstr \"voter's intent is encoded as an electronic ballot;\"\n\n#: ../../02-ylevaade.rst:52\nmsgid \"vormistatud hääl krüpteeritakse;\"\nmsgstr \"the electronic ballot is encrypted;\"\n\n#: ../../02-ylevaade.rst:54\nmsgid \"krüpteeritud hääl signeeritakse valija arvutis.\"\nmsgstr \"the encrypted ballot is digitally signed.\"\n\n#: ../../02-ylevaade.rst:56\nmsgid \"\"\n\"Kogumisteenus talletab elektroonilise hääle, moodustades selle käigus \"\n\"häälele kvalifitseeritud digitaalallkirja:\"\nmsgstr \"\"\n\"The collection service stores the electronic vote, forming a qualified \"\n\"digital signature for the vote:\"\n\n#: ../../02-ylevaade.rst:59\nmsgid \"elektrooniline hääl registreeritakse välises registreerimisteenuses;\"\nmsgstr \"\"\n\"an electronic vote is registered with an external registration service;\"\n\n#: ../../02-ylevaade.rst:61\nmsgid \"elektroonilisele häälele võetakse digitaalne ajatempel;\"\nmsgstr \"a digital timestamp is applied to the electronic vote;\"\n\n#: ../../02-ylevaade.rst:63\nmsgid \"\"\n\"elektroonilisele häälele võetakse valija sertifikaadi kehtivuskinnitus;\"\nmsgstr \"\"\n\"a digitally signed ballot will be accompanied by elements to confirm the \"\n\"validity of the voter's certificate;\"\n\n#: ../../02-ylevaade.rst:66\nmsgid \"\"\n\"elektroonilist häält kvalifitseerivad elemendid tagastatakse mh. ka \"\n\"valijarakendusele kontrollimiseks ning valija informeerimiseks \"\n\"kvalifitseerimise tulemustest;\"\nmsgstr \"\"\n\"elements qualifying an electronic vote are also returned to the voting \"\n\"application for verification and to inform the voter of the qualification \"\n\"results;\"\n\n#: ../../02-ylevaade.rst:70\nmsgid \"\"\n\"valijale võimaldatakse kvalifitseeritud elektroonilise hääle kontrollimine \"\n\"kontrollrakenduse abil.\"\nmsgstr \"\"\n\"the voter is allowed to verify a qualified electronic vote by means of a \"\n\"verification application.\"\n\n#: ../../02-ylevaade.rst:75\nmsgid \"\"\n\"Elektroonilise hääle digitaalne allkirjastamine erineb tavapärasest \"\n\"dokumentide digitaalallkirjastamisest, kus kõik allkirja kvalifitseerimiseks\"\n\" vajalikud toimingud algatatakse vahetult allkirjastaja seadmes. \"\n\"Elektroonilise hääle kvalifitseerimise kohustus on kogumisteenusel, kelle \"\n\"ülesanne on veenduda vastuvõetavate häälte korrektses allkirjastatuses. Kuna\"\n\" e-hääletamise perioodil on koormus seotud teenustele kõrge, võimaldab \"\n\"kogumisteenuse poolt juhitud kvalifitseerimine tagada paremat teenuse \"\n\"kvaliteeti.\"\nmsgstr \"\"\n\"Digital signing of electronic votes differs from traditional digital signing\"\n\" of documents, where all the operations necessary to qualify a signature are\"\n\" initiated directly on the signer's device. The onus of qualifying an \"\n\"electronic vote lies with the collection service, which is responsible for \"\n\"verifying that the votes received have been correctly signed. As the \"\n\"e-voting period is a period of high workload for the associated services, \"\n\"the qualification process managed by the collection service allows for a \"\n\"better quality of service.\"\n\n#: ../../02-ylevaade.rst:84\nmsgid \"\"\n\"Valija võib kasutada kontrollrakendust veendumaks oma hääle korrektses \"\n\"käitlemises kogumisteenuse poolt;\"\nmsgstr \"\"\n\"The voter can use the verification application to make sure their vote is \"\n\"handled correctly by the collection service;\"\n\n#: ../../02-ylevaade.rst:87\nmsgid \"\"\n\"Hääletamisperioodi lõppedes väljastab kogumisteenus valimise korraldajale \"\n\"e-valimiskasti ning registreerimisteenus väljavõtte kogumisteenuse poolt \"\n\"registreeritud häältest;\"\nmsgstr \"\"\n\"At the end of the voting period, the collection service will issue a digital\"\n\" ballot box to the election organiser and the registration service will \"\n\"issue a list of the votes registered by the collection service;\"\n\n#: ../../02-ylevaade.rst:91\nmsgid \"e-valimiskasti koosseisus antakse valimise korraldajale üle:\"\nmsgstr \"\"\n\"in the composition of the digital ballot-box following data will be handed \"\n\"over to the election organiser:\"\n\n#: ../../02-ylevaade.rst:93\nmsgid \"valija krüpteeritud tahteavaldus koos signatuuriga;\"\nmsgstr \"the voter's encrypted intent with signature;\"\n\n#: ../../02-ylevaade.rst:95\nmsgid \"registreerimisteenuse kinnitus hääle registreerimisest;\"\nmsgstr \"\"\n\"confirmation of the registration of the vote by the registration service;\"\n\n#: ../../02-ylevaade.rst:97\nmsgid \"\"\n\"ajatempliteenuse poolt väljastatud digitaalne ajatempel elektroonilisele \"\n\"häälele;\"\nmsgstr \"\"\n\"a digital timestamp issued by a timestamp service for an electronic vote;\"\n\n#: ../../02-ylevaade.rst:100\nmsgid \"\"\n\"kehtivuskinnitusteenuse poolt väljastatud kinnitus valija sertifikaadi \"\n\"kehtivuse kohta;\"\nmsgstr \"\"\n\"confirmation of the validity of the voter's certificate issued by a \"\n\"validation service;\"\n\n#: ../../02-ylevaade.rst:103\nmsgid \"\"\n\"registreerimisteenuse väljavõtte koosseisus antakse valimise korraldajale \"\n\"üle:\"\nmsgstr \"\"\n\"in the form of a registration extract shall be handed over to the organiser \"\n\"of the election:\"\n\n#: ../../02-ylevaade.rst:105\nmsgid \"\"\n\"kõik e-hääletamise perioodil kogumisteenuse poolt registreerimisteenusele \"\n\"saadetud päringud elektrooniliste häälte registreerimiseks.\"\nmsgstr \"\"\n\"all enquiries sent by the collection service to the registration service \"\n\"during the e-voting period to register electronic votes.\"\n\n#: ../../02-ylevaade.rst:109\nmsgid \"Valimise korraldaja arvutab hääletamistulemuse:\"\nmsgstr \"The election organiser calculates the tally:\"\n\n#: ../../02-ylevaade.rst:111\nmsgid \"kontrollitaks üle antud elektrooniliste häälte allkirjade kehtivust\"\nmsgstr \"verifying the validity of the electronic signatures of votes cast.\"\n\n#: ../../02-ylevaade.rst:113\nmsgid \"\"\n\"kontrollitakse, et kõik registreerimisteenuses registreeritud hääled on \"\n\"e-valimiskasti koosseisus üle antud;\"\nmsgstr \"\"\n\"making sure that all the votes registered in the registration service have \"\n\"been cast in the digital ballot box;\"\n\n#: ../../02-ylevaade.rst:116\nmsgid \"eraldatakse krüpteeritud hääled ja digitaalallkirjad;\"\nmsgstr \"separating encrypted ballots and digital signatures;\"\n\n#: ../../02-ylevaade.rst:118\nmsgid \"anonüümitakse krüpteeritud hääled krüptograafiliselt;\"\nmsgstr \"anonymizing encrypted ballots cryptographically;\"\n\n#: ../../02-ylevaade.rst:120\nmsgid \"dekrüpteeritakse krüpteeritud hääled;\"\nmsgstr \"decrypting encrypted ballots;\"\n\n#: ../../02-ylevaade.rst:122\nmsgid \"dekrüpteeritud häälte põhjal arvutatakse hääletamistulemus.\"\nmsgstr \"calculating the tally based on the decrypted votes.\"\n\n#: ../../02-ylevaade.rst:124\nmsgid \"\"\n\"Protokoll on analoogne paberil posti teel hääletamise protokolliga, kus \"\n\"valija tahe liigub valimiskomisjonini kahes ümbrikus – välimise ümbriku sees\"\n\" on sisemine ümbrik, mis omakorda sisaldab valija tahteavaldusega \"\n\"hääletussedelit. Välimine ümbrik kannab valijat identifitseerivat infot ning\"\n\" võimaldab mh. kontrollida valija õigust hääletada. Sisemine ümbrik on \"\n\"anonüümne ning kaitseb hääle salajasust. Enne häälte kokkulugemist \"\n\"eraldatakse sisemised ümbrikud välimistest.\"\nmsgstr \"\"\n\"The protocol is analogous to a postal voting protocol, where the voter's \"\n\"intent is sent to the electoral commission in two envelopes - the outer \"\n\"envelope contains the inner envelope, which in turn contains the ballot \"\n\"paper with the voter's intent. The outer envelope carries the voter's \"\n\"identifying information and allows, among other things, the voter's right to\"\n\" vote to be verified. The inner envelope is anonymous and protects the \"\n\"secrecy of the vote. The inner envelopes are separated from the outer \"\n\"envelopes before the votes are counted.\"\n\n#: ../../02-ylevaade.rst:132\nmsgid \"\"\n\"Elektroonilise hääletamise kontekstis on sisemine ümbrik vormistatud \"\n\"krüpteeritud häälena ning välimine ümbrik digitaalselt allkirjastatud \"\n\"dokumendina.\"\nmsgstr \"\"\n\"In the context of online voting, the inner envelope is an encrypted ballot \"\n\"and the outer envelope is a digitally signed document.\"\n" }, { "path": "Documentation/public/protokollid/locales/en/LC_MESSAGES/04-seadistus.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2024-02-29 10:34+0200\\n\"\n\"PO-Revision-Date: 2024-02-29 17:21+0200\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: en \\n\"\n\"Language: en\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"Generated-By: Babel 2.10.3\\n\"\n\"X-Generator: Poedit 3.4.2\\n\"\n\n#: ../../04-seadistus.rst:5\nmsgid \"Valimise definitsioon\"\nmsgstr \"Election definition\"\n\n#: ../../04-seadistus.rst:7\nmsgid \"\"\n\"Valimise defineerib valimise korraldaja. Eesti riiklikel valimistel \"\n\"jagunevad kõik hääleõiguslikud isikud ühte või mitmesse valimisringkonda. \"\n\"Valijal on võimalik hääletamisel valida ainult selle ringkonna kandidaatide \"\n\"vahel, kuhu ta kuulub.\"\nmsgstr \"\"\n\"The election is defined by the election organiser. In national elections in \"\n\"Estonia, all eligible voters are divided into one or more constituencies / \"\n\"electoral districts. Voters can only vote for candidates in the constituency\"\n\" to which they belong.\"\n\n#: ../../04-seadistus.rst:12\nmsgid \"Valimise defineerimiseks tuleb määratleda vähemalt\"\nmsgstr \"To define an election, at least the following have to be defined\"\n\n#: ../../04-seadistus.rst:14\nmsgid \"\"\n\"valimise unikaalne identifikaator ning küsimuste unikaalsed \"\n\"identifikaatorid;\"\nmsgstr \"\"\n\"a unique identifier for the election and unique identifiers for the \"\n\"questions;\"\n\n#: ../../04-seadistus.rst:16\nmsgid \"täielik loend valimisringkondadest ja -jaoskondadest;\"\nmsgstr \"a full list of electoral districts and polling stations;\"\n\n#: ../../04-seadistus.rst:18\nmsgid \"hääleõiguslike isikute nimekiri ja jagunemine valimisringkondadesse;\"\nmsgstr \"\"\n\"the list of persons entitled to vote and the division into electoral \"\n\"districts;\"\n\n#: ../../04-seadistus.rst:20\nmsgid \"kandidaatide nimekiri ja jagunemine valimisringkondadesse.\"\nmsgstr \"the list of candidates and the division into electoral districts.\"\n\n#: ../../04-seadistus.rst:22\nmsgid \"\"\n\"Valimise sisendandmed koostatakse Valimise Infosüsteemis (VIS), \"\n\"vormingukirjeldused on spetsifitseeritud `VIS ja EHS ühisspetsifikatsioonis \"\n\"`_.\"\nmsgstr \"\"\n\"Election input data is compiled in the Election Information System (VIS), \"\n\"the format specifications are specified in the 'Common Specification for VIS\"\n\" and EHS `_.\"\n" }, { "path": "Documentation/public/protokollid/locales/en/LC_MESSAGES/05-ehaal.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.8.2\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-03 19:52+0000\\n\"\n\"PO-Revision-Date: 2024-02-29 19:50+0200\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: en \\n\"\n\"Language: en\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../05-ehaal.rst:5\nmsgid \"Elektrooniline hääl\"\nmsgstr \"Electronic vote\"\n\n#: ../../05-ehaal.rst:7\nmsgid \"\"\n\"IVXV hääletamisprotokoll põhineb topeltümbrikuskeemil, mis tähendab, et \"\n\"valija avakujul tahteavaldus krüpteeritakse valimise korraldaja poolt \"\n\"levitatud avaliku võtmega. Krüpteeritud tahteavaldus allkirjastatakse \"\n\"digitaalselt valija käsutuses oleva allkirjastamisvahendiga ning edastatakse\"\n\" kogumisteenusesse mingis kokkulepitud konteinervormingus. Kogumisteenus \"\n\"võib valija poolt allkirjastatud häält täiendavalt kvalifitseerida, \"\n\"veendudes näiteks allkirjastamissertifikaadi kehtivuses. IVXV protokollistik\"\n\" näeb mh. ette kogumisteenuse poolt vastuvõetud häälte registreerimise \"\n\"välises registreerimisteenuses.\"\nmsgstr \"\"\n\"The IVXV voting protocol is based on a double envelope scheme, which means \"\n\"that the voter's plaintext intent is encrypted with a public key distributed\"\n\" by the election organiser. The encrypted ballot is digitally signed using a\"\n\" signature device at the voter's disposal and is delivered to the collection\"\n\" service in an agreed container format. The collection service may further \"\n\"qualify the vote signed by the voter, for example by verifying the validity \"\n\"of the signature certificate. The IVXV protocol suite foresees, inter alia, \"\n\"the registration of votes received by the collection service in an external \"\n\"registration service.\"\n\n#: ../../05-ehaal.rst:17\nmsgid \"\"\n\"Kogumisteenuse poolt talletamisele võetud hääl koos kvalifitseerivate \"\n\"elementidega tehakse kättesaadavaks nii valijarakendusele kui \"\n\"kontrollrakendusele, mis teostavad üksiku hääle peal samad kontrollid, mida \"\n\"hilisem valimise korraldaja töötlemisrakendus teostab kõigi häälte peal. \"\n\"Kvalifitseerivate elementide kontrollimise võimalus annab valijale kindluse,\"\n\" et tema häält on hilisemates protsessides korrektselt menetletud.\"\nmsgstr \"\"\n\"The vote accepted to be stored by the collection service, together with the \"\n\"qualifying elements, is made available to both the voting application and \"\n\"the verification application, which perform the same checks on the \"\n\"individual vote as the subsequent election organiser's processing \"\n\"application performs on all votes. The ability to check the qualifying \"\n\"elements gives the voter confidence that their vote has been correctly \"\n\"processed in subsequent processes.\"\n\n#: ../../05-ehaal.rst:26\nmsgid \"Valija tahteavaldus avakujul\"\nmsgstr \"Voter's Plaintext Intent\"\n\n#: ../../05-ehaal.rst:28\nmsgid \"\"\n\"Valija tahteavaldus avakujul eksisteerib valijarakenduses ning hiljem ka \"\n\"kontrollrakenduses ja häälte kokkulugemisel võtmerakenduses. Tahteavaldus \"\n\"sisaldab valiku koodi ringkonnas ja ringkonna EHAK-koodi. Eraldajana \"\n\"kasutatakse ASCII kooditabeli sümbolit `0x2E` ehk \\\".\\\". Vormingus \"\n\"spetsifitseerimata sümbolite kasutamine ei ole lubatud, vormingule \"\n\"mittevastavad sedelid loetakse kehtetuks.\"\nmsgstr \"\"\n\"The voter's plaintext intent exists in the voting application and later in \"\n\"the verification application and in the key application when the votes are \"\n\"tallied. The declaration of intent includes the precinct code and the EHAK \"\n\"code of the precinct. The separator shall be the ASCII code table symbol \"\n\"`0x2E` or \\\".\\\". The use of symbols not specified in the format is not \"\n\"allowed, and non-compliant tags will be invalidated.\"\n\n#: ../../05-ehaal.rst:49\nmsgid \"Järgmised tahteavaldused on vormistatud korrektselt:\"\nmsgstr \"The following declarations of intent have been correctly drafted:\"\n\n#: ../../05-ehaal.rst:57\nmsgid \"Järgmised tahteavaldused ei ole vormistatud korrektselt:\"\nmsgstr \"The following declarations of intent have not been properly drawn up:\"\n\n#: ../../05-ehaal.rst:68\nmsgid \"Krüpteeritud sedel\"\nmsgstr \"Encrypted ballot\"\n\n#: ../../05-ehaal.rst:70\nmsgid \"\"\n\"Valija tahteavaldus avakujul :token:`ballot` krüpteeritakse valijarakenduse \"\n\"poolt valimise korraldaja genereeritud avaliku võtmega. IVXV vajab \"\n\"krüpteerimiseks mitte-deterministlikku, homomorfset avaliku võtme \"\n\"krüptosüsteemi. Selliseks süsteemiks sobib ElGamal krüptosüsteem, mida täna \"\n\"rakendatakse IVXV kontekstis nii jäägiklassiringi `Zp` multiplikatiivsel \"\n\"rühmal `Zp*` (MODP tüüpi rühmad) kui ka elliptkõveratel (ECC tüüpi rühmad).\"\nmsgstr \"\"\n\"The voter's plaintext intent :token:`ballot` is encrypted by a public key \"\n\"generated by the election organizer by the voting application. IVXV requires\"\n\" a non-deterministic, homomorphic public key cryptosystem for encryption. \"\n\"Such a system is the ElGamal cryptosystem, which is today implemented in the\"\n\" context of IVXV both on the multiplicative group `Zp*` of the residue class\"\n\" ring `Zp` (MODP type groups) and on the elliptic curves (ECC type groups).\"\n\n#: ../../05-ehaal.rst:77\nmsgid \"\"\n\"ElGamal avalik võti kodeeritakse koos ElGamal krüptosüsteemi parameetritega \"\n\"ning konkreetset valimist iseloomustava identifikaatoriga. Krüptosüsteemi \"\n\"parameetrid on osaks algoritmi identifikaatori struktuurist, avalik võti on \"\n\"kodeeritud X509 standardis kirjeldatud :token:`SubjectPublicKeyInfo` \"\n\"struktuuri :token:`subjectPublicKey` välja.\"\nmsgstr \"\"\n\"The ElGamal public key is encoded with the ElGamal cryptosystem parameters \"\n\"and an identifier for the specific election. The cryptosystem parameters are\"\n\" part of the structure of the algorithm identifier, the public key is \"\n\"encoded in the :token:`SubjectPublicKeyInfo` structure of the \"\n\":token:`subjectPublicKey` described in the X509 standard.\"\n\n#: ../../05-ehaal.rst:90\nmsgid \"\"\n\"MODP tüüpi rühmade korral identifitseerib algoritmi identifikaator \"\n\":token:`id-ivxv-modp-elgamal`. Parameetrid vastavad struktuurile \"\n\":token:`IVXVModPElGamalParameters` ning avalik võti struktuurile \"\n\":token:`IVXVModPElGamalPublicKey` (:ref:`asn-modp`).\"\nmsgstr \"\"\n\"In the case of MODP type groups, the identifier :token:`id-ivxv-modp-\"\n\"elgamal` identifies the algorithm. The parameters correspond to the \"\n\"structure :token:`IVXVModPElGamalParameters` and the public key to the \"\n\"structure :token:`IVXVModPElGamalPublicKey` (:ref:`asn-modp`).\"\n\n#: ../../05-ehaal.rst:95\nmsgid \"\"\n\"ECC tüüpi rühmade korral identifitseerib algoritmi identifikaator \"\n\":token:`id-ivxv-ecc-elgamal`. Parameetrid vastavad struktuurile \"\n\":token:`IVXVECCElGamalParameters` ning avalik võti struktuurile \"\n\":token:`IVXVECCElGamalPublicKey` (:ref:`asn-ecc`).\"\nmsgstr \"\"\n\"In the case of ECC-type groups, the identifier :token:`id-ivxv-ecc-elgamal` \"\n\"identifies the algorithm. The parameters correspond to the structure \"\n\":token:`IVXVECCElGamalParameters` and the public key to the structure \"\n\":token:`IVXVECCElGamalPublicKey` (:ref:`asn-ecc`).\"\n\n#: ../../05-ehaal.rst:100\nmsgid \"\"\n\"Valija tahteavalduse krüpteerimiseks võetakse UTF-8 kodeeringus struktuur \"\n\":token:`ballot` ning teisendatakse see ElGamal parameetrite poolt \"\n\"kirjeldatud rühma elemendiks vastavalt MODP või ECC algoritmidele. Rühma \"\n\"elemendiks teisendatud tahteavaldus krüpteeritakse ElGamal algoritmiga ning \"\n\"kodeeritakse MODP korral struktuuri :token:`IVXVModPElGamalCiphertext` \"\n\"(:ref:`asn-modp`) ja ECC korral struktuuri :token:`IVXVECCElGamalCiphertext`\"\n\" (:ref:`asn-ecc`). Lõplik krüpteeritud tahteavaldus esitatakse struktuuris \"\n\":token:`IVXVElGamalCiphertext` (:ref:`asn-general`), kus väli \"\n\":token:`algorithm` viitab rühma tüübile ning väli :token:`ciphertext` \"\n\"rühmaspetsiifilisele krüptogrammile. Andmestruktuuri \"\n\":token:`IVXVElGamalCiphertext` DER-kodeering on krüpteeritud sedel ehk \"\n\"sisemine ümbrik topeltümbriku skeemis.\"\nmsgstr \"\"\n\"To encrypt a voter's intent statement, the UTF-8 encoding takes the \"\n\"structure :token:`ballot` and converts it to a group element described by \"\n\"the ElGamal parameters, according to the MODP or ECC algorithms. The intent \"\n\"statement converted to a group element is encrypted by the ElGamal algorithm\"\n\" and encoded in the structure :token:`IVXVModPElGamalCiphertext` (:ref:`asn-\"\n\"modp`) for MODP and :token:`IVXVECCElGamalCiphertext` (:ref:`asn-ecc`) for \"\n\"ECC. The final encrypted intent statement is represented in the structure \"\n\":token:`IVXVElGamalCiphertext` (:ref:`asn-general`), where \"\n\":token:`algorithm` refers to the group type and :token:`ciphertext` refers \"\n\"to the group specific ciphertext. The :token:`IVXVElGamalCiphertext` of the \"\n\"data structure is the DER encoding of the encrypted tuple, i.e. the inner \"\n\"envelope in a double envelope scheme.\"\n\n#: ../../05-ehaal.rst:116\nmsgid \"\"\n\"Tahteavalduse krüpteerimise käigus genereeritakse valijarakenduses juhuarv, \"\n\"mida ElGamal krüpteerimisel kasutab. Sama juhuarv avalikustatakse hiljem \"\n\"kontrollrakendusele. Tulenevalt ElGamal krüptosüsteemi eripärast \"\n\"funktsioneerib see juhuarv nö. teise võtmena ning võimaldab krüptogrammi \"\n\"dekodeerimist kontrollrakenduses.\"\nmsgstr \"\"\n\"During the encryption process, a random number is generated in the voting \"\n\"application. This random number is used for encryption by the ElGamal \"\n\"method. The same random number is later exposed to the verification \"\n\"application. Due to the specificity of the ElGamal cryptosystem, this random\"\n\" number functions as a second key and allows the decryption of the \"\n\"ciphertext in the verification application.\"\n\n#: ../../05-ehaal.rst:125\nmsgid \"Valija poolt allkirjastatud hääl\"\nmsgstr \"Vote signed by the voter\"\n\n#: ../../05-ehaal.rst:127\nmsgid \"\"\n\"Krüpteeritud sedel tuleb enne kogumisteenusesse talletamisele saatmist \"\n\"digitaalselt allkirjastada, milleks on võimalik kasutada kõiki Eesti \"\n\"Vabariigis kehtivaid digitaalallkirjavahendeid – ID-kaart, Digi-ID, Mobiil-\"\n\"ID, Smart-ID. ID-kaarti saab kasutada nii TLS-CCA kui Web-eID protokolliga.\"\nmsgstr \"\"\n\"The encrypted ballot has to be digitally signed before it is sent to the \"\n\"collection service for storage, which can be done using any digital \"\n\"signature device valid in the Republic of Estonia - ID-card, Digi-ID, \"\n\"Mobile-ID, Smart-ID.\"\n\n#: ../../05-ehaal.rst:134\nmsgid \"\"\n\"Loend digitaalallkirjavahenditest ja nendega seotud protokollidest on \"\n\"tehniliselt korrektne, kuid valimiste korraldajal on võimalus kasutada vaid \"\n\"mõnda alamhulka nimetatud vahenditest.\"\nmsgstr \"\"\n\"The list of digital signature devices and associated protocols is \"\n\"technically correct, but only a subset of these devices can be used by the \"\n\"election organiser.\"\n\n#: ../../05-ehaal.rst:138\nmsgid \"\"\n\"Käesolev spetsifikatsioon näeb ette Eesti Vabariigi Standardikavandis \"\n\"[BDOC2.1] defineeritud BDOC allkirjavormingu kasutamise. BDOC \"\n\"allkirjavorming koosneb ETSI standardi TS 101 903 (XadES) profiilist ning \"\n\"OpenDocument konteineri vormingust.\"\nmsgstr \"\"\n\"This specification prescribes the use of the BDOC signature format defined \"\n\"in the draft Estonian Standard [BDOC2.1]. The BDOC signature format consists\"\n\" of the ETSI TS 101 903 (XadES) profile and the OpenDocument container \"\n\"format.\"\n\n#: ../../05-ehaal.rst:142\nmsgid \"\"\n\"Olenevalt käimasoleval valimisel esitatud küsimuste arvust võib digitaalselt\"\n\" allkirjastatud hääl sisaldada ühte või mitut andmefaili MIME-tüübiga \"\n\"``application/octet-stream``. Iga andmefaili sisuks on krüpteeritud sedel. \"\n\"Andmefaili ja teiste signeeritavate andmeobjektide räsimiseks enne \"\n\"allkirjastamist kasutatakse räsifunktsiooni SHA-256. Andmefaili nimi \"\n\"moodustatakse laiendist '``ballot``' ning valimise identifikaatorist ja \"\n\"küsimuse identifikaatorist. Kõik viidatud andmefailid peavad sisalduma \"\n\"allkirjakonteineris. Digitaalselt allkirjastatud hääl ei tohi sisaldada muid\"\n\" andmefaile kui neid, mis sisaldavad hääli mõne käimasoleva valimise \"\n\"kontekstis. Seadistusele mittevastavate häälte vastuvõtmisest, talletamisest\"\n\" ja töötlemisest peab kogumisteenus keelduma.\"\nmsgstr \"\"\n\"Depending on the number of questions in the current ballot, the digitally \"\n\"signed ballot may contain one or more data files with the MIME type \"\n\"``application/octet-stream''. The content of each data file is an encrypted \"\n\"message. The SHA-256 hash function is used to hash the data file and other \"\n\"data objects to be signed before signing. The name of the data file is \"\n\"formed by the extension ``ballot`` and the election identifier and the \"\n\"question identifier. All referenced data files must be contained in the \"\n\"signature container. A digitally signed ballot must not contain any data \"\n\"files other than those containing votes in the context of an ongoing \"\n\"election. The collection service must refuse to accept, store and process \"\n\"votes that do not conform to the configuration.\"\n\n#: ../../05-ehaal.rst:156\nmsgid \"\"\n\"Valimise identifikaator ja küsimuse identifikaator on defineeritud valimise \"\n\"korraldaja poolt loodud seadistustes ning töötlevad rakendused peavad \"\n\"lähtuma neist seadistustest otsustamaks, millised vormingule vastavad \"\n\"identifikaatorid on konkreetse sündmuse kontekstis lubatud ja millised \"\n\"mitte.\"\nmsgstr \"\"\n\"The choice identifier and the question identifier are defined in the \"\n\"settings created by the choice organiser, and processing applications must \"\n\"refer to these settings to decide which format identifiers are allowed and \"\n\"which are not in the context of a particular event.\"\n\n#: ../../05-ehaal.rst:178\nmsgid \"\"\n\"Valija poolt valijarakenduses allkirjastatud hääl moodustatakse nii, et on \"\n\"võimalik selle edasine kvalifitseerimine kogumisteenuses. Käesolev \"\n\"spetsifikatsioon näeb ette hääle kvalifitseerimiseks nii PKIX ajatempli kui \"\n\"OCSP kehtivuskinnituse võtmise. Sellisena on lõplik kvalifitseeritud hääl \"\n\"vastav BDOC-TS profiilile.\"\nmsgstr \"\"\n\"The vote signed by the voter in the voter application is formed in such a \"\n\"way that it can be further qualified in the collection service. This \"\n\"specification provides for both a PKIX timestamp and an OCSP validity \"\n\"confirmation to be taken to qualify a vote. As such, the final qualified \"\n\"vote will conform to the BDOC-TS profile.\"\n\n#: ../../05-ehaal.rst:184\nmsgid \"\"\n\"Kui hääl allkirjastatakse ID-kaardi või Digi-ID'ga, siis toimub algse \"\n\"allkirjastatud konteineri moodustamine valijarakenduses. Kui hääl \"\n\"allkirjastatakse Mobiil-ID või Smart-ID'ga, siis toimub konteineri \"\n\"moodustamine valijarakenduse ning kogumisteenuse poolt vahendatava Mobiil-\"\n\"ID/Smart-ID teenuse koostöös. Mobiil-ID/Smart-ID juhtumil kasutab \"\n\"kogumisteenus Mobiil-ID/Smart-ID teenust ainult signatuuri saamiseks \"\n\"krüpteeritud sedelile. Kõik hääle kvalifitseerimiseks vajalikud elemendid \"\n\"hangitakse vastavatelt teenustelt alles siis kui valijarakendus on saatnud \"\n\"signeeritud hääle talletamiseks. Kvalifitseeritud hääl esitatakse \"\n\"kogumisteenuse poolt valijarakendusele verifitseerimiseks, ainult \"\n\"kvalifitseeritud hääl peab vastama BDOC 2.1 standardi tingimustele -- \"\n\"valijarakenduse poolt moodustatud hääl on vaheetapp kvalifitseeritud hääleni\"\n\" jõudmiseks.\"\nmsgstr \"\"\n\"If the vote is signed with an ID-card or Digi-ID, the initial signed \"\n\"container will be formed in the voting application. If the vote is signed \"\n\"with a Mobile-ID or Smart-ID, the containerisation is done in cooperation \"\n\"between the voting application and the Mobile-ID/Smart-ID service mediated \"\n\"by the collection service. In the case of a Mobile-ID/Smart-ID, the \"\n\"collection service will only use the Mobile-ID/Smart-ID service to obtain a \"\n\"signature on an encrypted ballot. All the elements necessary to qualify the \"\n\"vote are only retrieved from the respective services once the voting \"\n\"application has sent the signed vote for storage. The qualified vote is \"\n\"submitted by the collection service to the voting application for \"\n\"verification, only the qualified vote must meet the requirements of the BDOC\"\n\" 2.1 standard -- the vote formed by the voting application is an \"\n\"intermediate step to a qualified vote.\"\n\n#: ../../05-ehaal.rst:197\nmsgid \"\"\n\"Valijarakenduses signeeritud häälel peab olema üks ja ainult üks allkiri, \"\n\"mida hoitakse signatuurifailis :file:`META-INF/signature0.xml`. Häält ja \"\n\"allkirja sisaldav konteiner (edaspidi viidatud kui ``SignedVote``) \"\n\"moodustatakse BDOC 2.1 standardis kirjeldatud meetodit kasutades.\"\nmsgstr \"\"\n\"A vote signed in the voting application must have one and only one \"\n\"signature, which is stored in the signature file :file:`META-\"\n\"INF/signature0.xml`. The container containing the vote and the signature \"\n\"(hereafter referred to as ``SignedVote``) shall be created using the method \"\n\"described in BDOC 2.1.\"\n\n#: ../../05-ehaal.rst:202\nmsgid \"\"\n\"Spetsifitseerime valijarakenduses allkirjastatud hääle vormingu ühe küsimuse\"\n\" korral.\"\nmsgstr \"\"\n\"We specify the format of a signed vote in the voting application for a \"\n\"single question.\"\n\n#: ../../05-ehaal.rst:205\nmsgid \"\"\n\"Räsialgoritmina ``DIGEST_ALG`` on kasutusel SHA-256 \"\n\"(http://www.w3.org/2001/04/xmlenc#sha256). XML kanoniseerimiseks \"\n\"(``CANON_ALG``) kasutatakse meetodit ``c14n11`` \"\n\"(http://www.w3.org/2006/12/xml-c14n11).\"\nmsgstr \"\"\n\"The ``DIGEST_ALG`` algorithm used is SHA-256 \"\n\"(http://www.w3.org/2001/04/xmlenc#sha256). XML canonicalisation \"\n\"(``CANON_ALG``) is performed using the ``c14n11`` method \"\n\"(http://www.w3.org/2006/12/xml-c14n11).\"\n\n#: ../../05-ehaal.rst:210\nmsgid \"\"\n\"ECC võtmete korral on allkirjastamismeetodiks \"\n\"http://www.w3.org/2001/04/xmldsig-more#ecdsa-sha256. RSA võtmeid enam ei \"\n\"kasutata.\"\nmsgstr \"\"\n\"In case of ECC keys, the signature method is \"\n\"http://www.w3.org/2001/04/xmldsig-more#ecdsa-sha256. RSA keys are no longer \"\n\"used.\"\n\n#: ../../05-ehaal.rst:214\nmsgid \"\"\n\"Identifikaatorite `VOTE_REF`, `SP_REF`, `SP_URI` ning `SV_URI` täpne väärtus\"\n\" ei ole fikseeritud.\"\nmsgstr \"\"\n\"The exact value of the identifiers `VOTE_REF`, `SP_REF`, `SP_URI` and \"\n\"`SV_URI` is not fixed.\"\n\n#: ../../05-ehaal.rst:218\nmsgid \"Element `SignedProperties`\"\nmsgstr \"Element `SignedProperties`\"\n\n#: ../../05-ehaal.rst:220\nmsgid \"\"\n\"Element ``SignedProperties`` moodustatakse kooskõlas BDOC 2.1 standardiga. \"\n\"Kui kvalifitseerimisel kasutatakse ajatemplit, siis elementi \"\n\"``SignaturePolicyIdentifier`` ei kasutata. Ühtegi mitte-kohustuslikku \"\n\"elementi ei kasutata. Allkirjastamise kellaaja fikseerib andmestruktuuri \"\n\"täitev arvuti ning valija X509-sertifikaat saadakse kas ID-kaardilt, Mobiil-\"\n\"ID, Smart-ID või Web eID teenuse vahendusel.\"\nmsgstr \"\"\n\"The ``SignedProperties`` element is formed in accordance with the BDOC 2.1 \"\n\"standard. If a timestamp is used for qualification, the \"\n\"``SignaturePolicyIdentifier`` element shall not be used. No non-mandatory \"\n\"element shall be used. The time of signature is fixed by the computer \"\n\"executing the data structure and the X509 certificate of the voter is \"\n\"obtained either from the ID card, Mobile-ID, Smart-ID or Web eID service.\"\n\n#: ../../05-ehaal.rst:234\nmsgid \"Element `SignedInfo`\"\nmsgstr \"Element `SignedInfo`\"\n\n#: ../../05-ehaal.rst:236\nmsgid \"\"\n\"Element ``SignedInfo`` moodustatakse kooskõlas BDOC 2.1 standardiga, \"\n\"viidates nii krüpteeritud sedelile (``VOTE_DIGEST``) kui elemendile \"\n\"``SignedProperties`` (``SP_DIGEST``).\"\nmsgstr \"\"\n\"The ``SignedInfo`` element is formed in accordance with the BDOC 2.1 \"\n\"standard, referring to both the encrypted ballot (``VOTE_DIGEST``) and the \"\n\"``SignedProperties`` element (``SP_DIGEST``).\"\n\n#: ../../05-ehaal.rst:246\nmsgid \"Element `SignatureValue`\"\nmsgstr \"Element 'SignatureValue\"\n\n#: ../../05-ehaal.rst:248\nmsgid \"\"\n\"Element ``SignatureValue`` moodustatakse kooskõlas BDOC 2.1 standardiga. \"\n\"Kanoniseeritud elemendist ``SignedInfo`` arvutatakse räsi, mis \"\n\"allkirjastatakse PKCS1-meetodiga.\"\nmsgstr \"\"\n\"The ``SignatureValue`` element shall be formed in accordance with the BDOC \"\n\"2.1 standard. A hash of the canonicalised element ``SignedInfo`` shall be \"\n\"computed and signed using the PKCS1 method.\"\n\n#: ../../05-ehaal.rst:258\nmsgid \"Element `XAdESSignatures`\"\nmsgstr \"Element `XAdESSignatures`\"\n\n#: ../../05-ehaal.rst:260\nmsgid \"\"\n\"Element ``XAdESSignatures`` sisaldab ühte ``Signature`` elementi, mis on \"\n\"koostatud lähtudes kõigist eelmistest elementidest ning valija X509 \"\n\"sertifikaadist. Elementi ``UnsignedProperties`` ei kasutata.\"\nmsgstr \"\"\n\"The ``XAdESSignatures`` element contains a single ``Signature`` element \"\n\"which is constructed from all the previous elements and the X509 certificate\"\n\" of the voter. The ``UnsignedProperties`` element is not used.\"\n" }, { "path": "Documentation/public/protokollid/locales/en/LC_MESSAGES/06-talletamine.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2024, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.8.2\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2024-02-29 10:34+0200\\n\"\n\"PO-Revision-Date: 2024-03-01 12:50+0200\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: en \\n\"\n\"Language: en\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"Generated-By: Babel 2.10.3\\n\"\n\"X-Generator: Poedit 3.4.2\\n\"\n\n#: ../../06-talletamine.rst:5\nmsgid \"Elektroonilise hääle kvalifitseerimine talletamiseks\"\nmsgstr \"Qualifying an electronic vote for storage\"\n\n#: ../../06-talletamine.rst:8\nmsgid \"Kvalifitseeritud hääl\"\nmsgstr \"Qualified vote\"\n\n#: ../../06-talletamine.rst:10\nmsgid \"\"\n\"Valijarakenduse töö tulemusena saadetakse kogumisteenusesse talletamiseks \"\n\"topeltümbrik, mis sisaldab endas valija tahteavaldust krüpteeritud kujul, \"\n\"valija allkirja krüpteeritud tahteavaldusel kooskõlastatud allkirja- ja \"\n\"konteinervormingus ning valija allkirjastamissertifikaati X509-vormingus.\"\nmsgstr \"\"\n\"As a result of the work of the voting application, a double envelope \"\n\"containing the voter's intent in encrypted form, the voter's signature on \"\n\"the encrypted ballot, and the voter's signature certificate in X509 format \"\n\"is sent to the collection service for storage.\"\n\n#: ../../06-talletamine.rst:15\nmsgid \"\"\n\"Hääle edukaks talletamiseks näeb IVXV protokoll ette hääle registreerimise \"\n\"välise registreerimisteenuse osutaja juures ning registreerimistõendi \"\n\"valijarakendusele kättesaadavaks tegemise. Valimise korraldaja võib hääle \"\n\"kvalifitseerimiseks näha ette täiendavaid samme lisaks registreerimisele -- \"\n\"näiteks kehtivuskinnituse hankimist hääle allkirjastanud sertifikaadi kohta.\"\nmsgstr \"\"\n\"In order to ensure the successful storage of votes, IVXV protocol provides \"\n\"for the registration of votes with an external registration service provider\"\n\" and the availability of the registration confirmation in the voting \"\n\"application. In order to qualify a vote, the election organiser may provide \"\n\"for additional steps beyond registration -- for example, obtaining a \"\n\"validation certificate for the certificate that signed the vote.\"\n\n#: ../../06-talletamine.rst:21\nmsgid \"\"\n\"Kõik kogumisteenuse poolt hangitavad kvalifitseerivad elemendid, mis \"\n\"määravad hääle staatuse hilisemates töötlusetappides, tuleb esitada \"\n\"valijarakendusele ning nõudmise korral ka kontrollrakendusele tagamaks, et \"\n\"valija saab oma hääle korrektse menetlemise võimalikkusest õigeaegselt \"\n\"teada.\"\nmsgstr \"\"\n\"All qualifying elements obtained by the collection service that determine \"\n\"the status of the vote at subsequent stages of processing must be provided \"\n\"to the voting application and, on request, to the verification application \"\n\"to ensure that the voter is informed in a timely manner of the possibility \"\n\"of their vote being processed correctly.\"\n\n#: ../../06-talletamine.rst:27\nmsgid \"OCSP kehtivuskinnitus\"\nmsgstr \"OCSP validity confirmation\"\n\n#: ../../06-talletamine.rst:29\nmsgid \"\"\n\"OCSP (*Online Certificate Status Protocol*) on standartne protokoll \"\n\"X509-sertifikaatide kehtivusinfo pärimiseks. Kogumisteenus võib seda \"\n\"protokolli kasutada hääle allkirjastanud sertifikaadi kehtivuse \"\n\"teadasaamiseks. OCSP vastus ütleb, et sertifikaat kehtis päringu tegemise \"\n\"ajahetkel, kuid ei seosta OCSP vastust konkreetse allkirjaga.\"\nmsgstr \"\"\n\"OCSP (*Online Certificate Status Protocol*) is a standard protocol for \"\n\"requesting validity information for X509 certificates. The collection \"\n\"service can use this protocol to know the validity of the certificate that \"\n\"signed the vote. The OCSP response indicates that the certificate was valid \"\n\"at the time of the request, but does not link the OCSP response to a \"\n\"specific signature.\"\n\n#: ../../06-talletamine.rst:36\nmsgid \"RFC3161 ajatempel\"\nmsgstr \"RFC3161 timestamp\"\n\n#: ../../06-talletamine.rst:38\nmsgid \"\"\n\"RFC3161 ajatempli protokolliga saadakse usaldusteenuse pakkujalt kinnitus, \"\n\"et mingi andmekogum eksisteeris enne teatud ajahetke. BDOC-TS kontekstis \"\n\"ajatembeldatakse allkirja element ``SignatureValue`` kanoniseeritud kujul. \"\n\"Klassikaline OCSP vastus koos RFC 3161 vormingus ajatempliga \"\n\"kvalifitseerivad BDOC-TS allkirja.\"\nmsgstr \"\"\n\"The RFC3161 timestamp protocol is used to obtain confirmation from a trust \"\n\"service provider that a dataset existed before a certain point in time. In \"\n\"the context of BDOC-TS, the signature element ``SignatureValue`` is \"\n\"timestamped in canonicalized form. A classical OCSP response with a \"\n\"timestamp in RFC 3161 format qualifies a BDOC-TS signature.\"\n\n#: ../../06-talletamine.rst:47\nmsgid \"Talletamine\"\nmsgstr \"Storage\"\n\n#: ../../06-talletamine.rst:49\nmsgid \"Elektroonilise hääle talletamine kogumisteenuses tähendab:\"\nmsgstr \"Storing an electronic ballot in a collection service means:\"\n\n#: ../../06-talletamine.rst:51\nmsgid \"\"\n\"hääle vastuvõtmist valijarakenduselt ning hääletaja allkirja \"\n\"verifitseerimist;\"\nmsgstr \"\"\n\"acceptance of the vote from the voting application and verification of the \"\n\"voter's signature;\"\n\n#: ../../06-talletamine.rst:54\nmsgid \"\"\n\"hääle võimalikku kvalifitseerimist -- näiteks sertifikaadi kehtivuse \"\n\"tõendamist hääle allkirjastamisele lähedasel ajahetkel;\"\nmsgstr \"\"\n\"possible qualification of the vote -- for example, proof of the validity of \"\n\"the certificate at a point in time close to the time the vote was signed;\"\n\n#: ../../06-talletamine.rst:57\nmsgid \"hääle registreerimist sõltumatus registreerimisteenuses;\"\nmsgstr \"registering the vote with an independent registration service;\"\n\n#: ../../06-talletamine.rst:59\nmsgid \"häält kvalifitseerivate elementide vahendamist valijarakendusele.\"\nmsgstr \"\"\n\"the transmission of vote qualifying elements to the voting application.\"\n\n#: ../../06-talletamine.rst:61\nmsgid \"\"\n\"Erinevad kombinatsioonid allkirjavormingust ning hääli kvalifitseerivatest \"\n\"teenustest võivad tekitada erinevaid IVXV-profiile. Konkreetse dokumendi \"\n\"raames on IVXV profiil:\"\nmsgstr \"\"\n\"Different combinations of signature format and vote qualifying services can \"\n\"produce different IVXV profiles. In the context of a specific document, an \"\n\"IVXV profile is:\"\n\n#: ../../06-talletamine.rst:65\nmsgid \"Allkirjastatud hääle vorming on BDOC-TS;\"\nmsgstr \"The signed vote format is BDOC-TS;\"\n\n#: ../../06-talletamine.rst:67\nmsgid \"Kehtivuskinnitusprotokolliks on standartne OCSP;\"\nmsgstr \"The validation protocol is the standard OCSP;\"\n\n#: ../../06-talletamine.rst:69\nmsgid \"\"\n\"BDOC-TS kvalifitseerimiseks kasutatav RFC3161 ajatempel on kasutusel ka \"\n\"registreerimistõendina.\"\nmsgstr \"\"\n\"The RFC3161 timestamp used for BDOC-TS qualification is also used as a \"\n\"confirmation of registration.\"\n" }, { "path": "Documentation/public/protokollid/locales/en/LC_MESSAGES/06a-regteenus.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2024, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.8.2\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-03 19:52+0000\\n\"\n\"PO-Revision-Date: 2024-03-01 12:42+0200\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: en \\n\"\n\"Language: en\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../06a-regteenus.rst:5\nmsgid \"Elektroonilise hääle registreerimine\"\nmsgstr \"Registration of Electronic Vote\"\n\n#: ../../06a-regteenus.rst:7\nmsgid \"\"\n\"Hääle edukaks talletamiseks näeb IVXV protokoll ette hääle registreerimise \"\n\"välise registreerimisteenuse osutaja juures ning registreerimistõendi \"\n\"valijarakendusele kättesaadavaks tegemise. Registreerimisteenus toimub \"\n\"RFC3161 ajatempli protokolli baasil. Protokolli on laiendatud selliselt, et \"\n\"kogumisteenus saab ajatempli päringule anda oma signatuuri, mis teeb \"\n\"võimalikuks hilisema võrdleva väljavõtte registreerimisteenusest. Sõltumatu \"\n\"registreerimisteenuse olemasolu vähendab häälte kogumisteenuse poolt \"\n\"\\\"kaotamise\\\" riski.\"\nmsgstr \"\"\n\"In order to ensure the successful storage of votes, IVXV protocol provides \"\n\"for the registration of votes with an external registration service provider\"\n\" and the availability of the registration confirmation in the voting \"\n\"application. The registration service is based on the RFC3161 timestamping \"\n\"protocol. The protocol has been extended in such a way that the collection \"\n\"service can provide its own signature to the timestamp request, which allows\"\n\" for a later comparative extraction from the registration service. The \"\n\"existence of an independent registration service reduces the risk of votes \"\n\"being 'lost' by the collection service.\"\n\n#: ../../06a-regteenus.rst:17 ../../06a-regteenus.rst:171\nmsgid \"Registreerimisteenus\"\nmsgstr \"Registration Service\"\n\n#: ../../06a-regteenus.rst:19\nmsgid \"\"\n\"Registreerimisteenus on teenus, mille abil Kogumisteenus registreerib kõik \"\n\"Hääletajatelt saadud hääled. Pärast hääletamisperioodi lõppu edastab \"\n\"Kogumisteenus talletatud hääled Töötlejale ning Registreerimisteenus edastab\"\n\" registreeritud hääled Töötlejale.\"\nmsgstr \"\"\n\"The Registration Service is the service through which the Collection Service\"\n\" registers all votes received from Voters. After the end of the voting \"\n\"period, the Collection Service shall transmit the stored votes to the \"\n\"Processor and the Registration Service shall transmit the registered votes \"\n\"to the Processor.\"\n\n#: ../../06a-regteenus.rst:24\nmsgid \"\"\n\"Registreerimisteenus aitab tagada e-valimiskasti terviklust. Eeldame et \"\n\"Kogumisteenusel puudub võimalus võltsida digitaalallkirja ning sellisel moel\"\n\" tekitada juurde hääli või muuta juba talletatud hääli. Riskina säilib \"\n\"võimalus, et Kogumisteenus ei anna kõiki talletatud hääli Töötlejale üle. \"\n\"Häälte valikulise üleandmise riski maandamiseks kasutab IVXV protokoll \"\n\"täiendavat Registreerimisteenust, kuhu Kogumisteenus iga talletatud hääle \"\n\"registreerib. Hääletajal on protokollikohaselt võimalus korrektses \"\n\"registreerimises veenduda -- Registreerimisteenuse digitaalselt \"\n\"allkirjastatud kinnitus konkreetse hääle registreerimise kohta esitatakse ka\"\n\" konkreetsele hääletajale.\"\nmsgstr \"\"\n\"The registration service helps to ensure the integrity of the digital ballot\"\n\" box. We assume that the Collection Service has no possibility to forge a \"\n\"digital signature and thus generate additional votes or change votes already\"\n\" stored. As a risk, there remains the possibility that the Collection \"\n\"Service may not deliver all the stored votes to the Processor. In request to\"\n\" mitigate the risk of a selective transfer of votes, the IVXV protocol will \"\n\"use an additional Registration Service, where each stored vote will be \"\n\"registered by the Collection Service. The voter will have the opportunity \"\n\"to verify the correct registration according to the protocol -- a digitally \"\n\"signed confirmation of the registration of a specific vote by the \"\n\"Registration Service will also be provided to the specific voter.\"\n\n#: ../../06a-regteenus.rst:35\nmsgid \"Registreerimisteenus protokollis\"\nmsgstr \"Registration Service in the protocol\"\n\n#: ../../06a-regteenus.rst:37\nmsgid \"\"\n\"Kogumisteenus saadab Registreerimisteenusele enda poolt allkirjastatud \"\n\"registreerimiskorralduse (edaspidi KORRALDUS), mis sisaldab hääle \"\n\"identifikaatorit ja allkirjastatud hääle räsi::\"\nmsgstr \"\"\n\"The Collection Service sends to the Registration Service a registration \"\n\"request (hereinafter the REQUEST) signed by the Collection Service and \"\n\"containing the vote identifier and the signed vote hash:\"\n\n#: ../../06a-regteenus.rst:43\nmsgid \"\"\n\"Registreerimisteenus talletab KORRALDUSE hilisemaks väljastamiseks ning \"\n\"vastab Kogumisteenusele oma poolt allkirjastatud registreerimiskinnitusega \"\n\"(edaspidi KINNITUS), mis allkirjastab algset KORRALDUST ning KINNITUSE \"\n\"väljastamise aega::\"\nmsgstr \"\"\n\"The Registration Service stores the REQUEST for later issuance and responds \"\n\"to the Collection Service with a registration confirmation signed by the \"\n\"Registration Service (hereinafter the CONFIRMATION), signing the original \"\n\"REQUEST and the time of issuance of the CONFIRMATION:\"\n\n#: ../../06a-regteenus.rst:49\nmsgid \"\"\n\"Kogumisteenus tagastab nii KINNITUSE kui KORRALDUSE valijarakendusele, \"\n\"Hääletaja saab teate hääle positiivsest talletamisest ainult KINNITUSE ja \"\n\"selle aluseks olnud KORRALDUSE edukal verifitseerimisel.\"\nmsgstr \"\"\n\"The collection service returns both the CONFIRMATION and the REQUEST to the \"\n\"voting application, the Voter will receive notification of a positive vote \"\n\"deposit only upon successful verification of the CONFIRMATION and the \"\n\"underlying REQUEST.\"\n\n#: ../../06a-regteenus.rst:53\nmsgid \"\"\n\"Hääletamisperioodi lõppedes edastab Registreerimisteenus Kogumisteenuse \"\n\"poolt tehtud KORRALDUSED Töötlejale.\"\nmsgstr \"\"\n\"At the end of the voting period, the REGISTRATION SERVICE forwards the \"\n\"REQUESTS made by the COLLECTION SERVICE to the Processor.\"\n\n#: ../../06a-regteenus.rst:56\nmsgid \"\"\n\"Registreerimisteenus peab Töötlejale algselt andma üle vähemalt loendi::\"\nmsgstr \"\"\n\"The registration service must initially provide the Processor with at least \"\n\"a list of:\"\n\n#: ../../06a-regteenus.rst:60\nmsgid \"\"\n\"Kui Registreerimisteenus annab üle ainult ülalkirjeldatud loendi, siis peab \"\n\"ta hiljem oleme võimeline andma loendi nõutud elemendile vastava \"\n\"korralduse::\"\nmsgstr \"\"\n\"If the Registration Service delivers only the list described above, it must \"\n\"later be able to issue the corresponding request for the requested element \"\n\"of the list::\"\n\n#: ../../06a-regteenus.rst:68\nmsgid \"Registreerimisteenuse roll hääletamisel\"\nmsgstr \"The role of the registration service in voting\"\n\n#: ../../06a-regteenus.rst:73\nmsgid \"Registreerimisteenuse roll hääle kontrollimisel\"\nmsgstr \"The role of the registration service in verifying votes\"\n\n#: ../../06a-regteenus.rst:78\nmsgid \"Registreerimisteenuse roll häälte üleandmisel\"\nmsgstr \"The role of the registration service in the transfer of votes\"\n\n#: ../../06a-regteenus.rst:82\nmsgid \"Registreerimisteenuse liidesed\"\nmsgstr \"Registration service interfaces\"\n\n#: ../../06a-regteenus.rst:84\nmsgid \"Registreerimisteenusel on kaks liidest\"\nmsgstr \"The registration service has two interfaces\"\n\n#: ../../06a-regteenus.rst:86\nmsgid \"KORRALDUSTE vastuvõtmise ja KINNITUSTE väljastamise liides;\"\nmsgstr \"\"\n\"Interface for the reception of REQUESTS and the issue of CONFIRMATIONS;\"\n\n#: ../../06a-regteenus.rst:88\nmsgid \"\"\n\"KORRALDUSE alusel väljastatud KINNITUSTE loetelu ja nende aluseks olnud \"\n\"KORRALDUSTE väljastamise liides.\"\nmsgstr \"\"\n\"List of CONFIRMATIONS issued under the REQUEST and the interface for issuing\"\n\" the underlying REQUEST.\"\n\n#: ../../06a-regteenus.rst:91\nmsgid \"\"\n\"Registreerimisteenuse funktsionaalsuseks on Kogumisteenusele KINNITUSTE \"\n\"väljastamine, väljastatud KINNITUSTE ja neile aluseks olevate KORRALDUSTE \"\n\"säilitamine ja hilisem Töötlejale üleandmine.\"\nmsgstr \"\"\n\"The functionality of the Registration Service is to issue CONFIRMATIONS to \"\n\"the Collection Service, to store the issued CONFIRMATIONS and the underlying\"\n\" REQUESTS and to later transfer them to the Processor.\"\n\n#: ../../06a-regteenus.rst:95\nmsgid \"\"\n\"Kui Registreerimisteenus osutab teenust mitmele erinevale osapoolele, siis \"\n\"peab olema garanteeritud, et konkreetse valimisega seotud Kogumisteenuse \"\n\"KORRALDUSED ja neile vastavad KINNITUSED on Valijarakenduse ja \"\n\"Kontrollrakenduse poolt kontrollitavalt eristatavad teiste osapoolte \"\n\"KORRALDUSTEST ning neile vastavatest KINNITUSTEST. Vastasel juhul võib \"\n\"tekkida olukord, kus Kogumisteenus küll registreerib hääle, kuid info \"\n\"sellest ei jõua Töötlejani.\"\nmsgstr \"\"\n\"Where the Registration Service provides a service to several different \"\n\"parties, it must be guaranteed that the REQUESTS of the Collection Service \"\n\"relating to a particular election and the corresponding CONFIRMATIONS are \"\n\"verifiably distinguishable by the Voting Application and the Verification \"\n\"Application from the REQUESTS of the other parties and the corresponding \"\n\"CONFIRMATIONS. Otherwise, a situation may arise where the Collection Service\"\n\" registers a vote but the information does not reach the Processor.\"\n\n#: ../../06a-regteenus.rst:102\nmsgid \"\"\n\"Registreerimisteenus peab olema võimeline kõiki Kogumisteenuse poolt tulnud \"\n\"KORRALDUSI üle andma.\"\nmsgstr \"\"\n\"The Registration Service must be able to deliver all the REQUESTS coming \"\n\"from the Collection Service.\"\n\n#: ../../06a-regteenus.rst:106\nmsgid \"Osapoolte nõuded registreerimisteenusele\"\nmsgstr \"Requirements of registration service\"\n\n#: ../../06a-regteenus.rst:109\nmsgid \"Töötleja\"\nmsgstr \"Processor\"\n\n#: ../../06a-regteenus.rst:111\nmsgid \"Töötleja ülesanne on muuhulgas tuvastada,\"\nmsgstr \"The task of the Processor is, inter alia, to identify,\"\n\n#: ../../06a-regteenus.rst:113\nmsgid \"millised Kogumisteenuse poolt üle antud hääled lähevad lugemisele ja\"\nmsgstr \"\"\n\"which votes handed over by the Collection Service will be counted, and\"\n\n#: ../../06a-regteenus.rst:115\nmsgid \"kas Kogumisteenus on jätnud hääli üle andmata.\"\nmsgstr \"whether the Collection Service has failed to deliver the votes.\"\n\n#: ../../06a-regteenus.rst:117\nmsgid \"\"\n\"Töötleja töö tulemusena selguvaid erisusi tuleb lahendada ning siin on \"\n\"järgmised 3 juhtumit:\"\nmsgstr \"\"\n\"The differences that emerge as a result of the processor's work need to be \"\n\"resolved, and here are 3 cases:\"\n\n#: ../../06a-regteenus.rst:120\nmsgid \"\"\n\"Kogumisteenus annab Töötlejale üle allkirjastatud hääle koos KINNITUSega, \"\n\"Registreerimisteenus annab Töötlejale üle Kogumisteenuse KORRALDUSE, mille \"\n\"alusel KINNITUS anti - vaidlust ei ole, kui konkreetne hääl oli antud \"\n\"Hääletaja jaoks viimane, siis suunatakse ta lugemisele.\"\nmsgstr \"\"\n\"The Collection Service delivers to the Processor the signed vote together \"\n\"with the CONFIRMATION, the Registration Service delivers to the Processor \"\n\"the Collection Service's REQUEST on the basis of which the CONFIRMATION was \"\n\"given - there is no dispute, if the particular vote was the last one given \"\n\"for the Voter, it will be forwarded for counting.\"\n\n#: ../../06a-regteenus.rst:125\nmsgid \"\"\n\"Kogumisteenus annab Töötlejale üle allkirjastatud hääle koos KINNITUSega, \"\n\"Registreerimisteenus ei anna Töötlejale selle hääle kohta midagi üle. Kuna \"\n\"KINNITUS on Registreerimisteenuse poolt allkirjastatud, siis on viga \"\n\"Registreerimisteenuse poolel. Kui konkreetne hääl oli antud Hääletaja jaoks \"\n\"viimane, siis suunatakse ta lugemisele.\"\nmsgstr \"\"\n\"The Collection Service will transfer the signed vote to the Processor \"\n\"together with the CONFIRMATION, the Registration Service will not transfer \"\n\"anything about the vote to the Processor. Since the CONFIRMATION is signed \"\n\"by the Registration Service, the error is on the side of the Registration \"\n\"Service. If the particular vote was the last one cast for the Voter, it will\"\n\" be forwarded for counting.\"\n\n#: ../../06a-regteenus.rst:131\nmsgid \"\"\n\"Registreerimisteenus annab Töötlejale üle Kogumisteenuse KORRALDUSE, \"\n\"Kogumisteenus ei anna Töötlejale vastava räsiga häält üle. Kuna KORRALDUS on\"\n\" Kogumisteenuse poolt allkirjastatud, siis on viga Kogumisteenuse poolel \"\n\"ning antud hääl tuleb üles otsida.\"\nmsgstr \"\"\n\"The Registration Service will transfer to the Processor the Collection \"\n\"Service's REQUEST, the Collection Service will not transfer to the Processor\"\n\" the vote with the corresponding hash. As the REQUEST is signed by the \"\n\"Collection Service, the error is on the Collection Service's side and the \"\n\"vote cast must be retrieved.\"\n\n#: ../../06a-regteenus.rst:137\nmsgid \"Hääletaja\"\nmsgstr \"Voter\"\n\n#: ../../06a-regteenus.rst:139\nmsgid \"\"\n\"Hääletaja jaoks on oht, et Kogumisteenus võib tema hääle 'unustada'. \"\n\"Nõuetekohase KINNITUSE nägemine annab Hääletajale kindluse, et väline \"\n\"osapool garanteerib tema hääle Töötlejani jõudmist. Kindluse jaoks on \"\n\"oluline:\"\nmsgstr \"\"\n\"For the voter, there is a risk that the Collection Service may 'forget' \"\n\"his/her vote. Seeing a proper CONFIRMATION gives the Voter the assurance \"\n\"that an external party will guarantee that their vote will reach the \"\n\"Processor. Following is important for the certainty:\"\n\n#: ../../06a-regteenus.rst:143 ../../06a-regteenus.rst:289\nmsgid \"KINNITUS on Registreerimisteenuse poolt allkirjastatud;\"\nmsgstr \"The CONFIRMATION is signed by the Registration Service;\"\n\n#: ../../06a-regteenus.rst:145 ../../06a-regteenus.rst:291\nmsgid \"\"\n\"KINNITUSES sisalduv algne KORRALDUS on Kogumisteenuse poolt allkirjastatud;\"\nmsgstr \"\"\n\"The original REQUEST contained in the CONFIRMATION is signed by the \"\n\"Collection Service;\"\n\n#: ../../06a-regteenus.rst:147\nmsgid \"\"\n\"usaldus, et Registreerimisteenus on võimeline KINNITUSE andmise fakti meeles\"\n\" pidama;\"\nmsgstr \"\"\n\"confidence that the Registration Service is capable of remembering the fact \"\n\"of giving the CONFIRMATION;\"\n\n#: ../../06a-regteenus.rst:150\nmsgid \"\"\n\"usaldus, et Registreerimisteenus on võimeline KINNITUSE andmise kohasust \"\n\"Töötlejale tõestama;\"\nmsgstr \"\"\n\"confidence that the Registration Service is able to prove the \"\n\"appropriateness of granting the CONFIRMATION to the Processor;\"\n\n#: ../../06a-regteenus.rst:153\nmsgid \"\"\n\"usaldus, et Kogumisteenusel ei ole võimalik hankida alternatiivset \"\n\"valekinnitust, mis Valijarakenduses verifitseerub, kuid Töötlejani ei jõua.\"\nmsgstr \"\"\n\"confidence that the Collection Service will not be able to obtain an \"\n\"alternative false positive CONFIRMATION that will be verified in the Voting \"\n\"Application but will not reach the Processor.\"\n\n#: ../../06a-regteenus.rst:157\nmsgid \"Kogumisteenus\"\nmsgstr \"Collection Service\"\n\n#: ../../06a-regteenus.rst:159\nmsgid \"\"\n\"Kogumisteenuse jaoks on oht, et Registreerimisteenuse poolt üleantud \"\n\"KINNITUSTE ja talletatud häälte vaated erinevad. Kogumisteenuse poolt \"\n\"KORRALDUSELE antud allkiri on Kogumisteenuse garantii, et \"\n\"Registreerimisteenuse poolt ei saa tekkida fiktiivseid KINNITUSI, mida \"\n\"Kogumisteenus tegelikult nõudnud pole.\"\nmsgstr \"\"\n\"There is a risk that, for the Collection Service, the views of the \"\n\"CONFIRMATIONS transferred by the Registration Service and the stored votes \"\n\"will differ. The signature given by the Collection Service to the REQUEST is\"\n\" the Collection Service's guarantee that no fictitious REQUESTS cannot be \"\n\"generated by the Registration Service that were not actually requested by \"\n\"the Collection Service.\"\n\n#: ../../06a-regteenus.rst:164\nmsgid \"\"\n\"Kogumisteenus talletab kõiki Registreerimisteenuse vastuseid. Kuna need on \"\n\"allkirjastatud, siis on täiendav info oluline vaid siis kui Kogumisteenus \"\n\"väidab, et mingit KORRALDUST ei ole antud, kuigi Registreerimisteenus on \"\n\"``(v_id, Hash(VOTE))`` esitanud. Sellisel juhul saab Registreerimisteenus \"\n\"esitada terve Kogumisteenuse KORRALDUSE (või vähemalt selle allkirjastatud \"\n\"komponendi)\"\nmsgstr \"\"\n\"The Collection Service stores all responses from the Registration Service. \"\n\"Since they are signed, the additional information is only relevant if the \"\n\"Collection Service claims that no REQUEST has been given, even though the \"\n\"Registration Service has provided ``(v_id, Hash(VOTE))``. In such a case, \"\n\"the Registration Service can provide the entire ORDER of the Collection \"\n\"Service (or at least a signed component of it).\"\n\n#: ../../06a-regteenus.rst:173\nmsgid \"\"\n\"Registreerimisteenus on huvitatud, et vaidlusolukordades, kus Kogumisteenus \"\n\"jätab midagi üle andmata, oleks tal võimalik oma tegevuse korrektsust \"\n\"tõestada. Oluline on tagada:\"\nmsgstr \"\"\n\"The Registration Service is interested in being able to prove the \"\n\"correctness of its actions in the event of a dispute where the Collection \"\n\"Service fails to deliver something. It is important to ensure:\"\n\n#: ../../06a-regteenus.rst:177\nmsgid \"\"\n\"Kogumisteenuse poolt konkreetse valimise raames antavad KORRALDUSED on \"\n\"teiste klientide poolt esitatud KORRALDUSTEST kontrollitavalt eristatavad.\"\nmsgstr \"\"\n\"The REQUESTS provided by the collection service in the context of a specific\"\n\" election are verifiably distinguishable from the REQUESTS provided by other\"\n\" customers.\"\n\n#: ../../06a-regteenus.rst:180\nmsgid \"\"\n\"Kogumisteenus ei saa juba esitatud KORRALDUSTE kohta väita, et ta neid ei \"\n\"esitanud.\"\nmsgstr \"\"\n\"The collection service cannot claim that it has not already submitted the \"\n\"REQUESTS.\"\n\n#: ../../06a-regteenus.rst:184\nmsgid \"Registreerimisteenuse realiseerimine RFC 3161 protokolli raamistikus\"\nmsgstr \"Registry service implementation in the RFC 3161 protocol framework\"\n\n#: ../../06a-regteenus.rst:186\nmsgid \"\"\n\"PKIX on ajatembeldusprotokoll, kus usaldatav kolmas osapool \"\n\"(ajatempliteenuse osutaja ehk ATO) kinnitab oma allkirjaga andmete \"\n\"eksisteerimist konkreetsel ajahetkel. Protokoll koosneb ühest päringust ja \"\n\"vastusest.\"\nmsgstr \"\"\n\"PKIX is a timestamping protocol, where a trusted third party (a timestamp \"\n\"authority or TSA) confirms the existence of data at a specific point in time\"\n\" with its signature. The protocol consists of a single request and response.\"\n\n#: ../../06a-regteenus.rst:190\nmsgid \"Ajatemplipäring::\"\nmsgstr \"Timestamp request::\"\n\n#: ../../06a-regteenus.rst:202\nmsgid \"\"\n\"Ajatembeldatavad andmed esitatakse teenusele ``messageImprint`` koosseisus \"\n\"räsina. ``TimeStampReq`` ei sisalda endas päringu esitaja allkirja.\"\nmsgstr \"\"\n\"The data to be timestamped shall be submitted to the ``messageImprint`` \"\n\"service as a raster. The ``TimeStampReq`` shall not include the signature of\"\n\" the requester.\"\n\n#: ../../06a-regteenus.rst:205\nmsgid \"ATO vastus ajatemplipäringule::\"\nmsgstr \"TSA response to timestamp request::\"\n\n#: ../../06a-regteenus.rst:234\nmsgid \"\"\n\"``TimeStampResp`` on ATO poolt digitaalselt allkirjastatud konteiner, mis \"\n\"sisaldab endas päringu koosseisus saadud välja ``messageImprint`` ning \"\n\"nonssi.\"\nmsgstr \"\"\n\"The ``TimeStampResp`` is a digitally signed container by the ATO containing \"\n\"the ``messageImprint`` field and the nonss received in the query \"\n\"configuration.\"\n\n#: ../../06a-regteenus.rst:237\nmsgid \"\"\n\"Registreerimisteenuse huvides on, et Kogumisteenuse päring oleks \"\n\"signeeritud. Kuna RFC 3161 ei toeta allkirjastatud päringuid on \"\n\"alternatiiviks kasutada mõnda laiendust, mis võimaldab Kogumisteenuse \"\n\"signatuuri edastamist. See laiendus tuleks teenuse poolt ajatempli \"\n\"koosseisus ka tagasi saata. Kuna RFC 3161 ei sõnasta laienduste \"\n\"tagasipeegeldamise nõuet ühemõtteliselt on reaalne võimalus kasutada \"\n\"protokolli laiendamiseks ajatemplipäringu nonssi. Nonss on ASN.1 INTEGER \"\n\"andmetüüp kuhu saab kodeerida suvalise struktuuriga andmeid, mis teeb \"\n\"võimalikuks järgmise skeemi:\"\nmsgstr \"\"\n\"It is in the interest of the registration service that the request by \"\n\"Collection Service is signed. Since RFC 3161 does not support signed \"\n\"requests, an alternative is to use an extension that allows the transmission\"\n\" of the Collection Service signature. This extension should also be returned\"\n\" by the service as part of the timestamp. Since RFC 3161 does not explicitly\"\n\" state the requirement for reflecting extensions, a real possibility is to \"\n\"use a timestamp request nonsign to extend the protocol. A nonss is an ASN.1 \"\n\"INTEGER data type into which data of arbitrary structure can be encoded, \"\n\"which makes the following scheme possible:\"\n\n#: ../../06a-regteenus.rst:246\nmsgid \"Enne hääletamist:\"\nmsgstr \"Before the vote:\"\n\n#: ../../06a-regteenus.rst:248\nmsgid \"Kogumisteenus genereerib allkirjastamisvõtme ja sertifikaadi.\"\nmsgstr \"The Collection Service generates a signature key and a certificate.\"\n\n#: ../../06a-regteenus.rst:250\nmsgid \"Kogumisteenus annab sertifikaadi Korraldajale üle.\"\nmsgstr \"The Collection Service will deliver the certificate to the Organiser.\"\n\n#: ../../06a-regteenus.rst:252\nmsgid \"Kogumisteenus seadistab ennast ATO'd kasutama.\"\nmsgstr \"The Collection Service configures itself to use the TSA.\"\n\n#: ../../06a-regteenus.rst:254\nmsgid \"Hääletamise ajal:\"\nmsgstr \"During the voting:\"\n\n#: ../../06a-regteenus.rst:256\nmsgid \"Valija saadab hääle talletamiseks.\"\nmsgstr \"The voter sends the vote to be recorded.\"\n\n#: ../../06a-regteenus.rst:258\nmsgid \"\"\n\"Kogumisteenus räsib hääle, allkirjastab räsi ning võtab räsile ajatempli, \"\n\"kasutades ajatemplipäringu TimeStampReq nonsina oma allkirja sellel räsil.\"\nmsgstr \"\"\n\"The Collection Service casts a vote, signs the hash and takes a timestamp on\"\n\" the hash, using your signature on the hash as a TimeStampReq noun.\"\n\n#: ../../06a-regteenus.rst:261\nmsgid \"\"\n\"ATO töötleb ajatemplipäringut kooskõlas RFC 3161 nõuetega ning väljastab \"\n\"allkirjastatud ajatempli.\"\nmsgstr \"\"\n\"The TSA processes the timestamp request in accordance with RFC 3161 and \"\n\"issues a signed timestamp.\"\n\n#: ../../06a-regteenus.rst:264\nmsgid \"\"\n\"Kogumisteenus vahendab ajatempli Valijarakendusele, mis teostab järgmised \"\n\"kontrollid:\"\nmsgstr \"\"\n\"The Collection Service sends a timestamp to the Voting Application, which \"\n\"performs the following checks:\"\n\n#: ../../06a-regteenus.rst:267\nmsgid \"ajatempel on ATO poolt allkirjastatud,\"\nmsgstr \"the timestamp is signed by the TSA,\"\n\n#: ../../06a-regteenus.rst:268\nmsgid \"ajatempel sisaldab nonssi,\"\nmsgstr \"the timestamp includes the nonce,\"\n\n#: ../../06a-regteenus.rst:269\nmsgid \"ajatempel sisaldab tema hääle räsi,\"\nmsgstr \"The timestamp contains the hash of her vote,\"\n\n#: ../../06a-regteenus.rst:270\nmsgid \"nonss on Kogumisteenuse poolt allkirjastatud valija hääle räsi.\"\nmsgstr \"\"\n\"nonce is a hash of voter's signed vote signed by the Collection Service.\"\n\n#: ../../06a-regteenus.rst:272\nmsgid \"Peale hääletamist:\"\nmsgstr \"After the vote:\"\n\n#: ../../06a-regteenus.rst:274\nmsgid \"Korraldaja annab ATO'le ajavahemiku ja Kogumisteenuse sertifikaadi\"\nmsgstr \"\"\n\"The Organiser will provide the TSA with a time period and a Collection \"\n\"Service certificate\"\n\n#: ../../06a-regteenus.rst:276\nmsgid \"\"\n\"ATO otsib kõigi selle ajavahemiku ajatemplipäringute ja vastuste hulgast \"\n\"neid, millel\"\nmsgstr \"\"\n\"The TSA will search for all timestamp requests and responses in this period \"\n\"for those that have\"\n\n#: ../../06a-regteenus.rst:279\nmsgid \"on nonss,\"\nmsgstr \"a nonce,\"\n\n#: ../../06a-regteenus.rst:280\nmsgid \"nonss dekodeerub kokkuleppeliseks andmestruktuuriks,\"\nmsgstr \"the nonce is decodable into a specified data structure,\"\n\n#: ../../06a-regteenus.rst:281\nmsgid \"andmestruktuur verifitseerub Kogumisteenuse sertifikaadiga.\"\nmsgstr \"the data structure is verifiable by a Collection Service certificate.\"\n\n#: ../../06a-regteenus.rst:283\nmsgid \"ATO annab üle kõik leitud ajatemplipäringud ja ajatemplid.\"\nmsgstr \"The TSA will hand over all timestamp requests and timestamps found.\"\n\n#: ../../06a-regteenus.rst:285\nmsgid \"Kogumisteenus annab üle kõik ajatemplipäringud, ajatemplid ja hääled.\"\nmsgstr \"\"\n\"The Collection Service will deliver all timestamp requests, timestamps and \"\n\"votes.\"\n\n#: ../../06a-regteenus.rst:287\nmsgid \"Töötleja analüüsib andmeid vastavalt protokollile\"\nmsgstr \"The Processor analyses the data according to the protocol\"\n\n#: ../../06a-regteenus.rst:293\nmsgid \"\"\n\"Usaldus, et Registreerimisteenus on võimeline KINNITUSE andmise fakti meeles\"\n\" pidama;\"\nmsgstr \"\"\n\"Confirmation that the Registration Service is able to remember the fact of \"\n\"the CONFIRMATION;\"\n\n#: ../../06a-regteenus.rst:296\nmsgid \"\"\n\"Usaldus, et Kogumisteenusel ei ole võimalik hankida alternatiivset \"\n\"valekinnitust, mis Valijarakenduses verifitseerub, kuid Töötlejani ei jõua\"\nmsgstr \"\"\n\"Confirmation that it is not possible for the Collection Service to obtain an\"\n\" alternative false positive that will be verified in the Voting Application \"\n\"but will not reach the Processor\"\n\n#: ../../06a-regteenus.rst:299\nmsgid \"\"\n\"Usaldus, et Registreerimisteenus on võimeline KINNITUSE andmise kohasust \"\n\"Töötlejale tõestama;\"\nmsgstr \"\"\n\"Confirmation that the Registration Service is able to prove the \"\n\"appropriateness of granting the CONFIRMATION to the Processor;\"\n\n#: ../../06a-regteenus.rst:302\nmsgid \"\"\n\"Registreerimisteenuse poolt ei saa tekkida fiktiivseid KINNITUSI, mida \"\n\"Kogumisteenus tegelikult nõudnud pole\"\nmsgstr \"\"\n\"No fictitious CONFIRMATIONS can be generated by the Registration Service \"\n\"which are not actually required by the Collection Service\"\n\n#: ../../06a-regteenus.rst:305\nmsgid \"\"\n\"Kogumisteenus ei saa juba esitatud KORRALDUSTE kohta väita, et ta neid ei \"\n\"esitanud\"\nmsgstr \"\"\n\"The collection service cannot claim that it did not submit the REQUESTS \"\n\"already submitted\"\n\n#: ../../06a-regteenus.rst:308\nmsgid \"Nonsi vorming::\"\nmsgstr \"Nonce format::\"\n\n#: ../../06a-regteenus.rst:320\nmsgid \"Sõnumiks on TimeStampReq.messageImprint DER-kodeering::\"\nmsgstr \"The message is TimeStampReq.messageImprint DER encoding::\"\n\n#: ../../06a-regteenus.rst:327\nmsgid \"\"\n\"RSA kasutamisel allkirjastamiseks. välja \"\n\"``Signature.signingAlgorithm.algorithm`` väärtus sõltub sõnumi \"\n\"``hashAlgorithm`` välja väärtusest::\"\nmsgstr \"\"\n\"When using RSA for signing. field ``Signature.signingAlgorithm.algorithm`` \"\n\"the value depends on the value of the ``hashAlgorithm`` field of the \"\n\"message::\"\n\n#: ../../06a-regteenus.rst:339\nmsgid \"Väli ``Signature.signingAlgorithm.parameters`` puudub või on NULL.\"\nmsgstr \"\"\n\"The ``Signature.signingAlgorithm.parameters`` field is missing or NULL.\"\n\n#: ../../06a-regteenus.rst:341\nmsgid \"\"\n\"Väli ``Signature.signature`` on OCTET STRING, mis sisaldab RSA signatuuri \"\n\"sõnumil.\"\nmsgstr \"\"\n\"The ``Signature.signature`` field is an OCTET STRING containing the RSA \"\n\"signature on the message.\"\n\n#: ../../06a-regteenus.rst:344\nmsgid \"ATO väljavõte\"\nmsgstr \"TSA extract\"\n\n#: ../../06a-regteenus.rst:346\nmsgid \"\"\n\"ATO väljavõte Kogumisteenuse poolt esitatud TimeStampReq vormingus \"\n\"päringutest esitatakse ZIP failina, kus iga päring on salvestatud ühte \"\n\"faili, mis vastab järgmistele tingimustele:\"\nmsgstr \"\"\n\"The TSA extract of the requests submitted by the Collection Service in \"\n\"TimeStampReq format will be presented as a ZIP file, where each request is \"\n\"stored in a single file that meets the following conditions:\"\n\n#: ../../06a-regteenus.rst:350\nmsgid \"Kaustastruktuur puudub, ükski fail ei paikne kaustas.\"\nmsgstr \"There is no folder structure, no files are located in a folder.\"\n\n#: ../../06a-regteenus.rst:351\nmsgid \"Failinimed on unikaalsed (failinimedele samas tähendust ei omistata).\"\nmsgstr \"\"\n\"File names are unique (file names are not given any meaning at the same \"\n\"time).\"\n\n#: ../../06a-regteenus.rst:353\nmsgid \"Üleantav andmekomplekt on:\"\nmsgstr \"The data set to be transferred is:\"\n\n#: ../../06a-regteenus.rst:355\nmsgid \"Andmefail: `.zip`\"\nmsgstr \"Data file: `.zip`\"\n\n#: ../../06a-regteenus.rst:356\nmsgid \"Kontrollsummafail: `.zip.sha256sum.asice`\"\nmsgstr \"Checksum file: `.zip.sha256sum.asice`\"\n\n#: ../../06a-regteenus.rst:358\nmsgid \"\"\n\"Üherealise kontrollsummafaili sisu on HEX kodeeringus SHA256 räsi \"\n\"andmefailist.\"\nmsgstr \"\"\n\"The contents of the single line checksum file are HEX encoded from the \"\n\"SHA256 hash data file.\"\n" }, { "path": "Documentation/public/protokollid/locales/en/LC_MESSAGES/07-kontrollimine.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2024, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.8.2\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-05 11:29+0000\\n\"\n\"PO-Revision-Date: 2024-03-01 17:59+0200\\n\"\n\"Last-Translator: \\n\"\n\"Language: en\\n\"\n\"Language-Team: en \\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../07-kontrollimine.rst:5\nmsgid \"Elektroonilise hääle kontrollimine eraldi ja e-valimiskasti koosseisus\"\nmsgstr \"\"\n\"Verification of electronic votes separately and as part of a digital \"\n\"ballot box\"\n\n#: ../../07-kontrollimine.rst:7\nmsgid \"\"\n\"Elektroonilist häält kontrollitakse töötlemisrakenduses, kogumisteenuses,\"\n\" valijarakenduses ja kontrollrakenduses.\"\nmsgstr \"\"\n\"The electronic vote is verified in the processing application, the \"\n\"collection service, the voting application and the verification \"\n\"application.\"\n\n#: ../../07-kontrollimine.rst:10\nmsgid \"\"\n\"Kõige põhjalikuma kontrolli läbib elektrooniline hääl e-valimiskasti \"\n\"koosseisus töötlemisrakenduses, kus otsustatakse konkreetse hääle \"\n\"lugemisele saatmine või mittesaatmine. Nende kontrollide käigus \"\n\"vaadeldakse e-häält nii eraldi kui ka suhtes kõigi teiste sama valija \"\n\"poolt antud häältega. Täiendavalt kõrvutatakse e-valimiskasti \"\n\"registreerimisteenuse väljavõttega.\"\nmsgstr \"\"\n\"The most thorough check of an electronic vote takes place in the \"\n\"processing application within the e-voting box, where the decision to \"\n\"send or not to send a particular vote is made. During these checks, the \"\n\"e-vote is examined both individually and in relation to all other votes \"\n\"cast by the same voter. A further comparison is made with the e-voting \"\n\"box registration service extract.\"\n\n#: ../../07-kontrollimine.rst:16\nmsgid \"\"\n\"Iga üksiku hääle kohta läbitakse töötlemisrakendusega analoogsel tasemel \"\n\"kontroll valijarakenduses, kus veendutakse, et kogumisteenus on hääle \"\n\"kvalifitseerinud selliselt, et töötlemisrakenduses tehtavad kontrollid \"\n\"õnnestuvad. Valijarakenduse kontrollidega samaväärsed kontrollid viib \"\n\"läbi kontrollrakendus.\"\nmsgstr \"\"\n\"For each individual vote, a check is performed in the voting application \"\n\"at a level analogous to that in the processing application, to ensure \"\n\"that the collection service has qualified the vote in such a way that the\"\n\" checks in the processing application are successful. Checks equivalent \"\n\"to those carried out in the Voting Application shall be carried out by \"\n\"the Verification Application.\"\n\n#: ../../07-kontrollimine.rst:22\nmsgid \"\"\n\"Kogumisteenus on lisaks vastutav mitme hääle lõplikuks \"\n\"kvalifitseerumiseks vajaliku elemendi hankimise eest ning teostab ka \"\n\"nende hankimise järgselt kontrollid.\"\nmsgstr \"\"\n\"In addition, the collection service is responsible for the procurement of\"\n\" the elements necessary for the final qualification of several votes, and\"\n\" also carries out post-qualification checks.\"\n\n#: ../../07-kontrollimine.rst:27\nmsgid \"Lõpliku elektroonilise hääle komponendid\"\nmsgstr \"Components of the final electronic voice\"\n\n#: ../../07-kontrollimine.rst:29\nmsgid \"\"\n\"Elemendid, mis on kättesaadavad otsustamise hetkel, kas hääl \"\n\"kvalifitseerub lugemisele saatmiseks või mitte:\"\nmsgstr \"\"\n\"Elements available at the moment of deciding whether or not a vote \"\n\"qualifies to be sent for counting:\"\n\n#: ../../07-kontrollimine.rst:32\nmsgid \"elektroonilist häält sisaldav konteiner - :ref:`entity-haale-konteiner`;\"\nmsgstr \"container containing electronic voice - :ref:`entity-haale-konteiner`;\"\n\n#: ../../07-kontrollimine.rst:34\nmsgid \"krüpteeritud sedel - :ref:`entity-krypteeritud-sedel`;\"\nmsgstr \"encrypted ballot - :ref:`entity-krypteeritud-sedel`;\"\n\n#: ../../07-kontrollimine.rst:36\nmsgid \"valija signatuur krüpteeritud sedelil - :ref:`entity-haale-signatuur`;\"\nmsgstr \"voter signature on encrypted ballot - :ref:`entity-haale-signatuur`;\"\n\n#: ../../07-kontrollimine.rst:38\nmsgid \"valija allkiri krüpteeritud sedelil - :ref:`entity-haale-allkiri`;\"\nmsgstr \"voter signature on encrypted ballot - :ref:`entity-haale-allkiri`;\"\n\n#: ../../07-kontrollimine.rst:40\nmsgid \"valija allkirjastamissertifikaat - :ref:`entity-valija-sertifikaat`;\"\nmsgstr \"voter signing certificate - :ref:`entity-valija-sertifikaat`;\"\n\n#: ../../07-kontrollimine.rst:42\nmsgid \"valija isikukood - :ref:`entity-valija-identiteet`;\"\nmsgstr \"voter identity code - :ref:`entity-valija-identiteet`;\"\n\n#: ../../07-kontrollimine.rst:44\nmsgid \"\"\n\"kvalifitseeriv element - valija sertifikaadi kehtivuskinnitus - :ref\"\n\":`entity-kehtivuskinnitus`;\"\nmsgstr \"\"\n\"qualifying element - confirmation of the validity of the voter's \"\n\"certificate - :ref:`entity-kehtivuskinnitus`;\"\n\n#: ../../07-kontrollimine.rst:47\nmsgid \"\"\n\"kvalifitseeriv element - ajatempel allkirjastatud krüpteeritud sedelile -\"\n\" :ref:`entity-ajatempel`;\"\nmsgstr \"\"\n\"qualifying element - timestamp on a signed encrypted ballot - :ref\"\n\":`entity-ajatempel`;\"\n\n#: ../../07-kontrollimine.rst:50\nmsgid \"\"\n\"kvalifitseeriv element - registreerimispäringu konteiner :ref:`entity-\"\n\"registreerimisparing-konteiner`;\"\nmsgstr \"\"\n\"Creating a registration request - :ref:`entity-registreerimisparing-\"\n\"konteiner`\"\n\n#: ../../07-kontrollimine.rst:53\nmsgid \"\"\n\"kvalifitseeriv element - registreerimispäring allkirjastatud krüpteeritud\"\n\" sedelile - :ref:`entity-registreerimisparing`;\"\nmsgstr \"\"\n\"qualifying element - registration certificate for signed and encrypted \"\n\"vote - :ref:`entity-registreerimisparing`;\"\n\n#: ../../07-kontrollimine.rst:56\nmsgid \"\"\n\"kvalifitseeriv element - registreerimistõend allkirjastatud krüpteeritud \"\n\"sedeli kohta - :ref:`entity-registreerimistoend`;\"\nmsgstr \"\"\n\"qualifying element - registration certificate for signed and encrypted \"\n\"vote - :ref:`entity-registreerimistoend`;\"\n\n#: ../../07-kontrollimine.rst:59\nmsgid \"\"\n\"valija ringkonnakuuluvuse tõend hääle andmise hetkel - :ref:`entity-\"\n\"nimekirjatunnus`.\"\nmsgstr \"\"\n\"proof of the voter's district eligibility at the time of voting - :ref\"\n\":`entity-nimekirjatunnus`.\"\n\n#: ../../07-kontrollimine.rst:63\nmsgid \"\"\n\"Elemendid, mis on kättesaadavad otsustamise hetkel, kuidas häält \"\n\"kokkulugemisel arvesse võtta:\"\nmsgstr \"\"\n\"The elements available at the moment of deciding how to take the vote \"\n\"into account in the count:\"\n\n#: ../../07-kontrollimine.rst:66\nmsgid \"miksitud krüpteeritud sedel - :ref:`entity-miksitud-krypteeritud-sedel`;\"\nmsgstr \"mixed encrypted ballot - :ref:`entity-miksitud-krypteeritud-sedel`;\"\n\n#: ../../07-kontrollimine.rst:68\nmsgid \"valija tahteavaldus avakujul - :ref:`entity-tahteavaldus`;\"\nmsgstr \"voter's plaintext intent - :ref:`entity-tahteavaldus`;\"\n\n#: ../../07-kontrollimine.rst:70\nmsgid \"ringkonnakuuluvuse tunnus - :ref:`entity-ringkonnatunnus`;\"\nmsgstr \"district membership - :ref:`entity-ringkonnatunnus`;\"\n\n#: ../../07-kontrollimine.rst:72\nmsgid \"\"\n\"ringkonnapõhine valikute nimekiri - :ref:`entity-ringkonna-\"\n\"valikutenimekiri`.\"\nmsgstr \"district-based candidate list - :ref:`entity-ringkonna-valikutenimekiri`.\"\n\n#: ../../07-kontrollimine.rst:75\nmsgid \"Täiendavad elemendid:\"\nmsgstr \"Additional elements:\"\n\n#: ../../07-kontrollimine.rst:77\nmsgid \"\"\n\"krüpteerimisel kasutatud juhuslikkus - :ref:`entity-juhuslikkus`; - \"\n\"luuakse valijarakenduses hääle krüpteerimisel ning vahendatakse ainult \"\n\"kontrollrakendusele.\"\nmsgstr \"\"\n\"randomness used in encryption - :ref:`entity-juhuslikkus`; - is generated\"\n\" in the voter application when the vote is encrypted and is only \"\n\"transmitted to the verification application.\"\n\n#: ../../07-kontrollimine.rst:86\nmsgid \"TAHTEAVALDUS\"\nmsgstr \"INTENT\"\n\n#: ../../07-kontrollimine.rst:88\nmsgid \"\"\n\"Olem moodustatakse valijarakenduses ning tuvastatakse võtmerakenduses. \"\n\"Tegemist on EHS spetsiifilises vormingus UTF-8 kodeeringus baidijadaga.\"\nmsgstr \"\"\n\"The item is created in the voter application and identified in the key \"\n\"application. It is an EHS specific format UTF-8 encoded byte string.\"\n\n#: ../../07-kontrollimine.rst:94\nmsgid \"TAHTEAVALDUS, vormingu korrektsus\"\nmsgstr \"INTENT, correctness of the format\"\n\n#: ../../07-kontrollimine.rst:96\nmsgid \"\"\n\"Tahteavalduse vormingu korrektsuse kontroll käesoleva spetsifikatsiooni \"\n\"suhtes.\"\nmsgstr \"\"\n\"Verification of the correctness of the intent format against this \"\n\"specification.\"\n\n#: ../../07-kontrollimine.rst:102\nmsgid \"TAHTEAVALDUS, RINGKONNATUNNUS, RINGKONNA VALIKUTENIMEKIRI kooskõlalisus\"\nmsgstr \"INTENT, DISTRICT MEMBERSHIP, DISTRICT CHOICES consistency \"\n\n#: ../../07-kontrollimine.rst:104\nmsgid \"\"\n\"Tahteavalduses sisalduva valiku kontroll ringkonnatunnuse ja valikute \"\n\"nimekirja suhtes. Kontroll õnnestub, kui tuvastatud valik on kättesaadav \"\n\"antud ringkonnas.\"\nmsgstr \"\"\n\"Checking the choice identified by the intent against the district \"\n\"membership and the district choices. The check succeeds if the identified\"\n\" option is available in the given district.\"\n\n#: ../../07-kontrollimine.rst:111\nmsgid \"TAHTEAVALDUS, RINGKONNA VALIKUTENIMEKIRI, kooskõlalisus\"\nmsgstr \"INTENT, DISTRICT CHOICES, consistency\"\n\n#: ../../07-kontrollimine.rst:113\nmsgid \"\"\n\"Tahteavalduses sisalduva valiku kontroll ringkonnapõhise valikute \"\n\"nimekirja suhtes. Kontroll õnnestub, kui tuvastatud valik on kättesaadav \"\n\"antud ringkonnas.\"\nmsgstr \"\"\n\"Checking the choice identified by the intent against the list of \"\n\"district-based choices. The check succeeds if the identified option is \"\n\"available in the given district.\"\n\n#: ../../07-kontrollimine.rst:121\nmsgid \"JUHUSLIKKUS\"\nmsgstr \"RANDOMNESS\"\n\n#: ../../07-kontrollimine.rst:123\nmsgid \"\"\n\"Olem moodustatakse valijarakenduses ning kasutatakse ka \"\n\"kontrollrakenduses. Olem esitatakse EHS spetsiifilises vormingus \"\n\"baidijadana ning peab olema ühilduv avaliku võtme parameetrite poolt \"\n\"määratud matemaatilise rühmaga.\"\nmsgstr \"\"\n\"The item is created in the voter application and is also used in the \"\n\"verification application. The element shall be presented in an EHS \"\n\"specific format as a byte string and shall be compatible with the \"\n\"mathematical group specified by the public key parameters.\"\n\n#: ../../07-kontrollimine.rst:130\nmsgid \"JUHUSLIKKUS, vormingu korrektsus\"\nmsgstr \"RANDOMNESS, correctness of formatting\"\n\n#: ../../07-kontrollimine.rst:132\nmsgid \"\"\n\"Juhuslikkuse vormingu korrektsuse kontroll käesoleva spetsifikatsiooni \"\n\"suhtes.\"\nmsgstr \"Randomness format correctness check against this specification.\"\n\n#: ../../07-kontrollimine.rst:137\nmsgid \"JUHUSLIKKUS, kooskõlalisus avaliku võtmega\"\nmsgstr \"RANDOMNESS, consistency with the public key\"\n\n#: ../../07-kontrollimine.rst:139\nmsgid \"\"\n\"Juhuslikkuse kooskõlalisuse kontroll avaliku võtmega. Kontroll õnnestub \"\n\"kui juhuslikkus on kasutatav skalaarina arvutusteks avaliku võtme \"\n\"parameetrite poolt määratud matemaatilises rühmas.\"\nmsgstr \"\"\n\"Randomness consistency check with public key. The check succeeds if the \"\n\"randomness can be used as a scalar for calculations in the mathematical \"\n\"group specified by the parameters of the public key.\"\n\n#: ../../07-kontrollimine.rst:147\nmsgid \"KRÜPTEERITUD SEDEL\"\nmsgstr \"ENCRYPTED BALLOT\"\n\n#: ../../07-kontrollimine.rst:149\nmsgid \"\"\n\"Olem moodustatakse valijarakenduses. Tegemist on EHS spetsiifilises \"\n\"vormingus DER-kodeeritud andmestruktuuriga, mille kontrollimise aluseks \"\n\"on EHS avalik võti, mis muuhulgas määratleb krüpteerimisel kasutatud \"\n\"matemaatilise rühma.\"\nmsgstr \"\"\n\"The item is formed in the voting application. It is a DER encoded data \"\n\"structure in a specific format of the EHS, which is verified by the EHS \"\n\"public key, which, among other things, defines the mathematical group \"\n\"used for encryption.\"\n\n#: ../../07-kontrollimine.rst:156\nmsgid \"KRÜPTEERITUD SEDEL, vormingu korrektsus\"\nmsgstr \"ENCRYPTED BALLOT, format correctness\"\n\n#: ../../07-kontrollimine.rst:158\nmsgid \"\"\n\"Krüpteeritud sedeli vormingu korrektsuse kontroll käesoleva \"\n\"spetsifikatsiooni suhtes.\"\nmsgstr \"Verification of the encrypted ballot format against this specification.\"\n\n#: ../../07-kontrollimine.rst:164\nmsgid \"KRÜPTEERITUD SEDEL, kooskõlalisus avaliku võtmega\"\nmsgstr \"ENCRYPTED BALLOT, consistency with public key\"\n\n#: ../../07-kontrollimine.rst:166\nmsgid \"\"\n\"Krüpteeritud sedeli kooskõlalisuse kontroll avaliku võtmega. Kontroll \"\n\"õnnestub kui krüpteeritud sedeli komponendid on kasutatavad rühma \"\n\"liikmetena arvutusteks avaliku võtme parameetrite poolt määratud \"\n\"matemaatilises rühmas.\"\nmsgstr \"\"\n\"Checking the consistency of an encrypted ballot with a public key. The \"\n\"check succeeds if the components of the encrypted ballot are usable as \"\n\"members of a group for computations in the mathematical group specified \"\n\"by the public key parameters.\"\n\n#: ../../07-kontrollimine.rst:173\nmsgid \"KRÜPTEERITUD SEDEL, JUHUSLIKKUS, kooskõlalisus\"\nmsgstr \"ENCRYPTED BALLOT, RANDOMNESS, consistency\"\n\n#: ../../07-kontrollimine.rst:175\nmsgid \"\"\n\"Krüpteeritud sedeli kooskõlalisuse kontroll juhuslikkusega lähtudes rühma\"\n\" parameetritest. Kontroll õnnestub kui õnnestub näidata, et antud \"\n\"juhuslikkust on kasutatud krüpteeritud sedeli komponendi `uBlind` \"\n\"arvutamiseks antud rühma parameetrite järgi.\"\nmsgstr \"\"\n\"Checking the consistency of an encrypted ballot with randomness based on \"\n\"group parameters. A check succeeds if it can be shown that the given \"\n\"randomness has been used to compute the `uBlind` component of the \"\n\"ciphertext from the given group parameters.\"\n\n#: ../../07-kontrollimine.rst:185\nmsgid \"VALIJA SERTIFIKAAT\"\nmsgstr \"VOTER CERTIFICATE\"\n\n#: ../../07-kontrollimine.rst:187\nmsgid \"\"\n\"Olem on valijale omistatud süsteemiväliselt. Tegemist on X.509 vormingus \"\n\"sertifikaadiga, mille kehtivuse kontrolli aluseks on samasse avaliku \"\n\"võtme infrastruktuuri kuuluvad juursertifikaadid ja \"\n\"kehtivuskinnitusteenuse osutaja.\"\nmsgstr \"\"\n\"The item is assigned to the voter externally. It is an X.509 format \"\n\"certificate whose validity is checked by the root certificates and the \"\n\"validation service provider, which are part of the same public key \"\n\"infrastructure.\"\n\n#: ../../07-kontrollimine.rst:194\nmsgid \"VALIJA SERTIFIKAAT, vormingu korrektsus\"\nmsgstr \"VOTER CERTIFICATE, correct formatting\"\n\n#: ../../07-kontrollimine.rst:196\nmsgid \"\"\n\"Valija sertifikaadi vormingu korrektsuse kontroll lähtudes X.509 \"\n\"spetsifikatsioonist.\"\nmsgstr \"\"\n\"Verification of the correctness of the format of the voter certificate \"\n\"based on the X.509 specification.\"\n\n#: ../../07-kontrollimine.rst:201\nmsgid \"VALIJA SERTIFIKAAT, protokollikohane kooskõlalisus valimise seadistustega\"\nmsgstr \"VOTER CERTIFICATE, protocol consistency with election settings\"\n\n#: ../../07-kontrollimine.rst:203\nmsgid \"\"\n\"Valija sertifikaadi protokollikohase kooskõlalisuse kontroll valimise \"\n\"seadistustega. Kontroll õnnestub kui:\"\nmsgstr \"\"\n\"Checking the conformance of the voter certificate with the election \"\n\"settings. The check succeeds if:\"\n\n#: ../../07-kontrollimine.rst:206\nmsgid \"\"\n\"Valija sertifikaat on kehtiv lähtudes sertifikaadis sisalduvast \"\n\"kehtivusajast;\"\nmsgstr \"\"\n\"The voter's certificate is valid for the period of validity contained in \"\n\"the certificate;\"\n\n#: ../../07-kontrollimine.rst:208\nmsgid \"\"\n\"Valija sertifikaat kuulub mõnda valimise seadistustes kirjeldatud \"\n\"sertifitseerimishierarhiatest.\"\nmsgstr \"\"\n\"The voter certificate belongs to one of the certification hierarchies \"\n\"described in the election settings.\"\n\n#: ../../07-kontrollimine.rst:215\nmsgid \"\"\n\"VALIJA SERTIFIKAAT, KEHTIVUSKINNITUS, protokollikohane kooskõlalisus \"\n\"valimise seadistustega\"\nmsgstr \"\"\n\"VOTER CERTIFICATE, CERTIFICATE VALIDITY PROOF, protocol compliance with \"\n\"the election settings.\"\n\n#: ../../07-kontrollimine.rst:217\nmsgid \"\"\n\"Valija sertifikaadi ja kehtivuskinnituse protokollikohase kooskõlalisuse \"\n\"kontroll valimise seadistustega. Kontroll õnnestub kui:\"\nmsgstr \"\"\n\"Checking that the voter certificate and the certificate validity proof \"\n\"are in accordance with the protocol and in line with the election \"\n\"settings. The check succeeds if:\"\n\n#: ../../07-kontrollimine.rst:220\nmsgid \"\"\n\"Kehtivuskinnitus on korrektselt allkirjastatud kehtivuskinnituse teenuse \"\n\"osutaja poolt, kellel on seadistuste kohaselt voli valija sertifikaadi \"\n\"kehtivust tõendada\"\nmsgstr \"\"\n\"A certificate validity proof is correctly signed by validation service \"\n\"provider who has the power, according to the settings, to verify the \"\n\"validity of the voter's certificate.\"\n\n#: ../../07-kontrollimine.rst:224\nmsgid \"Kehtivuskinnitus on väljastatud valija sertifikaadi kohta;\"\nmsgstr \"A validation certificate is issued for a voter certificate;\"\n\n#: ../../07-kontrollimine.rst:226\nmsgid \"Kehtivuskinnitus näitab valija sertifikaadi OCSP olekuks 'Kehtiv'.\"\nmsgstr \"\"\n\"The validity confirmation indicates the OCSP status of the voter's \"\n\"certificate as 'Valid'.\"\n\n#: ../../07-kontrollimine.rst:233\nmsgid \"VALIJA IDENTITEET\"\nmsgstr \"VOTER IDENTITY\"\n\n#: ../../07-kontrollimine.rst:235\nmsgid \"\"\n\"Olem on valijale omistatud süsteemiväliselt. Tegemist on isikukoodiga, \"\n\"mille kontrollimise aluseks on VALIJA SERTIFIKAAT.\"\nmsgstr \"\"\n\"The item is assigned to the voter externally. It is a personal \"\n\"identification code, which is verified by the VOTER CERTIFICATE.\"\n\n#: ../../07-kontrollimine.rst:241\nmsgid \"VALIJA IDENTITEET, vormingu korrektsus\"\nmsgstr \"VOTER IDENTITY, correctness of formatting\"\n\n#: ../../07-kontrollimine.rst:243\nmsgid \"\"\n\"Valija identiteedi vormingu korrektsuse kontroll lähtudes Eesti Vabariigi\"\n\" isikukoodi vormingust.\"\nmsgstr \"\"\n\"Verification of the correctness of the format of the voter's identity \"\n\"based on the format of the personal identity code of the Republic of \"\n\"Estonia.\"\n\n#: ../../07-kontrollimine.rst:249\nmsgid \"VALIJA IDENTITEET, NIMEKIRJATUNNUS, hääleõigus\"\nmsgstr \"VOTER IDENTITY, DISTRICT ID, eligibility\"\n\n#: ../../07-kontrollimine.rst:251\nmsgid \"\"\n\"Hääleõiguse kontroll valija identiteedi ja nimekirjatunnuse alusel. \"\n\"Kontroll õnnestub, kui valija identiteet on kantud nimekirjatunnusele \"\n\"vastavasse valijate nimekirja. Sellisel juhul on identiteedile omistatud \"\n\"ka ringkonnatunnus, mis määrab ringkonnaspetsiifilise valikute nimekirja.\"\nmsgstr \"\"\n\"Verification of the right to vote based on voter identity and district \"\n\"id. The check is successful if the voter's identity is entered in the \"\n\"electoral roll corresponding to the district id. In this case, the \"\n\"identity is also assigned a precinct identifier, which determines the \"\n\"precinct-specific list of choices.\"\n\n#: ../../07-kontrollimine.rst:260\nmsgid \"HÄÄLE SIGNATUUR\"\nmsgstr \"VOTE SIGNATURE\"\n\n#: ../../07-kontrollimine.rst:262\nmsgid \"\"\n\"Olem arvutatakse allkirjastamise vahendi poolt lähtudes valijarakenduse \"\n\"poolt sisendiks antud KRÜPTEERITUD SEDELI räsist.\"\nmsgstr \"\"\n\"The element is calculated by the signing tool on the basis of the \"\n\"ENCRYPTED BALLOT given as input by the voter application.\"\n\n#: ../../07-kontrollimine.rst:268\nmsgid \"HÄÄLE SIGNATUUR, vormingu korrektsus\"\nmsgstr \"VOTE SIGNATURE, correctness of the format\"\n\n#: ../../07-kontrollimine.rst:270\nmsgid \"\"\n\"Hääle signatuuri vormingu korrektsuse kontroll lähtudes konkreetsest \"\n\"signeerimismeetodist.\"\nmsgstr \"\"\n\"Verification of the correctness of the vote signature format based on a \"\n\"specific signing method.\"\n\n#: ../../07-kontrollimine.rst:276\nmsgid \"HÄÄLE SIGNATUUR, KRÜPTEERITUD SEDEL, VALIJA SERTIFIKAAT, kooskõlalisus\"\nmsgstr \"VOTE SIGNATURE, ENCRYPTED BALLOT, VOTER CERTIFICATE, consistency\"\n\n#: ../../07-kontrollimine.rst:278\nmsgid \"\"\n\"Kontroll, mis õnnestub siis ja ainult siis kui õnnestub verifitseerida, \"\n\"et hääle signatuur on arvutatud krüpteeritud sedeli räsist kasutades \"\n\"valija sertifikaadis leiduvale avalikule võtmele vastavat privaatvõtit.\"\nmsgstr \"\"\n\"A check that succeeds if and only if it can be verified that the \"\n\"signature of the vote is computed from a hash of the encrypted ciphertext\"\n\" using the private key corresponding to the public key in the voter's \"\n\"certificate.\"\n\n#: ../../07-kontrollimine.rst:286\nmsgid \"HÄÄLE ALLKIRI\"\nmsgstr \"SIGNED VOTE\"\n\n#: ../../07-kontrollimine.rst:288\nmsgid \"\"\n\"Olem moodustatakse valijarakenduses, talletades hääle signatuuri allkirja\"\n\" vormingusse.\"\nmsgstr \"\"\n\"An item is formed in the voter application by storing the signature of \"\n\"the vote in a signature format.\"\n\n#: ../../07-kontrollimine.rst:293\nmsgid \"HÄÄLE ALLKIRI, vormingu korrektsus\"\nmsgstr \"SIGNED VOTE, correct formatting\"\n\n#: ../../07-kontrollimine.rst:295\nmsgid \"\"\n\"Hääle allkirja vormingu korrektsuse kontroll käesoleva spetsifikatsiooni \"\n\"suhtes.\"\nmsgstr \"\"\n\"Verification of the correctness of the signed vote format against this \"\n\"specification.\"\n\n#: ../../07-kontrollimine.rst:300\nmsgid \"HÄÄLE ALLKIRI, HÄÄLE SIGNATUUR, kooskõlalisus\"\nmsgstr \"SIGNED VOTE, VOTE SIGNATURE, consistency\"\n\n#: ../../07-kontrollimine.rst:302\nmsgid \"\"\n\"Hääle allkirja ja hääle signatuuri kooskõlalisuse kontroll. Kontroll \"\n\"õnnestub, kui antud allkiri sisaldab antud signatuuri.\"\nmsgstr \"\"\n\"Verification of the consistency of the signed vote and the vote \"\n\"signature. The check succeeds if the signed vote contains the given \"\n\"signature.\"\n\n#: ../../07-kontrollimine.rst:309\nmsgid \"HÄÄLE KONTEINER\"\nmsgstr \"VOTE CONTAINER\"\n\n#: ../../07-kontrollimine.rst:311\nmsgid \"\"\n\"Olem moodustatakse valijarakenduses, luues vormingukohane konteiner, mis \"\n\"sisaldab muuhulgas krüpteeritud sedelit, hääle allkirja ja valija \"\n\"sertifikaati.\"\nmsgstr \"\"\n\"The item is formed in the voter application by creating a formatted \"\n\"container containing, among other things, the encrypted ballot, the \"\n\"voter's signature and the voter's certificate.\"\n\n#: ../../07-kontrollimine.rst:317\nmsgid \"HÄÄLE KONTEINER, vormingu korrektsus\"\nmsgstr \"VOTE CONTAINER, format correctness\"\n\n#: ../../07-kontrollimine.rst:319\nmsgid \"\"\n\"Hääle konteineri vormingu korrektsuse kontroll käesoleva \"\n\"spetsifikatsiooni suhtes.\"\nmsgstr \"\"\n\"Verification of the correctness of the vote container format with respect\"\n\" to this specification.\"\n\n#: ../../07-kontrollimine.rst:324\nmsgid \"\"\n\"HÄÄLE KONTEINER, HÄÄLE ALLKIRI, VALIJA SERTIFIKAAT, KRÜPTEERITUD SEDEL, \"\n\"kooskõlalisus\"\nmsgstr \"\"\n\"VOTE CONTAINER, SIGNED VOTE, VOTER CERTIFICATE, ENCRPYPTED BALLOT, \"\n\"consistency\"\n\n#: ../../07-kontrollimine.rst:326\nmsgid \"\"\n\"Hääle konteineri, hääle allkirja, valija sertifikaadi ja krüpteeritud \"\n\"sedeli kooskõlalisuse kontroll. Kontroll õnnestub kui antud konteiner \"\n\"sisaldab konkreetset hääle allkirja, valija sertifikaati ja krüpteeritud \"\n\"sedelit.\"\nmsgstr \"\"\n\"Verification of the consistency of the vote container, the signed vote, \"\n\"the voter certificate and the encrypted ballot. The check succeeds if the\"\n\" given container contains a specific vote signature, voter certificate \"\n\"and encrypted ballot.\"\n\n#: ../../07-kontrollimine.rst:334\nmsgid \"KEHTIVUSKINNITUS\"\nmsgstr \"CERTIFICATE VALIDITY PROOF\"\n\n#: ../../07-kontrollimine.rst:336\nmsgid \"\"\n\"Olemi hankimise eest vastutab kogumisteenus. Tegemist on OCSP vormingus \"\n\"kinnitusega valija sertifikaadi oleku kohta.\"\nmsgstr \"\"\n\"The collection service is responsible for the procurement of the item. \"\n\"This is a confirmation of the status of the voter's certificate in OCSP \"\n\"format.\"\n\n#: ../../07-kontrollimine.rst:342\nmsgid \"KEHTIVUSKINNITUS, vormingu korrektsus\"\nmsgstr \"CERTIFICATE VALIDITY PROOF, correctness of the format\"\n\n#: ../../07-kontrollimine.rst:344\nmsgid \"\"\n\"Kehtivuskinnituse vormingu korrektsuse kontroll OCSP spetsifikatsiooni \"\n\"suhtes.\"\nmsgstr \"\"\n\"Validation of the correctness of the validation format against the OCSP \"\n\"specification.\"\n\n#: ../../07-kontrollimine.rst:350\nmsgid \"KEHTIVUSKINNITUS, AJATEMPEL, ajaline järgnevus\"\nmsgstr \"CERTIFICATE VALIDITY PROOF, TIMESTAMP, chronological sequence\"\n\n#: ../../07-kontrollimine.rst:352\nmsgid \"\"\n\"Kehtivuskinnituse ja ajatempli ajalise järgnevuse kontroll. Kontroll \"\n\"õnnestub, kui\"\nmsgstr \"\"\n\"Verification of the chronological sequence of the certificate validity \"\n\"proof and the timestamp. The check is successful if\"\n\n#: ../../07-kontrollimine.rst:354\nmsgid \"ajatempel ei ole väljastatud hiljem kui kehtivuskinnitus;\"\nmsgstr \"\"\n\"the time stamp is issued no later than the date of validity of the \"\n\"certificate validity proof;\"\n\n#: ../../07-kontrollimine.rst:356\nmsgid \"\"\n\"ajatempli ja kehtivuskinnituse väljastamise ajaline vahe on väiksem kui \"\n\"valimise seadistustes ette nähtud aeg.\"\nmsgstr \"\"\n\"the time difference between the issue of the timestamp and the \"\n\"certificate validity proof is less than determined in election settings.\"\n\n#: ../../07-kontrollimine.rst:364\nmsgid \"AJATEMPEL\"\nmsgstr \"TIMESTAMP\"\n\n#: ../../07-kontrollimine.rst:366\nmsgid \"\"\n\"Olemi hankimise eest vastutab kogumisteenus. Tegemist on PKIX vormingus \"\n\"ajatempliga.\"\nmsgstr \"\"\n\"The collection service is responsible for the procurement of the item. \"\n\"This is a timestamp in PKIX format.\"\n\n#: ../../07-kontrollimine.rst:371\nmsgid \"AJATEMPEL, vormingu korrektsus\"\nmsgstr \"TIMESTAMP, correctness of formatting\"\n\n#: ../../07-kontrollimine.rst:373\nmsgid \"Ajatempli vormingu korrektsuse kontroll PKIX spetsifikatsiooni suhtes.\"\nmsgstr \"\"\n\"Checking the correctness of the timestamp format against the PKIX \"\n\"specification.\"\n\n#: ../../07-kontrollimine.rst:379\nmsgid \"\"\n\"AJATEMPEL, HÄÄLE ALLKIRI, protokollikohane kooskõlalisus valimise \"\n\"seadistustega\"\nmsgstr \"TIMESTAMP, VOTE SIGNATURE, protocol consistency with election settings\"\n\n#: ../../07-kontrollimine.rst:381\nmsgid \"\"\n\"Ajatempli protokollikohase kooskõlalisuse kontroll valimise \"\n\"seadistustega. Kontroll õnnestub kui:\"\nmsgstr \"\"\n\"Checking the timestamp protocol consistency with the election settings. \"\n\"The check succeeds if:\"\n\n#: ../../07-kontrollimine.rst:384\nmsgid \"\"\n\"ajatempel on korrektselt allkirjastatud valimise seadistuses volitatud \"\n\"ajatempliteenuse osutaja poolt;\"\nmsgstr \"\"\n\"the timestamp is correctly signed by the provider authorized in the \"\n\"election settings\"\n\n#: ../../07-kontrollimine.rst:387\nmsgid \"ajatempel on võetud hääle allkirjale.\"\nmsgstr \"The timestamp has been taken to the signature of the vote.\"\n\n#: ../../07-kontrollimine.rst:393\nmsgid \"REGISTREERIMISPÄRING\"\nmsgstr \"REGISTRATION REQUEST\"\n\n#: ../../07-kontrollimine.rst:395 ../../07-kontrollimine.rst:443\nmsgid \"\"\n\"Olem moodustatakse kogumisteenuses. Olemi talletamise eest vastutab \"\n\"registreerimisteenuse osutaja.\"\nmsgstr \"\"\n\"The item is formed in the collection service. The storage of the item is \"\n\"the responsibility of the registration service provider.\"\n\n#: ../../07-kontrollimine.rst:401\nmsgid \"REGISTREERIMISPÄRING, vormingu korrektsus\"\nmsgstr \"REGISTRATION REQUEST, correctness of format\"\n\n#: ../../07-kontrollimine.rst:403\nmsgid \"\"\n\"Registreerimispäringu vormingu korrektsuse kontroll käesoleva \"\n\"spetsifikatsiooni suhtes.\"\nmsgstr \"\"\n\"Verification of the correctness of the registration request format \"\n\"against this specification.\"\n\n#: ../../07-kontrollimine.rst:409\nmsgid \"\"\n\"REGISTREERIMISPÄRING, HÄÄLE ALLKIRI, protokollikohane kooskõlalisus \"\n\"valimise seadistustega\"\nmsgstr \"\"\n\"REGISTRATION REQUEST, VOTE SIGNATURE, protocol consistency with election \"\n\"settings\"\n\n#: ../../07-kontrollimine.rst:411\nmsgid \"\"\n\"Registreerimispäringu ja hääle allkirja protokollikohase kooskõlalisuse \"\n\"kontroll valimise seadistustega. Kontroll õnnestub kui:\"\nmsgstr \"\"\n\"Verification of the consistency of the registration request and the vote \"\n\"signature with the protocol settings for the election. The check succeeds\"\n\" if:\"\n\n#: ../../07-kontrollimine.rst:414\nmsgid \"Registreerimispäring on koostatud hääle allkirjale;\"\nmsgstr \"\"\n\"The registration request is drawn up on the basis of the signature of the\"\n\" vote;\"\n\n#: ../../07-kontrollimine.rst:416 ../../07-kontrollimine.rst:428\n#: ../../07-kontrollimine.rst:465\nmsgid \"\"\n\"Registreerimispäring on korrektselt allkirjastatud valimise seadistuses \"\n\"viidatud kogumisteenuse poolt.\"\nmsgstr \"\"\n\"The registration request has been correctly signed by the collection \"\n\"service shown in the election settings.\"\n\n#: ../../07-kontrollimine.rst:423\nmsgid \"REGISTREERIMISPÄRING, REGISTREERIMISTÕEND, kooskõlalisus\"\nmsgstr \"REGISTRATION REQUEST, REGISTRATION CERTIFICATE, consistency\"\n\n#: ../../07-kontrollimine.rst:425\nmsgid \"\"\n\"Registreerimispäringu ja registreerimistõendi protokollikohase \"\n\"kooskõlalisuse kontroll valimise seadistustega. Kontroll õnnestub kui:\"\nmsgstr \"\"\n\"Verification of the consistency of the registration request and the \"\n\"registration certificate with the protocol election settings. The check \"\n\"succeeds if:\"\n\n#: ../../07-kontrollimine.rst:431\nmsgid \"Registreerimistõend on koostatud vastuseks samale registreerimispäringule;\"\nmsgstr \"\"\n\"The registration certificate is issued in response to the same \"\n\"registration request;\"\n\n#: ../../07-kontrollimine.rst:433 ../../07-kontrollimine.rst:499\nmsgid \"\"\n\"Registreerimistõend on korrektselt allkirjastatud valimise seadistuses \"\n\"viidatud registreerimisteenuse poolt.\"\nmsgstr \"\"\n\"The certificate of registration is correctly signed by the service \"\n\"provider defined in the election settings.\"\n\n#: ../../07-kontrollimine.rst:441\nmsgid \"REGISTREERIMISPÄRINGU KONTEINER\"\nmsgstr \"REGISTRATION REQUEST CONTAINER\"\n\n#: ../../07-kontrollimine.rst:449\nmsgid \"REGISTREERIMISPÄRINGU KONTEINER, vormingu korrektsus\"\nmsgstr \"REGISTRATION REQUEST CONTAINER, correctness of format\"\n\n#: ../../07-kontrollimine.rst:451\nmsgid \"\"\n\"Registreerimispäringu konteineri vormingu korrektsuse kontroll käesoleva \"\n\"spetsifikatsiooni suhtes.\"\nmsgstr \"\"\n\"Verification of the correctness of the registration request container \"\n\"format with respect to this specification.\"\n\n#: ../../07-kontrollimine.rst:458\nmsgid \"\"\n\"REGISTREERIMISPÄRINGU KONTEINER, REGISTREERIMISPÄRING, protokollikohane \"\n\"kooskõlalisus valimise seadistustega\"\nmsgstr \"\"\n\"REGISTRATION REQUEST CONTAINER, REGISTRATION REQUEST, protocol \"\n\"consistency with election settings\"\n\n#: ../../07-kontrollimine.rst:460\nmsgid \"\"\n\"Registreerimispäringu konteineri ja registreerimispäringu \"\n\"protokollikohase kooskõlalisuse kontroll valimise seadistustega. Kontroll\"\n\" õnnestub kui:\"\nmsgstr \"\"\n\"Check the consistency of the registration request container and the \"\n\"registration request protocol with the election settings. The check \"\n\"succeeds if:\"\n\n#: ../../07-kontrollimine.rst:463\nmsgid \"Registreerimispäringu konteiner sisaldab registreerimispäringut;\"\nmsgstr \"The registration request container contains the registration request;\"\n\n#: ../../07-kontrollimine.rst:473\nmsgid \"REGISTREERIMISTÕEND\"\nmsgstr \"REGISTRATION CERTIFICATE\"\n\n#: ../../07-kontrollimine.rst:475\nmsgid \"\"\n\"Olemi hankimise eest vastutab kogumisteenus, olemi moodustab \"\n\"registreerimisteenuse osutaja.\"\nmsgstr \"\"\n\"The collection service is responsible for the procurement of the item, \"\n\"the item is formed by the registration service provider.\"\n\n#: ../../07-kontrollimine.rst:481\nmsgid \"REGISTREERIMISTÕEND, vormingu korrektsus\"\nmsgstr \"REGISTRATION CERTIFICATE, correctness of format\"\n\n#: ../../07-kontrollimine.rst:483\nmsgid \"\"\n\"Registreerimistõendi vormingu korrektsuse kontroll käesoleva \"\n\"spetsifikatsiooni suhtes.\"\nmsgstr \"\"\n\"Verification of the correctness of the format of the registration \"\n\"certificate against this specification.\"\n\n#: ../../07-kontrollimine.rst:489\nmsgid \"\"\n\"REGISTREERIMISTÕEND, HÄÄLE ALLKIRI, protokollikohane kooskõlalisus \"\n\"valimise seadistustega\"\nmsgstr \"\"\n\"REGISTRATION CERTIFICATE, VOTE SIGNATURE, protocol consistency with \"\n\"election settings\"\n\n#: ../../07-kontrollimine.rst:491\nmsgid \"\"\n\"Registreerimistõendi ja hääle allkirja protokollikohase kooskõlalisuse \"\n\"kontroll valimise seadistustega. Kontroll õnnestub kui:\"\nmsgstr \"\"\n\"Verification of the consistency of the certificate of registration and \"\n\"the signature of the vote with the protocol settings for the election. \"\n\"The check succeeds if:\"\n\n#: ../../07-kontrollimine.rst:494\nmsgid \"Registreerimistõend on koostatud hääle allkirjale;\"\nmsgstr \"The registration certificate is drawn up on the signature of the vote;\"\n\n#: ../../07-kontrollimine.rst:496\nmsgid \"\"\n\"Registreerimistõend sisaldab kogumisteenuse poolt korrektselt \"\n\"allkirjastatud registreerimispäringut;\"\nmsgstr \"\"\n\"The registration certificate shall contain the following information, \"\n\"duly completed by the collection service.\"\n\n#: ../../07-kontrollimine.rst:507\nmsgid \"NIMEKIRJATUNNUS\"\nmsgstr \"LIST IDENTIFIER\"\n\n#: ../../07-kontrollimine.rst:509\nmsgid \"\"\n\"Olem moodustatakse kogumisteenuses ning identifitseerib ühe konkreetse \"\n\"versiooni valijate nimekirjast.\"\nmsgstr \"\"\n\"An item is formed in the collection service and identifies one specific \"\n\"version of the voter list.\"\n\n#: ../../07-kontrollimine.rst:515\nmsgid \"NIMEKIRJATUNNUS, vormingu korrektsus\"\nmsgstr \"LIST IDENTIFIER, correctness of formatting\"\n\n#: ../../07-kontrollimine.rst:517\nmsgid \"\"\n\"Nimekirjatunnuse vormingu korrektsuse kontroll käesoleva \"\n\"spetsifikatsiooni suhtes.\"\nmsgstr \"\"\n\"Verification of the correctness of the list identifier format with \"\n\"respect to this specification.\"\n\n#: ../../07-kontrollimine.rst:522\nmsgid \"NIMEKIRJATUNNUS, protokollikohane kooskõlalisus valimise seadistusega\"\nmsgstr \"LIST IDENTIFIER, protocol consistency with the selection setting\"\n\n#: ../../07-kontrollimine.rst:524\nmsgid \"\"\n\"Nimekirjatunnuse protokollikohase kooskõlalisuse kontroll valimise \"\n\"seadistusega. Kontroll õnnestub kui valimise seadistuses sisalduvate \"\n\"muudatusnimekirjade alusel on võimalik koostada nimekirjatunnusele vastav\"\n\" nimekiri.\"\nmsgstr \"\"\n\"Checking the protocol consistency of the list identifier with the \"\n\"election setting. The check succeeds if the voter list updates contained \"\n\"in the election configuration can be used to generate a voterlist \"\n\"corresponding to the list identifier.\"\n\n#: ../../07-kontrollimine.rst:534\nmsgid \"MIKSITUD KRÜPTEERITUD SEDEL\"\nmsgstr \"MIXED ENCRYPTED BALLOT\"\n\n#: ../../07-kontrollimine.rst:536\nmsgid \"\"\n\"Olem moodustatakse miksimisrakenduses. Miksitud krüpteeritud sedel on \"\n\"sisuliselt krüpteeritud sedel ning rakenduvad samad kontrollid, mis \"\n\"krüpteeritud sedelilegi.\"\nmsgstr \"\"\n\"The element is formed in the mixing application. A mixed encrypted ballot\"\n\" is essentially an encrypted ballot and the same controls apply as for an\"\n\" encrypted ballot.\"\n\n#: ../../07-kontrollimine.rst:543\nmsgid \"MIKSITUD KRÜPTEERITUD SEDEL, vormingu korrektsus\"\nmsgstr \"MIXED ENCRYPTED BALLOT, format correctness\"\n\n#: ../../07-kontrollimine.rst:545\nmsgid \"\"\n\"Miksitud krüpteeritud sedeli vormingu korrektsuse kontroll käesoleva \"\n\"spetsifikatsiooni suhtes.\"\nmsgstr \"\"\n\"Verification of the correctness of the format of the mixed encrypted \"\n\"ballot with respect to this specification.\"\n\n#: ../../07-kontrollimine.rst:551\nmsgid \"MIKSITUD KRÜPTEERITUD SEDEL, kooskõlalisus avaliku võtmega\"\nmsgstr \"MIXED ENCRYPTED BALLOT, consistency with public key\"\n\n#: ../../07-kontrollimine.rst:553\nmsgid \"\"\n\"Miksitud krüpteeritud sedeli kooskõlalisuse kontroll avaliku võtmega. \"\n\"Kontroll õnnestub kui miksitud krüpteeritud sedeli komponendid on \"\n\"kasutatavad rühma liikmetena arvutusteks avaliku võtme parameetrite poolt\"\n\" määratud matemaatilises rühmas.\"\nmsgstr \"\"\n\"Checking the consistency of a mixed encrypted ballot with a public key. \"\n\"The check succeeds if the components of the mixed encrypted ballot are \"\n\"usable as members of a group for computations in the mathematical group \"\n\"specified by the public key parameters.\"\n\n#: ../../07-kontrollimine.rst:563\nmsgid \"RINGKONNATUNNUS\"\nmsgstr \"DISTRICT IDENTIFIER\"\n\n#: ../../07-kontrollimine.rst:565\nmsgid \"\"\n\"Olem moodustatakse töötlemisrakenduses ning viitab ringkonnapõhisele \"\n\"valikute nimekirjale.\"\nmsgstr \"\"\n\"The item is created in the processing application and refers to a \"\n\"district-based list of choices.\"\n\n#: ../../07-kontrollimine.rst:571\nmsgid \"RINGKONNATUNNUS, vormingu korrektsus\"\nmsgstr \"DISTRICT IDENTIFIER, correctness of formatting\"\n\n#: ../../07-kontrollimine.rst:573\nmsgid \"\"\n\"Ringkonnatunnuse vormingu korrektsuse kontroll käesoleva \"\n\"spetsifikatsiooni suhtes.\"\nmsgstr \"\"\n\"Verification of the correctness of the district identifier format with \"\n\"respect to this specification.\"\n\n#: ../../07-kontrollimine.rst:579\nmsgid \"RINGKONNAPÕHINE VALIKUTE NIMEKIRI\"\nmsgstr \"DISTRICT CHOICES\"\n\n#: ../../07-kontrollimine.rst:581\nmsgid \"Olem on valijale omistatud süsteemiväliselt.\"\nmsgstr \"The item is assigned to the voter externally.\"\n\n#: ../../07-kontrollimine.rst:586\nmsgid \"RINGKONNAPÕHINE VALIKUTE NIMEKIRI, vormingu korrektsus\"\nmsgstr \"DISTRICT CHOICES, format correctness\"\n\n#: ../../07-kontrollimine.rst:588\nmsgid \"\"\n\"Ringkonnapõhise valikute nimekirja vormingu korrektsuse kontroll VIS \"\n\"liideste spetsifikatsiooni suhtes.\"\nmsgstr \"\"\n\"Verification of the correctness of the format of the district-based list \"\n\"of choices against the VIS interface specification.\"\n\n#: ../../07-kontrollimine.rst:592\nmsgid \"Kontrollid kogumisteenuses\"\nmsgstr \"Checks in the Collection Service\"\n\n#: ../../07-kontrollimine.rst:594\nmsgid \"\"\n\"Kogumisteenus käsitleb talletatavat häält sõltumatult teistest häältest. \"\n\"Kogumisteenuse ülesandeks on hääle talletamine kogu hääletamisperioodi \"\n\"vältel ja häälele töötlemise käigus kvalifitseerumiseks vajalike \"\n\"elementide hankimine.\"\nmsgstr \"\"\n\"The collection service treats the vote to be stored independently of \"\n\"other votes. The role of the collection service is to store votes \"\n\"throughout the voting period and to obtain the elements necessary to \"\n\"qualify a vote during the processing.\"\n\n#: ../../07-kontrollimine.rst:598\nmsgid \"Kogumisteenus saab valijarakenduselt järgmised olemid:\"\nmsgstr \"A collection service receives following items from the voter application:\"\n\n#: ../../07-kontrollimine.rst:600 ../../07-kontrollimine.rst:712\n#: ../../07-kontrollimine.rst:819 ../../07-kontrollimine.rst:898\n#: ../../07-kontrollimine.rst:1013 ../../07-kontrollimine.rst:1086\nmsgid \":ref:`entity-krypteeritud-sedel`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:602 ../../07-kontrollimine.rst:720\n#: ../../07-kontrollimine.rst:750 ../../07-kontrollimine.rst:821\n#: ../../07-kontrollimine.rst:900 ../../07-kontrollimine.rst:1027\n#: ../../07-kontrollimine.rst:1088\nmsgid \":ref:`entity-valija-sertifikaat`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:604 ../../07-kontrollimine.rst:722\n#: ../../07-kontrollimine.rst:751 ../../07-kontrollimine.rst:823\n#: ../../07-kontrollimine.rst:902 ../../07-kontrollimine.rst:1029\n#: ../../07-kontrollimine.rst:1090\nmsgid \":ref:`entity-valija-identiteet`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:606 ../../07-kontrollimine.rst:726\n#: ../../07-kontrollimine.rst:825 ../../07-kontrollimine.rst:904\n#: ../../07-kontrollimine.rst:1031 ../../07-kontrollimine.rst:1092\nmsgid \":ref:`entity-haale-signatuur`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:608 ../../07-kontrollimine.rst:714\n#: ../../07-kontrollimine.rst:827 ../../07-kontrollimine.rst:906\n#: ../../07-kontrollimine.rst:1033 ../../07-kontrollimine.rst:1094\nmsgid \":ref:`entity-haale-allkiri`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:610 ../../07-kontrollimine.rst:716\n#: ../../07-kontrollimine.rst:829 ../../07-kontrollimine.rst:908\n#: ../../07-kontrollimine.rst:1035 ../../07-kontrollimine.rst:1096\nmsgid \":ref:`entity-haale-konteiner`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:612\nmsgid \"\"\n\"Kogumisteenus hangib hääle töötlemise käigus välistelt teenustelt \"\n\"järgmised olemid:\"\nmsgstr \"\"\n\"In the course of vote processing, the Collection Service obtains the \"\n\"following entities from external services:\"\n\n#: ../../07-kontrollimine.rst:614 ../../07-kontrollimine.rst:728\n#: ../../07-kontrollimine.rst:779 ../../07-kontrollimine.rst:831\n#: ../../07-kontrollimine.rst:910 ../../07-kontrollimine.rst:1037\n#: ../../07-kontrollimine.rst:1098\nmsgid \":ref:`entity-kehtivuskinnitus`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:616 ../../07-kontrollimine.rst:730\n#: ../../07-kontrollimine.rst:780 ../../07-kontrollimine.rst:833\n#: ../../07-kontrollimine.rst:912 ../../07-kontrollimine.rst:1039\n#: ../../07-kontrollimine.rst:1100\nmsgid \":ref:`entity-ajatempel`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:618 ../../07-kontrollimine.rst:732\n#: ../../07-kontrollimine.rst:781 ../../07-kontrollimine.rst:835\n#: ../../07-kontrollimine.rst:918 ../../07-kontrollimine.rst:1045\n#: ../../07-kontrollimine.rst:1106\nmsgid \":ref:`entity-registreerimistoend`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:620\nmsgid \"Kogumisteenus tuvastab / loob ise järgmised olemid:\"\nmsgstr \"The collection service detects/creates the following entities:\"\n\n#: ../../07-kontrollimine.rst:622 ../../07-kontrollimine.rst:734\n#: ../../07-kontrollimine.rst:782 ../../07-kontrollimine.rst:837\n#: ../../07-kontrollimine.rst:914 ../../07-kontrollimine.rst:1041\n#: ../../07-kontrollimine.rst:1102\nmsgid \":ref:`entity-registreerimisparing`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:624 ../../07-kontrollimine.rst:738\n#: ../../07-kontrollimine.rst:843 ../../07-kontrollimine.rst:916\n#: ../../07-kontrollimine.rst:1043 ../../07-kontrollimine.rst:1104\nmsgid \":ref:`entity-registreerimisparing-konteiner`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:626 ../../07-kontrollimine.rst:740\n#: ../../07-kontrollimine.rst:845 ../../07-kontrollimine.rst:920\n#: ../../07-kontrollimine.rst:1047 ../../07-kontrollimine.rst:1108\nmsgid \":ref:`entity-nimekirjatunnus`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:628 ../../07-kontrollimine.rst:742\n#: ../../07-kontrollimine.rst:847 ../../07-kontrollimine.rst:926\n#: ../../07-kontrollimine.rst:1015 ../../07-kontrollimine.rst:1074\nmsgid \":ref:`entity-ringkonnatunnus`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:630 ../../07-kontrollimine.rst:724\n#: ../../07-kontrollimine.rst:839 ../../07-kontrollimine.rst:922\n#: ../../07-kontrollimine.rst:1049 ../../07-kontrollimine.rst:1076\nmsgid \":ref:`entity-ringkonna-valikutenimekiri`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:632\nmsgid \"Kogumisteenus ei puutu vahetult kokku järgmiste olemitega:\"\nmsgstr \"The collection service does not come into direct contact with:\"\n\n#: ../../07-kontrollimine.rst:634 ../../07-kontrollimine.rst:708\n#: ../../07-kontrollimine.rst:813 ../../07-kontrollimine.rst:933\n#: ../../07-kontrollimine.rst:1023 ../../07-kontrollimine.rst:1080\nmsgid \":ref:`entity-tahteavaldus`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:636 ../../07-kontrollimine.rst:710\n#: ../../07-kontrollimine.rst:817 ../../07-kontrollimine.rst:935\n#: ../../07-kontrollimine.rst:1025 ../../07-kontrollimine.rst:1084\nmsgid \":ref:`entity-juhuslikkus`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:638 ../../07-kontrollimine.rst:744\n#: ../../07-kontrollimine.rst:849 ../../07-kontrollimine.rst:931\n#: ../../07-kontrollimine.rst:1019 ../../07-kontrollimine.rst:1072\nmsgid \":ref:`entity-miksitud-krypteeritud-sedel`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:640\nmsgid \"\"\n\"Kogumisteenus viib läbi järgmised tegevused ja teostab järgmised \"\n\"kontrollid:\"\nmsgstr \"The collection service will carry out the following activities and checks:\"\n\n#: ../../07-kontrollimine.rst:642\nmsgid \"Hääle talletamise päringu vastuvõtmine valijarakenduselt\"\nmsgstr \"Receiving a vote storage request from a voter application\"\n\n#: ../../07-kontrollimine.rst:644 ../../07-kontrollimine.rst:753\n#: ../../07-kontrollimine.rst:853 ../../07-kontrollimine.rst:952\nmsgid \":ref:`check-valija-sertifikaat-correctness`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:645 ../../07-kontrollimine.rst:754\n#: ../../07-kontrollimine.rst:854 ../../07-kontrollimine.rst:953\nmsgid \":ref:`check-valija-sertifikaat-consistency-protocol-settings`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:646 ../../07-kontrollimine.rst:755\n#: ../../07-kontrollimine.rst:856 ../../07-kontrollimine.rst:954\nmsgid \":ref:`check-valija-identiteet-correctness`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:647 ../../07-kontrollimine.rst:957\nmsgid \":ref:`check-valija-identiteet-nimekirjatunnus-eligibility`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:648 ../../07-kontrollimine.rst:770\n#: ../../07-kontrollimine.rst:857 ../../07-kontrollimine.rst:959\nmsgid \":ref:`check-haale-signatuur-correctness`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:649 ../../07-kontrollimine.rst:771\n#: ../../07-kontrollimine.rst:858 ../../07-kontrollimine.rst:960\nmsgid \"\"\n\":ref:`check-haale-signatuur-krypteeritud-sedel-valija-sertifikaat-\"\n\"consistency`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:650 ../../07-kontrollimine.rst:859\n#: ../../07-kontrollimine.rst:961\nmsgid \":ref:`check-haale-allkiri-correctness`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:651 ../../07-kontrollimine.rst:860\n#: ../../07-kontrollimine.rst:962\nmsgid \":ref:`check-haale-allkiri-haale-signatuur-consistency`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:652 ../../07-kontrollimine.rst:861\n#: ../../07-kontrollimine.rst:963\nmsgid \":ref:`check-haale-konteiner-correctness`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:653 ../../07-kontrollimine.rst:862\n#: ../../07-kontrollimine.rst:964\nmsgid \"\"\n\":ref:`check-haale-konteiner-haale-allkiri-valija-sertifikaat-\"\n\"krypteeritud-sedel-consistency`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:654 ../../07-kontrollimine.rst:875\n#: ../../07-kontrollimine.rst:998 ../../07-kontrollimine.rst:1055\nmsgid \":ref:`check-krypteeritud-sedel-correctness`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:655 ../../07-kontrollimine.rst:876\n#: ../../07-kontrollimine.rst:999 ../../07-kontrollimine.rst:1056\nmsgid \":ref:`check-krypteeritud-sedel-public-key-consistency`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:657\nmsgid \"Kehtivuskinnituse hankimine - :ref:`entity-kehtivuskinnitus`\"\nmsgstr \"Obtaining certificate validation proof - :ref:`entity-kehtivuskinnitus`\"\n\n#: ../../07-kontrollimine.rst:659 ../../07-kontrollimine.rst:784\n#: ../../07-kontrollimine.rst:863 ../../07-kontrollimine.rst:965\nmsgid \":ref:`check-kehtivuskinnitus-correctness`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:660 ../../07-kontrollimine.rst:785\n#: ../../07-kontrollimine.rst:855 ../../07-kontrollimine.rst:966\nmsgid \":ref:`check-valija-sertifikaat-kehtivuskinnitus-consistency`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:662\nmsgid \"Ajatempli hankimine - :ref:`entity-ajatempel`\"\nmsgstr \"Getting a timestamp - :ref:`entity-ajatempel`\"\n\n#: ../../07-kontrollimine.rst:664 ../../07-kontrollimine.rst:786\n#: ../../07-kontrollimine.rst:864 ../../07-kontrollimine.rst:967\nmsgid \":ref:`check-ajatempel-correctness`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:665 ../../07-kontrollimine.rst:787\n#: ../../07-kontrollimine.rst:865 ../../07-kontrollimine.rst:968\nmsgid \":ref:`check-ajatempel-consistency-protocol-settings`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:667\nmsgid \"Registreerimispäringu loomine - :ref:`entity-registreerimisparing`\"\nmsgstr \"Creating a registration request - :ref:`entity-registreerimisparing`\"\n\n#: ../../07-kontrollimine.rst:669\nmsgid \"Registreerimistõendi hankimine - :ref:`entity-registreerimistoend`\"\nmsgstr \"Obtaining a registration certificate - :ref:`entity-registreerimistoend`\"\n\n#: ../../07-kontrollimine.rst:671 ../../07-kontrollimine.rst:792\n#: ../../07-kontrollimine.rst:869 ../../07-kontrollimine.rst:990\nmsgid \":ref:`check-registreerimisparing-registreerimistoend-consistency`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:672 ../../07-kontrollimine.rst:793\n#: ../../07-kontrollimine.rst:870 ../../07-kontrollimine.rst:970\nmsgid \":ref:`check-registreerimistoend-correctness`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:673 ../../07-kontrollimine.rst:794\n#: ../../07-kontrollimine.rst:871 ../../07-kontrollimine.rst:971\nmsgid \":ref:`check-registreerimistoend-haale-allkiri-consistency`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:674 ../../07-kontrollimine.rst:788\n#: ../../07-kontrollimine.rst:866 ../../07-kontrollimine.rst:969\nmsgid \":ref:`check-kehtivuskinnitus-ajatempel-order`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:676\nmsgid \"\"\n\"Hääle talletamine, kvalifitseerivate elementide ja unikaalse \"\n\"identifikaatori tagastamine valijarakendusele.\"\nmsgstr \"\"\n\"Vote storage, return of qualifiers and unique identifiers to the voting \"\n\"application.\"\n\n#: ../../07-kontrollimine.rst:680\nmsgid \"Kontrollid valijarakenduses\"\nmsgstr \"Checks in the Voting Application\"\n\n#: ../../07-kontrollimine.rst:682\nmsgid \"\"\n\"Valijarakendus moodustab valija avakujul tahteavalduse põhjal \"\n\"krüpteeritud sedeli ning allkirjastab selle valija allkirja andmise \"\n\"vahendiga.\"\nmsgstr \"\"\n\"The voting application forms an encrypted ballot based on the voter's \"\n\"plaintext intent and signs it using the voter's signature device.\"\n\n#: ../../07-kontrollimine.rst:685\nmsgid \"\"\n\"Valijarakenduse rolliks peale hääle allkirjastamist on veenduda, et \"\n\"kogumisteenus käitus häält kvalifitseerivate elementide võtmisel \"\n\"protokollikohaselt ning et hääl on talletatud selliselt, et ta saab \"\n\"töötlemisrakenduse poolt arvesse võetud.\"\nmsgstr \"\"\n\"The role of the voting application, after the vote has been signed, is to\"\n\" make sure that the collection service acted according to protocol in \"\n\"taking the elements that qualify the vote and that the vote has been \"\n\"stored in such a way that it can be taken into account by the processing \"\n\"application.\"\n\n#: ../../07-kontrollimine.rst:690\nmsgid \"Valijarakendus viib läbi minimaalselt järgmised kontrollid:\"\nmsgstr \"\"\n\"As a minimum, the following checks will be carried out by the voting \"\n\"application:\"\n\n#: ../../07-kontrollimine.rst:692\nmsgid \"\"\n\"Kogumisteenus võttis kehtivuskinnituse valija sertifikaadile volitatud \"\n\"kehtivuskinnitusteenuselt. Valijarakendus kontrollib allkirja \"\n\"kehtivuskinnitusteenuse vastusel.\"\nmsgstr \"\"\n\"The collection service validated the voter's certificate at the \"\n\"authorised validation service. The voting application verifies the \"\n\"signature in the validation service response.\"\n\n#: ../../07-kontrollimine.rst:696\nmsgid \"\"\n\"Kogumisteenus registreeris valija poolt allkirjastatud hääle volitatud \"\n\"registreerimisteenuses. Valijarakendus kontrollib, et kogumisteenuse \"\n\"poolt moodustatud päring oli kogumisteenuse poolt signeeritud ning viitas\"\n\" korrektselt allkirjastatud häälele. Valijarakendus kontrollib, et \"\n\"registreerimisteenuse vastus on allkirjastatud õige registreerimisteenuse\"\n\" osutaja poolt ning sisaldab kogumisteenuse poolt allkirjastatud \"\n\"päringut.\"\nmsgstr \"\"\n\"The collection service registered the vote signed by the voter in the \"\n\"authorised registration service. The Voting Application verifies that the\"\n\" request generated by the Collection Service was signed by the Collection\"\n\" Service and referred to a correctly signed vote. The Voting Application \"\n\"checks that the confirmation from the registration service is signed by \"\n\"the correct registration service provider and includes the request signed\"\n\" by the collection service.\"\n\n#: ../../07-kontrollimine.rst:703\nmsgid \"\"\n\"Kui hääle kvalifitseerimiseks vajalike elementide kontroll ei õnnestu, \"\n\"siis teavitab valijarakendus sellest kasutajat.\"\nmsgstr \"\"\n\"If the verification of the elements necessary to qualify a vote fails, \"\n\"the voting application will notify the user.\"\n\n#: ../../07-kontrollimine.rst:706\nmsgid \"Valijarakendus loob ise järgmised olemid:\"\nmsgstr \"The voting application itself creates the following entities:\"\n\n#: ../../07-kontrollimine.rst:718\nmsgid \"Valijarakendus saab järgmised olemid teistelt osapooltelt:\"\nmsgstr \"The voting application receives the following entities from other parties:\"\n\n#: ../../07-kontrollimine.rst:736\nmsgid \"Valijarakendus ei puutu vahetult kokku järgmiste olemitega:\"\nmsgstr \"The voting application does not come into direct contact with:\"\n\n#: ../../07-kontrollimine.rst:746\nmsgid \"\"\n\"Valijarakendus viib läbi järgmised tegevused ja teostab järgmised \"\n\"kontrollid:\"\nmsgstr \"The voting application performs the following actions and checks:\"\n\n#: ../../07-kontrollimine.rst:748\nmsgid \"eID vahendi aktiveerimine ja valija identiteedi tuvastamine\"\nmsgstr \"activation of the eID tool and identification of the voter's identity\"\n\n#: ../../07-kontrollimine.rst:757\nmsgid \"\"\n\"Ringkonnapõhise valikutenimekirja tuvastamine - :ref:`entity-ringkonna-\"\n\"valikutenimekiri`\"\nmsgstr \"district-based candidate list - :ref:`entity-ringkonna-valikutenimekiri`.\"\n\n#: ../../07-kontrollimine.rst:760\nmsgid \"Tahteavalduse moodustamine - :ref:`entity-tahteavaldus`\"\nmsgstr \"Formation of an intent - :ref:`entity-tahteavaldus`\"\n\n#: ../../07-kontrollimine.rst:762\nmsgid \"Juhuarvu genereerimine - :ref:`entity-juhuslikkus`\"\nmsgstr \"Random number generation - :ref:`entity-juhuslikkus`\"\n\n#: ../../07-kontrollimine.rst:764\nmsgid \"Sedeli krüpteerimine - :ref:`entity-krypteeritud-sedel`\"\nmsgstr \"Encrypting ballot - :ref:`entity-krypteeritud-sedel`\"\n\n#: ../../07-kontrollimine.rst:766\nmsgid \"Krüpteeritud sedeli signeerimine - :ref:`entity-haale-signatuur`\"\nmsgstr \"Signing an encrypted ballot - :ref:`entity-haale-signatuur`\"\n\n#: ../../07-kontrollimine.rst:768\nmsgid \"Allkirja moodustamine signatuurist - :ref:`entity-haale-allkiri`\"\nmsgstr \"Forming a signed vote from a signature - :ref:`entity-haale-allkiri`\"\n\n#: ../../07-kontrollimine.rst:773\nmsgid \"Allkirjastatud konteineri moodustamine - :ref:`entity-haale-konteiner`\"\nmsgstr \"Formation of a signed container - :ref:`entity-haale-konteiner`\"\n\n#: ../../07-kontrollimine.rst:775\nmsgid \"Allkirjastatud konteineri edastamine kogumisteenusele.\"\nmsgstr \"Forwarding the signed container to the collection service.\"\n\n#: ../../07-kontrollimine.rst:777\nmsgid \"Kogumisteenuse vastuse kontrollimine\"\nmsgstr \"Checking the collection service response\"\n\n#: ../../07-kontrollimine.rst:790 ../../07-kontrollimine.rst:867\n#: ../../07-kontrollimine.rst:976\nmsgid \":ref:`check-registreerimisparing-correctness`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:791 ../../07-kontrollimine.rst:868\n#: ../../07-kontrollimine.rst:989\nmsgid \":ref:`check-registreerimisparing-haale-allkiri-consistency`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:797\nmsgid \"Kontrollid kontrollrakenduses\"\nmsgstr \"Checks in the Verification Application\"\n\n#: ../../07-kontrollimine.rst:799\nmsgid \"\"\n\"Sarnaselt valijarakendusele on kontrollrakenduse rolliks peale hääle \"\n\"allkirjastamist veenduda, et kogumisteenus käitus häält kvalifitseerivate\"\n\" elementide võtmisel protokollikohaselt ning et hääl on talletatud \"\n\"selliselt, et ta saab töötlemisrakenduse poolt arvesse võetud.\"\nmsgstr \"\"\n\"Similar to the voter application, the role of the verification \"\n\"application, once the vote has been signed, is to verify that the \"\n\"collection service acted in a protocol-compliant manner in capturing the \"\n\"elements that qualify the vote and that the vote has been stored in such \"\n\"a way that it can be taken into account by the processing application.\"\n\n#: ../../07-kontrollimine.rst:804\nmsgid \"\"\n\"Täiendavalt on kontrollrakenduse ülesandeks anda valijale tagasisidet, \"\n\"kas tema tahteavaldus sai valijarakenduse poolt korrektselt hääleks \"\n\"vormistatud.\"\nmsgstr \"\"\n\"In addition, it is the responsibility of the verification application to \"\n\"provide feedback to the voter on whether their intent was correctly \"\n\"formatted as a vote by the voter application.\"\n\n#: ../../07-kontrollimine.rst:807\nmsgid \"\"\n\"Kui hääle kvalifitseerimiseks vajalike elementide kontroll ei õnnestu, \"\n\"siis teavitab kontrollrakendus sellest kasutajat. Tahteavalduse \"\n\"korrektsuses peab valija ise veenduma.\"\nmsgstr \"\"\n\"If the verification of the elements necessary to qualify the vote fails, \"\n\"the verification application will inform the user. It is up to the voter \"\n\"to verify the correctness of the intent.\"\n\n#: ../../07-kontrollimine.rst:811\nmsgid \"Kontrollrakendus tuvastab ise järgmised olemid:\"\nmsgstr \"The verification application itself detects the following entities:\"\n\n#: ../../07-kontrollimine.rst:815\nmsgid \"Kontrollrakendus saab järgmised olemid teistelt osapooltelt:\"\nmsgstr \"\"\n\"A verification application receives the following entities from other \"\n\"parties:\"\n\n#: ../../07-kontrollimine.rst:841\nmsgid \"Kontrollrakendus ei puutu vahetult kokku järgmiste olemitega:\"\nmsgstr \"The verification application does not directly interact with:\"\n\n#: ../../07-kontrollimine.rst:851\nmsgid \"\"\n\"Kontrollrakendus viib läbi järgmised tegevused ja teostab järgmised \"\n\"kontrollid:\"\nmsgstr \"\"\n\"The verification application will carry out the following activities and \"\n\"perform the following checks:\"\n\n#: ../../07-kontrollimine.rst:872\nmsgid \":ref:`check-ringkonna-valikutenimekiri-correctness`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:873\nmsgid \":ref:`check-juhuslikkus-correctness`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:874\nmsgid \":ref:`check-juhuslikkus-public-key-consistency`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:877\nmsgid \":ref:`check-krypteeritud-sedel-juhuslikkus-consistency`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:878 ../../07-kontrollimine.rst:1117\nmsgid \":ref:`check-tahteavaldus-correctness`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:879\nmsgid \":ref:`check-tahteavaldus-ringkonna-valikutenimekiri-consistency`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:882\nmsgid \"Kontrollid töötlemisrakenduses\"\nmsgstr \"Checks in the Processing Application\"\n\n#: ../../07-kontrollimine.rst:884\nmsgid \"\"\n\"Töötlemisrakenduse sisendiks on e-valimiskast ja registreerimisteenuse \"\n\"väljavõte registreerimispäringutest. Töötlemisrakendus kontrollib mõlema \"\n\"andmehulga elemente kõigepealt eraldi ning seejärel püüab luua vastavuse \"\n\"nende vahel.\"\nmsgstr \"\"\n\"The input to the processing application is the e-voting box and the \"\n\"registration service extract of registration requests. The processing \"\n\"application first checks the elements of both data sets separately and \"\n\"then tries to establish a correspondence between them.\"\n\n#: ../../07-kontrollimine.rst:889\nmsgid \"\"\n\"Töötlemisrakendus otsustab, milline valija häältest oli viimane ning \"\n\"liigub töötlemise järgmisesse etappi. S.t. üks häält kvalifitseerivatest \"\n\"elementidest täidab hääle talletamise aja fikseerimise rolli ning selle \"\n\"elemendi põhjal moodustatakse üksikute häälte ajaline järgnevus. \"\n\"Olenevalt IVXV profiilist võib see element olla kehtivuskinnituse \"\n\"koosseisus (BDOC-TM), eraldi ajatemplina (BDOC-TS) või \"\n\"registreerimistõendi koosseisus (BDOC-TS).\"\nmsgstr \"\"\n\"The processing application decides which voter's vote was the last and \"\n\"moves to the next stage of processing. That is, one of the elements \"\n\"qualifying a vote performs the role of fixing the time at which the vote \"\n\"was recorded, and the temporal sequence of individual votes is formed \"\n\"based on this element. Depending on the IVXV profile, this element may be\"\n\" part of a validity confirmation (BDOC-TM), a separate time stamp (BDOC-\"\n\"TS) or a registration certificate (BDOC-TS).\"\n\n#: ../../07-kontrollimine.rst:896\nmsgid \"Töötlemisrakendusele tehakse kättesaadavaks järgmised olemid:\"\nmsgstr \"\"\n\"The following entities will be made available to the processing \"\n\"application:\"\n\n#: ../../07-kontrollimine.rst:924\nmsgid \"Töötlemisrakendus tuvastab/loob järgmised olemid:\"\nmsgstr \"The processing application detects/creates the following entities:\"\n\n#: ../../07-kontrollimine.rst:929\nmsgid \"Töötlemisrakendus ei puutu vahetult kokku järgmiste olemitega:\"\nmsgstr \"The processing application does not come into direct contact with:\"\n\n#: ../../07-kontrollimine.rst:937\nmsgid \"Töötlemisrakenduse töö jaguneb neljaks etapiks:\"\nmsgstr \"The work of the processing application is divided into four phases:\"\n\n#: ../../07-kontrollimine.rst:939\nmsgid \"Kontrollimine\"\nmsgstr \"Check\"\n\n#: ../../07-kontrollimine.rst:941\nmsgid \"Korduvhäälte eemaldamine\"\nmsgstr \"Removal of repeat votes\"\n\n#: ../../07-kontrollimine.rst:943\nmsgid \"Tühistamine/-ennistamine\"\nmsgstr \"Revocation/restoration\"\n\n#: ../../07-kontrollimine.rst:945\nmsgid \"Anonüümimine\"\nmsgstr \"Anonymization\"\n\n#: ../../07-kontrollimine.rst:948\nmsgid \"Töötlemisrakendus teostab kontrollimise etapis järgmised kontrollid:\"\nmsgstr \"\"\n\"The processing application performs the following checks during the check\"\n\" phase:\"\n\n#: ../../07-kontrollimine.rst:950\nmsgid \"\"\n\"e-valimiskasti elementide kontrollid teostatakse kõigi hääle elementide \"\n\"kohta:\"\nmsgstr \"\"\n\"checks on the elements of the digital ballot box are carried out for all \"\n\"elements of the vote:\"\n\n#: ../../07-kontrollimine.rst:955\nmsgid \":ref:`check-nimekirjatunnus-correctness`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:956\nmsgid \":ref:`check-nimekirjatunnus-consistency-protocol-settings`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:958 ../../07-kontrollimine.rst:1054\n#: ../../07-kontrollimine.rst:1116\nmsgid \":ref:`check-ringkonnatunnus-correctness`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:973\nmsgid \"\"\n\"registreerimisteenuse väljavõtte kontrollid teostatakse iga \"\n\"registreerimispäringu kohta\"\nmsgstr \"\"\n\"checks on the extract from the registration service are carried out for \"\n\"every registration request\"\n\n#: ../../07-kontrollimine.rst:977\nmsgid \":ref:`check-registreerimisparing-konteiner-correctness`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:978\nmsgid \"\"\n\":ref:`check-registreerimisparing-konteiner-registreerimispäring-\"\n\"consistency`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:980\nmsgid \"\"\n\"Töötlemisrakendus loob vastavuse e-valimiskasti ja registreerimisteenuse \"\n\"väljavõtte vahel võttes aluseks olemi :ref:`entity-registreerimisparing-\"\n\"konteiner` registreerimisteenuse väljavõttest ning olemi :ref:`entity-\"\n\"registreerimistoend` e-valimiskastist. Ühendavaks lüliks kahe vaate vahel\"\n\" on :ref:`entity-registreerimisparing`.\"\nmsgstr \"\"\n\"The processing application creates a match between the digital ballot box\"\n\" and the registration service extract based on the :ref:`entity-\"\n\"registreerimisparing-konteiner` from the registration service extract and\"\n\" the :ref:`entity-registreerimistoend` from the digital ballot box. The \"\n\"connecting link between the two views is :ref:`entity-\"\n\"registreerimisparing`.\"\n\n#: ../../07-kontrollimine.rst:987\nmsgid \"e-valimiskasti ja registreerimisteenuse väljavõtte vastavuskontrollid\"\nmsgstr \"digital ballot box and registration service extract compliance checks\"\n\n#: ../../07-kontrollimine.rst:992\nmsgid \"\"\n\"Töötlemisrakendus teostab korduvhäälte eemaldamise etapis järgmised \"\n\"kontrollid:\"\nmsgstr \"\"\n\"The processing application performs the following checks during the \"\n\"squash phase:\"\n\n#: ../../07-kontrollimine.rst:994\nmsgid \"Töötlemisrakendus tuvastab iga valija häälte hulgast ajaliselt viimase.\"\nmsgstr \"\"\n\"The processing application identifies the last of each voter's votes in \"\n\"time.\"\n\n#: ../../07-kontrollimine.rst:996\nmsgid \"Töötlemisrakendus viib läbi krüpteeritud sedeli korrektsuse kontrollid.\"\nmsgstr \"\"\n\"The processing application performs correctness checks on the encrypted \"\n\"sender.\"\n\n#: ../../07-kontrollimine.rst:1002\nmsgid \"\"\n\"Töötlemisrakenduse töö järgmistes etappides täiendavaid kontrolle ei \"\n\"teostata. Tühistamis-/ennistamisetapis eemaldatakse/taastatakse \"\n\"isikukoodile vastavaid hääli korduvhäältest puhastatud e-valimiskastist. \"\n\"Anonüümimisetapis eemaldatakse e-häältelt kvalifitseerivad elemendid ning\"\n\" saadud loend krüpteeritud sedelitest suunatakse miksimisrakendusse.\"\nmsgstr \"\"\n\"No further checks will be carried out at subsequent stages of the \"\n\"processing application. In the cancellation/pre-cancelling phase, the \"\n\"votes corresponding to the personal identification code are \"\n\"removed/restored from the e-voting box cleaned of duplicate votes. In the\"\n\" anonymisation phase, the qualifying elements are removed from the \"\n\"e-votes and the resulting list of encrypted ballots is passed to the \"\n\"mixing application.\"\n\n#: ../../07-kontrollimine.rst:1009\nmsgid \"Kontrollid miksimisrakenduses\"\nmsgstr \"Controls in the mixing application\"\n\n#: ../../07-kontrollimine.rst:1011\nmsgid \"Miksimisrakendusele tehakse kättesaadavaks järgmised olemid:\"\nmsgstr \"The following entities will be made available to the mixing application:\"\n\n#: ../../07-kontrollimine.rst:1017\nmsgid \"Miksimisrakendus loob järgmised olemid:\"\nmsgstr \"The mixing application creates the following entities:\"\n\n#: ../../07-kontrollimine.rst:1021\nmsgid \"Miksimisrakendus ei puutu vahetult kokku järgmiste olemitega:\"\nmsgstr \"The mixing application does not directly interact with:\"\n\n#: ../../07-kontrollimine.rst:1052\nmsgid \"Miksimisrakendus viib läbi järgmised tegevused ja kontrollid:\"\nmsgstr \"The mixing application performs the following actions and checks:\"\n\n#: ../../07-kontrollimine.rst:1058\nmsgid \"\"\n\"Miksimisrakendus grupeerib sisendiks antud krüpteeritud sedelid \"\n\"ringkonnatunnuste kaupa ning järjestab krüpteeritud sedelid ringkonnas \"\n\"ringi.\"\nmsgstr \"\"\n\"The mixing application groups the encrypted ballots given as input by \"\n\"district identifiers and reorders the encrypted ballots within a \"\n\"district.\"\n\n#: ../../07-kontrollimine.rst:1062\nmsgid \"\"\n\"Miksimisrakendus arvutab iga ümberjärjestatud krüpteeritud sedeli kohta \"\n\"uue miksitud krüpteeritud sedeli.\"\nmsgstr \"\"\n\"The mixing application for each reordered ciphertext calculates a new \"\n\"ciphertext.\"\n\n#: ../../07-kontrollimine.rst:1065\nmsgid \"\"\n\"Miksimisrakendus koostab nullteadmustõestused sedelite korrektse \"\n\"miksimise kohta.\"\nmsgstr \"\"\n\"The mixing application generates zero-knowledge proofs of correct mixing \"\n\"of ballots.\"\n\n#: ../../07-kontrollimine.rst:1068\nmsgid \"Kontrollid võtmerakenduses\"\nmsgstr \"Checks in the key application\"\n\n#: ../../07-kontrollimine.rst:1070\nmsgid \"Võtmerakendusele tehakse kättesaadavaks järgmised olemid:\"\nmsgstr \"The following entities will be made available to the key application:\"\n\n#: ../../07-kontrollimine.rst:1078\nmsgid \"Võtmerakendus tuvastab järgmised olemid:\"\nmsgstr \"The key application identifies the following entities:\"\n\n#: ../../07-kontrollimine.rst:1082\nmsgid \"Võtmerakendus ei puutu vahetult kokku järgmiste olemitega:\"\nmsgstr \"The key application does not directly interact with:\"\n\n#: ../../07-kontrollimine.rst:1111\nmsgid \"Võtmerakendus viib läbi järgmised tegevused ja kontrollid:\"\nmsgstr \"The Key Application performs the following activities and checks:\"\n\n#: ../../07-kontrollimine.rst:1113\nmsgid \":ref:`check-miksitud-krypteeritud-sedel-correctness`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:1114\nmsgid \":ref:`check-miksitud-krypteeritud-sedel-public-key-consistency`\"\nmsgstr \"\"\n\n#: ../../07-kontrollimine.rst:1115\nmsgid \"Häälte dekrüpteerimine\"\nmsgstr \"Decryption of votes\"\n\n#: ../../07-kontrollimine.rst:1118\nmsgid \":ref:`check-tahteavaldus-ringkonnatunnus-valikutenimekiri-consistency`\"\nmsgstr \"\"\n" }, { "path": "Documentation/public/protokollid/locales/en/LC_MESSAGES/08-haaletamine.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2024, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.8.2\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-25 12:59+0000\\n\"\n\"PO-Revision-Date: 2024-03-01 18:24+0200\\n\"\n\"Last-Translator: \\n\"\n\"Language: en\\n\"\n\"Language-Team: en \\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../08-haaletamine.rst:5\nmsgid \"Suhtlusprotokollid\"\nmsgstr \"Communication protocols\"\n\n#: ../../08-haaletamine.rst:8\nmsgid \"Liides\"\nmsgstr \"Interface\"\n\n#: ../../08-haaletamine.rst:10\nmsgid \"\"\n\"Kogumisteenuse valijale suunatud mikroteenused suhtlevad \"\n\"valijarakendusega ja kontrollrakendusega JSON-RPC protokolli vahendusel.\"\nmsgstr \"\"\n\"The micro-services at the collection service communicate with the voting \"\n\"application and the verification application via the JSON-RPC protocol.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"id\"\nmsgstr \"id\"\n\n#: ../../08-haaletamine.rst:13\nmsgid \"JSON-RPC päringuidentifikaator\"\nmsgstr \"JSON-RPC query identifier\"\n\n#: ../../08-haaletamine.rst\nmsgid \"method\"\nmsgstr \"method\"\n\n#: ../../08-haaletamine.rst:14\nmsgid \"RPC-meetod\"\nmsgstr \"RPC method\"\n\n#: ../../08-haaletamine.rst\nmsgid \"params\"\nmsgstr \"params\"\n\n#: ../../08-haaletamine.rst:15\nmsgid \"Konkreetse RPC-meetodi parameetrid\"\nmsgstr \"Parameters of a specific RPC method\"\n\n#: ../../08-haaletamine.rst\nmsgid \"error\"\nmsgstr \"error\"\n\n#: ../../08-haaletamine.rst:21\nmsgid \"Võimalik veainfo või ``null`` vea puudumisel\"\nmsgstr \"Possible error information or \\\"null\\\" in the absence of error\"\n\n#: ../../08-haaletamine.rst:22\nmsgid \"JSON-RPC päringuidentifikaator, peab ühtima päringus kasutatud id'ga\"\nmsgstr \"JSON-RPC query identifier, must match the id used in the query.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result\"\nmsgstr \"result\"\n\n#: ../../08-haaletamine.rst:23\nmsgid \"Meetodipõhine vastusandmestruktuur\"\nmsgstr \"Method-dependent response data structure\"\n\n#: ../../08-haaletamine.rst:29\nmsgid \"\"\n\"Esimese päringuvahetuse käigus mõne IVXV mikroteenusega väljastatakse \"\n\"suhtlevale rakendusele HEX-kodeeritud unikaalne seansiidentifikaator \"\n\"(``result.SessionID``), mida rakendus kasutab edaspidi kõigis \"\n\"kogumisteenuse suunalistes päringutes (``params.SessionID``). \"\n\"Seansiidentifikaatori abil seostatakse hääletamisega seotud RPC-päringud \"\n\"üheks seansiks. Seostamine on informatiivne ning selle eesmärk on \"\n\"logianalüüsi lihtsustamine, hääle ringkonnakuuluvust jm. sisulisi aspekte\"\n\" puudutavad otsused tehakse digiallkirjastatud andmete põhjal.\"\nmsgstr \"\"\n\"During the first query exchange with one of the IVXV microservices, a \"\n\"HEX-encoded unique session identifier (``result.SessionID``) is issued to\"\n\" the communicating application, which is used by the application in all \"\n\"subsequent queries to the collection service (``params.SessionID``). The \"\n\"session identifier is used to associate RPC requests related to voting \"\n\"into a single session. The association is informative and is intended to \"\n\"simplify log analysis, vote circularity, etc. Decisions on substantive \"\n\"aspects are made on the basis of the digitally signed data.\"\n\n#: ../../08-haaletamine.rst:37\nmsgid \"\"\n\"Transpordiprotokollina on kasutusel TLS. Krüpteeritud kanali \"\n\"termineerimine toimub konkreetses mikroteenuses. Võimaldamaks koormuse \"\n\"jaotamist ning mikroteenuste paindlikku evitamist kasutatakse TLS-SNI \"\n\"laiendust, mis lubab vahendusteenusel TLS voogu termineerimata õigesse \"\n\"mikroteenusinstantsi suunata. Vahendusteenus on tüüpiliselt kättesaadav \"\n\"kogumisteenuse välise liidese pordis 443.\"\nmsgstr \"\"\n\"TLS is used as the transport protocol. The termination of the encrypted \"\n\"channel takes place in a specific microservice. To enable load balancing \"\n\"and flexible provisioning of microservices, the TLS-SNI extension is \"\n\"used, which allows the proxy service to route the TLS stream to the \"\n\"correct microservice instance without termination. The broker service is \"\n\"typically available on port 443 of the external interface to the \"\n\"collection service.\"\n\n#: ../../08-haaletamine.rst:45\nmsgid \"Valikute nimekirja hankimine\"\nmsgstr \"Retrieving the List of Choices\"\n\n#: ../../08-haaletamine.rst:47\nmsgid \"\"\n\"Valikute nimekirja hankimine tähendab valijarakenduse suhtlemist \"\n\"nimekirjateenusega (SNI ``choices.ivxv.invalid``). Valikute nimekirja \"\n\"hankimine eeldab valija autentimist ning tema ringkonnakuuluvuse \"\n\"tuvastamist.\"\nmsgstr \"\"\n\"Retrieving the list of choices means the interaction of the voting \"\n\"application with the choices service (SNI ``choices.ivxv.invalid``). \"\n\"Getting a list of choices requires authentication of the voter and \"\n\"verification of the voter's electoral district.\"\n\n#: ../../08-haaletamine.rst:51\nmsgid \"Valijarakendus teeb päringu ``RPC.VoterChoices`` nimekirjade hankimiseks.\"\nmsgstr \"The voting application will query ``RPC.VoterChoices`` to retrieve lists.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"params.AuthMethod\"\nmsgstr \"params.AuthMethod\"\n\n#: ../../08-haaletamine.rst:53 ../../08-haaletamine.rst:140\nmsgid \"Toetatud valikud on meetodid ``tls`` ja ``ticket``.\"\nmsgstr \"The supported options are methods ``tls`` and ``ticket``.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"params.OS\"\nmsgstr \"params.OS\"\n\n#: ../../08-haaletamine.rst:54 ../../08-haaletamine.rst:146\n#: ../../08-haaletamine.rst:230 ../../08-haaletamine.rst:256\n#: ../../08-haaletamine.rst:305 ../../08-haaletamine.rst:337\n#: ../../08-haaletamine.rst:361 ../../08-haaletamine.rst:415\n#: ../../08-haaletamine.rst:439 ../../08-haaletamine.rst:464\n#: ../../08-haaletamine.rst:516 ../../08-haaletamine.rst:533\n#: ../../08-haaletamine.rst:570 ../../08-haaletamine.rst:594\n#: ../../08-haaletamine.rst:645 ../../08-haaletamine.rst:668\nmsgid \"Operatsioonisüsteem, millel valijarakendust kasutatakse.\"\nmsgstr \"The operating system on which the voting application is used.\"\n\n#: ../../08-haaletamine.rst:56\nmsgid \"\"\n\"Päring ``RPC.VoterChoices`` ID-kaardiga autentimise korral - autentimine \"\n\"toimub TLS-protokolli tasemel päringu töötlemise ajal kasutades ID-kaardi\"\n\" autentimissertifikaati.\"\nmsgstr \"\"\n\"Query ``RPC.VoterChoices`` in case of ID-card authentication - \"\n\"authentication is performed at the TLS protocol level during query \"\n\"processing using the ID-card authentication certificate.\"\n\n#: ../../08-haaletamine.rst:64\nmsgid \"\"\n\"Päring ``RPC.VoterChoices`` Mobiil-ID'ga autentimise korral - päringu \"\n\"sooritamiseks tuleb eelnevalt kasutada Mobiil-ID vahendusteenuse (SNI \"\n\"``mid.ivxv.invalid``) abi allkirjastatud autentimistõendi saamiseks.\"\nmsgstr \"\"\n\"Query ``RPC.VoterChoices`` in case of Mobile-ID authentication - to \"\n\"perform the query, the Mobile-ID Intermediary Service (SNI \"\n\"``mid.ivxv.invalid``) must be used in advance to obtain a signed \"\n\"authentication certificate.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"params.AuthToken\"\nmsgstr \"params.AuthToken\"\n\n#: ../../08-haaletamine.rst:68 ../../08-haaletamine.rst:83\n#: ../../08-haaletamine.rst:98\nmsgid \"\"\n\"Autentimisteenuse vahendusel allkirjastatud tõend, mis sisaldab endas \"\n\"valija unikaalset identifikaatorit.\"\nmsgstr \"\"\n\"A certificate signed by an authentication service containing a unique \"\n\"identifier of the voter.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"params.SessionID\"\nmsgstr \"params.SessionID\"\n\n#: ../../08-haaletamine.rst:71\nmsgid \"\"\n\"Kuna Mobiil-ID korral on nimekirja hankimisele eelnenud interaktsioon \"\n\"autentimistõendi saamiseks, on olemas seansiidentifikaator, mida tuleb \"\n\"kasutada.\"\nmsgstr \"\"\n\"Since the Mobile ID has been preceded by an interaction to obtain an \"\n\"authentication certificate, there is a session identifier that must be \"\n\"used.\"\n\n#: ../../08-haaletamine.rst:79\nmsgid \"\"\n\"Päring ``RPC.VoterChoices`` Smart-ID'ga autentimise korral - päringu \"\n\"sooritamiseks tuleb eelnevalt kasutada Smart-ID vahendusteenuse (SNI \"\n\"``smartid.ivxv.invalid``) abi allkirjastatud autentimistõendi saamiseks.\"\nmsgstr \"\"\n\"Query ``RPC.VoterChoices`` in case of authentication with Smart-ID - to \"\n\"perform the query, the Smart-ID Intermediary Service (SNI \"\n\"``smartid.ivxv.invalid``) must be used beforehand to obtain a signed \"\n\"authentication certificate.\"\n\n#: ../../08-haaletamine.rst:86\nmsgid \"\"\n\"Kuna Smart-ID korral on nimekirja hankimisele eelnenud interaktsioon \"\n\"autentimistõendi saamiseks, on olemas seansiidentifikaator, mida tuleb \"\n\"kasutada.\"\nmsgstr \"\"\n\"Since the Smart-ID has an interaction to obtain an authentication proof \"\n\"prior to the list acquisition, there is a session identifier to be used.\"\n\n#: ../../08-haaletamine.rst:94\nmsgid \"\"\n\"Päring ``RPC.VoterChoices`` Web eID'ga autentimise korral - päringu \"\n\"sooritamiseks tuleb eelnevalt kasutada Web eID vahendusteenuse (SNI \"\n\"``webeid.ivxv.invalid``) abi allkirjastatud autentimistõendi saamiseks.\"\nmsgstr \"\"\n\"Query ``RPC.VoterChoices`` in case of authentication with ID-card using \"\n\"Web eID protocol - to perform the query, the Web eID Intermediary Service\"\n\" (SNI ``webeid.ivxv.invalid``) must be used beforehand to obtain a signed\"\n\" authentication certificate.\"\n\n#: ../../08-haaletamine.rst:101\nmsgid \"\"\n\"Kuna Web eID korral on nimekirja hankimisele eelnenud interaktsioon \"\n\"autentimistõendi saamiseks, on olemas seansiidentifikaator, mida tuleb \"\n\"kasutada.\"\nmsgstr \"\"\n\"Since in the case of a Web eID, the list acquisition is preceded by an \"\n\"interaction to obtain an authentication certificate, there is a session \"\n\"identifier that must be used.\"\n\n#: ../../08-haaletamine.rst:109\nmsgid \"Nimekirjateenuse vastus päringule ``RPC.VoterChoices``.\"\nmsgstr \"Choices service response to ``RPC.VoterChoices``.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result.Choices\"\nmsgstr \"result.Choices\"\n\n#: ../../08-haaletamine.rst:111\nmsgid \"Valija ringkonnakuuluvuse identifikaator ``VoterDistrict``\"\nmsgstr \"Voter district identifier ``VoterDistrict``\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result.List\"\nmsgstr \"result.List\"\n\n#: ../../08-haaletamine.rst:112\nmsgid \"BASE64-kodeeritud ringkonna valikute nimekiri ``DistrictChoices``\"\nmsgstr \"List of BASE64 encoded district options ``DistrictChoices``\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result.Voted\"\nmsgstr \"result.Voted\"\n\n#: ../../08-haaletamine.rst:113\nmsgid \"\"\n\"Kui valija on juba hääletanud, siis ``true``, vastasel juhul seda välja \"\n\"vastuses ei ole.\"\nmsgstr \"\"\n\"If the voter has already voted, then ``true``, otherwise it will not \"\n\"appear in the response.\"\n\n#: ../../08-haaletamine.rst:120\nmsgid \"Võimalikud veateated päringu ``RPC.VoterChoices`` korral.\"\nmsgstr \"Possible error messages for the query ``RPC.VoterChoices``.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"BAD_CERTIFICATE\"\nmsgstr \"BAD_CERTIFICATE\"\n\n#: ../../08-haaletamine.rst:122\nmsgid \"Viga valija isikutuvastussertifikaadiga.\"\nmsgstr \"An error with the voter's identity certificate.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"BAD_REQUEST\"\nmsgstr \"BAD_REQUEST\"\n\n#: ../../08-haaletamine.rst:123 ../../08-haaletamine.rst:204\n#: ../../08-haaletamine.rst:249 ../../08-haaletamine.rst:284\n#: ../../08-haaletamine.rst:321 ../../08-haaletamine.rst:353\n#: ../../08-haaletamine.rst:389 ../../08-haaletamine.rst:432\n#: ../../08-haaletamine.rst:457 ../../08-haaletamine.rst:496\n#: ../../08-haaletamine.rst:555 ../../08-haaletamine.rst:586\n#: ../../08-haaletamine.rst:621 ../../08-haaletamine.rst:662\n#: ../../08-haaletamine.rst:692 ../../08-haaletamine.rst:728\n#: ../../08-haaletamine.rst:790\nmsgid \"Vigane päring.\"\nmsgstr \"Malformed query.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"INELIGIBLE_VOTER\"\nmsgstr \"INELIGIBLE_VOTER\"\n\n#: ../../08-haaletamine.rst:124 ../../08-haaletamine.rst:207\nmsgid \"Valijal pole õigust hääletada.\"\nmsgstr \"The voter has no right to vote.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"INTERNAL_SERVER_ERROR\"\nmsgstr \"INTERNAL_SERVER_ERROR\"\n\n#: ../../08-haaletamine.rst:125 ../../08-haaletamine.rst:208\n#: ../../08-haaletamine.rst:250 ../../08-haaletamine.rst:285\n#: ../../08-haaletamine.rst:322 ../../08-haaletamine.rst:354\n#: ../../08-haaletamine.rst:390 ../../08-haaletamine.rst:433\n#: ../../08-haaletamine.rst:458 ../../08-haaletamine.rst:497\n#: ../../08-haaletamine.rst:556 ../../08-haaletamine.rst:587\n#: ../../08-haaletamine.rst:622 ../../08-haaletamine.rst:663\n#: ../../08-haaletamine.rst:693 ../../08-haaletamine.rst:729\n#: ../../08-haaletamine.rst:757 ../../08-haaletamine.rst:791\nmsgid \"Viga serveri sisemises töös.\"\nmsgstr \"An error in the internal workings of the server.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"UNAUTHENTICATED\"\nmsgstr \"UNAUTHENTICATED\"\n\n#: ../../08-haaletamine.rst:126 ../../08-haaletamine.rst:210\nmsgid \"Autentimata päring.\"\nmsgstr \"Unauthenticated request.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"VOTER_TOO_YOUNG\"\nmsgstr \"VOTER_TOO_YOUNG\"\n\n#: ../../08-haaletamine.rst:127 ../../08-haaletamine.rst:211\nmsgid \"Valija on liiga noor.\"\nmsgstr \"The voter is too young.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"VOTING_END\"\nmsgstr \"VOTING_END\"\n\n#: ../../08-haaletamine.rst:128 ../../08-haaletamine.rst:212\n#: ../../08-haaletamine.rst:251 ../../08-haaletamine.rst:294\n#: ../../08-haaletamine.rst:326 ../../08-haaletamine.rst:355\n#: ../../08-haaletamine.rst:398 ../../08-haaletamine.rst:434\n#: ../../08-haaletamine.rst:459 ../../08-haaletamine.rst:504\n#: ../../08-haaletamine.rst:559 ../../08-haaletamine.rst:588\n#: ../../08-haaletamine.rst:629 ../../08-haaletamine.rst:664\n#: ../../08-haaletamine.rst:695 ../../08-haaletamine.rst:730\n#: ../../08-haaletamine.rst:758 ../../08-haaletamine.rst:792\nmsgid \"Hääletusperiood on lõppenud.\"\nmsgstr \"The voting period has ended.\"\n\n#: ../../08-haaletamine.rst:132\nmsgid \"Allkirjastatud hääle saatmine talletamiseks\"\nmsgstr \"Sending a signed vote for storage\"\n\n#: ../../08-haaletamine.rst:134\nmsgid \"\"\n\"Allkirjastatud hääle saatmine talletamiseks tähendab valijarakenduse \"\n\"suhtlemist hääletamisteenusega (SNI ``voting.ivxv.invalid``).\"\nmsgstr \"\"\n\"Sending a signed vote to be stored implies the interaction of the voter \"\n\"application with the voting service (SNI ``voting.ivxv.invalid``).\"\n\n#: ../../08-haaletamine.rst:137\nmsgid \"\"\n\"Valijarakendus teeb päringu ``RPC.Vote`` allkirjastatud hääle \"\n\"talletamiseks saatmiseks.\"\nmsgstr \"\"\n\"The voting application will query ``RPC.Vote`` to send the signed vote \"\n\"for storage.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"params.Choices\"\nmsgstr \"params.Choices\"\n\n#: ../../08-haaletamine.rst:141\nmsgid \"\"\n\"Valija ringkonnakuuluvuse identifikaator ``VoterDistrict`` mis kehtis \"\n\"valikute nimekirja hankimise ajal. Parameetri korrektne kasutamine \"\n\"võimaldab kogumisteenusel valijat hoiatada kui tema ringkonnakuuluvus on \"\n\"võrreldes hääletamise algushetkega muutunud.\"\nmsgstr \"\"\n\"The voter's district identifier ``VoterDistrict`` that was in effect at \"\n\"the time the list of choices was obtained. Correct use of this parameter \"\n\"allows the collection service to alert the voter if his/her district \"\n\"affiliation has changed since the start of the voting process.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"params.Type\"\nmsgstr \"params.Type\"\n\n#: ../../08-haaletamine.rst:147 ../../08-haaletamine.rst:716\nmsgid \"Allkirjastatud hääle vorming. Hetkel on ainus toetatud väärtus ``bdoc``.\"\nmsgstr \"Signed ballot format. Currently the only supported value is ``bdoc``.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"params.Vote\"\nmsgstr \"params.Vote\"\n\n#: ../../08-haaletamine.rst:149 ../../08-haaletamine.rst:718\nmsgid \"\"\n\"BASE64-kodeeritud hääl ``SignedVote`` eelpoolmääratud vormingus (:ref\"\n\":`signed-vote`).\"\nmsgstr \"\"\n\"BASE64-encoded vote in ``SignedVote`` predefined format (:ref:`signed-\"\n\"vote`).\"\n\n#: ../../08-haaletamine.rst:152\nmsgid \"Päring ``RPC.Vote`` ID-kaardiga autentimise korral.\"\nmsgstr \"Query ``RPC.Vote`` in case of ID-card authentication.\"\n\n#: ../../08-haaletamine.rst:158\nmsgid \"Päring ``RPC.Vote`` Mobiil-ID'ga autentimise korral.\"\nmsgstr \"Query ``RPC.Vote`` in case of authentication with Mobile-ID.\"\n\n#: ../../08-haaletamine.rst:164\nmsgid \"Päring ``RPC.Vote`` Smart-ID'ga autentimise korral.\"\nmsgstr \"Query ``RPC.Vote`` for authentication with Smart-ID.\"\n\n#: ../../08-haaletamine.rst:170\nmsgid \"Päring ``RPC.Vote`` Web eID'ga autentimise korral.\"\nmsgstr \"Query ``RPC.Vote`` for authentication with Web eID.\"\n\n#: ../../08-haaletamine.rst:176\nmsgid \"Hääletamisteenuse vastus päringule ``RPC.Vote``.\"\nmsgstr \"Voting service response to the query ``RPC.Vote``.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result.Qualification.ocsp\"\nmsgstr \"result.Qualification.ocsp\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result.Qualification.tspreg\"\nmsgstr \"result.Qualification.tspreg\"\n\n#: ../../08-haaletamine.rst:180\nmsgid \"\"\n\"Kogumisteenuse poolt hangitud täiendavad tõendid valijarakenduse poolt \"\n\"loodud hääle ``SignedVote`` (:ref:`signed-vote`) kvalifitseerimiseks ning\"\n\" korrektseks registreerimiseks. Vastuse koosseis sõltub kogumisteenuse \"\n\"konkreetsest seadistusest, antud juhul kasutatakse standardset OCSP \"\n\"protokolli valija allkirjasertifikaadi kehtivuse kontrolliks ning PKIX \"\n\"ajatempliprotokolli põhist registreerimisteenust nii hääle andmise aja \"\n\"fikseerimiseks kui elektroonilise hääle registreerimiseks välises \"\n\"sõltumatus teenuses. Valijarakendusele kontrollimiseks edastatakse nii \"\n\"OCSP vastus kui PKIX vormingus ajatempel koos registreerimisteenusele \"\n\"vajalike täiendustega.\"\nmsgstr \"\"\n\"Additional evidence obtained by the collection service for the \"\n\"qualification and correct registration of the ``SignedVote`` (:ref\"\n\":`signed-vote`) generated by the voting application. The composition of \"\n\"the response depends on the specific configuration of the collection \"\n\"service, in this case the standard OCSP protocol is used to verify the \"\n\"validity of the voter's signature certificate and the PKIX timestamp \"\n\"protocol based registration service is used both to record the time of \"\n\"casting the vote and to register the electronic vote in an external \"\n\"independent service. Both the OCSP response and the timestamp in PKIX \"\n\"format, with the necessary additions to the registration service, are \"\n\"transmitted to the voting application for verification.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result.TestVote\"\nmsgstr \"result.TestVote\"\n\n#: ../../08-haaletamine.rst:189\nmsgid \"\"\n\"Kui hääl esitati enne hääletamise algust ning läks arvesse proovihäälena,\"\n\" siis ``true``, vastasel juhul seda välja vastuses ei ole. Valijarakendus\"\n\" kuvab valijale proovihääle korral sellekohase hoiatuse.\"\nmsgstr \"\"\n\"If the vote was cast before voting started and counted as a test vote, \"\n\"then ``true``, otherwise it is not included in the response. The voting \"\n\"application will display a warning to the voter in the case of a test \"\n\"vote.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result.VoteID\"\nmsgstr \"result.VoteID\"\n\n#: ../../08-haaletamine.rst:193\nmsgid \"\"\n\"Hääle identifikaator talletusteenuses, mille alusel on kontrollrakendusel\"\n\" võimalik häält hilisemaks analüüsiks välja nõuda.\"\nmsgstr \"\"\n\"The identifier of the ballot in the storage service, which allows the \"\n\"verification application to retrieve the ballot for later analysis.\"\n\n#: ../../08-haaletamine.rst:201\nmsgid \"Võimalikud veateated päringu ``RPC.Vote`` korral.\"\nmsgstr \"Possible error messages in case of ``RPC.Vote`` query.\"\n\n#: ../../08-haaletamine.rst:203\nmsgid \"Viga valija isikutuvastus- või allkirjastamissertifikaadiga.\"\nmsgstr \"An error with the voter's identification or signature certificate.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"IDENTITY_MISMATCH\"\nmsgstr \"IDENTITY_MISMATCH\"\n\n#: ../../08-haaletamine.rst:205\nmsgid \"Isikutuvastus- ning allkirjastamissertifikaadi isikukoodid ei kattu.\"\nmsgstr \"The ID codes of the ID and signature certificate do not match.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"OUTDATED_CHOICES\"\nmsgstr \"OUTDATED_CHOICES\"\n\n#: ../../08-haaletamine.rst:209\nmsgid \"Valija ringkonnakuuluvus on nimekirja hankimisest muutunud.\"\nmsgstr \"\"\n\"The district eligibility of a candidate has changed since the list was \"\n\"obtained.\"\n\n#: ../../08-haaletamine.rst:216\nmsgid \"Hääletamine Mobiil-ID'ga\"\nmsgstr \"Voting with Mobile-ID\"\n\n#: ../../08-haaletamine.rst:218\nmsgid \"\"\n\"Mobiil-ID kasutamine allkirjastamis- ning autentimisvahendina tingib \"\n\"Mobiil-ID teenusega liidestuva abiteenuse (SNI ``mid.ivxv.invalid``) \"\n\"kasutamise autentimistõendi hankimiseks enne valikute nimekirja hankimist\"\n\" ning hääle allkirjastamiseks enne talletamist.\"\nmsgstr \"\"\n\"The use of Mobile-ID as a signature and authentication tool implies the \"\n\"use of an auxiliary service (SNI ``mid.ivxv.invalid``) that interfaces \"\n\"with the Mobile-ID service to obtain an authentication certificate before\"\n\" retrieving the list of options and to sign the vote before storing it.\"\n\n#: ../../08-haaletamine.rst:225 ../../08-haaletamine.rst:411\n#: ../../08-haaletamine.rst:640\nmsgid \"Autentimistõendi hankimine\"\nmsgstr \"Retrieving an Authentication Certificate\"\n\n#: ../../08-haaletamine.rst:227\nmsgid \"\"\n\"Valijarakendus teeb päringu ``RPC.Authenticate`` Mobiil-ID autentimise \"\n\"algatamiseks.\"\nmsgstr \"\"\n\"The voting application will make a request ``RPC.Authenticate`` to \"\n\"initiate Mobile ID authentication.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"params.IDCode\"\nmsgstr \"params.IDCode\"\n\n#: ../../08-haaletamine.rst:231\nmsgid \"Mobiil-ID kasutaja isikukood.\"\nmsgstr \"Mobile-ID user ID.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"params.PhoneNo\"\nmsgstr \"params.PhoneNo\"\n\n#: ../../08-haaletamine.rst:232\nmsgid \"Mobiil-ID kasutaja telefoninumber.\"\nmsgstr \"Mobile ID user's phone number.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result.Challenge\"\nmsgstr \"result.Challenge\"\n\n#: ../../08-haaletamine.rst:238\nmsgid \"Räsi, millest arvutada Mobiil-ID kontrollkood valijarakenduses kuvamiseks\"\nmsgstr \"\"\n\"Hash from which to calculate the Mobile ID verification code to display \"\n\"in the voting application\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result.SessionCode\"\nmsgstr \"result.SessionCode\"\n\n#: ../../08-haaletamine.rst:240\nmsgid \"Mobiil-ID seansiidentifikaator edasiste poll-päringute jaoks\"\nmsgstr \"Mobile-ID session identifier for further poll requests\"\n\n#: ../../08-haaletamine.rst:247 ../../08-haaletamine.rst:430\n#: ../../08-haaletamine.rst:455\nmsgid \"Võimalikud veateated päringu ``RPC.Authenticate`` korral.\"\nmsgstr \"Possible error messages in case of ``RPC.Authenticate`` request.\"\n\n#: ../../08-haaletamine.rst:253 ../../08-haaletamine.rst:461\nmsgid \"\"\n\"Valijarakendus teeb päringu ``RPC.AuthenticateStatus`` \"\n\"autentimisprotsessi oleku hindamiseks.\"\nmsgstr \"\"\n\"The voting application queries ``RPC.AuthenticateStatus`` to assess the \"\n\"status of the authentication process.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"params.SessionCode\"\nmsgstr \"params.SessionCode\"\n\n#: ../../08-haaletamine.rst:257 ../../08-haaletamine.rst:467\n#: ../../08-haaletamine.rst:534\nmsgid \"Autentimisseansi identifikaator\"\nmsgstr \"Authentication session identifier\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result.AuthToken\"\nmsgstr \"result.AuthToken\"\n\n#: ../../08-haaletamine.rst:264 ../../08-haaletamine.rst:474\nmsgid \"\"\n\"Autentimistõend teistele IVXV teenustele esitamiseks või ``null``, kui \"\n\"päringu töötlemine alles käib.\"\nmsgstr \"\"\n\"Authentication certificate for submission to other IVXV services, or \"\n\"``null`` if the request is still being processed.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result.GivenName\"\nmsgstr \"result.GivenName\"\n\n#: ../../08-haaletamine.rst:266 ../../08-haaletamine.rst:478\n#: ../../08-haaletamine.rst:678\nmsgid \"Eduka autentimise korral valija eesnimi\"\nmsgstr \"First name of voter in case of successful authentication\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result.PersonalCode\"\nmsgstr \"result.PersonalCode\"\n\n#: ../../08-haaletamine.rst:267 ../../08-haaletamine.rst:479\n#: ../../08-haaletamine.rst:679\nmsgid \"Eduka autentimise korral valija isikukood\"\nmsgstr \"\"\n\"Voter's personal identification number in case of successful \"\n\"authentication\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result.Status\"\nmsgstr \"result.Status\"\n\n#: ../../08-haaletamine.rst:268 ../../08-haaletamine.rst:480\n#: ../../08-haaletamine.rst:541\nmsgid \"\"\n\"Päringu staatus - ``POLL`` viitab vajadusele päringut korrata, ``OK`` \"\n\"viitab edukale autentimisele. Vastuse muud väljad sisaldavad infot vaid \"\n\"siis kui väärtus on ``OK``.\"\nmsgstr \"\"\n\"Query status - ``POLL`` indicates the need to repeat the query, ``OK`` \"\n\"indicates successful authentication. The other fields in the response \"\n\"contain information only if the value is ``OK``.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result.Surname\"\nmsgstr \"result.Surname\"\n\n#: ../../08-haaletamine.rst:271 ../../08-haaletamine.rst:483\n#: ../../08-haaletamine.rst:683\nmsgid \"Eduka autentimise korral valija perekonnanimi\"\nmsgstr \"In case of successful authentication, the voter's surname\"\n\n#: ../../08-haaletamine.rst:282 ../../08-haaletamine.rst:494\nmsgid \"Võimalikud veateated päringu ``RPC.AuthenticateStatus`` korral.\"\nmsgstr \"Possible error messages in case of ``RPC.AuthenticateStatus`` request.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"MID_BAD_CERTIFICATE\"\nmsgstr \"MID_BAD_CERTIFICATE\"\n\n#: ../../08-haaletamine.rst:286\nmsgid \"Viga valija Mobiil-ID isikutuvastussertifikaadiga.\"\nmsgstr \"An error with the voter's Mobile ID certificate.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"MID_NOT_USER\"\nmsgstr \"MID_NOT_USER\"\n\n#: ../../08-haaletamine.rst:287 ../../08-haaletamine.rst:325\nmsgid \"Telefoninumber ei kuulu Mobiil-ID kliendile.\"\nmsgstr \"The phone number does not belong to a Mobile ID customer.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"MID_OPERATOR\"\nmsgstr \"MID_OPERATOR\"\n\n#: ../../08-haaletamine.rst:288 ../../08-haaletamine.rst:393\nmsgid \"\"\n\"Probleem valija mobiiltelefoni SIM kaardiga, mille lahendamiseks tuleb \"\n\"pöörduda mobiilioperaatori poole.\"\nmsgstr \"\"\n\"A problem with the SIM card of the voter's mobile phone, which needs to \"\n\"be solved by contacting the mobile operator.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"MID_ABSENT\"\nmsgstr \"MID_ABSENT\"\n\n#: ../../08-haaletamine.rst:290 ../../08-haaletamine.rst:391\nmsgid \"Valija mobiiltelefon ei ole kättesaadav.\"\nmsgstr \"The voter's mobile phone is not available.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"MID_CANCELED\"\nmsgstr \"MID_CANCELED\"\n\n#: ../../08-haaletamine.rst:291 ../../08-haaletamine.rst:395\nmsgid \"Valija katkestas Mobiil-ID seansi.\"\nmsgstr \"The voter has cancelled the Mobile-ID session.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"MID_EXPIRED\"\nmsgstr \"MID_EXPIRED\"\n\n#: ../../08-haaletamine.rst:292 ../../08-haaletamine.rst:396\nmsgid \"Mobiil-ID seanss on aegunud.\"\nmsgstr \"The Mobile ID session has expired.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"MID_GENERAL\"\nmsgstr \"MID_GENERAL\"\n\n#: ../../08-haaletamine.rst:293 ../../08-haaletamine.rst:324\n#: ../../08-haaletamine.rst:397\nmsgid \"Viga Mobiil-ID teenuse töös.\"\nmsgstr \"An error in the operation of the Mobile ID service.\"\n\n#: ../../08-haaletamine.rst:298 ../../08-haaletamine.rst:508\nmsgid \"Hääle allkirjastamine\"\nmsgstr \"Signing the vote\"\n\n#: ../../08-haaletamine.rst:300\nmsgid \"\"\n\"Valijarakendus teeb päringu ``RPC.GetCertificate`` \"\n\"allkirjastamissertifikaadi hankimiseks.\"\nmsgstr \"\"\n\"The voting application makes a query ``RPC.GetCertificate`` to retrieve \"\n\"the signing certificate.\"\n\n#: ../../08-haaletamine.rst:303 ../../08-haaletamine.rst:332\n#: ../../08-haaletamine.rst:513 ../../08-haaletamine.rst:565\nmsgid \"Toetatud ainult autentimismeetod ``ticket``.\"\nmsgstr \"Only the authentication method ``ticket`` is supported.\"\n\n#: ../../08-haaletamine.rst:304 ../../08-haaletamine.rst:333\nmsgid \"Mobiil-ID autentimistõend.\"\nmsgstr \"Mobile-ID authentication certificate.\"\n\n#: ../../08-haaletamine.rst:306 ../../08-haaletamine.rst:338\nmsgid \"Hääle allkirjastaja telefoninumber\"\nmsgstr \"Telephone number of the person who signed the vote\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result.Certificate\"\nmsgstr \"result.Certificate\"\n\n#: ../../08-haaletamine.rst:313 ../../08-haaletamine.rst:540\nmsgid \"Allkirjastamissertifikaat X509-vormingus\"\nmsgstr \"Signature certificate in X509 format\"\n\n#: ../../08-haaletamine.rst:319\nmsgid \"Võimalikud veateated päringu ``RPC.GetCertificate`` korral.\"\nmsgstr \"Possible error messages for ``RPC.GetCertificate``.\"\n\n#: ../../08-haaletamine.rst:323 ../../08-haaletamine.rst:392\nmsgid \"Viga valija Mobiil-ID allkirjastamissertifikaadiga.\"\nmsgstr \"Error with the voter's Mobile-ID signature certificate.\"\n\n#: ../../08-haaletamine.rst:329\nmsgid \"\"\n\"Valijarakendus teeb päringu ``RPC.Sign`` hääle allkirjastamise \"\n\"algatamiseks. Mobiil-ID kontrollkoodi arvutab valijarakendus andmevälja \"\n\"``Hash`` väärtusest.\"\nmsgstr \"\"\n\"The voting application will make a query ``RPC.Sign`` to initiate the \"\n\"signing of the vote. The mobile ID verification code is calculated by the\"\n\" voter application from the value of the ``Hash`` field.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"params.Hash\"\nmsgstr \"params.hash\"\n\n#: ../../08-haaletamine.rst:334 ../../08-haaletamine.rst:567\nmsgid \"BASE64-kodeeritud elektroonilise hääle räsi\"\nmsgstr \"BASE64-encoded hash of the ballot\"\n\n#: ../../08-haaletamine.rst\nmsgid \"params.HashType\"\nmsgstr \"params.HashType\"\n\n#: ../../08-haaletamine.rst:335\nmsgid \"\"\n\"Räsifunktsiooni nimi Mobiil-ID teenusele edastamiseks, kas ``SHA256``, \"\n\"``SHA384`` või ``SHA512``\"\nmsgstr \"\"\n\"The name of the hash function to be forwarded to the Mobile-ID service, \"\n\"either ``SHA256``, ``SHA384`` or ``SHA512``\"\n\n#: ../../08-haaletamine.rst:344\nmsgid \"Mobiil-ID seansiidentifikaator edasiste poll-päringute jaoks.\"\nmsgstr \"Mobile ID session identifier for further poll requests.\"\n\n#: ../../08-haaletamine.rst:351 ../../08-haaletamine.rst:584\nmsgid \"Võimalikud veateated päringu ``RPC.Sign`` korral.\"\nmsgstr \"Possible error messages in case of ``RPC.Sign`` query.\"\n\n#: ../../08-haaletamine.rst:358 ../../08-haaletamine.rst:591\nmsgid \"\"\n\"Valijarakendus teeb päringu ``RPC.SignStatus`` allkirjastamisprotsessi \"\n\"seisundi hindamiseks.\"\nmsgstr \"\"\n\"The voting application queries ``RPC.SignStatus`` to assess the status of\"\n\" the signing process.\"\n\n#: ../../08-haaletamine.rst:362\nmsgid \"Mobiil-ID seansiidentifikaator\"\nmsgstr \"Mobile-ID session identifier\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result.Signature\"\nmsgstr \"result.Signature\"\n\n#: ../../08-haaletamine.rst:368\nmsgid \"\"\n\"Juhul kui vastuse ``Status`` väli on ``OK``, BASE-64 kodeeritud \"\n\"PKCS1-vormingus signatuur, vastasel juhul ``null``.\"\nmsgstr \"\"\n\"If the ``Status`` field of the response is ``OK``, the BASE-64 encoded \"\n\"PKCS1 format signature, otherwise ``zero``.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result.Algorithm\"\nmsgstr \"result.Algorithm\"\n\n#: ../../08-haaletamine.rst:370\nmsgid \"\"\n\"Juhul kui vastuse ``Status`` väli on ``OK``, Mobiil-ID teenuse poolt \"\n\"tagastatud signatuuri algoritm. Võimalikud väärtused on \"\n\"``SHA256WithECEncryption``, ``SHA256WithRSAEncryption``, \"\n\"``SHA384WithECEncryption``, ``SHA384WithRSAEncryption``, \"\n\"``SHA512WithECEncryption`` ja ``SHA512WithRSAEncryption``.\"\nmsgstr \"\"\n\"If the ``Status`` field of the response is ``OK``, the signature \"\n\"algorithm returned by the Mobile-ID service. The possible values are \"\n\"``SHA256WithECEncryption``, ``SHA256WithRSAEncryption``, \"\n\"``SHA384WithECEncryption``, ``SHA384WithRSAEncryption``, \"\n\"``SHA512WithECEncryption`` and ``SHA512WithRSAEncryption``.\"\n\n#: ../../08-haaletamine.rst:375 ../../08-haaletamine.rst:607\nmsgid \"\"\n\"Päringu staatus - ``POLL`` viitab vajadusele päringut korrata, ``OK`` \"\n\"viitab edukale allkirjastamisele. Vastuse muud väljad sisaldavad infot \"\n\"vaid siis kui väärtus on ``OK``.\"\nmsgstr \"\"\n\"Query status - ``POLL`` indicates the need to repeat the query, ``OK`` \"\n\"indicates a successful signature. The other fields in the response \"\n\"contain information only if the value is ``OK``.\"\n\n#: ../../08-haaletamine.rst:387 ../../08-haaletamine.rst:619\nmsgid \"Võimalikud veateated päringu ``RPC.SignStatus`` korral.\"\nmsgstr \"Possible error messages in case of ``RPC.SignStatus`` query.\"\n\n#: ../../08-haaletamine.rst:402\nmsgid \"Hääletamine Smart-ID'ga\"\nmsgstr \"Voting with Smart-ID\"\n\n#: ../../08-haaletamine.rst:404\nmsgid \"\"\n\"Smart-ID kasutamine allkirjastamis- ning autentimisvahendina tingib \"\n\"Smart-ID teenusega liidestuva abiteenuse (SNI ``smartid.ivxv.invalid``) \"\n\"kasutamise autentimistõendi hankimiseks enne valikute nimekirja hankimist\"\n\" ning hääle allkirjastamiseks enne talletamist.\"\nmsgstr \"\"\n\"The use of Smart-ID as a signature and authentication tool implies the \"\n\"use of an auxiliary service (SNI ``smartid.ivxv.invalid``) interfacing \"\n\"with the Smart-ID service to obtain an authentication certificate before \"\n\"retrieving the list of choices and to sign the vote before storing it.\"\n\n#: ../../08-haaletamine.rst:413\nmsgid \"\"\n\"Valijarakendus teeb päringu ``RPC.Challenge`` Smart-ID kontrollkoodi \"\n\"hankimiseks.\"\nmsgstr \"\"\n\"The voter application will query ``RPC.Challenge`` to retrieve the Smart-\"\n\"ID verification code.\"\n\n#: ../../08-haaletamine.rst:421\nmsgid \"Räsi, millest arvutada Smart-ID kontrollkood valijarakenduses kuvamiseks\"\nmsgstr \"\"\n\"Hash from which to calculate the Smart-ID verification code to display in\"\n\" the voting application\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result.XSmartIDAuth\"\nmsgstr \"result.XSmartIDAuth\"\n\n#: ../../08-haaletamine.rst:423 ../../08-haaletamine.rst:440\n#: ../../08-haaletamine.rst:465\nmsgid \"\"\n\"Päringu küpsis, kus talletatakse Smart-ID kontrollkoodi räsi, selle eluea\"\n\" ajatempel ja seansiidentifikaator\"\nmsgstr \"\"\n\"A query cookie storing a hash of the Smart-ID verification code, a \"\n\"timestamp of its lifetime and a session identifier.\"\n\n#: ../../08-haaletamine.rst:436\nmsgid \"\"\n\"Valijarakendus teeb päringu ``RPC.Authenticate`` Smart-ID autentimise \"\n\"algatamiseks.\"\nmsgstr \"\"\n\"The voting application will query ``RPC.Authenticate`` to initiate Smart-\"\n\"ID authentication.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"params.XSmartIDAuth\"\nmsgstr \"params.XSmartIDAuth\"\n\n#: ../../08-haaletamine.rst\nmsgid \"params.Identifier\"\nmsgstr \"params.Identifier\"\n\n#: ../../08-haaletamine.rst:442\nmsgid \"Smart-ID kasutaja isikukood.\"\nmsgstr \"Smart-ID user ID.\"\n\n#: ../../08-haaletamine.rst:448 ../../08-haaletamine.rst:522\nmsgid \"Smart-ID seansiidentifikaator edasiste poll-päringute jaoks\"\nmsgstr \"Smart-ID session identifier for further poll requests\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result.DataToken\"\nmsgstr \"\"\n\n#: ../../08-haaletamine.rst:476\nmsgid \"\"\n\"Hääletaja Smart-ID dokumendi number või ``null``, kui päringu töötlemine \"\n\"alles käib.\"\nmsgstr \"\"\n\"Voter's Smart-ID document number or ``null``, when the query is pending.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"SMARTID_BAD_CERTIFICATE\"\nmsgstr \"SMARTID_BAD_CERTIFICATE\"\n\n#: ../../08-haaletamine.rst:498 ../../08-haaletamine.rst:623\nmsgid \"Viga valija Smart-ID isikutuvastussertifikaadiga.\"\nmsgstr \"Error with the voter's Smart-ID identity certificate.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"SMARTID_VERIFICATION\"\nmsgstr \"SMARTID_VERIFICATION\"\n\n#: ../../08-haaletamine.rst:499 ../../08-haaletamine.rst:624\nmsgid \"Valija valis vale verifitseerimiskoodi.\"\nmsgstr \"The voter selected the wrong verification code.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"SMARTID_ACCOUNT\"\nmsgstr \"SMARTID_ACCOUNT\"\n\n#: ../../08-haaletamine.rst:500 ../../08-haaletamine.rst:625\nmsgid \"Viga valija Smart-ID kontos.\"\nmsgstr \"An error in the voter's Smart-ID account.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"SMARTID_CANCELED\"\nmsgstr \"SMARTID_CANCELED\"\n\n#: ../../08-haaletamine.rst:501 ../../08-haaletamine.rst:626\nmsgid \"Valija katkestas Smart-ID seansi.\"\nmsgstr \"The Smart-ID session has been interrupted by the voter.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"SMARTID_EXPIRED\"\nmsgstr \"SMARTID_EXPIRED\"\n\n#: ../../08-haaletamine.rst:502 ../../08-haaletamine.rst:627\nmsgid \"Smart-ID seanss on aegunud.\"\nmsgstr \"The Smart-ID session has expired.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"SMARTID_GENERAL\"\nmsgstr \"SMARTID_GENERAL\"\n\n#: ../../08-haaletamine.rst:503 ../../08-haaletamine.rst:558\n#: ../../08-haaletamine.rst:628\nmsgid \"Viga Smart-ID teenuse töös.\"\nmsgstr \"Error in the Smart-ID service.\"\n\n#: ../../08-haaletamine.rst:510\nmsgid \"\"\n\"Valijarakendus teeb päringu ``RPC.GetCertificateChoice`` \"\n\"allkirjastamissertifikaadi valikuks.\"\nmsgstr \"\"\n\"The voting application makes a query ``RPC.GetCertificateChoice`` to \"\n\"select the signing certificate.\"\n\n#: ../../08-haaletamine.rst:514 ../../08-haaletamine.rst:566\nmsgid \"Smart-ID autentimistõend.\"\nmsgstr \"Smart-ID authentication certificate.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"params.DataToken\"\nmsgstr \"\"\n\n#: ../../08-haaletamine.rst:515 ../../08-haaletamine.rst:571\nmsgid \"Hääletaja Smart-ID dokumendi number.\"\nmsgstr \"Voter's Smart-ID documentnumber\"\n\n#: ../../08-haaletamine.rst:529\nmsgid \"\"\n\"Valijarakendus teeb päringu ``RPC.GetCertificateChoiceStatus`` \"\n\"allkirjastamissertifikaadi oleku hindamiseks.\"\nmsgstr \"\"\n\"The voting application makes a query ``RPC.GetCertificateChoiceStatus`` \"\n\"to evaluate the status of the signing certificate.\"\n\n#: ../../08-haaletamine.rst:553\nmsgid \"Võimalikud veateated päringu ``RPC.GetCertificateChoiceStatus`` korral.\"\nmsgstr \"Possible error messages for the query ``RPC.GetCertificateChoiceStatus``.\"\n\n#: ../../08-haaletamine.rst:557\nmsgid \"Viga valija Smart-ID allkirjastamissertifikaadiga.\"\nmsgstr \"Error with the voter's Smart-ID signature certificate.\"\n\n#: ../../08-haaletamine.rst:562\nmsgid \"\"\n\"Valijarakendus teeb päringu ``RPC.Sign`` hääle allkirjastamise \"\n\"algatamiseks. Smart-ID kontrollkoodi arvutab valijarakendus andmevälja \"\n\"``Hash`` väärtusest.\"\nmsgstr \"\"\n\"The voting application will make a query ``RPC.Sign`` to initiate the \"\n\"signing of the vote. The Smart-ID verification code is calculated by the \"\n\"voter application from the value of the ``Hash`` field.\"\n\n#: ../../08-haaletamine.rst:568\nmsgid \"\"\n\"Räsifunktsiooni nimi Smart-ID teenusele edastamiseks, kas ``SHA256``, \"\n\"``SHA384`` või ``SHA512``\"\nmsgstr \"\"\n\"The name of the hash function to transmit to the Smart-ID service, either\"\n\" ``SHA256``, ``SHA384`` or ``SHA512``\"\n\n#: ../../08-haaletamine.rst:577\nmsgid \"Smart-ID seansiidentifikaator edasiste poll-päringute jaoks.\"\nmsgstr \"Smart-ID session identifier for further poll requests.\"\n\n#: ../../08-haaletamine.rst:595\nmsgid \"Smart-ID seansiidentifikaator\"\nmsgstr \"Smart-ID session identifier\"\n\n#: ../../08-haaletamine.rst:601\nmsgid \"\"\n\"Juhul kui vastuse ``Status`` väli on ``OK``, BASE-64 kodeeritud \"\n\"signatuur, vastasel juhul ``null``.\"\nmsgstr \"\"\n\"If the ``Status`` field of the response is ``OK``, BASE-64 encoded \"\n\"signature, otherwise ``null``.\"\n\n#: ../../08-haaletamine.rst:603\nmsgid \"\"\n\"Juhul kui vastuse ``Status`` väli on ``OK``, Smart-ID teenuse poolt \"\n\"tagastatud signatuuri algoritm. Võimalikud väärtused on \"\n\"``sha256WithRSAEncryption``, ``sha384WithRSAEncryption``, ja \"\n\"``sha512WithRSAEncryption``.\"\nmsgstr \"\"\n\"If the ``Status`` field of the response is ``OK``, the signature \"\n\"algorithm returned by the Smart-ID service. Possible values are \"\n\"``sha256WithRSAEncryption``, ``sha384WithRSAEncryption``, and \"\n\"``sha512WithRSAEncryption``.\"\n\n#: ../../08-haaletamine.rst:632\nmsgid \"Hääletamine Web eID'ga\"\nmsgstr \"Voting with Web eID\"\n\n#: ../../08-haaletamine.rst:634\nmsgid \"\"\n\"Web eID kasutamine autentimisvahendina tingib Web eID teenusega \"\n\"liidestuva abiteenuse (SNI ``webeid.ivxv.invalid``) kasutamise \"\n\"autentimistõendi hankimiseks enne valikute nimekirja hankimist.\"\nmsgstr \"\"\n\"The use of Web eID as an authentication tool implies the use of an \"\n\"auxiliary service (SNI ``webeid.ivxv.invalid``) interfacing with the Web \"\n\"eID service to obtain an authentication certificate before retrieving the\"\n\" list of choices.\"\n\n#: ../../08-haaletamine.rst:642\nmsgid \"\"\n\"Valijarakendus teeb päringu ``RPC.Challenge`` Web eID autentimise \"\n\"algatamiseks.\"\nmsgstr \"\"\n\"The voting application makes a request to ``RPC.Challenge`` to initiate \"\n\"Web eID authentication.\"\n\n#: ../../08-haaletamine.rst:651\nmsgid \"\"\n\"Base64 kodeeritud räsi, mille dekodeeritud väärtust peab valijarakendus \"\n\"kasutama autentimistõendi allkirja loomiseks.\"\nmsgstr \"\"\n\"A Base64 encoded hash whose decoded value must be used by the voter \"\n\"application to generate the authentication proof signature.\"\n\n#: ../../08-haaletamine.rst:653 ../../08-haaletamine.rst:669\nmsgid \"Seansiidentifikaator.\"\nmsgstr \"Session identifier.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"params.Bearer\"\nmsgstr \"params.Bearer\"\n\n#: ../../08-haaletamine.rst:654 ../../08-haaletamine.rst:671\nmsgid \"Küpsis, mida server kasutab räsi verifitseerimiseks.\"\nmsgstr \"A cookie used by the server to verify hashes.\"\n\n#: ../../08-haaletamine.rst:660\nmsgid \"Võimalikud veateated päringu ``RPC.Challenge`` korral.\"\nmsgstr \"Possible error messages in case of ``RPC.Challenge`` query.\"\n\n#: ../../08-haaletamine.rst:666\nmsgid \"\"\n\"Valijarakendus teeb päringu ``RPC.Token`` autentimistõendi \"\n\"valideerimiseks.\"\nmsgstr \"\"\n\"The voting application will query ``RPC.Token`` to validate the \"\n\"authentication token.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"params.Token\"\nmsgstr \"params.Token\"\n\n#: ../../08-haaletamine.rst:670\nmsgid \"Web eID autentimistõend.\"\nmsgstr \"Web eID authentication certificate.\"\n\n#: ../../08-haaletamine.rst:677\nmsgid \"Autentimistõend teistele IVXV teenustele esitamiseks\"\nmsgstr \"Proof of authentication for submission to other IVXV services\"\n\n#: ../../08-haaletamine.rst:680\nmsgid \"\"\n\"Päringu staatus - ``OK`` viitab edukale autentimisele. Vastuse muud \"\n\"väljad sisaldavad infot vaid siis kui väärtus on ``OK``.\"\nmsgstr \"\"\n\"Query status - ``OK`` indicates successful authentication. The other \"\n\"fields in the response contain information only if the value is ``OK``.\"\n\n#: ../../08-haaletamine.rst:690\nmsgid \"Võimalikud veateated päringu ``RPC.Token`` korral.\"\nmsgstr \"Possible error messages in case of ``RPC.Token`` query.\"\n\n#: ../../08-haaletamine.rst:694\nmsgid \"Viga valija Web eID isikutuvastussertifikaadiga.\"\nmsgstr \"Error with the voter's Web eID identity certificate.\"\n\n#: ../../08-haaletamine.rst:698\nmsgid \"Hääle kontrollimine\"\nmsgstr \"Vote verification\"\n\n#: ../../08-haaletamine.rst:700\nmsgid \"\"\n\"Kontrollrakendus teeb päringu ``RPC.Verify`` allkirjastatud hääle ning \"\n\"häält kvalifitseerivate tõendite allalaadimiseks kogumisteenusest.\"\nmsgstr \"\"\n\"The Verification Application will query ``RPC.Verify`` to download the \"\n\"signed vote and the evidence that qualifies the vote from the collection \"\n\"service.\"\n\n#: ../../08-haaletamine.rst:703\nmsgid \"Operatsioonisüsteem, millel kontrollrakendust kasutatakse.\"\nmsgstr \"The operating system on which the verification application is used.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"params.VoteID\"\nmsgstr \"params.VoteID\"\n\n#: ../../08-haaletamine.rst:704\nmsgid \"\"\n\"QR-koodi vahendusel valijarakendusest saadud hääle identifikaator \"\n\"talletusteenuses.\"\nmsgstr \"\"\n\"The identifier of the vote received from the voting application via QR \"\n\"code in the storage service.\"\n\n#: ../../08-haaletamine.rst:713\nmsgid \"Vaata peatükki hääle verifitseerimisest\"\nmsgstr \"See chapter on vote verification\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result.Type\"\nmsgstr \"result.Type\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result.Vote\"\nmsgstr \"result.Vote\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result.ChoicesList\"\nmsgstr \"result.ChoicesList\"\n\n#: ../../08-haaletamine.rst:720\nmsgid \"JSON-vormingus ringkonnapõhine valikute nimekiri.\"\nmsgstr \"A JSON-formatted list of district-based options.\"\n\n#: ../../08-haaletamine.rst:726\nmsgid \"Võimalikud veateated päringu ``RPC.Verify`` korral.\"\nmsgstr \"Possible error messages in case of ``RPC.Verify`` request.\"\n\n#: ../../08-haaletamine.rst:734\nmsgid \"E-hääletamise jooksev nimekiri\"\nmsgstr \"List of e-votes\"\n\n#: ../../08-haaletamine.rst:736\nmsgid \"\"\n\"X-tee teenusega(xroad-service) liidestuva abiteenuse (SNI \"\n\"``votesorder.ivxv.invalid``) kasutatakse informatsiooni edastamiseks \"\n\"X-tee turvaserverile.\"\nmsgstr \"\"\n\"The auxiliary service (SNI ``votesorder.ivxv.invalid``), which interfaces\"\n\" with the X-road service (xroad-service), is used to send information to \"\n\"the X-road security server.\"\n\n#: ../../08-haaletamine.rst:741\nmsgid \"Viimane järjenumber\"\nmsgstr \"Last serial number\"\n\n#: ../../08-haaletamine.rst:742\nmsgid \"\"\n\"X-tee teenus(xroad-service) teeb päringu ``RPC.VotesSeqNo`` viimase \"\n\"järjenumbri saamiseks.\"\nmsgstr \"\"\n\"The X-road service (xroad-service) makes a query ``RPC.VotesSeqNo`` for \"\n\"the last sequence number.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result.SeqNo\"\nmsgstr \"result.SeqNo\"\n\n#: ../../08-haaletamine.rst:749\nmsgid \"Viimane järjenumber.\"\nmsgstr \"Latest sequence number.\"\n\n#: ../../08-haaletamine.rst:755\nmsgid \"Võimalikud veateated päringu ``RPC.VotesSeqNo`` korral.\"\nmsgstr \"Possible error messages in case of query ``RPC.VotesSeqNo``.\"\n\n#: ../../08-haaletamine.rst:761\nmsgid \"E-hääletamiste pakk\"\nmsgstr \"E-voting package\"\n\n#: ../../08-haaletamine.rst:762\nmsgid \"\"\n\"X-tee teenus(xroad-service) teeb päringu ``RPC.Votes`` e-hääletamise paki\"\n\" saamiseks.\"\nmsgstr \"\"\n\"The X-road service (xroad-service) makes a request for an ``RPC.Votes`` \"\n\"e-voting packet.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"params.VotesFrom\"\nmsgstr \"params.VotesFrom\"\n\n#: ../../08-haaletamine.rst:764\nmsgid \"E-hääled alates sellest järjenumbrist.\"\nmsgstr \"E-votes from this serial number.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"params.BatchMaxSize\"\nmsgstr \"params.BatchMaxSize\"\n\n#: ../../08-haaletamine.rst:765\nmsgid \"E-hääletamise paki suurus.\"\nmsgstr \"Size of e-voting package.\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result.batchRecords\"\nmsgstr \"result.batchRecords\"\n\n#: ../../08-haaletamine.rst:772\nmsgid \"E-häälte loend\"\nmsgstr \"List of e-votes\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result.batchRecords.seqNo\"\nmsgstr \"result.batchRecords.seqNo\"\n\n#: ../../08-haaletamine.rst:774\nmsgid \"Hääle järjenumber\"\nmsgstr \"Voice of the sequel\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result.batchRecords.idCode\"\nmsgstr \"result.batchRecords.idCode\"\n\n#: ../../08-haaletamine.rst:776\nmsgid \"Hääletaja isikukood\"\nmsgstr \"Voter identification code\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result.batchRecords.voterName\"\nmsgstr \"result.batchRecords.voterName\"\n\n#: ../../08-haaletamine.rst:778\nmsgid \"Hääletaja nimi\"\nmsgstr \"Name of voter\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result.batchRecords.kovCode\"\nmsgstr \"result.batchRecords.kovCode\"\n\n#: ../../08-haaletamine.rst:780\nmsgid \"KOV EHAK kood\"\nmsgstr \"KOV EHAK code\"\n\n#: ../../08-haaletamine.rst\nmsgid \"result.batchRecords.electoralDistrictNo\"\nmsgstr \"result.batchRecords.electoralDistrictNo\"\n\n#: ../../08-haaletamine.rst:782\nmsgid \"Valimisringkonna number\"\nmsgstr \"Constituency number\"\n\n#: ../../08-haaletamine.rst:788\nmsgid \"Võimalikud veateated päringu ``RPC.Votes`` korral.\"\nmsgstr \"Possible error messages in case of ``RPC.Votes`` query.\"\n\n#~ msgid \"result.DocumentNo\"\n#~ msgstr \"result.DocumentNo\"\n\n#~ msgid \"params.DocumentNo\"\n#~ msgstr \"params.DocumentNo\"\n\n#~ msgid \"Hääle allkirjastaja Smart-ID dokumendi number.\"\n#~ msgstr \"Smart ID document number of the person who signed the vote.\"\n\n" }, { "path": "Documentation/public/protokollid/locales/en/LC_MESSAGES/09-tootlemine.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-03 08:56+0000\\n\"\n\"PO-Revision-Date: 2024-03-01 18:35+0200\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: en \\n\"\n\"Language: en\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../09-tootlemine.rst:5\nmsgid \"E-valimiskasti töötlemisetapi andmestruktuurid\"\nmsgstr \"Data structures for the digital ballot box processing phase\"\n\n#: ../../09-tootlemine.rst:9\nmsgid \"Tühistus- ja ennistusnimekiri\"\nmsgstr \"Revocation and Restoration List\"\n\n#: ../../09-tootlemine.rst:11\nmsgid \"\"\n\"Tühistus- ja ennistusnimekiri sisaldab andmeid isikute kohta, kelle e-hääl \"\n\"tuleb tühistada (ei lähe arvesse valimistulemuste kokkulugemisel) või \"\n\"ennistada (s.t. tühistatakse eelnev tühistamine ning häälte uuesti üle \"\n\"lugemisel võetakse ennistatud e-hääl arvesse). Nimekiri laaditakse süsteemi \"\n\"digitaalselt allkirjastatud dokumendina, mille andmefaili vorming on \"\n\"järgmine:\"\nmsgstr \"\"\n\"The revocation and restoration lists contain information on the persons \"\n\"whose e-vote is to be annulled (not counted in the count) or restored (i.e. \"\n\"the previous annulment is cancelled and the restored e-vote is counted in \"\n\"the recount). The list will be uploaded to the system as a digitally signed \"\n\"document with the following data file format:\"\n\n#: ../../09-tootlemine.rst:17 ../../09-tootlemine.rst:35\n#: ../../09-tootlemine.rst:61 ../../09-tootlemine.rst:146\nmsgid \"Näide:\"\nmsgstr \"Example:\"\n\n#: ../../09-tootlemine.rst:24\nmsgid \"E-hääletanute nimekiri\"\nmsgstr \"List of e-voters\"\n\n#: ../../09-tootlemine.rst:26\nmsgid \"\"\n\"E-hääletanute nimekiri on pärast e-hääletamise lõppu väljastatav nimekiri \"\n\"e-hääletanud isikutest, sordituna valimisjaoskondade kaupa. Dokument \"\n\"genereeritakse töötlemisrakenduse poolt.\"\nmsgstr \"\"\n\"The list of e-voters is the list of e-voters issued after the end of \"\n\"e-voting, sorted by polling station. The document is generated by the \"\n\"processing application.\"\n\n#: ../../09-tootlemine.rst:42\nmsgid \"Hääletamistulemus\"\nmsgstr \"Voting results\"\n\n#: ../../09-tootlemine.rst:44\nmsgid \"\"\n\"Võtmerakenduse poolt dekrüpteeritud ning summeeritud hääled jagatud \"\n\"valimisringkondade ja jaoskondade kaupa.\"\nmsgstr \"\"\n\"Votes decrypted and summed by the key application, broken down by district \"\n\"and polling station.\"\n\n#: ../../09-tootlemine.rst:47\nmsgid \"\"\n\"Hääletamistulemuste failis peavad iga jaoskonna kohta olema järgmised \"\n\"andmed.\"\nmsgstr \"\"\n\"The voting results file must contain the following information for each \"\n\"station.\"\n\n#: ../../09-tootlemine.rst:49\nmsgid \"\"\n\"Rikutud ja kehtetute häälte arvu näitav kirje. Seda ka juhul, kui \"\n\"valimisjaoskonnas polnud ühtki rikutud või kehtetut häält: sellisel juhul on\"\n\" häälte arv null.\"\nmsgstr \"\"\n\"A record showing the number of spoilt and invalid votes. This is the case \"\n\"even if there were no spoilt or invalid votes in the polling station: in \"\n\"this case the number of votes is zero.\"\n\n#: ../../09-tootlemine.rst:53\nmsgid \"\"\n\"Iga valiku poolt antud häälte arvu näitav kirje. Seda ka juhul, kui \"\n\"valimisjaoskonnas ei antud selle valiku poolt ühtki häält: sellisel juhul on\"\n\" häälte arv null.\"\nmsgstr \"\"\n\"A record showing the number of votes cast for each option. This is the case \"\n\"even if no votes were cast for that option in the polling station: in this \"\n\"case the number of votes is zero.\"\n\n#: ../../09-tootlemine.rst:69\nmsgid \"E-valimiskast\"\nmsgstr \"Ballot box\"\n\n#: ../../09-tootlemine.rst:71\nmsgid \"\"\n\"Fail sisaldab kogumisteenuse poolt vastu võetud hääli koos häälte juurde \"\n\"kuuluvate andmetega.\"\nmsgstr \"\"\n\"The file contains the votes received by the collection service, together \"\n\"with the data associated with the votes.\"\n\n#: ../../09-tootlemine.rst:74\nmsgid \"Faili vorming on Zip64 konteiner.\"\nmsgstr \"The file format is Zip64 container.\"\n\n#: ../../09-tootlemine.rst:76\nmsgid \"Valija-spetsiifilised kaustad asuvad vahetult juurkausta `votes` all.\"\nmsgstr \"\"\n\"The voter-specific folders are located just below the `votes` root folder.\"\n\n#: ../../09-tootlemine.rst:78\nmsgid \"Faili sisu:\"\nmsgstr \"File content:\"\n\n#: ../../09-tootlemine.rst:80\nmsgid \":file:`votes//`\"\nmsgstr \":file:`votes//`\"\n\n#: ../../09-tootlemine.rst:82\nmsgid \":file:`.version`\"\nmsgstr \":file:`.version`\"\n\n#: ../../09-tootlemine.rst:84\nmsgid \":file:`.`\"\nmsgstr \":file:`.`\"\n\n#: ../../09-tootlemine.rst:86\nmsgid \":file:`.*`\"\nmsgstr \":file:`.*`\"\n\n#: ../../09-tootlemine.rst:88\nmsgid \"kus:\"\nmsgstr \"where:\"\n\n#: ../../09-tootlemine.rst:90\nmsgid \"```` on valija identifikaator, Eesti puhul isikukood;\"\nmsgstr \"\"\n\"```` is the voter's identifier, which in Estonia is the voter's \"\n\"personal identification number;\"\n\n#: ../../09-tootlemine.rst:92\nmsgid \"\"\n\"```` on hääle esitamise kellaaeg vormingus \"\n\"``yyyymmddhhmmssmmm±zzzz``;\"\nmsgstr \"\"\n\"```` is the time of day for the submission of the vote in the \"\n\"format ``yyymmddhhmmmmmmm±zzzz``;\"\n\n#: ../../09-tootlemine.rst:95\nmsgid \"\"\n\"see kellaaeg kajastab hetke, mil päring kogumisteenusesse tehti, ja on antud\"\n\" lihtsalt valimiskasti inimloetavuse parandamiseks; hääle tegelik ajamärk \"\n\"või -tempel on mõne kvalifitseeriva vastuse sees;\"\nmsgstr \"\"\n\"this time reflects the moment when the query was made to the collection \"\n\"service and is given simply to improve the human readability of the ballot \"\n\"box; the actual time stamp or time stamp of the vote is inside some \"\n\"qualifying response;\"\n\n#: ../../09-tootlemine.rst:99\nmsgid \"```` on valikute konteineri tüüp, Eesti puhul BDOC;\"\nmsgstr \"\"\n\"```` is the type of the ballot container, for Estonia BDOC;\"\n\n#: ../../09-tootlemine.rst:101\nmsgid \"\"\n\"kusjuures BDOC ise on lihtsalt põhiprofiiliga ja ei sisalda kvalifitseerivad\"\n\" parameetreid (kehtivuskinnitusi, ajamärgendeid, ajatempleid),\"\nmsgstr \"\"\n\"whereas the BDOC itself is just a basic profile and does not contain any \"\n\"qualifying parameters (validations, timemarks, timestamps),\"\n\n#: ../../09-tootlemine.rst:105\nmsgid \"\"\n\"```` on häält kvalifitseeriva protokolli tüüp, millest hetkel \"\n\"võimalikud on:\"\nmsgstr \"\"\n\"```` is the type of vote qualifying protocol currently possible:\"\n\n#: ../../09-tootlemine.rst:108\nmsgid \"\"\n\"``ocsp`` - *Online Certificate Status Protocol* (kehtivuskinnitus, `RFC 6960\"\n\" `_) kinnitab valija \"\n\"allkirjastamissertifikaadi kehtivust hääle andmise hetkel,\"\nmsgstr \"\"\n\"``ocsp`` - *Online Certificate Status Protocol* (`RFC 6960 \"\n\"`_) confirms the validity of the \"\n\"voter's signature certificate at the moment of casting the vote,\"\n\n#: ../../09-tootlemine.rst:112\nmsgid \"\"\n\"``tsp`` - *Time-Stamp Protocol* (ajatempel, `RFC 3161 \"\n\"`_) kinnitab, et päringu tegemise \"\n\"hetkeks oli hääl olemas,\"\nmsgstr \"\"\n\"``tsp`` - *Time-Stamp Protocol* (timestamp, `RFC 3161 \"\n\"`_) confirms that a ballot was present \"\n\"at the time the request was made,\"\n\n#: ../../09-tootlemine.rst:116\nmsgid \"\"\n\"``tspreg`` - sama, mis ``tsp``, aga nonsiks pannakse kogumisteenuse allkiri \"\n\"päringu ``MessageImprint`` elemendil, et häält registreerida.\"\nmsgstr \"\"\n\"``tspreg`` - the same as ``tsp``, but with the addition of the collection \"\n\"service signature on the ``MessageImprint`` element of the query to register\"\n\" the vote.\"\n\n#: ../../09-tootlemine.rst:119\nmsgid \"Iga hääle kohta esinevad failid on:\"\nmsgstr \"The files per vote are:\"\n\n#: ../../09-tootlemine.rst:121\nmsgid \"\"\n\"``.version`` - hääle andmise ajal kehtinud valijate nimekirja \"\n\"versioon;\"\nmsgstr \"\"\n\"``.version`` - the version of the electoral roll in force at the \"\n\"time the vote was cast;\"\n\n#: ../../09-tootlemine.rst:124\nmsgid \"\"\n\"``.`` - valikute konteiner, mille sees on valiku \"\n\"identifikaator kujul ``..ballot``. Eesti puhul \"\n\"BDOC-konteineris olev vastava nimega fail;\"\nmsgstr \"\"\n\"``.`` - a ballot container containing a ballot \"\n\"identifier of the form ``..ballot``. In the case of \"\n\"Estonia, the file with the corresponding name in the BDOC container;\"\n\n#: ../../09-tootlemine.rst:128\nmsgid \"\"\n\"``.`` - häält kvalifitseeriva protokolli päringu \"\n\"vastus; neid võib esineda mitu, aga iga protokolli kohta maksimaalselt üks.\"\nmsgstr \"\"\n\"``.`` - the response to the query of the protocol \"\n\"qualifying the vote; there may be more than one, but not more than one per \"\n\"protocol.\"\n\n#: ../../09-tootlemine.rst:134\nmsgid \"Anonüümistatud e-valimiskast\"\nmsgstr \"Anonymous ballot box\"\n\n#: ../../09-tootlemine.rst:136\nmsgid \"\"\n\"Valimisringkondade ja jaoskondade järgi grupeeritud krüpteeritud hääled. \"\n\"Anonüümistatud e-valimiskastis puudub informatsioon valijate kohta.\"\nmsgstr \"\"\n\"Encrypted votes grouped by districts and stations. No information on voters \"\n\"is available in the anonymised e-voting box.\"\n\n#: ../../09-tootlemine.rst:139\nmsgid \"\"\n\"Anonüümistatud e-valimiskast on töötlemisrakenduse väljund ning \"\n\"võtmerakenduse dekrüpteerimise tööriista sisend.\"\nmsgstr \"\"\n\"The anonymised e-voting box is the output of the processing application and \"\n\"the input of the decryption tool of the key application.\"\n" }, { "path": "Documentation/public/protokollid/locales/en/LC_MESSAGES/11-audit.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-03 19:52+0000\\n\"\n\"PO-Revision-Date: 2024-03-01 18:43+0200\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: en \\n\"\n\"Language: en\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../11-audit.rst:5\nmsgid \"Hääletamistulemuse audit\"\nmsgstr \"Audit of voting results\"\n\n#: ../../11-audit.rst:8\nmsgid \"Miksimistõendi kontroll\"\nmsgstr \"Verification of Proof-of-Shuffle\"\n\n#: ../../11-audit.rst:10\nmsgid \"\"\n\"Miksimistõendi kontrollimiseks kasutatakse algoritmi nagu on defineeritud \"\n\"`Verificatumi verifitseerija implementeerimise manuaalis \"\n\"`_.\"\nmsgstr \"\"\n\"The verification of the proof-of-shuffle is done using the algorithm as \"\n\"defined in the `Verificatum Verifier Implementation Manual \"\n\"`_.\"\n\n#: ../../11-audit.rst:14\nmsgid \"\"\n\"Märgime, et miksimistõendi koostamisel lisatakse krüptogrammile andmed \"\n\"valimiste, ringkonna, jaoskonna ja küsimuse identifikaatori kohta. \"\n\"Lisamiseks kodeeritakse vastav väli rühma elemendina, kasutades \"\n\"pimendamiseks juhuslikkust 0. Näitena, kui esialgu on krüptogramm :math:`c_0\"\n\" = (c_{00}, c_{01})`, kasutades avalikku võtit :math:`pk = (g, y)`, siis \"\n\"Verificatumi sisendina kasutatakse laia krüptogrammi :math:`C = (c_{id}, \"\n\"c_d, c_s, c_q, c_0)`, kus:\"\nmsgstr \"\"\n\"Note that when the proof-of-shuffle is generated, the cryptogram is appended\"\n\" with the election, district, station and question identifier. For the \"\n\"purpose of insertion, the corresponding field is coded as a group element \"\n\"using randomness 0 for obfuscation. As an example, if the initial cryptogram\"\n\" is :math:`c_0 = (c_{00}, c_{01})` using the public key :math:`pk = (g, y)`,\"\n\" then the input to Verificatum is a broad cryptogram :math:`C = (c_{id}, \"\n\"c_d, c_s, c_q, c_0)` where:\"\n\n#: ../../11-audit.rst:21\nmsgid \"\"\n\"valimiste identifikaatori pseudokrüptogramm on antud kujul :math:`c_{id} = \"\n\"(1, encode(id))`, kus funktsioon :math:`encode` kodeerib sõne vastava rühma \"\n\"elemendina ja `id` on valimiste identifikaatori sõne.\"\nmsgstr \"\"\n\"the pseudocryptogram of the election identifier is given by :math:`c_{id} = \"\n\"(1, encode(id))`, where :math:`encode` encodes the seed as an element of the\"\n\" corresponding group and `id` is the seed of the election identifier.\"\n\n#: ../../11-audit.rst:24\nmsgid \"\"\n\"ringkonna identifikaatori pseudokrüptogramm on antud kujul :math:`c_d = (1, \"\n\"encode(d))`, kus `d` on ringkonna identifikaatori sõne.\"\nmsgstr \"\"\n\"the pseudocryptogram of the district identifier is given by :math:`c_d = (1,\"\n\" encode(d))`, where `d` is the seed of the district identifier.\"\n\n#: ../../11-audit.rst:26\nmsgid \"\"\n\"jaoskonna identifikaatori pseudokrüptogramm on antud kujul :math:`c_s = (1, \"\n\"encode(s))`, kus `s` on jaoskonna identifikaatori sõne.\"\nmsgstr \"\"\n\"the pseudocryptogram of the station identifier is given by :math:`c_s = (1, \"\n\"encode(s))`, where `s` is the seed of the station identifier.\"\n\n#: ../../11-audit.rst:28\nmsgid \"\"\n\"küsimuse identifikaatori pseudokrüptogramm on antud kujul :math:`c_q = (1, \"\n\"encode(q))`, kus `q` on küsimuse identifikaatori sõne.\"\nmsgstr \"\"\n\"the pseudocryptogram of the question identifier is given by :math:`c_q = (1,\"\n\" encode(q))`, where `q` is the seed of the question identifier.\"\n\n#: ../../11-audit.rst:31\nmsgid \"\"\n\"Sellisel juhul defineeritakse laia krüptogrammile vastava avaliku võtmena \"\n\":math:`((g,1), (g,1), (g,1), (g,1), (g,y))`.\"\nmsgstr \"\"\n\"In this case, the public key corresponding to the wide cryptogram is defined\"\n\" as :math:`((g,1), (g,1), (g,1), (g,1), (g,y))`.\"\n\n#: ../../11-audit.rst:35\nmsgid \"Korrektse dekrüpteerimise tõendi kontroll\"\nmsgstr \"Checking the Proof-of-Decryption\"\n\n#: ../../11-audit.rst:37\nmsgid \"\"\n\"Olgu antud krüptogramm :math:`c = (c_0, c_1)`, mis dekrüpteeritakse \"\n\"väärtuseks :math:`d` antud avaliku võtmega :math:`pk` üle parameetrite \"\n\":math:`(p,g)` ja dekrüpteerimistõendiga :math:`(a,b,s)`.\"\nmsgstr \"\"\n\"Given a cryptogram :math:`c = (c_0, c_1)`, decrypted to the value :math:`d` \"\n\"with the given public key :math:`pk` over the parameters :math:`(p,g)` and \"\n\"the decryption key :math:`(a,b,s)`.\"\n\n#: ../../11-audit.rst:41\nmsgid \"\"\n\"Korrektse dekrüpteerimise kontrollimise jaoks on tarvis arvutada mitte-\"\n\"interaktiivne kontrollija väljakutse. Selle jaoks kodeeritakse \"\n\":math:`\\\"DECRYPTION\\\" || pk || c || d || a || b` DER-kodeeringus. Baidijada \"\n\"kasutatakse deterministliku juhuarvugeneraatori initsialiseerimiseks ja \"\n\"selle väljundist loetakse rühma järgu pikkune täisarv :math:`k`.\"\nmsgstr \"\"\n\"To verify the proof-of-decryption it is necessary to calculate the challenge\"\n\" for non-interactive verifier. For this purpose, :math:`\\\"DECRYPTION\\\" || pk\"\n\" || c || d || a || b` is encoded in DER encoding. The byte sequence is used \"\n\"to initialise a deterministic random number generator and its output is read\"\n\" as a group-order integer :math:`k`.\"\n\n#: ../../11-audit.rst:47\nmsgid \"\"\n\"Dekrüpteerimistõendi kontrolliks tuleb veenduda, et :math:`c_0^s = a * \"\n\"(c_1/d)^k` ja :math:`g^s = b * y^k`.\"\nmsgstr \"\"\n\"To check the decryption proof, make sure that :math:`c_0^s = a * (c_1/d)^k` \"\n\"and :math:`g^s = b * y^k`.\"\n\n#: ../../11-audit.rst:51\nmsgid \"Korrektse teisendamise kontroll\"\nmsgstr \"Correct conversion check\"\n\n#: ../../11-audit.rst:53\nmsgid \"\"\n\"Kontrollimaks, et teisendus IVXV e-valimiskasti ja Verificatumi \"\n\"krüptogrammide vahel on tehtud korrektselt, tuleb korrata teisendust \"\n\"sõltumatult. Pärast sõltumatut teisendust tuleb võrrelda saadud väljundeid. \"\n\"Kuna teisendamine on deterministlik protseduur, siis garanteerib kordamine \"\n\"tegevuse õigsuse.\"\nmsgstr \"\"\n\"To verify that the conversion between the IVXV ballot Box and the \"\n\"Verificatum cryptograms has been done correctly, the conversion must be \"\n\"repeated independently. After the independent conversion, the resulting \"\n\"outputs must be compared. Since the conversion is a deterministic procedure,\"\n\" the repetition guarantees the correctness of the operation.\"\n" }, { "path": "Documentation/public/protokollid/locales/en/LC_MESSAGES/12-lisad.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2025.\n#\n#, fuzzy\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.0\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-03 19:52+0000\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language-Team: en \\n\"\n\"Language: en\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../12-lisad.rst:5\nmsgid \"Lisad\"\nmsgstr \"More\"\n\n#: ../../12-lisad.rst:8\nmsgid \"Andmestruktuuride ASN.1 spetsifikatsioon\"\nmsgstr \"ASN.1 specification of data structures\"\n\n#: ../../12-lisad.rst:10\nmsgid \"IVXV ElGamal üldised andmestruktuurid\"\nmsgstr \"IVXV ElGamal general data structures\"\n\n#: ../../12-lisad.rst:16\nmsgid \"IVXV ElGamal ModP spetsiifilised andmestruktuurid\"\nmsgstr \"IVXV ElGamal ModP specific data structures\"\n\n#: ../../12-lisad.rst:22\nmsgid \"IVXV ElGamal ECC spetsiifilised andmestruktuurid\"\nmsgstr \"IVXV ElGamal ECC specific data structures\"\n\n#: ../../12-lisad.rst:31\nmsgid \"Elektroonilise hääle vormingu spetsifikatsioon\"\nmsgstr \"Specification for electronic voice formatting\"\n\n#: ../../12-lisad.rst:33\nmsgid \"\"\n\"Käesoleva protokolliversiooniga kooskõlaline ettepanek VVK otsuseks \"\n\"hääletamissedeli ja elektroonilise hääle vormi kehtestamiseks.\"\nmsgstr \"\"\n\"Proposal for a decision of the IGC establishing the voting form and the \"\n\"electronic voting form, in conformity with this version of the minutes.\"\n\n#: ../../12-lisad.rst:40\nmsgid \"Vead töötlemisprotsessis\"\nmsgstr \"Errors in the processing\"\n\n#: ../../12-lisad.rst:42\nmsgid \"\"\n\"Anname ülevaate veakoodidest töötlemisprotsessis. Veakoodid kirjeldavad vigu\"\n\" üksiku elemendi verifitseerimisel - hääl, registreerimistõend, \"\n\"registreerimispäring - ning häälte, registreerimistõendite ja \"\n\"registreerimispäringute vahelise vastavuse loomisel.\"\nmsgstr \"\"\n\"We give an overview of error codes in the processing process. Error codes \"\n\"describe errors in the verification of a single element - vote, registration\"\n\" certificate, registration request - and in the matching of votes, \"\n\"registration certificates and registration requests.\"\n\n#: ../../12-lisad.rst:47\nmsgid \"\"\n\"Enamus veaolukordi on pigem hüpoteetilised (nt. `REG_NO_NONCE`), siiski on \"\n\"tegemist olukordadega, mis programselt võivad esineda ning seetõttu tuleb \"\n\"neid ka käsitleda.\"\nmsgstr \"\"\n\"Most of the error situations are rather hypothetical (e.g. `REG_NO_NONCE`), \"\n\"however, they are situations that can occur programmatically and therefore \"\n\"need to be addressed.\"\n\n#: ../../12-lisad.rst:51\nmsgid \"\"\n\"Veaolukord tähendab, et konkreetne element ei liigu edasi töötlemise \"\n\"järgmisesse faasi.\"\nmsgstr \"\"\n\"An error condition means that a particular element does not move on to the \"\n\"next phase of processing.\"\n\n#: ../../12-lisad.rst:53\nmsgid \"Töötlemisprotsessi veakoodid\"\nmsgstr \"Error codes for the processing process\"\n\n#: ../../12-lisad.rst:57 ../../12-lisad.rst:121\nmsgid \"Veakood\"\nmsgstr \"Error code\"\n\n#: ../../12-lisad.rst:58 ../../12-lisad.rst:122\nmsgid \"Selgitus\"\nmsgstr \"Explanation\"\n\n#: ../../12-lisad.rst:59\nmsgid \"``INVALID_FILE_NAME``\"\nmsgstr \"``INVALID_FILE_NAME``\"\n\n#: ../../12-lisad.rst:60\nmsgid \"Failinimi ei vasta oodatud mustrile. Viitab tundmatule failile urnis.\"\nmsgstr \"\"\n\"The file name does not match the expected pattern. Refers to an unknown file\"\n\" in the urn.\"\n\n#: ../../12-lisad.rst:61\nmsgid \"``MISSING_FILE``\"\nmsgstr \"``MISSING_FILE``\"\n\n#: ../../12-lisad.rst:62\nmsgid \"Mõni hääle koosseisuks vajalik fail puudub. Nt. ajatempel.\"\nmsgstr \"\"\n\"Some of the files needed to compose the votes are missing. E.g. timestamp.\"\n\n#: ../../12-lisad.rst:63\nmsgid \"``REPEATED_FILE``\"\nmsgstr \"``REPEATED_FILE``\"\n\n#: ../../12-lisad.rst:64\nmsgid \"Mõnda hääle koosseisuks vajalikku faili on mitu. Nt. kehtivuskinnitus.\"\nmsgstr \"\"\n\"There are several files needed to compose some votes. E.g. validity \"\n\"confirmation.\"\n\n#: ../../12-lisad.rst:65\nmsgid \"``UNKNOWN_FILE_TYPE``\"\nmsgstr \"``UNKNOWN_FILE_TYPE``\"\n\n#: ../../12-lisad.rst:66\nmsgid \"Faili tüüp on tundmatu või mittetoetatud.\"\nmsgstr \"The file type is unknown or unsupported.\"\n\n#: ../../12-lisad.rst:67\nmsgid \"``INVALID_FILE_SIZE``\"\nmsgstr \"``INVALID_FILE_SIZE``\"\n\n#: ../../12-lisad.rst:68\nmsgid \"\"\n\"Allkirjastatud hääle faili suurus ei vasta seadistustes nõutud \"\n\"kriteeriumitele.\"\nmsgstr \"\"\n\"The size of the signed vote file does not meet the criteria required in the \"\n\"settings.\"\n\n#: ../../12-lisad.rst:69\nmsgid \"``INVALID_BALLOT_SIGNATURE``\"\nmsgstr \"``INVALID_BALLOT_SIGNATURE``\"\n\n#: ../../12-lisad.rst:70\nmsgid \"Hääl on vigase allkirjaga.\"\nmsgstr \"The voice has an incorrect signature.\"\n\n#: ../../12-lisad.rst:71\nmsgid \"``MISSING_VOTER_SIGNATURE``\"\nmsgstr \"``MISSING_VOTER_SIGNATURE``\"\n\n#: ../../12-lisad.rst:72\nmsgid \"Hääl ei sisalda valija allkirja.\"\nmsgstr \"The vote does not include the voter's signature.\"\n\n#: ../../12-lisad.rst:73\nmsgid \"``VOTER_NOT_FOUND``\"\nmsgstr \"``VOTER_NOT_FOUND``\"\n\n#: ../../12-lisad.rst:74\nmsgid \"Valija ei olnud hääletamise hetkel valijate nimekirjas.\"\nmsgstr \"The voter was not on the electoral roll at the time of voting.\"\n\n#: ../../12-lisad.rst:75\nmsgid \"``VOTERLIST_NOT_FOUND``\"\nmsgstr \"``VOTERLIST_NOT_FOUND``\"\n\n#: ../../12-lisad.rst:76\nmsgid \"Versioonile vastavat valijate nimekirja ei leitud.\"\nmsgstr \"No voter list matching the version was found.\"\n\n#: ../../12-lisad.rst:77\nmsgid \"``TIME_BEFORE_START``\"\nmsgstr \"``TIME_BEFORE_START``\"\n\n#: ../../12-lisad.rst:78\nmsgid \"Hääl on antud enne hääletamisperioodi algust. Viitab testhäälele.\"\nmsgstr \"\"\n\"The vote is cast before the start of the voting period. Refers to a test \"\n\"vote.\"\n\n#: ../../12-lisad.rst:79\nmsgid \"``REG_RESP_INVALID``\"\nmsgstr \"``REG_RESP_INVALID``\"\n\n#: ../../12-lisad.rst:80\nmsgid \"Registreerimistõend/ajatempel on vigane. Viga ATOs või töötlejas.\"\nmsgstr \"\"\n\"The registration certificate/time stamp is invalid. Error in ATO or \"\n\"processor.\"\n\n#: ../../12-lisad.rst:81\nmsgid \"``REG_REQ_INVALID``\"\nmsgstr \"``REG_REQ_INVALID``\"\n\n#: ../../12-lisad.rst:82\nmsgid \"Registreerimispäring on vigane. Viga kogumisteenuses või töötlejas.\"\nmsgstr \"\"\n\"The registration request is invalid. Error in collection service or \"\n\"processor.\"\n\n#: ../../12-lisad.rst:83\nmsgid \"``REG_RESP_NOT_UNIQUE``\"\nmsgstr \"``REG_RESP_NOT_UNIQUE``\"\n\n#: ../../12-lisad.rst:84\nmsgid \"\"\n\"Registreerimistõend ei ole unikaalne. Viga kogumisteenuses või töötlejas.\"\nmsgstr \"\"\n\"The registration certificate is not unique. Error in collection service or \"\n\"processor.\"\n\n#: ../../12-lisad.rst:85\nmsgid \"``REG_REQ_NOT_UNIQUE``\"\nmsgstr \"``REG_REQ_NOT_UNIQUE``\"\n\n#: ../../12-lisad.rst:86\nmsgid \"\"\n\"Registreerimispäring ei ole unikaalne. Sama räsiga häält on esitatud \"\n\"korduvalt.\"\nmsgstr \"\"\n\"The registration request is not unique. The same ragged vote has been \"\n\"submitted multiple times.\"\n\n#: ../../12-lisad.rst:87\nmsgid \"``REG_NO_NONCE``\"\nmsgstr \"``REG_NO_NONCE``\"\n\n#: ../../12-lisad.rst:88\nmsgid \"Registreerimistõendis puudub nonss.\"\nmsgstr \"There is no nonss on the registration certificate.\"\n\n#: ../../12-lisad.rst:89\nmsgid \"``REG_NONCE_NOT_SIG``\"\nmsgstr \"``REG_NONCE_NOT_SIG``\"\n\n#: ../../12-lisad.rst:90\nmsgid \"Esitatud nonss ei ole IVXV protokolli kohaselt allkirjastatud.\"\nmsgstr \"\"\n\"The submitted nonss have not been signed in accordance with Protocol IVXV.\"\n\n#: ../../12-lisad.rst:91\nmsgid \"``REG_NONCE_ALG_MISMATCH``\"\nmsgstr \"``REG_NONCE_ALG_MISMATCH``\"\n\n#: ../../12-lisad.rst:92\nmsgid \"Nonssi allkirjastamisel kasutatud algoritm ei vasta oodatule.\"\nmsgstr \"\"\n\"The algorithm used to sign the nonsense does not match the expected one.\"\n\n#: ../../12-lisad.rst:93\nmsgid \"``REG_NONCE_SIG_INVALID``\"\nmsgstr \"``REG_NONCE_SIG_INVALID``\"\n\n#: ../../12-lisad.rst:94\nmsgid \"Nonssi allkiri on vigane.\"\nmsgstr \"Nonss's signature is incorrect.\"\n\n#: ../../12-lisad.rst:95\nmsgid \"``UNKNOWN_FILE_IN_VOTE_CONTAINER``\"\nmsgstr \"``UNKNOWN_FILE_IN_VOTE_CONTAINER``\"\n\n#: ../../12-lisad.rst:96\nmsgid \"Hääle konteineris on tundmatu fail.\"\nmsgstr \"There is an unknown file in the voice container.\"\n\n#: ../../12-lisad.rst:97\nmsgid \"``TECHNICAL_ERROR``\"\nmsgstr \"``TECHNICAL_ERROR``\"\n\n#: ../../12-lisad.rst:98\nmsgid \"Töötlemise ajal tekkis tehniline viga.\"\nmsgstr \"A technical error occurred during processing.\"\n\n#: ../../12-lisad.rst:99\nmsgid \"``REG_RESP_REQ_UNMATCH``\"\nmsgstr \"``REG_RESP_REQ_UNMATCH``\"\n\n#: ../../12-lisad.rst:100\nmsgid \"Registreerimistõendi andmed ei vasta registreerimispäringu andmetele.\"\nmsgstr \"\"\n\"The information on the registration certificate does not match the \"\n\"information on the registration request.\"\n\n#: ../../12-lisad.rst:101\nmsgid \"``REG_REQ_WITHOUT_BALLOT``\"\nmsgstr \"``REG_REQ_WITHOUT_BALLOT``\"\n\n#: ../../12-lisad.rst:102\nmsgid \"\"\n\"Esitatud on registreerimispäring, kuid hääl puudub urnist. Kogumisteenuse \"\n\"viga.\"\nmsgstr \"\"\n\"A registration request has been submitted, but there is no vote in the \"\n\"ballot box. Collection service error.\"\n\n#: ../../12-lisad.rst:103\nmsgid \"``BALLOT_WITHOUT_REG_REQ``\"\nmsgstr \"``BALLOT_WITHOUT_REG_REQ``\"\n\n#: ../../12-lisad.rst:104\nmsgid \"Hääl on esitatud ilma vastava registreerimispäringuta. ATO viga.\"\nmsgstr \"\"\n\"The vote is submitted without a corresponding registration request. ATO \"\n\"error.\"\n\n#: ../../12-lisad.rst:105\nmsgid \"``SAME_TIME_AS_LATEST``\"\nmsgstr \"``SAME_TIME_AS_LATEST``\"\n\n#: ../../12-lisad.rst:106\nmsgid \"Kaks häält samalt valijalt võivad olla arvesse võetavad viimasena.\"\nmsgstr \"Two votes from the same voter may be counted last.\"\n\n#: ../../12-lisad.rst:107\nmsgid \"``INVALID_SIGNATURE_PROFILE``\"\nmsgstr \"``INVALID_SIGNATURE_PROFILE``\"\n\n#: ../../12-lisad.rst:108\nmsgid \"Hääle allkirjaprofiil on vigane.\"\nmsgstr \"The signature profile of the vote is incorrect.\"\n\n#: ../../12-lisad.rst:111\nmsgid \"\"\n\"Töötlemise käigus tuvastatakse kehtetud sedelid sellisel määral, mil seda \"\n\"võimaldavad kontrollid avaliku võtmega. Kuigi kogumisteenus ei luba \"\n\"kehtetuid sedeleid talletada, peab töötlemisrakendus kontrolle siiski \"\n\"kordama tagamaks mh. võimalike tarkvaravigade vältimise.\"\nmsgstr \"\"\n\"Invalid tags will be identified during the processing to the extent that \"\n\"public key checks allow. Although the collection service does not allow the \"\n\"storage of invalid tags, the processing application must still repeat the \"\n\"checks to ensure, inter alia, that possible software bugs are avoided.\"\n\n#: ../../12-lisad.rst:117\nmsgid \"Krüptogrammide kehtivuse kontrolli veakoodid\"\nmsgstr \"Cryptogram validity check error codes\"\n\n#: ../../12-lisad.rst:123\nmsgid \"``INVALID_BYTES``\"\nmsgstr \"``INVALID_BYTES``\"\n\n#: ../../12-lisad.rst:124\nmsgid \"Baidijada ei ole dekodeeritav ElGamalCiphertext'na\"\nmsgstr \"Baidijada is not decodable by ElGamalCiphertext\"\n\n#: ../../12-lisad.rst:125\nmsgid \"``INVALID_GROUP``\"\nmsgstr \"``INVALID_GROUP``\"\n\n#: ../../12-lisad.rst:126\nmsgid \"Väärtus ei ole oodatud rühma element\"\nmsgstr \"The value is not an expected group element\"\n\n#: ../../12-lisad.rst:127\nmsgid \"``INVALID_RANGE``\"\nmsgstr \"``INVALID_RANGE``\"\n\n#: ../../12-lisad.rst:128\nmsgid \"Väärtus on lubatud vahemikust väljas.\"\nmsgstr \"The value is out of range.\"\n\n#: ../../12-lisad.rst:129\nmsgid \"``INVALID_QR``\"\nmsgstr \"``INVALID_QR```\"\n\n#: ../../12-lisad.rst:130\nmsgid \"Väärtus ei ole ruutjääk (MODP).\"\nmsgstr \"The value is not a square residual (MODP).\"\n\n#: ../../12-lisad.rst:131\nmsgid \"``INVALID_POINT``\"\nmsgstr \"``INVALID_POINT``\"\n\n#: ../../12-lisad.rst:132\nmsgid \"Väärtus ei ole kõvera punkt (ECC).\"\nmsgstr \"The value is not the point of the curve (ECC).\"\n\n#: ../../12-lisad.rst:133\nmsgid \"``INVALID``\"\nmsgstr \"``INVALID``\"\n\n#: ../../12-lisad.rst:134\nmsgid \"Vigane šifreeritud tekst.\"\nmsgstr \"Erroneous shifter text.\"\n\n#~ msgid \"IVXV ElGamal ECC spetsifiilised andmestruktuurid\"\n#~ msgstr \"\"\n" }, { "path": "Documentation/public/protokollid/locales/en/LC_MESSAGES/index.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2024, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.8.2\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2024-02-29 10:34+0200\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language-Team: en \\n\"\n\"Language: en\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"Generated-By: Babel 2.10.3\\n\"\n\n#: ../../index.rst:5\nmsgid \"IVXV protokollid\"\nmsgstr \"IVXV Protocols\"\n" }, { "path": "Documentation/public/protokollid/model/Makefile", "content": "# Source diagrams are all in different .pu files\nSRC_DIAG=\n\nPARENT=sequence\n\n# Sub-diagrams are generated from $(PARENT).pu\nSUB_DIAG=phase1 phase2 phase3\n\n\ninclude ../../../common-model.mk\n\n\n# Set environment variables for subdiagrams\nphase1.env:\n\t$(eval DIAGRAM_DEF=-DPHASE_1)\n\nphase2.env:\n\t$(eval DIAGRAM_DEF=-DPHASE_2)\n\nphase3.env:\n\t$(eval DIAGRAM_DEF=-DPHASE_3)\n" }, { "path": "Documentation/public/protokollid/model/en/lang.pu", "content": "\n!define TR_A_VOTER() Voter\n!define TR_P_VOTA() Voting application\n!define TR_P_VERA() Verification app\n\n!define TR_BOX_COLLECT() Online (RIA)\n!define TR_P_COLLECT() Collection service\n\n!define TR_BOX_REG() Registration service (SK)\n!define TR_P_REG() Registration service\n\n!define TR_BOX_PROCESSOR() Offline (RVT)\n!define TR_P_PROCESSOR() Processor\n\n\n!define TR_PHASE1() Voter votes\n!define TR_PHASE2() Voter verifies the vote\n!define TR_PHASE3() Services hand over the data\n!define TR_PHASE4() Processor verifies consistency of the data\n\n" }, { "path": "Documentation/public/protokollid/model/et/lang.pu", "content": "\n!define TR_A_VOTER() Hääletaja\n!define TR_P_VOTA() Valijarakendus\n!define TR_P_VERA() Kontrollrakendus\n\n!define TR_BOX_COLLECT() Online (RIA)\n!define TR_P_COLLECT() Kogumisteenus\n\n!define TR_BOX_REG() Registreerimisteenus (SK)\n!define TR_P_REG() Registreerimisteenus\n\n!define TR_BOX_PROCESSOR() Offline (RVT)\n!define TR_P_PROCESSOR() Töötlemisrakendus\n\n\n!define TR_PHASE1() Hääletaja hääletab\n!define TR_PHASE2() Hääletaja kontrollib häält\n!define TR_PHASE3() Teenused annavad andmed üle\n!define TR_PHASE4() Töötleja kontrollib teenuste vaateid\n\n" }, { "path": "Documentation/public/protokollid/model/sequence.pu", "content": "@startuml\n\n\n!ifdef PHASE_1\n !define PHASE_VOTE\n !define PHASE_VOTER\n !define PHASE_COLLECT\n !define PHASE_REG\n!endif\n\n!ifdef PHASE_2\n !define PHASE_VERIFY\n !define PHASE_VOTER\n !define PHASE_COLLECT\n!endif\n\n!ifdef PHASE_3\n !define PHASE_COLLECT\n !define PHASE_REG\n !define PHASE_PROC\n!endif\n\n\n\n!ifdef PHASE_VOTER\nactor \"TR_A_VOTER()\" as a_voter\n!endif\n\n!ifdef PHASE_VOTE\nparticipant \"TR_P_VOTA()\" as p_vota\n!endif\n\n!ifdef PHASE_VERIFY\nparticipant \"TR_P_VERA()\" as p_vera\n!endif\n\n!ifdef PHASE_COLLECT\nbox \"TR_BOX_COLLECT()\"\n participant \"TR_P_COLLECT()\" as p_collect\nend box\n!endif\n\n!ifdef PHASE_REG\nbox \"TR_BOX_REG()\"\nparticipant \"TR_P_REG()\" as p_reg\nend box\n!endif\n\n!ifdef PHASE_PROC\nbox \"TR_BOX_PROCESSOR()\"\n participant \"TR_P_PROCESSOR()\" as p_processor\nend box\n!endif\n\n\n!ifdef PHASE_1\n\n== TR_PHASE1() ==\n\na_voter --> p_vota: ballot_v, key_v\n\np_vota -> p_collect: vote_v = Sign(key_v, Enc(ballot_v))\n\np_collect -> p_reg: reg_request_v = Sign(key_k, (v_id, Hash(vote_v)))\n\np_reg -> p_reg: VerifyAndStore(reg_request_v, cert_k)\n\np_reg -> p_collect: reg_confirmation_v = Sign(key_r, Hash(reg_request_v))\n\np_collect -> p_collect: VerifyAndStore(reg_confirmation_v, cert_r)\n\np_collect -> p_vota: v_id, reg_request_v, reg_confirmation_v\n\np_vota -> p_vota: Verify(reg_request_v, cert_k)\np_vota -> p_vota: Verify(reg_confirmation_v, cert_r)\np_vota -> p_vota: Verify(reg_confirmation_v, reg_request_v, vote_v)\np_vota --> a_voter: v_id\n\n!endif\n\n\n!ifdef PHASE_2\n\n== TR_PHASE2() ==\n\na_voter --> p_vera: v_id\n\np_vera -> p_collect: v_id\n\np_collect -> p_vera: vote_v, reg_request_v, reg_confirmation_v\n\np_vera -> p_vera: Verify(reg_request_v, cert_k)\np_vera -> p_vera: Verify(reg_confirmation_v, cert_r)\np_vera -> p_vera: Verify(reg_confirmation_v, reg_request_v, vote_v)\np_vera --> a_voter: ballot_v\n\n!endif\n\n\n!ifdef PHASE_3\n\n== TR_PHASE3() ==\n\np_collect -> p_processor: (v_id, vote_i, reg_request_i, reg_confirmation_i)\np_reg -> p_processor: (v_id, Hash(vote_i), reg_request_i)\n\n\n== TR_PHASE4() ==\n\n!endif\n\n\n\n@enduml\n" }, { "path": "Documentation/public/protokollid/paragraph.txt", "content": "3. Kehtestada elektroonilise hääle vorm järgmiselt (skeem lisatud).\n\n 3.1. Valijarakenduses elektrooniliselt allkirjastatud elektrooniline\n hääl on digitaalselt allkirjastatud fail, mille nimi on teksti\n kujul e-hääletamise aeg (ajatempel). Faili sees asub punktis 3.2\n nimetatud salastatud (krüpteeritud) elektrooniline hääl ja valija\n elektrooniline allkiri. Elektroonilise allkirja sertifikaatide\n kehtivuskinnitus ja ajatempel saadakse usaldusteenuse pakkujalt\n kogujasse eraldi ning valijarakenduse faili ennast ei muudeta,\n vaid kehtivuskinnitus ja ajatempel hoiustatakse valijarakenduses\n loodud allkirjastatud failist lahus.\n\n 3.2. Elektrooniline hääl on krüpteeritud Riigikogu valimiste seaduse\n §483 lõike 3 alusel hääletamiseks loodud elektrooniliste häälte\n salastamise võtmega andmefail. Faili nimi algab valimiste või\n rahvahääletuse identifikaatoriga ja lõpeb küsimuse\n identifikaatoriga. Faili laiend on .ballot. Faili sees on\n krüpteeritud kujul punktides 3.4, 3.5, 3.6 või 3.7 nimetatud\n andmeelemendid vastavalt sellele, kas tegemist on Euroopa\n Parlamendi, Riigikogu või kohaliku omavalitsuse volikogu valimiste\n või rahvahääletusega.\n\n 3.3. Avatud (dekrüpteeritud) elektrooniline hääl on elektrooniliste\n häälte avamise arvuti (võtmeprotseduurideks mõeldud arvuti) mälus\n olev andmehulk, mis koosneb kahest andmeelemendist ja neid\n eraldavatest märgenditest.\n\n 3.4. Euroopa Parlamendi valimiste andmeelementide ja märgendite\n järjekord on:\n\n 3.4.1. sõne 0000 ja märgend ASCII kuueteistkümnendkood 2E;\n\n 3.4.2. kandidaadi registreerimisnumber.\n\n 3.5. Riigikogu valimiste andmeelementide ja märgendite järjekord on:\n\n 3.5.1. sõne 0000 ja märgend ASCII kuueteistkümnendkood 2E;\n\n 3.5.2. kandidaadi registreerimisnumber.\n\n 3.6. Kohaliku omavalitsuse volikogu valimiste andmeelementide ja\n märgendite järjekord on:\n\n 3.6.1. kohaliku omavalitsuse üksuse EHAK kood ja märgend ASCII\n kuueteistkümnendkood 2E;\n\n 3.6.2. kandidaadi registreerimisnumber.\n\n 3.7. Rahvahääletuse andmeelementide ja märgendite järjekord on:\n\n 3.7.1. sõne 0000 ja märgend ASCII kuueteistkümnendkood 2E;\n\n 3.7.2. vastuse kood.\n" }, { "path": "Documentation/public/protokollid/spelling_wordlist.txt", "content": "" }, { "path": "Documentation/public/uldsisukord/.gitignore", "content": "nimekiri.rst\n" }, { "path": "Documentation/public/uldsisukord/Makefile", "content": "DEPENDENCIES := nimekiri.rst\ninclude ../../common.mk\n\nnimekiri.rst:\n\t../../documents.py > $@\n" }, { "path": "Documentation/public/uldsisukord/annotatsioon.rst", "content": ".. IVXV dokumentatsiooni üldsisukord\n\nAnnotatsioon\n------------\n\nIVXV dokumentatsiooni üldsisukord,\ninfosüsteemi dokumentide sisukorradokument.\n" }, { "path": "Documentation/public/uldsisukord/index.rst", "content": ".. IVXV dokumentatsiooni üldsisukord\n\nIVXV dokumentatsiooni üldsisukord\n=========================================================================\n\n.. raw:: html\n\n

\n NB!\n See on HTML-versioon dokumendist.\n Tellijale antakse üle PDF-versioon.\n

\n\n\n.. toctree::\n :maxdepth: 2\n\n annotatsioon\n nimekiri\n tarned\n" }, { "path": "Documentation/public/uldsisukord/locales/en/LC_MESSAGES/annotatsioon.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2024-02-29 10:34+0200\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language-Team: en \\n\"\n\"Language: en\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"Generated-By: Babel 2.10.3\\n\"\n\n#: ../../annotatsioon.rst:4\nmsgid \"Annotatsioon\"\nmsgstr \"Annotation\"\n\n#: ../../annotatsioon.rst:6\nmsgid \"\"\n\"IVXV dokumentatsiooni üldsisukord, infosüsteemi dokumentide \"\n\"sisukorradokument.\"\nmsgstr \"\"\n\"Table of contents for the IVXV documentation.\"\n" }, { "path": "Documentation/public/uldsisukord/locales/en/LC_MESSAGES/index.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2024, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2024-02-29 10:34+0200\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language-Team: en \\n\"\n\"Language: en\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"Generated-By: Babel 2.10.3\\n\"\n\n#: ../../index.rst:4\nmsgid \"IVXV dokumentatsiooni üldsisukord\"\nmsgstr \"IVXV documentation overview\"\n" }, { "path": "Documentation/public/uldsisukord/locales/en/LC_MESSAGES/nimekiri.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2025, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2025.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-25 13:00+0000\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language: en\\n\"\n\"Language-Team: en \\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../nimekiri.rst:4\nmsgid \"Dokumendid\"\nmsgstr \"Documents\"\n\n#: ../../nimekiri.rst:7\nmsgid \"Ülddokumendid\"\nmsgstr \"General documents\"\n\n#: ../../nimekiri.rst:14 ../../nimekiri.rst:32 ../../nimekiri.rst:65\n#: ../../nimekiri.rst:98\nmsgid \"Nimi\"\nmsgstr \"Name\"\n\n#: ../../nimekiri.rst:15 ../../nimekiri.rst:33 ../../nimekiri.rst:66\n#: ../../nimekiri.rst:99\nmsgid \"ID\"\nmsgstr \"ID\"\n\n#: ../../nimekiri.rst:16 ../../nimekiri.rst:34 ../../nimekiri.rst:67\n#: ../../nimekiri.rst:100\nmsgid \"Versioon\"\nmsgstr \"Version\"\n\n#: ../../nimekiri.rst:17 ../../nimekiri.rst:35 ../../nimekiri.rst:68\n#: ../../nimekiri.rst:101\nmsgid \"Kuupäev\"\nmsgstr \"Date\"\n\n#: ../../nimekiri.rst:19\nmsgid \"IVXV dokumentatsiooni üldsisukord\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:20\nmsgid \"IVXV-YS-1.10\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:21 ../../nimekiri.rst:44 ../../nimekiri.rst:49\n#: ../../nimekiri.rst:72 ../../nimekiri.rst:77 ../../nimekiri.rst:82\n#: ../../nimekiri.rst:87 ../../nimekiri.rst:105 ../../nimekiri.rst:110\n#: ../../nimekiri.rst:115 ../../nimekiri.rst:125 ../../nimekiri.rst:130\n#: ../../nimekiri.rst:135\nmsgid \"1.10\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:22 ../../nimekiri.rst:45 ../../nimekiri.rst:50\n#: ../../nimekiri.rst:73 ../../nimekiri.rst:78 ../../nimekiri.rst:83\n#: ../../nimekiri.rst:88 ../../nimekiri.rst:106 ../../nimekiri.rst:111\n#: ../../nimekiri.rst:116 ../../nimekiri.rst:126 ../../nimekiri.rst:131\n#: ../../nimekiri.rst:136\nmsgid \"25.09.2025\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:25\nmsgid \"Spetsifikatsioonid\"\nmsgstr \"Specifications\"\n\n#: ../../nimekiri.rst:37\nmsgid \"IVXV kasutusmallid\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:38\nmsgid \"IVXV-KM-1.8.1\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:39\nmsgid \"1.8.1\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:40\nmsgid \"16.12.2022\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:42\nmsgid \"IVXV protokollide kirjeldus\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:43\nmsgid \"IVXV-PR-1.10\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:47\nmsgid \"IVXV arhitektuur\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:48\nmsgid \"IVXV-AR-1.10\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:52\nmsgid \"IVXV võtmerakendus\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:53\nmsgid \"IVXV-SVR-1.8.0\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:54 ../../nimekiri.rst:120\nmsgid \"1.8.0\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:55 ../../nimekiri.rst:121\nmsgid \"01.12.2022\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:58\nmsgid \"Ingliskeelsed dokumendid\"\nmsgstr \"Documents in english\"\n\n#: ../../nimekiri.rst:70\nmsgid \"IVXV protocols\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:71\nmsgid \"IVXV-PR-EN-1.10\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:75\nmsgid \"IVXV architecture\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:76\nmsgid \"IVXV-AR-EN-1.10\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:80\nmsgid \"VIS3-EHS interfaces\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:81\nmsgid \"IVXV-VIS-EHS-EN-1.10\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:85\nmsgid \"IVXV Backend Log Messages\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:86\nmsgid \"IVXV-LOGS-EN-1.10\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:91\nmsgid \"Juhendid\"\nmsgstr \"User guides\"\n\n#: ../../nimekiri.rst:103\nmsgid \"IVXV seadistuste koostamise juhend\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:104\nmsgid \"IVXV-JSK-1.10\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:108\nmsgid \"IVXV kogumisteenuse haldusjuhend\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:109\nmsgid \"IVXV-JSH-1.10\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:113\nmsgid \"IVXV haldusteenuse kasutusjuhend\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:114\nmsgid \"IVXV-JHT-1.10\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:118\nmsgid \"IVXV API\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:119\nmsgid \"IVXV-API-1.8.0\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:123\nmsgid \"IVXV audiitori juhend\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:124\nmsgid \"IVXV-JAJ-1.10\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:128\nmsgid \"IVXV valijarakendus\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:129\nmsgid \"IVXV-JVR-1.10\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:133\nmsgid \"IVXV valijarakenduse pakendamine\"\nmsgstr \"\"\n\n#: ../../nimekiri.rst:134\nmsgid \"IVXV-JVP-1.10\"\nmsgstr \"\"\n" }, { "path": "Documentation/public/uldsisukord/locales/en/LC_MESSAGES/tarned.po", "content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2016-2024, Cybernetica AS\n# This file is distributed under the same license as the Elektroonilise\n# hääletamise infosüsteem package.\n# FIRST AUTHOR , 2024.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: Elektroonilise hääletamise infosüsteem 1.10.3\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2025-09-25 13:06+0000\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language: en\\n\"\n\"Language-Team: en \\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Generated-By: Babel 2.15.0\\n\"\n\n#: ../../tarned.rst:4\nmsgid \"Tarned\"\nmsgstr \"Deliveries\"\n\n#: ../../tarned.rst:7\nmsgid \"Muudatused tarne 1.10.4 koosseisus, erinevused võrreldes tarnega 1.10.3\"\nmsgstr \"\"\n\"Changes in the composition of the delivery 1.10.4, differences compared \"\n\"to delivery 1.10.3.\"\n\n#: ../../tarned.rst:10 ../../tarned.rst:78 ../../tarned.rst:146\n#: ../../tarned.rst:236 ../../tarned.rst:302 ../../tarned.rst:380\n#: ../../tarned.rst:451 ../../tarned.rst:545 ../../tarned.rst:614\n#: ../../tarned.rst:688 ../../tarned.rst:762 ../../tarned.rst:844\n#: ../../tarned.rst:921 ../../tarned.rst:1003 ../../tarned.rst:1084\n#: ../../tarned.rst:1174 ../../tarned.rst:1263\nmsgid \"Kogumisteenus\"\nmsgstr \"Collection service\"\n\n#: ../../tarned.rst:12 ../../tarned.rst:80 ../../tarned.rst:148\n#: ../../tarned.rst:238 ../../tarned.rst:304 ../../tarned.rst:382\n#: ../../tarned.rst:453 ../../tarned.rst:547 ../../tarned.rst:616\n#: ../../tarned.rst:690 ../../tarned.rst:764 ../../tarned.rst:846\n#: ../../tarned.rst:923 ../../tarned.rst:1005 ../../tarned.rst:1086\n#: ../../tarned.rst:1176\nmsgid \"Üldised muutused\"\nmsgstr \"General changes\"\n\n#: ../../tarned.rst:14\nmsgid \"Valijate nimekirjade muudatuste allalaadimise täpsustused\"\nmsgstr \"Clarify the download process for voterlist changesets\"\n\n#: ../../tarned.rst:17 ../../tarned.rst:85 ../../tarned.rst:160\n#: ../../tarned.rst:243 ../../tarned.rst:311 ../../tarned.rst:387\n#: ../../tarned.rst:470 ../../tarned.rst:555 ../../tarned.rst:625\n#: ../../tarned.rst:703 ../../tarned.rst:779 ../../tarned.rst:860\n#: ../../tarned.rst:938 ../../tarned.rst:1018 ../../tarned.rst:1102\n#: ../../tarned.rst:1193 ../../tarned.rst:1295\nmsgid \"Registreerimisteenus\"\nmsgstr \"Registration service\"\n\n#: ../../tarned.rst:19 ../../tarned.rst:26 ../../tarned.rst:30\n#: ../../tarned.rst:35 ../../tarned.rst:42 ../../tarned.rst:46\n#: ../../tarned.rst:50 ../../tarned.rst:54 ../../tarned.rst:59\n#: ../../tarned.rst:71 ../../tarned.rst:82 ../../tarned.rst:87\n#: ../../tarned.rst:94 ../../tarned.rst:98 ../../tarned.rst:103\n#: ../../tarned.rst:110 ../../tarned.rst:114 ../../tarned.rst:118\n#: ../../tarned.rst:122 ../../tarned.rst:127 ../../tarned.rst:139\n#: ../../tarned.rst:162 ../../tarned.rst:186 ../../tarned.rst:245\n#: ../../tarned.rst:261 ../../tarned.rst:268 ../../tarned.rst:272\n#: ../../tarned.rst:276 ../../tarned.rst:280 ../../tarned.rst:285\n#: ../../tarned.rst:290 ../../tarned.rst:313 ../../tarned.rst:389\n#: ../../tarned.rst:407 ../../tarned.rst:414 ../../tarned.rst:427\n#: ../../tarned.rst:472 ../../tarned.rst:491\nmsgid \"Muudatused puuduvad\"\nmsgstr \"No changes\"\n\n#: ../../tarned.rst:22 ../../tarned.rst:90 ../../tarned.rst:165\n#: ../../tarned.rst:248 ../../tarned.rst:316 ../../tarned.rst:392\n#: ../../tarned.rst:475 ../../tarned.rst:560 ../../tarned.rst:630\n#: ../../tarned.rst:708 ../../tarned.rst:784 ../../tarned.rst:865\n#: ../../tarned.rst:943 ../../tarned.rst:1023 ../../tarned.rst:1106\n#: ../../tarned.rst:1197 ../../tarned.rst:1299\nmsgid \"Kontrollrakendused\"\nmsgstr \"Verification applications\"\n\n#: ../../tarned.rst:24 ../../tarned.rst:92 ../../tarned.rst:167\n#: ../../tarned.rst:250 ../../tarned.rst:318 ../../tarned.rst:394\n#: ../../tarned.rst:477 ../../tarned.rst:562 ../../tarned.rst:632\n#: ../../tarned.rst:710 ../../tarned.rst:786 ../../tarned.rst:867\n#: ../../tarned.rst:945 ../../tarned.rst:1025 ../../tarned.rst:1108\n#: ../../tarned.rst:1199 ../../tarned.rst:1301\nmsgid \"Android\"\nmsgstr \"Android\"\n\n#: ../../tarned.rst:28 ../../tarned.rst:96 ../../tarned.rst:175\n#: ../../tarned.rst:254 ../../tarned.rst:324 ../../tarned.rst:399\n#: ../../tarned.rst:483 ../../tarned.rst:567 ../../tarned.rst:638\n#: ../../tarned.rst:714 ../../tarned.rst:791 ../../tarned.rst:871\n#: ../../tarned.rst:949 ../../tarned.rst:1029 ../../tarned.rst:1114\n#: ../../tarned.rst:1204 ../../tarned.rst:1305\nmsgid \"iOS\"\nmsgstr \"iOS\"\n\n#: ../../tarned.rst:33 ../../tarned.rst:101 ../../tarned.rst:184\n#: ../../tarned.rst:259 ../../tarned.rst:331 ../../tarned.rst:405\n#: ../../tarned.rst:489 ../../tarned.rst:572 ../../tarned.rst:645\n#: ../../tarned.rst:719 ../../tarned.rst:797 ../../tarned.rst:876\n#: ../../tarned.rst:954 ../../tarned.rst:1034 ../../tarned.rst:1119\n#: ../../tarned.rst:1211 ../../tarned.rst:1310\nmsgid \"Miksnet\"\nmsgstr \"Mixnet\"\n\n#: ../../tarned.rst:38 ../../tarned.rst:106 ../../tarned.rst:189\n#: ../../tarned.rst:264 ../../tarned.rst:336 ../../tarned.rst:410\n#: ../../tarned.rst:494 ../../tarned.rst:577 ../../tarned.rst:650\n#: ../../tarned.rst:724 ../../tarned.rst:802 ../../tarned.rst:882\n#: ../../tarned.rst:959 ../../tarned.rst:1039 ../../tarned.rst:1124\n#: ../../tarned.rst:1216 ../../tarned.rst:1314\nmsgid \"Töötleja rakendused\"\nmsgstr \"Processor applications\"\n\n#: ../../tarned.rst:40 ../../tarned.rst:108 ../../tarned.rst:191\n#: ../../tarned.rst:266 ../../tarned.rst:338 ../../tarned.rst:412\n#: ../../tarned.rst:496 ../../tarned.rst:579 ../../tarned.rst:652\n#: ../../tarned.rst:726 ../../tarned.rst:804 ../../tarned.rst:884\n#: ../../tarned.rst:961 ../../tarned.rst:1041 ../../tarned.rst:1126\nmsgid \"Üldised\"\nmsgstr \"General\"\n\n#: ../../tarned.rst:44 ../../tarned.rst:112 ../../tarned.rst:195\n#: ../../tarned.rst:270 ../../tarned.rst:343 ../../tarned.rst:416\n#: ../../tarned.rst:500 ../../tarned.rst:583 ../../tarned.rst:656\n#: ../../tarned.rst:730 ../../tarned.rst:808 ../../tarned.rst:888\n#: ../../tarned.rst:965 ../../tarned.rst:1045 ../../tarned.rst:1132\n#: ../../tarned.rst:1218 ../../tarned.rst:1315\nmsgid \"Võtmerakendus\"\nmsgstr \"Key application\"\n\n#: ../../tarned.rst:48 ../../tarned.rst:116 ../../tarned.rst:199\n#: ../../tarned.rst:274 ../../tarned.rst:348 ../../tarned.rst:421\n#: ../../tarned.rst:505 ../../tarned.rst:587 ../../tarned.rst:660\n#: ../../tarned.rst:734 ../../tarned.rst:812 ../../tarned.rst:892\n#: ../../tarned.rst:969 ../../tarned.rst:1052 ../../tarned.rst:1136\n#: ../../tarned.rst:1222 ../../tarned.rst:1319\nmsgid \"Töötlemisrakendus\"\nmsgstr \"Processing application\"\n\n#: ../../tarned.rst:52 ../../tarned.rst:120 ../../tarned.rst:203\n#: ../../tarned.rst:278 ../../tarned.rst:353 ../../tarned.rst:425\n#: ../../tarned.rst:510 ../../tarned.rst:591 ../../tarned.rst:664\n#: ../../tarned.rst:738 ../../tarned.rst:816 ../../tarned.rst:896\n#: ../../tarned.rst:973 ../../tarned.rst:1056 ../../tarned.rst:1140\n#: ../../tarned.rst:1229 ../../tarned.rst:1323\nmsgid \"Auditirakendus\"\nmsgstr \"Audit application\"\n\n#: ../../tarned.rst:57 ../../tarned.rst:125 ../../tarned.rst:208\n#: ../../tarned.rst:283 ../../tarned.rst:359 ../../tarned.rst:430\n#: ../../tarned.rst:516 ../../tarned.rst:596 ../../tarned.rst:669\n#: ../../tarned.rst:743 ../../tarned.rst:821 ../../tarned.rst:901\n#: ../../tarned.rst:979 ../../tarned.rst:1061 ../../tarned.rst:1145\n#: ../../tarned.rst:1234 ../../tarned.rst:1328\nmsgid \"Valijarakendused ja seadistusrakendus\"\nmsgstr \"Voting applications and configuration app\"\n\n#: ../../tarned.rst:62 ../../tarned.rst:130 ../../tarned.rst:217\n#: ../../tarned.rst:288 ../../tarned.rst:365 ../../tarned.rst:435\n#: ../../tarned.rst:528 ../../tarned.rst:601 ../../tarned.rst:675\n#: ../../tarned.rst:748 ../../tarned.rst:828 ../../tarned.rst:906\n#: ../../tarned.rst:985 ../../tarned.rst:1066 ../../tarned.rst:1157\n#: ../../tarned.rst:1245 ../../tarned.rst:1338\nmsgid \"Dokumentatsioon\"\nmsgstr \"Documentation\"\n\n#: ../../tarned.rst:64\nmsgid \"Numeratsiooni läbivaatus\"\nmsgstr \"\"\n\n#: ../../tarned.rst:65\nmsgid \"Võtmerakenduse seadistuste täpsustamine\"\nmsgstr \"Clarify the configuration of key app\"\n\n#: ../../tarned.rst:66\nmsgid \"Smart-ID protokolli näidete täpsustamine\"\nmsgstr \"Improved SmartID protocol examples\"\n\n#: ../../tarned.rst:69 ../../tarned.rst:137 ../../tarned.rst:224\n#: ../../tarned.rst:293 ../../tarned.rst:371 ../../tarned.rst:441\n#: ../../tarned.rst:534 ../../tarned.rst:606 ../../tarned.rst:680\n#: ../../tarned.rst:753 ../../tarned.rst:833 ../../tarned.rst:911\n#: ../../tarned.rst:992 ../../tarned.rst:1076 ../../tarned.rst:1163\n#: ../../tarned.rst:1251 ../../tarned.rst:1342\nmsgid \"Logimonitor\"\nmsgstr \"Logmonitor\"\n\n#: ../../tarned.rst:75\nmsgid \"Muudatused tarne 1.10.3 koosseisus, erinevused võrreldes tarnega 1.10.2\"\nmsgstr \"\"\n\"Changes in the composition of the delivery 1.10.3, differences compared \"\n\"to delivery 1.10.2.\"\n\n#: ../../tarned.rst:132 ../../tarned.rst:219\nmsgid \"Tõlgete läbivaatus\"\nmsgstr \"\"\n\n#: ../../tarned.rst:133 ../../tarned.rst:220\nmsgid \"Õigekirja läbivaatus\"\nmsgstr \"\"\n\n#: ../../tarned.rst:134 ../../tarned.rst:221\nmsgid \"Tarne 1.10.2 sisu dokumenteerimine\"\nmsgstr \"\"\n\n#: ../../tarned.rst:143\nmsgid \"Muudatused tarne 1.10.2 koosseisus, erinevused võrreldes tarnega 1.10.1\"\nmsgstr \"\"\n\"Changes in the composition of the delivery 1.10.2, differences compared \"\n\"to delivery 1.10.1.\"\n\n#: ../../tarned.rst:150 ../../tarned.rst:193\nmsgid \"ZIP/BDOC failide käsitluse parendamine\"\nmsgstr \"Improve handling of ZIP/BDOC files\"\n\n#: ../../tarned.rst:151\nmsgid \"Sõltuvuste uuendamine, JavaScript\"\nmsgstr \"Update dependencies, JavaScript\"\n\n#: ../../tarned.rst:152\nmsgid \"eID vahendite testimine\"\nmsgstr \"Test eID tools\"\n\n#: ../../tarned.rst:153\nmsgid \"Mälulekete parandamine\"\nmsgstr \"Fix memory leaks\"\n\n#: ../../tarned.rst:154\nmsgid \"Smart-ID voogude uuendamine vastavalt protokollile\"\nmsgstr \"Update Smart-ID flows according the protocol\"\n\n#: ../../tarned.rst:155\nmsgid \"Nimekirjade laadimise intervalli ja strateegia täpsustamine\"\nmsgstr \"Update the logic and configuration of downloading voterlists\"\n\n#: ../../tarned.rst:156\nmsgid \"Arendus- ja testkeskkonna parendused\"\nmsgstr \"Improvements to test and development tools\"\n\n#: ../../tarned.rst:157 ../../tarned.rst:197 ../../tarned.rst:201\n#: ../../tarned.rst:205\nmsgid \"Pisiparandused\"\nmsgstr \"Minor bug fixes\"\n\n#: ../../tarned.rst:169 ../../tarned.rst:177\nmsgid \"Rakenduse kolimine Riigikogu Kantselei poodi\"\nmsgstr \"Move application to Riigikogu Kantselei store\"\n\n#: ../../tarned.rst:170\nmsgid \"TargetSDK uuendamine\"\nmsgstr \"Update TargetSDK\"\n\n#: ../../tarned.rst:171 ../../tarned.rst:178\nmsgid \"Erinevad veaparandused kasutajaliideses\"\nmsgstr \"Minor UX changes/improvements\"\n\n#: ../../tarned.rst:172\nmsgid \"Täiendav obfuskeerimine\"\nmsgstr \"Improved obfuscation\"\n\n#: ../../tarned.rst:173 ../../tarned.rst:181\nmsgid \"Veateadete täiendamine\"\nmsgstr \"Improve error messages\"\n\n#: ../../tarned.rst:179\nmsgid \"Täpsustused rakenduse varundamisele\"\nmsgstr \"Update backup policy\"\n\n#: ../../tarned.rst:180\nmsgid \"Rakenduse elutsükli olekumasina täpsustused\"\nmsgstr \"Improve app lifecycle state machine\"\n\n#: ../../tarned.rst:210\nmsgid \"Sõltuvuste uuendamine, OpenSSL, PCRE\"\nmsgstr \"Update dependencies, OpenSSL, PCRE\"\n\n#: ../../tarned.rst:211\nmsgid \"Kasutajaliidese teegi FLTK uuendamine\"\nmsgstr \"Update UX library FLTK\"\n\n#: ../../tarned.rst:212\nmsgid \"Smart-ID voo uuendamine\"\nmsgstr \"Update of Smart-ID flows\"\n\n#: ../../tarned.rst:213\nmsgid \"Testimine uusima ID-kaardiga\"\nmsgstr \"Test with most recent ID-card\"\n\n#: ../../tarned.rst:214\nmsgid \"Kompileerimiskeskkonna täpsustused\"\nmsgstr \"Improvements to compilation process\"\n\n#: ../../tarned.rst:226\nmsgid \"Sõltuvuste uuendamine, Python, JavaScript\"\nmsgstr \"Update dependencies, Python, JavaScript\"\n\n#: ../../tarned.rst:227\nmsgid \"Veebiliidese täiendused\"\nmsgstr \"Updates to web-interface\"\n\n#: ../../tarned.rst:228\nmsgid \"Päringuvahendaja ``pgbouncer`` kasutuselevõtt\"\nmsgstr \"Add ``pgbouncer``\"\n\n#: ../../tarned.rst:229\nmsgid \"Veebiserveri konfiguratsiooni läbivaatus turvatesti tulemustest lähtudes\"\nmsgstr \"Web-server configuration accordig to security test feedback\"\n\n#: ../../tarned.rst:233\nmsgid \"Muudatused tarne 1.10.1 koosseisus, erinevused võrreldes tarnega 1.10.0\"\nmsgstr \"\"\n\"Changes in the composition of the delivery 1.10.1, differences compared \"\n\"to delivery 1.10.0.\"\n\n#: ../../tarned.rst:240\nmsgid \"Uuenenud SmartID serdiprofiili toetamine\"\nmsgstr \"Support for updated SmartID certificate profile\"\n\n#: ../../tarned.rst:252 ../../tarned.rst:256 ../../tarned.rst:322\n#: ../../tarned.rst:328 ../../tarned.rst:397 ../../tarned.rst:402\nmsgid \"Täpsustused hääle verifitseerimisel, äärejuhtumite läbivaatus\"\nmsgstr \"Clarification of vote verification, corner cases\"\n\n#: ../../tarned.rst:295 ../../tarned.rst:373 ../../tarned.rst:444\nmsgid \"Pisiparandused vastavalt muutuste logile\"\nmsgstr \"Minor changes/improvements according to `changelog` file\"\n\n#: ../../tarned.rst:299\nmsgid \"Muudatused tarne 1.10.0 koosseisus, erinevused võrreldes tarnega 1.9.10\"\nmsgstr \"\"\n\"Changes in the composition of delivery 1.10.0, differences compared to \"\n\"delivery 1.9.10\"\n\n#: ../../tarned.rst:306\nmsgid \"Funktsionaalsus kehtetute sedelite eemaldamiseks kogumisteenuses\"\nmsgstr \"Functionality to remove invalid ballots in the collection service\"\n\n#: ../../tarned.rst:307\nmsgid \"MODP ja elliptkõverate krüptograafia\"\nmsgstr \"ModP and ECC cryptography\"\n\n#: ../../tarned.rst:308 ../../tarned.rst:384 ../../tarned.rst:467\nmsgid \"Erinevad pisiparandused vastavalt muutuste logile\"\nmsgstr \"Minor changes/improvements according to `changelog` file\"\n\n#: ../../tarned.rst:320 ../../tarned.rst:326 ../../tarned.rst:333\n#: ../../tarned.rst:340 ../../tarned.rst:345 ../../tarned.rst:350\n#: ../../tarned.rst:355 ../../tarned.rst:361\nmsgid \"Elliptkõverate krüptograafia\"\nmsgstr \"Elliptic curves\"\n\n#: ../../tarned.rst:321 ../../tarned.rst:327\nmsgid \"Ligipääsetavuse parandamine\"\nmsgstr \"Accessibility improvements\"\n\n#: ../../tarned.rst:341 ../../tarned.rst:346 ../../tarned.rst:351\n#: ../../tarned.rst:356\nmsgid \"Täpsustused urni verifitseerimisel, äärejuhtumite läbivaatus\"\nmsgstr \"Clarifications of ballot box verification, corner cases\"\n\n#: ../../tarned.rst:362\nmsgid \"Proksikasutuse refaktoreerimine\"\nmsgstr \"Refactor proxy usage\"\n\n#: ../../tarned.rst:367\nmsgid \"Protokollidokumendi täiendamine\"\nmsgstr \"Improve protocol document\"\n\n#: ../../tarned.rst:368\nmsgid \"Logide dokumendi loomine\"\nmsgstr \"Create documentation for log items\"\n\n#: ../../tarned.rst:377\nmsgid \"Muudatused tarne 1.9.10 koosseisus, erinevused võrreldes tarnega 1.9.4\"\nmsgstr \"\"\n\"Changes in the composition of delivery 1.9.10, differences compared to \"\n\"delivery 1.9.4\"\n\n#: ../../tarned.rst:396\nmsgid \"FLAG_SECURE kasutuselevõtt\"\nmsgstr \"Use FLAG_SECURE\"\n\n#: ../../tarned.rst:401\nmsgid \"Ligipääsetavuse parendamine\"\nmsgstr \"Accessibility improvements\"\n\n#: ../../tarned.rst:418\nmsgid \"Krüptogrammi kehtetuks kuulutamise äärejuhtumite läbivaatus\"\nmsgstr \"Corner cases for invalid ballot detection\"\n\n#: ../../tarned.rst:423\nmsgid \"Hääle kehtetuks kuulutamise äärejuhtumite läbivaatus\"\nmsgstr \"Corner cases for invalid ballot detection\"\n\n#: ../../tarned.rst:432\nmsgid \"Windows, ligipääsetavuse veaparandused\"\nmsgstr \"Improvement of accessibility under Windows\"\n\n#: ../../tarned.rst:437 ../../tarned.rst:531\nmsgid \"Eesti- ja ingliskeelse dokumentatsiooni ühtlustamine\"\nmsgstr \"Unifying documentation in Estonian and in English\"\n\n#: ../../tarned.rst:438\nmsgid \"Arhitektuuridokumendi täiendamine\"\nmsgstr \"Improve architecture document\"\n\n#: ../../tarned.rst:443\nmsgid \"Hääletamisfaktide edastamise ebaõnnestumise tuvastamine logist\"\nmsgstr \"Detect unsucessful delivery of statistics from the logs\"\n\n#: ../../tarned.rst:448\nmsgid \"Muudatused tarne 1.9.4 koosseisus, erinevused võrreldes tarnega 1.8.2\"\nmsgstr \"\"\n\"Changes in the composition of delivery 1.9.4, differences compared to \"\n\"delivery 1.8.2\"\n\n#: ../../tarned.rst:455 ../../tarned.rst:536\nmsgid \"Ubuntu 22.04 tugi\"\nmsgstr \"Support for Ubuntu 22.04\"\n\n#: ../../tarned.rst:456\nmsgid \"Go versiooniuuendus\"\nmsgstr \"Go version upgrade\"\n\n#: ../../tarned.rst:457\nmsgid \"etcd versiooniuuendus ja seadistamine\"\nmsgstr \"etcd version upgrade and configuration\"\n\n#: ../../tarned.rst:458\nmsgid \"Sõltuvuste ajakohastamine\"\nmsgstr \"Update of dependencies\"\n\n#: ../../tarned.rst:459\nmsgid \"Web eID autentimismeetodi lisamine\"\nmsgstr \"Add Web eID authentication method\"\n\n#: ../../tarned.rst:460\nmsgid \"Session status mikroteenuse lisamine\"\nmsgstr \"Adding a session status microservice\"\n\n#: ../../tarned.rst:461\nmsgid \"EHS statistikaliidese töökindluse tõstmine\"\nmsgstr \"Improving the reliability of statistics interface\"\n\n#: ../../tarned.rst:462\nmsgid \"Valimiste järkjärguline lõpp\"\nmsgstr \"Gradual stop of an event\"\n\n#: ../../tarned.rst:463\nmsgid \"Seansiidentifikaatori muutmine kohustuslikuks\"\nmsgstr \"Mandatory SessionID\"\n\n#: ../../tarned.rst:464\nmsgid \"ASiCe vormingutäpsustus\"\nmsgstr \"ASiCe format clarifications\"\n\n#: ../../tarned.rst:465\nmsgid \"VIS tugi detailstatistikale\"\nmsgstr \"VIS detailed statistics\"\n\n#: ../../tarned.rst:466\nmsgid \"SmartID toe täpsustused\"\nmsgstr \"Improved SmartID support\"\n\n#: ../../tarned.rst:479 ../../tarned.rst:485 ../../tarned.rst:518\nmsgid \"TLS 1.3\"\nmsgstr \"TLS 1.3\"\n\n#: ../../tarned.rst:480\nmsgid \"Sertide pinnimisest loobumine\"\nmsgstr \"Deprecating certificate pinning\"\n\n#: ../../tarned.rst:481 ../../tarned.rst:486\nmsgid \"Valikute nimekirja kontroll\"\nmsgstr \"Verification of a choice list\"\n\n#: ../../tarned.rst:498\nmsgid \"Java 17\"\nmsgstr \"Java 17\"\n\n#: ../../tarned.rst:502\nmsgid \"Kehtetute sedelite korrektse dekrüpteerimise tõestamine\"\nmsgstr \"Proof of correct decryption of invalid ciphertexts\"\n\n#: ../../tarned.rst:507 ../../tarned.rst:538\nmsgid \"Statistika arvutuste täpsustamine\"\nmsgstr \"Calculation of statistics\"\n\n#: ../../tarned.rst:508\nmsgid \"Töötlemisprotseduuride auditeerimise täpsustamine\"\nmsgstr \"Clarification of auditing tools for processing steps\"\n\n#: ../../tarned.rst:512\nmsgid \"Kehtetute sedelite korrektse dekrüpteerimise kontrollimine\"\nmsgstr \"Checking the correct decryption of invalid ciphertexts\"\n\n#: ../../tarned.rst:513\nmsgid \"Sedelite kontrolli täpsustused\"\nmsgstr \"\"\n\n#: ../../tarned.rst:519\nmsgid \"Mitme PKCS11 tokeni tugi\"\nmsgstr \"Support for multiple PKCS11 tokens\"\n\n#: ../../tarned.rst:520\nmsgid \"Windowsi serdituvastuse parendamine\"\nmsgstr \"Improvement of cert handling under Windows\"\n\n#: ../../tarned.rst:521\nmsgid \"Aegunud sertide tuvastamine\"\nmsgstr \"Detection of outdated certificates\"\n\n#: ../../tarned.rst:522\nmsgid \"DLL laadimisvigade parandamine\"\nmsgstr \"Fix errors in DLL loading\"\n\n#: ../../tarned.rst:523\nmsgid \"Ligipääsetavus macOS platvormil\"\nmsgstr \"Accessibility on macOS\"\n\n#: ../../tarned.rst:524\nmsgid \"Kasutajaliidese muudatused\"\nmsgstr \"General GUI changes\"\n\n#: ../../tarned.rst:525\nmsgid \"Kuvatõmmiste automatiseerimine\"\nmsgstr \"Automated screenshots in configuration app\"\n\n#: ../../tarned.rst:530\nmsgid \"Web eID autentimismeetodiga seotud dokumentatsiooni lisamine\"\nmsgstr \"Adding documentation related to the Web eID authentication method\"\n\n#: ../../tarned.rst:537\nmsgid \"Grafana versiooni uuendamine\"\nmsgstr \"Grafana version update\"\n\n#: ../../tarned.rst:542\nmsgid \"Muudatused tarne 1.8.2 koosseisus, erinevused võrreldes tarnega 1.8.1\"\nmsgstr \"\"\n\"Changes in the composition of delivery 1.8.2, differences compared to \"\n\"delivery 1.8.1.\"\n\n#: ../../tarned.rst:549 ../../tarned.rst:581\nmsgid \"Valijate nimekirjade vormingu muutus\"\nmsgstr \"Change the voter list format\"\n\n#: ../../tarned.rst:550\nmsgid \"EHS/VIS X-tee liidese CI lisandumine\"\nmsgstr \"Addition of CI to the EHS/VIS X-road interface\"\n\n#: ../../tarned.rst:551\nmsgid \"EHS/VIS X-tee liidese dokumentatsiooni täpsustumine\"\nmsgstr \"Specification of EHS/VIS X-Road interface documentation\"\n\n#: ../../tarned.rst:552 ../../tarned.rst:598\nmsgid \"Väiksemad veaparandused\"\nmsgstr \"Minor bug fixes\"\n\n#: ../../tarned.rst:557 ../../tarned.rst:569 ../../tarned.rst:574\n#: ../../tarned.rst:585 ../../tarned.rst:593 ../../tarned.rst:608\n#: ../../tarned.rst:627 ../../tarned.rst:647 ../../tarned.rst:658\n#: ../../tarned.rst:666 ../../tarned.rst:692 ../../tarned.rst:696\n#: ../../tarned.rst:700 ../../tarned.rst:705 ../../tarned.rst:712\n#: ../../tarned.rst:716 ../../tarned.rst:728 ../../tarned.rst:732\n#: ../../tarned.rst:736 ../../tarned.rst:740 ../../tarned.rst:745\n#: ../../tarned.rst:755 ../../tarned.rst:781 ../../tarned.rst:810\n#: ../../tarned.rst:818 ../../tarned.rst:862 ../../tarned.rst:869\n#: ../../tarned.rst:873 ../../tarned.rst:894 ../../tarned.rst:898\n#: ../../tarned.rst:940 ../../tarned.rst:951 ../../tarned.rst:1020\n#: ../../tarned.rst:1027 ../../tarned.rst:1031 ../../tarned.rst:1036\n#: ../../tarned.rst:1043 ../../tarned.rst:1054 ../../tarned.rst:1058\n#: ../../tarned.rst:1103 ../../tarned.rst:1116 ../../tarned.rst:1121\n#: ../../tarned.rst:1142 ../../tarned.rst:1194 ../../tarned.rst:1220\n#: ../../tarned.rst:1231\nmsgid \"Muudatusi ei ole\"\nmsgstr \"No changes\"\n\n#: ../../tarned.rst:564\nmsgid \"RSA eemaldamine\"\nmsgstr \"RSA removal\"\n\n#: ../../tarned.rst:565\nmsgid \"Veaparandused\"\nmsgstr \"Bug fixes\"\n\n#: ../../tarned.rst:589\nmsgid \"Töövoogude konsolideerimine\"\nmsgstr \"Workflow consolidation\"\n\n#: ../../tarned.rst:603\nmsgid \"Täpsustused seoses muudatustega tarkvaras\"\nmsgstr \"Clarifications due to software changes\"\n\n#: ../../tarned.rst:611\nmsgid \"Muudatused tarne 1.8.1 koosseisus, erinevused võrreldes tarnega 1.7.7\"\nmsgstr \"\"\n\"Changes in the composition of delivery 1.8.1, differences compared to \"\n\"delivery 1.7.7\"\n\n#: ../../tarned.rst:618\nmsgid \"Smart-ID toe lisandumine\"\nmsgstr \"Addition of Smart-ID support\"\n\n#: ../../tarned.rst:619\nmsgid \"EHS/VIS X-tee liidese lisandumine\"\nmsgstr \"Addition of EHS/VIS X-road interface\"\n\n#: ../../tarned.rst:620\nmsgid \"Hääletamisfaktide järjestamine\"\nmsgstr \"Ranking of voting facts\"\n\n#: ../../tarned.rst:621 ../../tarned.rst:636 ../../tarned.rst:642\nmsgid \"Seadistatav SNI\"\nmsgstr \"Configurable SNI\"\n\n#: ../../tarned.rst:634 ../../tarned.rst:640 ../../tarned.rst:654\nmsgid \"Smart-ID\"\nmsgstr \"Smart ID\"\n\n#: ../../tarned.rst:635 ../../tarned.rst:641\nmsgid \"Täpsustatud krüptogrammi kontroll\"\nmsgstr \"Clarified ciphertext verification\"\n\n#: ../../tarned.rst:662\nmsgid \"Töövoogude konsolideerimine, täpsustused parameetrites\"\nmsgstr \"Consolidation of workflows, refinement of parameters\"\n\n#: ../../tarned.rst:671 ../../tarned.rst:682\nmsgid \"SmartID\"\nmsgstr \"SmartID\"\n\n#: ../../tarned.rst:672\nmsgid \"Uuendatud väljanägemine\"\nmsgstr \"Updated look\"\n\n#: ../../tarned.rst:677\nmsgid \"Täpsustused seoses muudatustega tarkvaras - SmartID, jne.\"\nmsgstr \"Clarifications regarding changes in software - SmartID, etc.\"\n\n#: ../../tarned.rst:685\nmsgid \"Muudatused tarne 1.7.7 koosseisus, erinevused võrreldes tarnega 1.7.6\"\nmsgstr \"\"\n\"Changes in the composition of delivery 1.7.7, differences compared to \"\n\"delivery 1.7.6\"\n\n#: ../../tarned.rst:694 ../../tarned.rst:770 ../../tarned.rst:851\n#: ../../tarned.rst:929 ../../tarned.rst:1009 ../../tarned.rst:1093\n#: ../../tarned.rst:1181 ../../tarned.rst:1265\nmsgid \"Haldusteenus\"\nmsgstr \"Management service\"\n\n#: ../../tarned.rst:698 ../../tarned.rst:774 ../../tarned.rst:855\n#: ../../tarned.rst:933 ../../tarned.rst:1013 ../../tarned.rst:1097\n#: ../../tarned.rst:1186 ../../tarned.rst:1278\nmsgid \"IVXV mikroteenused\"\nmsgstr \"IVXV microservices\"\n\n#: ../../tarned.rst:721\nmsgid \"Muudatused seoses entroopia allika valikulise tühjendamisega\"\nmsgstr \"Changes regarding selective emptying of the entropy source\"\n\n#: ../../tarned.rst:750\nmsgid \"Muudatused seoses miksneti muutustega\"\nmsgstr \"Changes due to changes in the mixnet\"\n\n#: ../../tarned.rst:759\nmsgid \"Muudatused tarne 1.7.6 koosseisus, erinevused võrreldes tarnega 1.6.0\"\nmsgstr \"\"\n\"Changes in the composition of delivery 1.7.6, differences compared to \"\n\"delivery 1.6.0.\"\n\n#: ../../tarned.rst:766\nmsgid \"Muudatused seoses sisendnimekirjade haldamisega VIS3's\"\nmsgstr \"Changes regarding the management of input lists in VIS3\"\n\n#: ../../tarned.rst:767 ../../tarned.rst:799\nmsgid \"Muudatused seoses Ubuntu 20.04 toetamisega\"\nmsgstr \"Changes related to Ubuntu 20.04 support\"\n\n#: ../../tarned.rst:768 ../../tarned.rst:772 ../../tarned.rst:776\n#: ../../tarned.rst:849 ../../tarned.rst:853 ../../tarned.rst:857\n#: ../../tarned.rst:927 ../../tarned.rst:931 ../../tarned.rst:935\n#: ../../tarned.rst:1007 ../../tarned.rst:1011 ../../tarned.rst:1015\n#: ../../tarned.rst:1078 ../../tarned.rst:1095 ../../tarned.rst:1099\n#: ../../tarned.rst:1168 ../../tarned.rst:1184 ../../tarned.rst:1190\nmsgid \"Väiksemad muutused/veaparandused vastavalt `changelog` failile\"\nmsgstr \"Minor changes/improvements according to `changelog` file\"\n\n#: ../../tarned.rst:788\nmsgid \"Muudatused seoses API versioonile 28 liikumisega\"\nmsgstr \"Changes related to the move to API version 28\"\n\n#: ../../tarned.rst:789 ../../tarned.rst:794 ../../tarned.rst:825\nmsgid \"Aegunud rakenduse tuvastamine\"\nmsgstr \"Detection of outdated application\"\n\n#: ../../tarned.rst:793\nmsgid \"Muudatused seoses iOS versioonile 12 liikumisega\"\nmsgstr \"Changes related to the move to iOS version 12\"\n\n#: ../../tarned.rst:806\nmsgid \"Muudatused seoses sisendnimekirjade haldamisega VIS3s\"\nmsgstr \"Changes to the management of input lists in VIS3\"\n\n#: ../../tarned.rst:814\nmsgid \"Töötlemise töövoogude optimeerimine\"\nmsgstr \"Optimising processing workflows\"\n\n#: ../../tarned.rst:823\nmsgid \"M1 protsessoritüübi toetamine macOS platvormil\"\nmsgstr \"M1 processor support on macOS platform\"\n\n#: ../../tarned.rst:824\nmsgid \"FLTK, OpenSSL ja teiste alusteekide versiooniuuendused\"\nmsgstr \"Updates to FLTK, OpenSSL and other libraries.\"\n\n#: ../../tarned.rst:830\nmsgid \"Muudatused seoses muutustega seadistustes ning terminoloogias\"\nmsgstr \"Changes due to configuration and terminology changes\"\n\n#: ../../tarned.rst:835\nmsgid \"Kaasatud tarnesse\"\nmsgstr \"Included in delivery\"\n\n#: ../../tarned.rst:841\nmsgid \"Muudatused tarne 1.6.0 koosseisus, erinevused võrreldes tarnega 1.5.0\"\nmsgstr \"\"\n\"Changes in the composition of delivery 1.6.0, differences compared to \"\n\"delivery 1.5.0\"\n\n#: ../../tarned.rst:848\nmsgid \"Mobiil-ID REST teenuse toetamine\"\nmsgstr \"Support for Mobile-ID REST service\"\n\n#: ../../tarned.rst:878 ../../tarned.rst:886\nmsgid \"Java versiooni 11 kasutuselevõtt\"\nmsgstr \"Java version 11 rollout\"\n\n#: ../../tarned.rst:879\nmsgid \"Verificatumi versiooniuuendus\"\nmsgstr \"Verificatum upgrade\"\n\n#: ../../tarned.rst:890\nmsgid \"RSA võtmete serialiseerimise uus vorming\"\nmsgstr \"New format for RSA key serialisation\"\n\n#: ../../tarned.rst:903 ../../tarned.rst:908\nmsgid \"Mobiil-ID REST teenuse tugi\"\nmsgstr \"Mobile-ID REST service support\"\n\n#: ../../tarned.rst:913\nmsgid \"Eemaldatud tarnest seoses litsentsi lõppemisega\"\nmsgstr \"Removed from delivery due to expiry of licence\"\n\n#: ../../tarned.rst:918\nmsgid \"Muudatused tarne 1.5.0 koosseisus, erinevused võrreldes tarnega 1.4.1\"\nmsgstr \"\"\n\"Changes in the composition of delivery 1.5.0, differences compared to \"\n\"delivery 1.4.1.\"\n\n#: ../../tarned.rst:925\nmsgid \"Kõigi päringute logimine\"\nmsgstr \"Logging all requests\"\n\n#: ../../tarned.rst:926\nmsgid \"etcd Debian buster repositooriumist, uusima golang-google-rpc saamiseks\"\nmsgstr \"\"\n\"etcd from the Debian buster repository, to get the latest golang-google-\"\n\"rpc.\"\n\n#: ../../tarned.rst:947\nmsgid \"Muudatused seoses koodiläbivaatuse ja veatöötluse parendamisega\"\nmsgstr \"Changes to improve code review and error handling\"\n\n#: ../../tarned.rst:956\nmsgid \"Muudatused seoses 300K hääle miksimisega\"\nmsgstr \"Changes to the 300K vote mixing process\"\n\n#: ../../tarned.rst:963\nmsgid \"Valimise identifikaatori kasutamine läbiva prefiksina\"\nmsgstr \"Use of a election identifier as a prefix\"\n\n#: ../../tarned.rst:967\nmsgid \"Muudatused seoses koodiläbivaatusega\"\nmsgstr \"Changes related to code review\"\n\n#: ../../tarned.rst:971 ../../tarned.rst:976\nmsgid \"Muudatused seoses 300K hääle töötlemisega\"\nmsgstr \"Changes regarding the processing of 300K votes\"\n\n#: ../../tarned.rst:975\nmsgid \"Edenemisriba\"\nmsgstr \"Progressbar\"\n\n#: ../../tarned.rst:981 ../../tarned.rst:1063\nmsgid \"MSAA toe täpsustamine\"\nmsgstr \"Specification of MSAA support\"\n\n#: ../../tarned.rst:982\nmsgid \"Süsteemsete PIN-dialoogide kasutamine Windows platvormil\"\nmsgstr \"Using system PIN dialogues on the Windows platform\"\n\n#: ../../tarned.rst:987\nmsgid \"IVXV audiitori juhendi lisamine\"\nmsgstr \"Addition of IVXV auditor's manual\"\n\n#: ../../tarned.rst:988\nmsgid \"Muudatusdokumentide lisamine tarnesse\"\nmsgstr \"Inclusion of change documents in the delivery\"\n\n#: ../../tarned.rst:994\nmsgid \"Muutused/veaparandused vastavalt `changelog` failile\"\nmsgstr \"Changes/improvements according to `changelog` file\"\n\n#: ../../tarned.rst:1000\nmsgid \"Muudatused tarne 1.4.1 koosseisus, erinevused võrreldes tarnega 1.4.0\"\nmsgstr \"\"\n\"Changes in the composition of the delivery 1.4.1, differences compared to\"\n\" delivery 1.4.0.\"\n\n#: ../../tarned.rst:1047\nmsgid \"Tööriista *init* väljundfailide muutus\"\nmsgstr \"Tool *init* change in output files\"\n\n#: ../../tarned.rst:1048\nmsgid \"Tööriista *init* SN ja CN parameetrite muutus\"\nmsgstr \"Change in tool *init* SN and CN parameters\"\n\n#: ../../tarned.rst:1049\nmsgid \"Tööriista *testkey* sisendparameetrite muutus\"\nmsgstr \"Change in input parameters of *testkey* tool\"\n\n#: ../../tarned.rst:1050\nmsgid \"Tööriista *decrypt* kasutatud kaardinumbrite kuvamine\"\nmsgstr \"Displaying the card numbers used by the *decrypt* toolbar\"\n\n#: ../../tarned.rst:1068\nmsgid \"IVXV protokollid - registreerimisprotokolli lisamine\"\nmsgstr \"Protocols IVXV - Addition to the record of registrations\"\n\n#: ../../tarned.rst:1069\nmsgid \"\"\n\"IVXV seadistuste koostejuhend - läbivad täiendused ning käsiraamatuga \"\n\"ühtlustamine.\"\nmsgstr \"IVXV configuration manual - improvements and alignment with the procedure.\"\n\n#: ../../tarned.rst:1071\nmsgid \"IVXV valijarakendus - läbivad täiendused.\"\nmsgstr \"IVXV voting application - improvements.\"\n\n#: ../../tarned.rst:1072\nmsgid \"IVXV mixnet - dokument hõlmatud seadistuste koostejuhendisse, eemaldatud.\"\nmsgstr \"IVXV mixnet - document included in the configuration manual, removed.\"\n\n#: ../../tarned.rst:1073\nmsgid \"\"\n\"IVXV registreerimisteenus - dokument hõlmatud protokollistikku, \"\n\"eemaldatud.\"\nmsgstr \"\"\n\"IVXV registration service - document included in the protocol document, \"\n\"removed.\"\n\n#: ../../tarned.rst:1081\nmsgid \"Muudatused tarne 1.4.0 koosseisus, erinevused võrreldes tarnega 1.3.0\"\nmsgstr \"\"\n\"Changes in the configuration of delivery 1.4.0, differences compared to \"\n\"delivery 1.3.0\"\n\n#: ../../tarned.rst:1088\nmsgid \"\"\n\"OCSP ja ajatemplipäringute automaatne kordamine vastavalt \"\n\"konfiguratsioonile\"\nmsgstr \"Automatic repetition of OCSP and timestamp requests as configured\"\n\n#: ../../tarned.rst:1090\nmsgid \"BDOC-TS allkirjakonteinerite toetamine\"\nmsgstr \"Support for BDOC-TS signature containers\"\n\n#: ../../tarned.rst:1091\nmsgid \"Tühjade valijanimekirjade tugi\"\nmsgstr \"Support for empty voterlists\"\n\n#: ../../tarned.rst:1110\nmsgid \"TLS 1.2 toetamine API-versioonide < 19 korral\"\nmsgstr \"TLS 1.2 support for API versions < 19\"\n\n#: ../../tarned.rst:1111\nmsgid \"Abiinfo vaate asendamine süsteemse brauseriga\"\nmsgstr \"Replacing the help view with a system browser\"\n\n#: ../../tarned.rst:1112\nmsgid \"Kuvast väljuvate tekstide automaatne lühendamine nuppude korral\"\nmsgstr \"Automatic abbreviation of texts in the image when buttons are pressed\"\n\n#: ../../tarned.rst:1128\nmsgid \"Jaoskonnanumbri unikaalsusnõuete täpsustamine\"\nmsgstr \"Specifying the uniqueness requirements for the station number\"\n\n#: ../../tarned.rst:1129\nmsgid \"Tühja valijatenimekirja tugi\"\nmsgstr \"Support for an empty voterlist\"\n\n#: ../../tarned.rst:1130\nmsgid \"Kodeeringuvigadega sertifikaatide toetamine rakendustes\"\nmsgstr \"Support for certificates with coding errors in applications\"\n\n#: ../../tarned.rst:1134\nmsgid \"Eemaldatud LOG4 ja LOG5\"\nmsgstr \"Removed LOG4 and LOG5\"\n\n#: ../../tarned.rst:1138\nmsgid \"Eemaldatud PDF vormingus valijate nimekiri faasist *revoke*\"\nmsgstr \"Removed PDF voter list from *revoke* phase.\"\n\n#: ../../tarned.rst:1147\nmsgid \"macOS 10.11 toetamine\"\nmsgstr \"macOS 10.11 support\"\n\n#: ../../tarned.rst:1148\nmsgid \"32bit Linuxi toetamine\"\nmsgstr \"32bit Linux support\"\n\n#: ../../tarned.rst:1149\nmsgid \"UPX versiooni uuendamine\"\nmsgstr \"Upgrading UPX\"\n\n#: ../../tarned.rst:1150\nmsgid \"Pinpad kaardilugejate töökindluse tõstmine (Win)\"\nmsgstr \"Improving the reliability of Pinpad card readers (Win)\"\n\n#: ../../tarned.rst:1151\nmsgid \"ID-kaardi suhtlusvigade parandamine (Win7/ECC)\"\nmsgstr \"Fix ID card communication errors (Win7/ECC)\"\n\n#: ../../tarned.rst:1152\nmsgid \"Nii PEM kui DER vormingus andmete import (Seadistaja)\"\nmsgstr \"Import data in both PEM and DER format (Configurator)\"\n\n#: ../../tarned.rst:1153\nmsgid \"Lisatud Seadistuste valideerimisvõimalus (Seadistaja)\"\nmsgstr \"Added Configuration validation option (Configurator)\"\n\n#: ../../tarned.rst:1154\nmsgid \"Parandatud käitumine liigsuurte seadistuste korral (Seadistaja)\"\nmsgstr \"Corrected behaviour in case of excessive settings (Configurator)\"\n\n#: ../../tarned.rst:1159\nmsgid \"\"\n\"Dokumentatsiooni uuendamine muudatuste kajastamiseks ning DEMO2018 \"\n\"tagasiside arvestamiseks\"\nmsgstr \"Updating documentation to reflect changes and feedback from DEMO2018.\"\n\n#: ../../tarned.rst:1165\nmsgid \"MTA sõltuvuse lisamine\"\nmsgstr \"Adding MTA dependency\"\n\n#: ../../tarned.rst:1166\nmsgid \"CSV logiväljavõtte täpsustamine, algus- ja lõpuaja lisamine\"\nmsgstr \"Specifying the CSV log field, adding start and end times\"\n\n#: ../../tarned.rst:1167\nmsgid \"Logianalüüsi optimeerimine mitmetuumalise riistvara jaoks\"\nmsgstr \"Optimising log analysis for multi-core hardware\"\n\n#: ../../tarned.rst:1171\nmsgid \"Muudatused tarne 1.3.0 koosseisus, erinevused võrreldes tarnega 1.2.0\"\nmsgstr \"\"\n\"Changes in the composition of delivery 1.3.0, differences compared to \"\n\"delivery 1.2.0\"\n\n#: ../../tarned.rst:1178 ../../tarned.rst:1253\nmsgid \"Ubuntu 18.04 LTS (Bionic Beaver) kasutuselevõtmine\"\nmsgstr \"Support for Ubuntu 18.04 LTS (Bionic Beaver)\"\n\n#: ../../tarned.rst:1179\nmsgid \"Krahhitaaste protseduuride kirjeldamine\"\nmsgstr \"Description of disaster recovery procedures\"\n\n#: ../../tarned.rst:1183\nmsgid \"Parandatud tööriistad teenuste seisundiinfo saamiseks\"\nmsgstr \"Improved tools for getting service status information\"\n\n#: ../../tarned.rst:1188\nmsgid \"golang keeleversioon 1.9 kasutuselevõtmine\"\nmsgstr \"golang language version 1.9 rollout\"\n\n#: ../../tarned.rst:1189\nmsgid \"Eesti ID-kaardi uuenenud profiili toetamine (PNOEE)\"\nmsgstr \"Supporting the renewed profile of the Estonian ID card (PNOEE)\"\n\n#: ../../tarned.rst:1201 ../../tarned.rst:1206\nmsgid \"ESTEID2018 sertifikaatide toetamine\"\nmsgstr \"Support for ESTEID2018 certificates\"\n\n#: ../../tarned.rst:1202\nmsgid \"Täpsustatud vigase ASN1-kodeeringuga avalike võtmete käitlemist\"\nmsgstr \"Improved handling of public keys with corrupt ASN1 coding\"\n\n#: ../../tarned.rst:1207\nmsgid \"iPhone 10 X muudatused\"\nmsgstr \"iPhone 10 X changes\"\n\n#: ../../tarned.rst:1208\nmsgid \"XCode 10 ja iOS 12 SDK kasutamine\"\nmsgstr \"Using XCode 10 and iOS 12 SDK\"\n\n#: ../../tarned.rst:1213\nmsgid \"Verificatumi AGPL versiooni kasutuselevõtmine\"\nmsgstr \"Deployment of the AGPL version of Verificatum\"\n\n#: ../../tarned.rst:1224\nmsgid \"Lisatud tööriist StatsTool valimiskastist statistikafaili genereerimiseks\"\nmsgstr \"Added tool StatsTool to generate a statistics file from the ballot box.\"\n\n#: ../../tarned.rst:1225\nmsgid \"Lisatud tööriist StatsDiffTool kahe statistikafaili võrdlemiseks\"\nmsgstr \"Added tool StatsDiffTool to compare two statistics files\"\n\n#: ../../tarned.rst:1226 ../../tarned.rst:1239\nmsgid \"ESTEID2018 sertifikaatide ja profiili toetamine\"\nmsgstr \"ESTEID2018 certificates and profile support\"\n\n#: ../../tarned.rst:1227\nmsgid \"digidoc4j 2.1.0 kasutamine\"\nmsgstr \"digidoc4j 2.1.0 usage\"\n\n#: ../../tarned.rst:1236\nmsgid \"Valijarakenduses kandidaatide otsingu võimaldamine\"\nmsgstr \"Enabling the search for candidates in the voter application\"\n\n#: ../../tarned.rst:1237\nmsgid \"Valijarakenduses erakondade ja kandidaatide kaustana kuvamine\"\nmsgstr \"\"\n\"Displaying political parties and candidates as a folder in the voter \"\n\"application\"\n\n#: ../../tarned.rst:1238\nmsgid \"\"\n\"Valijarakenduse ja Seadistusrakenduse üleviimine JSON-vormingus \"\n\"seadistustele\"\nmsgstr \"Migrating the Voting app and Configuration app to JSON format settings\"\n\n#: ../../tarned.rst:1240\nmsgid \"Win: IDEMIA minidraiveri toetamine\"\nmsgstr \"Win: IDEMIA minidriver support\"\n\n#: ../../tarned.rst:1241\nmsgid \"Linux/macOS: IDEMIA PKCS11 draiveri toetamine\"\nmsgstr \"Linux/macOS: IDEMIA PKCS11 driver support\"\n\n#: ../../tarned.rst:1242\nmsgid \"macOS 10.14 toetamine\"\nmsgstr \"macOS 10.14 support\"\n\n#: ../../tarned.rst:1247\nmsgid \"Dokumentatsiooni uuendamine muudatuste kajastamiseks\"\nmsgstr \"Updating documentation to reflect changes\"\n\n#: ../../tarned.rst:1248\nmsgid \"Ingliskeelse arhitektuuridokumendi ja protokollistiku lisamine\"\nmsgstr \"Creation of an English-language architecture and protocol document\"\n\n#: ../../tarned.rst:1254\nmsgid \"Võetud kasutusele Grafana 5.3.4\"\nmsgstr \"Introduced Grafana 5.3.4\"\n\n#: ../../tarned.rst:1255\nmsgid \"\"\n\"Parandatud vanusepõhise statistika genereerimine ja vanusegruppidesse \"\n\"jaotumine\"\nmsgstr \"Generation of age-specific statistics and age group breakdowns\"\n\n#: ../../tarned.rst:1257\nmsgid \"CSV väljundi võtmine seanssidest\"\nmsgstr \"Extracting CSV output from sessions\"\n\n#: ../../tarned.rst:1260\nmsgid \"\"\n\"Muudatused tarne 1.2.0 koosseisus, erinevused võrreldes KOV2017 \"\n\"valimistega.\"\nmsgstr \"\"\n\"Changes in the composition of the supply 1.2.0, differences compared to \"\n\"the KOV2017 elections.\"\n\n#: ../../tarned.rst:1267\nmsgid \"Lisatud tööriist vigaste valijanimekirjade eemaldamiseks.\"\nmsgstr \"Added a tool to remove invalid voterlists.\"\n\n#: ../../tarned.rst:1268\nmsgid \"Lisatud tööriist jaoskondade/ringkondade nimekirja lisamiseks.\"\nmsgstr \"Added a tool to add a list of wards/districts.\"\n\n#: ../../tarned.rst:1269\nmsgid \"Lisatud ringkonnapõhine statistika.\"\nmsgstr \"Statistics by district are included.\"\n\n#: ../../tarned.rst:1270\nmsgid \"Lisatud varundusteenus.\"\nmsgstr \"Added backup service.\"\n\n#: ../../tarned.rst:1271\nmsgid \"Lisatud tööriist varundatud valimiskastide konsolideerimiseks.\"\nmsgstr \"Added tool to consolidate backed up ballot boxes.\"\n\n#: ../../tarned.rst:1272\nmsgid \"Lisatud tööriist nimekirjade kooskõlalisuse kontrolliks.\"\nmsgstr \"Added a tool to check the consistency of lists.\"\n\n#: ../../tarned.rst:1273\nmsgid \"\"\n\"Lisatud võimekus seadistusfailidele valimisspetsiifiliste prefiksite \"\n\"lisamiseks.\"\nmsgstr \"Added ability to add election specific prefixes to configuration files.\"\n\n#: ../../tarned.rst:1274\nmsgid \"Täiendatud haldusliidese kasutajaliidest abiinfoga.\"\nmsgstr \"Enhanced the administrative interface with help.\"\n\n#: ../../tarned.rst:1275\nmsgid \"Eemaldatud aegunud konfiguratsiooniparameeter “stats.*”\"\nmsgstr \"Removed obsolete configuration parameter \\\"stats.*\\\"\"\n\n#: ../../tarned.rst:1276\nmsgid \"Parandatud sisendfailide vormingu kontrolli ja laadimist.\"\nmsgstr \"Improved input file format checking and loading.\"\n\n#: ../../tarned.rst:1280\nmsgid \"Uuendatud etcd versioon.\"\nmsgstr \"Updated etcd version.\"\n\n#: ../../tarned.rst:1281\nmsgid \"Lisatud võimekus etcd ajalõppude seadistamiseks keskkonnamuutujate kaudu.\"\nmsgstr \"Added ability to set etcd timeouts via environment variables.\"\n\n#: ../../tarned.rst:1282\nmsgid \"Lisatud võimekus klastri modifitseerimiseks krahhitaaste eesmärgil.\"\nmsgstr \"Added capability to modify cluster for disaster recovery\"\n\n#: ../../tarned.rst:1283\nmsgid \"\"\n\"Parandatud klastri käitumist liidrivahetuse korral, pooleliolevate \"\n\"talletamiste kordamine.\"\nmsgstr \"Improved cluster behaviour in the event of a leader-change.\"\n\n#: ../../tarned.rst:1284\nmsgid \"TLS šifrid muudetud seadistatavaks.\"\nmsgstr \"TLS ciphers made configurable.\"\n\n#: ../../tarned.rst:1285\nmsgid \"Parandatud BDOC profiili identifitseeriva konfiguratsioonivälja nimi.\"\nmsgstr \"Name of the configuration field identifying the corrected BDOC profile.\"\n\n#: ../../tarned.rst:1286\nmsgid \"\"\n\"Lisatud võimekus seadistada Mobiil-ID autentimist nõudma nii isikukoodi \"\n\"kui telefoninumbrit.\"\nmsgstr \"\"\n\"Added the ability to configure Mobile ID authentication to require both \"\n\"an ID and a phone number.\"\n\n#: ../../tarned.rst:1287\nmsgid \"Lisatud võimekus piirata korduvhääletamise sagedust.\"\nmsgstr \"Added ability to limit the frequency of re-voting.\"\n\n#: ../../tarned.rst:1288\nmsgid \"Lisatud võimekus toetada Windowsi reavahetusi konfifailides.\"\nmsgstr \"Added ability to support Windows line-breaks in configuration files.\"\n\n#: ../../tarned.rst:1289\nmsgid \"Täiustatud BDOC XML kanoniseerimist ja parsimist.\"\nmsgstr \"Improved BDOC XML canonicalisation and parsing.\"\n\n#: ../../tarned.rst:1290\nmsgid \"Karmistatud DDS päringute vormingukontrolle.\"\nmsgstr \"Tightened DDS query formatting controls.\"\n\n#: ../../tarned.rst:1291\nmsgid \"Logimine viidud üle RELP protokollile.\"\nmsgstr \"Logging migrated to RELP protocol.\"\n\n#: ../../tarned.rst:1292\nmsgid \"\"\n\"Muudetud seadistusfailide ülesehitust eristamaks Koguja ja Töötleja \"\n\"vastutusi.\"\nmsgstr \"\"\n\"Changed the structure of configuration files to distinguish between the \"\n\"responsibilities of the Collector and the Processor.\"\n\n#: ../../tarned.rst:1296 ../../tarned.rst:1307 ../../tarned.rst:1311\n#: ../../tarned.rst:1317 ../../tarned.rst:1321 ../../tarned.rst:1325\nmsgid \"Muudatusi ei ole.\"\nmsgstr \"There are no changes.\"\n\n#: ../../tarned.rst:1303\nmsgid \"\"\n\"Lisatud juhised publitseeritud kontrollrakenduse ja avalikustatud \"\n\"lähtekoodi vastavuse kontrollimiseks.\"\nmsgstr \"\"\n\"Added guidance on how to check the consistency of a published control \"\n\"implementation with the published source code.\"\n\n#: ../../tarned.rst:1329\nmsgid \"Linux ja Mac – platvormispetsiifilisi muudatusi ei ole.\"\nmsgstr \"Linux and Mac - There are no platform-specific changes.\"\n\n#: ../../tarned.rst:1330\nmsgid \"\"\n\"Windows – parandatud liidestumist Minidraiveriga, mingw64 \"\n\"kasutuselevõtmine.\"\nmsgstr \"Windows - improved interfacing with Minidraiver, introducing mingw64.\"\n\n#: ../../tarned.rst:1331\nmsgid \"Lisatud ID-kaardi ECC toetamine.\"\nmsgstr \"Added support for ID card ECC.\"\n\n#: ../../tarned.rst:1332\nmsgid \"Seadistatud Mobiil-ID nõudma vajadusel isikukoodi ja telefoninumbrit.\"\nmsgstr \"Set up Mobile ID to ask for an ID and phone number when needed.\"\n\n#: ../../tarned.rst:1333\nmsgid \"Täiendatud veakoode.\"\nmsgstr \"Updated error codes.\"\n\n#: ../../tarned.rst:1334\nmsgid \"Kohandatud seadistusrakendus muudatustega vastavusse.\"\nmsgstr \"Adjusted the configuration app to reflect the changes.\"\n\n#: ../../tarned.rst:1335\nmsgid \"Kohandatud BDOC XML mallid\"\nmsgstr \"Customized BDOC XML templates\"\n\n#: ../../tarned.rst:1339\nmsgid \"Dokumentatsioon läbivalt kaasajastatud seoses muudatustega\"\nmsgstr \"Documentation updated throughout in the light of the amendments\"\n\n#: ../../tarned.rst:1343\nmsgid \"Loobutud CrateDBst.\"\nmsgstr \"Rejected CrateDB\"\n\n#: ../../tarned.rst:1344\nmsgid \"Võetud läbivalt kasutusele PostgreSQL.\"\nmsgstr \"Adopted PostgreSQL.\"\n\n#: ../../tarned.rst:1345\nmsgid \"Võetud kasutusele Grafana 5.0.1.\"\nmsgstr \"Grafana 5.0.1 has been introduced.\"\n\n#: ../../tarned.rst:1346\nmsgid \"Seansside valideerimise parandused lähtudes KOV2017 logianalüüsist.\"\nmsgstr \"\"\n\"Improvements to the validation of the sessions based on the KOV2017 log \"\n\"analysis.\"\n\n#: ../../tarned.rst:1347\nmsgid \"Lisatud statistika genereerimine ringkondade kaupa.\"\nmsgstr \"Generation of statistics by district.\"\n\n#~ msgid \"Muudatused tarne 1.9.1 koosseisus, erinevused võrreldes tarnega 1.9.0\"\n#~ msgstr \"\"\n#~ \"Changes in the composition of delivery\"\n#~ \" 1.9.1, differences compared to delivery\"\n#~ \" 1.9.0\"\n\n#~ msgid \"???\"\n#~ msgstr \"???\"\n\n#~ msgid \"iOS versioonide täpsustamine\"\n#~ msgstr \"Update iOS versions\"\n\n" }, { "path": "Documentation/public/uldsisukord/spelling_wordlist.txt", "content": "\nprotocols\narchitecture\ninterfaces\n\nAPI\n\nbackend\nbeaver\nbionic\nbit\nbuster\n\ndebian\ndigidoc\n\nECC\netcd\n\ngo\ngolang\ngoogle\ngrafana\n\niOS\niPhone\n\nlog\n\nmac\nmacOS\nmessages\nmingw\nmixnet\n\npin\npinpad\npython\n\nrpc\n\nstats\n\nubuntu\n\nWin\nWindowsi\n\nXCode\n\ningliskeelsed\n" }, { "path": "Documentation/public/uldsisukord/tarned.rst", "content": ".. IVXV dokumentatsiooni üldsisukord\n\nTarned\n======\n\nMuudatused tarne 1.10.4 koosseisus, erinevused võrreldes tarnega 1.10.3\n--------------------------------------------------------------------------------\n\nKogumisteenus\n~~~~~~~~~~~~~\n\nÜldised muutused\n\n* Valijate nimekirjade muudatuste allalaadimise täpsustused\n\nRegistreerimisteenus\n~~~~~~~~~~~~~~~~~~~~\n\n* Muudatused puuduvad\n\nKontrollrakendused\n~~~~~~~~~~~~~~~~~~\n\nAndroid\n\n* Muudatused puuduvad\n\niOS\n\n* Muudatused puuduvad\n\nMiksnet\n~~~~~~~\n\n* Muudatused puuduvad\n\nTöötleja rakendused\n~~~~~~~~~~~~~~~~~~~\n\nÜldised\n\n* Muudatused puuduvad\n\nVõtmerakendus\n\n* Muudatused puuduvad\n\nTöötlemisrakendus\n\n* Muudatused puuduvad\n\nAuditirakendus\n\n* Muudatused puuduvad\n\nValijarakendused ja seadistusrakendus\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n* Muudatused puuduvad\n\nDokumentatsioon\n~~~~~~~~~~~~~~~\n\n* Numeratsiooni läbivaatus\n* Võtmerakenduse seadistuste täpsustamine\n* Smart-ID protokolli näidete täpsustamine\n\nLogimonitor\n~~~~~~~~~~~\n\n* Muudatused puuduvad\n\n\nMuudatused tarne 1.10.3 koosseisus, erinevused võrreldes tarnega 1.10.2\n--------------------------------------------------------------------------------\n\nKogumisteenus\n~~~~~~~~~~~~~\n\nÜldised muutused\n\n* Muudatused puuduvad\n\nRegistreerimisteenus\n~~~~~~~~~~~~~~~~~~~~\n\n* Muudatused puuduvad\n\nKontrollrakendused\n~~~~~~~~~~~~~~~~~~\n\nAndroid\n\n* Muudatused puuduvad\n\niOS\n\n* Muudatused puuduvad\n\nMiksnet\n~~~~~~~\n\n* Muudatused puuduvad\n\nTöötleja rakendused\n~~~~~~~~~~~~~~~~~~~\n\nÜldised\n\n* Muudatused puuduvad\n\nVõtmerakendus\n\n* Muudatused puuduvad\n\nTöötlemisrakendus\n\n* Muudatused puuduvad\n\nAuditirakendus\n\n* Muudatused puuduvad\n\nValijarakendused ja seadistusrakendus\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n* Muudatused puuduvad\n\nDokumentatsioon\n~~~~~~~~~~~~~~~\n\n* Tõlgete läbivaatus\n* Õigekirja läbivaatus\n* Tarne 1.10.2 sisu dokumenteerimine\n\nLogimonitor\n~~~~~~~~~~~\n\n* Muudatused puuduvad\n\n\nMuudatused tarne 1.10.2 koosseisus, erinevused võrreldes tarnega 1.10.1\n--------------------------------------------------------------------------------\n\nKogumisteenus\n~~~~~~~~~~~~~\n\nÜldised muutused\n\n* ZIP/BDOC failide käsitluse parendamine\n* Sõltuvuste uuendamine, JavaScript\n* eID vahendite testimine\n* Mälulekete parandamine\n* Smart-ID voogude uuendamine vastavalt protokollile\n* Nimekirjade laadimise intervalli ja strateegia täpsustamine\n* Arendus- ja testkeskkonna parendused\n* Pisiparandused\n\nRegistreerimisteenus\n~~~~~~~~~~~~~~~~~~~~\n\n* Muudatused puuduvad\n\nKontrollrakendused\n~~~~~~~~~~~~~~~~~~\n\nAndroid\n\n* Rakenduse kolimine Riigikogu Kantselei poodi\n* TargetSDK uuendamine\n* Erinevad veaparandused kasutajaliideses\n* Täiendav obfuskeerimine\n* Veateadete täiendamine\n\niOS\n\n* Rakenduse kolimine Riigikogu Kantselei poodi\n* Erinevad veaparandused kasutajaliideses\n* Täpsustused rakenduse varundamisele\n* Rakenduse elutsükli olekumasina täpsustused\n* Veateadete täiendamine\n\nMiksnet\n~~~~~~~\n\n* Muudatused puuduvad\n\nTöötleja rakendused\n~~~~~~~~~~~~~~~~~~~\n\nÜldised\n\n* ZIP/BDOC failide käsitluse parendamine\n\nVõtmerakendus\n\n* Pisiparandused\n\nTöötlemisrakendus\n\n* Pisiparandused\n\nAuditirakendus\n\n* Pisiparandused\n\nValijarakendused ja seadistusrakendus\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n* Sõltuvuste uuendamine, OpenSSL, PCRE\n* Kasutajaliidese teegi FLTK uuendamine\n* Smart-ID voo uuendamine\n* Testimine uusima ID-kaardiga\n* Kompileerimiskeskkonna täpsustused\n\nDokumentatsioon\n~~~~~~~~~~~~~~~\n\n* Tõlgete läbivaatus\n* Õigekirja läbivaatus\n* Tarne 1.10.2 sisu dokumenteerimine\n\nLogimonitor\n~~~~~~~~~~~\n\n* Sõltuvuste uuendamine, Python, JavaScript\n* Veebiliidese täiendused\n* Päringuvahendaja ``pgbouncer`` kasutuselevõtt\n* Veebiserveri konfiguratsiooni läbivaatus turvatesti tulemustest lähtudes\n\n\nMuudatused tarne 1.10.1 koosseisus, erinevused võrreldes tarnega 1.10.0\n--------------------------------------------------------------------------------\n\nKogumisteenus\n~~~~~~~~~~~~~\n\nÜldised muutused\n\n* Uuenenud SmartID serdiprofiili toetamine\n\nRegistreerimisteenus\n~~~~~~~~~~~~~~~~~~~~\n\n* Muudatused puuduvad\n\nKontrollrakendused\n~~~~~~~~~~~~~~~~~~\n\nAndroid\n\n* Täpsustused hääle verifitseerimisel, äärejuhtumite läbivaatus\n\niOS\n\n* Täpsustused hääle verifitseerimisel, äärejuhtumite läbivaatus\n\nMiksnet\n~~~~~~~\n\n* Muudatused puuduvad\n\nTöötleja rakendused\n~~~~~~~~~~~~~~~~~~~\n\nÜldised\n\n* Muudatused puuduvad\n\nVõtmerakendus\n\n* Muudatused puuduvad\n\nTöötlemisrakendus\n\n* Muudatused puuduvad\n\nAuditirakendus\n\n* Muudatused puuduvad\n\nValijarakendused ja seadistusrakendus\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n* Muudatused puuduvad\n\nDokumentatsioon\n~~~~~~~~~~~~~~~\n\n* Muudatused puuduvad\n\nLogimonitor\n~~~~~~~~~~~\n\n* Pisiparandused vastavalt muutuste logile\n\n\nMuudatused tarne 1.10.0 koosseisus, erinevused võrreldes tarnega 1.9.10\n--------------------------------------------------------------------------------\n\nKogumisteenus\n~~~~~~~~~~~~~\n\nÜldised muutused\n\n* Funktsionaalsus kehtetute sedelite eemaldamiseks kogumisteenuses\n* MODP ja elliptkõverate krüptograafia\n* Erinevad pisiparandused vastavalt muutuste logile\n\nRegistreerimisteenus\n~~~~~~~~~~~~~~~~~~~~\n\n* Muudatused puuduvad\n\nKontrollrakendused\n~~~~~~~~~~~~~~~~~~\n\nAndroid\n\n* Elliptkõverate krüptograafia\n* Ligipääsetavuse parandamine\n* Täpsustused hääle verifitseerimisel, äärejuhtumite läbivaatus\n\niOS\n\n* Elliptkõverate krüptograafia\n* Ligipääsetavuse parandamine\n* Täpsustused hääle verifitseerimisel, äärejuhtumite läbivaatus\n\nMiksnet\n~~~~~~~\n\n* Elliptkõverate krüptograafia\n\nTöötleja rakendused\n~~~~~~~~~~~~~~~~~~~\n\nÜldised\n\n* Elliptkõverate krüptograafia\n* Täpsustused urni verifitseerimisel, äärejuhtumite läbivaatus\n\nVõtmerakendus\n\n* Elliptkõverate krüptograafia\n* Täpsustused urni verifitseerimisel, äärejuhtumite läbivaatus\n\nTöötlemisrakendus\n\n* Elliptkõverate krüptograafia\n* Täpsustused urni verifitseerimisel, äärejuhtumite läbivaatus\n\nAuditirakendus\n\n* Elliptkõverate krüptograafia\n* Täpsustused urni verifitseerimisel, äärejuhtumite läbivaatus\n\nValijarakendused ja seadistusrakendus\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n* Elliptkõverate krüptograafia\n* Proksikasutuse refaktoreerimine\n\nDokumentatsioon\n~~~~~~~~~~~~~~~\n\n* Protokollidokumendi täiendamine\n* Logide dokumendi loomine\n\nLogimonitor\n~~~~~~~~~~~\n\n* Pisiparandused vastavalt muutuste logile\n\n\nMuudatused tarne 1.9.10 koosseisus, erinevused võrreldes tarnega 1.9.4\n--------------------------------------------------------------------------------\n\nKogumisteenus\n~~~~~~~~~~~~~\n\nÜldised muutused\n\n* Erinevad pisiparandused vastavalt muutuste logile\n\nRegistreerimisteenus\n~~~~~~~~~~~~~~~~~~~~\n\n* Muudatused puuduvad\n\nKontrollrakendused\n~~~~~~~~~~~~~~~~~~\n\nAndroid\n\n* FLAG_SECURE kasutuselevõtt\n* Täpsustused hääle verifitseerimisel, äärejuhtumite läbivaatus\n\niOS\n\n* Ligipääsetavuse parendamine\n* Täpsustused hääle verifitseerimisel, äärejuhtumite läbivaatus\n\nMiksnet\n~~~~~~~\n\n* Muudatused puuduvad\n\nTöötleja rakendused\n~~~~~~~~~~~~~~~~~~~\n\nÜldised\n\n* Muudatused puuduvad\n\nVõtmerakendus\n\n* Krüptogrammi kehtetuks kuulutamise äärejuhtumite läbivaatus\n\n\nTöötlemisrakendus\n\n* Hääle kehtetuks kuulutamise äärejuhtumite läbivaatus\n\nAuditirakendus\n\n* Muudatused puuduvad\n\nValijarakendused ja seadistusrakendus\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n* Windows, ligipääsetavuse veaparandused\n\nDokumentatsioon\n~~~~~~~~~~~~~~~\n\n* Eesti- ja ingliskeelse dokumentatsiooni ühtlustamine\n* Arhitektuuridokumendi täiendamine\n\nLogimonitor\n~~~~~~~~~~~\n\n* Hääletamisfaktide edastamise ebaõnnestumise tuvastamine logist\n* Pisiparandused vastavalt muutuste logile\n\n\nMuudatused tarne 1.9.4 koosseisus, erinevused võrreldes tarnega 1.8.2\n--------------------------------------------------------------------------------\n\nKogumisteenus\n~~~~~~~~~~~~~\n\nÜldised muutused\n\n* Ubuntu 22.04 tugi\n* Go versiooniuuendus\n* etcd versiooniuuendus ja seadistamine\n* Sõltuvuste ajakohastamine\n* Web eID autentimismeetodi lisamine\n* Session status mikroteenuse lisamine\n* EHS statistikaliidese töökindluse tõstmine\n* Valimiste järkjärguline lõpp\n* Seansiidentifikaatori muutmine kohustuslikuks\n* ASiCe vormingutäpsustus\n* VIS tugi detailstatistikale\n* SmartID toe täpsustused\n* Erinevad pisiparandused vastavalt muutuste logile\n\nRegistreerimisteenus\n~~~~~~~~~~~~~~~~~~~~\n\n* Muudatused puuduvad\n\nKontrollrakendused\n~~~~~~~~~~~~~~~~~~\n\nAndroid\n\n* TLS 1.3\n* Sertide pinnimisest loobumine\n* Valikute nimekirja kontroll\n\niOS\n\n* TLS 1.3\n* Valikute nimekirja kontroll\n\nMiksnet\n~~~~~~~\n\n* Muudatused puuduvad\n\nTöötleja rakendused\n~~~~~~~~~~~~~~~~~~~\n\nÜldised\n\n* Java 17\n\nVõtmerakendus\n\n* Kehtetute sedelite korrektse dekrüpteerimise tõestamine\n\n\nTöötlemisrakendus\n\n* Statistika arvutuste täpsustamine\n* Töötlemisprotseduuride auditeerimise täpsustamine\n\nAuditirakendus\n\n* Kehtetute sedelite korrektse dekrüpteerimise kontrollimine\n* Sedelite kontrolli täpsustused\n\nValijarakendused ja seadistusrakendus\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n* TLS 1.3\n* Mitme PKCS11 tokeni tugi\n* Windowsi serdituvastuse parendamine\n* Aegunud sertide tuvastamine\n* DLL laadimisvigade parandamine\n* Ligipääsetavus macOS platvormil\n* Kasutajaliidese muudatused\n* Kuvatõmmiste automatiseerimine\n\nDokumentatsioon\n~~~~~~~~~~~~~~~\n\n* Web eID autentimismeetodiga seotud dokumentatsiooni lisamine\n* Eesti- ja ingliskeelse dokumentatsiooni ühtlustamine\n\nLogimonitor\n~~~~~~~~~~~\n\n* Ubuntu 22.04 tugi\n* Grafana versiooni uuendamine\n* Statistika arvutuste täpsustamine\n\n\nMuudatused tarne 1.8.2 koosseisus, erinevused võrreldes tarnega 1.8.1\n--------------------------------------------------------------------------------\n\nKogumisteenus\n~~~~~~~~~~~~~\n\nÜldised muutused\n\n* Valijate nimekirjade vormingu muutus\n* EHS/VIS X-tee liidese CI lisandumine\n* EHS/VIS X-tee liidese dokumentatsiooni täpsustumine\n* Väiksemad veaparandused\n\nRegistreerimisteenus\n~~~~~~~~~~~~~~~~~~~~\n\n* Muudatusi ei ole\n\nKontrollrakendused\n~~~~~~~~~~~~~~~~~~\n\nAndroid\n\n* RSA eemaldamine\n* Veaparandused\n\niOS\n\n* Muudatusi ei ole\n\nMiksnet\n~~~~~~~\n\n* Muudatusi ei ole\n\nTöötleja rakendused\n~~~~~~~~~~~~~~~~~~~\n\nÜldised\n\n* Valijate nimekirjade vormingu muutus\n\nVõtmerakendus\n\n* Muudatusi ei ole\n\nTöötlemisrakendus\n\n* Töövoogude konsolideerimine\n\nAuditirakendus\n\n* Muudatusi ei ole\n\nValijarakendused ja seadistusrakendus\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n* Väiksemad veaparandused\n\nDokumentatsioon\n~~~~~~~~~~~~~~~\n\n* Täpsustused seoses muudatustega tarkvaras\n\nLogimonitor\n~~~~~~~~~~~\n\n* Muudatusi ei ole\n\nMuudatused tarne 1.8.1 koosseisus, erinevused võrreldes tarnega 1.7.7\n--------------------------------------------------------------------------------\n\nKogumisteenus\n~~~~~~~~~~~~~\n\nÜldised muutused\n\n* Smart-ID toe lisandumine\n* EHS/VIS X-tee liidese lisandumine\n* Hääletamisfaktide järjestamine\n* Seadistatav SNI\n\n\nRegistreerimisteenus\n~~~~~~~~~~~~~~~~~~~~\n\n* Muudatusi ei ole\n\nKontrollrakendused\n~~~~~~~~~~~~~~~~~~\n\nAndroid\n\n* Smart-ID\n* Täpsustatud krüptogrammi kontroll\n* Seadistatav SNI\n\niOS\n\n* Smart-ID\n* Täpsustatud krüptogrammi kontroll\n* Seadistatav SNI\n\nMiksnet\n~~~~~~~\n\n* Muudatusi ei ole\n\nTöötleja rakendused\n~~~~~~~~~~~~~~~~~~~\n\nÜldised\n\n* Smart-ID\n\nVõtmerakendus\n\n* Muudatusi ei ole\n\nTöötlemisrakendus\n\n* Töövoogude konsolideerimine, täpsustused parameetrites\n\nAuditirakendus\n\n* Muudatusi ei ole\n\nValijarakendused ja seadistusrakendus\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n* SmartID\n* Uuendatud väljanägemine\n\nDokumentatsioon\n~~~~~~~~~~~~~~~\n\n* Täpsustused seoses muudatustega tarkvaras - SmartID, jne.\n\nLogimonitor\n~~~~~~~~~~~\n\n* SmartID\n\nMuudatused tarne 1.7.7 koosseisus, erinevused võrreldes tarnega 1.7.6\n--------------------------------------------------------------------------------\n\nKogumisteenus\n~~~~~~~~~~~~~\n\nÜldised muutused\n\n* Muudatusi ei ole\n\nHaldusteenus\n\n* Muudatusi ei ole\n\nIVXV mikroteenused\n\n* Muudatusi ei ole\n\nRegistreerimisteenus\n~~~~~~~~~~~~~~~~~~~~\n\n* Muudatusi ei ole\n\nKontrollrakendused\n~~~~~~~~~~~~~~~~~~\n\nAndroid\n\n* Muudatusi ei ole\n\niOS\n\n* Muudatusi ei ole\n\nMiksnet\n~~~~~~~\n\n* Muudatused seoses entroopia allika valikulise tühjendamisega\n\nTöötleja rakendused\n~~~~~~~~~~~~~~~~~~~\n\nÜldised\n\n* Muudatusi ei ole\n\nVõtmerakendus\n\n* Muudatusi ei ole\n\nTöötlemisrakendus\n\n* Muudatusi ei ole\n\nAuditirakendus\n\n* Muudatusi ei ole\n\nValijarakendused ja seadistusrakendus\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n* Muudatusi ei ole\n\nDokumentatsioon\n~~~~~~~~~~~~~~~\n\n* Muudatused seoses miksneti muutustega\n\nLogimonitor\n~~~~~~~~~~~\n\n* Muudatusi ei ole\n\n\nMuudatused tarne 1.7.6 koosseisus, erinevused võrreldes tarnega 1.6.0\n--------------------------------------------------------------------------------\n\nKogumisteenus\n~~~~~~~~~~~~~\n\nÜldised muutused\n\n* Muudatused seoses sisendnimekirjade haldamisega VIS3's\n* Muudatused seoses Ubuntu 20.04 toetamisega\n* Väiksemad muutused/veaparandused vastavalt `changelog` failile\n\nHaldusteenus\n\n* Väiksemad muutused/veaparandused vastavalt `changelog` failile\n\nIVXV mikroteenused\n\n* Väiksemad muutused/veaparandused vastavalt `changelog` failile\n\nRegistreerimisteenus\n~~~~~~~~~~~~~~~~~~~~\n\n* Muudatusi ei ole\n\nKontrollrakendused\n~~~~~~~~~~~~~~~~~~\n\nAndroid\n\n* Muudatused seoses API versioonile 28 liikumisega\n* Aegunud rakenduse tuvastamine\n\niOS\n\n* Muudatused seoses iOS versioonile 12 liikumisega\n* Aegunud rakenduse tuvastamine\n\nMiksnet\n~~~~~~~\n\n* Muudatused seoses Ubuntu 20.04 toetamisega\n\nTöötleja rakendused\n~~~~~~~~~~~~~~~~~~~\n\nÜldised\n\n* Muudatused seoses sisendnimekirjade haldamisega VIS3s\n\nVõtmerakendus\n\n* Muudatusi ei ole\n\nTöötlemisrakendus\n\n* Töötlemise töövoogude optimeerimine\n\nAuditirakendus\n\n* Muudatusi ei ole\n\nValijarakendused ja seadistusrakendus\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n* M1 protsessoritüübi toetamine macOS platvormil\n* FLTK, OpenSSL ja teiste alusteekide versiooniuuendused\n* Aegunud rakenduse tuvastamine\n\nDokumentatsioon\n~~~~~~~~~~~~~~~\n\n* Muudatused seoses muutustega seadistustes ning terminoloogias\n\nLogimonitor\n~~~~~~~~~~~\n\n* Kaasatud tarnesse\n\n\n\n\nMuudatused tarne 1.6.0 koosseisus, erinevused võrreldes tarnega 1.5.0\n--------------------------------------------------------------------------------\n\nKogumisteenus\n~~~~~~~~~~~~~\n\nÜldised muutused\n\n* Mobiil-ID REST teenuse toetamine\n* Väiksemad muutused/veaparandused vastavalt `changelog` failile\n\nHaldusteenus\n\n* Väiksemad muutused/veaparandused vastavalt `changelog` failile\n\nIVXV mikroteenused\n\n* Väiksemad muutused/veaparandused vastavalt `changelog` failile\n\nRegistreerimisteenus\n~~~~~~~~~~~~~~~~~~~~\n\n* Muudatusi ei ole\n\nKontrollrakendused\n~~~~~~~~~~~~~~~~~~\n\nAndroid\n\n* Muudatusi ei ole\n\niOS\n\n* Muudatusi ei ole\n\nMiksnet\n~~~~~~~\n\n* Java versiooni 11 kasutuselevõtt\n* Verificatumi versiooniuuendus\n\nTöötleja rakendused\n~~~~~~~~~~~~~~~~~~~\n\nÜldised\n\n* Java versiooni 11 kasutuselevõtt\n\nVõtmerakendus\n\n* RSA võtmete serialiseerimise uus vorming\n\nTöötlemisrakendus\n\n* Muudatusi ei ole\n\nAuditirakendus\n\n* Muudatusi ei ole\n\nValijarakendused ja seadistusrakendus\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n* Mobiil-ID REST teenuse tugi\n\nDokumentatsioon\n~~~~~~~~~~~~~~~\n\n* Mobiil-ID REST teenuse tugi\n\nLogimonitor\n~~~~~~~~~~~\n\n* Eemaldatud tarnest seoses litsentsi lõppemisega\n\n\n\nMuudatused tarne 1.5.0 koosseisus, erinevused võrreldes tarnega 1.4.1\n--------------------------------------------------------------------------------\n\nKogumisteenus\n~~~~~~~~~~~~~\n\nÜldised muutused\n\n* Kõigi päringute logimine\n* etcd Debian buster repositooriumist, uusima golang-google-rpc saamiseks\n* Väiksemad muutused/veaparandused vastavalt `changelog` failile\n\nHaldusteenus\n\n* Väiksemad muutused/veaparandused vastavalt `changelog` failile\n\nIVXV mikroteenused\n\n* Väiksemad muutused/veaparandused vastavalt `changelog` failile\n\nRegistreerimisteenus\n~~~~~~~~~~~~~~~~~~~~\n\n* Muudatusi ei ole\n\nKontrollrakendused\n~~~~~~~~~~~~~~~~~~\n\nAndroid\n\n* Muudatused seoses koodiläbivaatuse ja veatöötluse parendamisega\n\niOS\n\n* Muudatusi ei ole\n\nMiksnet\n~~~~~~~\n\n* Muudatused seoses 300K hääle miksimisega\n\nTöötleja rakendused\n~~~~~~~~~~~~~~~~~~~\n\nÜldised\n\n* Valimise identifikaatori kasutamine läbiva prefiksina\n\nVõtmerakendus\n\n* Muudatused seoses koodiläbivaatusega\n\nTöötlemisrakendus\n\n* Muudatused seoses 300K hääle töötlemisega\n\nAuditirakendus\n\n* Edenemisriba\n* Muudatused seoses 300K hääle töötlemisega\n\nValijarakendused ja seadistusrakendus\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n* MSAA toe täpsustamine\n* Süsteemsete PIN-dialoogide kasutamine Windows platvormil\n\nDokumentatsioon\n~~~~~~~~~~~~~~~\n\n* IVXV audiitori juhendi lisamine\n* Muudatusdokumentide lisamine tarnesse\n\n\nLogimonitor\n~~~~~~~~~~~\n\n* Muutused/veaparandused vastavalt `changelog` failile\n\n\n\n\nMuudatused tarne 1.4.1 koosseisus, erinevused võrreldes tarnega 1.4.0\n--------------------------------------------------------------------------------\n\nKogumisteenus\n~~~~~~~~~~~~~\n\nÜldised muutused\n\n* Väiksemad muutused/veaparandused vastavalt `changelog` failile\n\nHaldusteenus\n\n* Väiksemad muutused/veaparandused vastavalt `changelog` failile\n\nIVXV mikroteenused\n\n* Väiksemad muutused/veaparandused vastavalt `changelog` failile\n\nRegistreerimisteenus\n~~~~~~~~~~~~~~~~~~~~\n\n* Muudatusi ei ole\n\nKontrollrakendused\n~~~~~~~~~~~~~~~~~~\n\nAndroid\n\n* Muudatusi ei ole\n\niOS\n\n* Muudatusi ei ole\n\nMiksnet\n~~~~~~~\n\n* Muudatusi ei ole\n\nTöötleja rakendused\n~~~~~~~~~~~~~~~~~~~\n\nÜldised\n\n* Muudatusi ei ole\n\nVõtmerakendus\n\n* Tööriista *init* väljundfailide muutus\n* Tööriista *init* SN ja CN parameetrite muutus\n* Tööriista *testkey* sisendparameetrite muutus\n* Tööriista *decrypt* kasutatud kaardinumbrite kuvamine\n\nTöötlemisrakendus\n\n* Muudatusi ei ole\n\nAuditirakendus\n\n* Muudatusi ei ole\n\nValijarakendused ja seadistusrakendus\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n* MSAA toe täpsustamine\n\nDokumentatsioon\n~~~~~~~~~~~~~~~\n\n* IVXV protokollid - registreerimisprotokolli lisamine\n* IVXV seadistuste koostejuhend - läbivad täiendused ning käsiraamatuga\n ühtlustamine.\n* IVXV valijarakendus - läbivad täiendused.\n* IVXV mixnet - dokument hõlmatud seadistuste koostejuhendisse, eemaldatud.\n* IVXV registreerimisteenus - dokument hõlmatud protokollistikku, eemaldatud.\n\nLogimonitor\n~~~~~~~~~~~\n\n* Väiksemad muutused/veaparandused vastavalt `changelog` failile\n\nMuudatused tarne 1.4.0 koosseisus, erinevused võrreldes tarnega 1.3.0\n--------------------------------------------------------------------------------\n\nKogumisteenus\n~~~~~~~~~~~~~\n\nÜldised muutused\n\n* OCSP ja ajatemplipäringute automaatne kordamine vastavalt\n konfiguratsioonile\n* BDOC-TS allkirjakonteinerite toetamine\n* Tühjade valijanimekirjade tugi\n\nHaldusteenus\n\n* Väiksemad muutused/veaparandused vastavalt `changelog` failile\n\nIVXV mikroteenused\n\n* Väiksemad muutused/veaparandused vastavalt `changelog` failile\n\nRegistreerimisteenus\n~~~~~~~~~~~~~~~~~~~~\n* Muudatusi ei ole\n\nKontrollrakendused\n~~~~~~~~~~~~~~~~~~\n\nAndroid\n\n* TLS 1.2 toetamine API-versioonide < 19 korral\n* Abiinfo vaate asendamine süsteemse brauseriga\n* Kuvast väljuvate tekstide automaatne lühendamine nuppude korral\n\niOS\n\n* Muudatusi ei ole\n\nMiksnet\n~~~~~~~\n\n* Muudatusi ei ole\n\nTöötleja rakendused\n~~~~~~~~~~~~~~~~~~~\n\nÜldised\n\n* Jaoskonnanumbri unikaalsusnõuete täpsustamine\n* Tühja valijatenimekirja tugi\n* Kodeeringuvigadega sertifikaatide toetamine rakendustes\n\nVõtmerakendus\n\n* Eemaldatud LOG4 ja LOG5\n\nTöötlemisrakendus\n\n* Eemaldatud PDF vormingus valijate nimekiri faasist *revoke*\n\nAuditirakendus\n\n* Muudatusi ei ole\n\nValijarakendused ja seadistusrakendus\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n* macOS 10.11 toetamine\n* 32bit Linuxi toetamine\n* UPX versiooni uuendamine\n* Pinpad kaardilugejate töökindluse tõstmine (Win)\n* ID-kaardi suhtlusvigade parandamine (Win7/ECC)\n* Nii PEM kui DER vormingus andmete import (Seadistaja)\n* Lisatud Seadistuste valideerimisvõimalus (Seadistaja)\n* Parandatud käitumine liigsuurte seadistuste korral (Seadistaja)\n\nDokumentatsioon\n~~~~~~~~~~~~~~~\n\n* Dokumentatsiooni uuendamine muudatuste kajastamiseks ning DEMO2018\n tagasiside arvestamiseks\n\nLogimonitor\n~~~~~~~~~~~\n\n* MTA sõltuvuse lisamine\n* CSV logiväljavõtte täpsustamine, algus- ja lõpuaja lisamine\n* Logianalüüsi optimeerimine mitmetuumalise riistvara jaoks\n* Väiksemad muutused/veaparandused vastavalt `changelog` failile\n\nMuudatused tarne 1.3.0 koosseisus, erinevused võrreldes tarnega 1.2.0\n--------------------------------------------------------------------------------\n\nKogumisteenus\n~~~~~~~~~~~~~\n\nÜldised muutused\n\n* Ubuntu 18.04 LTS (Bionic Beaver) kasutuselevõtmine\n* Krahhitaaste protseduuride kirjeldamine\n\nHaldusteenus\n\n* Parandatud tööriistad teenuste seisundiinfo saamiseks\n* Väiksemad muutused/veaparandused vastavalt `changelog` failile\n\nIVXV mikroteenused\n\n* golang keeleversioon 1.9 kasutuselevõtmine\n* Eesti ID-kaardi uuenenud profiili toetamine (PNOEE)\n* Väiksemad muutused/veaparandused vastavalt `changelog` failile\n\nRegistreerimisteenus\n~~~~~~~~~~~~~~~~~~~~\n* Muudatusi ei ole\n\nKontrollrakendused\n~~~~~~~~~~~~~~~~~~\n\nAndroid\n\n* ESTEID2018 sertifikaatide toetamine\n* Täpsustatud vigase ASN1-kodeeringuga avalike võtmete käitlemist\n\niOS\n\n* ESTEID2018 sertifikaatide toetamine\n* iPhone 10 X muudatused\n* XCode 10 ja iOS 12 SDK kasutamine\n\nMiksnet\n~~~~~~~\n\n* Verificatumi AGPL versiooni kasutuselevõtmine\n\nTöötleja rakendused\n~~~~~~~~~~~~~~~~~~~\n\nVõtmerakendus\n\n* Muudatusi ei ole\n\nTöötlemisrakendus\n\n* Lisatud tööriist StatsTool valimiskastist statistikafaili genereerimiseks\n* Lisatud tööriist StatsDiffTool kahe statistikafaili võrdlemiseks\n* ESTEID2018 sertifikaatide ja profiili toetamine\n* digidoc4j 2.1.0 kasutamine\n\nAuditirakendus\n\n* Muudatusi ei ole\n\nValijarakendused ja seadistusrakendus\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n* Valijarakenduses kandidaatide otsingu võimaldamine\n* Valijarakenduses erakondade ja kandidaatide kaustana kuvamine\n* Valijarakenduse ja Seadistusrakenduse üleviimine JSON-vormingus seadistustele\n* ESTEID2018 sertifikaatide ja profiili toetamine\n* Win: IDEMIA minidraiveri toetamine\n* Linux/macOS: IDEMIA PKCS11 draiveri toetamine\n* macOS 10.14 toetamine\n\nDokumentatsioon\n~~~~~~~~~~~~~~~\n\n* Dokumentatsiooni uuendamine muudatuste kajastamiseks\n* Ingliskeelse arhitektuuridokumendi ja protokollistiku lisamine\n\nLogimonitor\n~~~~~~~~~~~\n\n* Ubuntu 18.04 LTS (Bionic Beaver) kasutuselevõtmine\n* Võetud kasutusele Grafana 5.3.4\n* Parandatud vanusepõhise statistika genereerimine ja vanusegruppidesse\n jaotumine\n* CSV väljundi võtmine seanssidest\n\nMuudatused tarne 1.2.0 koosseisus, erinevused võrreldes KOV2017 valimistega.\n--------------------------------------------------------------------------------\n\nKogumisteenus\n~~~~~~~~~~~~~\n\nHaldusteenus\n\n* Lisatud tööriist vigaste valijanimekirjade eemaldamiseks.\n* Lisatud tööriist jaoskondade/ringkondade nimekirja lisamiseks.\n* Lisatud ringkonnapõhine statistika.\n* Lisatud varundusteenus.\n* Lisatud tööriist varundatud valimiskastide konsolideerimiseks.\n* Lisatud tööriist nimekirjade kooskõlalisuse kontrolliks.\n* Lisatud võimekus seadistusfailidele valimisspetsiifiliste prefiksite lisamiseks.\n* Täiendatud haldusliidese kasutajaliidest abiinfoga.\n* Eemaldatud aegunud konfiguratsiooniparameeter “stats.*”\n* Parandatud sisendfailide vormingu kontrolli ja laadimist.\n\nIVXV mikroteenused\n\n* Uuendatud etcd versioon.\n* Lisatud võimekus etcd ajalõppude seadistamiseks keskkonnamuutujate kaudu.\n* Lisatud võimekus klastri modifitseerimiseks krahhitaaste eesmärgil.\n* Parandatud klastri käitumist liidrivahetuse korral, pooleliolevate talletamiste kordamine.\n* TLS šifrid muudetud seadistatavaks.\n* Parandatud BDOC profiili identifitseeriva konfiguratsioonivälja nimi.\n* Lisatud võimekus seadistada Mobiil-ID autentimist nõudma nii isikukoodi kui telefoninumbrit.\n* Lisatud võimekus piirata korduvhääletamise sagedust.\n* Lisatud võimekus toetada Windowsi reavahetusi konfifailides.\n* Täiustatud BDOC XML kanoniseerimist ja parsimist.\n* Karmistatud DDS päringute vormingukontrolle.\n* Logimine viidud üle RELP protokollile.\n* Muudetud seadistusfailide ülesehitust eristamaks Koguja ja Töötleja vastutusi.\n\nRegistreerimisteenus\n~~~~~~~~~~~~~~~~~~~~\n* Muudatusi ei ole.\n\nKontrollrakendused\n~~~~~~~~~~~~~~~~~~\n\nAndroid\n\n* Lisatud juhised publitseeritud kontrollrakenduse ja avalikustatud lähtekoodi vastavuse kontrollimiseks.\n\niOS\n\n* Muudatusi ei ole.\n\nMiksnet\n~~~~~~~\n* Muudatusi ei ole.\n\nTöötleja rakendused\n~~~~~~~~~~~~~~~~~~~\nVõtmerakendus\n\n* Muudatusi ei ole.\n\nTöötlemisrakendus\n\n* Muudatusi ei ole.\n\nAuditirakendus\n\n* Muudatusi ei ole.\n\nValijarakendused ja seadistusrakendus\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n* Linux ja Mac – platvormispetsiifilisi muudatusi ei ole.\n* Windows – parandatud liidestumist Minidraiveriga, mingw64 kasutuselevõtmine.\n* Lisatud ID-kaardi ECC toetamine.\n* Seadistatud Mobiil-ID nõudma vajadusel isikukoodi ja telefoninumbrit.\n* Täiendatud veakoode.\n* Kohandatud seadistusrakendus muudatustega vastavusse.\n* Kohandatud BDOC XML mallid\n\nDokumentatsioon\n~~~~~~~~~~~~~~~\n* Dokumentatsioon läbivalt kaasajastatud seoses muudatustega\n\nLogimonitor\n~~~~~~~~~~~\n* Loobutud CrateDBst.\n* Võetud läbivalt kasutusele PostgreSQL.\n* Võetud kasutusele Grafana 5.0.1.\n* Seansside valideerimise parandused lähtudes KOV2017 logianalüüsist.\n* Lisatud statistika genereerimine ringkondade kaupa.\n" }, { "path": "Documentation/spelling_wordlist.txt", "content": "\nagregeerimise\nagregeeritakse\najakohastamine\nandmeaudit\nandmeauditi\nanonüümib\nanonüümimine\nanonüümitakse\nanonüümitud\narhitektuuridokumendi\nATO'd\nATO'le\naudit\nauditi\nauditit\nauditirakendus\nauditirakenduse\nauditirakendusega\nautentimismeetod\nautentimismeetodi\nautentimismeetodiga\nautentimisprotsessi\nautentimisseansi\nautentimissertifikaadi\nautentimissertifikaat\nautentimissertifikaati\nautentimisteenuse\nautentimistõend\nautentimistõendi\nautentimisvahendina\nautentimisvahendite\nautomaatvarunduse\n\nBase\nbitise\n\nCSV\n\ndekodeerub\ndekrüpteeruvad\nDER\nDigi\ndigiallkirjastatud\ndigiallkirja\ndigiallkirjade\ndimensioneerida\n\neID\neID'ga\nelliptkõver\nelliptkõverad\nelliptkõveraid\nelliptkõveral\nelliptkõverate\nelliptkõveratel\neskaleerimiseks\n\nhaldusutiliitide\nHEX\nhomomorfset\n\nID\nID'ga\nid'ga\nidentiteedi\nidentiteedile\nidentiteet\nidentiteeti\ningliskeelse\nIP\n\nkasutuselevõtmine\nkasutuselevõtt\nkodeeringud\nkodeeringus\nkodeeringut\nkodeeringuvigadega\nkonfifailides\nkoodekfiltri\nkooskõlastatakse\nkrüpteerinud\nkrüptib\nkrüptimise\nkõrgkäideldav\nkõrgkäideldava\nkõrgkäideldavuse\nkäideldavusnõuetele\nkäimasolev\nkäimasoleval\nkäsureautiliidid\nkäsureautiliitide\nkätluse\n\nliidestuma\nliidestumist\nliidestuva\nlogiseire\nlähtestab\nlähtestamine\nlähtestatakse\n\nmh\nmiksija\nmiksijale\nmiksimine\nmiksimise\nmiksimiseelse\nmiksimisega\nmiksimiseks\nmiksimisele\nmiksimisjärgse\nmiksimisrakendus\nmiksimisrakenduse\nmiksimisrakendusele\nmiksimisrakenduses\nmiksimisrakendusse\nmiksimist\nmiksimistõend\nmiksimistõendi\nmiksimistõendit\nmiksitud\nmiksnet\nmiksneti\nmiksnetist\nminidraiveriga\nmitmelõimelist\nModP\nmonitoorida\nmonitoorimine\nmonitooring\nmonitooringu\nmonitooringulahendus\nmonitooringule\nmonitooritavas\n\nnavigeerida\nnonsiks\nnonsina\nnonss\nnonsi\nnonssi\nnotatsioon\nnotatsioonis\nnö\n\nobfuskeerimine\nolemasolev\nolemasolu\norganisatsioonilis\nosak\nosakud\n\nparametriseerimise\nparametriseeritavad\nparendused\npermuteerib\npoll\nprivaatvõti\nprivaatvõtit\nprivaatvõtme\nprivaatvõtmed\nprogramselt\nprotokollistikku\npseudojuhuslik\npseudokoodina\npseudokrüptogramm\npuhverdatavat\n\nQR\n\nrefaktoreerimine\nresponderi\nriigiti\nroad\nRPC\nräsiga\nräsil\nräsile\n\nseadistusutiliidid\nseire\nseirelahendus\nseirelahenduse\nseirelahendusest\nseirele\nseireprogramm\nseireprogrammi\nseiresse\nseiret\nseiretarkvara\nseireteenuse\nseireteenusest\nserdid\nserdiprofiili\nserdituvastuse\nserialiseerimise\nsertide\nservice\nskaleerida\nskaleerimiseks\nskaleeritavuse\nskaleerub\nsmart\nspetsifikatsioon\nspetsifikatsiooni\nstandartne\n\nteadaoleva\nteadaolevaid\nteadaolevate\nteadasaamiseks\nteavitussüsteem\nteavituste\nteenushoste\nteenushosti\nteenushostide\nteenushostidesse\ntegevusmonitooringu\ntähelepanu\nTLS\n\nunikaalsusnõuete\nutiliidi\nutiliidid\nutiliidiga\nutiliit\nUML\nURL\n\nvallasrežiimis\nvallasrežiimirakendustest\nvarundab\nvarundama\nvarundamine\nvarundamise\nvarundamisele\nvarundamiseks\nvarundamist\nvarundatakse\nvarundatavad\nvarundati\nvarundatud\nvarundus\nvarunduse\nvarundusliidese\nvarundusprotseduuride\nvarundusserver\nvarundusserveri\nvarundusserveris\nvarundusserverisse\nvarundusserveritesse\nvarundusteenus\nvarundusteenuse\nvarundusteenuses\nvarundusteenusele\nvarundusteenusesse\nvarundusteenusest\nvarundusteenust\nveebisirviku\nVerificatum\nVerificatumi\nverifitseerib\nverifitseerida\nverifitseerimine\nverifitseerimise\nverifitseerimiseks\nverifitseerimisel\nverifitseerimisest\nverifitseerimiskoodi\nverifitseerimist\nverifitseerimisteenus\nverifitseerimisteenusega\nverifitseeritakse\nverifitseeritav\nverifitseeritavuse\nverifitseerivad\nverifitseerub\nvirtualiseerimistehnoloogiate\nvisualiseerimistarkvaraga\nvõtmeosakud\nvõtmeosakut\n\nülaosas\n\nweb\n\nX\nxroad\n\nzip\n" }, { "path": "LICENSE", "content": "Copyright: Vabariigi Valimisteenistus (Estonian State Electoral Office),\nwww.valimised.ee\n\nCreated in 2016-2025 by Cybernetica AS, www.cyber.ee\n\nThis work is licensed under the Creative Commons\nAttribution-NonCommercial-NoDerivs 3.0 Unported License. To view a copy of this\nlicense, visit http://creativecommons.org/licenses/by-nc-nd/3.0/.\n" }, { "path": "Makefile", "content": "JAVADIRS := common/java key processor auditor\nGODIRS := common/collector sessionstatus/api proxy mid smartid choices voting verification storage votesorder webeid sessionstatus\nOTHERDIRS := systemd Documentation\n\nTESTDIRS := $(patsubst %,test-%,$(JAVADIRS) $(GODIRS))\nINSTALLDIRS := $(patsubst %,install-%,$(JAVADIRS) $(GODIRS) systemd)\nCLEANDIRS := $(patsubst %,clean-%,$(JAVADIRS) $(GODIRS) $(OTHERDIRS))\n\nexport ROOT_BUILD=true\n\n# Needed to include newlines in $(forach) loops. Must contain two empty lines.\ndefine NEWLINE\n\n\nendef\n\n.PHONY: help\nhelp:\n\t@echo \"usage: make all Build all components\"\n\t@echo \" make test Run unit tests for all components\"\n\t@echo \" make install Install all collector components to \\$$DESTDIR\"\n\t@echo \" make install-java Install all application components to \\$$DESTDIR\"\n\t@echo \" make clean Clean the repository\"\n\t@echo\n\t@echo \" make Build the component (listed below)\"\n\t@echo \" make test- Run unit tests for the component\"\n\t@echo \" make install- Install the component to \\$$DESTDIR\"\n\t@echo \" make clean- Clean the component\"\n\t@echo\n\t@echo \" make external Checkout common/external to the expected version\"\n\t@echo \" make update-external Checkout common/external to the latest version\"\n\t@echo \" make version Update version numbers in all known locations to\"\n\t@echo \" the last entry in debian/changelog\"\n\t@echo\n\t@echo \"Components:\"\n\t$(foreach component,$(filter-out $(JAVADIRS) $(GODIRS),$(OTHERDIRS)),@echo \" $(component)\"$(NEWLINE))\n\t@echo\n\t@echo \" java (meta-component which includes all of the following)\"\n\t$(foreach component,$(JAVADIRS),@echo \" $(component)\"$(NEWLINE))\n\t@echo\n\t@echo \" go (meta-component which includes all of the following)\"\n\t$(foreach component,$(GODIRS),@echo \" $(component)\"$(NEWLINE))\n\t@echo\n\t@echo \"All rules can be suffixed with \\\"-dev\\\" to call them in development mode instead,\"\n\t@echo \"e.g., make all-dev.\"\n\t@echo\n\t@echo \"Read README.rst in both the repository root and specific component directories\"\n\t@echo \"for more details.\"\n\n.PHONY: all\nall: $(JAVADIRS) $(GODIRS) $(OTHERDIRS)\n\n.PHONY: java\njava: $(JAVADIRS)\n\n.PHONY: go\ngo: $(GODIRS)\n\n.PHONY: $(GODIRS)\n$(GODIRS): --gotools\n\t$(MAKE) -C $@ goimports\n\t$(MAKE) -C $@ ONLINE=$(ONLINE)\n\t$(MAKE) -C $@\n\n.PHONY: $(JAVADIRS)\n$(JAVADIRS):\n\t$(MAKE) -C $@\n\n.PHONY: $(OTHERDIRS)\n$(OTHERDIRS):\n\t$(MAKE) -C $@\n\n.PHONY: test\ntest: $(TESTDIRS)\n\n.PHONY: test-java\ntest-java: $(JAVADIRS:%=test-%)\n\n.PHONY: test-go\ntest-go: $(GODIRS:%=test-%)\n\n.PHONY: test-python\ntest-python:\n\t$(MAKE) -C tests unit-tests\n\n.PHONY: $(TESTDIRS)\n$(TESTDIRS): test-%:\n\t$(MAKE) -C $* test\n\n# Only install Go services and systemd unit files by default.\n.PHONY: install\ninstall: $(patsubst %,install-%,$(GODIRS) systemd)\n\n.PHONY: install-java\ninstall-java: $(JAVADIRS:%=install-%)\n\n.PHONY: $(INSTALLDIRS)\n$(INSTALLDIRS): install-%:\n\t$(MAKE) -C $* install\n\n.PHONY: clean\nclean: $(CLEANDIRS)\n\t$(MAKE) -C tests $@\n\t$(MAKE) -C release $@\n\trm -rf build dist common/tools/go/bin\n\n.PHONY: clean-java\nclean-java: $(JAVADIRS:%=clean-%)\n\n.PHONY: release-doc\nrelease-doc: go\n\t$(MAKE) -C Documentation/common/schema validate\n\t$(MAKE) -C Documentation release\n\n.PHONY: clean-go\nclean-go: $(GODIRS:%=clean-%)\n\n.PHONY: $(CLEANDIRS)\n$(CLEANDIRS): clean-%:\n\t$(MAKE) -C $* clean\n\n.PHONY: external\nexternal:\n\tgit submodule update --init\n\n\n.PHONY: update-external\nupdate-external:\n\tgit submodule update --init --remote\n\n\n.PHONY: version\nversion:\n\tpython3 common/tools/update_project_version.py\n\n# We cannot mark this target as phony without listing all possible targets.\n%-dev:\n\t$(MAKE) $* DEVELOPMENT=1\n\n# Target prefixed with \"--\" are not seen to the call `make [target]`\n.PHONY: --gotools\n--gotools:\n\t$(MAKE) -C common/collector gotools\n" }, { "path": "README.md", "content": "IVXV online voting system\n=========================\n\nThe intention behind this repository is to make source code of the Estonian\nonline voting system available for public review.\n\nThe repository is not used for active development, but will be kept up to date,\nso the code that can be found here is the code that is used for election. As the\nvoting system used for legally binding elections must strictly follow the\nlegislation, the actual development of Estonian I-voting system and I-vote\nverification application is supervised by State Electoral Office of Estonia.\nPlease refer to www.valimised.ee for further information.\n\n" }, { "path": "README.rst", "content": "==============================\nIVXV Internet voting framework\n==============================\n\n\n\n----------\n Building\n----------\n\nBuilding the collector components requires Go 1.9 and the management\napplications require Java 11::\n\n sudo apt-get install --no-install-recommends openjdk-11-jdk-headless golang-1.9-go\n\nThe submodule for external dependencies uses Git LFS. This must be locally\nsupported so make sure that it is installed::\n\n sudo apt-get install --no-install-recommends git-lfs\n\nNext, external dependencies need to be acquired. If working off of an offline\ncopy of the IVXV repository, then they are already included and this step can\nbe skipped. Otherwise run\n\n::\n\n make external\n\nto download the external dependecy repository.\n\nFinally, to build, test, and clean the entire codebase, just do\n\n::\n\n make all\n make test\n make clean\n\nIndividual components can be built, tested, and cleaned with\n\n::\n\n make \n make test-\n make clean-\n\nwhere ```` is the name name of the components subdirectory.\n\nAll components are built in release mode by default. To build in development\nmode, which enables dummy modules and other components not safe for release,\nthe make variable ``DEVELOPMENT`` must be set either on the command line or in\nthe environment. Every target of the root Makefile can be called with a\n``-dev`` suffix, which sets this variable during the make.\n\nDebian packages can be built using ``dpkg-buildpackage`` (or ``debuild`` if\npreferred) as usual.\n\n-------------\n Development\n-------------\n\nUpdating external dependencies\n------------------------------\n\nDuring development, if changes are pushed to the external dependencies\nrepository, then the reference needs to be updated in this repository to link\nthose changes to the current revision. This is done with\n\n::\n\n make update-external\n git add common/external\n git commit\n git push\n\nAfter the reference update has been pulled by other developers, they will get\nan entry in their ``git status`` output, indicating that external has changed::\n\n modified: common/external (new commits)\n\nTo fetch the changes to their local working tree, developers need to rerun\n\n::\n\n make external\n\nSetting GOPATH\n--------------\n\nThe IVXV project uses multiple GOPATH directories, one for each Go component.\nDuring ``make`` commands, the GOPATH will be automatically set, but if a\ndeveloper (or their IDE) wishes to run some manual Go commands, then this can\nbe tedious to specify. To help with this\n\n::\n\n make gopath\n\nwill print out the GOPATH used by the build system. So for example, when using\nBash,\n\n::\n\n export GOPATH=\"$(make gopath)\"\n\nwill set the correct GOPATH in the current shell.\n\n\n----------\n Releasing\n----------\n\nRelease builds are made using test system.\n\nTo make release build:\n\n* run ``dch --release`` to finalize the changelog for a release\n\n* run ``make release``\n\n *Note!* This creates a new virtual environment for building the\n release, so if you have installed a custom binaries or libraries to the\n local machine (e.g., the patched Go standard library from ivxv-golang),\n then those will not be used. In this case, build the Debian packages\n manually.\n" }, { "path": "auditor/.gitignore", "content": ".classpath\n.gradle/\n.idea/\n.project\nbuild/\n/log/\n/bin/\n.settings/\n" }, { "path": "auditor/Makefile", "content": "include ../common/java/common.mk\n" }, { "path": "auditor/README.rst", "content": "================================\n IVXV Internet voting framework\n================================\n---------------------\n Auditor application\n---------------------\n\nThe auditor application is an application for verifying the correctness of\noperations of other tools.\n\nThe application functionality is provided by the tools described below:\n\n* *convert* - tool for verifying that the proof of shuffle provided by\n Verificatum corresponds to the anonymized ballot boxes. The input ballot box\n is the anonymized ballot box output by the processor tool and the output\n ballot box is the anonymized ballot box output by the Verificatum prover\n application. The provided public key must be output by key generation\n tool.\n* *mixer* - tool for verifying the correctness of a proof of shuffle. The tool\n takes as input the protocol information file provided to Verificatum during\n shuffle and the proof directory output by it.\n* *decrypt* - tool for verifying the correctness of decryption. The tool uses\n public key and the proof of correct decryption output by the decryption tool.\n The tool also verifies whether the tally has been computed correctly and\n whether the files resulting from the decryption are consistent with one\n another.\n It outputs ciphertexts for which verification of the decryption proof failed.\n* *integrity* - tool for verifying the logs of the processing application. The\n tool uses the logs output by the processing application as well as the\n original and anonymised ballot boxes to verify the audit trail of the logs.\n\nBuilding\n--------\n\nIVXV java applications have 2 levels of build systems:\n\n* *make* - the build system facade. Must be installed on the user's machine.\n* *gradle* - the implementation of the build system. Gradle is located under\n ``common/external/gradle-8.11``, with the executable ``bin/gradle(.bat)``.\n\nBuilding:\n\n* ``make`` or\n* ``make all`` or\n* ``gradle build installDist`` - build and test the application.\n* ``make clean`` or\n* ``gradle clean`` - clean build resources, i.e. the directory ``build``.\n\nApplication executable is ``build/install/auditor/bin/auditor(.bat)``.\n\nDistributable application packages are provided under ``build/distributions/``.\n\nSample executions\n-----------------\n\nAs the command-line arguments have to be defined precisely for correct\noperation, we strongly recommend using a parameters file. Refer to the\nconfiguration preparation documentation for the example configurations.\n\n* Verify the correctness of file format conversion::\n\n auditor convert --conf app-conf.bdoc --params auditor-app-conf.bdoc\n\n* Verify the correcntess of the shuffle::\n\n auditor mixer --conf app-conf.bdoc --params auditor-app-conf.bdoc\n\n* Verify the correctness of decryption::\n\n auditor decrypt --conf app-conf.bdoc --params auditor-app-conf.bdoc\n\n* Verify the integrity of processing logs::\n\n auditor integrity --conf app-conf.bdoc --params auditor-app-conf.bdoc\n\nSample configuration\n--------------------\n\n.. code-block:: yaml\n\n convert:\n input_bb: bb-4.json\n output_bb: bb-5.json\n pub: initout/pub.pem\n protinfo: mixnet/ProtocolInformation.xml\n proofdir: mixnet/\n\n mixer:\n protinfo: mixnet/ProtocolInformation.xml\n proofdir: mixnet/\n threaded: true\n\n decrypt:\n proofs: decout/proof\n pub: initout/pub.pem\n discarded: decout/invalid\n anon_bb: bb-4.json\n plain_bb: decout/TESTQUESTION.plain\n tally: decout/TESTQUESTION.tally\n candidates: choices.bdoc\n districts: districts.bdoc\n out: auditout/\n invalidity_proofs: decout/proof-invalid\n\n integrity:\n ballotbox: votes.zip\n anon_bb: bb-4.json\n log_accepted: out-1/TESTQUESTION.check.log1\n log_squashed: out-2/TESTQUESTION.squash.log2\n log_revoked: out-3/TESTQUESTION.revoke.log2\n log_anonymised: out-4/TESTQUESTION.anonymize.log3\n bb_errors: out-1/ballotbox_errors.txt\n" }, { "path": "auditor/build.gradle", "content": "buildscript {\n ext.base = '../'\n apply from: \"${base}/common/java/common-buildscript.gradle\", to: buildscript\n}\n\napply from: \"${base}/common/java/common-build.gradle\"\napply plugin: 'application'\n\ndependencies {\n implementation project(\":common\")\n\n testImplementation testFixtures(project(\":common\"))\n}\n\napplication {\n\tmainClass = \"ee.ivxv.audit.Audit\"\n\tapplicationDefaultJvmArgs = [\"-Xmx8G\"]\n}\n" }, { "path": "auditor/settings.gradle", "content": "include \"common\"\nproject(\":common\").projectDir = file(\"../common/java\")\n" }, { "path": "auditor/src/main/java/ee/ivxv/audit/Audit.java", "content": "package ee.ivxv.audit;\n\nimport ee.ivxv.common.cli.AppRunner;\n\npublic class Audit {\n\n public static void main(String[] args) {\n AuditApp app = new AuditApp();\n AppRunner runner = new AppRunner<>(app);\n\n if (!runner.run(args)) {\n System.exit(1);\n }\n }\n\n}\n" }, { "path": "auditor/src/main/java/ee/ivxv/audit/AuditApp.java", "content": "package ee.ivxv.audit;\n\nimport ee.ivxv.audit.tools.ConvertTool;\nimport ee.ivxv.audit.tools.ConvertTool.ConvertArgs;\nimport ee.ivxv.audit.tools.DecryptTool;\nimport ee.ivxv.audit.tools.DecryptTool.DecryptArgs;\nimport ee.ivxv.audit.tools.IntegrityTool;\nimport ee.ivxv.audit.tools.IntegrityTool.IntegrityArgs;\nimport ee.ivxv.audit.tools.MixerTool;\nimport ee.ivxv.audit.tools.MixerTool.MixerArgs;\nimport ee.ivxv.common.cli.App;\nimport ee.ivxv.common.cli.CommonArgs;\nimport ee.ivxv.common.cli.InitialContext;\nimport ee.ivxv.common.cli.Tool;\nimport ee.ivxv.common.conf.Conf;\nimport java.util.Arrays;\nimport java.util.List;\n\nclass AuditApp extends App {\n\n AuditApp() {\n super(Msg.app_audit, createTools());\n }\n\n private static List> createTools() {\n return Arrays.asList( //\n new Tool<>(Msg.tool_convert, ConvertArgs::new, ConvertTool::new),\n new Tool<>(Msg.tool_mixer, MixerArgs::new, MixerTool::new),\n new Tool<>(Msg.tool_decrypt, DecryptArgs::new, DecryptTool::new),\n new Tool<>(Msg.tool_integrity, IntegrityArgs::new, IntegrityTool::new));\n }\n\n @Override\n public AuditContext createContext(InitialContext ctx, Conf conf, CommonArgs args) {\n return new AuditContext(ctx, conf, args);\n }\n}\n" }, { "path": "auditor/src/main/java/ee/ivxv/audit/AuditContext.java", "content": "package ee.ivxv.audit;\n\nimport ee.ivxv.common.cli.AppContext;\nimport ee.ivxv.common.cli.CommonArgs;\nimport ee.ivxv.common.cli.InitialContext;\nimport ee.ivxv.common.conf.Conf;\n\npublic class AuditContext extends AppContext {\n\n public AuditContext(InitialContext i, Conf conf, CommonArgs args) {\n super(i, conf, args);\n }\n\n}\n" }, { "path": "auditor/src/main/java/ee/ivxv/audit/Msg.java", "content": "package ee.ivxv.audit;\n\nimport ch.qos.cal10n.BaseName;\nimport ch.qos.cal10n.LocaleData;\nimport ee.ivxv.common.util.NameHolder;\n\n@BaseName(\"i18n.audit-msg\")\n@LocaleData(defaultCharset = \"UTF-8\", value = {})\npublic enum Msg implements NameHolder {\n /*-\n * The part of the enum name until the first '_' (including) is excluded from the getName().\n * This is a means to provide multiple translations for the same tool or argument name.\n */\n\n // App\n app_audit,\n\n // Error messages\n e_proof_verif_false, e_proof_verif_exception,\n e_file_missing,\n\n // Tools\n tool_decrypt, tool_mixer, tool_convert, tool_integrity,\n\n // Tool arguments\n arg_abort_early, //\n arg_proofs, arg_invalidity_proofs, arg_discarded, //\n arg_hash, arg_links(\"l\"), arg_out(\"o\"), arg_pbb(\"p\"), arg_pub(\"p\"), //\n arg_revoke(\"r\"), arg_seed(\"s\"), arg_storage(\"s\"), arg_signaturepub, arg_threads(\"t\"), //\n arg_input_bb, arg_output_bb, arg_protinfo, arg_proofdir, arg_threaded, //\n arg_ballotbox, arg_ballotbox_checksum, arg_anon_bb, arg_plain_bb, //\n arg_log_accepted, arg_log_squashed, arg_log_revoked, arg_log_anonymised, arg_bb_errors, //\n arg_tally, arg_candidates, arg_districts, arg_questioncount, //\n\n // Messages\n m_yes, m_no, //\n m_pub_loading, m_pub_loaded, m_failurecount, m_verify_start, m_verify_finish, //\n m_decrypt_bb_has_proofs, m_decrypt_bb_has_invalids, m_decrypt_one_per_file, //\n m_decrypt_verified_valid, m_decrypt_verified_invalid, //\n m_decrypt_consistent_valids_begin, //\n m_decrypt_consistent_valids, m_decrypt_consistent_invalids, m_decrypt_dec_consistent, //\n m_decrypt_success, m_decrypt_failure, //\n m_shuffle_proof_loading, m_shuffle_proof_failed_reason, m_shuffle_proof_succeeded, //\n m_shuffle_proof_failed, m_convert_publickey_failed, m_convert_publickey_succ, //\n m_convert_bb_to_bt_failed, m_convert_bb_to_bt_succ, m_convert_bt_to_bb_failed, //\n m_convert_bt_to_bb_succ, m_shuffle_step, m_shuffle_read, m_shuffle_read_prot_info, //\n m_shuffle_read_pubkey, m_shuffle_read_pc, m_shuffle_read_posc, m_shuffle_read_posr, //\n m_shuffle_read_ciphs, m_shuffle_read_shuffled, //\n m_shuffle_verify, m_shuffle_verify_params, m_shuffle_verify_ni, m_shuffle_verify_permutation, //\n m_shuffle_verify_rerandomisation, //\n m_plain_loading, m_plain_loaded, m_plain_count, //\n m_tally_loading, m_tally_loaded, m_tally_match, //\n m_discarded_loading, m_discarded_loaded, m_discarded_count, //\n m_bb_loading, m_bb_loaded, m_anon_loading, m_anon_loaded, //\n m_log_accepted, m_log_squashed, m_log_revoked, m_log_anonymised, m_bb_errors, //\n m_integrity_match_anon, m_integrity_match_anon_logs, //\n m_integrity_match_valid, m_integrity_match_logs, //\n m_integrity_bb_consistent, m_integrity_bb_inconsistent, m_integrity_recurring_ct, //\n m_tally_start, m_tally_done, m_out_tally, m_tally_read, //\n\n e_abb_invalid_question_count, //\n\n ;\n\n\n private final String shortName;\n\n Msg() {\n this(null);\n }\n\n Msg(String shortName) {\n this.shortName = shortName;\n }\n\n @Override\n public String getShortName() {\n return shortName;\n }\n\n @Override\n public String getName() {\n return extractName(name());\n }\n\n @Override\n public Enum getKey() {\n return this;\n }\n}\n" }, { "path": "auditor/src/main/java/ee/ivxv/audit/model/PlainBallotBox.java", "content": "package ee.ivxv.audit.model;\n\nimport com.fasterxml.jackson.annotation.JsonCreator;\nimport com.fasterxml.jackson.annotation.JsonProperty;\n\n\nimport java.util.ArrayList;\nimport java.util.LinkedHashMap;\nimport java.util.Map;\nimport java.util.List;\n\n/**\n * JSON serializable structure for holding the decrypted ballot box.\n */\npublic record PlainBallotBox(String election, Map>> byParish,\n Map> byDistrict) {\n @JsonCreator\n public PlainBallotBox(@JsonProperty(\"election\") String election,\n @JsonProperty(\"byparish\") Map>> byParish,\n @JsonProperty(\"bydistrict\") Map> byDistrict) {\n this.election = election;\n this.byParish = byParish;\n this.byDistrict = byDistrict;\n }\n\n public Map> computeByDistrict() {\n Map> res = new LinkedHashMap<>();\n byParish().forEach((d, sMap) -> {\n List pList = res.computeIfAbsent(d, tmp -> new ArrayList<>());\n sMap.forEach((s, plains) -> pList.addAll(plains));\n });\n return res;\n }\n}\n" }, { "path": "auditor/src/main/java/ee/ivxv/audit/model/Tally.java", "content": "package ee.ivxv.audit.model;\n\n\nimport com.fasterxml.jackson.annotation.JsonCreator;\nimport com.fasterxml.jackson.annotation.JsonProperty;\nimport ee.ivxv.common.model.CandidateList;\nimport ee.ivxv.common.model.DistrictList;\n\nimport java.util.HashMap;\nimport java.util.LinkedHashMap;\nimport java.util.Map;\n\n/**\n * JSON serializable structure for holding the tally of the votes.\n */\npublic class Tally {\n public static final String INVALID_VOTE_ID = \"invalid\";\n private final String election;\n private final Map>> byParish;\n private final Map> byDistrict;\n\n\n @JsonCreator Tally(@JsonProperty(\"election\") String election,\n @JsonProperty(\"byparish\") Map>> byParish,\n @JsonProperty(\"bydistrict\") Map> byDistrict) {\n this.election = election;\n this.byParish = byParish;\n this.byDistrict = byDistrict;\n }\n\n /**\n * Get the election identifier.\n *\n * @return\n */\n public String getElection() {\n return election;\n }\n\n /**\n * @return Returns a map from district id to a map from station id to a map from candidate id to\n * number of received votes.\n */\n public Map>> getByParish() {\n return byParish;\n }\n\n /**\n * @return Returns a map from district id to a map from candidate id to number of received\n * votes.\n */\n public Map> getByDistrict() {\n return byDistrict;\n }\n\n public Map> computeByDistrict() {\n Map> res = new LinkedHashMap<>();\n getByParish().forEach((d, sMap) -> {\n Map ccMap = res.computeIfAbsent(d, tmp -> new LinkedHashMap<>());\n sMap.forEach((s, cMap) -> cMap.forEach((c, count) -> {\n ccMap.compute(c, (cc, ccount) -> ccount == null ? count : ccount + count);\n }));\n\n });\n return res;\n }\n}\n\n" }, { "path": "auditor/src/main/java/ee/ivxv/audit/shuffle/ByteTree.java", "content": "package ee.ivxv.audit.shuffle;\n\nimport ee.ivxv.common.math.*;\nimport ee.ivxv.common.util.Util;\nimport java.io.DataInputStream;\nimport java.io.File;\nimport java.io.FileInputStream;\nimport java.io.IOException;\nimport java.io.OutputStream;\nimport java.io.UnsupportedEncodingException;\nimport java.math.BigInteger;\nimport java.nio.ByteBuffer;\nimport java.nio.ByteOrder;\nimport java.nio.file.Path;\nimport java.util.HexFormat;\nimport java.util.Objects;\n\nimport org.bouncycastle.math.ec.ECFieldElement;\nimport org.bouncycastle.util.Arrays;\n\n/**\n * ByteTree decodes the ByteTree (BT) format as defined in Verificatum user manual.\n */\npublic class ByteTree {\n public int getLength() {\n return 0;\n }\n\n public int getEncodedLength() {\n return 0;\n }\n\n public byte[] getEncoded() {\n return null;\n }\n\n public void writeEncoded(OutputStream out) throws IOException {\n // Overridden\n }\n\n public boolean isLeaf() {\n return false;\n }\n\n public String getPrefix() {\n return \"\";\n }\n\n public String toString(int indent) {\n return \"\";\n }\n\n @Override\n public String toString() {\n return toString(0);\n }\n\n /**\n * Node is a recursive object in a ByteTree which consists of an array of nodes and leafs.\n */\n public static class Node extends ByteTree {\n private final ByteTree[] nodes;\n\n public static final byte PREFIX = 0;\n\n /**\n * Initialize Node from an array of ByteTree objects.\n *\n * @param nodes Array of ByteTree objects.\n */\n public Node(ByteTree[] nodes) {\n this.nodes = nodes;\n }\n\n /**\n * Initialize Node from an array of BigInteger objects.\n *\n * @param ints Array of BigInteger objects\n */\n public Node(BigInteger[] ints) {\n nodes = new Leaf[ints.length];\n for (int i = 0; i < nodes.length; i++) {\n nodes[i] = new Leaf(ints[i]);\n }\n }\n\n /**\n * Initialize Node from an array of GroupElements.\n *\n * @param elements Array of GroupElements\n */\n public Node(GroupElement[] elements) {\n nodes = new ByteTree[elements.length];\n for (int i = 0; i < nodes.length; i++) {\n if (elements[i] instanceof ProductGroupElement) {\n nodes[i] = new Node((ProductGroupElement) elements[i]);\n } else if (elements[i] instanceof ECGroupElement) {\n nodes[i] = new Node((ECGroupElement) elements[i]);\n } else if (elements[i] instanceof ModPGroupElement) {\n nodes[i] = new Leaf(elements[i]);\n } else {\n throw new IllegalArgumentException(\"Unknown element type: \" + elements[i].getClass().getSimpleName());\n }\n }\n }\n\n /**\n * Initialize Node from ProductGroupElement.\n *\n * @param element A ProductGroupElement element\n */\n public Node(ProductGroupElement element) {\n nodes = new ByteTree[element.getElements().length];\n for (int i = 0; i < nodes.length; i++) {\n GroupElement ge = element.getElements()[i];\n if (ge instanceof ProductGroupElement) {\n nodes[i] = new Node((ProductGroupElement) ge);\n } else if (ge instanceof ECGroupElement) {\n nodes[i] = new Node((ECGroupElement) ge);\n } else if (ge instanceof ModPGroupElement) {\n nodes[i] = new Leaf(ge);\n } else {\n throw new IllegalArgumentException(\"Unknown element type: \" + ge.getClass().getSimpleName());\n }\n }\n }\n\n /**\n * Initialize Node from ECGroupElement.\n *\n * @param ec {@link ee.ivxv.common.math.ECGroupElement} instance\n */\n public Node(ECGroupElement ec) {\n // Size is two, because coordinate point (X,Y) == (BigInteger, BigInteger)\n nodes = new Leaf[2];\n\n ECFieldElement x = ec.getPoint().getXCoord();\n ECFieldElement y = ec.getPoint().getYCoord();\n\n int fieldSizeBytes = ec.getPoint().getCurve().getFieldSize();\n\n nodes[0] = new Leaf(ecFieldElementToLeaf(fieldSizeBytes, x));\n nodes[1] = new Leaf(ecFieldElementToLeaf(fieldSizeBytes, y));\n }\n\n /**\n * Return the array of ByteTree objects.\n *\n * @return Array of ByteTree objects.\n */\n public ByteTree[] getNodes() {\n return nodes;\n }\n\n /**\n * Get the number of elements in the ByteTree array.\n *\n * @return Length of array.\n */\n @Override\n public int getLength() {\n return nodes.length;\n }\n\n /**\n * Get the byte-length of the Node.\n *\n * @return Byte-length of the Node.\n */\n @Override\n public int getEncodedLength() {\n int sum = 5;\n for (ByteTree n : nodes) {\n sum += n.getEncodedLength();\n }\n return sum;\n }\n\n /**\n * Encode the Node as bytes.\n *\n * @return Node encoded as bytes\n */\n @Override\n public byte[] getEncoded() {\n byte[] ret = new byte[getEncodedLength()];\n ret[0] = PREFIX;\n System.arraycopy(ByteTree.parse_from_int(getLength()), 0, ret, 1, 4);\n int pt = 5;\n for (int i = 0; i < getLength(); i++) {\n byte[] enc = getNodes()[i].getEncoded();\n System.arraycopy(enc, 0, ret, pt, enc.length);\n pt += enc.length;\n }\n return ret;\n }\n\n /**\n * Encode the Node and write it to out.\n *\n * @param out Stream to write the ByteTree description of the Node.\n * @throws IOException When writing to out fails\n */\n @Override\n public void writeEncoded(OutputStream out) throws IOException {\n out.write(PREFIX);\n out.write(ByteTree.parse_from_int(getLength()));\n for (int i = 0; i < getLength(); i++) {\n getNodes()[i].writeEncoded(out);\n }\n }\n\n /**\n * @return false\n */\n @Override\n public boolean isLeaf() {\n return false;\n }\n\n /**\n * Parse an array of bytes into a node, starting at offset.\n *\n * @param b Array of bytes to be parsed.\n * @param offset The offset in the array to start parsing\n * @return A decoded Node instance.\n */\n public static Node parse(byte[] b, int offset) {\n int len = parse_int_fullbytes(b, offset);\n ByteTree[] bts = new ByteTree[len];\n int pt = 0;\n for (int i = 0; i < len; i++) {\n bts[i] = ByteTree.parse(b, offset + pt + 5);\n pt += bts[i].getEncodedLength();\n }\n Node n = new Node(bts);\n return n;\n }\n\n /**\n * Parse a DataInputStream into a node.\n *\n * The given DataInputStream must be pointed to the beginning of a valid Node element.\n *\n * @param is DataInputStream to be used for reading a node, seeked to the beginning of Node\n * definition.\n * @return A decoded Node instance.\n * @throws IOException When reading from the stream fails.\n */\n public static Node parse(DataInputStream is) throws IOException {\n int len = read_length(is);\n ByteTree[] bts = new ByteTree[len];\n for (int i = 0; i < len; i++) {\n bts[i] = ByteTree.parse(is);\n }\n Node n = new Node(bts);\n return n;\n }\n\n /**\n * @return \"NODE\".\n */\n @Override\n public String getPrefix() {\n return \"NODE\";\n }\n\n /**\n * Human-friendly representation of the Node object, with starting indentation.\n *\n * @param indent The indentation level\n * @return String representation of instance\n */\n @Override\n public String toString(int indent) {\n String spaces = new String(new char[indent]).replace(\"\\0\", \" \");\n String header = String.format(\"%s%s %d\", spaces, getPrefix(), getLength());\n String[] subs = new String[getLength() + 1];\n subs[0] = header;\n for (int i = 0; i < getLength(); i++) {\n subs[i + 1] = nodes[i].toString(indent + 1);\n }\n return String.join(\"\\n\", subs);\n }\n\n /**\n * Convert ECFieldElement to Leaf.\n * Mixnet Verificatum reference:\n * innerToByteArray\n *\n * @param fieldSize EC field size\n * @param ec EC field element\n * @return EC field element as Leaf\n */\n private byte[] ecFieldElementToLeaf(final int fieldSize, final ECFieldElement ec) {\n // https://github.com/verificatum/verificatum-vcr/blob/97974cfc4ebbb323e49396222823e226cae2bebe/src/java/com/verificatum/arithm/ECqPGroupElement.magic#L538\n int fieldSizeBytesPlusOne = MathUtil.toBytesLen(fieldSize) + 1;\n\n final byte[] leaf = new byte[fieldSizeBytesPlusOne];\n\n // null means infinity point\n if (Objects.isNull(ec)) {\n java.util.Arrays.fill(leaf, (byte) 0xFF);\n } else {\n final byte[] ecBytes = ec.toBigInteger().toByteArray();\n System.arraycopy(ecBytes, 0, leaf, leaf.length - ecBytes.length, ecBytes.length);\n }\n\n return leaf;\n }\n }\n\n /**\n * Leaf represents an abstract object.\n */\n public static class Leaf extends ByteTree {\n private final byte[] value;\n public static final byte PREFIX = 1;\n\n /**\n * Initialize a leaf from an abstract byte array.\n *\n * @param value A byte array\n */\n public Leaf(byte[] value) {\n this.value = value;\n }\n\n /**\n * Initialize a leaf from a String.\n *\n * @param value A string to initialize Leaf.\n */\n public Leaf(String value) {\n byte[] encoded = null;\n try {\n encoded = value.getBytes(\"US-ASCII\");\n } catch (UnsupportedEncodingException e) {\n // this encoding is supported\n }\n this.value = encoded;\n }\n\n /**\n * Initialize a leaf from a BigInteger.\n *\n * @param value A BigInteger to initialize Leaf.\n */\n public Leaf(BigInteger value) {\n this.value = value.toByteArray();\n }\n\n /**\n * Initialize a leaf from a GroupElement.\n *\n * @param value A GroupElement to initialize Leaf.\n */\n public Leaf(GroupElement value) {\n if (value instanceof ModPGroupElement) {\n this.value = getEncoded((ModPGroupElement) value);\n } else if (value instanceof ECGroupElement) {\n this.value = getEncoded((ECGroupElement) value);\n } else if (value instanceof ProductGroupElement) {\n throw new IllegalArgumentException(\"Use Node for ProductGroupElement\");\n } else {\n throw new IllegalArgumentException(\"Invalid group\");\n }\n }\n\n /**\n * Get the byte array used to initialize the Leaf.\n *\n * @return A byte array.\n */\n public byte[] getValue() {\n return value;\n }\n\n /**\n * Return a String representation of the underlying byte array.\n *\n * @return String representing byte array.\n */\n public String getString() {\n return Util.toString(getValue());\n }\n\n /**\n * Return a BigInteger representation of the underlying byte array.\n *\n * @return BigInteger representing byte array.\n */\n public BigInteger getBigInteger() {\n return new BigInteger(value);\n }\n\n /**\n * Get the length of the underlying byte array.\n *\n * @return Length of byte array.\n */\n @Override\n public int getLength() {\n return value.length;\n }\n\n /**\n * Get the length of the whole Leaf object represented as byte array.\n *\n * @return Length of Leaf instance representation as byte array.\n */\n @Override\n public int getEncodedLength() {\n return getLength() + 5;\n }\n\n /**\n * Get the value with corresponding headers.\n *\n * @return A byte array.\n */\n @Override\n public byte[] getEncoded() {\n byte[] ret = new byte[getEncodedLength()];\n ret[0] = PREFIX;\n System.arraycopy(ByteTree.parse_from_int(getLength()), 0, ret, 1, 4);\n System.arraycopy(getValue(), 0, ret, 5, getLength());\n return ret;\n }\n\n /**\n * Encode the Leaf and write it to out.\n *\n * @param out Stream to write the ByteTree description of the Leaf.\n * @throws IOException When writing to out fails\n */\n @Override\n public void writeEncoded(OutputStream out) throws IOException {\n out.write(PREFIX);\n out.write(ByteTree.parse_from_int(getLength()));\n out.write(getValue());\n }\n\n private byte[] getEncoded(ModPGroupElement value) {\n // Verificatum verifier manual says that enough enough bytes are needed such that the\n // element fits in. In implementation, it uses BigInteger.toByteArray().length, which is\n // not always the same (it has a bit for magnitude).\n byte[] ret = new byte[((ModPGroup) value.getGroup()).getOrder().toByteArray().length];\n byte[] bvalue = value.getValue().toByteArray();\n System.arraycopy(bvalue, 0, ret, ret.length - bvalue.length, bvalue.length);\n return ret;\n }\n\n private byte[] getEncoded(ECGroupElement v) {\n return v.getBytes();\n }\n\n /**\n * @return true\n */\n @Override\n public boolean isLeaf() {\n return true;\n }\n\n /**\n * Parse an array of bytes into a leaf.\n *\n * @param b The array of bytes to parse.\n * @param offset Starting offset to start parsing from.\n * @return The Leaf constructed from bytes.\n */\n public static Leaf parse(byte[] b, int offset) {\n int len = parse_int_fullbytes(b, offset);\n byte[] leafbytes = Arrays.copyOfRange(b, offset + 5, offset + 5 + len);\n return new Leaf(leafbytes);\n }\n\n /**\n * Parse a data stream into a leaf.\n *\n * Parses the given DataInputStream into the leaf. The given stream must be pointed to the\n * beginning of the definition (with length).\n *\n * @param is The given input stream, seeked to the beginning of the Leaf definition.\n * @return Leaf constructed from the input stream\n * @throws IOException When reading from the stream fails.\n */\n public static Leaf parse(DataInputStream is) throws IOException {\n int len = read_length(is);\n byte[] leafbytes = new byte[len];\n int read = is.read(leafbytes);\n if (read == -1) {\n throw new IOException(\"Unexpected end of stream\");\n } else if (read != len) {\n throw new IOException(\"Short read\");\n }\n return new Leaf(leafbytes);\n }\n\n /**\n * @return \"LEAF\"\n */\n @Override\n public String getPrefix() {\n return \"LEAF\";\n }\n\n /**\n * Return a human-friendly String representation of the Leaf with indentation.\n *\n * @param indent Indentation of the String.\n */\n @Override\n public String toString(int indent) {\n String spaces = new String(new char[indent]).replace(\"\\0\", \" \");\n return String.format(\"%s%s %d %s\", spaces, getPrefix(), getLength(),\n HexFormat.of().formatHex(getValue()).toUpperCase());\n }\n }\n\n /**\n * Parse an array of bytes into ByteTree instance. Internally, either Node or Leaf is\n * constructed depending on the prefix.\n *\n * @param b Byte array to be parsed.\n * @param offset Starting offset of the byte array to start parsing from.\n * @return A ByteTree representing the byte array.\n */\n public static ByteTree parse(byte[] b, int offset) {\n if (offset < 0) {\n throw new IllegalArgumentException(\"Offset must be non-negatove\");\n }\n if (b == null || b.length <= offset + 5) {\n throw new IllegalArgumentException(\"Non-existing bytetree\");\n }\n\n if (b[offset] == Node.PREFIX) {\n return Node.parse(b, offset);\n } else if (b[offset] == Leaf.PREFIX) {\n return Leaf.parse(b, offset);\n }\n throw new IllegalArgumentException(\"Invalid bytetree value\");\n }\n\n /**\n * Parse an input stream into ByteTree instance.\n *\n * Depending on the prefix, either Node or Leaf instance is constructed.\n *\n * @param is Given input stream to construct the ByteTree instance from, seeked to the\n * beginning.\n * @return A ByteTree representing the byte array.\n * @throws IOException When reading from the stream fails or if the prefix is invalid.\n */\n public static ByteTree parse(DataInputStream is) throws IOException {\n switch (is.read()) {\n case -1:\n throw new IOException(\"Unexpected end of stream\");\n case Node.PREFIX:\n return Node.parse(is);\n case Leaf.PREFIX:\n return Leaf.parse(is);\n default:\n throw new IOException(\"Unexpected token in input stream\");\n }\n }\n\n /**\n * Short-hand method for {@link #parse(byte[], int)} with {@literal offset} 0.\n *\n * @param b Byte array to be parsed\n * @return A ByteTree representing the byte array.\n */\n public static ByteTree parse(byte[] b) {\n return parse(b, 0);\n }\n\n /**\n * Parse a file at a path into a ByteTree instance.\n *\n * Read a file from the given location into a ByteTree instance. In practice, depending on the\n * prefix, either Node or Leaf is constructed. This method is useful when the files are large\n * and do not fit into byte arrays.\n *\n * @param path Location of file\n * @return A ByteTree instance representing the byte array.\n * @throws IOException When the path is invalid, or the corresponding file is not valid ByteTree\n * representation.\n */\n public static ByteTree parse(Path path) throws IOException {\n File file = path.toFile();\n FileInputStream fis = new FileInputStream(file);\n DataInputStream dis = new DataInputStream(fis);\n return parse(dis);\n }\n\n /**\n * Parse value from the byte array into integer.\n *\n * @param b Byte array to be parsed.\n * @param offset Starting offset to start parsing at.\n * @return Integer representation of the byte array.\n */\n private static int parse_int(byte[] b, int offset) {\n if (b.length < offset + 4) {\n throw new IllegalArgumentException(\"Bytetree int must be in four bytes\");\n }\n return ByteBuffer.wrap(b, offset, 4).order(ByteOrder.BIG_ENDIAN).getInt();\n }\n\n private static int parse_int_fullbytes(byte[] b, int offset) {\n int len = parse_int(b, offset + 1);\n return len;\n }\n\n private static byte[] parse_from_int(int v) {\n return ByteBuffer.allocate(4).order(ByteOrder.BIG_ENDIAN).putInt(v).array();\n }\n\n private static int read_length(DataInputStream is) throws IOException {\n return is.readInt();\n }\n}\n" }, { "path": "auditor/src/main/java/ee/ivxv/audit/shuffle/DataParser.java", "content": "package ee.ivxv.audit.shuffle;\n\nimport ee.ivxv.audit.shuffle.ByteTree.Leaf;\nimport ee.ivxv.audit.shuffle.ByteTree.Node;\nimport ee.ivxv.common.math.ECGroup;\nimport ee.ivxv.common.math.ECGroupElement;\nimport ee.ivxv.common.math.Group;\nimport ee.ivxv.common.math.GroupElement;\nimport ee.ivxv.common.math.ModPGroup;\nimport ee.ivxv.common.math.ModPGroupElement;\nimport ee.ivxv.common.math.ProductGroup;\nimport ee.ivxv.common.math.ProductGroupElement;\nimport java.math.BigInteger;\nimport java.security.MessageDigest;\nimport java.security.NoSuchAlgorithmException;\nimport java.util.HexFormat;\n\n/**\n * DataParser is a utility class for performing operations with ByteTree objects.\n */\npublic class DataParser {\n /**\n * Identifier for groups of integers modulo a value.\n */\n public static final String VER_MODP = \"com.verificatum.arithm.ModPGroup\";\n /**\n * Identifier for elliptic curve groups.\n */\n public static final String VER_EC = \"com.verificatum.arithm.ECqPGroup\";\n\n /**\n * Extract Verificatum group information node from Verificatum group description.\n *

\n * Returns list [{@literal description}, {@literal groupinfo}], where {@literal decription} is a\n * string description of the group and {@literal groupinfo} is group-specific ByteTree\n * description of the group.\n * \n * @param pgroup String group description\n * @return Array of ByteTree elements representing group\n * @throws ShuffleException When unmarshalling fails.\n */\n public static ByteTree[] unmarshalGroup(String pgroup) throws ShuffleException {\n String[] split = pgroup.split(\"::\");\n if (split.length != 2) {\n throw new ShuffleException(\"Invalid pgroup description string\");\n }\n String groupdesc = split[1];\n // in some cases, the pgroup description has newline in the end. omit it\n if (groupdesc.length() % 2 == 1 && groupdesc.charAt(groupdesc.length() - 1) == '\\n') {\n groupdesc = groupdesc.substring(0, groupdesc.length() - 1);\n }\n byte[] groupdescb = HexFormat.of().parseHex(groupdesc);\n ByteTree G = ByteTree.parse(groupdescb);\n if (G.isLeaf()) {\n throw new ShuffleException(\"Invalid pgroup description bytetree\");\n }\n ByteTree.Node pginfo = (ByteTree.Node) G;\n if (pginfo.getLength() != 2) {\n throw new ShuffleException(\"Invalid marshalled pgroup description\");\n }\n return pginfo.getNodes();\n }\n\n /**\n * Extract elliptic curve generator from Verificatum elliptic curve group description leaf.\n *

\n * Returns the base point corresponding to the elliptic curve. Description leaf should be a\n * string leaf containing curve name.\n * \n * @param groupRoot ByteTree representation of elliptic curve group\n * @return Elliptic curve base point\n * @throws ShuffleException When parsing fails.\n * @throws IllegalArgumentException When unknown elliptic curve group is defined.\n */\n public static ECGroupElement parseECGroupGenerator(ByteTree groupRoot)\n throws ShuffleException, IllegalArgumentException {\n if (!groupRoot.isLeaf()) {\n throw new ShuffleException(\"Invalid Elliptic Curve Group description\");\n }\n Leaf ecgroupname = (Leaf) groupRoot;\n ECGroup parsed_group = new ECGroup(ecgroupname.getString());\n ECGroupElement generator = parsed_group.getBasePoint();\n return generator;\n }\n\n /**\n * Extract elliptic curve group from Verificatum elliptic curve group description node.\n *

\n * \n * @see #parseECGroupGenerator(ByteTree) for input node format.\n * \n * @param groupRoot ByteTree representation of elliptic curve group.\n * @return {@link ee.ivxv.common.math.ECGroup} instance representing the group.\n * @throws ShuffleException When failing to parse the node\n */\n public static ECGroup parseECGroup(ByteTree groupRoot)\n throws ShuffleException, IllegalArgumentException {\n return (ECGroup) parseECGroupGenerator(groupRoot).getGroup();\n }\n\n /**\n * Extract generator for group of integers modulo a safe prime from Verificatum group\n * description node.\n *

\n * Expect as input a node [{@literal p}, {@literal q}, {@literal g}], where p is the modulus of\n * the group, q the order of the group and g the generator of the group.\n * \n * @param groupRoot ByteTree representation of group of integers modulo a prime.\n * @return Group generator\n * @throws ShuffleException When failing to parse the node.\n */\n public static ModPGroupElement parseModPGroupGenerator(ByteTree groupRoot)\n throws ShuffleException {\n if (groupRoot.isLeaf()) {\n throw new ShuffleException(\"Invalid ModPGroup description\");\n }\n ByteTree.Node marshalled = (ByteTree.Node) groupRoot;\n if (marshalled.getLength() != 4) {\n throw new ShuffleException(\"Invalid ModPGroup description length\");\n }\n ByteTree pnode = marshalled.getNodes()[0];\n if (!pnode.isLeaf()) {\n throw new ShuffleException(\"Invalid modulus leaf\");\n }\n BigInteger p = ((Leaf) pnode).getBigInteger();\n ByteTree gnode = marshalled.getNodes()[2];\n if (!gnode.isLeaf()) {\n throw new ShuffleException(\"Invalid generator leaf\");\n }\n BigInteger g = ((Leaf) gnode).getBigInteger();\n ModPGroup parsed_group = new ModPGroup(p);\n ModPGroupElement generator = new ModPGroupElement(parsed_group, g);\n return generator;\n }\n\n /**\n * Extract group of integers modulo a prime from Verificatum group description node.\n *

\n * \n * @see #parseModPGroupGenerator(ByteTree).\n * \n * @param groupRoot ByteTree representation of group of integers modulo a prime.\n * @return {@link ee.ivxv.common.math.ModPGroup} representing a group\n * @throws ShuffleException When failing to parse the node\n */\n public static ModPGroup parseModPGroup(ByteTree groupRoot) throws ShuffleException {\n return (ModPGroup) parseModPGroupGenerator(groupRoot).getGroup();\n }\n\n /**\n * Parse group generator from Verificatum group description node.\n *

\n * \n * @see #parseModPGroupGenerator(ByteTree)\n * @see #parseECGroupGenerator(ByteTree)\n * \n * @param pgroup ByteTree representation of group.\n * @return {@link ee.ivxv.common.math.GroupElement} representing the group generator.\n * @throws ShuffleException When failing to parse the node\n */\n public static GroupElement parseGroupGenerator(String pgroup) throws ShuffleException {\n ByteTree[] nodes = unmarshalGroup(pgroup);\n if (!nodes[0].isLeaf()) {\n throw new ShuffleException(\"Invalid marshalled pgroup description string\");\n }\n Leaf descstring = (Leaf) nodes[0];\n GroupElement generator = null;\n if (descstring.getString().equals(VER_MODP)) {\n generator = parseModPGroupGenerator(nodes[1]);\n } else if (descstring.getString().equals(VER_EC)) {\n generator = parseECGroupGenerator(nodes[1]);\n } else {\n throw new ShuffleException(\"Invalid group\");\n }\n return generator;\n }\n\n /**\n * Get the ByteTree node as a group element.\n *

\n * The Verificatum element representation node bt must be a correct representation of the group\n * element. See descriptions of specific group methods for more detailed structures.\n *

\n * \n * @see #getAsElement(ECGroup, ByteTree)\n * @see #getAsElement(ModPGroup, ByteTree)\n * @see #getAsElement(ProductGroup, ByteTree)\n * \n * @param group Group where the element belongs\n * @param bt Element representation in Verificatum ByteTree format\n * @return Group element instance\n * @throws IllegalArgumentException when parsing fails\n */\n public static GroupElement getAsElement(Group group, ByteTree bt)\n throws IllegalArgumentException {\n if (group instanceof ModPGroup) {\n return getAsElement((ModPGroup) group, bt);\n } else if (group instanceof ECGroup) {\n return getAsElement((ECGroup) group, bt);\n } else if (group instanceof ProductGroup) {\n return getAsElement((ProductGroup) group, bt);\n } else {\n throw new IllegalArgumentException(\"Invalid group\");\n }\n }\n\n /**\n * Get the indexed node from the ByteTree nodes as a group element\n *

\n * Indexed version of {@link #getAsElement(Group, ByteTree)}.\n *

\n * \n * @see #getAsElement(Group, ByteTree).\n * \n * @param group Group where the element belongs\n * @param bt Elements node representation in Verificatum ByteTree format\n * @param index Element index\n * @return Group element instance\n * @throws IllegalArgumentException when parsing fails\n */\n public static GroupElement getAsElement(Group group, ByteTree bt, int index)\n throws IllegalArgumentException {\n if (bt.isLeaf()) {\n throw new IllegalArgumentException(\"Expecting node\");\n }\n Node node = (Node) bt;\n return getAsElement(group, node.getNodes()[index]);\n }\n\n /**\n * Get the ByteTree leaf as ModPGroupElement\n *

\n * We assume that the leaf is an integer. It is represented as an element in group of modulo a\n * prime.\n * \n * @param group Group where the element belongs.\n * @param bt Integer leaf\n * @return {@link ee.ivxv.common.math.ModPGroupElement} instance\n * @throws IllegalArgumentException When parsing fails\n */\n public static ModPGroupElement getAsElement(ModPGroup group, ByteTree bt)\n throws IllegalArgumentException {\n if (!bt.isLeaf()) {\n throw new IllegalArgumentException(\"Expecting leaf\");\n }\n Leaf leaf = (Leaf) bt;\n BigInteger val = leaf.getBigInteger();\n return new ModPGroupElement(group, val);\n }\n\n /**\n * Get the ByteTree node as an ECGroupElement.\n *\n * @param group Group where the element belongs\n * @param bt Node node\n * @return {@link ee.ivxv.common.math.ECGroupElement} instance\n */\n public static ECGroupElement getAsElement(ECGroup group, ByteTree bt) {\n Node point = (Node) bt;\n Leaf x = (Leaf) point.getNodes()[0];\n Leaf y = (Leaf) point.getNodes()[1];\n return new ECGroupElement(group, x.getBigInteger(), y.getBigInteger());\n }\n\n /**\n * Get the ByteTree node as an ProductGroupElement.\n *

\n * We assume that the node is an array of group element nodes. Every node is parsed as a\n * suitable group element from the product group.\n * \n * @param group Product group instance where the element belongs\n * @param bt Node representing the element\n * @return {@link ee.ivxv.common.math.ProductGroupElement} instance.\n * @throws IllegalArgumentException When parsing fails.\n */\n public static ProductGroupElement getAsElement(ProductGroup group, ByteTree bt)\n throws IllegalArgumentException {\n if (bt.isLeaf()) {\n throw new IllegalArgumentException(\"Expecting node\");\n }\n Group[] groups = ((ProductGroup) group).getGroups();\n GroupElement[] el = new GroupElement[groups.length];\n for (int i = 0; i < groups.length; i++) {\n el[i] = getAsElement(groups[i], bt, i);\n }\n return new ProductGroupElement(group, el);\n }\n\n /**\n * Get the ByteTree node as an array of group elements.\n *

\n * We assume that the node is an array of group element representations. See specific group\n * element getter methods for exact structures.\n *

\n * \n * @see #getAsElement(Group, ByteTree).\n * \n * @param group Group which the elements are part of.\n * @param bt Node which is an array of elements.\n * @return An array of {@link ee.ivxv.common.math.GroupElement} instances.\n * @throws IllegalArgumentException When parsing fails.\n */\n public static GroupElement[] getAsElementArray(Group group, ByteTree bt)\n throws IllegalArgumentException {\n if (bt.isLeaf()) {\n throw new IllegalArgumentException(\"Expecting root node\");\n }\n if (group instanceof ProductGroup) {\n // handle special case\n return getAsElementArray((ProductGroup) group, bt);\n }\n Node rootnode = (Node) bt;\n ByteTree[] nodes = rootnode.getNodes();\n GroupElement[] ret = new GroupElement[nodes.length];\n for (int i = 0; i < nodes.length; i++) {\n ret[i] = getAsElement(group, nodes[i]);\n }\n return ret;\n }\n\n /**\n * Get the ByteTree node as an array of product group elements.\n *

\n * We assume that the node is an array of group element representations. See specific group\n * element getter methods for exact structures.\n *

\n * \n * @see #getAsElement(ProductGroup, ByteTree)\n * \n * @param group Group which the elements are part of.\n * @param bt Node which is an array of elements.\n * @return An array of {@link ee.ivxv.common.math.GroupElement} instances.\n * @throws IllegalArgumentException When parsing fails.\n */\n public static GroupElement[] getAsElementArray(ProductGroup group, ByteTree bt)\n throws IllegalArgumentException {\n Node rootnode = (Node) bt;\n Group[] groups = group.getGroups();\n GroupElement[][] sub = new GroupElement[groups.length][];\n for (int i = 0; i < groups.length; i++) {\n sub[i] = getAsElementArray(groups[i], rootnode.getNodes()[i]);\n }\n GroupElement[] ret = new GroupElement[sub[0].length];\n for (int i = 0; i < ret.length; i++) {\n GroupElement[] cons = new GroupElement[groups.length];\n for (int j = 0; j < groups.length; j++) {\n cons[j] = sub[j][i];\n }\n ret[i] = new ProductGroupElement(group, cons);\n }\n return ret;\n }\n\n /**\n * Get the indexed ByteTree node as an array of group elements.\n *

\n * Indexed version of {@link #getAsElementArray(Group, ByteTree)}.\n *

\n * \n * @see #getAsElementArray(Group, ByteTree)\n * \n * @param group Group which the elements are part of.\n * @param bt Node which is an array of elements.\n * @param index Index of the node to use.\n * @return An array of {@link ee.ivxv.common.math.GroupElement} instances.\n * @throws IllegalArgumentException When parsing fails.\n */\n public static GroupElement[] getAsElementArray(Group group, ByteTree bt, int index)\n throws IllegalArgumentException {\n if (bt.isLeaf()) {\n throw new IllegalArgumentException(\"Expecting node\");\n }\n Node node = (Node) bt;\n return getAsElementArray(group, node.getNodes()[index]);\n }\n\n /**\n * Get the indexed ByteTree node as an integer.\n *

\n * The index element of the node must be an integer leaf.\n * \n * @param bt Node\n * @param index Index of the element\n * @return Integer value\n * @throws IllegalArgumentException When parsing fails.\n */\n public static BigInteger getAsInteger(ByteTree bt, int index) throws IllegalArgumentException {\n if (bt.isLeaf()) {\n throw new IllegalArgumentException(\"Root should be node\");\n }\n ByteTree[] nodes = ((Node) bt).getNodes();\n if (!nodes[index].isLeaf()) {\n throw new IllegalArgumentException(\"Should be leaf\");\n }\n Leaf leaf = (Leaf) nodes[index];\n BigInteger res = leaf.getBigInteger();\n return res;\n }\n\n /**\n * Get the indexed ByteTree node as an array of integers.\n *

\n * The index element of the node must be a node consisting of integer leafs.\n * \n * @param bt Node\n * @param index Index of the element.\n * @return Array of integer values.\n * @throws IllegalArgumentException When parsing fails.\n */\n public static BigInteger[] getAsIntegerArray(ByteTree bt, int index)\n throws IllegalArgumentException {\n if (bt.isLeaf()) {\n throw new IllegalArgumentException(\"Root should be node\");\n }\n ByteTree[] nodes = ((Node) bt).getNodes();\n if (nodes[index].isLeaf()) {\n throw new IllegalArgumentException(\"Should be node\");\n }\n ByteTree[] intnodes = ((Node) nodes[index]).getNodes();\n BigInteger[] res = new BigInteger[intnodes.length];\n for (int i = 0; i < intnodes.length; i++) {\n if (!intnodes[i].isLeaf()) {\n throw new IllegalArgumentException(\"Should be leaf\");\n }\n res[i] = ((Leaf) intnodes[i]).getBigInteger();\n }\n return res;\n }\n\n /**\n * Get the indexed ByteTree node as a group scalar.\n *

\n * Indexed version of {@link #getAsScalar(Group, ByteTree, int)}.\n *

\n *\n * @see #getAsScalar(Group, ByteTree, int)\n *\n * @param group Group where the scalar belongs.\n * @param bt Scalar node representation in Verificatum ByteTree format.\n * @param index Index of the node to use.\n * @return An array of {@link BigInteger} instances.\n * @throws IllegalArgumentException When parsing fails.\n */\n public static BigInteger[] getAsScalar(Group group, ByteTree bt, int index)\n throws IllegalArgumentException {\n if (bt.isLeaf()) {\n throw new IllegalArgumentException(\"Expecting node\");\n }\n\n if (group instanceof ProductGroup) {\n Node node = (Node) ((Node) bt).getNodes()[index];\n Group[] groups = ((ProductGroup) group).getGroups();\n BigInteger[] scalars = new BigInteger[groups.length];\n\n for (int i = 0; i < groups.length; i++) {\n Leaf leaf = (Leaf) node.getNodes()[i];\n scalars[i] = leaf.getBigInteger();\n }\n\n return scalars;\n } else {\n throw new IllegalArgumentException(\"Invalid group\");\n }\n }\n\n /**\n * Get the hash corresponding to string representation.\n *

\n * The hash name is delegated to {@link java.security.MessageDigest}.\n * \n * @param hashname Hash name.\n * @return Hash instance.\n * @throws IllegalArgumentException When can not find hash with hashname.\n */\n public static MessageDigest getHash(String hashname) throws IllegalArgumentException {\n MessageDigest md;\n try {\n md = MessageDigest.getInstance(hashname);\n\n } catch (NoSuchAlgorithmException e) {\n throw new IllegalArgumentException(\n String.format(\"Hash function %s not supported\", hashname));\n }\n return md;\n }\n\n /**\n * Convert GroupElement array to a ProductGroupElement instance.\n *

\n * Currently only ProductGroupElement instances are supported.\n * \n * @param elements\n * @return\n * @throws IllegalArgumentException When converting fails\n */\n public static ProductGroupElement toArray(GroupElement[] elements)\n throws IllegalArgumentException {\n ProductGroupElement[] casted = new ProductGroupElement[elements.length];\n for (int i = 0; i < casted.length; i++) {\n if (!(elements[i] instanceof ProductGroupElement)) {\n throw new IllegalArgumentException(\"Invalid group\");\n }\n casted[i] = (ProductGroupElement) elements[i];\n }\n return toArray(casted);\n }\n\n /**\n * Convert ProductGroupElement array to a ProductGroupElement instance.\n *

\n * \n * @see #toArray(GroupElement[]).\n * \n * @param elements\n * @return\n */\n public static ProductGroupElement toArray(ProductGroupElement[] elements) {\n ProductGroupElement r = toArray_first(elements[0], elements.length);\n for (int i = 0; i < elements.length; i++) {\n toArray_second(r, elements[i], i);\n }\n return r;\n }\n\n private static ProductGroupElement toArray_first(ProductGroupElement in, int N) {\n GroupElement[] gs = in.getElements();\n GroupElement[] ret = new GroupElement[gs.length];\n Group[] retgs = new Group[gs.length];\n for (int i = 0; i < gs.length; i++) {\n if (gs[i] instanceof ProductGroupElement) {\n ret[i] = toArray_first((ProductGroupElement) gs[i], N);\n } else {\n ret[i] = new ProductGroupElement(new ProductGroup(gs[i].getGroup(), N));\n }\n retgs[i] = ret[i].getGroup();\n }\n return new ProductGroupElement(new ProductGroup(retgs), ret);\n }\n\n private static void toArray_second(ProductGroupElement out, ProductGroupElement in, int N) {\n GroupElement[] inel = in.getElements();\n GroupElement[] outel = out.getElements();\n for (int i = 0; i < inel.length; i++) {\n if (inel[i] instanceof ProductGroupElement) {\n toArray_second((ProductGroupElement) outel[i], (ProductGroupElement) inel[i], N);\n } else {\n ((ProductGroupElement) outel[i]).getElements()[N] = inel[i];\n }\n }\n }\n}\n" }, { "path": "auditor/src/main/java/ee/ivxv/audit/shuffle/PRNG.java", "content": "package ee.ivxv.audit.shuffle;\n\nimport ee.ivxv.common.util.Util;\nimport java.security.MessageDigest;\n\n/**\n * Class PRNG implements pseudo-random number generator as defined in Verificatum independent\n * verifier implementation description.\n */\npublic class PRNG {\n private MessageDigest cleanhash;\n private byte[] buf;\n private int it;\n private int bufp;\n private int digestLen;\n\n /**\n * Initialize PRNG using a hash function and a seed.\n * \n * @param hashname Defined hash function.\n * @param seed Seed to initialize PRNG with.\n */\n PRNG(String hashname, byte[] seed) {\n this.cleanhash = init_hash(hashname, seed);\n this.digestLen = cleanhash.getDigestLength();\n this.buf = new byte[digestLen];\n this.it = 0;\n this.bufp = digestLen;\n }\n\n /**\n * Fill the output buffer with bytes from the PRNG.\n * \n * @param out Output buffer to fill.\n */\n public void read(byte[] out) {\n int read = 0;\n int to_read;\n int len = out.length;\n while (read < len) {\n refill();\n to_read = Math.min(len - read, digestLen - bufp);\n System.arraycopy(buf, bufp, out, read, to_read);\n bufp = bufp + to_read;\n read += to_read;\n }\n }\n\n private void refill() {\n if (bufp < digestLen) {\n return;\n }\n MessageDigest h;\n try {\n h = (MessageDigest) cleanhash.clone();\n } catch (CloneNotSupportedException e) {\n // already checked\n return;\n }\n buf = h.digest(Util.toBytes(it));\n bufp = 0;\n it += 1;\n }\n\n static MessageDigest init_hash(String hashname, byte[] seed) {\n MessageDigest md = DataParser.getHash(hashname);\n try {\n md.clone();\n } catch (CloneNotSupportedException e) {\n throw new IllegalArgumentException(\n String.format(\"Hash function %s support is incomplete\", hashname));\n }\n if (seed != null) {\n md.update(seed);\n }\n return md;\n }\n\n}\n" }, { "path": "auditor/src/main/java/ee/ivxv/audit/shuffle/ProtocolInformation.java", "content": "package ee.ivxv.audit.shuffle;\n\nimport ee.ivxv.common.math.Group;\nimport ee.ivxv.common.math.GroupElement;\nimport java.io.IOException;\nimport java.nio.file.Path;\nimport javax.xml.parsers.DocumentBuilder;\nimport javax.xml.parsers.DocumentBuilderFactory;\nimport javax.xml.parsers.ParserConfigurationException;\nimport org.w3c.dom.Document;\nimport org.w3c.dom.Element;\nimport org.w3c.dom.Node;\nimport org.w3c.dom.NodeList;\nimport org.xml.sax.SAXException;\n\n/**\n * ProtocolInformation represents Verificatum protocol information file.\n */\npublic class ProtocolInformation {\n private String version, sid, name, pgroup, prg, rohash, auxsid, type;\n private int statdist, width, ebitlenro, vbitlenro, keywidth;\n private Group pgroup_parsed;\n private GroupElement generator_parsed;\n\n private static final String default_auxsid = \"default\";\n private static final String default_type = \"shuffling\";\n private static final int default_keywidth = 5;\n\n /**\n * Initialize ProtocolInformation from required values.\n * \n * @param version\n * @param sid\n * @param name\n * @param pgroup\n * @param keywidth\n * @param vbitlenro\n * @param ebitlenro\n * @param prg\n * @param rohash\n * @param width\n * @param statdist\n */\n public ProtocolInformation(String version, String sid, String name, String pgroup, int keywidth,\n int vbitlenro, int ebitlenro, String prg, String rohash, int width, int statdist) {\n this.version = version;\n this.sid = sid;\n this.name = name;\n this.pgroup = pgroup;\n this.keywidth = keywidth;\n this.vbitlenro = vbitlenro;\n this.ebitlenro = ebitlenro;\n this.prg = prg;\n this.rohash = rohash;\n this.width = width;\n this.statdist = statdist;\n this.auxsid = default_auxsid;\n this.type = default_type;\n }\n\n /**\n * Initialize the ProtocolInformation from a file.\n * \n * @param protinfo Protocol information file\n * @throws ShuffleException When parsing fails\n */\n public ProtocolInformation(Path protinfo) throws ShuffleException {\n DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance();\n DocumentBuilder db;\n Document dom;\n try {\n db = dbf.newDocumentBuilder();\n } catch (ParserConfigurationException e) {\n // there should be a default parser\n throw new RuntimeException(\"XML parser not configured\", e);\n }\n try {\n dom = db.parse(protinfo.toFile());\n } catch (SAXException e) {\n throw new IllegalArgumentException(\"Invalid Protocol Information file\", e);\n } catch (IOException e) {\n throw new IllegalArgumentException(\"Error while reading Protocol Information file\", e);\n }\n Element root = dom.getDocumentElement();\n root.normalize();\n if (!root.getNodeName().equals(\"protocol\")) {\n throw new IllegalArgumentException(\"Root node must be 'protocol'\");\n }\n if (root.getNodeType() != Node.ELEMENT_NODE) {\n throw new IllegalArgumentException(\"Protocol node must be an element node\");\n }\n Element rootel = (Element) root;\n this.version = get_element(rootel, \"version\");\n this.sid = get_element(rootel, \"sid\");\n this.name = get_element(rootel, \"name\");\n this.pgroup = get_element(rootel, \"pgroup\");\n this.generator_parsed = DataParser.parseGroupGenerator(this.pgroup);\n this.pgroup_parsed = this.generator_parsed.getGroup();\n this.keywidth = Integer.parseInt(get_element(rootel, \"keywidth\"));\n if (this.keywidth != default_keywidth) {\n throw new IllegalArgumentException(\"Invalid keywidth\");\n }\n this.vbitlenro = Integer.parseInt(get_element(rootel, \"vbitlenro\"));\n this.ebitlenro = Integer.parseInt(get_element(rootel, \"ebitlenro\"));\n this.prg = get_element(rootel, \"prg\");\n this.rohash = get_element(rootel, \"rohash\");\n this.width = Integer.parseInt(get_element(rootel, \"width\"));\n this.statdist = Integer.parseInt(get_element(rootel, \"statdist\"));\n this.auxsid = default_auxsid;\n this.type = default_type;\n String corr = get_element(rootel, \"corr\");\n if (!corr.equals(\"noninteractive\")) {\n throw new IllegalArgumentException(\"Only non-interactive protocol is supported\");\n }\n }\n\n private static String get_element(Element node, String name) {\n NodeList els = node.getElementsByTagName(name);\n String val = null;\n if (els.getLength() < 1) {\n throw new IllegalArgumentException(String.format(\"Element '%s' missing\", name));\n }\n if (els.getLength() > 1) {\n for (int i = 0; i < els.getLength(); i++) {\n if (els.item(i).getParentNode().equals(node)) {\n val = els.item(i).getTextContent();\n }\n }\n if (val == null) {\n throw new IllegalArgumentException(String.format(\"Element '%s' not found\", name));\n }\n } else {\n val = els.item(0).getTextContent();\n }\n return val;\n }\n\n public String get_version() {\n return version;\n }\n\n public String get_sid() {\n return sid;\n }\n\n public String get_auxsid() {\n return auxsid;\n }\n\n public String get_name() {\n return name;\n }\n\n public String get_pgroup() {\n return pgroup;\n }\n\n public Group get_parsed_pgroup() {\n return pgroup_parsed;\n }\n\n public GroupElement get_parsed_generator() {\n return generator_parsed;\n }\n\n public int get_keywidth() {\n return keywidth;\n }\n\n public int get_vbitlenro() {\n return vbitlenro;\n }\n\n public int get_ebitlenro() {\n return ebitlenro;\n }\n\n public String get_prg() {\n return prg;\n }\n\n public String get_rohash() {\n return rohash;\n }\n\n public int get_width() {\n return width;\n }\n\n public int get_statdist() {\n return statdist;\n }\n\n public String get_type() {\n return type;\n }\n}\n" }, { "path": "auditor/src/main/java/ee/ivxv/audit/shuffle/RO.java", "content": "package ee.ivxv.audit.shuffle;\n\nimport ee.ivxv.common.util.Util;\nimport java.io.IOException;\nimport java.io.OutputStream;\nimport java.security.MessageDigest;\n\n/**\n * Implements Random Oracle as defined in Verificatum manual for implementing independent verifier.\n */\npublic class RO extends OutputStream {\n private String hashname;\n private MessageDigest hash;\n private byte[] seed;\n private int amount;\n\n /**\n * Initialize RO using a hashname and a seed.\n * \n * @param hashname Hash function to use.\n * @param seed Seed bytes.\n */\n public RO(String hashname, byte[] seed) {\n this.hashname = hashname;\n this.flush();\n this.seed = seed.clone();\n }\n\n /**\n * Initialize RO instance using hashname.\n * \n * In this mode, the user has to provide the amount to be read and the seed to seed this\n * instance separately.\n * \n * @param hashname Hash function to use.\n */\n public RO(String hashname) {\n this.hashname = hashname;\n this.flush();\n }\n\n /**\n * Reset the RO instance\n * \n */\n public void flush() {\n this.hash = PRNG.init_hash(hashname, null);\n this.amount = 0;\n }\n\n /**\n * Set the expected amount to be read.\n * \n * As the amount is written to the digest instance, then it must be set before updating the RO\n * instance.\n * \n * @param amount\n */\n public void setAmount(int amount) {\n this.amount = amount;\n hash.update(Util.toBytes(amount));\n }\n\n\n\n private void readOut(byte[] out) {\n if ((this.amount + 7) / 8 != out.length) {\n throw new IllegalArgumentException(\n \"Output buffer length does not correspond to requested read amount\");\n }\n PRNG p = new PRNG(hashname, hash.digest());\n p.read(out);\n if (amount % 8 != 0) {\n out[0] &= (1 << (amount % 8)) - 1;\n }\n }\n\n /**\n * Fill the output buffer with bytes from the RO.\n * \n * If the amount field is 0, then it is assumed that it has been set by a call to\n * {@link #setAmount(int)}. If the seed was given during the initialization, then it is added to\n * the input.\n * \n * @param out Output buffer to fill.\n * @param amount Number of bits to fill\n */\n public void read(byte[] out, int amount) {\n if (this.amount == 0) {\n setAmount(amount);\n }\n if (this.seed != null) {\n try {\n write(seed);\n } catch (IOException e) {\n // checked exception\n }\n }\n readOut(out);\n }\n\n /**\n * Update the RO with some input.\n * \n * The expected amount to be read must be set.\n * \n * @param b The data\n * @throws IOException When amount to be read is not set.\n */\n @Override\n public void write(int b) throws IOException {\n write(new byte[] {(byte) b});\n }\n\n /**\n * Update the RO with some input.\n * \n * The expected amount to be read must be set.\n * \n * @param b The data\n * @param off Offset of the data\n * @param len Length of the data\n * @throws IOException when amount to be read is not set.\n */\n @Override\n public void write(byte[] b, int off, int len) throws IOException {\n if (amount == 0) {\n throw new IllegalArgumentException(\"Amount not set\");\n }\n hash.update(b, off, len);\n }\n\n /**\n * Update the RO with some input.\n * \n * The expected amount to be read must be set.\n * \n * @param in A byte array to seed into the RO instance.\n * @throws IOException when amount to be read is not set.\n */\n @Override\n public void write(byte[] b) throws IOException {\n write(b, 0, b.length);\n }\n}\n" }, { "path": "auditor/src/main/java/ee/ivxv/audit/shuffle/ShuffleConsole.java", "content": "package ee.ivxv.audit.shuffle;\n\nimport ee.ivxv.audit.Msg;\nimport ee.ivxv.common.service.console.Progress;\nimport ee.ivxv.common.service.i18n.Translatable;\nimport ee.ivxv.common.util.I18nConsole;\nimport java.util.ArrayList;\nimport java.util.List;\nimport java.util.concurrent.atomic.AtomicInteger;\n\npublic class ShuffleConsole {\n private final I18nConsole console;\n\n public ShuffleConsole(I18nConsole console) {\n this.console = console;\n }\n\n public void enter(ShuffleStep step) {\n int totalSteps = step.parent != null ? step.parent.subSteps.size() : 0;\n int thisStep = step.parent != null ? step.parent.nextSubStep() : 0;\n String stepstr = \"\";\n if (totalSteps > 0) {\n stepstr = String.format(\"(%d/%d): \", thisStep, totalSteps);\n }\n if (step.i18msg != null) {\n console.println(Msg.m_shuffle_step, step.getDepth(), stepstr, step.i18msg);\n } else if (step.msg != null) {\n console.println(Msg.m_shuffle_step, step.getDepth(), stepstr, step.msg);\n } else {\n console.println(Msg.m_shuffle_step, step.getDepth(), stepstr, \"\");\n }\n }\n\n public Progress enter(ShuffleStep step, long length) {\n enter(step);\n return console.startProgress(length, true);\n }\n\n public static enum ShuffleStep {\n READ(Msg.m_shuffle_read), //\n READ_PROT_INFO(READ, Msg.m_shuffle_read_prot_info), //\n READ_PUBKEY(READ, Msg.m_shuffle_read_pubkey), //\n READ_PC(READ, Msg.m_shuffle_read_pc), READ_POSC(READ, Msg.m_shuffle_read_posc), //\n READ_POSR(READ, Msg.m_shuffle_read_posr), //\n READ_CIPHS(READ, Msg.m_shuffle_read_ciphs), //\n READ_SHUFFLED(READ, Msg.m_shuffle_read_shuffled),\n\n VERIFY(Msg.m_shuffle_verify), //\n VERIFY_PARAMS(VERIFY, Msg.m_shuffle_verify_params), //\n VERIFY_NI(VERIFY, Msg.m_shuffle_verify_ni), //\n VERIFY_PERM(VERIFY, Msg.m_shuffle_verify_permutation), //\n VERIFY_RERAND(VERIFY, Msg.m_shuffle_verify_rerandomisation);\n\n final String msg;\n final Translatable i18msg;\n final ShuffleStep parent;\n final List subSteps = new ArrayList();\n final AtomicInteger completed = new AtomicInteger();\n\n ShuffleStep(Translatable msg) {\n this.msg = null;\n this.i18msg = msg;\n this.parent = null;\n }\n\n ShuffleStep(String msg) {\n this.msg = msg;\n this.i18msg = null;\n this.parent = null;\n }\n\n ShuffleStep(ShuffleStep parent, Translatable msg) {\n this.msg = null;\n this.i18msg = msg;\n this.parent = parent;\n parent.appendSubStep(this);\n }\n\n int getDepth() {\n int i = 0;\n ShuffleStep next = this.parent;\n while (next != null) {\n next = next.parent;\n i++;\n }\n return i;\n }\n\n void appendSubStep(ShuffleStep substep) {\n subSteps.add(substep);\n }\n\n int subStepCount() {\n return subSteps.size();\n }\n\n int nextSubStep() {\n return this.completed.incrementAndGet();\n }\n }\n}\n" }, { "path": "auditor/src/main/java/ee/ivxv/audit/shuffle/ShuffleException.java", "content": "package ee.ivxv.audit.shuffle;\n\n@SuppressWarnings(\"serial\")\npublic class ShuffleException extends Exception {\n public ShuffleException(Throwable t) {\n super(t);\n }\n\n public ShuffleException(String msg) {\n super(msg);\n }\n\n public ShuffleException(String msg, Throwable t) {\n super(msg, t);\n }\n}\n" }, { "path": "auditor/src/main/java/ee/ivxv/audit/shuffle/ShuffleParameters.java", "content": "package ee.ivxv.audit.shuffle;\n\nimport java.io.IOException;\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport java.nio.file.Paths;\nimport java.util.List;\n\npublic class ShuffleParameters {\n private String version, auxsid, type;\n int width;\n\n /**\n * Initialize the shuffle parameters from values.\n * \n * @param version\n * @param auxsid\n * @param width\n * @param type\n */\n ShuffleParameters(String version, String auxsid, int width, String type) {\n this.version = version;\n this.auxsid = auxsid;\n this.width = width;\n this.type = type;\n }\n\n /**\n * Initialize ShuffleParameters using a proof directory path. The corresponding files are\n * assumed to be at their default locations (stored by Verificatum).\n * \n * @param proofdir Proof directory\n * @throws IOException If reading parameter file fails\n */\n ShuffleParameters(Path proofdir) throws IOException {\n Path versionpath = Paths.get(proofdir.toString(), \"version\");\n Path auxsidpath = Paths.get(proofdir.toString(), \"auxsid\");\n Path widthpath = Paths.get(proofdir.toString(), \"width\");\n Path typepath = Paths.get(proofdir.toString(), \"type\");\n this.version = read_parameters(versionpath);\n this.auxsid = read_parameters(auxsidpath);\n this.width = Integer.parseInt(read_parameters(widthpath));\n this.type = read_parameters(typepath);\n\n }\n\n private static String read_parameters(Path loc) throws IOException {\n List l = Files.readAllLines(loc);\n if (l.size() != 1) {\n throw new IllegalArgumentException(\"Parameters file must have single line\");\n }\n return l.get(0);\n }\n\n public String get_version() {\n return version;\n }\n\n public String get_auxsid() {\n return auxsid;\n }\n\n public int get_width() {\n return width;\n }\n\n public String get_type() {\n return type;\n }\n}\n" }, { "path": "auditor/src/main/java/ee/ivxv/audit/shuffle/ShuffleProof.java", "content": "package ee.ivxv.audit.shuffle;\n\nimport ee.ivxv.audit.shuffle.ShuffleConsole.ShuffleStep;\nimport ee.ivxv.common.crypto.elgamal.ElGamalCiphertext;\nimport ee.ivxv.common.crypto.elgamal.ElGamalPublicKey;\nimport ee.ivxv.common.math.Group;\nimport ee.ivxv.common.math.GroupElement;\nimport ee.ivxv.common.math.ProductGroup;\nimport ee.ivxv.common.math.ProductGroupElement;\nimport java.io.IOException;\nimport java.math.BigInteger;\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport java.nio.file.Paths;\n\n/**\n * Class for holding variables for non-interactive shuffle proof.\n */\npublic class ShuffleProof {\n private final ProtocolInformation prot;\n private final PermutationCommitment pc;\n private final PoSCommitment posc;\n private final PoSReply posr;\n private final GroupElement[] ciphs, shuffled;\n private final GroupElement pk;\n\n /**\n * Default filename of ciphertexts in Verificatum shuffle proof.\n */\n public static final String CIPHERTEXTS_PATH = \"Ciphertexts.bt\";\n /**\n * Default filename of shuffled ciphertexts in Verificatum shuffle proof.\n */\n public static final String SHUFFLED_CIPHERTEXTS_PATH = \"ShuffledCiphertexts.bt\";\n /**\n * Default filename of public key in Verificatum shuffle proof.\n */\n public static final String PUBLICKEY_PATH = \"FullPublicKey.bt\";\n /**\n * Default directory name for proofs in Verificatum shuffle proof.\n */\n public static final String PROOFS_PATH = \"proofs\";\n /**\n * Default filename of permutation commitment in Verificatum shuffle proof.\n */\n public static final String PC_PATH = \"PermutationCommitment01.bt\";\n /**\n * Default filename of shuffle commitment in Verificatum shuffle proof.\n */\n public static final String POSC_PATH = \"PoSCommitment01.bt\";\n /**\n * Default filename of shuffle proof reply in Verificatum shuffle proof.\n */\n public static final String POSR_PATH = \"PoSReply01.bt\";\n\n /**\n * Initialize the proof from components. Ciphertexts, shuffled ciphertexts and public key are\n * represented as corresponding group elements.\n * \n * @param prot\n * @param pc\n * @param posc\n * @param posr\n * @param ciphs\n * @param shuffled\n * @param pk\n */\n public ShuffleProof(ProtocolInformation prot, PermutationCommitment pc, PoSCommitment posc,\n PoSReply posr, GroupElement[] ciphs, GroupElement[] shuffled, GroupElement pk) {\n this.prot = prot;\n this.pc = pc;\n this.posc = posc;\n this.posr = posr;\n this.ciphs = ciphs;\n this.shuffled = shuffled;\n this.pk = pk;\n }\n\n /**\n * Initialize the proof from components.\n * \n * @param prot\n * @param pc\n * @param posc\n * @param posr\n * @param ciphs\n * @param shuffled\n * @param pk\n */\n public ShuffleProof(ProtocolInformation prot, PermutationCommitment pc, PoSCommitment posc,\n PoSReply posr, ElGamalCiphertext[] ciphs, ElGamalCiphertext[] shuffled,\n ElGamalPublicKey pk) {\n if (ciphs.length != shuffled.length) {\n throw new IllegalArgumentException(\"Ciphertext and shuffled length does not match\");\n }\n GroupElement[] cge = new GroupElement[ciphs.length];\n GroupElement[] scge = new GroupElement[shuffled.length];\n for (int i = 0; i < ciphs.length; i++) {\n cge[i] = ciphs[i].getAsProductGroupElement();\n scge[i] = shuffled[i].getAsProductGroupElement();\n }\n this.prot = prot;\n this.pc = pc;\n this.posc = posc;\n this.posr = posr;\n this.ciphs = cge;\n this.shuffled = scge;\n this.pk = pk.getAsProductGroupElement();\n }\n\n /**\n * Initialize the proof from protocol information path and proof directory path.\n *

\n * Parses the files and constructs the components.\n * \n * @param protpath\n * @param proofdir\n * @throws IOException\n * @throws ShuffleException\n */\n public ShuffleProof(Path protpath, Path proofdir, ShuffleConsole console) throws IOException, ShuffleException {\n console.enter(ShuffleStep.READ);\n console.enter(ShuffleStep.READ_PROT_INFO);\n prot = new ProtocolInformation(protpath);\n\n console.enter(ShuffleStep.READ_PC);\n Path pcpath = Paths.get(proofdir.toString(), PROOFS_PATH, PC_PATH);\n pc = new PermutationCommitment(prot, pcpath);\n\n console.enter(ShuffleStep.READ_POSC);\n Path poscpath = Paths.get(proofdir.toString(), PROOFS_PATH, POSC_PATH);\n posc = new PoSCommitment(prot, poscpath);\n\n console.enter(ShuffleStep.READ_POSR);\n Path posrpath = Paths.get(proofdir.toString(), PROOFS_PATH, POSR_PATH);\n posr = new PoSReply(prot, posrpath);\n\n console.enter(ShuffleStep.READ_PUBKEY);\n Path pkpath = Paths.get(proofdir.toString(), PUBLICKEY_PATH);\n ByteTree pkbt = ByteTree.parse(pkpath);\n Group group = prot.get_parsed_pgroup();\n Group ciphgroup = get_ciphertext_group(prot, group);\n pk = DataParser.getAsElement(ciphgroup, pkbt);\n\n console.enter(ShuffleStep.READ_CIPHS);\n Path ciphspath = Paths.get(proofdir.toString(), CIPHERTEXTS_PATH);\n ByteTree ctsbt = ByteTree.parse(ciphspath);\n ciphs = DataParser.getAsElementArray(ciphgroup, ctsbt);\n\n console.enter(ShuffleStep.READ_SHUFFLED);\n Path shuffledpath = Paths.get(proofdir.toString(), SHUFFLED_CIPHERTEXTS_PATH);\n ByteTree sctsbt = ByteTree.parse(shuffledpath);\n shuffled = DataParser.getAsElementArray(ciphgroup, sctsbt);\n }\n\n public ProtocolInformation get_ProtocolInformation() {\n return prot;\n }\n\n public PermutationCommitment get_PermutationCommitment() {\n return pc;\n }\n\n public PoSCommitment get_PoSCommitment() {\n return posc;\n }\n\n public PoSReply get_PoSReply() {\n return posr;\n }\n\n public GroupElement[] get_ciphertexts() {\n return ciphs;\n }\n\n public GroupElement[] get_shuffled_ciphertexts() {\n return shuffled;\n }\n\n public GroupElement get_publickey() {\n return pk;\n }\n\n private static ProductGroup get_ciphertext_group(ProtocolInformation prot, Group group) {\n ProductGroup prodgroup = new ProductGroup(group, prot.get_keywidth());\n ProductGroup ciphgroup = new ProductGroup(prodgroup, 2);\n return ciphgroup;\n }\n\n /**\n * Permutation commitment holder.\n */\n public static class PermutationCommitment {\n private final GroupElement[] u;\n\n /**\n * Parse permutation commitment from a bytetree.\n * \n * @param bt\n */\n PermutationCommitment(ProtocolInformation prot, byte[] bt) {\n ByteTree root = ByteTree.parse(bt);\n this.u = DataParser.getAsElementArray(prot.get_parsed_pgroup(), root);\n }\n\n /**\n * Initialize the permutation commitment from protocol information and permutation\n * commitment path.\n * \n * @param prot\n * @param path\n * @throws IOException\n */\n PermutationCommitment(ProtocolInformation prot, Path path) throws IOException {\n this(prot, Files.readAllBytes(path));\n }\n\n public GroupElement[] get_u() {\n return u;\n }\n }\n\n /**\n * Proof of shuffle commitment holder.\n */\n public static class PoSCommitment {\n private GroupElement A_prim, C_prim, D_prim;\n private GroupElement[] B, B_prim;\n private ProductGroupElement F_prim;\n\n /**\n * Parse proof of shuffle commitment from bytetree.\n * \n * @param bt Byte array holding proof of shuffle commitment.\n */\n PoSCommitment(ProtocolInformation prot, byte[] bt) {\n ByteTree root = ByteTree.parse(bt);\n Group group = prot.get_parsed_pgroup();\n ProductGroup ciphgroup = get_ciphertext_group(prot, group);\n B = DataParser.getAsElementArray(group, root, 0);\n A_prim = DataParser.getAsElement(group, root, 1);\n B_prim = DataParser.getAsElementArray(group, root, 2);\n C_prim = DataParser.getAsElement(group, root, 3);\n D_prim = DataParser.getAsElement(group, root, 4);\n F_prim = (ProductGroupElement) DataParser.getAsElement(ciphgroup, root, 5);\n }\n\n /**\n * Initialize the shuffle commitment from protocol information and shuffle commitment path.\n * \n * @param prot\n * @param path\n * @throws IOException\n */\n PoSCommitment(ProtocolInformation prot, Path path) throws IOException {\n this(prot, Files.readAllBytes(path));\n }\n\n public GroupElement get_A_prim() {\n return A_prim;\n }\n\n public GroupElement get_C_prim() {\n return C_prim;\n }\n\n public GroupElement get_D_prim() {\n return D_prim;\n }\n\n public GroupElement[] get_B() {\n return B;\n }\n\n public GroupElement[] get_B_prim() {\n return B_prim;\n }\n\n public ProductGroupElement get_F_prim() {\n return F_prim;\n }\n }\n\n /**\n * Holder for proof of shuffle reply.\n */\n public static class PoSReply {\n private BigInteger kA, kC, kD;\n private BigInteger[] kB, kE;\n private BigInteger[] kF;\n\n /**\n * Parse proof of shuffle reply from bytetree.\n * \n * @param bt Byte array holding proof of shuffle in bytetree format.\n */\n PoSReply(ProtocolInformation prot, byte[] bt) {\n ByteTree root = ByteTree.parse(bt);\n Group group = prot.get_parsed_pgroup();\n ProductGroup prodgroup = new ProductGroup(group, prot.get_keywidth());\n kA = DataParser.getAsInteger(root, 0);\n kB = DataParser.getAsIntegerArray(root, 1);\n kC = DataParser.getAsInteger(root, 2);\n kD = DataParser.getAsInteger(root, 3);\n kE = DataParser.getAsIntegerArray(root, 4);\n kF = DataParser.getAsScalar(prodgroup, root, 5);\n }\n\n /**\n * Initialize the proof reply from protocol information and path to proof reply.\n * \n * @param prot\n * @param path\n * @throws IOException\n */\n PoSReply(ProtocolInformation prot, Path path) throws IOException {\n this(prot, Files.readAllBytes(path));\n }\n\n public BigInteger get_kA() {\n return kA;\n }\n\n public BigInteger get_kC() {\n return kC;\n }\n\n public BigInteger get_kD() {\n return kD;\n }\n\n public BigInteger[] get_kB() {\n return kB;\n }\n\n public BigInteger[] get_kE() {\n return kE;\n }\n\n public BigInteger[] get_kF() {\n return kF;\n }\n }\n}\n" }, { "path": "auditor/src/main/java/ee/ivxv/audit/shuffle/ThreadedVerifier.java", "content": "package ee.ivxv.audit.shuffle;\n\nimport ee.ivxv.audit.shuffle.ShuffleConsole.ShuffleStep;\nimport ee.ivxv.common.math.GroupElement;\nimport ee.ivxv.common.math.MathException;\nimport ee.ivxv.common.math.ModPGroupElement;\nimport ee.ivxv.common.math.ProductGroup;\nimport ee.ivxv.common.math.ProductGroupElement;\nimport ee.ivxv.common.service.console.Progress;\nimport java.math.BigInteger;\nimport java.util.ArrayList;\nimport java.util.List;\nimport java.util.concurrent.Callable;\nimport java.util.concurrent.ExecutionException;\nimport java.util.concurrent.ExecutorService;\nimport java.util.concurrent.Executors;\nimport java.util.concurrent.Future;\nimport java.util.concurrent.FutureTask;\nimport org.slf4j.Logger;\nimport org.slf4j.LoggerFactory;\n\npublic class ThreadedVerifier extends Verifier {\n static final Logger log = LoggerFactory.getLogger(ThreadedVerifier.class);\n\n private int nothreads;\n private ExecutorService executor;\n\n public ThreadedVerifier(ShuffleConsole console, ShuffleProof proof, int nothreads) {\n super(console, proof);\n this.nothreads = nothreads;\n this.executor = Executors.newFixedThreadPool(nothreads);\n }\n\n public GroupElement compute_A_threaded(Progress progress, BigInteger[] e)\n throws MathException, InterruptedException, ExecutionException {\n return compute_A(progress, get_proof().get_PermutationCommitment().get_u(), e, nothreads,\n executor);\n }\n\n public GroupElement compute_F_threaded(Progress progress, BigInteger[] e)\n throws MathException, InterruptedException, ExecutionException {\n return compute_F(progress, get_proof().get_ciphertexts(), e, nothreads, executor);\n }\n\n public boolean verify_A_threaded(Progress progress, BigInteger v, GroupElement A,\n GroupElement[] h) throws MathException, InterruptedException, ExecutionException {\n return verify_A(progress, v, A, get_proof().get_PoSCommitment().get_A_prim(),\n get_proof().get_ProtocolInformation().get_parsed_generator(), h,\n get_proof().get_PoSReply().get_kA(), get_proof().get_PoSReply().get_kE(), nothreads,\n executor);\n }\n\n public boolean verify_B_threaded(Progress progress, BigInteger v, GroupElement[] h)\n throws MathException, InterruptedException, ExecutionException {\n return verify_B(progress, v, get_proof().get_PoSCommitment().get_B(),\n get_proof().get_PoSCommitment().get_B_prim(),\n get_proof().get_ProtocolInformation().get_parsed_generator(),\n get_proof().get_PoSReply().get_kB(), get_proof().get_PoSReply().get_kE(), h,\n nothreads, executor);\n }\n\n public boolean verify_F_threaded(Progress progress, BigInteger v, GroupElement F)\n throws MathException, InterruptedException, ExecutionException {\n return verify_F(progress, v, F, get_proof().get_PoSCommitment().get_F_prim(),\n get_proof().get_publickey(), get_proof().get_PoSReply().get_kE(),\n get_proof().get_PoSReply().get_kF(), get_proof().get_shuffled_ciphertexts(),\n nothreads, executor);\n }\n\n public boolean verify_all() throws ShuffleException, MathException {\n console.enter(ShuffleStep.VERIFY);\n console.enter(ShuffleStep.VERIFY_PARAMS);\n byte[] rho = compute_rho();\n GroupElement[] h = compute_h(rho);\n console.enter(ShuffleStep.VERIFY_NI);\n byte[] s = compute_RO_seed(rho, h);\n BigInteger[] e = compute_e(s);\n BigInteger v = compute_v(rho, s);\n\n int N = get_proof().get_ciphertexts().length;\n Progress progress = console.enter(ShuffleStep.VERIFY_PERM, 5 * N + 10 + 3 * nothreads);\n GroupElement A;\n try {\n A = compute_A_threaded(progress, e);\n } catch (InterruptedException | ExecutionException ex) {\n executor.shutdown();\n throw new ShuffleException(ex);\n }\n GroupElement C = compute_C(progress, h);\n GroupElement D = compute_D(progress, h, e);\n try {\n if (!verify_A_threaded(progress, v, A, h)) {\n throw new ShuffleException(\"A failed\");\n }\n } catch (InterruptedException | ExecutionException ex) {\n executor.shutdown();\n throw new ShuffleException(ex);\n }\n try {\n if (!verify_B_threaded(progress, v, h)) {\n throw new ShuffleException(\"B failed\");\n }\n } catch (InterruptedException | ExecutionException ex) {\n executor.shutdown();\n throw new ShuffleException(ex);\n }\n if (!verify_C(progress, v, C)) {\n throw new ShuffleException(\"C failed\");\n }\n if (!verify_D(progress, v, D)) {\n throw new ShuffleException(\"D failed\");\n }\n progress.finish();\n progress = console.enter(ShuffleStep.VERIFY_RERAND, 2 * N\n + get_proof().get_PoSReply().get_kF().length + 3 + 2 * nothreads);\n GroupElement F;\n try {\n F = compute_F_threaded(progress, e);\n } catch (InterruptedException | ExecutionException ex) {\n executor.shutdown();\n throw new ShuffleException(ex);\n }\n try {\n if (!verify_F_threaded(progress, v, F)) {\n throw new ShuffleException(\"F failed\");\n }\n } catch (InterruptedException | ExecutionException ex) {\n executor.shutdown();\n throw new ShuffleException(ex);\n }\n executor.shutdown();\n progress.finish();\n return true;\n }\n\n private GroupElement compute_A(Progress progress, GroupElement[] u, BigInteger[] e,\n int nothreads, ExecutorService executor)\n throws MathException, InterruptedException, ExecutionException {\n // the number of computations differ in threaded and non-threaded case. In threaded case we\n // also aggregate the per-thread results.\n List> futures = new ArrayList<>();\n for (int i = 0; i < nothreads; i++) {\n FutureTask ft =\n new FutureTask<>(get_compute_A_worker(progress, u, e, i, nothreads));\n executor.submit(ft);\n futures.add(ft);\n }\n log.debug(\"Started all compute A workers\");\n GroupElement res = u[0].getGroup().getIdentity();\n log.debug(\"Collecting compute A worker results\");\n for (Future ft : futures) {\n res = res.op(ft.get());\n progress.increase(1);\n }\n log.debug(\"Collected all compute A worker results\");\n return res;\n }\n\n private static Callable get_compute_A_worker(Progress progress, GroupElement[] u,\n BigInteger[] e, int threadid, int nothreads) {\n return () -> {\n log.debug(\"Compute A worker [{}/{}] started\", threadid, nothreads);\n GroupElement res = u[0].getGroup().getIdentity();\n for (int i = 0; i < u.length; i++) {\n if (i % nothreads != threadid)\n continue;\n GroupElement exped = u[i].scale(e[i]);\n res = res.op(exped);\n progress.increase(1);\n }\n log.debug(\"Compute A worker [{}/{}] finished\", threadid, nothreads);\n return res;\n };\n }\n\n public GroupElement compute_F(Progress progress, GroupElement[] w, BigInteger[] e,\n int nothreads, ExecutorService executor)\n throws MathException, InterruptedException, ExecutionException {\n // the number of computations differ in threaded and non-threaded case. In threaded case we\n // also aggregate the per-thread results.\n List> futures = new ArrayList<>();\n for (int i = 0; i < nothreads; i++) {\n FutureTask ft =\n new FutureTask<>(get_compute_F_worker(progress, w, e, i, nothreads));\n executor.submit(ft);\n futures.add(ft);\n }\n log.debug(\"Started all compute F workers\");\n GroupElement res = w[0].getGroup().getIdentity();\n log.debug(\"Collecting compute F worker results\");\n for (Future ft : futures) {\n res = res.op(ft.get());\n progress.increase(1);\n }\n log.debug(\"Collected all compute F worker results\");\n return res;\n }\n\n private static Callable get_compute_F_worker(Progress progress, GroupElement[] w,\n BigInteger[] e, int threadid, int nothreads) throws MathException {\n return () -> {\n log.debug(\"Compute F [{}/{}] worker started\", threadid, nothreads);\n GroupElement res = w[0].getGroup().getIdentity();\n for (int i = 0; i < w.length; i++) {\n if (i % nothreads != threadid)\n continue;\n GroupElement exped = w[i].scale(e[i]);\n res = res.op(exped);\n progress.increase(1);\n }\n log.debug(\"Compute F worker [{}/{}] finished\", threadid, nothreads);\n return res;\n };\n }\n\n private boolean verify_A(Progress progress, BigInteger v, GroupElement A, GroupElement A_prim,\n GroupElement g, GroupElement[] h, BigInteger k_A, BigInteger[] k_E, int nothreads,\n ExecutorService executor)\n throws MathException, InterruptedException, ExecutionException {\n // the number of computations differ in threaded and non-threaded case. In threaded case we\n // also aggregate the per-thread results.\n List> futures = new ArrayList<>();\n for (int i = 0; i < nothreads; i++) {\n FutureTask ft =\n new FutureTask<>(get_verify_A_worker(progress, h, k_E, i, nothreads));\n executor.submit(ft);\n futures.add(ft);\n }\n log.debug(\"Started verify A workers\");\n GroupElement left = A.scale(v).op(A_prim);\n progress.increase(1);\n GroupElement right = h[0].getGroup().getIdentity();\n log.debug(\"Collecting verify A worker results\");\n for (Future ft : futures) {\n right = right.op(ft.get());\n progress.increase(1);\n log.debug(\"Collected verify A worker result\");\n }\n log.debug(\"Collected all verify A worker results\");\n right = right.op(g.scale(k_A));\n progress.increase(1);\n return left.equals(right);\n }\n\n private static Callable get_verify_A_worker(Progress progress, GroupElement[] h,\n BigInteger[] k_E, int threadid, int nothreads) throws MathException {\n return () -> {\n log.debug(\"Verify A worker [{}/{}] started\", threadid, nothreads);\n GroupElement right = h[0].getGroup().getIdentity();\n for (int i = 0; i < h.length; i++) {\n if (i % nothreads != threadid)\n continue;\n right = right.op(h[i].scale(k_E[i]));\n progress.increase(1);\n }\n log.debug(\"Verify A worker [{}/{}] finished\", threadid, nothreads);\n return right;\n };\n }\n\n private boolean verify_B(Progress progress, BigInteger v, GroupElement[] B,\n GroupElement[] B_prim, GroupElement g, BigInteger[] k_B, BigInteger[] k_E,\n GroupElement[] h, int nothreads, ExecutorService executor)\n throws MathException, InterruptedException, ExecutionException {\n // the number of computations is different in threaded and non-threaded case. In threaded\n // case the thread which sees invalid proof stops and this is propagated to the controlling\n // thread. In non-threaded case, all values are computed and then checked one-by-one.\n GroupElement left = B[0].scale(v).op(B_prim[0]);\n GroupElement right = h[0].scale(k_E[0]).op(g.scale(k_B[0]));\n if (!left.equals(right)) {\n return false;\n }\n log.debug(\"Verified first B value\");\n List> futures = new ArrayList<>();\n for (int i = 0; i < nothreads; i++) {\n FutureTask ft = new FutureTask<>(\n get_verify_B_worker(progress, v, B, B_prim, g, k_B, k_E, h, i, nothreads));\n executor.submit(ft);\n futures.add(ft);\n }\n log.debug(\"Started verify B workers\");\n log.debug(\"Collecting verify B worker results\");\n for (Future ft : futures) {\n if (!ft.get()) {\n return false;\n }\n progress.increase(1);\n log.debug(\"Collected verify B worker result\");\n }\n log.debug(\"Collected all verify B worker results\");\n return true;\n }\n\n private static Callable get_verify_B_worker(Progress progress, BigInteger v,\n GroupElement[] B, GroupElement[] B_prim, GroupElement g, BigInteger[] k_B,\n BigInteger[] k_E, GroupElement[] h, int threadid, int nothreads) {\n return () -> {\n log.debug(\"Verify B worker [{}/{}] started\", threadid, nothreads);\n GroupElement left, right;\n for (int i = 1; i < B.length; i++) {\n if (i % nothreads != threadid)\n continue;\n left = B[i].scale(v).op(B_prim[i]);\n right = B[i - 1].scale(k_E[i]);\n right = right.op(g.scale(k_B[i]));\n progress.increase(1);\n if (!left.equals(right)) {\n log.debug(\"Verify B worker [{}/{}] finished early\", threadid, nothreads);\n return false;\n }\n }\n log.debug(\"Verify B worker [{}/{}] finished\", threadid, nothreads);\n return true;\n };\n }\n\n private boolean verify_F(Progress progress, BigInteger v, GroupElement F, GroupElement F_prim,\n GroupElement pk, BigInteger[] k_E, BigInteger[] k_F, GroupElement[] w_prim,\n int nothreads, ExecutorService executor)\n throws MathException, InterruptedException, ExecutionException {\n // the number of computations differ in threaded and non-threaded case. In threaded case we\n // also aggregate the per-thread results.\n List> futures = new ArrayList<>();\n for (int i = 0; i < nothreads; i++) {\n FutureTask ft =\n new FutureTask<>(get_verify_F_worker(progress, k_E, w_prim, i, nothreads));\n executor.submit(ft);\n futures.add(ft);\n }\n log.debug(\"Started verify F workers\");\n BigInteger[] factors = new BigInteger[k_F.length];\n for (int i = 0; i < factors.length; i++) {\n factors[i] = k_F[i].negate();\n progress.increase(1);\n }\n GroupElement left = F.scale(v).op(F_prim);\n GroupElement right = w_prim[0].getGroup().getIdentity();\n log.debug(\"Collecting verify F worker results\");\n for (Future ft : futures) {\n right = right.op(ft.get());\n progress.increase(1);\n log.debug(\"Collected verify F worker result\");\n }\n log.debug(\"Collected all verify F worker results\");\n ProductGroupElement pkl = (ProductGroupElement) ((ProductGroupElement) pk).getElements()[0];\n ProductGroupElement pkr = (ProductGroupElement) ((ProductGroupElement) pk).getElements()[1];\n ProductGroupElement tmpl = pkl.scale(factors);\n progress.increase(1);\n ProductGroupElement tmpr = pkr.scale(factors);\n progress.increase(1);\n ProductGroupElement tmp = new ProductGroupElement((ProductGroup) pk.getGroup(), tmpl, tmpr);\n right = right.op(tmp);\n progress.increase(1);\n return left.equals(right);\n }\n\n private static Callable get_verify_F_worker(Progress progress, BigInteger[] k_E,\n GroupElement[] w_prim, int threadid, int nothreads) {\n return () -> {\n log.debug(\"Verify F worker [{}/{}] started\", threadid, nothreads);\n GroupElement right = w_prim[0].getGroup().getIdentity();\n for (int i = 0; i < w_prim.length; i++) {\n if (i % nothreads != threadid)\n continue;\n right = right.op(w_prim[i].scale(k_E[i]));\n progress.increase(1);\n }\n log.debug(\"Verify F worker [{}/{}] finished\", threadid, nothreads);\n return right;\n };\n }\n}\n" }, { "path": "auditor/src/main/java/ee/ivxv/audit/shuffle/Verifier.java", "content": "package ee.ivxv.audit.shuffle;\n\nimport ee.ivxv.audit.shuffle.ByteTree.Leaf;\nimport ee.ivxv.audit.shuffle.ByteTree.Node;\nimport ee.ivxv.audit.shuffle.ShuffleConsole.ShuffleStep;\nimport ee.ivxv.common.math.*;\nimport ee.ivxv.common.service.console.Progress;\nimport ee.ivxv.common.util.Util;\n\nimport java.io.IOException;\nimport java.math.BigInteger;\nimport java.util.function.Supplier;\n\n/**\n * Verificatum proof of a shuffle verifier.\n *

\n * See the Verificatum manual for implementing independent verifier for the explanation of the\n * variables used in the verifier.\n */\npublic class Verifier {\n\n protected final ShuffleProof proof;\n protected final ShuffleConsole console;\n\n /**\n * Initialize the verifier using proof of a shuffle.\n * \n * @param proof\n */\n public Verifier(ShuffleProof proof) {\n this.console = null;\n this.proof = proof;\n }\n\n public Verifier(ShuffleConsole console, ShuffleProof proof) {\n this.console = console;\n this.proof = proof;\n }\n\n public ShuffleProof get_proof() {\n return proof;\n }\n\n /**\n * See:\n * globalPrefix\n *\n * @return\n */\n public byte[] compute_rho() {\n ProtocolInformation p = proof.get_ProtocolInformation();\n\n String fullsid = String.format(\"%s.%s\", p.get_sid(), p.get_auxsid());\n\n Node n = new Node(new ByteTree[]{\n new Leaf(p.get_version()),\n new Leaf(fullsid),\n new Leaf(Util.toBytes(p.get_statdist())),\n new Leaf(Util.toBytes(p.get_vbitlenro())),\n new Leaf(Util.toBytes(p.get_ebitlenro())),\n new Leaf(p.get_prg()),\n new Leaf(p.get_pgroup()),\n new Leaf(p.get_rohash())\n });\n\n return DataParser.getHash(p.get_rohash()).digest(n.getEncoded());\n }\n\n /**\n * See:\n * prgSeed\n *\n * @param rho\n * @param h\n * @return\n */\n public byte[] compute_RO_seed(byte[] rho, GroupElement[] h) {\n ProductGroupElement publickey = (ProductGroupElement) get_proof().get_publickey();\n\n ProtocolInformation p = proof.get_ProtocolInformation();\n GroupElement generator = get_proof().get_ProtocolInformation().get_parsed_generator();\n String pgroup = p.get_pgroup();\n\n ByteTree[] nodes;\n ByteTree generatorNode;\n\n if (pgroup.contains(\"ECqPGroup\")) {\n generatorNode = new Node((ECGroupElement) generator);\n } else {\n generatorNode = new Leaf(generator);\n }\n\n nodes = new ByteTree[]{\n generatorNode,\n new Node(h),\n new Node(get_proof().get_PermutationCommitment().get_u()),\n new Node(publickey),\n new Node(DataParser.toArray(get_proof().get_ciphertexts()).getElements()),\n new Node(DataParser.toArray(get_proof().get_shuffled_ciphertexts()).getElements())\n };\n\n Node node = new Node(nodes);\n RO ro = new RO(get_proof().get_ProtocolInformation().get_rohash());\n byte[] out = new byte[DataParser.getHash(get_proof().get_ProtocolInformation().get_prg()).getDigestLength()];\n ro.setAmount(out.length * 8);\n\n try {\n ro.write(rho);\n node.writeEncoded(ro);\n } catch (IOException e) {\n // checked\n }\n\n ro.read(out, out.length * 8);\n return out;\n }\n\n /**\n * See:\n * e\n *\n * @param s\n * @return\n */\n public BigInteger[] compute_e(byte[] s) {\n PRNG gen = new PRNG(get_proof().get_ProtocolInformation().get_prg(), s);\n int n_e = get_proof().get_ProtocolInformation().get_ebitlenro();\n int N = get_proof().get_ciphertexts().length;\n BigInteger[] scalars = new BigInteger[N];\n BigInteger mask = BigInteger.ONE.shiftLeft(n_e);\n\n for (int i = 0; i < N; i++) {\n byte[] ti = new byte[(n_e + 7) / 8];\n gen.read(ti);\n scalars[i] = new BigInteger(1, ti).mod(mask);\n }\n return scalars;\n }\n\n /**\n * For ECGroup see:\n * ec\n * For ModpGroup see:\n * modp\n *\n * @param rho\n * @return\n */\n public GroupElement[] compute_h(byte[] rho) {\n Group G_q = get_proof().get_ProtocolInformation().get_parsed_pgroup();\n BigInteger p = get_proof().get_ProtocolInformation().get_parsed_pgroup().getOrder();\n int n_r = get_proof().get_ProtocolInformation().get_statdist();\n int n_p = p.bitLength();\n int N = get_proof().get_ciphertexts().length;\n String prg = get_proof().get_ProtocolInformation().get_prg();\n String rohash = get_proof().get_ProtocolInformation().get_rohash();\n\n Leaf l = new Leaf(\"generators\");\n\n byte[] seed = new byte[rho.length + l.getEncodedLength()];\n\n System.arraycopy(rho, 0, seed, 0, rho.length);\n System.arraycopy(l.getEncoded(), 0, seed, rho.length, l.getEncodedLength());\n\n @SuppressWarnings(\"resource\")\n RO ro = new RO(rohash, seed);\n\n byte[] out = new byte[DataParser.getHash(prg).getDigestLength()];\n ro.read(out, out.length * 8);\n PRNG gen = new PRNG(prg, out);\n\n GroupElement[] elements = new GroupElement[N];\n BigInteger mask = BigInteger.ONE.shiftLeft(n_p + n_r);\n\n if (G_q instanceof ECGroup) {\n // Each dprg.get() invocation produces new byte array\n Supplier dprg = () -> {\n byte[] rand = new byte[(n_p + n_r + 7) / 8];\n gen.read(rand);\n return new BigInteger(1, rand).mod(mask).toByteArray();\n };\n\n elements = new ECGroup().pseudoRandomElements(N, dprg);\n } else {\n BigInteger TWO = BigInteger.valueOf(2);\n for (int i = 0; i < N; i++) {\n byte[] rand = new byte[(n_p + n_r + 7) / 8];\n gen.read(rand);\n BigInteger value = new BigInteger(1, rand).mod(mask).modPow(TWO, p);\n elements[i] = new ModPGroupElement((ModPGroup) G_q, value);\n }\n }\n\n return elements;\n }\n\n /**\n * See:\n * v\n *\n * @param rho\n * @param s\n * @return\n */\n public BigInteger compute_v(byte[] rho, byte[] s) {\n GroupElement A_prim = get_proof().get_PoSCommitment().get_A_prim();\n GroupElement C_prim = get_proof().get_PoSCommitment().get_C_prim();\n GroupElement D_prim = get_proof().get_PoSCommitment().get_D_prim();\n int n_v = get_proof().get_ProtocolInformation().get_vbitlenro();\n\n ByteTree aPrim, cPrim, dPrim;\n\n if (get_proof().get_ProtocolInformation().get_pgroup().contains(\"ECqPGroup\")) {\n aPrim = new Node((ECGroupElement) A_prim);\n cPrim = new Node((ECGroupElement) C_prim);\n dPrim = new Node((ECGroupElement) D_prim);\n\n } else {\n aPrim = new Leaf(A_prim);\n cPrim = new Leaf(C_prim);\n dPrim = new Leaf(D_prim);\n }\n\n ByteTree[] nodes = new ByteTree[]{\n new Node(get_proof().get_PoSCommitment().get_B()),\n aPrim,\n new Node(get_proof().get_PoSCommitment().get_B_prim()),\n cPrim,\n dPrim,\n new Node(get_proof().get_PoSCommitment().get_F_prim())\n };\n\n Node n = new Node(new ByteTree[]{new Leaf(s), new Node(nodes)});\n\n byte[] seed = new byte[rho.length + n.getEncodedLength()];\n System.arraycopy(rho, 0, seed, 0, rho.length);\n System.arraycopy(n.getEncoded(), 0, seed, rho.length, n.getEncodedLength());\n @SuppressWarnings(\"resource\")\n RO ro = new RO(get_proof().get_ProtocolInformation().get_rohash(), seed);\n byte[] out = new byte[(n_v + 7) / 8];\n ro.read(out, n_v);\n return new BigInteger(1, out);\n }\n\n /**\n * See:\n * A\n *\n * @param progress\n * @param e\n * @return\n * @throws MathException\n */\n public GroupElement compute_A(Progress progress, BigInteger[] e) throws MathException {\n GroupElement[] u = get_proof().get_PermutationCommitment().get_u();\n GroupElement res = u[0].getGroup().getIdentity();\n for (int i = 0; i < u.length; i++) {\n res = res.op(u[i].scale(e[i]));\n progress.increase(1);\n }\n return res;\n }\n\n /**\n * See:\n * C\n *\n * @param progress\n * @param h\n * @return\n * @throws MathException\n * @throws ShuffleException\n */\n public GroupElement compute_C(Progress progress, GroupElement[] h)\n throws MathException, ShuffleException {\n GroupElement[] u = get_proof().get_PermutationCommitment().get_u();\n\n if (u.length != h.length) {\n throw new ShuffleException(\"u and h length does not match\");\n }\n\n GroupElement up = u[0].getGroup().getIdentity();\n GroupElement hp = h[0].getGroup().getIdentity();\n\n for (int i = 0; i < u.length; i++) {\n up = u[i].op(up);\n hp = h[i].op(hp);\n progress.increase(1);\n }\n\n GroupElement hpi = hp.inverse();\n GroupElement res = up.op(hpi);\n\n progress.increase(2);\n return res;\n }\n\n /**\n * See:\n * D\n *\n * @param progress\n * @param h\n * @param e\n * @return\n * @throws ShuffleException\n * @throws MathException\n */\n public GroupElement compute_D(Progress progress, GroupElement[] h, BigInteger[] e)\n throws ShuffleException, MathException {\n BigInteger ep = BigInteger.ONE;\n BigInteger q;\n int N = get_proof().get_ciphertexts().length;\n\n if (h[0] instanceof ModPGroupElement) {\n ModPGroup group = (ModPGroup) h[0].getGroup();\n q = MathUtil.safePrimeOrder(group.getOrder());\n } else if (h[0] instanceof ECGroupElement) {\n q = h[0].getGroup().getOrder();\n } else {\n throw new ShuffleException(\"Unknown element type: \" + h[0].getClass().getSimpleName());\n }\n\n for (BigInteger bigInteger : e) {\n ep = ep.multiply(bigInteger).mod(q);\n progress.increase(1);\n }\n\n GroupElement hp = h[0].scale(ep);\n hp = hp.inverse();\n GroupElement ret = get_proof().get_PoSCommitment().get_B()[N - 1].op(hp);\n\n progress.increase(3);\n return ret;\n }\n\n /**\n * See:\n * F\n *\n * @param progress\n * @param e\n * @return\n * @throws MathException\n */\n public GroupElement compute_F(Progress progress, BigInteger[] e) throws MathException {\n GroupElement[] w = get_proof().get_ciphertexts();\n GroupElement res = w[0].getGroup().getIdentity();\n\n for (int i = 0; i < w.length; i++) {\n GroupElement exped = w[i].scale(e[i]);\n res = res.op(exped);\n progress.increase(1);\n }\n\n return res;\n }\n\n /**\n * See:\n * verdictA\n *\n * @param progress\n * @param v\n * @param A\n * @param h\n * @param e\n * @return\n * @throws MathException\n */\n public boolean verify_A(Progress progress, BigInteger v, GroupElement A, GroupElement[] h)\n throws MathException {\n GroupElement left = A.scale(v).op(get_proof().get_PoSCommitment().get_A_prim());\n progress.increase(1);\n GroupElement right = h[0].getGroup().getIdentity();\n\n for (int i = 0; i < h.length; i++) {\n right = right.op(h[i].scale(get_proof().get_PoSReply().get_kE()[i]));\n progress.increase(1);\n }\n\n right = get_proof().get_ProtocolInformation().get_parsed_generator()\n .scale(get_proof().get_PoSReply().get_kA())\n .op(right);\n\n progress.increase(1);\n return left.equals(right);\n }\n\n /**\n * See:\n * verdictB\n *\n * @param progress\n * @param v\n * @param h\n * @return\n * @throws MathException\n */\n public boolean verify_B(Progress progress, BigInteger v, GroupElement[] h)\n throws MathException {\n GroupElement[] B = get_proof().get_PoSCommitment().get_B();\n GroupElement[] Bp = get_proof().get_PoSCommitment().get_B_prim();\n BigInteger[] kB = get_proof().get_PoSReply().get_kB();\n BigInteger[] kE = get_proof().get_PoSReply().get_kE();\n GroupElement g = get_proof().get_ProtocolInformation().get_parsed_generator();\n\n for (int i = 1; i < B.length; i++) {\n GroupElement left = B[i].scale(v).op(Bp[i]);\n GroupElement right = B[i - 1].scale(kE[i]).op(g.scale(kB[i]));\n if (!left.equals(right)) {\n return false;\n }\n progress.increase(1);\n }\n\n return true;\n }\n\n /**\n * See:\n * verdictC\n *\n * @param progress\n * @param v\n * @param C\n * @return\n * @throws MathException\n */\n public boolean verify_C(Progress progress, BigInteger v, GroupElement C) throws MathException {\n GroupElement left = C.scale(v).op(get_proof().get_PoSCommitment().get_C_prim());\n progress.increase(1);\n\n GroupElement right = get_proof().get_ProtocolInformation().get_parsed_generator()\n .scale(get_proof().get_PoSReply().get_kC());\n progress.increase(1);\n\n return left.equals(right);\n }\n\n /**\n * See:\n * verdictD\n *\n * @param progress\n * @param v\n * @param D\n * @return\n * @throws MathException\n */\n public boolean verify_D(Progress progress, BigInteger v, GroupElement D) throws MathException {\n GroupElement left = D.scale(v).op(get_proof().get_PoSCommitment().get_D_prim());\n progress.increase(1);\n\n GroupElement right = get_proof().get_ProtocolInformation().get_parsed_generator()\n .scale(get_proof().get_PoSReply().get_kD());\n progress.increase(1);\n\n return left.equals(right);\n }\n\n /**\n * See:\n * verdictF\n *\n * @param progress\n * @param v\n * @param F\n * @return\n * @throws MathException\n */\n public boolean verify_F(Progress progress, BigInteger v, GroupElement F) throws MathException {\n // the number of computations differ in threaded and non-threaded case. In threaded case we\n // also aggregate the per-thread results.\n GroupElement pk = get_proof().get_publickey();\n BigInteger[] kF = get_proof().get_PoSReply().get_kF();\n GroupElement[] wp = get_proof().get_shuffled_ciphertexts();\n BigInteger[] kE = get_proof().get_PoSReply().get_kE();\n GroupElement Fp = get_proof().get_PoSCommitment().get_F_prim();\n\n GroupElement left = F.scale(v).op(Fp);\n GroupElement right = wp[0].getGroup().getIdentity();\n\n for (int i = 0; i < wp.length; i++) {\n right = right.op(wp[i].scale(kE[i]));\n progress.increase(1);\n }\n\n BigInteger[] factors = new BigInteger[kF.length];\n for (int i = 0; i < factors.length; i++) {\n factors[i] = kF[i].negate();\n progress.increase(1);\n\n }\n\n ProductGroupElement pkl = (ProductGroupElement) ((ProductGroupElement) pk).getElements()[0];\n ProductGroupElement pkr = (ProductGroupElement) ((ProductGroupElement) pk).getElements()[1];\n ProductGroupElement tmpl = pkl.scale(factors);\n progress.increase(1);\n ProductGroupElement tmpr = pkr.scale(factors);\n progress.increase(1);\n ProductGroupElement tmp = new ProductGroupElement((ProductGroup) pk.getGroup(), tmpl, tmpr);\n right = right.op(tmp);\n\n progress.increase(1);\n return left.equals(right);\n }\n\n /**\n * Verify the correctness of the shuffle.\n *

\n * Throws an exception specifying the reason for failed verification.\n * \n * @return Boolean True if the proof verifies. If not, then an exception is thrown.\n * @throws ShuffleException If the verification fails, denoting a reason.\n * @throws MathException If computation fails.\n */\n public boolean verify_all() throws ShuffleException, MathException {\n console.enter(ShuffleStep.VERIFY);\n console.enter(ShuffleStep.VERIFY_PARAMS);\n byte[] rho = compute_rho();\n GroupElement[] h = compute_h(rho);\n console.enter(ShuffleStep.VERIFY_NI);\n byte[] s = compute_RO_seed(rho, h);\n BigInteger[] e = compute_e(s);\n BigInteger v = compute_v(rho, s);\n\n int N = get_proof().get_ciphertexts().length;\n Progress progress = console.enter(ShuffleStep.VERIFY_PERM, 5 * N + 11);\n GroupElement A = compute_A(progress, e);\n GroupElement C = compute_C(progress, h);\n GroupElement D = compute_D(progress, h, e);\n if (!verify_A(progress, v, A, h)) {\n throw new ShuffleException(\"A failed\");\n }\n if (!verify_B(progress, v, h)) {\n throw new ShuffleException(\"B failed\");\n }\n if (!verify_C(progress, v, C)) {\n throw new ShuffleException(\"C failed\");\n }\n if (!verify_D(progress, v, D)) {\n throw new ShuffleException(\"D failed\");\n }\n progress.finish();\n progress = console.enter(ShuffleStep.VERIFY_RERAND,\n 2 * N + get_proof().get_PoSReply().get_kF().length + 3);\n GroupElement F = compute_F(progress, e);\n if (!verify_F(progress, v, F)) {\n throw new ShuffleException(\"F failed\");\n }\n progress.finish();\n return true;\n }\n\n /**\n * Verify the correctness of the shuffle.\n *

\n * If {@literal throwexception} is false, then now exceptions are thrown during computation and\n * verification.\n * \n * @param throwexception Boolean in\n * @return Boolean indicating the correctness of the shuffle.\n */\n public boolean verify_all(boolean throwexception) {\n try {\n return verify_all();\n } catch (ShuffleException | MathException e) {\n if (!throwexception) {\n return false;\n }\n }\n return true;\n }\n}\n" }, { "path": "auditor/src/main/java/ee/ivxv/audit/tools/ConvertTool.java", "content": "package ee.ivxv.audit.tools;\n\nimport ee.ivxv.audit.AuditContext;\nimport ee.ivxv.audit.Msg;\nimport ee.ivxv.audit.shuffle.DataParser;\nimport ee.ivxv.audit.shuffle.ShuffleConsole;\nimport ee.ivxv.audit.shuffle.ShuffleProof;\nimport ee.ivxv.audit.tools.ConvertTool.ConvertArgs;\nimport ee.ivxv.common.cli.Arg;\nimport ee.ivxv.common.cli.Args;\nimport ee.ivxv.common.cli.Tool;\nimport ee.ivxv.common.crypto.Plaintext;\nimport ee.ivxv.common.crypto.elgamal.ElGamalCiphertext;\nimport ee.ivxv.common.crypto.elgamal.ElGamalPublicKey;\nimport ee.ivxv.common.math.Group;\nimport ee.ivxv.common.math.GroupElement;\nimport ee.ivxv.common.math.MathException;\nimport ee.ivxv.common.math.ProductGroup;\nimport ee.ivxv.common.math.ProductGroupElement;\nimport ee.ivxv.common.model.AnonymousBallotBox;\nimport ee.ivxv.common.util.I18nConsole;\nimport ee.ivxv.common.util.Json;\nimport java.nio.file.Path;\nimport java.util.ArrayList;\nimport java.util.Arrays;\nimport java.util.LinkedHashMap;\nimport java.util.List;\nimport java.util.Map;\nimport org.slf4j.Logger;\nimport org.slf4j.LoggerFactory;\nimport org.slf4j.helpers.NOPLogger;\n\n/**\n * ConvertTool verifies the correctness of file format conversions.\n */\npublic class ConvertTool implements Tool.Runner {\n public static class ConvertArgs extends Args {\n Arg inputBbox = Arg.aPath(Msg.arg_input_bb);\n Arg outputBbox = Arg.aPath(Msg.arg_output_bb);\n Arg pubPath = Arg.aPath(Msg.arg_pub);\n Arg protPath = Arg.aPath(Msg.arg_protinfo, true, false);\n Arg proofPath = Arg.aPath(Msg.arg_proofdir, true, true);\n\n public ConvertArgs() {\n super();\n args.add(inputBbox);\n args.add(outputBbox);\n args.add(pubPath);\n args.add(protPath);\n args.add(proofPath);\n }\n }\n\n // we use static NOP logger to be able to run tests without logging\n // the logger is patched in non-test context\n private static Logger log = NOPLogger.NOP_LOGGER;\n private I18nConsole console;\n\n public ConvertTool(AuditContext ctx) {\n this.console = new I18nConsole(ctx.i.console, ctx.i.i18n);\n // patch the static logger. It is a single-instance class, so there are not any race\n // conditions.\n ConvertTool.log = LoggerFactory.getLogger(ConvertTool.class);\n }\n\n @Override\n public boolean run(ConvertArgs args) throws Exception {\n boolean ret = true;\n log.debug(\"Reading shuffle proof\");\n ShuffleConsole sc = new ShuffleConsole(this.console);\n ShuffleProof proof = new ShuffleProof(args.protPath.value(), args.proofPath.value(), sc);\n log.debug(\"Reading pre-shuffle ballot box\");\n AnonymousBallotBox bb = Json.read(args.inputBbox.value(), AnonymousBallotBox.class);\n log.debug(\"Reading post-shuffle ballot box\");\n AnonymousBallotBox sbb = Json.read(args.outputBbox.value(), AnonymousBallotBox.class);\n log.debug(\"Reading public key\");\n ElGamalPublicKey pk = new ElGamalPublicKey(args.pubPath.value());\n if (!verifyPublickey(pk, proof)) {\n console.println(Msg.m_convert_publickey_failed);\n ret = false;\n } else {\n console.println(Msg.m_convert_publickey_succ);\n }\n if (!verifyBallotboxToBytetree(pk, bb, proof)) {\n console.println(Msg.m_convert_bb_to_bt_failed);\n ret = false;\n } else {\n console.println(Msg.m_convert_bb_to_bt_succ);\n }\n if (!verifyBytetreeToBallotbox(pk, proof, sbb)) {\n console.println(Msg.m_convert_bt_to_bb_failed);\n ret = false;\n } else {\n console.println(Msg.m_convert_bt_to_bb_succ);\n }\n return ret;\n }\n\n public static boolean verifyPublickey(ElGamalPublicKey pk, ShuffleProof proof) {\n log.debug(\"Verifying public key correct converting\");\n log.debug(\"Getting shuffle proof public key\");\n GroupElement btpk = proof.get_publickey();\n log.debug(\"Converting public key to bytetree format\");\n GroupElement gppk = convertPublickeyToBytetree(pk);\n boolean res = btpk.equals(gppk);\n log.debug(\"Shuffle proof public key == converted public key: {}\", res);\n return res;\n }\n\n public static boolean verifyBallotboxToBytetree(ElGamalPublicKey pk, AnonymousBallotBox bb,\n ShuffleProof proof) {\n log.debug(\"Verifying ballot box to bytetree converting\");\n log.debug(\"Getting shuffle ciphertext list\");\n GroupElement[] proofciphs = proof.get_ciphertexts();\n log.debug(\"Converting ballot box to byte tree format\");\n GroupElement[] bbciphs;\n try {\n bbciphs = convertBallotboxToBytetree(pk, bb);\n } catch (IllegalArgumentException e) {\n log.debug(\"Converting ballot box to bytetree cipherexts failed: {}\", e);\n return false;\n }\n if (bbciphs.length != proofciphs.length) {\n log.debug(\"Ballot box and shuffle ciphertext list size differ\");\n return false;\n }\n for (int i = 0; i < bbciphs.length; i++) {\n if (!bbciphs[i].equals(proofciphs[i])) {\n log.debug(\"Ballot box element and shuffle ciphertext item '{}' differ\", i);\n return false;\n }\n }\n log.debug(\"Shuffle proof ciphertexts == ballot box: true\");\n return true;\n }\n\n public static boolean verifyBytetreeToBallotbox(ElGamalPublicKey pk, ShuffleProof proof,\n AnonymousBallotBox bb) {\n log.debug(\"Verifying bytetree to ballot box converting\");\n log.debug(\"Converting shuffle ciphertext list to ballot box\");\n AnonymousBallotBox proofbb;\n try {\n proofbb = convertBytetreeToBallotbox(pk, proof.get_shuffled_ciphertexts());\n } catch (IllegalArgumentException e) {\n log.debug(\"Converting bytetree to ballot box failed: {}\", e);\n return false;\n }\n if (!bb.getElection().equals(proofbb.getElection())) {\n log.debug(\"Converted ballot box and ballot box election identifier differ. \"\n + \"Expected '{}', got '{}'\", bb.getElection(), proofbb.getElection());\n return false;\n }\n Map>>> proofd = proofbb.getDistricts();\n Map>>> bbd = bb.getDistricts();\n if (!proofd.keySet().equals(bbd.keySet())) {\n log.debug(\"Converted ballot box and ballot box district identifier set differ\");\n return false;\n }\n for (String d : proofd.keySet()) {\n Map>> proofs = proofd.get(d);\n Map>> bbs = bbd.get(d);\n if (!proofs.keySet().equals(bbs.keySet())) {\n log.debug(\"Converted ballot box and ballot box station identifier set differ \"\n + \"for district '{}'\", d);\n return false;\n }\n for (String s : proofs.keySet()) {\n Map> proofq = proofs.get(s);\n Map> bbq = bbs.get(s);\n if (!proofq.keySet().equals(bbq.keySet())) {\n log.debug(\"Converted ballot box and ballot box question identifier set differ \"\n + \"for district '{}' and station '{}'\", d, s);\n return false;\n }\n for (String q : proofq.keySet()) {\n List proofc = proofq.get(q);\n List bbc = bbq.get(q);\n if (proofc.size() != bbc.size()) {\n log.debug(\n \"Converted ballot box and ballot box ciphertext list differ \"\n + \"for district '{}', station '{}' and question '{}'\",\n d, s, q);\n return false;\n }\n for (int i = 0; i < proofc.size(); i++) {\n if (!Arrays.equals(proofc.get(i), bbc.get(i))) {\n log.debug(\"Converted ballot box and ballot box ciphertext differ for \"\n + \"district '{}', station '{}', question '{}' and \"\n + \"index '{}'\", d, s, q, i);\n return false;\n }\n }\n }\n }\n }\n return true;\n }\n\n private static GroupElement[] convertBallotboxToBytetree(ElGamalPublicKey pk,\n AnonymousBallotBox bb) throws IllegalArgumentException {\n List res = new ArrayList();\n ProductGroupElement ege = convertStringToProductGroupElement(pk, bb.getElection());\n bb.getDistricts().forEach((d, smap) -> {\n ProductGroupElement dge = convertStringToProductGroupElement(pk, d);\n smap.forEach((s, qmap) -> {\n ProductGroupElement sge = convertStringToProductGroupElement(pk, s);\n qmap.forEach((q, clist) -> {\n ProductGroupElement qge = convertStringToProductGroupElement(pk, q);\n clist.forEach(c -> {\n ElGamalCiphertext ct = new ElGamalCiphertext(pk.getParameters(), c);\n ProductGroupElement cge = ct.getAsProductGroupElement();\n ProductGroupElement multict = DataParser\n .toArray(new ProductGroupElement[] {ege, dge, sge, qge, cge});\n res.add(multict);\n });\n });\n });\n });\n return res.toArray(new ProductGroupElement[0]);\n }\n\n private static ProductGroupElement convertStringToProductGroupElement(ElGamalPublicKey pk,\n String msg) throws IllegalArgumentException {\n Group G = pk.getParameters().getGroup();\n Plaintext padded = G.pad(new Plaintext(msg));\n GroupElement ge;\n try {\n ge = G.encode(padded);\n } catch (MathException e) {\n throw new IllegalArgumentException(\"Encoding failed\", e);\n }\n ProductGroup pG = new ProductGroup(G, 2);\n ProductGroupElement pge = new ProductGroupElement(pG, G.getIdentity(), ge);\n return pge;\n }\n\n private static AnonymousBallotBox convertBytetreeToBallotbox(ElGamalPublicKey pk,\n GroupElement[] cts) throws IllegalArgumentException {\n Map>>> res =\n new LinkedHashMap>>>();\n String election = null;\n for (int i = 0; i < cts.length; i++) {\n if (!(cts[i] instanceof ProductGroupElement)) {\n throw new IllegalArgumentException(\n String.format(\"Ciphertext %d not ProductGroupElement\", i));\n }\n ProductGroupElement multict = (ProductGroupElement) cts[i];\n if (multict.getElements().length != 2) {\n throw new IllegalArgumentException(String.format(\"Ciphertext %d length not 2\", i));\n }\n if (!(multict.getElements()[0] instanceof ProductGroupElement)) {\n throw new IllegalArgumentException(\n String.format(\"Ciphertext %d left side not PGE\", i));\n }\n if (((ProductGroupElement) multict.getElements()[0]).getElements().length != 5) {\n throw new IllegalArgumentException(\n String.format(\"Ciphertext %d left side length not 5\", i));\n }\n if (!(multict.getElements()[1] instanceof ProductGroupElement)) {\n throw new IllegalArgumentException(\n String.format(\"Ciphertext %d right side not PGE\", i));\n }\n if (((ProductGroupElement) multict.getElements()[1]).getElements().length != 5) {\n throw new IllegalArgumentException(\n String.format(\"Ciphertext %d right side length not 5\", i));\n }\n String thiselection = convertProductGroupElementToString(pk, multict, 0);\n if (election == null) {\n election = thiselection;\n }\n if (!election.equals(thiselection)) {\n throw new IllegalArgumentException(String\n .format(\"Ciphertext %d election differs. Expected '%s', got '%s'\", i));\n }\n String district = convertProductGroupElementToString(pk, multict, 1);\n String station = convertProductGroupElementToString(pk, multict, 2);\n String question = convertProductGroupElementToString(pk, multict, 3);\n GroupElement blind = ((ProductGroupElement) multict.getElements()[0]).getElements()[4];\n GroupElement blindedMessage =\n ((ProductGroupElement) multict.getElements()[1]).getElements()[4];\n ElGamalCiphertext cc =\n new ElGamalCiphertext(blind, blindedMessage, pk.getParameters().getOID());\n res.computeIfAbsent(district, x -> new LinkedHashMap<>())\n .computeIfAbsent(station, x -> new LinkedHashMap<>())\n .computeIfAbsent(question, x -> new ArrayList()).add(cc.getBytes());\n }\n AnonymousBallotBox bb = new AnonymousBallotBox(election, res);\n return bb;\n }\n\n private static String convertProductGroupElementToString(ElGamalPublicKey pk,\n ProductGroupElement pge, int index) throws IllegalArgumentException {\n GroupElement[] els = pge.getElements();\n GroupElement msgenc = ((ProductGroupElement) els[1]).getElements()[index];\n Plaintext padded = pk.getParameters().getGroup().decode(msgenc);\n Plaintext pt = pk.getParameters().getGroup().unpad(padded);\n String msg = pt.getUTF8DecodedMessage();\n return msg;\n }\n\n private static GroupElement convertPublickeyToBytetree(ElGamalPublicKey pk) {\n ProductGroupElement pkpg = pk.getAsProductGroupElement();\n ProductGroupElement gpg = new ProductGroupElement((ProductGroup) pkpg.getGroup(),\n pk.getParameters().getGenerator(), pk.getParameters().getGroup().getIdentity());\n ProductGroupElement res =\n DataParser.toArray(new ProductGroupElement[] {gpg, gpg, gpg, gpg, pkpg});\n return res;\n }\n}\n" }, { "path": "auditor/src/main/java/ee/ivxv/audit/tools/DecryptTool.java", "content": "package ee.ivxv.audit.tools;\n\nimport ee.ivxv.audit.AuditContext;\nimport ee.ivxv.audit.Msg;\nimport ee.ivxv.audit.model.PlainBallotBox;\nimport ee.ivxv.audit.model.Tally;\nimport ee.ivxv.audit.tools.DecryptTool.DecryptArgs;\nimport ee.ivxv.audit.util.DiscardedBallot;\nimport ee.ivxv.audit.util.InvalidDecProofs;\nimport ee.ivxv.common.M;\nimport ee.ivxv.common.cli.Arg;\nimport ee.ivxv.common.cli.Args;\nimport ee.ivxv.common.cli.Tool;\nimport ee.ivxv.common.crypto.Plaintext;\nimport ee.ivxv.common.crypto.elgamal.ElGamalCiphertext;\nimport ee.ivxv.common.crypto.elgamal.ElGamalDecryptionProof;\nimport ee.ivxv.common.crypto.elgamal.ElGamalPublicKey;\nimport ee.ivxv.common.math.Group;\nimport ee.ivxv.common.math.GroupElement;\nimport ee.ivxv.common.math.MathException;\nimport ee.ivxv.common.model.AnonymousBallotBox;\nimport ee.ivxv.common.model.CandidateList;\nimport ee.ivxv.common.model.DistrictList;\nimport ee.ivxv.common.model.Proof;\nimport ee.ivxv.common.service.bbox.impl.BboxHelperImpl;\nimport ee.ivxv.common.service.console.Progress;\nimport ee.ivxv.common.util.I18nConsole;\nimport ee.ivxv.common.util.Json;\nimport ee.ivxv.common.util.ToolHelper;\nimport ee.ivxv.common.util.Util;\nimport org.slf4j.Logger;\nimport org.slf4j.LoggerFactory;\nimport org.apache.commons.collections4.Bag;\nimport org.apache.commons.collections4.bag.HashBag;\n\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport java.util.*;\nimport java.util.concurrent.*;\nimport java.util.function.Consumer;\nimport java.util.stream.Collectors;\n\n/**\n * Tool for verifying the correctness and consistency of ciphertext decryption.\n */\npublic class DecryptTool implements Tool.Runner {\n private final Logger log = LoggerFactory.getLogger(DecryptTool.class);\n\n private final AuditContext ctx;\n private final I18nConsole console;\n private final ToolHelper tool;\n\n public DecryptTool(AuditContext ctx) {\n this.ctx = ctx;\n this.console = new I18nConsole(ctx.i.console, ctx.i.i18n);\n tool = new ToolHelper(console, ctx.container, new BboxHelperImpl(ctx.conf, ctx.container));\n }\n\n @Override\n public boolean run(DecryptArgs args) throws Exception {\n // Verify whether all provided files are found on the filesystem.\n boolean allFilesExist = verifyInputFiles(args);\n if (!allFilesExist) {\n console.println();\n return false;\n }\n\n boolean abortEarly = args.abortEarly.value();\n boolean verifyInvalid = Objects.nonNull(args.invalidInputPath.value());\n boolean allChecksPassed = true;\n\n DistrictList districts = tool.readJsonDistricts(args.districts.value());\n CandidateList candidates = tool.readJsonCandidates(args.candidates.value(), districts);\n\n console.println();\n\n console.println(Msg.m_anon_loading, args.anonBoxPath.value());\n // The anonymous ballot box will subsequently be mutated!\n AnonymousBallotBox anonBb = Json.read(args.anonBoxPath.value(), AnonymousBallotBox.class);\n console.println(Msg.m_anon_loaded);\n\n console.println();\n\n console.println(Msg.m_pub_loading, args.pubPath.value());\n ElGamalPublicKey pub = new ElGamalPublicKey(args.pubPath.value());\n console.println(Msg.m_pub_loaded);\n\n // Use bags since it might be that there are multiple identical ciphertexts.\n // While these occurrences are suspicious and should be flagged, the flagging is done by\n // the integrity tool, not the decrypt tool.\n Bag vProofCiphers = new HashBag<>(); // from proofs of ballot validity\n Bag iProofCiphers = new HashBag<>(); // from proofs of ballot invalidity\n\n // For privacy reasons, these proofs might not exist: their generation is optional.\n if (verifyInvalid) {\n Proof proofs = tool.readJsonProofs(args.invalidInputPath.value());\n // Cryptographically verify proofs and get the base64 encoded invalid ballots.\n boolean allCorrect = processVerification(proofs, pub, ctx.args.threads.value(),\n args.outputPath.value(), false, iProofCiphers);\n\n if (!allCorrect && abortEarly) {\n printFailure();\n return true;\n } else allChecksPassed = allCorrect;\n\n // Verify invalidity: plaintexts are indeed invalid.\n // Verify consistency: all ciphertexts in the proof file have a counterpart in the anonymous BB.\n // If this step becomes a performance bottleneck, it could be combined with the previous check.\n // Currently, the checks are separate for implementation clarity.\n // Note! Mutates the anonymous ballot box: removes ciphertexts of invalid votes from it.\n boolean areConsistent = verifyPlaintexts(pub, anonBb, proofs, candidates, false);\n if (!areConsistent && abortEarly) {\n printFailure();\n return true;\n } else allChecksPassed = allChecksPassed && areConsistent;\n }\n\n Proof proofs = tool.readJsonProofs(args.inputPath.value());\n // Cryptographically verify proofs and get the base64 encoded valid ballots.\n boolean allCorrect = processVerification(proofs, pub, ctx.args.threads.value(),\n args.outputPath.value(), true, vProofCiphers);\n\n if (!allCorrect && abortEarly) {\n printFailure();\n return true;\n } else allChecksPassed = allChecksPassed && allCorrect;\n\n // Verify validity: plaintexts are indeed valid.\n // Verify consistency: all ciphertexts in the proof file have a counterpart in the anonymous BB.\n // If this step becomes a performance bottleneck, it could be combined with the previous check.\n // Currently, the checks are separate for implementation clarity.\n // Note! Mutates the anonymous ballot box: removes ciphertexts of valid votes from it.\n boolean areConsistent = verifyPlaintexts(pub, anonBb, proofs, candidates, true);\n if (!areConsistent && abortEarly) {\n printFailure();\n return true;\n } else allChecksPassed = allChecksPassed && areConsistent;\n\n // Get the ciphertexts deemed invalid.\n // The file must always be provided, even if there are none: the file then contains none.\n Bag discardedCiphers = getDiscardedCiphers(args.discardedInputPath.value());\n\n if (verifyInvalid) {\n // Verify whether the invalidity proofs are consistent with the ciphertexts declared invalid:\n // - all ciphertexts in the proofs file must have a counterpart in the invalids file\n // - all ciphertexts in the invalids file must have a counterpart in the proofs file\n boolean consistentInvalids = verifyInvalidConsistency(discardedCiphers, iProofCiphers);\n console.println(Msg.m_decrypt_consistent_invalids, getYesNoMessage(consistentInvalids));\n if (!consistentInvalids && abortEarly) {\n printFailure();\n return true;\n } else allChecksPassed = allChecksPassed && consistentInvalids;\n } else {\n // If the invalidity proofs are not provided, verify whether all ciphertexts declared invalid\n // have a counterpart in the anonymous BB. This is already done if the proofs are provided.\n // Note! Mutates the anonymous ballot box: removes ciphertexts of invalid votes from it.\n boolean invalidsInBb = verifyCiphersInBb(anonBb, discardedCiphers);\n console.println(Msg.m_decrypt_bb_has_invalids, getYesNoMessage(invalidsInBb));\n if (!invalidsInBb && abortEarly) {\n printFailure();\n return true;\n } else allChecksPassed = allChecksPassed && invalidsInBb;\n }\n\n // Verify that no ciphertext is declared both valid and invalid.\n console.println();\n boolean disjointOutputs = Collections.disjoint(vProofCiphers, discardedCiphers);\n console.println(Msg.m_decrypt_one_per_file, getYesNoMessage(disjointOutputs));\n if (!disjointOutputs && abortEarly) {\n printFailure();\n return true;\n } else allChecksPassed = allChecksPassed && disjointOutputs;\n\n // The anonymous BB should now be empty if it is consistent with the proof files:\n // all ciphertexts in the anonymous BB then have a counterpart in the proof files.\n // If only validity proofs were provided, the counterparts were checked through the invalid\n // ciphertexts file.\n // The converse consistency has already been verified, i.e. that all ciphertexts have a\n // counterpart in the anonymous BB.\n // In summary, if the following check passes, then: anon bb = valid ciphertexts + invalid ciphertexts\n boolean abbIsEmpty = isAnonBBEmpty(anonBb);\n console.println(Msg.m_decrypt_dec_consistent, getYesNoMessage(abbIsEmpty));\n if (!abbIsEmpty && abortEarly) {\n printFailure();\n return true;\n } else allChecksPassed = allChecksPassed && abbIsEmpty;\n\n // Get the plaintext ballot box.\n console.println();\n console.println(Msg.m_plain_loading, args.plainBoxPath.value());\n PlainBallotBox plainBb = Json.read(args.plainBoxPath.value(), PlainBallotBox.class);\n console.println(Msg.m_plain_loaded);\n\n // Verify whether the plaintext ballot box is consistent with the plaintexts in the proofs file:\n // - all plaintexts in the proofs file must have a counterpart in the plaintext ballot box\n // - all entries in the plaintext ballot box must have a counterpart in the proofs file\n // - the number of invalid votes should be consistent\n // If this step becomes a performance bottleneck, it should be somehow combined with the\n // validity proof verification stage.\n boolean consistentValids = verifyValidConsistency(pub, proofs, plainBb, discardedCiphers.size());\n console.println(Msg.m_decrypt_consistent_valids, getYesNoMessage(consistentValids));\n if (!consistentValids && abortEarly) {\n printFailure();\n return true;\n } else allChecksPassed = allChecksPassed && consistentValids;\n\n console.println();\n\n // Verify whether the plaintext ballot box matches with the computed tally.\n boolean tallyValid = verifyTally(plainBb, args.tallyPath.value());\n console.println(Msg.m_tally_match, getYesNoMessage(tallyValid));\n if (!tallyValid && abortEarly) {\n printFailure();\n return true;\n } else allChecksPassed = allChecksPassed && tallyValid;\n\n console.println();\n if (allChecksPassed) console.println(Msg.m_decrypt_success);\n else console.println(Msg.m_decrypt_failure);\n console.println();\n\n return true;\n }\n\n private Msg getYesNoMessage(boolean success) {\n if (success) return Msg.m_yes;\n return Msg.m_no;\n }\n\n private void printFailure() {\n console.println();\n console.println(Msg.m_decrypt_failure);\n console.println();\n }\n\n private boolean isAnonBBEmpty(AnonymousBallotBox abb) {\n boolean isEmpty = true;\n for (Map>> smap : abb.getDistricts().values()) {\n for (Map> qmap : smap.values()) {\n for (List clist : qmap.values()) {\n if (clist.isEmpty()) continue;\n isEmpty = false;\n for (byte[] c : clist) {\n String b64ct = Base64.getEncoder().encodeToString(c);\n log.warn(\"Output files missing ballot: {}\", b64ct);\n }\n }\n }\n }\n return isEmpty;\n }\n\n /**\n * Parses the file of discarded ciphertexts and extracts them.\n *\n * @param path the path of the file containing discarded ciphertexts\n * @return a bag of base64-encoded ciphertexts\n * @throws Exception If the file cannot be read or parsed\n */\n private Bag getDiscardedCiphers(Path path) throws Exception {\n Bag discardedCTs = new HashBag<>();\n\n console.println();\n console.println(Msg.m_discarded_loading, path);\n DiscardedBallot discarded = Json.read(path, DiscardedBallot.class);\n console.println(Msg.m_discarded_loaded);\n\n console.println(Msg.m_discarded_count, discarded.getCount());\n\n discarded.getDiscarded().forEach(vote ->\n discardedCTs.add(Base64.getEncoder().encodeToString(vote.getVote())));\n\n return discardedCTs;\n }\n\n /**\n * Verifies the proofs of correct decryption.\n *

\n * Additionally, verifies whether the decrypted results indeed are valid or invalid,\n * thus confirming whether proofs are valid proofs of validity or invalidity.\n * Collects also the base64-encoded ciphertexts for subsequent audit operations.\n *\n * @param proofs the decryption proofs\n * @param pub the election public key\n * @param threadCount the number of threads to use for processing\n * @param outPath the directory where to output verification failures\n * @param validityProofs whether the proofs prove validity or invalidity of ballots\n * @param b64CTs the bag where to store base64-encoded ciphertexts\n * @return true if all proofs verify, false otherwise\n * @throws Exception If the verification process cannot complete\n */\n private boolean processVerification(Proof proofs, ElGamalPublicKey pub, int threadCount,\n Path outPath, boolean validityProofs,\n Bag b64CTs) throws Exception {\n console.println();\n console.println(Msg.m_verify_start);\n InvalidDecProofs invalid = verifyDecryption(proofs, pub, threadCount, b64CTs);\n console.println(Msg.m_verify_finish);\n\n console.println(Msg.m_failurecount, invalid.getCount());\n if (invalid.getCount() == 0) return true;\n\n console.println(M.m_out_start, outPath);\n if (!Files.exists(outPath)) Files.createDirectory(outPath);\n\n if (validityProofs)\n invalid.outputFailedProofsOfValidity(outPath);\n else\n invalid.outputFailedProofsOfInvalidity(outPath);\n\n console.println(M.m_out_done, outPath);\n\n return false;\n }\n\n /**\n * Verifies whether plaintexts in a proof file really are valid/invalid.\n *

\n * Mutates the anonymous ballot box: removes ciphertexts for which it has\n * checked the plaintext. This speeds up subsequent verifications and keeps\n * track of the verification status.\n *\n * @param pub the election public key\n * @param abb the anonymous ballot box\n * @param proofs the proof file\n * @param candidates the list of accepted candidates\n * @param expectedValid whether the plaintexts should be valid or invalid\n * @return the result of the checks\n */\n private boolean verifyPlaintexts(ElGamalPublicKey pub, AnonymousBallotBox abb, Proof proofs, CandidateList candidates,\n boolean expectedValid) {\n // Using a set is fine here even if there are repetitions since we have already verified the proofs:\n // inconsistent repetitions should no longer be possible.\n Map votes = new HashMap<>();\n // However, we still need to keep track of how many duplications there are when we compare with the\n // ballot box later.\n Bag multiples = new HashBag<>();\n\n // Get all ciphertext-message pairs.\n for (Proof.ProofJson proof : proofs.getProofs()) {\n String b64 = Base64.getEncoder().encodeToString(proof.getCiphertext());\n GroupElement old = votes.put(b64, pub.getParameters().getGroup().getElement(proof.getMessage()));\n\n if (Objects.isNull(old)) continue; // not a duplicate\n\n if (!multiples.contains(b64)) multiples.add(b64, 2); // add two the first time\n else multiples.add(b64);\n }\n\n boolean allCorrect = true;\n\n for (Map.Entry>>> districtMap : abb.getDistricts().entrySet()) {\n for (Map> sMap : districtMap.getValue().values()) {\n for (List cList : sMap.values()) {\n Iterator i = cList.iterator();\n while (i.hasNext()) {\n byte[] c = i.next();\n String b64 = Base64.getEncoder().encodeToString(c);\n GroupElement decrypted = votes.remove(b64);\n multiples.remove(b64);\n if (Objects.isNull(decrypted)) continue;\n Group group = pub.getParameters().getGroup();\n Plaintext decoded = group.decode(decrypted);\n Plaintext unpadded = group.unpad(decoded);\n\n boolean isValid = isValidChoice(unpadded, districtMap.getKey(), candidates);\n if (isValid != expectedValid) {\n log.warn(\"Plaintext is declared {} but is not: {}\",\n expectedValid ? \"valid\" : \"invalid\", unpadded.getUTF8DecodedMessage());\n }\n allCorrect = allCorrect && (isValid == expectedValid);\n i.remove();\n }\n }\n }\n }\n\n // Verify whether all proof file entries were indeed in the anonymous ballot box.\n boolean allInBb = votes.isEmpty() && multiples.isEmpty();\n if (!allInBb) {\n log.warn(\"There were {} ballots missing from the input ballot box:\", votes.size() + multiples.size());\n logMissingBallots(votes.keySet());\n logMissingBallots(multiples);\n }\n\n if (expectedValid) console.println(Msg.m_decrypt_verified_valid, getYesNoMessage(allCorrect));\n else console.println(Msg.m_decrypt_verified_invalid, getYesNoMessage(allCorrect));\n\n console.println(Msg.m_decrypt_bb_has_proofs, getYesNoMessage(allInBb));\n return allCorrect && allInBb;\n }\n\n private boolean verifyTally(PlainBallotBox pbb, Path tallyPath) throws Exception {\n console.println(Msg.m_tally_loading, tallyPath);\n Tally tally = Json.read(tallyPath, Tally.class);\n console.println(Msg.m_tally_loaded);\n\n boolean electionMatches = tally.getElection().equals(pbb.election());\n if (!electionMatches) {\n log.warn(\"The tally is for election '{}' while the plaintext ballot box is for election '{}'\",\n tally.getElection(), pbb.election());\n return false;\n }\n\n boolean parishesMatch = tally.getByParish().keySet().equals(pbb.byParish().keySet());\n if (!parishesMatch) {\n log.warn(\"Parishes do not match between the tally and the plaintext ballot box\");\n return false;\n }\n\n // This iteration is comprehensive since the parish sets must now be equal.\n for (Map.Entry>> parishMap : pbb.byParish().entrySet()) {\n String parishId = parishMap.getKey();\n Map> districtVotes = parishMap.getValue();\n\n Map> parishDistricts = tally.getByParish().get(parishId);\n boolean districtsMatch = parishDistricts.keySet().equals(districtVotes.keySet());\n if (!districtsMatch) {\n log.warn(\"Districts do not match between the tally and the plaintext ballot box\");\n return false;\n }\n\n // This iteration is comprehensive since the district sets must now be equal.\n for (Map.Entry> votesMap : districtVotes.entrySet()) {\n // The plaintext votes for that district.\n List votes = votesMap.getValue();\n\n // Counter the (choice, count) pairs from the plaintext BB entry.\n Map counts = votes.stream()\n .collect(Collectors.groupingBy(c -> c, Collectors.summingInt(c -> 1)));\n // The tallied (choice, count) pairs. Create a copy to avoid mutation.\n Map tallyCounts = new LinkedHashMap<>(parishDistricts.get(votesMap.getKey()));\n\n for (Map.Entry count : counts.entrySet()) {\n // The tally counts must match the count obtained from the plaintext BB.\n if (!tallyCounts.remove(count.getKey()).equals(count.getValue())) {\n log.warn(\"Plaintext ballot box and tally mismatch for the choice '{}'\", count.getKey());\n return false;\n }\n }\n\n // Whatever choice is present in the tally map should now have 0 votes.\n // The plaintext BB choices have already been checked for validity.\n for (Integer val : tallyCounts.values()) {\n if (val != 0) {\n log.warn(\"Vote count > 0 for a choice not present in the plaintext ballot box\");\n return false;\n }\n }\n }\n }\n\n // We have checked the byParish tally. The byDistrict tally must also be checked.\n // Since byParish is valid, simply check whether the byDistrict tally obtained\n // from the byParish tally matches with the byDistrict tally read form the tally.\n return tally.getByDistrict().equals(tally.computeByDistrict());\n }\n\n private boolean isValidChoice(Plaintext pt, String district, CandidateList candidates) {\n String candidateCode;\n try {\n candidateCode = pt.getUTF8DecodedMessage();\n } catch (IllegalArgumentException ignored) {\n return false;\n }\n\n // Get choices list\n Map>> ds = candidates.getCandidates();\n // Ensure that vote district exists in a choices list\n if (!ds.containsKey(district)) {\n return false;\n }\n\n // Get choices for a specific district (district that vote belongs to)\n Map> ps = ds.get(district);\n // Ensure that there are choices per that district\n if (ps.isEmpty()) {\n return false;\n }\n\n // Loop over all choices per that district\n for (Map parties : ps.values()) {\n // Is there a candidate code that matches candidateCode\n if (parties.containsKey(candidateCode)) {\n return true;\n }\n }\n\n // Choice is not valid\n return false;\n }\n\n private InvalidDecProofs verifyDecryption(Proof input, ElGamalPublicKey pub,\n int threadCount, Bag b64CTs) throws Exception {\n InvalidDecProofs idp = new InvalidDecProofs(input.getElection());\n ExecutorService ioExecutor = Executors.newFixedThreadPool(2);\n CompletionService CompService = new ExecutorCompletionService<>(ioExecutor);\n\n ExecutorService verifyExecutor;\n threadCount = threadCount > 0 ? threadCount : 1;\n verifyExecutor = new ThreadPoolExecutor(threadCount, threadCount, 0L, TimeUnit.MILLISECONDS,\n new ArrayBlockingQueue<>(threadCount * 2));\n\n WorkManager manager =\n new WorkManager(input, getVerifyConsumer(pub, idp, b64CTs), verifyExecutor, idp);\n CompService.submit(manager);\n CompService.submit(idp.getResultWorker());\n\n try {\n for (int done = 0; done < 2; done++) {\n CompService.take().get();\n }\n } finally {\n ioExecutor.shutdown();\n verifyExecutor.shutdown();\n }\n return idp;\n }\n\n private Consumer getVerifyConsumer(ElGamalPublicKey pub,\n InvalidDecProofs out,\n Bag b64CTs) {\n return (proofJson) -> {\n GroupElement decrypted = pub.getParameters().getGroup().getElement(proofJson.getMessage());\n ElGamalCiphertext ct =\n new ElGamalCiphertext(pub.getParameters(), proofJson.getCiphertext());\n ElGamalDecryptionProof proof =\n new ElGamalDecryptionProof(ct, decrypted, pub, proofJson.getProof());\n\n // Get the base64-encoded ballot for later comparison with the ballot box.\n b64CTs.add(Base64.getEncoder().encodeToString(proofJson.getCiphertext()));\n\n try {\n boolean res = proof.verifyProof();\n if (!res) {\n log.warn(\"Proof verification failed: {}\", proof);\n out.addInvalidProof(proof);\n }\n } catch (MathException e) {\n log.warn(\"Proof verification exception: {}, {}\", proof, e);\n out.addInvalidProof(proof);\n }\n };\n }\n\n /**\n * Verifies whether ciphertexts are part of the anonymous ballot box.\n *\n * @param abb the anonymous ballot box\n * @param b64CTs the base64-encoded ciphertexts to check inclusion for\n * @return true if all the ciphertexts are included, false otherwise\n */\n private boolean verifyCiphersInBb(AnonymousBallotBox abb, Bag b64CTs) {\n // Do not mutate the ciphers.\n Bag b64copy = new HashBag<>(b64CTs);\n\n for (Map>> sMap : abb.getDistricts().values()) {\n for (Map> qMap : sMap.values()) {\n for (List cList : qMap.values()) {\n Iterator i = cList.iterator();\n while (i.hasNext()) {\n byte[] c = i.next();\n String b64ct = Base64.getEncoder().encodeToString(c);\n if (!b64copy.remove(b64ct, 1)) continue;\n i.remove();\n }\n }\n }\n }\n\n // Verify whether all entries were indeed in the anonymous ballot box.\n boolean allInBb = b64copy.isEmpty();\n if (!allInBb) {\n log.warn(\"There were {} ballots missing from the input ballot box:\", b64copy.size());\n logMissingBallots(b64copy);\n }\n return allInBb;\n }\n\n private boolean verifyInvalidConsistency(Bag discardedCiphers, Bag iProofCiphers) {\n if (iProofCiphers.equals(discardedCiphers)) return true;\n\n // Create copies to avoid mutating inputs.\n Bag iProofCopy = new HashBag<>(iProofCiphers);\n Bag discardedCopy = new HashBag<>(discardedCiphers);\n\n // Obtain the differences and log them.\n iProofCopy.removeAll(discardedCiphers);\n discardedCopy.removeAll(iProofCiphers);\n\n log.warn(\"There were {} ballots missing from the discarded votes file:\", iProofCopy.size());\n logMissingBallots(iProofCopy);\n\n log.warn(\"There were {} ballots missing from the invalid proofs:\", discardedCopy.size());\n logMissingBallots(discardedCopy);\n\n return false;\n }\n\n private void logMissingBallots(Collection b64CTs) {\n for (String b64ct : b64CTs) log.warn(\"Missing ballot: {}\", b64ct);\n }\n\n /**\n * Verifies plaintext ballot box consistency with the validity proofs.\n *

\n * Carries out the verification solely based on the choice identifier, and not\n * on the complete plaintext vote. The full validation of plaintexts in the proofs\n * file must be carried out beforehand for stronger consistency guarantees.\n *\n * @param pub the election public key\n * @param proofs the validity proofs\n * @param pbb the plaintext ballot box\n * @param invalidCount the number of expected invalid votes\n * @return true if the verification succeeds, false otherwise\n */\n private boolean verifyValidConsistency(ElGamalPublicKey pub, Proof proofs, PlainBallotBox pbb, int invalidCount) {\n Bag plainVotes = new HashBag<>(pbb.byDistrict().values().stream()\n .flatMap(Collection::stream).toList());\n console.println(Msg.m_plain_count, plainVotes.size());\n\n console.println();\n console.println(Msg.m_decrypt_consistent_valids_begin);\n\n boolean noExtra = true;\n try {\n for (Proof.ProofJson proof : proofs.getProofs()) {\n GroupElement decrypted = pub.getParameters().getGroup().getElement(proof.getMessage());\n Group group = decrypted.getGroup();\n Plaintext decoded = group.decode(decrypted);\n // Note! Here we do not validate the full vote, meaning that the validation\n // should be done prior to calling this function.\n String voteCode = group.unpad(decoded).getUTF8DecodedMessage();\n if (plainVotes.remove(voteCode, 1)) continue;\n noExtra = false;\n log.warn(\"A vote for {} is missing from the plaintext ballot box\", voteCode);\n }\n } catch (Exception e) {\n // Barring software errors, this can happen only if\n // the proofs file is manipulated/corrupted.\n log.error(e.toString());\n return false;\n }\n\n // There were proofs for votes not present in the plaintext BB.\n if (!noExtra) {\n log.warn(\"There were proofs for votes not present in the plaintext ballot box\");\n return false;\n }\n\n // We have checked the byDistrict votes. The byParish votes must also be checked.\n // Since byDistrict is valid, simply check whether the byDistrict votes obtained\n // from the byParish votes matches with the byDistrict votes read form the plaintext BB.\n boolean tallyConsistent = pbb.byDistrict().equals(pbb.computeByDistrict());\n if (!tallyConsistent) {\n log.warn(\"byparish inconsistent with bydistrict in the plaintext ballot box\");\n return false;\n }\n\n return plainVotes.size() == invalidCount;\n }\n\n private boolean verifyInputFiles(DecryptArgs args) {\n List paths = new ArrayList<>(List.of(\n args.inputPath.value(),\n args.pubPath.value(),\n args.discardedInputPath.value(),\n args.anonBoxPath.value(),\n args.plainBoxPath.value(),\n args.tallyPath.value(),\n args.districts.value(),\n args.candidates.value()));\n\n if (Objects.nonNull(args.invalidInputPath.value()))\n paths.add(args.invalidInputPath.value());\n\n for (Path path : paths) {\n if (Files.notExists(path)) {\n console.println();\n console.println(Msg.e_file_missing, path);\n return false;\n }\n }\n\n return true;\n }\n\n public static class DecryptArgs extends Args {\n Arg inputPath = Arg.aPath(Msg.arg_proofs);\n Arg invalidInputPath = Arg.aPath(Msg.arg_invalidity_proofs).setOptional();\n Arg pubPath = Arg.aPath(Msg.arg_pub);\n Arg anonBoxPath = Arg.aPath(Msg.arg_anon_bb);\n Arg plainBoxPath = Arg.aPath(Msg.arg_plain_bb);\n Arg tallyPath = Arg.aPath(Msg.arg_tally);\n Arg discardedInputPath = Arg.aPath(Msg.arg_discarded);\n Arg districts = Arg.aPath(Msg.arg_districts);\n Arg candidates = Arg.aPath(Msg.arg_candidates);\n Arg outputPath = Arg.aPath(Msg.arg_out, false, true);\n Arg abortEarly = Arg.aFlag(Msg.arg_abort_early).setDefault(true);\n\n public DecryptArgs() {\n super();\n args.add(inputPath);\n args.add(pubPath);\n args.add(discardedInputPath);\n args.add(anonBoxPath);\n args.add(plainBoxPath);\n args.add(tallyPath);\n args.add(districts);\n args.add(candidates);\n args.add(outputPath);\n args.add(invalidInputPath);\n args.add(abortEarly);\n }\n }\n\n private class WorkManager implements Callable {\n private final Proof in;\n private final Consumer consumer;\n private final ExecutorService verifyExecutor;\n private final InvalidDecProofs idp;\n\n WorkManager(Proof in, Consumer consumer, ExecutorService verifyExecutor,\n InvalidDecProofs idp) {\n this.in = in;\n this.consumer = consumer;\n this.verifyExecutor = verifyExecutor;\n this.idp = idp;\n }\n\n @Override\n public Void call() throws Exception {\n Progress progress = console.startProgress(in.getCount());\n in.getProofs().forEach(proof -> {\n boolean taskAdded = false;\n do {\n try {\n verifyExecutor.execute(() -> consumer.accept(proof));\n taskAdded = true;\n } catch (RejectedExecutionException e) {\n try {\n Thread.sleep(20);\n } catch (InterruptedException e1) {\n log.warn(\"Unexpected interruption\", e1);\n }\n }\n } while (!taskAdded);\n progress.increase(1);\n });\n verifyExecutor.shutdown();\n verifyExecutor.awaitTermination(1, TimeUnit.DAYS);\n idp.setEot();\n progress.finish();\n return null;\n }\n }\n}\n" }, { "path": "auditor/src/main/java/ee/ivxv/audit/tools/IntegrityTool.java", "content": "package ee.ivxv.audit.tools;\n\nimport ee.ivxv.audit.AuditContext;\nimport ee.ivxv.audit.Msg;\nimport ee.ivxv.audit.tools.IntegrityTool.IntegrityArgs;\nimport ee.ivxv.audit.util.RawBallotWithDigest;\nimport ee.ivxv.common.cli.Arg;\nimport ee.ivxv.common.cli.Args;\nimport ee.ivxv.common.cli.Tool;\nimport ee.ivxv.common.crypto.hash.HashType;\nimport ee.ivxv.common.model.AnonymousBallotBox;\nimport ee.ivxv.common.service.bbox.impl.FileSource;\nimport ee.ivxv.common.service.bbox.impl.ZipSource;\nimport ee.ivxv.common.service.bbox.impl.ZipSourceRaw;\nimport ee.ivxv.common.service.console.Progress;\nimport ee.ivxv.common.util.I18nConsole;\nimport ee.ivxv.common.util.Json;\nimport org.slf4j.Logger;\nimport org.slf4j.LoggerFactory;\nimport org.apache.commons.collections4.Bag;\nimport org.apache.commons.collections4.bag.TreeBag;\n\nimport java.io.BufferedReader;\nimport java.io.FileReader;\nimport java.io.IOException;\nimport java.math.BigInteger;\nimport java.nio.file.Files;\nimport java.nio.file.Path;\nimport java.util.*;\n\npublic class IntegrityTool implements Tool.Runner {\n\n private static final String BDOC_EXTENSION = \".bdoc\";\n private static final String ASICE_EXTENSION = \".asice\";\n private static final String RAW_BALLOT_EXTENSION = \".ballot\";\n private static final Character DIR_SEP = '/';\n private static final String EXPECTED_BALLOT_REF = \"\" + DIR_SEP + \"+XXXX\";\n\n private static final String CSV_FIELD_SEPARATOR = \"\\t\";\n private static final int LOG_HASH_ENTRY_FIELDS = 5;\n private static final int BB_ERRORS_ENTRY_FIELDS = 3;\n\n private static final String BB_ERRORS_BALLOT_REGEX = \"^\\\\d{11}/\\\\d+\\\\+\\\\d{4}$\";\n\n private final Logger log = LoggerFactory.getLogger(IntegrityTool.class);\n private final AuditContext ctx;\n private final I18nConsole console;\n\n public IntegrityTool(AuditContext ctx) {\n this.ctx = ctx;\n this.console = new I18nConsole(ctx.i.console, ctx.i.i18n);\n }\n\n @Override\n public boolean run(IntegrityArgs args) throws Exception {\n // Verify whether all provided files are found on the filesystem.\n boolean allFilesExist = verifyInputFiles(args);\n if (!allFilesExist) {\n console.println();\n return false;\n }\n\n boolean abortEarly = args.abortEarly.value();\n\n console.println();\n\n console.println(Msg.m_bb_loading, args.bb.value());\n List ballots = getBallots(args);\n console.println(Msg.m_bb_loaded);\n BigInteger checksumAll = sumBbHashes(ballots);\n\n console.println();\n\n // Checksums of ballots in the processed ballot box.\n console.println(Msg.m_anon_loading, args.anonBoxPath.value());\n AnonymousBallotBox anonBb = Json.read(args.anonBoxPath.value(), AnonymousBallotBox.class);\n AnonBbDigests anonDigests = getAnonBbDigests(anonBb);\n console.println(Msg.m_anon_loaded);\n console.println();\n\n console.println(Msg.m_log_accepted, args.acceptedLogPath.value());\n console.println(Msg.m_log_squashed, args.squashedLogPath.value());\n console.println(Msg.m_log_revoked, args.revokedLogPath.value());\n console.println(Msg.m_log_anonymised, args.anonLogPath.value());\n console.println(Msg.m_bb_errors, args.bbErrorsPath.value());\n\n console.println();\n\n // Checksums of all accepted (valid received) ballots.\n List acceptedDigests = getBallotDigestsFromLog(args.acceptedLogPath.value());\n BigInteger acceptedDigestsSum = sumHashes(acceptedDigests);\n\n Set erroredBallotNames = getErroredBallotsNames(args.bbErrorsPath.value());\n BbDigests bbDigests = getValidInvalidSums(ballots, acceptedDigests, erroredBallotNames);\n if (bbDigests == null) {\n // This should happen only if ballots in the original ballot box appear in neither\n // the error log nor the accepted log.\n console.println(Msg.m_integrity_bb_consistent, getYesNoMessage(false));\n if (abortEarly) {\n console.println();\n return true;\n }\n } else {\n // This check should never fail but is here for clarity.\n // If true: accepted ballots in the original box are consistent with the log of accepted ballots.\n boolean validChecksumsMatch = bbDigests.validSum.equals(acceptedDigestsSum);\n\n // This check should never fail but is here for clarity.\n // If true: accepted ballots + refused ballots = original box.\n boolean sumIsConsistent = checksumAll.equals(bbDigests.invalidSum.add(bbDigests.validSum));\n\n boolean bbIsConsistent = validChecksumsMatch && sumIsConsistent;\n console.println(Msg.m_integrity_bb_consistent, getYesNoMessage(bbIsConsistent));\n if (!bbIsConsistent) {\n\n if (abortEarly) {\n console.println();\n return true;\n }\n\n // Check if accepted ballots are included in the original box.\n // This provides more information on the inconsistency failure.\n boolean acceptedMatch = matchHashesToBb(acceptedDigests, ballots);\n console.println(Msg.m_integrity_match_valid, getYesNoMessage(acceptedMatch));\n }\n }\n\n // Checksums of accepted ballots that were squashed.\n List squashedDigests = getBallotDigestsFromLog(args.squashedLogPath.value());\n BigInteger squashedDigestsSum = sumHashes(squashedDigests);\n\n // Checksums of accepted ballots that were revoked.\n List revokedDigests = getBallotDigestsFromLog(args.revokedLogPath.value());\n BigInteger revokedDigestsSum = sumHashes(revokedDigests);\n\n // Checksums of accepted ballots forwarded for tallying (remaining after squash + revoke).\n List anonLogDigests = getBallotDigestsFromLog(args.anonLogPath.value());\n BigInteger anonLogDigestsSum = sumHashes(anonLogDigests);\n\n // If true: anon ballots are consistent with the log of anon ballots.\n boolean anonDigestMatches = anonDigests.checksumSum.equals(anonLogDigestsSum);\n console.println(Msg.m_integrity_match_anon_logs, getYesNoMessage(anonDigestMatches));\n if (!anonDigestMatches && abortEarly) {\n console.println();\n return true;\n }\n\n BigInteger postprocessDigestSum = squashedDigestsSum.add(revokedDigestsSum.add(anonLogDigestsSum));\n\n // If true: anon + revoked + squashed = all accepted ballots.\n boolean acceptedDigestMatches = acceptedDigestsSum.equals(postprocessDigestSum);\n console.println(Msg.m_integrity_match_logs, getYesNoMessage(acceptedDigestMatches));\n\n // If all checks succeed, the following audit trail is verified:\n // - anon BB matches with anon log\n // - invalid ballots (log) + valid ballots (log) = original BB\n // - anon ballots (log) + squashed ballots (log) + revoked ballots (log) = valid ballots (log)\n // Inferred: anon ballots are part of the original ballot box.\n\n console.println();\n\n return true;\n }\n\n private Msg getYesNoMessage(boolean success) {\n if (success) return Msg.m_yes;\n return Msg.m_no;\n }\n\n private List getBallots(IntegrityArgs args) {\n List ballots = new ArrayList<>();\n\n // Read ballot box\n FileSource zipContainer = new ZipSource(args.bb.value());\n\n // Start progress, counting from 0 up to the amount of ballots in a ballot box\n int ballotCount = zipContainer.countFilesWithSuffix(Arrays.asList(BDOC_EXTENSION, ASICE_EXTENSION));\n Progress progress = console.startProgress(ballotCount);\n\n // Read ballots from a ballot box one by one\n zipContainer.processFiles((fileName, fileContent) -> {\n\n // Only look for voter signed ballots\n if (fileName.contains(BDOC_EXTENSION) || fileName.contains(ASICE_EXTENSION)) {\n try {\n // Read voter signed container as byte stream\n FileSource signedContainer = new ZipSourceRaw(fileContent.readAllBytes());\n\n // Signed container is a zip file, that contains files inside\n signedContainer.processFiles((ballotName, ballotContent) -> {\n\n // Only look for a ballot file\n if (ballotName.contains(RAW_BALLOT_EXTENSION)) {\n try {\n byte[] ballot = ballotContent.readAllBytes();\n String ballotId = getBallotContainerId(fileName);\n ballots.add(new RawBallotWithDigest(ballot, ballotId));\n } catch (Exception e) {\n throw new RuntimeException(e);\n }\n }\n });\n } catch (IOException e) {\n throw new RuntimeException(e);\n }\n progress.increase(1);\n }\n });\n\n progress.finish();\n\n return ballots;\n }\n\n private static String getBallotContainerId(String fileName) throws Exception {\n // Getting the container path in the BB is necessary\n // for ballot identification through the error log.\n int i = fileName.lastIndexOf(DIR_SEP);\n if (i < 0) {\n // It's OK to throw since we can reasonably expect a valid ballot box.\n throw new Exception(\"Expected name \" + EXPECTED_BALLOT_REF + \" but got \" + fileName);\n }\n int j = fileName.lastIndexOf(DIR_SEP, i - 1);\n int extensionLength = fileName.contains(BDOC_EXTENSION) ?\n BDOC_EXTENSION.length() :\n ASICE_EXTENSION.length();\n String ballotContainerId = fileName.substring(j + 1, fileName.length() - extensionLength);\n if (!ballotContainerId.matches(BB_ERRORS_BALLOT_REGEX)) {\n throw new Exception(\"Expected name \" + EXPECTED_BALLOT_REF + \" but got \" + fileName);\n }\n return ballotContainerId;\n }\n\n private BbDigests getValidInvalidSums(List bb,\n List acceptedDigests, Set invalidBallotIds) {\n BigInteger invalidBallotChecksumSum = BigInteger.ZERO;\n BigInteger validBallotChecksumSum = BigInteger.ZERO;\n\n // Use a tree bag since comparing arrays of bytes does not work in a regular bag.\n // We must use a bag instead of a set since it might happen (statistically unlikely unless intentional)\n // that there are ballots with the same ciphertext. Therefore, a set would not correctly represent the\n // state of the accepted ballots.\n // Use a tree bag since comparing arrays of bytes does not work in a regular bag.\n Bag digests = new TreeBag<>(Arrays::compare);\n digests.addAll(acceptedDigests);\n\n // Notify in case of multiple matching ciphertexts so that the occurrence(s) can be investigated further.\n int recurringCts = digests.size() - digests.uniqueSet().size();\n if (recurringCts != 0) {\n console.println(Msg.m_integrity_recurring_ct);\n log.warn(\"There are {} ciphertext recurrences among the accepted ballots\", recurringCts);\n\n Set recurringDigests = new HashSet<>();\n for (byte[] c : digests) if (digests.getCount(c) != 1) recurringDigests.add(c);\n for (byte[] c : recurringDigests) log.warn(\"Recurring ballot: {}\", Base64.getEncoder().encodeToString(c));\n console.println();\n }\n\n // Avoid mutating the input set. These are IDs so they must be unique.\n Set invalids = new HashSet<>(invalidBallotIds);\n\n boolean errored = false;\n\n for (RawBallotWithDigest ballot : bb) {\n // Make sure that each ballot is referenced in exactly one file.\n int seenCount = 0;\n\n if (invalids.remove(ballot.getId())) {\n invalidBallotChecksumSum =\n invalidBallotChecksumSum.add(new BigInteger(1, ballot.getRawDigest()));\n ++seenCount;\n }\n\n if (digests.remove(ballot.getRawDigest(), 1)) {\n validBallotChecksumSum =\n validBallotChecksumSum.add(new BigInteger(1, ballot.getRawDigest()));\n ++seenCount;\n }\n\n if (seenCount == 0) {\n log.warn(\"Ballot '{}' not found in the acceptance/rejection logs\", ballot.getId());\n errored = true;\n }\n\n if (seenCount > 1) {\n log.warn(\"Ballot '{}' present in both the acceptance and rejection logs\", ballot.getId());\n errored = true;\n }\n }\n\n if (errored) return null;\n\n // Make sure that there are not more log entries than there are ballots in the BB.\n if (!digests.isEmpty() || !invalids.isEmpty()) {\n for (String invalid : invalids)\n log.warn(\"Ballot '{}' is missing from the original ballot box\", invalid);\n for (byte[] digest : digests)\n log.warn(\"Missing from the original ballot box: {}\", Base64.getEncoder().encodeToString(digest));\n return null;\n }\n\n return new BbDigests(invalidBallotChecksumSum, validBallotChecksumSum);\n }\n\n /**\n * Reads the digests from a processor logfile.\n *\n * @param path the logfile path\n * @return a list of digests extracted from the logfile\n * @throws Exception If the logfile does not exist or cannot be properly read\n */\n private List getBallotDigestsFromLog(Path path) throws Exception {\n List hashes = new ArrayList<>();\n\n BufferedReader br = new BufferedReader(new FileReader(path.toFile()));\n String line;\n while ((line = br.readLine()) != null) {\n String[] values = line.split(CSV_FIELD_SEPARATOR);\n if (values.length != LOG_HASH_ENTRY_FIELDS) continue;\n\n byte[] hash = Base64.getDecoder().decode(values[1]);\n hashes.add(hash);\n }\n\n return hashes;\n }\n\n /**\n * Reads ballot identifiers from the ballot validation error report.\n *\n * @param path the report path\n * @return a set of ballot identifiers extracted from the report\n * @throws Exception If the report cannot be found be read\n */\n private Set getErroredBallotsNames(Path path) throws Exception {\n // Use a set since there may be multiple errors pertaining to the\n // same ballot in the log.\n Set erroredBallotNames = new HashSet<>();\n\n BufferedReader br = new BufferedReader(new FileReader(path.toFile()));\n String line;\n while ((line = br.readLine()) != null) {\n String[] values = line.split(CSV_FIELD_SEPARATOR);\n if (values.length != BB_ERRORS_ENTRY_FIELDS) continue;\n if (!values[0].matches(BB_ERRORS_BALLOT_REGEX)) continue;\n\n erroredBallotNames.add(values[0]);\n }\n\n return erroredBallotNames;\n }\n\n private static BigInteger sumHashes(List hashes) {\n BigInteger sum = BigInteger.ZERO;\n\n for (byte[] hash : hashes) {\n sum = sum.add(new BigInteger(1, hash));\n }\n\n return sum;\n }\n\n private static BigInteger sumBbHashes(List bb) {\n BigInteger sum = BigInteger.ZERO;\n\n for (RawBallotWithDigest ballot : bb) {\n sum = sum.add(new BigInteger(1, ballot.getRawDigest()));\n }\n\n return sum;\n }\n\n private AnonBbDigests getAnonBbDigests(AnonymousBallotBox bb) {\n // Also extract checksums in a list to avoid looping again later.\n List digests = new ArrayList<>();\n BigInteger sum = BigInteger.ZERO;\n\n for (Map>> smap : bb.getDistricts().values()) {\n for (Map> qmap : smap.values()) {\n for (List clist : qmap.values()) {\n for (byte[] c : clist) {\n byte[] hash = HashType.SHA256.getFunction().digest(c);\n digests.add(hash);\n sum = sum.add(new BigInteger(1, hash));\n }\n }\n }\n }\n\n return new AnonBbDigests(digests, sum);\n }\n\n /**\n * Verifies whether digests correspond to ballots in a ballot box.\n *\n * @param digests the digests of some set of ballots\n * @param bb the ballot box to match against\n * @return whether all ballots were present in the box\n */\n private boolean matchHashesToBb(List digests, List bb) {\n boolean allOk = true;\n // Potential perf improvement: would it be faster to iterate over the full ballot box\n // and try to remove them from a set of digests? The return value is then whether\n // the set is empty. During normal execution this should never be invoked in any case.\n for (byte[] digest : digests) {\n boolean matches = bb.stream().anyMatch(b -> Arrays.equals(digest, b.getRawDigest()));\n if (!matches) {\n log.warn(\"Missing from the original ballot box: {}\", Base64.getEncoder().encodeToString(digest));\n allOk = false;\n }\n }\n return allOk;\n }\n\n record BbDigests(BigInteger invalidSum, BigInteger validSum) {\n }\n\n record AnonBbDigests(List digests, BigInteger checksumSum) {\n }\n\n private boolean verifyInputFiles(IntegrityArgs args) {\n List paths = new ArrayList<>(List.of(\n args.bb.value(),\n args.anonBoxPath.value(),\n args.acceptedLogPath.value(),\n args.squashedLogPath.value(),\n args.revokedLogPath.value(),\n args.anonLogPath.value(),\n args.bbErrorsPath.value()));\n\n for (Path path : paths) {\n if (Files.notExists(path)) {\n console.println();\n console.println(Msg.e_file_missing, path);\n return false;\n }\n }\n\n return true;\n }\n\n\n public static class IntegrityArgs extends Args {\n Arg bb = Arg.aPath(Msg.arg_ballotbox, true, false);\n Arg anonBoxPath = Arg.aPath(Msg.arg_anon_bb);\n Arg acceptedLogPath = Arg.aPath(Msg.arg_log_accepted);\n Arg squashedLogPath = Arg.aPath(Msg.arg_log_squashed);\n Arg revokedLogPath = Arg.aPath(Msg.arg_log_revoked);\n Arg anonLogPath = Arg.aPath(Msg.arg_log_anonymised);\n Arg bbErrorsPath = Arg.aPath(Msg.arg_bb_errors);\n Arg abortEarly = Arg.aFlag(Msg.arg_abort_early).setDefault(true);\n\n public IntegrityArgs() {\n super();\n args.add(bb);\n args.add(anonBoxPath);\n args.add(acceptedLogPath);\n args.add(squashedLogPath);\n args.add(revokedLogPath);\n args.add(anonLogPath);\n args.add(bbErrorsPath);\n args.add(abortEarly);\n }\n }\n}\n" }, { "path": "auditor/src/main/java/ee/ivxv/audit/tools/MixerTool.java", "content": "package ee.ivxv.audit.tools;\n\nimport ee.ivxv.audit.AuditContext;\nimport ee.ivxv.audit.Msg;\nimport ee.ivxv.audit.shuffle.ShuffleConsole;\nimport ee.ivxv.audit.shuffle.ShuffleException;\nimport ee.ivxv.audit.shuffle.ShuffleProof;\nimport ee.ivxv.audit.shuffle.ThreadedVerifier;\nimport ee.ivxv.audit.shuffle.Verifier;\nimport ee.ivxv.audit.tools.MixerTool.MixerArgs;\nimport ee.ivxv.common.cli.Arg;\nimport ee.ivxv.common.cli.Args;\nimport ee.ivxv.common.cli.Tool;\nimport ee.ivxv.common.util.I18nConsole;\nimport java.nio.file.Path;\n\n/**\n * Tool for verifying the correctness of the shuffle.\n */\npublic class MixerTool implements Tool.Runner {\n private final I18nConsole console;\n private AuditContext ctx;\n\n public static class MixerArgs extends Args {\n Arg protPath = Arg.aPath(Msg.arg_protinfo, true, false);\n Arg proofPath = Arg.aPath(Msg.arg_proofdir, true, true);\n Arg threaded = Arg.aFlag(Msg.arg_threaded);\n\n public MixerArgs() {\n super();\n args.add(protPath);\n args.add(proofPath);\n args.add(threaded);\n }\n }\n\n public MixerTool(AuditContext ctx) {\n this.ctx = ctx;\n this.console = new I18nConsole(ctx.i.console, ctx.i.i18n);\n }\n\n @Override\n public boolean run(MixerArgs args) throws Exception {\n console.println();\n console.println(Msg.m_shuffle_proof_loading, args.protPath.value(), args.proofPath.value());\n ShuffleConsole sc = new ShuffleConsole(console);\n ShuffleProof proof = new ShuffleProof(args.protPath.value(), args.proofPath.value(), sc);\n Verifier ver;\n if (args.threaded.value()) {\n ver = new ThreadedVerifier(sc, proof, ctx.args.threads.value());\n } else {\n ver = new Verifier(sc, proof);\n }\n boolean res = false;\n try {\n res = ver.verify_all();\n } catch (ShuffleException e) {\n console.println(Msg.m_shuffle_proof_failed_reason, e);\n res = false;\n }\n if (res) {\n console.println(Msg.m_shuffle_proof_succeeded);\n } else {\n console.println(Msg.m_shuffle_proof_failed);\n }\n return res;\n }\n}\n" }, { "path": "auditor/src/main/java/ee/ivxv/audit/util/DiscardedBallot.java", "content": "package ee.ivxv.audit.util;\n\nimport com.fasterxml.jackson.annotation.JsonCreator;\nimport com.fasterxml.jackson.annotation.JsonIgnore;\nimport com.fasterxml.jackson.annotation.JsonProperty;\n\nimport java.util.List;\n\npublic class DiscardedBallot {\n private final String election;\n\n private final List discarded;\n\n @JsonCreator\n public DiscardedBallot(\n @JsonProperty(\"election\") String election,\n @JsonProperty(\"invalid\") List invalid) {\n this.election = election;\n this.discarded = invalid;\n }\n\n public List getDiscarded() {\n return discarded;\n }\n\n @JsonIgnore\n public int getCount() {\n return discarded.size();\n }\n\n public static class VoteJson {\n private final String district;\n private final String station;\n private final String question;\n private final byte[] vote;\n\n @JsonCreator\n private VoteJson(\n @JsonProperty(\"district\") String district,\n @JsonProperty(\"station\") String station,\n @JsonProperty(\"question\") String question,\n @JsonProperty(\"vote\") byte[] vote) {\n this.district = district;\n this.station = station;\n this.question = question;\n this.vote = vote;\n }\n\n public byte[] getVote() {\n return vote;\n }\n }\n\n}\n" }, { "path": "auditor/src/main/java/ee/ivxv/audit/util/InvalidDecProofs.java", "content": "package ee.ivxv.audit.util;\n\nimport ee.ivxv.common.crypto.elgamal.ElGamalDecryptionProof;\nimport ee.ivxv.common.model.Proof;\nimport ee.ivxv.common.util.*;\nimport java.nio.file.Path;\nimport java.nio.file.Paths;\nimport java.util.concurrent.BlockingQueue;\nimport java.util.concurrent.Callable;\nimport java.util.concurrent.LinkedBlockingQueue;\n\n/**\n * Class for handling ciphertexts with invalid proofs.\n */\npublic class InvalidDecProofs {\n private static final Path FAILED_PROOF_VALID_PATH = Paths.get(\"failed-validity\");\n private static final Path FAILED_PROOF_INVALID_PATH = Paths.get(\"failed-invalidity\");\n private final BlockingQueue in = new LinkedBlockingQueue<>();\n private final Proof invalidProofs;\n\n /**\n * Initialize using the election identifier.\n *\n * @param electionName\n */\n public InvalidDecProofs(String electionName) {\n invalidProofs = new Proof(electionName);\n }\n\n /**\n * Get the worker for parsing all added proofs.\n *\n * @return\n */\n public InvalidProofHandler getResultWorker() {\n return new InvalidProofHandler();\n }\n\n /**\n * Set the terminator after last added invalid proof.\n */\n public void setEot() {\n in.add(ee.ivxv.common.util.Util.EOT);\n }\n\n /**\n * Add invalid proof.\n *\n * @param proof\n */\n public void addInvalidProof(ElGamalDecryptionProof proof) {\n in.add(proof);\n }\n\n /**\n * Get the total number of invalid proofs.\n *\n * @return\n */\n public int getCount() {\n return invalidProofs.getCount();\n }\n\n /**\n * Serialize the structure to directory.\n *\n * @param outDir\n * @throws Exception\n */\n public void outputFailedProofsOfValidity(Path outDir) throws Exception {\n Json.write(invalidProofs, outDir.resolve(FAILED_PROOF_VALID_PATH));\n }\n\n /**\n * Serialize the structure to directory.\n *\n * @param outDir\n * @throws Exception\n */\n public void outputFailedProofsOfInvalidity(Path outDir) throws Exception {\n Json.write(invalidProofs, outDir.resolve(FAILED_PROOF_INVALID_PATH));\n }\n\n private class InvalidProofHandler implements Callable {\n\n @Override\n public Void call() throws Exception {\n Object obj;\n while ((obj = in.take()) != ee.ivxv.common.util.Util.EOT) {\n if (obj instanceof ElGamalDecryptionProof) {\n invalidProofs.addProof((ElGamalDecryptionProof) obj);\n } else {\n throw new IllegalArgumentException(\n \"Unexpected decryption result type: \" + obj.getClass());\n }\n }\n return null;\n }\n }\n}\n" }, { "path": "auditor/src/main/java/ee/ivxv/audit/util/RawBallotWithDigest.java", "content": "package ee.ivxv.audit.util;\n\nimport ee.ivxv.common.crypto.hash.HashType;\n\n\npublic class RawBallotWithDigest {\n private final String id;\n\n private final byte[] ballot;\n\n private final byte[] rawDigest;\n\n public RawBallotWithDigest(byte[] ballot, String id) {\n this.id = id;\n this.ballot = ballot;\n this.rawDigest = HashType.SHA256.getFunction().digest(ballot);\n }\n\n public String getId() {\n return this.id;\n }\n\n public byte[] getBallot() {\n return this.ballot;\n }\n\n public byte[] getRawDigest() {\n return this.rawDigest;\n }\n}\n" }, { "path": "choices/.gitignore", "content": "bin/\npkg/\n" }, { "path": "choices/Makefile", "content": "include ../common/go/common.mk\n" }, { "path": "choices/README.rst", "content": "================================\n IVXV Internet voting framework\n================================\n-----------------\n Choices service\n-----------------\n\n\n" }, { "path": "choices/cmd/choiceimp/log_desc.go", "content": "package main\n\nconst (\n\t_CHOICES_VERSION_FROM_DB = \"Cannot fetch choices list version from a database\"\n\t_CHOICES_LIST_BDOC_OPEN = \"Failed to open choices list BDOC container\"\n\t_CHOICES_LIST_BDOC_NO_SIG = \"No signatures found in choices list BDOC container\"\n\t_CHOICES_LIST_BDOC_SIG_INFO = \"Choices list BDOC container signature info\"\n\t_CHOICES_LIST_BDOC_SIG_TO_JSON = \"Failed to JSON marshal choices list BDOC container signature\"\n\t_CHOICES_LIST_BDOC_HAS_MANY_FILES = \"Choices list BDOC container should only have 1 file\"\n\t_CHOICES_LIST_READ = \"Reading choices list\"\n\t_CHOICES_LIST_TO_DB_UPLOAD = \"Failed to upload choices list to database\"\n\t_CHOICES_LIST_INVALID_JSON = \"Choices list has an invalid JSON format\"\n\t_CHOICES_LIST_ID_MISMATCH = \"Choices list ID doesn't match the one used in election configuration file\"\n\t_CHOICES_LIST_PREPARE_UPLOAD_TO_DB = \"Choices list is ready to uploaded into database\"\n\t_CHOICES_LIST_UPLOAD_TO_DB_FAIL = \"Unable to upload choices list to database\"\n)\n" }, { "path": "choices/cmd/choiceimp/main.go", "content": "/*\nThe choiceimp application is used for loading choice lists into the storage\nservice.\n*/\npackage main\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"flag\"\n\t\"fmt\"\n\t\"os\"\n\n\t\"ivxv.ee/common/collector/command\"\n\t\"ivxv.ee/common/collector/command/exit\"\n\t\"ivxv.ee/common/collector/command/status\"\n\t\"ivxv.ee/common/collector/conf\"\n\t\"ivxv.ee/common/collector/conf/version\"\n\t\"ivxv.ee/common/collector/errors\"\n\t\"ivxv.ee/common/collector/log\"\n\t\"ivxv.ee/common/collector/storage\"\n\t//ivxv:modules common/collector/container\n\t//ivxv:modules common/collector/storage\n)\n\nconst usage = `choiceimp loads choice lists into the collector's storage service for use by\nother services.\n\nThe choice list container must have an extension corresponding to the container\ntype it is, e.g., choicelist.bdoc.`\n\nvar (\n\tqp = flag.Bool(\"q\", false, \"quiet, do not show progress\")\n\n\tprogress *status.Line\n)\n\nfunc main() {\n\t// Call choiceimpmain in a separate function so that it can set up\n\t// defers and have them trigger before returning with a non-zero exit\n\t// code.\n\tos.Exit(choiceimpmain())\n}\n\nfunc choiceimpmain() (code int) {\n\tc := command.New(\"ivxv-choiceimp\", usage, \"choice list container\")\n\tdefer func() {\n\t\tcode = c.Cleanup(code)\n\t}()\n\n\tif !*qp {\n\t\tprogress = status.New()\n\t}\n\n\t// Only check the version if it was the specific check requested.\n\tif c.Until == command.CheckVersion {\n\t\tversion1, err := c.Storage.GetChoicesVersion(c.Ctx)\n\t\tif err != nil {\n\t\t\tif errors.CausedBy(err, new(storage.NotExistError)) == nil {\n\t\t\t\treturn c.Error(exit.Unavailable, CheckVersionError{Err: err,\n\t\t\t\t\tDescription: _CHOICES_VERSION_FROM_DB},\n\t\t\t\t\t\"failed to check imported list version:\", err)\n\t\t\t}\n\t\t} else {\n\t\t\tfmt.Println(version1)\n\t\t}\n\t}\n\n\tif c.Until < command.CheckInput {\n\t\treturn exit.OK\n\t}\n\tpath := c.Args[0]\n\n\t// Open the choice list container file.\n\tcnt, err := c.Conf.Container.OpenFile(path)\n\tif err != nil {\n\t\tcode = exit.DataErr\n\t\tif perr := errors.CausedBy(err, new(os.PathError)); perr != nil {\n\t\t\tif os.IsNotExist(perr) {\n\t\t\t\tcode = exit.NoInput\n\t\t\t}\n\t\t}\n\t\treturn c.Error(code, OpenContainerError{Container: path, Err: err,\n\t\t\tDescription: _CHOICES_LIST_BDOC_OPEN},\n\t\t\t\"failed to open choice list container:\", err)\n\t}\n\tdefer cnt.Close()\n\n\t// Ensure that the container is signed and log the signatures.\n\tsignatures := cnt.Signatures()\n\tif len(signatures) == 0 {\n\t\treturn c.Error(exit.DataErr, UnsignedContainerError{Container: path,\n\t\t\tDescription: _CHOICES_LIST_BDOC_NO_SIG},\n\t\t\t\"unsigned choice list container\")\n\t}\n\tfor _, s := range signatures {\n\t\tlog.Log(c.Ctx, ContainerSignature{Signer: s.Signer, SigningTime: s.SigningTime,\n\t\t\tDescription: _CHOICES_LIST_BDOC_SIG_INFO})\n\t}\n\n\t// Get the version string of the container.\n\tversion1, err := version.Container(cnt)\n\tif err != nil {\n\t\treturn c.Error(exit.DataErr, ContainerVersionError{Container: path, Err: err,\n\t\t\tDescription: _CHOICES_LIST_BDOC_SIG_TO_JSON},\n\t\t\t\"failed to format container version string:\", err)\n\t}\n\n\t// Check that the container only has a single file.\n\tdata := cnt.Data()\n\tif len(data) != 1 {\n\t\treturn c.Error(exit.DataErr, DataCountError{Count: len(data),\n\t\t\tDescription: _CHOICES_LIST_BDOC_HAS_MANY_FILES},\n\t\t\t\"choice list container has\", len(data), \"files, expected 1\")\n\t}\n\n\t// Process the choice list. We do not know the key, so do a single cycle loop.\n\tfor key, list := range data {\n\t\tlog.Log(c.Ctx, ProcessingList{List: key,\n\t\t\tDescription: _CHOICES_LIST_READ})\n\t\tif err := choiceimp(c.Ctx, c.Until, c.Conf, c.Storage, version1, list); err != nil {\n\t\t\treturn c.Error(exit.Unavailable, ImportChoicesError{Err: err,\n\t\t\t\tDescription: _CHOICES_LIST_TO_DB_UPLOAD},\n\t\t\t\t\"failed to import choice list\", key+\":\", err)\n\t\t}\n\t}\n\treturn exit.OK\n}\n\ntype choicelist struct {\n\tElection string\n\tChoices map[string]json.RawMessage\n}\n\n// choiceimp parses the list of choices and uploads them to the storage\n// service.\nfunc choiceimp(ctx context.Context, until int, c *conf.C, s *storage.Client,\n\tversion string, list []byte) error {\n\n\tvar l choicelist\n\tif err := json.Unmarshal(list, &l); err != nil {\n\t\treturn JSONUnmarshalError{Err: err, Description: _CHOICES_LIST_INVALID_JSON}\n\t}\n\n\t// Ensure that the election identifier matches the configured one.\n\tif l.Election != c.Election.Identifier {\n\t\treturn ElectionIDMismatchError{Conf: c.Election.Identifier, List: l.Election,\n\t\t\tDescription: _CHOICES_LIST_ID_MISMATCH}\n\t}\n\n\tif until >= command.Execute {\n\t\t// Convert map[string]json.RawMessage to map[string][]byte.\n\t\tchoices := make(map[string][]byte)\n\t\tfor id, list := range l.Choices {\n\t\t\tchoices[id] = list\n\t\t}\n\n\t\tlog.Log(ctx, ImportingChoices{Count: len(choices), Description: _CHOICES_LIST_PREPARE_UPLOAD_TO_DB})\n\t\tprogress.Static(fmt.Sprintf(\"Importing %d choices:\", len(choices)))\n\t\taddprogress := progress.Percent(uint64(len(choices)), true)\n\t\tprogress.Redraw()\n\t\tdefer progress.Keep()\n\n\t\tif err := s.PutChoices(ctx, version, choices, addprogress); err != nil {\n\t\t\treturn PutChoicesError{Err: err, Description: _CHOICES_LIST_UPLOAD_TO_DB_FAIL}\n\t\t}\n\t}\n\treturn nil\n}\n" }, { "path": "choices/cmd/districtimp/district_test.go", "content": "package main\n\nimport (\n\t\"testing\"\n\n\t\"ivxv.ee/common/collector/errors\"\n\t\"ivxv.ee/common/collector/storage\"\n)\n\nfunc testDistrictsLookupFormatError(t *testing.T, id string) {\n\tt.Helper()\n\tlist := districtlist{Districts: map[string]district{id: {}}}\n\n\t_, err := districtsLookup(list)\n\tif errors.CausedBy(err, new(DistrictIDFormatError)) == nil {\n\t\tt.Error(\"unexpected success with malformed district code\", id)\n\t}\n}\n\nfunc TestDistrictsLookupFormatError(t *testing.T) {\n\ttestDistrictsLookupFormatError(t, \"0000\")\n\ttestDistrictsLookupFormatError(t, \"0000.\")\n\ttestDistrictsLookupFormatError(t, \".0000\")\n\ttestDistrictsLookupFormatError(t, \"0000.0.0\")\n}\n\nfunc TestDistrictsLookupMultipleCodes(t *testing.T) {\n\tlist := districtlist{\n\t\tDistricts: map[string]district{\n\t\t\t\"0001.1\": {\n\t\t\t\tParish: []string{\"1111\"},\n\t\t\t},\n\t\t\t\"0002.2\": {\n\t\t\t\tParish: []string{\"1111\"},\n\t\t\t},\n\t\t},\n\t}\n\n\t_, err := districtsLookup(list)\n\tif errors.CausedBy(err, new(ParishWithMultipleDistrictCodesError)) == nil {\n\t\tt.Error(\"unexpected success with multiple district codes\")\n\t}\n}\n\nfunc assertDistricts(t *testing.T, districts map[string][]byte,\n\tadminCode, districtNr, districtID string) {\n\n\tt.Helper()\n\tencoded := storage.EncodeAdminDistrict(adminCode, districtNr)\n\tid, ok := districts[string(encoded)]\n\tif !ok {\n\t\tt.Error(\"unexpected error: administrative unit code\", adminCode,\n\t\t\t\"and district number\", districtNr, \"not in districts\")\n\t}\n\tif string(id) != districtID {\n\t\tt.Errorf(\"unexpected district identifier for %s and %s: got %s, want %s\",\n\t\t\tadminCode, districtNr, id, districtID)\n\t}\n}\n\nfunc TestDistrictsLookup(t *testing.T) {\n\tlist := districtlist{\n\t\tDistricts: map[string]district{\n\t\t\t// One-to-one match.\n\t\t\t\"0001.1\": {\n\t\t\t\tParish: []string{\"1111\"},\n\t\t\t},\n\n\t\t\t// District with multiple parishes.\n\t\t\t\"0002.1\": {\n\t\t\t\tParish: []string{\"2222\", \"3333\"},\n\t\t\t},\n\n\t\t\t// Parish with multiple districts.\n\t\t\t\"0004.1\": {\n\t\t\t\tParish: []string{\"4444\"},\n\t\t\t},\n\t\t\t\"0004.2\": {\n\t\t\t\tParish: []string{\"4444\"},\n\t\t\t},\n\t\t},\n\t}\n\n\tdistricts, err := districtsLookup(list)\n\tif err != nil {\n\t\tt.Fatal(err)\n\t}\n\n\tassertDistricts(t, districts, \"1111\", \"1\", \"0001.1\")\n\tassertDistricts(t, districts, \"2222\", \"1\", \"0002.1\")\n\tassertDistricts(t, districts, \"3333\", \"1\", \"0002.1\")\n\tassertDistricts(t, districts, \"4444\", \"1\", \"0004.1\")\n\tassertDistricts(t, districts, \"4444\", \"2\", \"0004.2\")\n}\n" }, { "path": "choices/cmd/districtimp/log_desc.go", "content": "package main\n\nconst (\n\t_DISTRICTS_VERSION_FROM_DB = \"Cannot fetch districts list version from a database\"\n\t_DISTRICTS_LIST_BDOC_OPEN = \"Failed to open district list BDOC container\"\n\t_DISTRICTS_LIST_BDOC_NO_SIG = \"No signatures found in districts list BDOC container\"\n\t_DISTRICTS_LIST_BDOC_SIG_INFO = \"Districts list BDOC container signature info\"\n\t_DISTRICTS_LIST_BDOC_SIG_TO_JSON = \"Failed to JSON marshal districts list BDOC container signature\"\n\t_DISTRICTS_LIST_BDOC_HAS_MANY_FILES = \"Districts list BDOC container should only have 1 file\"\n\t_DISTRICTS_LIST_READ = \"Reading districts list\"\n\t_DISTRICTS_LIST_TO_DB_UPLOAD = \"Failed to upload districts list to database\"\n\t_DISTRICTS_LIST_INVALID_JSON = \"Choices list has an invalid JSON format\"\n\t_DISTRICTS_LIST_ID_MISMATCH = \"Choices list ID doesn't match the one used in election configuration file\"\n\t_DISTRICTS_LIST_INVALID_COUNTIES_JSON = \"District list has an invalid 'counties' JSON\"\n\t_DISTRICTS_LIST_PREPARE_UPLOAD_TO_DB = \"Choices list is ready to uploaded into database\"\n\t_DISTRICTS_LIST_UPLOAD_TO_DB_FAIL = \"Unable to upload districts list to database\"\n\t_DISTRICTS_LIST_INVALID_DISTRICT_ID = \"District ID has an invalid format\"\n\t_DISTRICTS_LIST_PARISH_CONTAINS_SAME_DISTRICT_CODES = \"Only 1 district code is allowed per parish\"\n)\n" }, { "path": "choices/cmd/districtimp/main.go", "content": "/*\nThe districtimp application is used for loading district lists into the storage\nservice.\n*/\npackage main\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"flag\"\n\t\"fmt\"\n\t\"os\"\n\t\"strings\"\n\n\t\"ivxv.ee/common/collector/command\"\n\t\"ivxv.ee/common/collector/command/exit\"\n\t\"ivxv.ee/common/collector/command/status\"\n\t\"ivxv.ee/common/collector/conf\"\n\t\"ivxv.ee/common/collector/conf/version\"\n\t\"ivxv.ee/common/collector/errors\"\n\t\"ivxv.ee/common/collector/log\"\n\t\"ivxv.ee/common/collector/storage\"\n\t//ivxv:modules common/collector/container\n\t//ivxv:modules common/collector/storage\n)\n\nconst usage = `districtimp loads district lists into the collector's storage service for use\nby other services.\n\nThe district list container must have an extension corresponding to the\ncontainer type it is, e.g., choicelist.bdoc.`\n\nvar (\n\tqp = flag.Bool(\"q\", false, \"quiet, do not show progress\")\n\n\tprogress *status.Line\n)\n\nfunc main() {\n\t// Call districtimpmain in a separate function so that it can set up\n\t// defers and have them trigger before returning with a non-zero exit\n\t// code.\n\tos.Exit(districtimpmain())\n}\n\nfunc districtimpmain() (code int) {\n\tc := command.New(\"ivxv-districtimp\", usage, \"district list container\")\n\tdefer func() {\n\t\tcode = c.Cleanup(code)\n\t}()\n\n\tif !*qp {\n\t\tprogress = status.New()\n\t}\n\n\t// Only check the version if it was the specific check requested.\n\tif c.Until == command.CheckVersion {\n\t\tversion1, err := c.Storage.GetDistrictsVersion(c.Ctx)\n\t\tif err != nil {\n\t\t\tif errors.CausedBy(err, new(storage.NotExistError)) == nil {\n\t\t\t\treturn c.Error(exit.Unavailable, CheckVersionError{Err: err,\n\t\t\t\t\tDescription: _DISTRICTS_VERSION_FROM_DB,\n\t\t\t\t},\n\t\t\t\t\t\"failed to check imported list version:\", err)\n\t\t\t}\n\t\t} else {\n\t\t\tfmt.Println(version1)\n\t\t}\n\t}\n\n\tif c.Until < command.CheckInput {\n\t\treturn exit.OK\n\t}\n\tpath := c.Args[0]\n\n\t// Open the district list container file.\n\tcnt, err := c.Conf.Container.OpenFile(path)\n\tif err != nil {\n\t\tcode = exit.DataErr\n\t\tif perr := errors.CausedBy(err, new(os.PathError)); perr != nil {\n\t\t\tif os.IsNotExist(perr) {\n\t\t\t\tcode = exit.NoInput\n\t\t\t}\n\t\t}\n\t\treturn c.Error(code, OpenContainerError{Container: path, Err: err,\n\t\t\tDescription: _DISTRICTS_LIST_BDOC_OPEN},\n\t\t\t\"failed to open district list container:\", err)\n\t}\n\tdefer cnt.Close()\n\n\t// Ensure that the container is signed and log the signatures.\n\tsignatures := cnt.Signatures()\n\tif len(signatures) == 0 {\n\t\treturn c.Error(exit.DataErr, UnsignedContainerError{Container: path,\n\t\t\tDescription: _DISTRICTS_LIST_BDOC_NO_SIG},\n\t\t\t\"unsigned districts list container\")\n\t}\n\tfor _, s := range signatures {\n\t\tlog.Log(c.Ctx, ContainerSignature{Signer: s.Signer, SigningTime: s.SigningTime,\n\t\t\tDescription: _DISTRICTS_LIST_BDOC_SIG_INFO})\n\t}\n\n\t// Get the version string of the container.\n\tversion1, err := version.Container(cnt)\n\tif err != nil {\n\t\treturn c.Error(exit.DataErr, ContainerVersionError{Container: path, Err: err,\n\t\t\tDescription: _DISTRICTS_LIST_BDOC_SIG_TO_JSON},\n\t\t\t\"failed to format container version string:\", err)\n\t}\n\n\t// Check that the container only has a single file.\n\tdata := cnt.Data()\n\tif len(data) != 1 {\n\t\treturn c.Error(exit.DataErr, DataCountError{Count: len(data),\n\t\t\tDescription: _DISTRICTS_LIST_BDOC_HAS_MANY_FILES},\n\t\t\t\"districts list container has\", len(data), \"files, expected 1\")\n\t}\n\n\t// Process the district list. We do not know the key, so do a single cycle loop.\n\tfor key, list := range data {\n\t\tlog.Log(c.Ctx, ProcessingList{List: key, Description: _DISTRICTS_LIST_READ})\n\t\tif err := districtimp(c.Ctx, c.Until, c.Conf, c.Storage, version1, list); err != nil {\n\t\t\treturn c.Error(exit.Unavailable, ImportDistrictsError{Err: err,\n\t\t\t\tDescription: _DISTRICTS_LIST_TO_DB_UPLOAD},\n\t\t\t\t\"failed to import district list\", key+\":\", err)\n\t\t}\n\t}\n\treturn exit.OK\n}\n\ntype districtlist struct {\n\tElection string\n\tDistricts map[string]district\n\tCounties json.RawMessage\n}\n\ntype district struct {\n\tName string\n\tParish []string\n}\n\n// districtimp parses the districts list and uploads data from it to the\n// storage service.\nfunc districtimp(ctx context.Context, until int, c *conf.C, s *storage.Client,\n\tversion string, list []byte) error {\n\n\tvar l districtlist\n\tif err := json.Unmarshal(list, &l); err != nil {\n\t\treturn JSONUnmarshalError{Err: err, Description: _DISTRICTS_LIST_INVALID_JSON}\n\t}\n\n\t// Ensure that the election identifier matches the configured one.\n\tif l.Election != c.Election.Identifier {\n\t\treturn ElectionIDMismatchError{Conf: c.Election.Identifier, List: l.Election,\n\t\t\tDescription: _DISTRICTS_LIST_ID_MISMATCH}\n\t}\n\n\t// Convert districts to lookup table where a administrative unit code\n\t// and district number map to the district identifier.\n\tdistricts, err := districtsLookup(l)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\t// Although Counties is stored as-is, ensure that it is of expected\n\t// type, i.e., a JSON object with string array values.\n\tvar counties map[string][]string\n\tif err := json.Unmarshal(l.Counties, &counties); err != nil {\n\t\treturn JSONUnmarshalCountiesError{Err: err, Description: _DISTRICTS_LIST_INVALID_COUNTIES_JSON}\n\t}\n\n\tif until >= command.Execute {\n\t\tlog.Log(ctx, ImportingDistricts{Count: len(l.Districts),\n\t\t\tDescription: _DISTRICTS_LIST_PREPARE_UPLOAD_TO_DB})\n\t\tprogress.Static(fmt.Sprintf(\"Importing %d districts:\", len(l.Districts)))\n\t\taddprogress := progress.Percent(uint64(len(districts)), true)\n\t\tprogress.Redraw()\n\t\tdefer progress.Keep()\n\n\t\terr := s.PutDistricts(ctx, version, districts, l.Counties, addprogress)\n\t\tif err != nil {\n\t\t\treturn PutDistrictsError{Err: err, Description: _DISTRICTS_LIST_UPLOAD_TO_DB_FAIL}\n\t\t}\n\t}\n\treturn nil\n}\n\n// districtsLookup converts the districts from a district list to a lookup\n// table from an administrative unit code and district number to a district\n// identifier.\nfunc districtsLookup(list districtlist) (map[string][]byte, error) {\n\tdistricts := make(map[string][]byte)\n\tparishCodes := make(map[string]string)\n\tfor id, district := range list.Districts {\n\t\tsplits := strings.Split(id, \".\")\n\t\tif len(splits) != 2 || len(splits[0]) == 0 || len(splits[1]) == 0 {\n\t\t\t// Must contain a single period, but not first or last.\n\t\t\treturn nil, DistrictIDFormatError{District: id,\n\t\t\t\tDescription: _DISTRICTS_LIST_INVALID_DISTRICT_ID}\n\t\t}\n\t\tcode, nr := splits[0], splits[1]\n\n\t\tfor _, parish := range district.Parish {\n\t\t\tif parishCode, ok := parishCodes[parish]; ok && code != parishCode {\n\t\t\t\treturn nil, ParishWithMultipleDistrictCodesError{First: parishCode, Second: code,\n\t\t\t\t\tDescription: _DISTRICTS_LIST_PARISH_CONTAINS_SAME_DISTRICT_CODES,\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tdistricts[string(storage.EncodeAdminDistrict(parish, nr))] = []byte(id)\n\t\t\tparishCodes[parish] = code\n\t\t}\n\t}\n\treturn districts, nil\n}\n" }, { "path": "choices/cmd/voterimp/container.go", "content": "package main\n\nimport (\n\t\"archive/zip\"\n\t\"encoding/json\"\n\t\"io\"\n\t\"path/filepath\"\n\t\"regexp\"\n\n\t\"ivxv.ee/common/collector/conf/version\"\n\t\"ivxv.ee/common/collector/container\"\n\t\"ivxv.ee/common/collector/errors\"\n)\n\n// openContainer attemps to open path as a trusted signed container using\n// opener, but if this fails because it is an unknown type, then it opens it as\n// an untrusted ZIP-archive mimicing the container interface.\nfunc openContainer(opener container.Opener, path string) (\n\tcnt container.Container, trusted bool, err error) {\n\n\tcnt, err = opener.OpenFile(path)\n\tif errors.CausedBy(err, new(container.UnconfiguredTypeError)) == nil {\n\t\treturn cnt, true, err\n\t}\n\n\t// OpenFile failed because it was an unknown type: check if it is ZIP.\n\tif filepath.Ext(path) != \".zip\" {\n\t\treturn nil, false, err // Return the UnconfiguredTypeError.\n\t}\n\n\tarchive, err := zip.OpenReader(path)\n\tif err != nil {\n\t\treturn nil, false, OpenZIPContainerError{Err: err, Description: _VOTERS_LIST_OPEN_ZIP_CONTAINER}\n\t}\n\tdefer archive.Close()\n\n\tdata := make(map[string][]byte, len(archive.File))\n\tfor _, file := range archive.File {\n\t\trc, err := file.Open()\n\t\tif err != nil {\n\t\t\treturn nil, false, OpenZIPFileError{File: file.Name, Err: err,\n\t\t\t\tDescription: _VOTERS_LIST_OPEN_ZIPPED_FILE}\n\t\t}\n\t\tdefer rc.Close()\n\n\t\tbytes, err := io.ReadAll(rc)\n\t\tif err != nil {\n\t\t\treturn nil, false, ReadZIPFileError{File: file.Name, Err: err,\n\t\t\t\tDescription: _VOTERS_LIST_READ_ZIPPED_FILE}\n\t\t}\n\t\tdata[file.Name] = bytes\n\t}\n\n\treturn zipContainer{\n\t\tcomment: archive.Comment,\n\t\tdata: data,\n\t}, false, nil\n}\n\ntype zipContainer struct {\n\tcomment string\n\tdata map[string][]byte\n}\n\n// Close does nothing, because there are no resources to manually free.\nfunc (z zipContainer) Close() error {\n\treturn nil\n}\n\n// Signatures returns an empty slice since the container is not signed.\nfunc (z zipContainer) Signatures() []container.Signature {\n\treturn nil\n}\n\n// Data returns the container data from the ZIP-archive.\nfunc (z zipContainer) Data() map[string][]byte {\n\treturn z.data\n}\n\nvar containerVersionRE = regexp.MustCompile(\"(?m)^Version: +(.+)$\")\n\n// containerVersion returns a container's version string. If the container is a\n// trusted signed container, then it calls version.Container, otherwise it\n// parses version metadata from the ZIP-archive comments.\nfunc containerVersion(cnt container.Container) (string, error) {\n\tz, ok := cnt.(zipContainer)\n\tif !ok {\n\t\treturn version.Container(cnt)\n\t}\n\n\tmatches := containerVersionRE.FindAllStringSubmatch(z.comment, -1)\n\tif len(matches) == 0 {\n\t\treturn \"\", MissingZIPVersionError{Description: _VOTERS_LIST_UNABLE_TO_EXTRACT_ZIP_VERSION}\n\t}\n\tversions := make([]string, len(matches))\n\tfor i, match := range matches {\n\t\tversions[i] = match[1] // The first submatch is the version string.\n\t}\n\tversion, err := json.Marshal(versions)\n\treturn string(version), err\n}\n" }, { "path": "choices/cmd/voterimp/log_desc.go", "content": "package main\n\nconst (\n\t_VOTERS_LIST_OPEN_ZIP_CONTAINER = \"Failed to open .zip container with .utf and .sig files\"\n\t_VOTERS_LIST_OPEN_ZIPPED_FILE = \"Cannot open a file from .zip container\"\n\t_VOTERS_LIST_READ_ZIPPED_FILE = \"Failed to read a file from .zip container\"\n\t_VOTERS_LIST_UNABLE_TO_EXTRACT_ZIP_VERSION = \".zip container doesn't have a version\"\n\t_VOTERS_LIST_VERSION_FROM_DB = \"Cannot fetch voters list version from a database\"\n\t_VOTERS_LIST_VERSION_TO_JSON = \"Cannot JSON marshal voters list version\"\n\t_VOTERS_LIST_BDOC_OPEN = \"Failed to open voters list BDOC container\"\n\t_VOTERS_LIST_BDOC_NO_SIG = \"No signatures found in voters list BDOC container\"\n\t_VOTERS_LIST_BDOC_SIG_INFO = \"Districts list BDOC container signature info\"\n\t_VOTERS_LIST_BDOC_SIG_TO_JSON = \"Failed to JSON marshal voters list BDOC container signature\"\n\t_VOTERS_LIST_BDOC_INVALID_DATA = \"Voters list BDOC container has invalid data\"\n\t_VOTERS_LIST_UTF_AND_SIG_VERIFY = \".sig signature doesn't correspond to .utf\"\n\t_VOTERS_LIST_CURRENT_VERSION = \"Fetched from a database current voters list version\"\n\t_VOTERS_LIST_CREATE_MAP_OF_ALL_CHANGES = \"Failed to construct a map of all voters list being used so far\"\n\t_VOTERS_LIST_TO_DB_UPLOAD = \"Uploading voters list to database\"\n\t_VOTERS_LIST_TO_DB_UPLOAD_FAIL = \"Failed to upload voters list to database\"\n\t_VOTERS_LIST_BDOC_HAS_MORE_THAN_2_FILES = \"Voters list BDOC container doesn't have exactly 2 files (.utf and .sig)\"\n\t_VOTERS_LIST_NO_UTF_FILE = \"Voters list BDOC container doesn't have a .utf file\"\n\t_VOTERS_LIST_NO_SIG_FILE = \"Voters list BDOC container doesn't have a .sig file\"\n\t_VOTERS_LIST_PUB_KEY_INVALID_PEM = \"Voters list public key is invalid PEM\"\n\t_VOTERS_LIST_PUB_KEY_INVALID_PKIX = \"Voters list public key, after PEM decoding, is invalid PKIX\"\n\t_VOTERS_LIST_PUB_KEY_INVALID_ECDSA = \"Voters list public key algorithm is not ECDSA\"\n\t_VOTERS_LIST_ASN1_SIG_ASN1_UNMARSHAL = \"Cannot ASN.1 unmarshal .sig content\"\n\t_VOTERS_LIST_SIG_VERIFY_FAIL = \"Failed to verify .sig content with voters list public key\"\n\t_VOTERS_LIST_READ = \"Reading voters list\"\n\t_VOTERS_LIST_READ_CTX_CANCEL = \"Context has been cancelled during voters list reading\"\n\t_VOTERS_LIST_UTF_INVALID_COLUMNS_COUNT = \".utf has invalid columns count\"\n\t_VOTERS_LIST_UTF_UNKNOWN_COLUMN = \".utf contains unknown column\"\n\t_VOTERS_LIST_READING_ERRORS = \"Report of all errors occurred during voters file reading\"\n\t_VOTERS_LIST_READING_ERRORS_COUNT = \"Report errors count during voters file reading\"\n\t_VOTERS_LIST_READ_UTF_FORMAT_VERSION = \"Failed to read .utf format version\"\n\t_VOTERS_LIST_UTF_FORMAT_VERSION = \"Invalid .utf format version\"\n\t_VOTERS_LIST_READ_UTF_ELECTION_ID = \"Failed to read .utf election ID\"\n\t_VOTERS_LIST_UTF_ELECTION_ID = \".utf election ID doesn't match the one in election configuration file\"\n\t_VOTERS_LIST_READ_UTF_VOTERS_LIST_VERSION = \"Failed to read .utf voters list version\"\n\t_VOTERS_LIST_UTF_VOTERS_LIST_VERSION = \".utf voters list version is not a base-10 integer\"\n\t_VOTERS_LIST_UTF_VOTERS_LIST_VERSION_0 = \"Current .utf voters list to be uploaded has a version of 0, however such version already exists\"\n\t_VOTERS_LIST_INITIAL_NOT_UPLOADED_YET = \"Voters list with version 0 (initial) hasn't been yet uploaded\"\n\t_VOTERS_LIST_UPLOAD_OLD_VERSION = \"Trying to upload old voters list version\"\n\t_VOTERS_LIST_READ_ELECTION_FROM_PERIOD = \"Failed to read .utf election 'from' period\"\n\t_VOTERS_LIST_ELECTION_FROM_PERIOD = \".utf election 'from' value is not a RFC3339 timestamp\"\n\t_VOTERS_LIST_READ_ELECTION_TO_PERIOD = \"Failed to read .utf election 'to' period\"\n\t_VOTERS_LIST_ELECTION_TO_PERIOD = \".utf election 'to' value is not a RFC3339 timestamp\"\n\t_VOTERS_LIST_UTF_VOTER_ID_EMPTY = \".utf voters list contains empty voter ID\"\n\t_VOTERS_LIST_UTF_INITIAL_ACTION = \".utf voters list initial action should be 'lisamine'\"\n\t_VOTERS_LIST_UTF_ADMIN_CODE_EMPTY = \".utf voters list contains empty admin code\"\n\t_VOTERS_LIST_UTF_DISTRICT_EMPTY = \".utf voters list contains empty district\"\n\t_VOTERS_LIST_UTF_ADD_SAME_VOTER = \".utf voters list attempts to add ('lisamine' action) same voters multiple time\"\n\t_VOTERS_LIST_MODIFY_WITH_PREVIOUS_ERRORS = \"Trying to process next line of voters list, but previous line was rejected with errors\"\n\t_VOTERS_LIST_GET_VOTER_FROM_DB = \"Cannot fetch voter ID from database\"\n\t_VOTERS_LIST_NON_EXISTING_VOTER = \"Voter doesn't exist in a database\"\n\t_VOTERS_LIST_DELETE_JUST_ADDED_VOTER = \"Voters list has 'lisamine' and then 'kustutamine' action for the same voter\"\n\t_VOTERS_LIST_UNKNOWN_ACTION = \"Voters list contains unknown action type\"\n\t_VOTERS_LIST_READ_FILE_PROGRESS = \"Reading voters file progress info\"\n\t_VOTERS_LIST_READ_LINE_ERROR = \"Cannot read voters file line\"\n\t_VOTERS_LIST_UTF_COLUMNS_COUNT = \"Voters file has invalid columns count for a given row\"\n)\n" }, { "path": "choices/cmd/voterimp/main.go", "content": "/*\nThe voterimp application is used for loading voter lists into the storage\nservice.\n\nThe voter list is generated and signed by the Estonian Election Information\nSystem and contains Estonian strings, so the format is very specific to\nEstonia. voterimp checks the raw ECDSA signature with SHA-256 digest, parses\nthe contents of the voter list, and adds a new version of voter information\ninto the storage service.\n*/\npackage main\n\nimport (\n\t\"bytes\"\n\t\"context\"\n\t\"crypto/ecdsa\"\n\t\"crypto/sha256\"\n\t\"crypto/x509\"\n\t\"encoding/json\"\n\t\"flag\"\n\t\"fmt\"\n\t\"io\"\n\t\"os\"\n\t\"strconv\"\n\t\"strings\"\n\t\"time\"\n\n\t\"ivxv.ee/common/collector/command\"\n\t\"ivxv.ee/common/collector/command/exit\"\n\t\"ivxv.ee/common/collector/command/status\"\n\t\"ivxv.ee/common/collector/cryptoutil\"\n\t\"ivxv.ee/common/collector/errors\"\n\t\"ivxv.ee/common/collector/log\"\n\t\"ivxv.ee/common/collector/storage\"\n\t//ivxv:modules common/collector/container\n\t//ivxv:modules common/collector/storage\n)\n\nconst usage = `voterimp loads voter lists into the collector's storage service for use by\nother services.\n\nThe voter list container must contain exactly two files: the voter list and the\nvoter list signature. The key for the voter list can be anything, but the key\nfor the signature must be the list key with a \".signature\" suffix. E.g.,\n\"voter.list\" and \"voter.list.signature\".\n\nThe voter list container must have an extension corresponding to the container\ntype it is, e.g., voterlist.bdoc. voterimp additionally supports unsigned ZIP\ncontainers with metadata stored in the archive comment.`\n\nvar (\n\tqp = flag.Bool(\"q\", false, \"quiet, do not show progress\")\n\n\tprogress *status.Line\n)\n\nfunc main() {\n\t// Call voterimpmain in a separate function so that it can set up\n\t// defers and have them trigger before returning with a non-zero exit\n\t// code.\n\tos.Exit(voterimpmain())\n}\n\nfunc voterimpmain() (code int) {\n\tc := command.New(\"ivxv-voterimp\", usage, \"voter list container\")\n\tdefer func() {\n\t\tcode = c.Cleanup(code)\n\t}()\n\n\tif !*qp {\n\t\tprogress = status.New()\n\t}\n\n\t// Only check the version if it was the specific check requested.\n\tif c.Until == command.CheckVersion {\n\t\tversion, err := c.Storage.GetVotersContainerVersions(c.Ctx)\n\t\tif err != nil {\n\t\t\tif errors.CausedBy(err, new(storage.NotExistError)) == nil {\n\t\t\t\treturn c.Error(exit.Unavailable, CheckVersionError{Err: err,\n\t\t\t\t\tDescription: _VOTERS_LIST_VERSION_FROM_DB},\n\t\t\t\t\t\"failed to check imported container versions:\", err)\n\t\t\t}\n\t\t} else {\n\t\t\t// Convert from new-line separation to JSON array.\n\t\t\tvar vers []json.RawMessage\n\t\t\tfor _, ver := range strings.Split(strings.TrimSpace(version), \"\\n\") {\n\t\t\t\tvers = append(vers, json.RawMessage(ver))\n\t\t\t}\n\t\t\tif err := json.NewEncoder(os.Stdout).Encode(vers); err != nil {\n\t\t\t\treturn c.Error(exit.Unavailable, ConvertVersionError{Err: err,\n\t\t\t\t\tDescription: _VOTERS_LIST_VERSION_TO_JSON},\n\t\t\t\t\t\"failed to encode container versions:\", err)\n\t\t\t}\n\t\t}\n\t}\n\n\tif c.Until < command.CheckInput {\n\t\treturn exit.OK\n\t}\n\tpath := c.Args[0]\n\n\t// Open the voter list container file.\n\tcnt, trusted, err := openContainer(c.Conf.Container, path)\n\tif err != nil {\n\t\tcode = exit.DataErr\n\t\tif perr := errors.CausedBy(err, new(os.PathError)); perr != nil {\n\t\t\tif os.IsNotExist(perr) {\n\t\t\t\tcode = exit.NoInput\n\t\t\t}\n\t\t}\n\t\treturn c.Error(code, OpenContainerError{Container: path, Err: err,\n\t\t\tDescription: _VOTERS_LIST_BDOC_OPEN},\n\t\t\t\"failed to open voter list container:\", err)\n\t}\n\tdefer cnt.Close()\n\n\t// Ensure that a trusted container is signed and log the signatures.\n\tsignatures := cnt.Signatures()\n\tif trusted && len(signatures) == 0 {\n\t\treturn c.Error(exit.DataErr, UnsignedContainerError{Container: path,\n\t\t\tDescription: _VOTERS_LIST_BDOC_NO_SIG},\n\t\t\t\"unsigned voter list container\")\n\t}\n\tfor _, s := range signatures {\n\t\tlog.Log(c.Ctx, ContainerSignature{\n\t\t\tSigner: s.Signer,\n\t\t\tSigningTime: s.SigningTime,\n\t\t\tDescription: _VOTERS_LIST_BDOC_SIG_INFO,\n\t\t})\n\t}\n\n\t// Get the version string of the container.\n\tcversion, err := containerVersion(cnt)\n\tif err != nil {\n\t\treturn c.Error(exit.DataErr, ContainerVersionError{Container: path,\n\t\t\tErr: err, Description: _VOTERS_LIST_BDOC_SIG_TO_JSON},\n\t\t\t\"failed to format container version string:\", err)\n\t}\n\n\t// Get the contents of the container.\n\tlist, sig, err := containerData(cnt.Data())\n\tif err != nil {\n\t\treturn c.Error(exit.DataErr, ContainerDataError{Err: err,\n\t\t\tDescription: _VOTERS_LIST_BDOC_INVALID_DATA},\n\t\t\t\"failed to find expected data from container:\", err)\n\t}\n\n\t// Check the signature.\n\tif err = verifyECDSA(c.Conf.Election.VoterList.Key, list, sig); err != nil {\n\t\treturn c.Error(exit.DataErr, VerifySignatureError{Err: err,\n\t\t\tDescription: _VOTERS_LIST_UTF_AND_SIG_VERIFY},\n\t\t\t\"failed to verify voter list signature:\", err)\n\t}\n\n\t// Get the current voter list version.\n\toldver, err := c.Storage.GetVotersListVersion(c.Ctx)\n\tswitch {\n\tcase err == nil:\n\t\tlog.Log(c.Ctx, CurrentVoterListVersion{Version: oldver,\n\t\t\tDescription: _VOTERS_LIST_CURRENT_VERSION})\n\tcase errors.CausedBy(err, new(storage.NotExistError)) != nil:\n\t\toldver = \"\" // Do not rely on storage returning zero value on error.\n\tdefault:\n\t\treturn c.Error(exit.Unavailable, CheckListVersionError{Err: err,\n\t\t\tDescription: _VOTERS_LIST_VERSION_FROM_DB},\n\t\t\t\"failed to check current list version:\", err)\n\t}\n\n\t// Parse the voter list and preprocess into a map of changes.\n\tvoters, newver, err := preprocess(c.Ctx, list, oldver, c.Conf.Election.Identifier, c.Storage)\n\tif err != nil {\n\t\treturn c.Error(exit.DataErr, PreprocessVotersError{Err: err,\n\t\t\tDescription: _VOTERS_LIST_CREATE_MAP_OF_ALL_CHANGES},\n\t\t\t\"failed to preprocess voter list:\", err)\n\t}\n\n\t// Store the new list.\n\tif c.Until >= command.Execute {\n\t\tlog.Log(c.Ctx, ImportingVoters{Version: newver, Count: len(voters),\n\t\t\tDescription: _VOTERS_LIST_TO_DB_UPLOAD})\n\t\tprogress.Static(fmt.Sprintf(\"Importing %d voters:\", len(voters)))\n\t\taddprogress := progress.Percent(uint64(len(voters)), true)\n\t\tprogress.Redraw()\n\t\tdefer progress.Keep()\n\n\t\tif err := c.Storage.PutVoters(c.Ctx, cversion, voters,\n\t\t\toldver, newver, addprogress); err != nil {\n\n\t\t\treturn c.Error(exit.Unavailable, PutVotersError{Err: err,\n\t\t\t\tDescription: _VOTERS_LIST_TO_DB_UPLOAD_FAIL},\n\t\t\t\t\"failed to import voter list:\", err)\n\t\t}\n\t}\n\treturn exit.OK\n}\n\n// containerData returns voter list and signature contents from container data.\nfunc containerData(data map[string][]byte) (list, signature []byte, err error) {\n\t// The container data should have exactly two keys: *.utf and *.sig.\n\t// Although the files are usually named more specifically\n\t//\n\t// -voters-.{utf,sig},\n\t//\n\t// do not enforce this.\n\tconst utf = \".utf\"\n\tconst sig = \".sig\"\n\n\tif len(data) != 2 {\n\t\treturn nil, nil, KeyCountError{Count: len(data),\n\t\t\tDescription: _VOTERS_LIST_BDOC_HAS_MORE_THAN_2_FILES}\n\t}\n\tvar utfKey, sigKey string\n\tfor key, content := range data {\n\t\tif strings.HasSuffix(key, utf) {\n\t\t\tutfKey = key\n\t\t\tlist = content\n\t\t\tsigKey = key[:len(key)-len(utf)] + sig\n\t\t\tbreak\n\t\t}\n\t}\n\tif len(utfKey) == 0 {\n\t\treturn nil, nil, MissingUTFKeyError{\n\t\t\tDescription: _VOTERS_LIST_NO_UTF_FILE,\n\t\t}\n\t}\n\tsignature, ok := data[sigKey]\n\tif !ok {\n\t\treturn nil, nil, MissingSigKeyError{Expected: sigKey,\n\t\t\tDescription: _VOTERS_LIST_NO_SIG_FILE}\n\t}\n\n\treturn list, signature, nil\n}\n\n// verifyECDSA parses an ECDSA public key from a PEM-encoded X.509 structure\n// and verifies the signature sig on data.\nfunc verifyECDSA(pub string, data, sig []byte) error {\n\tder, err := cryptoutil.PEMDecode(pub, \"PUBLIC KEY\")\n\tif err != nil {\n\t\treturn ECDSAPEMDecodeError{Err: err, Description: _VOTERS_LIST_PUB_KEY_INVALID_PEM}\n\t}\n\tparsed, err := x509.ParsePKIXPublicKey(der)\n\tif err != nil {\n\t\treturn ECDSAParsePKIXError{Err: err,\n\t\t\tDescription: _VOTERS_LIST_PUB_KEY_INVALID_PKIX}\n\t}\n\tkey, ok := parsed.(*ecdsa.PublicKey)\n\tif !ok {\n\t\treturn ECDSAPublicKeyNotECDSAError{Type: fmt.Sprintf(\"%T\", parsed),\n\t\t\tDescription: _VOTERS_LIST_PUB_KEY_INVALID_ECDSA}\n\t}\n\n\thashed := sha256.Sum256(data) // Hardcoded regardless of key parameters.\n\tr, s, err := cryptoutil.ParseECDSAASN1Signature(sig)\n\tif err != nil {\n\t\treturn ECDSAParseSignatureError{Err: err,\n\t\t\tDescription: _VOTERS_LIST_ASN1_SIG_ASN1_UNMARSHAL}\n\t}\n\tif !ecdsa.Verify(key, hashed[:], r, s) {\n\t\treturn ECDSASignatureVerificationError{Description: _VOTERS_LIST_SIG_VERIFY_FAIL}\n\t}\n\treturn nil\n}\n\nconst (\n\tdelim = '\\n'\n\tsep = '\\t'\n)\n\n// linefunc is the type of functions used to process voter lines. Given a\n// voter, action, administrative unit code and district number, it reports any\n// problems or if there were none, adds an entry for voter into voters.\n// previousErrors indicates if there were previous lines with errors for this\n// voter. version is the currently applied voter list version.\ntype linefunc func(ctx context.Context, voter, action, adminCode, district string,\n\tvoters map[string][]byte, previousErrors bool, version string, s *storage.Client) (\n\terrs []error)\n\n// preprocess parses the list and preprocesses the changes for storage.\nfunc preprocess(ctx context.Context, list []byte, version, election string, s *storage.Client) (\n\tvoters map[string][]byte, newver string, err error) {\n\n\tb := bytes.NewBuffer(list)\n\n\t// Parse the header to determine list version and type.\n\tnewver, lf, err := header(b, election, version)\n\tif err != nil {\n\t\treturn nil, \"\", err\n\t}\n\n\t// Loop over all list entries, calling lf for each. Report progress of\n\t// this process.\n\tlog.Log(ctx, PreprocessingVoterList{Version: newver,\n\t\tDescription: _VOTERS_LIST_READ})\n\tprogress.Static(\"Preprocessing voter list:\")\n\taddcount := progress.Count(0, false) // Do not redraw every time.\n\tconst countstep = 10000 // Redraw after each countstep.\n\tprogress.Redraw()\n\tdefer progress.Keep()\n\n\tvoters = make(map[string][]byte)\n\twithErrors := make(map[string]struct{}) // Voters with previous errors.\n\tvar errcount int\n\n\tline := 3 // Voter entries start after the third line.\nloop:\n\tfor ; ; stepadd(ctx, addcount, 1, countstep) {\n\t\t// Check if preprocessing was cancelled.\n\t\tselect {\n\t\tcase <-ctx.Done():\n\t\t\treturn nil, \"\", PreprocessVoterListCanceled{\n\t\t\t\tErr: ctx.Err(), Description: _VOTERS_LIST_READ_CTX_CANCEL}\n\t\tdefault:\n\t\t}\n\n\t\t// Read the next line.\n\t\tline++\n\t\taction, voter, adminCode, district, err := next(b)\n\t\tswitch {\n\t\tcase err == nil:\n\t\tcase err == io.EOF:\n\t\t\tbreak loop\n\t\tcase errors.CausedBy(err, new(FieldCountError)) != nil:\n\t\t\treport(ctx, VoterEntryFormatError{Line: line, Err: err,\n\t\t\t\tDescription: _VOTERS_LIST_UTF_INVALID_COLUMNS_COUNT})\n\t\t\terrcount++\n\t\t\tcontinue loop\n\t\tdefault:\n\t\t\treport(ctx, ReadVoterEntryError{Line: line, Err: err,\n\t\t\t\tDescription: _VOTERS_LIST_UTF_UNKNOWN_COLUMN})\n\t\t\terrcount++\n\t\t\tbreak loop\n\t\t}\n\n\t\t// Call lf for the line.\n\t\t_, previous := withErrors[voter]\n\t\terrs := lf(ctx, voter, action, adminCode, district, voters, previous, version, s)\n\t\tif len(errs) > 0 {\n\t\t\twithErrors[voter] = struct{}{}\n\t\t}\n\t\tfor _, err = range errs {\n\t\t\treport(ctx, PreprocessVoterEntryError{Line: line, Err: err,\n\t\t\t\tDescription: _VOTERS_LIST_READING_ERRORS})\n\t\t\terrcount++\n\t\t}\n\t}\n\t// Report final count if not already done by stepadd.\n\tif addcount(0)%countstep > 0 {\n\t\tstepadd(ctx, addcount, 0, 0)\n\t}\n\tif errcount > 0 {\n\t\treturn nil, \"\", PreprocessVoterListError{\n\t\t\tErrorCount: errcount, Description: _VOTERS_LIST_READING_ERRORS_COUNT}\n\t}\n\treturn voters, newver, nil\n}\n\nfunc header(b *bytes.Buffer, election, oldver string) (newver string, lf linefunc, err error) {\n\t// First line is the format version number, which must be 2.\n\tfver, err := readString(b, delim)\n\tif err != nil {\n\t\treturn \"\", nil, ReadFileVersionError{Err: err,\n\t\t\tDescription: _VOTERS_LIST_UTF_FORMAT_VERSION}\n\t}\n\tif fver != \"2\" {\n\t\treturn \"\", nil, FileVersionError{Version: fver,\n\t\t\tDescription: _VOTERS_LIST_READ_UTF_FORMAT_VERSION}\n\t}\n\n\t// Second is the election identifier. Must match the one in the election\n\t// configuration.\n\telid, err := readString(b, delim)\n\tif err != nil {\n\t\treturn \"\", nil, ReadElectionIDError{Err: err,\n\t\t\tDescription: _VOTERS_LIST_READ_UTF_ELECTION_ID}\n\t}\n\tif elid != election {\n\t\treturn \"\", nil, ElectionIDMismatchError{Conf: election,\n\t\t\tList: elid, Description: _VOTERS_LIST_UTF_ELECTION_ID}\n\t}\n\n\t// Third is the list version number.\n\tnewver, err = readString(b, delim)\n\tif err != nil {\n\t\treturn \"\", nil, ReadListVersionError{Err: err,\n\t\t\tDescription: _VOTERS_LIST_READ_UTF_VOTERS_LIST_VERSION}\n\t}\n\tnewver64, err := strconv.ParseUint(newver, 10, 64)\n\tif err != nil {\n\t\treturn \"\", nil, ParseListVersionError{Err: err,\n\t\t\tDescription: _VOTERS_LIST_UTF_VOTERS_LIST_VERSION}\n\t}\n\tif newver64 == 0 {\n\t\tif len(oldver) > 0 {\n\t\t\treturn \"\", nil, VoterListExistsError{Version: oldver,\n\t\t\t\tDescription: _VOTERS_LIST_UTF_VOTERS_LIST_VERSION_0}\n\t\t}\n\t\tlf = initial\n\t} else {\n\t\tvar oldver64 uint64\n\t\tif len(oldver) == 0 {\n\t\t\treturn \"\", nil, NoExistingVoterListError{\n\t\t\t\tDescription: _VOTERS_LIST_INITIAL_NOT_UPLOADED_YET}\n\t\t} else if oldver64, err = strconv.ParseUint(oldver, 10, 64); err != nil {\n\t\t\treturn \"\", nil, ParseCurrentListVersionError{Err: err,\n\t\t\t\tDescription: _VOTERS_LIST_UTF_VOTERS_LIST_VERSION}\n\t\t} else if oldver64 >= newver64 {\n\t\t\treturn \"\", nil, UnexpectedListVersionError{\n\t\t\t\tCurrent: oldver64,\n\t\t\t\tList: newver64,\n\t\t\t\tDescription: _VOTERS_LIST_UPLOAD_OLD_VERSION,\n\t\t\t}\n\t\t}\n\t\tlf = changes\n\t}\n\n\t// Fourth are two timestamps representing the period. Not used by the\n\t// collector, but make sure that the format is valid.\n\tfromstr, err := readString(b, sep)\n\tif err != nil {\n\t\treturn \"\", nil, ReadPeriodFromError{Err: err,\n\t\t\tDescription: _VOTERS_LIST_READ_ELECTION_FROM_PERIOD}\n\t}\n\tif _, err = time.Parse(time.RFC3339, fromstr); err != nil {\n\t\treturn \"\", nil, ParsePeriodFromError{Err: err,\n\t\t\tDescription: _VOTERS_LIST_ELECTION_FROM_PERIOD}\n\t}\n\ttostr, err := readString(b, delim)\n\tif err != nil {\n\t\treturn \"\", nil, ReadPeriodToError{Err: err,\n\t\t\tDescription: _VOTERS_LIST_READ_ELECTION_TO_PERIOD}\n\t}\n\tif _, err = time.Parse(time.RFC3339, tostr); err != nil {\n\t\treturn \"\", nil, ParsePeriodToError{Err: err,\n\t\t\tDescription: _VOTERS_LIST_ELECTION_TO_PERIOD}\n\t}\n\n\treturn newver, lf, nil\n}\n\nfunc initial(_ context.Context, voter, action, adminCode, district string,\n\tvoters map[string][]byte, _ bool, _ string, _ *storage.Client) (\n\terrs []error) {\n\n\t// Skip duplicate checking if there are relevant errors. We want to\n\t// check duplicates even if the voter had previous errors, so use a\n\t// flag separate from previousErrors.\n\tvar skip bool\n\n\tif len(voter) == 0 {\n\t\terrs = append(errs, InitialEmptyVoterError{Description: _VOTERS_LIST_UTF_VOTER_ID_EMPTY})\n\t\tskip = true\n\t}\n\tif action != \"lisamine\" {\n\t\terrs = append(errs, InitialNonAddActionError{Action: action,\n\t\t\tDescription: _VOTERS_LIST_UTF_INITIAL_ACTION})\n\t\tskip = true\n\t}\n\tif len(adminCode) == 0 {\n\t\terrs = append(errs, InitialEmptyAdminUnitCodeError{\n\t\t\tDescription: _VOTERS_LIST_UTF_ADMIN_CODE_EMPTY,\n\t\t})\n\t}\n\tif len(district) == 0 {\n\t\terrs = append(errs, InitialEmptyDistrictNumberError{\n\t\t\tDescription: _VOTERS_LIST_UTF_DISTRICT_EMPTY,\n\t\t})\n\t}\n\tif !skip {\n\t\tif _, ok := voters[voter]; ok {\n\t\t\terrs = append(errs, InitialAddDuplicateVoterError{Voter: voter,\n\t\t\t\tDescription: _VOTERS_LIST_UTF_ADD_SAME_VOTER})\n\t\t}\n\t\t// It is OK to add invalid entries (skip was not set for\n\t\t// adminCode or district errors) since then we will error\n\t\t// anyway and the map values are not used during preprocessing.\n\t\tvoters[voter] = storage.EncodeAdminDistrict(adminCode, district)\n\t}\n\treturn\n}\n\nfunc changes(ctx context.Context, voter, action, adminCode, district string,\n\tvoters map[string][]byte, previousErrors bool, version string, s *storage.Client) (\n\terrs []error) {\n\n\tif len(voter) == 0 {\n\t\terrs = append(errs, ChangesEmptyVoterError{\n\t\t\tDescription: _VOTERS_LIST_UTF_VOTER_ID_EMPTY,\n\t\t})\n\t\tpreviousErrors = true\n\t} else if previousErrors {\n\t\terrs = append(errs, ChangesVoterWithPreviousErrorsError{Voter: voter,\n\t\t\tDescription: _VOTERS_LIST_MODIFY_WITH_PREVIOUS_ERRORS})\n\t}\n\n\t// Only perform consistency checks if there are no previous errors.\n\tvar voterExists bool // Is this voter on the current voter list?\n\tvar voterProcessed bool // Has this voter already been processed?\n\tif !previousErrors {\n\t\t// Check the current entry for the voter. Look at the in-memory\n\t\t// map first and only then storage.\n\t\tif entry, ok := voters[voter]; ok {\n\t\t\tvoterExists = entry != nil\n\t\t\tvoterProcessed = true\n\t\t} else {\n\t\t\tvar err error\n\t\t\t_, _, err = s.GetVoter(ctx, version, voter)\n\t\t\tswitch {\n\t\t\tcase err == nil:\n\t\t\t\tvoterExists = true\n\t\t\tcase errors.CausedBy(err, new(storage.NotExistError)) != nil:\n\t\t\tdefault:\n\t\t\t\terrs = append(errs, GetOldVoterError{Voter: voter, Err: err,\n\t\t\t\t\tDescription: _VOTERS_LIST_GET_VOTER_FROM_DB})\n\t\t\t\tpreviousErrors = true\n\t\t\t}\n\t\t}\n\t}\n\n\tswitch action {\n\tcase \"lisamine\":\n\t\tif len(adminCode) == 0 {\n\t\t\terrs = append(errs, ChangesEmptyAdminUnitCodeError{\n\t\t\t\tDescription: _VOTERS_LIST_UTF_ADMIN_CODE_EMPTY,\n\t\t\t})\n\t\t\tpreviousErrors = true\n\t\t}\n\t\tif len(district) == 0 {\n\t\t\terrs = append(errs, ChangesEmptyDistrictNumberError{\n\t\t\t\tDescription: _VOTERS_LIST_UTF_DISTRICT_EMPTY,\n\t\t\t})\n\t\t\tpreviousErrors = true\n\t\t}\n\t\tif !previousErrors {\n\t\t\tif voterExists {\n\t\t\t\terrs = append(errs, ChangesAddDuplicateVoterError{Voter: voter,\n\t\t\t\t\tDescription: _VOTERS_LIST_UTF_ADD_SAME_VOTER})\n\t\t\t}\n\t\t\tvoters[voter] = storage.EncodeAdminDistrict(adminCode, district)\n\t\t}\n\n\tcase \"kustutamine\":\n\t\tif !previousErrors {\n\t\t\tswitch {\n\t\t\tcase !voterExists:\n\t\t\t\terrs = append(errs, ChangesRemoveNotExistingVoterError{\n\t\t\t\t\tVoter: voter, Description: _VOTERS_LIST_NON_EXISTING_VOTER})\n\t\t\tcase voterProcessed:\n\t\t\t\terrs = append(errs, ChangesRemoveAddedVoterError{Voter: voter,\n\t\t\t\t\tDescription: _VOTERS_LIST_DELETE_JUST_ADDED_VOTER})\n\t\t\t}\n\t\t\tvoters[voter] = nil // nil to distinguish from unchanged voters.\n\t\t}\n\n\tdefault:\n\t\terrs = append(errs, ChangesUnsupportedActionError{Action: action,\n\t\t\tDescription: _VOTERS_LIST_UNKNOWN_ACTION})\n\t}\n\treturn\n}\n\n// stepadd calls add with count and, if step is zero or the new total modulo\n// step is zero, logs and redraws progress.\nfunc stepadd(ctx context.Context, add status.Add, count, step uint64) {\n\tif new1 := add(count); step == 0 || new1%step == 0 {\n\t\tlog.Log(ctx, PreprocessProgress{Count: new1,\n\t\t\tDescription: _VOTERS_LIST_READ_FILE_PROGRESS})\n\t\tprogress.Redraw()\n\t}\n}\n\n// next reads and parses the next voter line from b.\nfunc next(b *bytes.Buffer) (action, voter, adminCode, district string, err error) {\n\tline, err := readString(b, delim)\n\tif err != nil {\n\t\tif err != io.EOF || len(line) > 0 {\n\t\t\terr = ReadNextError{Line: line, Err: err, Description: _VOTERS_LIST_READ_LINE_ERROR}\n\t\t}\n\t\treturn\n\t}\n\n\t// Split on tabs and expect five fields or two fields when 'kustutamine':\n\t//\n\t//\t0. action,\n\t//\t1. voter ID,\n\t//\t2. voter name (ignored),\n\t//\t3. administrative unit code, and\n\t//\t4. district number.\n\t//\n\t//\t0. action,\n\t//\t1. voter ID,\n\t//\n\t// The choices identifier is formed from the administrative unit code\n\t// and district number.\n\tfields := strings.Split(line, string(sep))\n\tswitch len(fields) {\n\tcase 2:\n\t\treturn fields[0], fields[1], \"\", \"\", nil\n\tcase 5:\n\t\treturn fields[0], fields[1], fields[3], fields[4], nil\n\tdefault:\n\t\terr = FieldCountError{Fields: len(fields), Description: _VOTERS_LIST_UTF_COLUMNS_COUNT}\n\t\treturn\n\t}\n}\n\n// report reports an error to both the log and standard output.\nfunc report(ctx context.Context, entry log.ErrorEntry) {\n\tlog.Error(ctx, entry)\n\tprogress.Hide()\n\tdefer progress.Show()\n\tfmt.Fprintln(os.Stderr, \"error:\", entry)\n}\n\n// readString returns the result of b.ReadString(delim) with delim trimmed.\nfunc readString(b *bytes.Buffer, delim byte) (string, error) {\n\tline, err := b.ReadString(delim)\n\tif err == nil {\n\t\tline = line[:len(line)-1] // Trim the delimiter.\n\t}\n\treturn line, err\n}\n" }, { "path": "choices/cmd/voterimp/voterimp_test.go", "content": "package main\n\nimport \"testing\"\n\nfunc TestZIPVersion(t *testing.T) {\n\tconst comment = `Version: start of text\n\nSome commentary about the archive.\n\nVersion: mid-text\n\nSome more commentary about the archive.\n\nVersion: left-trim and Unicode ✔️\nversion: lowercase\nVersion:no space\nVersion: end of text`\n\tconst expected = `[\"start of text\",\"mid-text\",\"left-trim and Unicode ✔️\",\"end of text\"]`\n\n\tversion, err := containerVersion(zipContainer{comment: comment})\n\tif err != nil {\n\t\tt.Fatal(err)\n\t}\n\tif version != expected {\n\t\tt.Errorf(\"unexpected ZIP version: got %s, want %s\", version, expected)\n\t}\n}\n" }, { "path": "choices/go.mod", "content": "module ivxv.ee/choices\n\ngo 1.23\n\nrequire ivxv.ee/common/collector v1.9.11\n\nrequire ivxv.ee/sessionstatus/api v1.9.11\n\nrequire (\n\tgithub.com/coreos/go-semver v0.3.0 // indirect\n\tgithub.com/coreos/go-systemd/v22 v22.3.2 // indirect\n\tgithub.com/gogo/protobuf v1.3.2 // indirect\n\tgithub.com/golang/protobuf v1.5.4 // indirect\n\tgo.etcd.io/etcd/api/v3 v3.5.17 // indirect\n\tgo.etcd.io/etcd/client/pkg/v3 v3.5.17 // indirect\n\tgo.etcd.io/etcd/client/v3 v3.5.17 // indirect\n\tgo.uber.org/atomic v1.7.0 // indirect\n\tgo.uber.org/multierr v1.6.0 // indirect\n\tgo.uber.org/zap v1.17.0 // indirect\n\tgolang.org/x/net v0.29.0 // indirect\n\tgolang.org/x/sys v0.25.0 // indirect\n\tgolang.org/x/text v0.18.0 // indirect\n\tgoogle.golang.org/genproto/googleapis/api v0.0.0-20240903143218-8af14fe29dc1 // indirect\n\tgoogle.golang.org/genproto/googleapis/rpc v0.0.0-20240903143218-8af14fe29dc1 // indirect\n\tgoogle.golang.org/grpc v1.68.0 // indirect\n\tgoogle.golang.org/protobuf v1.34.2 // indirect\n)\n\nreplace ivxv.ee/common/collector => ../common/collector\n\nreplace ivxv.ee/sessionstatus/api => ../sessionstatus/api\n" }, { "path": "choices/go.sum", "content": "github.com/coreos/go-semver v0.3.0 h1:wkHLiw0WNATZnSG7epLsujiMCgPAc9xhjJ4tgnAxmfM=\ngithub.com/coreos/go-semver v0.3.0/go.mod h1:nnelYz7RCh+5ahJtPPxZlU+153eP4D4r3EedlOD2RNk=\ngithub.com/coreos/go-systemd/v22 v22.3.2 h1:D9/bQk5vlXQFZ6Kwuu6zaiXJ9oTPe68++AzAJc1DzSI=\ngithub.com/coreos/go-systemd/v22 v22.3.2/go.mod h1:Y58oyj3AT4RCenI/lSvhwexgC+NSVTIJ3seZv2GcEnc=\ngithub.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=\ngithub.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=\ngithub.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=\ngithub.com/godbus/dbus/v5 v5.0.4/go.mod h1:xhWf0FNVPg57R7Z0UbKHbJfkEywrmjJnf7w5xrFpKfA=\ngithub.com/gogo/protobuf v1.3.2 h1:Ov1cvc58UF3b5XjBnZv7+opcTcQFZebYjWzi34vdm4Q=\ngithub.com/gogo/protobuf v1.3.2/go.mod h1:P1XiOD3dCwIKUDQYPy72D8LYyHL2YPYrpS2s69NZV8Q=\ngithub.com/golang/protobuf v1.5.4 h1:i7eJL8qZTpSEXOPTxNKhASYpMn+8e5Q6AdndVa1dWek=\ngithub.com/golang/protobuf v1.5.4/go.mod h1:lnTiLA8Wa4RWRcIUkrtSVa5nRhsEGBg48fD6rSs7xps=\ngithub.com/google/go-cmp v0.6.0 h1:ofyhxvXcZhMsU5ulbFiLKl/XBFqE1GSq7atu8tAmTRI=\ngithub.com/google/go-cmp v0.6.0/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY=\ngithub.com/kisielk/errcheck v1.5.0/go.mod h1:pFxgyoBC7bSaBwPgfKdkLd5X25qrDl4LWUI2bnpBCr8=\ngithub.com/kisielk/gotool v1.0.0/go.mod h1:XhKaO+MFFWcvkIS/tQcRk01m1F5IRFswLeQ+oQHNcck=\ngithub.com/pkg/errors v0.8.1 h1:iURUrRGxPUNPdy5/HRSm+Yj6okJ6UtLINN0Q9M4+h3I=\ngithub.com/pkg/errors v0.8.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0=\ngithub.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=\ngithub.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=\ngithub.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=\ngithub.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=\ngithub.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=\ngithub.com/stretchr/testify v1.9.0 h1:HtqpIVDClZ4nwg75+f6Lvsy/wHu+3BoSGCbBAcpTsTg=\ngithub.com/stretchr/testify v1.9.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=\ngithub.com/yuin/goldmark v1.1.27/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74=\ngithub.com/yuin/goldmark v1.2.1/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74=\ngo.etcd.io/etcd/api/v3 v3.5.17 h1:cQB8eb8bxwuxOilBpMJAEo8fAONyrdXTHUNcMd8yT1w=\ngo.etcd.io/etcd/api/v3 v3.5.17/go.mod h1:d1hvkRuXkts6PmaYk2Vrgqbv7H4ADfAKhyJqHNLJCB4=\ngo.etcd.io/etcd/client/pkg/v3 v3.5.17 h1:XxnDXAWq2pnxqx76ljWwiQ9jylbpC4rvkAeRVOUKKVw=\ngo.etcd.io/etcd/client/pkg/v3 v3.5.17/go.mod h1:4DqK1TKacp/86nJk4FLQqo6Mn2vvQFBmruW3pP14H/w=\ngo.etcd.io/etcd/client/v3 v3.5.17 h1:o48sINNeWz5+pjy/Z0+HKpj/xSnBkuVhVvXkjEXbqZY=\ngo.etcd.io/etcd/client/v3 v3.5.17/go.mod h1:j2d4eXTHWkT2ClBgnnEPm/Wuu7jsqku41v9DZ3OtjQo=\ngo.uber.org/atomic v1.7.0 h1:ADUqmZGgLDDfbSL9ZmPxKTybcoEYHgpYfELNoN+7hsw=\ngo.uber.org/atomic v1.7.0/go.mod h1:fEN4uk6kAWBTFdckzkM89CLk9XfWZrxpCo0nPH17wJc=\ngo.uber.org/multierr v1.6.0 h1:y6IPFStTAIT5Ytl7/XYmHvzXQ7S3g/IeZW9hyZ5thw4=\ngo.uber.org/multierr v1.6.0/go.mod h1:cdWPpRnG4AhwMwsgIHip0KRBQjJy5kYEpYjJxpXp9iU=\ngo.uber.org/zap v1.17.0 h1:MTjgFu6ZLKvY6Pvaqk97GlxNBuMpV4Hy/3P6tRGlI2U=\ngo.uber.org/zap v1.17.0/go.mod h1:MXVU+bhUf/A7Xi2HNOnopQOrmycQ5Ih87HtOu4q5SSo=\ngolang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w=\ngolang.org/x/crypto v0.0.0-20191011191535-87dc89f01550/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI=\ngolang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto=\ngolang.org/x/mod v0.2.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA=\ngolang.org/x/mod v0.3.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA=\ngolang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg=\ngolang.org/x/net v0.0.0-20190620200207-3b0461eec859/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=\ngolang.org/x/net v0.0.0-20200226121028-0de0cce0169b/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=\ngolang.org/x/net v0.0.0-20201021035429-f5854403a974/go.mod h1:sp8m0HH+o8qH0wwXwYZr8TS3Oi6o0r6Gce1SSxlDquU=\ngolang.org/x/net v0.29.0 h1:5ORfpBpCs4HzDYoodCDBbwHzdR5UrLBZ3sOnUJmFoHo=\ngolang.org/x/net v0.29.0/go.mod h1:gLkgy8jTGERgjzMic6DS9+SP0ajcu6Xu3Orq/SpETg0=\ngolang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=\ngolang.org/x/sync v0.0.0-20190911185100-cd5d95a43a6e/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=\ngolang.org/x/sync v0.0.0-20201020160332-67f06af15bc9/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=\ngolang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=\ngolang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=\ngolang.org/x/sys v0.0.0-20200930185726-fdedc70b468f/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=\ngolang.org/x/sys v0.25.0 h1:r+8e+loiHxRqhXVl6ML1nO3l1+oFoWbnlu2Ehimmi34=\ngolang.org/x/sys v0.25.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=\ngolang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=\ngolang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=\ngolang.org/x/text v0.18.0 h1:XvMDiNzPAl0jr17s6W9lcaIhGUfUORdGCNsuLmPG224=\ngolang.org/x/text v0.18.0/go.mod h1:BuEKDfySbSR4drPmRPG/7iBdf8hvFMuRexcpahXilzY=\ngolang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=\ngolang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo=\ngolang.org/x/tools v0.0.0-20200619180055-7c47624df98f/go.mod h1:EkVYQZoAsY45+roYkvgYkIh4xh/qjgUK9TdY2XT94GE=\ngolang.org/x/tools v0.0.0-20210106214847-113979e3529a/go.mod h1:emZCQorbCU4vsT4fOWvOPXz4eW1wZW4PmDk9uLelYpA=\ngolang.org/x/xerrors v0.0.0-20190717185122-a985d3407aa7/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=\ngolang.org/x/xerrors v0.0.0-20191011141410-1b5146add898/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=\ngolang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=\ngolang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=\ngoogle.golang.org/genproto/googleapis/api v0.0.0-20240903143218-8af14fe29dc1 h1:hjSy6tcFQZ171igDaN5QHOw2n6vx40juYbC/x67CEhc=\ngoogle.golang.org/genproto/googleapis/api v0.0.0-20240903143218-8af14fe29dc1/go.mod h1:qpvKtACPCQhAdu3PyQgV4l3LMXZEtft7y8QcarRsp9I=\ngoogle.golang.org/genproto/googleapis/rpc v0.0.0-20240903143218-8af14fe29dc1 h1:pPJltXNxVzT4pK9yD8vR9X75DaWYYmLGMsEvBfFQZzQ=\ngoogle.golang.org/genproto/googleapis/rpc v0.0.0-20240903143218-8af14fe29dc1/go.mod h1:UqMtugtsSgubUsoxbuAoiCXvqvErP7Gf0so0mK9tHxU=\ngoogle.golang.org/grpc v1.68.0 h1:aHQeeJbo8zAkAa3pRzrVjZlbz6uSfeOXlJNQM0RAbz0=\ngoogle.golang.org/grpc v1.68.0/go.mod h1:fmSPC5AsjSBCK54MyHRx48kpOti1/jRfOlwEWywNjWA=\ngoogle.golang.org/protobuf v1.34.2 h1:6xV6lTsCfpGD21XK49h7MhtcApnLqkfYgPcdHftf6hg=\ngoogle.golang.org/protobuf v1.34.2/go.mod h1:qYOHts0dSfpeUzUFpOMr/WGzszTmLH+DiWniOlNbLDw=\ngopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=\ngopkg.in/yaml.v2 v2.2.8/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=\ngopkg.in/yaml.v2 v2.4.0 h1:D8xgwECY7CYvx+Y2n4sBz93Jn9JRvxdiyyo8CTfuKaY=\ngopkg.in/yaml.v2 v2.4.0/go.mod h1:RDklbk79AGWmwhnvt/jBztapEOGDOx6ZbXqjP6csGnQ=\ngopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=\ngopkg.in/yaml.v3 v3.0.0-20210107192922-496545a6307b/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=\ngopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=\ngopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=\n" }, { "path": "choices/internal/client/sessionstatus/rpc/client.go", "content": "package rpc\n\nimport (\n\t\"strconv\"\n\n\t\"ivxv.ee/common/collector/auth\"\n\t\"ivxv.ee/common/collector/command\"\n\t\"ivxv.ee/common/collector/server\"\n\t\"ivxv.ee/common/collector/status/client\"\n\tstatus \"ivxv.ee/common/collector/status/client/rpc\"\n\tapi \"ivxv.ee/sessionstatus/api/rpc\"\n)\n\nconst (\n\t// This should be a StatusReadResp.Caller value for ID card\n\tEmpty = \"\"\n\n\t// This should be a StatusReadResp.Caller value for Mobile-ID/Smart-ID\n\tAuthenticateStatus = \"RPC.AuthenticateStatus\"\n\n\t// This should be a StatusReadResp.Caller value for Web eID\n\tToken = \"RPC.Token\"\n\n\t// This should be a StatusUpdateReq.Caller value for ID card/Mobile-ID/Smart-ID/Web eID\n\tVoterChoices = \"RPC.VoterChoices\"\n)\n\nconst exitCodeOK = 0\n\ntype RPC struct {\n\tchoiceTTL int64\n\tclient client.TLSDialer\n}\n\n// NewClient initializes session status server client.\nfunc NewClient(c *command.C) (client.Verifier, int) {\n\t// Initialize RPC TLS session status client\n\ttlsDialer, errCode := api.NewClient(c)\n\tif errCode != exitCodeOK {\n\t\treturn nil, errCode\n\t}\n\n\treturn &RPC{\n\t\tclient: tlsDialer,\n\t\tchoiceTTL: c.Conf.Technical.Status.Session.ChoiceTTL,\n\t}, exitCodeOK\n}\n\nfunc (r *RPC) Verify(dto interface{}) (bool, error) {\n\t// dto should cast to *status.VerifyReq\n\tverifyReq, err := status.CastAnyToVerifyReq(dto)\n\tif err != nil {\n\t\treturn false, CastAnyToVerifyReqError{Err: err,\n\t\t\tDescription: _SESSIONSTATUS_CAST_ANY_TO_VERIFYREQ}\n\t}\n\n\t// verifyReq.Request should cast to server.Header\n\theader, err := api.CastVerifyRequestToServerHeader(verifyReq)\n\tif err != nil {\n\t\treturn false, CastVerifyRequestToServerHeaderError{Err: err,\n\t\t\tDescription: _SESSIONSTATUS_CAST_VERIFYREQ_TO_SERVERHEADER}\n\t}\n\n\t// Send request to session status server and verify response\n\tok, err := r.verifyAndUpdateSessionStatus(verifyReq.ServiceMethod, *header)\n\tif err != nil {\n\t\treturn false, VerifyAndUpdateSessionStatusError{Err: err,\n\t\t\tDescription: _SESSIONSTATUS_SEND_UPDATE_REQ_AND_VERIFY_IT}\n\t}\n\n\treturn ok, nil\n}\n\n// verifyAndUpdateSessionStatus will first check h.Header.SessionID\n// record against the underlying storage, and if everything is correct,\n// then will update h.Header.SessionID record in the underlying storage\n// by marking session status Caller as serviceMethod.\n//\n// Note, that here serviceMethod is the RPC method that calls this function.\nfunc (r *RPC) verifyAndUpdateSessionStatus(serviceMethod string, h server.Header) (bool, error) {\n\t// Extract authentication method from a header.Ctx\n\tauthFilter, err := server.AuthMethod(h.Ctx)\n\tif err != nil {\n\t\treturn false, AuthMethodFromCtxError{Err: err,\n\t\t\tDescription: _SESSIONSTATUS_AUTHMETHOD_FROM_CTX}\n\t}\n\tif authFilter == \"\" {\n\t\treturn false, AuthMethodIsEmptyError{AuthFilter: authFilter,\n\t\t\tDescription: _SESSIONSTATUS_AUTHMETHOD_EMPTY}\n\t}\n\n\t// Create new session read status request\n\treqRead := api.NewSessionStatusReadReqBuilder().\n\t\tWithHeader(h).\n\t\tBuild()\n\n\t// Create new RPC request to status server, embeds session status request\n\treqReadRPC := status.NewStatusReqBuilder().\n\t\tWithServiceMethod(api.Endpoint.SessionStatusRead).\n\t\tWithRequest(reqRead).\n\t\tBuild()\n\n\t// RPC call to .WithServiceMethod(...)\n\trespReadRaw, err := r.client.TLSDial(&reqReadRPC)\n\tif err != nil {\n\t\treturn false, SessionReadReqTLSDialError{Err: err,\n\t\t\tDescription: _SESSIONSTATUS_TLS_DIAL}\n\t}\n\n\t// Process raw RPC response, doesn't care about the embedded status type\n\trespReadRPC := status.NewStatusRespBuilder().\n\t\tWithResponse(respReadRaw).\n\t\tBuild()\n\n\t// Process session read status response\n\trespRead := api.NewSessionStatusReadRespBuilder().\n\t\tWithResponse(respReadRPC.Response).\n\t\tBuild()\n\n\tttl := strconv.FormatInt(r.choiceTTL, 10)\n\t// Reset the LeaseID\n\trespRead.Lease = \"\"\n\n\t// NB! Most important part, that prevents any attack on SessionID\n\tok, err := verifyStatusReadResp(&respRead, voterChoicesHandler)\n\tif err != nil || !ok {\n\t\treturn false, VerifyStatusReadRespError{Err: err,\n\t\t\tDescription: _SESSIONSTATUS_RESP_VERIFY}\n\t}\n\n\t// SessionID is valid, however there is one more possibility to tamper\n\t// a SessionID == to wait until SessionID TTL is expired and perform\n\t// RPC.VoterChoices query. This is the only edge case that could happen\n\t// since RPC.VoterChoices is the only endpoint which allows\n\t// empty Auth and Caller fields.\n\t//\n\t// This behaviour can be prevented if we know, how user exactly authenticated\n\t// in an authentication filter. For Mobile-ID/Smart-ID/Web eID it is auth.Ticket,\n\t// however for ID card it is auth.TLS\n\tif respRead.Auth == client.NoAuth && auth.Type(authFilter) != auth.TLS {\n\t\t// SessionID is attempted to tamper\n\t\treturn false, EmptyAuthAndCallerForNonIDCardUserError{\n\t\t\tMethod: VoterChoices,\n\t\t\tAuth: respRead.Auth,\n\t\t\tCaller: respRead.Caller,\n\t\t\tAuthMethod: authFilter,\n\t\t\tDescription: _SESSIONSTATUS_IDCARD,\n\t\t}\n\t}\n\n\t// Here is 100% clear, that user is ID card\n\tif respRead.Auth == client.NoAuth {\n\t\trespRead.Auth = client.IDcardAuth\n\t}\n\n\t// Create new session update status request\n\treqUpdate := api.NewSessionStatusUpdateReqBuilder().\n\t\tWithHeader(h).\n\t\tWithCaller(serviceMethod).\n\t\tWithAuth(respRead.Auth).\n\t\tWithLease(respRead.Lease).\n\t\tWithTTL(ttl).\n\t\tBuild()\n\n\t// Create new RPC request to status server, embeds session status request\n\treqUpdateRPC := status.NewStatusReqBuilder().\n\t\tWithServiceMethod(api.Endpoint.SessionStatusUpdate).\n\t\tWithRequest(reqUpdate).\n\t\tBuild()\n\n\t// RPC call to .WithServiceMethod(...)\n\trespUpdateRaw, err := r.client.TLSDial(&reqUpdateRPC)\n\tif err != nil {\n\t\treturn false, SessionUpdateReqTLSDialError{Err: err,\n\t\t\tDescription: _SESSIONSTATUS_TLS_DIAL}\n\t}\n\n\t// Process raw RPC response, doesn't care about the embedded status type\n\trespUpdateRPC := status.NewStatusRespBuilder().\n\t\tWithResponse(respUpdateRaw).\n\t\tBuild()\n\n\t// Process session update status response\n\trespUpdate := api.NewSessionStatusUpdateRespBuilder().\n\t\tWithResponse(respUpdateRPC.Response).\n\t\tBuild()\n\n\t// If true, then status has been successfully updated\n\tok = respUpdate.Ok\n\tif !ok {\n\t\treturn false, SessionStatusUpdateError{\n\t\t\tCaller: reqUpdate.Caller,\n\t\t\tAuth: respRead.Auth,\n\t\t\tDescription: _SESSIONSTATUS_UPDATE_FAIL,\n\t\t}\n\t}\n\n\treturn true, nil\n}\n\n// verifyStatusReadResp r by applying an appropriate handler h.\nfunc verifyStatusReadResp(r *api.StatusReadResp,\n\th func(*api.StatusReadResp) (bool, error)) (bool, error) {\n\treturn h(r)\n}\n\n// voterChoicesHandler performs filter operation on StatusReadResp r to\n// detect invalid SessionID in a client RPC.VoterChoices request.\nfunc voterChoicesHandler(r *api.StatusReadResp) (bool, error) {\n\t// When authenticating with ID card, i.e. first interaction with IVXV\n\tidCardAuth := r.Caller == Empty && r.Auth == client.NoAuth\n\n\t// When authenticating with Mobile-ID, then IVXV requires that client\n\t// has previously interacted with IVXV using RPC.AuthenticateStatus method\n\tmidAuth := r.Caller == AuthenticateStatus && r.Auth == client.MobileIDAuth\n\n\t// When authenticating with Smart-ID, then IVXV requires that client\n\t// has previously interacted with IVXV using RPC.AuthenticateStatus method\n\tsidAuth := r.Caller == AuthenticateStatus && r.Auth == client.SmartIDAuth\n\n\t// When authenticating with Web eID, then IVXV requires that client\n\t// has previously interacted with IVXV using RPC.Token method\n\twidAuth := r.Caller == Token && r.Auth == client.WebeIDAuth\n\n\t// All conditions must satisfy simultaneously!\n\tif !(idCardAuth) && !(midAuth) && !(sidAuth) && !(widAuth) {\n\t\treturn false, VoterChoicesInvalidCallerOrAuthForSessionID{\n\t\t\tMethod: VoterChoices,\n\t\t\tCaller: r.Caller,\n\t\t\tAuth: r.Auth,\n\t\t\tDescription: _SESSIONSTATUS_MALFORMED_SESSION_ID,\n\t\t}\n\t}\n\treturn true, nil\n}\n" }, { "path": "choices/internal/client/sessionstatus/rpc/log_desc.go", "content": "package rpc\n\nconst (\n\t_SESSIONSTATUS_CAST_ANY_TO_VERIFYREQ = \"Cannot cast any to VerifyReq\"\n\t_SESSIONSTATUS_CAST_VERIFYREQ_TO_SERVERHEADER = \"Cannot cast VerifyReq to server.Header\"\n\t_SESSIONSTATUS_SEND_UPDATE_REQ_AND_VERIFY_IT = \"SessionID verification request that has been sent to sessionstatus service has been failed\"\n\t_SESSIONSTATUS_AUTHMETHOD_FROM_CTX = \"Unable to parse server.AuthMethod from context\"\n\t_SESSIONSTATUS_AUTHMETHOD_EMPTY = \"server.AuthMethod parsed from context is empty\"\n\t_SESSIONSTATUS_TLS_DIAL = \"TLS dial to sessionstatus service failed\"\n\t_SESSIONSTATUS_RESP_VERIFY = \"Sessionstatus service response verification failed\"\n\t_SESSIONSTATUS_IDCARD = \"Empty server.AuthMethod is only allowed for ID card users\"\n\t_SESSIONSTATUS_UPDATE_FAIL = \"Sessionstatus service hasn't updated the Session ID state\"\n\t_SESSIONSTATUS_MALFORMED_SESSION_ID = \"SessionID has been attempted to tamper\"\n)\n" }, { "path": "choices/service/choices/log_desc.go", "content": "package main\n\nconst (\n\t_CHOICES_CHOICESREQ = \"RPC.ChoicesReq\"\n\t_CHOICES_ADMIN_CODE = \"Unable to fetch admin code from database for this voter ID\"\n\t_CHOICES_NO_FOR_VOTER = \"No choices for this voter ID\"\n\t_CHOICES_FROM_DB = \"Unable to fetch choices for this voter ID from a database\"\n\t_CHOICES_CHOICESRESP = \"RPC.ChoicesResp\"\n\t_CHOICES_VOTERCHOICESREQ = \"RPC.VoterChoicesReq\"\n\t_CHOICES_VOTER_NO_AUTH = \"Voter has not been authenticated\"\n\t_CHOICES_SESSION_ID = \"Malformed SessionID\"\n\t_CHOICES_SESSION_ID_EXPIRED = \"SessionID has been expired\"\n\t_CHOICES_NO_VOTER_IN_VOTERS_LIST = \"No such voter ID in a voters list\"\n\t_CHOICES_DB = \"Successfully got choices for this voter ID from a database\"\n\t_CHOICES_CHECK_VOTED = \"Unable to get a response from database whether this voter ID has already voted or not\"\n\t_CHOICES_VOTERCHOICESRESP = \"RPC.VoterChoicesResp\"\n\t_CHOICES_START = \"Failed to transform service start time from election configuration file to RFC3339 format\"\n\t_CHOICES_STOP = \"Failed to transform service stop time from election configuration file to RFC3339 format\"\n\t_CHOICES_AUTH = \"Failed to parse authentication configuration for choices service\"\n\t_CHOICES_SERVER = \"Failed to parse server configuration for choices service\"\n\t_CHOICES_SERVER_SERVE = \"Failed to serve choices service to clients\"\n)\n" }, { "path": "choices/service/choices/main.go", "content": "/*\nThe choices service serves choice lists for voting and verification.\n*/\npackage main\n\nimport (\n\t\"os\"\n\t\"strings\"\n\t\"time\"\n\n\tinternal \"ivxv.ee/choices/internal/client/sessionstatus/rpc\"\n\t\"ivxv.ee/common/collector/command\"\n\t\"ivxv.ee/common/collector/command/exit\"\n\t\"ivxv.ee/common/collector/conf\"\n\t\"ivxv.ee/common/collector/errors\"\n\t\"ivxv.ee/common/collector/log\"\n\t\"ivxv.ee/common/collector/server\"\n\t\"ivxv.ee/common/collector/status/client\"\n\tstatus \"ivxv.ee/common/collector/status/client/rpc\"\n\t\"ivxv.ee/common/collector/storage\"\n\t//ivxv:modules common/collector/auth\n\t//ivxv:modules common/collector/container\n\t//ivxv:modules common/collector/storage\n)\n\n// RPC is the handler for choices service calls.\ntype RPC struct {\n\tstatus client.Verifier\n\tstorage *storage.Client\n\tforceList string // If set, VoterChoices always returns this list.\n\tforeignCode string // Administrative unit code for foreign voters.\n}\n\n// ChoicesArgs are the arguments provided to a call of RPC.Choices.\ntype ChoicesArgs struct {\n\tserver.Header\n\tChoices string `size:\"10\"` // Identifier of the requested choice list.\n}\n\n// VoterArgs are the arguments provided to a call of RPC.VoterChoices. There\n// are none, because the identity of the voter will be extracted from the\n// authentication info.\ntype VoterArgs struct {\n\tserver.Header\n}\n\n// Response is the response returned by RPC.Choices and RPC.VoterChoices.\ntype Response struct {\n\tserver.Header\n\tChoices string // Identifier of the requested choices.\n\tList []byte // The requested choices.\n\tVoted bool `json:\",omitempty\"` // Has the voter voted already?\n}\n\n// Deprecated: Choices RPC endpoint is not used by IVXV backend anymore.\n// Choices is the remote procedure call performed by verification clients to\n// retrieve a specific choices list.\nfunc (r *RPC) Choices(args ChoicesArgs, resp *Response) (err error) {\n\tlog.Log(args.Ctx, ChoicesReq{Choices: args.Choices,\n\t\tDescription: _CHOICES_CHOICESREQ})\n\tresp.Choices = args.Choices\n\n\tif resp.List, err = r.storage.GetChoices(args.Ctx, args.Choices); err != nil {\n\t\tif errors.CausedBy(err, new(storage.NotExistError)) != nil {\n\t\t\tlog.Error(args.Ctx, BadChoicesError{Err: err,\n\t\t\t\tDescription: _CHOICES_NO_FOR_VOTER})\n\t\t\treturn server.ErrBadRequest\n\t\t}\n\t\tlog.Error(args.Ctx, GetChoicesError{Err: log.Alert(err),\n\t\t\tDescription: _CHOICES_FROM_DB})\n\t\treturn server.ErrInternal\n\t}\n\n\t// The choices are not actually sensitive, but just really large.\n\tlog.Log(args.Ctx, ChoicesResp{List: log.Sensitive(resp.List),\n\t\tDescription: _CHOICES_CHOICESRESP})\n\treturn\n}\n\n// VoterChoices is the remote procedure call performed by voting clients to\n// retrieve the choices list for a voter.\nfunc (r *RPC) VoterChoices(args VoterArgs, resp *Response) (err error) {\n\tlog.Log(args.Ctx, VoterChoicesReq{Description: _CHOICES_VOTERCHOICESREQ})\n\n\t// Get the voter identifier associated with the RPC call. If empty, then the request\n\t// was not properly authenticated and error shall be logged\n\tvoter := server.VoterIdentity(args.Ctx)\n\tif len(voter) == 0 {\n\t\tlog.Error(args.Ctx, UnauthenticatedVoterChoicesError{Description: _CHOICES_VOTER_NO_AUTH})\n\t\treturn server.ErrUnauthenticated\n\t}\n\n\t// Build up VerifyReq for session status service\n\tverifyReq := status.NewVerifyReqBuilder().\n\t\tWithServiceMethod(internal.VoterChoices).\n\t\tWithRequest(args.Header).\n\t\tBuild()\n\n\t// SessionID security check\n\tok, err := r.status.Verify(&verifyReq)\n\tif err != nil {\n\t\t// Error during SessionID check - database unreachable, service stalled, etc.\n\t\tlog.Error(args.Ctx, VoterChoicesVerifySessionIDError{Err: err,\n\t\t\tDescription: _CHOICES_SESSION_ID})\n\t\treturn server.ErrBadRequest\n\t}\n\tif !ok {\n\t\t// SessionID is unknown / has expired, we shall not further process the request\n\t\tlog.Error(args.Ctx, VoterChoicesUpdateSessionIDError{Description: _CHOICES_SESSION_ID_EXPIRED})\n\t\treturn server.ErrBadRequest\n\t}\n\n\tif len(r.forceList) > 0 {\n\t\tresp.Choices = r.forceList\n\t} else {\n\t\t_, resp.Choices, err = r.storage.VoterChoices(args.Ctx, voter, r.foreignCode)\n\t\tif err != nil {\n\t\t\tif errors.CausedBy(err, new(storage.NotExistError)) != nil {\n\t\t\t\t// Voter successfully authenticated to the backend but\n\t\t\t\t// was not found in the current voterlist\n\t\t\t\tlog.Error(args.Ctx, IneligibleVoterError{Err: err,\n\t\t\t\t\tDescription: _CHOICES_NO_VOTER_IN_VOTERS_LIST})\n\t\t\t\treturn server.ErrIneligible\n\t\t\t}\n\t\t\t// Backend cannot fetch choices list from storage, database may be unreachable\n\t\t\tlog.Error(args.Ctx, VoterChoicesError{Err: log.Alert(err),\n\t\t\t\tDescription: _CHOICES_ADMIN_CODE})\n\t\t\treturn server.ErrInternal\n\t\t}\n\t}\n\tlog.Log(args.Ctx, VoterChoices{Choices: resp.Choices, Description: _CHOICES_DB})\n\n\tif resp.List, err = r.storage.GetChoices(args.Ctx, resp.Choices); err != nil {\n\t\t// Backend cannot fetch choices list from storage, database may be unreachable\n\t\tlog.Error(args.Ctx, GetVoterChoicesError{Err: log.Alert(err),\n\t\t\tDescription: _CHOICES_FROM_DB})\n\t\treturn server.ErrInternal\n\t}\n\n\tif resp.Voted, err = r.storage.CheckVoted(args.Ctx, voter); err != nil {\n\t\t// Backend cannot check whether voter has already voted or not,\n\t\t// database may be unreachable\n\t\tlog.Error(args.Ctx, CheckVotedError{Err: log.Alert(err),\n\t\t\tDescription: _CHOICES_CHECK_VOTED})\n\t\treturn server.ErrInternal\n\t}\n\n\t// The choices are not actually sensitive, but just really large.\n\tlog.Log(args.Ctx, VoterChoicesResp{List: log.Sensitive(resp.List),\n\t\tDescription: _CHOICES_VOTERCHOICESRESP})\n\treturn\n}\n\nfunc main() {\n\t// Call choicesmain in a separate function so that it can set up defers\n\t// and have them trigger before returning with a non-zero exit code.\n\tos.Exit(choicesmain())\n}\n\nfunc choicesmain() (code int) {\n\tc := command.New(\"ivxv-choices\", \"\")\n\tdefer func() {\n\t\tcode = c.Cleanup(code)\n\t}()\n\n\t// Configure session status client\n\tstatusClient, errCode := internal.NewClient(c)\n\tif statusClient == nil || errCode != 0 {\n\t\treturn errCode\n\t}\n\n\t// Create new RPC instance with storage and status clients\n\trpc := &RPC{storage: c.Storage, status: statusClient}\n\n\tvar start, stop time.Time\n\tvar authConf server.AuthConf\n\tvar err error\n\n\tif elec := c.Conf.Election; elec != nil {\n\t\t// Check election configuration time values.\n\t\tif start, err = elec.ServiceStartTime(); err != nil {\n\t\t\treturn c.Error(exit.Config, StartTimeError{Err: err,\n\t\t\t\tDescription: _CHOICES_START},\n\t\t\t\t\"bad service start time:\", err)\n\t\t}\n\n\t\tif stop, err = elec.ElectionStopTime(); err != nil {\n\t\t\treturn c.Error(exit.Config, StopTimeError{Err: err,\n\t\t\t\tDescription: _CHOICES_STOP},\n\t\t\t\t\"bad election stop time:\", err)\n\t\t}\n\n\t\t// Parse client-authentication configuration.\n\t\tif authConf, err = server.NewAuthConf(\n\t\t\telec.Auth, elec.Identity, &elec.Age); err != nil {\n\n\t\t\treturn c.Error(exit.Config, ServerAuthConfError{Err: err,\n\t\t\t\tDescription: _CHOICES_AUTH},\n\t\t\t\t\"failed to configure client authentication:\", err)\n\t\t}\n\n\t\trpc.forceList = strings.TrimSpace(elec.IgnoreVoterList)\n\t\trpc.foreignCode = strings.TrimSpace(elec.VoterForeignEHAKDefault())\n\t}\n\n\tvar s *server.S\n\tif c.Conf.Technical != nil {\n\t\t// Configure a new server with the service instance\n\t\t// configuration and the RPC handler instance.\n\t\tcert, key := conf.TLS(conf.Sensitive(c.Service.ID))\n\t\tif s, err = server.New(&server.Conf{\n\t\t\tCertPath: cert,\n\t\t\tKeyPath: key,\n\t\t\tAddress: c.Service.Address,\n\t\t\tEnd: stop,\n\t\t\tFilter: &c.Conf.Technical.Filter,\n\t\t\tVersion: &c.Conf.Version,\n\t\t}, rpc); err != nil {\n\t\t\treturn c.Error(exit.Config, ServerConfError{Err: err,\n\t\t\t\tDescription: _CHOICES_SERVER},\n\t\t\t\t\"failed to configure server:\", err)\n\t\t}\n\t}\n\n\t// Start listening for incoming connections during the voting period.\n\tif c.Until >= command.Execute {\n\t\tif err = s.WithAuth(authConf).ServeAt(c.Ctx, start); err != nil {\n\t\t\treturn c.Error(exit.Unavailable, ServeError{Err: err,\n\t\t\t\tDescription: _CHOICES_SERVER_SERVE},\n\t\t\t\t\"failed to serve choices service:\", err)\n\t\t}\n\t}\n\treturn exit.OK\n}\n" }, { "path": "collector-admin/Makefile", "content": "check:\n\tenv PYTHONPATH=../common/external/schematics \\\n\t\tpylint3 --rcfile=../common/tools/pylintrc ivxv_admin\n" }, { "path": "collector-admin/README.rst", "content": "================================\n IVXV Internet voting framework\n================================\n-----------------------------------\n Collector administration interface\n-----------------------------------\n\n\n" }, { "path": "collector-admin/config/ivxv-admin-ui.conf", "content": "# IVXV Internet voting framework\n\n# Apache site configuration for Collector Management Service\n# /etc/apache2/sites-available/ivxv-admin-ui.conf\n\n# When Apache server responds to client, then 'Header:Server:' will be 'Apache', and not 'Apache/2.4.52 (Ubuntu)'\nServerTokens Prod\n\nServerName ivxv-admin\nAddDefaultCharset utf-8\n\nErrorLog ${APACHE_LOG_DIR}/error.log\n\n# Nobody can browse URLs that are outside the tags listed below in this configuration.\n# E.g. URLs like 'https://myhost.ee/ui/js' will be HTTP 403 Forbidden\n\n Options FollowSymLinks\n AllowOverride None\n Require all granted\n\n\n\n # Redirect all HTTP requests to HTTPS site\n RewriteEngine on\n RewriteCond %{HTTPS} !=on\n RewriteRule ^.* https://%{HTTP_HOST}/ [R=301,L]\n\n # Access log\n CustomLog ${APACHE_LOG_DIR}/access-http.log combined\n\n\n\n # The ServerName directive sets the request scheme, hostname and port that\n # the server uses to identify itself. This is used when creating\n # redirection URLs. In the context of virtual hosts, the ServerName\n # specifies what hostname must appear in the request's Host: header to\n # match this virtual host. For the default virtual host (this file) this\n # value is not decisive as it is used as a last resort host regardless.\n # However, you must set it for any further virtual host explicitly.\n ServerAdmin webmaster@localhost\n DocumentRoot /var/www/collector-admin/\n\n # Available loglevels: trace8, ..., trace1, debug, info, notice, warn,\n # error, crit, alert, emerg.\n # It is also possible to configure the loglevel for particular\n # modules, e.g.\n #LogLevel info ssl:warn\n\n # Access log\n LogFormat \"%a %l %u %t \\\"%r\\\" %>s %b %T \\\"%{Referer}i\\\" \\\"%{User-Agent}i\\\" \\\"%q\\\" \\\"%{SSL_CLIENT_S_DN_CN}e\\\"\" ivxv-admin-https\n CustomLog ${APACHE_LOG_DIR}/access.log ivxv-admin-https\n\n # SSL {{{\n # SSL Engine Switch\n SSLEngine on\n\n # Create the standard set of SSL related CGI/SSI environment variables\n SSLOptions StdEnvVars\n\n # A self-signed certificate can be created by installing\n # the ssl-cert package.\n # If both key and certificate are stored in the same file, only the\n # SSLCertificateFile directive is needed.\n SSLCertificateFile \"/etc/ssl/certs/ivxv-admin-default.crt\"\n SSLCertificateKeyFile \"/etc/ssl/private/ivxv-admin-default.key\"\n\n # Server Certificate Chain:\n # Point SSLCertificateChainFile at a file containing the\n # concatenation of PEM encoded CA certificates which form the\n # certificate chain for the server certificate. Alternatively\n # the referenced file can be the same as SSLCertificateFile\n # when the CA certificates are directly appended to the server\n # certificate for convinience.\n #SSLCertificateChainFile /etc/ssl/certs/KLASS3-SK_2010_EECCRCA_SHA384.pem.crt\n\n # Certificate Authority (CA):\n # Set the CA certificate verification path where to find CA\n # certificates for client authentication or alternatively one\n # huge file containing all of them (file must be PEM encoded)\n # Note: Inside SSLCACertificatePath you need hash symlinks\n # to point to the certificate files. Use the provided\n # Makefile to update the hash symlinks after changes.\n #SSLCACertificatePath /etc/ssl/certs/\n SSLCACertificateFile /etc/ssl/certs/sk-juur.crt\n\n # Certificate Revocation Lists (CRL):\n # Set the CA revocation path where to find CA CRLs for client\n # authentication or alternatively one huge file containing all\n # of them (file must be PEM encoded)\n # Note: Inside SSLCARevocationPath you need hash symlinks\n # to point to the certificate files. Use the provided\n # Makefile to update the hash symlinks after changes.\n #SSLCARevocationPath /etc/apache2/ssl.crl/\n #SSLCARevocationFile /etc/apache2/ssl.crl/ca-bundle.crl\n\n # Client Authentication (Type):\n # Client certificate verification type and depth. Types are\n # none, optional, require and optional_no_ca. Depth is a\n # number which specifies how deeply to verify the certificate\n # issuer chain before deciding the certificate is not valid.\n SSLVerifyClient require\n SSLVerifyDepth 2\n\n # Ref: https://www.id.ee/wp-content/uploads/2021/12/21.11-ubuntu-apache2-webserver-ssl-configuration.pdf\n # Accept only TLSv1.3 protocol in new connections.\n SSLProtocol -all +TLSv1.3\n\n # Use the server's preference when choosing a cipher\n # during an TLSv1.3 handshake.\n SSLHonorCipherOrder on\n\n # Uncomment in case you want to check client certificate against OCSP\n # responder, parsed from certificate's 'Authority Information Access:' field\n # SSLOCSPEnable on\n\n # Ensures Perfect Forward Secrecy is not compromised if the server is not restarted regularly.\n SSLSessionTickets off\n\n # Specify Diffie-Hellman group (strong, 2048 bit)\n SSLOpenSSLConfCmd DHParameters \"/etc/ssl/dhparams.pem\"\n\n # SSL Protocol Adjustments:\n # The safe and default but still SSL/TLS standard compliant shutdown\n # approach is that mod_ssl sends the close notify alert but doesn't wait for\n # the close notify alert from client. When you need a different shutdown\n # approach you can use one of the following variables:\n # o ssl-unclean-shutdown:\n # This forces an unclean shutdown when the connection is closed, i.e. no\n # SSL close notify alert is send or allowed to received. This violates\n # the SSL/TLS standard but is needed for some brain-dead browsers. Use\n # this when you receive I/O errors because of the standard approach where\n # mod_ssl sends the close notify alert.\n # o ssl-accurate-shutdown:\n # This forces an accurate shutdown when the connection is closed, i.e. a\n # SSL close notify alert is send and mod_ssl waits for the close notify\n # alert of the client. This is 100% SSL/TLS standard compliant, but in\n # practice often causes hanging connections with brain-dead browsers. Use\n # this only for browsers where you know that their SSL implementation\n # works correctly.\n # Notice: Most problems of broken clients are also related to the HTTP\n # keep-alive facility, so you usually additionally want to disable\n # keep-alive for those clients, too. Use variable \"nokeepalive\" for this.\n # Similarly, one has to force some clients to use HTTP/1.0 to workaround\n # their broken HTTP/1.1 implementation. Use variables \"downgrade-1.0\" and\n # \"force-response-1.0\" for this.\n BrowserMatch \"MSIE [2-6]\" \\\n nokeepalive ssl-unclean-shutdown \\\n downgrade-1.0 force-response-1.0\n # MSIE 7 and newer should be able to use keepalive\n BrowserMatch \"MSIE [17-9]\" ssl-unclean-shutdown\n # }}}\n\n # /ivxv/data - data files for UI {{{\n\n # Aliases for data files in file system\n # Access to files is defined in \n Alias \"/ivxv/data/ballot-box\" \"/var/lib/ivxv/ballot-box/\"\n Alias \"/ivxv/data/commands\" \"/var/lib/ivxv/commands/\"\n Alias \"/ivxv/data/\" \"/var/lib/ivxv/admin-ui-data/\"\n\n # }}}\n # /ivxv/cgi - CGI application for UI {{{\n\n # Define CGI application alias\n WSGIScriptAlias \"/ivxv/cgi\" \"/var/www/cgi/ivxv-admin.wsgi\"\n\n # }}}\n\n\n\n# Main site\n\n Require all denied\n\n ExpiresActive on\n ExpiresDefault \"access plus 1 minute\"\n\n # Allow all roles to access main site\n \n Require all granted\n \n \n Require all granted\n \n \n Require all granted\n \n\n\n# Exported votes downloadable through user interface\n\n Require all denied\n\n ExpiresActive on\n ExpiresDefault \"access plus 1 second\"\n\n \n Require all granted\n \n \n Require all granted\n \n\n\n# Command files with command status files\n\n Require all denied\n\n ExpiresActive on\n ExpiresDefault \"access plus 1 second\"\n\n # All config command files (bdoc, zip) and command status files (json) for admin\n \n \n Require all granted\n \n \n\n # Voting list command files for election config manager\n \n \n Require all granted\n \n \n\n # Voter list update files for election config manager\n \n \n Require all granted\n \n \n\n\n\n# JSON data for user interface\n\n AllowOverride None\n Require all denied\n\n ExpiresActive on\n ExpiresDefault \"access plus 1 second\"\n\n # Districts list, stats and status for every role\n \n \n Require all granted\n \n \n Require all granted\n \n \n Require all granted\n \n \n\n # Uploading status files for every role\n \n \n Require all granted\n \n \n Require all granted\n \n \n Require all granted\n \n \n\n\n# vim:ft=apache foldmethod=marker:\n" }, { "path": "collector-admin/config/rsyslog.conf", "content": "# IVXV Internet voting framework\n\n# Logging configuration\n# /etc/rsyslog.d/90-ivxv-admin.conf\n\n# Write audit log in JSON format\nif ($programname == 'ivxv_audit_log') then\naction(\n type=\"omfile\"\n file=\"/var/log/ivxv/ivxv-audit.log\"\n # template is defined by ivxv-common package\n template=\"ivxv-json\"\n)\n" }, { "path": "collector-admin/ivxv-collector-admin.conf", "content": "# IVXV Internet voting framework\n# Config file for collector admin utilities\n# This file should normally installed at /etc/ivxv-admin-utils.conf\n\n[DEFAULT]\n# base directory for management service data files\n#ivxv_admin_data_path = /var/lib/ivxv\n# directory for admin UI static data files (used directly by web UI)\n#admin_ui_data_path = %(ivxv_admin_data_path)s/admin-ui-data\n# directory for admin UI permissions\n#permissions_path = %(ivxv_admin_data_path)s/admin-ui-permissions\n# directory for applied command files\n#command_files_path = %(ivxv_admin_data_path)s/commands\n# directory for collector config files\n#active_config_files_path = /etc/ivxv\n# directory for uploaded files\n#file_upload_path = %(ivxv_admin_data_path)s/upload\n# directory for exported votes\n#exported_votes_path = %(ivxv_admin_data_path)s/ballot-box\n# directory for ivxv debian packages\n#deb_pkg_path = /etc/ivxv/debs\n# directory for VIS related data files (voter lists)\n#vis_path = %(ivxv_admin_data_path)s/vis\n# directory for service specific files\n#service_files_path = %(ivxv_admin_data_path)s/service\n\n# management database directory\n#ivxv_db_path = %(ivxv_admin_data_path)s/db\n# management database file path\n#ivxv_db_file_path = %(ivxv_db_path)s/ivxv-management.db\n\n# ADMIN UTILS LOGGING\n# https://docs.python.org/3/howto/logging.html\n[loggers]\nkeys=root,\n ivxv_admin.admin_util,\n ivxv_admin.command_file,\n ivxv_admin.db,\n ivxv_admin.http_daemon,\n ivxv_admin.lib,\n ivxv_admin.service\n\n[handlers]\nkeys=null,\n console,\n stdout,\n stdout_service,\n syslog\n\n[formatters]\nkeys=console,\n stdout,\n stdout_service,\n syslog\n\n\n# LOGGERS\n\n# root logger\n[logger_root]\nlevel=DEBUG\n# Send all log to syslog\nhandlers=syslog\n\n# Admin utility logger\n[logger_ivxv_admin.admin_util]\nlevel=DEBUG\nqualname=ivxv_admin.admin_util\nhandlers=stdout\n\n# Command file handling module logger\n[logger_ivxv_admin.command_file]\nlevel=DEBUG\nqualname=ivxv_admin.command_file\nhandlers=console\n\n# Database layer logger\n[logger_ivxv_admin.db]\nlevel=INFO\nqualname=ivxv_admin.db\nhandlers=console\n\n# Management daemon logger\n[logger_ivxv_admin.http_daemon]\nlevel=INFO\nqualname=ivxv_admin.http_daemon\nhandlers=null\n\n# Lib module logger\n[logger_ivxv_admin.lib]\nlevel=DEBUG\nqualname=ivxv_admin.lib\nhandlers=console\n\n# Service configurator logger\n[logger_ivxv_admin.service]\nlevel=DEBUG\nqualname=ivxv_admin.service\nhandlers=stdout_service\n\n\n# LOG HANDLERS\n\n# Console handler - output log to stderr\n[handler_console]\nclass=StreamHandler\nlevel=INFO\nformatter=console\nargs=(sys.stderr,)\n\n# Stdout handler - output log to stdout\n[handler_stdout]\nclass=StreamHandler\nlevel=INFO\nformatter=stdout\nargs=(sys.stdout,)\n\n# Stdout handler for service module - output log to stdout\n[handler_stdout_service]\nclass=StreamHandler\nlevel=INFO\nformatter=stdout_service\nargs=(sys.stdout,)\n\n# Null handler - drop log messages\n[handler_null]\nclass=NullHandler\nargs=()\n\n# Syslog handler\n[handler_syslog]\nclass=handlers.SysLogHandler\nlevel=DEBUG\nformatter=syslog\nargs=('/dev/log', handlers.SysLogHandler.LOG_LOCAL4)\n\n\n# LOG FORMATTERS\n\n# console formatter\n[formatter_console]\nformat=%(module)s:%(levelname)s: %(message)s\n\n# stdout formatter\n[formatter_stdout]\nformat=%(levelname)s: %(message)s\n\n# stdout formatter for service module\n[formatter_stdout_service]\nformat=%(message)s\n\n# syslog formatter\n[formatter_syslog]\nformat=%(name)s %(message)s\n\n# vim:ft=dosini:\n" }, { "path": "collector-admin/ivxv_admin/__init__.py", "content": "# IVXV Internet voting framework\n\"\"\"Collector Management Service.\"\"\"\n\n__version__ = '1.10.3'\nDEB_PKG_VERSION = '1.10.3'\n\n#: Management daemon data\nMANAGEMENT_DAEMON_PORT = 8080\nMANAGEMENT_DAEMON_URL = f\"http://localhost:{MANAGEMENT_DAEMON_PORT}/\"\n\n#: RFC3339 date format\nRFC3339_DATE_FORMAT = '%Y-%m-%dT%H:%M:%S.%f'\n#: RFC3339 date format (without second fractions)\nRFC3339_DATE_FORMAT_WO_FRACT = '%Y-%m-%dT%H:%M:%SZ'\n\n#: User permissions\nPERMISSION_BALLOT_BOX_DOWNLOAD = 'download-ballot-box'\nPERMISSION_ELECTION_CONF = 'election-conf-admin'\nPERMISSION_LOG_VIEW = 'log-view'\nPERMISSION_STATS_VIEW = 'stats-view'\nPERMISSION_TECH_CONF = 'tech-conf-admin'\nPERMISSION_USERS_ADMIN = 'user-admin'\n#: User roles\nUSER_ROLES = {\n 'admin': {\n 'description': 'Administrator',\n 'permissions': (\n PERMISSION_BALLOT_BOX_DOWNLOAD,\n PERMISSION_ELECTION_CONF,\n PERMISSION_LOG_VIEW,\n PERMISSION_STATS_VIEW,\n PERMISSION_TECH_CONF,\n PERMISSION_USERS_ADMIN,\n ),\n },\n 'election-conf-manager': {\n 'description': 'Election config manager',\n 'permissions': (\n PERMISSION_BALLOT_BOX_DOWNLOAD,\n PERMISSION_ELECTION_CONF,\n PERMISSION_STATS_VIEW\n ),\n },\n 'viewer': {\n 'description': 'Viewer',\n 'permissions': (\n PERMISSION_STATS_VIEW,\n ),\n },\n 'none': {\n 'description': 'No permissions',\n 'permissions': tuple(),\n },\n}\n\n#: Config types\nCFG_TYPES = {\n 'trust': 'trust root configuration',\n 'election': 'elections configuration',\n 'technical': 'collectors technical configuration',\n}\n#: Voting list types\nVOTING_LIST_TYPES = {\n 'choices': 'choices list',\n 'districts': 'districts list',\n 'voters': 'voters list',\n}\n#: Command types\nCMD_TYPES = list(CFG_TYPES) + list(VOTING_LIST_TYPES) + ['user']\n#: Command descriptions\nCMD_DESCR = {'user': 'user permissions configuration'}\nCMD_DESCR.update(CFG_TYPES)\nCMD_DESCR.update(VOTING_LIST_TYPES)\n\n\n#: Collector states\nCOLLECTOR_STATE_NOT_INSTALLED = 'NOT INSTALLED'\nCOLLECTOR_STATE_INSTALLED = 'INSTALLED'\nCOLLECTOR_STATE_CONFIGURED = 'CONFIGURED'\nCOLLECTOR_STATE_FAILURE = 'FAILURE'\nCOLLECTOR_STATE_PARTIAL_FAILURE = 'PARTIAL FAILURE'\nCOLLECTOR_STATES = [\n COLLECTOR_STATE_NOT_INSTALLED,\n COLLECTOR_STATE_INSTALLED,\n COLLECTOR_STATE_CONFIGURED,\n COLLECTOR_STATE_FAILURE,\n COLLECTOR_STATE_PARTIAL_FAILURE,\n]\n\n#: Service states\nSERVICE_STATE_NOT_INSTALLED = 'NOT INSTALLED'\nSERVICE_STATE_INSTALLED = 'INSTALLED'\nSERVICE_STATE_CONFIGURED = 'CONFIGURED'\nSERVICE_STATE_FAILURE = 'FAILURE'\nSERVICE_STATE_REMOVED = 'REMOVED'\nSERVICE_STATES = [\n SERVICE_STATE_NOT_INSTALLED,\n SERVICE_STATE_INSTALLED,\n SERVICE_STATE_CONFIGURED,\n SERVICE_STATE_FAILURE,\n SERVICE_STATE_REMOVED,\n]\n\n#: Service states included to status monitoring\nSERVICE_MONITORING_STATES = [SERVICE_STATE_CONFIGURED, SERVICE_STATE_FAILURE]\n\n#: Service type parameters.\n#: ``main_service`` - is service required to collect votes\n#: (*False* = support service);\n#: **require_config** - does service require election config package for\n#: operation;\n#: ``require_tls`` - does service require TLS certificate and key to\n#: ``tspreg`` - can communicate with TSP registration service\n#: ``mobile_id`` - can communicate with Mobile ID service\n#: communicate with other services;\nSERVICE_TYPE_PARAMS = {\n 'backup': {\n 'main_service': False,\n 'require_config': False,\n 'require_tls': False,\n 'tspreg': False,\n 'mobile_id': False,\n },\n 'choices': {\n 'main_service': True,\n 'require_config': True,\n 'require_tls': True,\n 'tspreg': False,\n 'mobile_id': True,\n },\n 'log': {\n 'main_service': False,\n 'require_config': False,\n 'require_tls': False,\n 'tspreg': False,\n 'mobile_id': False,\n },\n 'mid': {\n 'main_service': True,\n 'require_config': True,\n 'require_tls': True,\n 'tspreg': False,\n 'mobile_id': True,\n },\n 'votesorder': {\n 'main_service': True,\n 'require_config': True,\n 'require_tls': True,\n 'tspreg': False,\n 'mobile_id': False,\n },\n 'proxy': {\n 'main_service': True,\n 'require_config': True,\n 'require_tls': False,\n 'tspreg': False,\n 'mobile_id': False,\n },\n 'smartid': {\n 'main_service': True,\n 'require_config': True,\n 'require_tls': True,\n 'tspreg': False,\n 'mobile_id': True,\n },\n 'webeid': {\n 'main_service': True,\n 'require_config': True,\n 'require_tls': True,\n 'tspreg': False,\n 'mobile_id': True,\n },\n 'storage': {\n 'main_service': True,\n 'require_config': True,\n 'require_tls': True,\n 'tspreg': False,\n 'mobile_id': False,\n },\n 'verification': {\n 'main_service': True,\n 'require_config': True,\n 'require_tls': True,\n 'tspreg': False,\n 'mobile_id': False,\n },\n 'voting': {\n 'main_service': True,\n 'require_config': True,\n 'require_tls': True,\n 'tspreg': True,\n 'mobile_id': True,\n },\n 'sessionstatus': {\n 'main_service': True,\n 'require_config': True,\n 'require_tls': True,\n 'tspreg': False,\n 'mobile_id': False,\n },\n}\n\n#: Service secret types\nSERVICE_SECRET_TYPES = {\n 'tls-cert': {\n 'description': 'Service TLS certificate',\n 'db-key': 'tls-cert',\n 'target-path': '/var/lib/ivxv/service/{service_id}/tls.pem',\n 'shared': False,\n },\n 'tls-key': {\n 'description': 'Service TLS key',\n 'db-key': 'tls-key',\n 'target-path': '/var/lib/ivxv/service/{service_id}/tls.key',\n 'shared': False,\n },\n 'mid-token-key': {\n 'description': 'Mobile-ID/Smart-ID/Web eID identity token',\n 'db-key': 'mid-token-key',\n 'target-path': '/var/lib/ivxv/service/ticket.key',\n 'shared': True,\n },\n 'tsp-regkey': {\n 'description': 'PKIX TSP registration key',\n 'db-key': 'tspreg-key',\n 'target-path': '/var/lib/ivxv/service/{service_id}/tspreg.key',\n 'shared': False,\n },\n}\n\n#: Filenames of collector deb packages\nCOLLECTOR_PKG_FILENAMES = {\n 'ivxv-admin': f'ivxv-admin_{DEB_PKG_VERSION}_amd64.deb',\n 'ivxv-backup': f'ivxv-backup_{DEB_PKG_VERSION}_amd64.deb',\n 'ivxv-choices': f'ivxv-choices_{DEB_PKG_VERSION}_amd64.deb',\n 'ivxv-common': f'ivxv-common_{DEB_PKG_VERSION}_all.deb',\n 'ivxv-log': f'ivxv-log_{DEB_PKG_VERSION}_all.deb',\n 'ivxv-mid': f'ivxv-mid_{DEB_PKG_VERSION}_amd64.deb',\n 'ivxv-votesorder': f'ivxv-votesorder_{DEB_PKG_VERSION}_amd64.deb',\n 'ivxv-smartid': f'ivxv-smartid_{DEB_PKG_VERSION}_amd64.deb',\n 'ivxv-webeid': f'ivxv-webeid_{DEB_PKG_VERSION}_amd64.deb',\n 'ivxv-proxy': f'ivxv-proxy_{DEB_PKG_VERSION}_amd64.deb',\n 'ivxv-storage': f'ivxv-storage_{DEB_PKG_VERSION}_amd64.deb',\n 'ivxv-verification': f'ivxv-verification_{DEB_PKG_VERSION}_amd64.deb',\n 'ivxv-voting': f'ivxv-voting_{DEB_PKG_VERSION}_amd64.deb',\n 'ivxv-sessionstatus': f'ivxv-sessionstatus_{DEB_PKG_VERSION}_amd64.deb',\n}\n\n#: Event log filename\nEVENT_LOG_FILENAME = 'ivxv-management-events.log'\n\n#: Event descriptions\nEVENTS = {\n # collector state events\n \"COLLECTOR_INIT\": \"Initialize Collector\",\n \"COLLECTOR_RESET\":\n f\"Reset Collector (state: {COLLECTOR_STATE_NOT_INSTALLED!r})\",\n \"COLLECTOR_STATE_CHANGE\":\n \"Collector state changed from {last_state!r} to {state!r}\",\n # command loading events\n \"CMD_LOAD\": \"Load command {cmd_type!r} version {version!r}\",\n \"CMD_LOADED\": \"Command {cmd_type!r} is loaded, version {version!r}\",\n \"CMD_REMOVED\": \"Command {cmd_type!r} is removed, version {version!r}\",\n # voter list downloading events\n \"VOTER_LIST_DOWNLOADED\": \"Downloaded voter list changeset #{changeset_no}\",\n \"VOTER_LIST_DOWNLOAD_FAILED\":\n \"Failed to download voter list changeset #{changeset_no}\",\n # user permission management events\n \"PERMISSION_SET\": \"Add permission {permission!r} to user {user_cn!r}\",\n \"PERMISSION_RESET\": \"Reset user {user_cn!r} permissions\",\n # election start/stop times registering\n \"SET_ELECTION_TIME\": \"Election {period!r} timestamp set to {timestamp}\",\n # service management events\n \"SERVICE_REGISTER\":\n f\"Add {{service_type}} service (state: {SERVICE_STATE_NOT_INSTALLED!r})\",\n \"SERVICE_CONFIG_APPLY\": 'Applied {cfg_descr} version {cfg_version!r}',\n \"SERVICE_STATE_CHANGE\": 'Service state changed from {last_state!r} to {state!r}',\n \"SECRET_INSTALL\": \"{secret_descr} loaded to service\",\n}\n" }, { "path": "collector-admin/ivxv_admin/agent_daemon.py", "content": "# IVXV Internet voting framework\n\"\"\"\nAgent daemon for collector management service.\n\nThis daemon is managed by systemd.\n\n* Systemd service file:\n :file:`/lib/systemd/system/ivxv-admin.service`\n\n* Query daemon status:\n :command:`systemctl status ivxv-admin`\n\n* Start daemon:\n :command:`systemctl stop ivxv-admin`\n\n* Stop daemon:\n :command:`systemctl status ivxv-admin`\n\"\"\"\n\nimport datetime\nimport json\nimport logging\nimport os\nimport re\nimport subprocess\nimport time\nimport typing\n\nimport dateutil.parser\n\nfrom . import (CMD_DESCR, RFC3339_DATE_FORMAT, SERVICE_MONITORING_STATES,\n SERVICE_STATE_CONFIGURED, SERVICE_STATE_FAILURE, lib)\nfrom .cli_utils import init_cli_util\nfrom .config import cfg_path\nfrom .db import DB_FILE_PATH, IVXVManagerDb\nfrom .event_log import register_service_event\nfrom .lib.lockfile import PidLocker\nfrom .service.service import Service\n\n# create logger\nlog = logging.getLogger(__name__)\n\n#: Service ping interval in seconds.\nPING_INTERVAL = 60\n#: State file path.\nSTATE_FILEPATH = cfg_path(\"admin_ui_data_path\", \"status.json\")\n#: Stats file path.\nSTATS_FILEPATH = cfg_path('admin_ui_data_path', 'stats.json')\n#: Maximum count of automatic attempts to apply config\nMAX_AUTO_ATTEMPTS = 3\n#: Unix epoch timestamp\nUNIX_EPOCH_TIMESTAMP = '1970-01-01T00:00:00'\n\n\ndef main_loop():\n \"\"\"Agent daemon main loop.\"\"\"\n args = init_cli_util(\"\"\"\n IVXV Collector Management Service agent daemon.\n\n Usage: ivxv-agent-daemon [--get-stats] [--register-status]\n\n Options:\n --get-stats Copy statistics from Log Monitor to\n Management Service without daemonizing.\n --register-status Register collector state (if not registered).\n \"\"\")\n\n # copy stats and finish process\n if args['--get-stats'] and args[\"--register-status\"]:\n log.error('Conflicting options: --get-stats and --register-status')\n return 1\n if args['--get-stats']:\n return generate_stats_data(force=True)\n if args[\"--register-status\"]:\n with IVXVManagerDb(for_update=True) as db:\n register_collector_state(db)\n return 0\n\n # daemon process\n log.info('Starting Collector Management Service agent daemon')\n check_management_db()\n\n jobs: typing.Set[subprocess.Popen] = set()\n\n while True:\n loop_start_time = datetime.datetime.now()\n\n # generate stats/state data\n state = None\n try:\n PidLocker.rm_stale_pidfile('ivxv-config-apply.pid')\n state = generate_state_data()\n generate_stats_data()\n except OSError as err:\n log.error(err)\n except Exception as err: # pylint: disable=broad-except\n log.error(\n 'Unknown error while generating stats/state data: %s', err)\n finally:\n for job in jobs:\n if job.poll() is not None: # job is not yet terminated\n if job.stdin is not None:\n job.stdin.close()\n if job.stdout is not None:\n job.stdout.close()\n if job.stderr is not None:\n job.stderr.close()\n job.kill() # send SIGKILL to terminated process, just in case\n jobs.remove(job)\n\n # start config applying if required\n if state and len(jobs) == 0:\n jobs = apply_cfg(state)\n\n # pause after loop\n duration = datetime.datetime.now() - loop_start_time\n if duration.seconds < 5:\n log.debug('Sleeping for 5 seconds')\n time.sleep(5)\n else:\n time.sleep(1)\n\n\ndef generate_state_data():\n \"\"\"\n Ping services, generate state data and write it to :file:`status.json`.\n \"\"\"\n # fetch services data\n services = get_collector_data()\n if services:\n # sort services list in order of last data\n services_sorted = sorted([\n [service['last-data'], service_id]\n for service_id, service in services.items()])\n\n # check services\n for last_data_timestamp, service_id in services_sorted:\n service_data = services[service_id]\n if service_data['state'] not in SERVICE_MONITORING_STATES:\n # log.debug('Service %s state is %s, skipping check',\n # service_id, service_data['state'])\n continue\n next_check_timestamp = (\n dateutil.parser.parse(last_data_timestamp or\n UNIX_EPOCH_TIMESTAMP) +\n datetime.timedelta(seconds=PING_INTERVAL))\n if next_check_timestamp > datetime.datetime.now():\n log.debug('Service %s next check is in the future, '\n 'skipping check', service_id)\n continue\n\n ping_service(service_id, service_data)\n time.sleep(1)\n\n # generate state data\n with IVXVManagerDb(for_update=True) as db:\n state = register_collector_state(db)\n\n # generate config applying state\n state['config-apply'] = {}\n for cfg_key in ['trust', 'technical', 'election', 'choices', 'districts']:\n get_cfg_applying_state(cfg_key, state)\n for changeset_no in range(10_000):\n if not get_cfg_applying_state(f\"voters{changeset_no:04}\", state):\n break\n\n # write state data to file\n state['meta'] = get_agent_metadata()\n with open(STATE_FILEPATH, \"w\") as fp:\n fp.write(json.dumps(state, indent=4, sort_keys=True))\n\n return state\n\n\ndef get_cfg_applying_state(cfg_key, state):\n \"\"\"Get config applying state.\n\n :return: True if config file exist and state data is generated,\n False if config file does not exist.\n \"\"\"\n cfg_filepath = lib.get_loaded_cfg_file_path(cfg_key)\n if cfg_filepath is None:\n return False\n state_file_filepath = cfg_filepath.replace(\n os.path.splitext(cfg_filepath)[1], \".json\"\n )\n\n try:\n with open(state_file_filepath) as fp:\n apply_state = json.load(fp)\n state['config-apply'][cfg_key] = {\n 'version': apply_state['config_version'],\n 'attempts': apply_state['attempts'],\n 'completed': apply_state['completed'],\n 'state_file': os.path.basename(state_file_filepath),\n }\n except FileNotFoundError:\n state['config-apply'][cfg_key] = {}\n state['config-apply'][cfg_key]['cmd_file'] = os.path.basename(cfg_filepath)\n\n return True\n\n\ndef get_agent_metadata():\n \"\"\"Generate agent metadata block.\"\"\"\n timestamp = datetime.datetime.utcnow()\n return dict(generator='IVXV Management Service Agent Daemon',\n time_generated=timestamp.strftime('%Y-%m-%dT%H:%M:%SZ'))\n\n\ndef apply_cfg(state) -> typing.Set[subprocess.Popen]:\n \"\"\"Apply config files.\"\"\"\n jobs: typing.Set[subprocess.Popen] = set()\n\n job = apply_cfg_for_services(\"technical\", \"technical\", state)\n if job is not None and job is not False:\n jobs.add(job)\n\n if state['config']['technical']:\n for cfg_key in [\"election\", \"choices\", \"districts\"]:\n job = apply_cfg_for_services(cfg_key, cfg_key, state)\n if job is not None and job is not False:\n jobs.add(job)\n for changeset_no in range(10_000):\n job = apply_cfg_for_services(\"voters\", f\"voters{changeset_no:04}\", state)\n if job is None: # voter list doesn't exist or currently being loaded\n break\n if job is False: # voter list has already been loaded\n continue\n jobs.add(job)\n\n return jobs\n\n\ndef apply_cfg_for_services(cfg_type, cfg_key, state) -> subprocess.Popen | bool | None:\n \"\"\"Apply config for services.\n\n :return: None if config file does not exist,\n True if config applying is started,\n False if config applying is not started.\n \"\"\"\n cfg_filepath = lib.get_loaded_cfg_file_path(cfg_key)\n if cfg_filepath is None:\n return None\n\n state_file_filepath = cfg_filepath.replace(\n os.path.splitext(cfg_filepath)[1], \".json\"\n )\n with open(state_file_filepath) as fp:\n state = json.load(fp)\n\n # check preconditions\n if (not state['autoapply'] or\n state['completed'] or\n state['attempts'] >= MAX_AUTO_ATTEMPTS):\n return False\n\n if PidLocker.pidfile_exists('ivxv-config-apply.pid'):\n log.info('Can\\'t start automatic applying of %s, pidfile exists',\n CMD_DESCR[cfg_type])\n return None\n\n # execute config applying command\n log.info('Automatically apply %s, attempt #%d',\n CMD_DESCR[cfg_type], state['attempts'] + 1)\n\n return subprocess.Popen(\n args=['ivxv-config-apply', f'--type={cfg_type}'],\n stdin=subprocess.DEVNULL,\n stdout=subprocess.DEVNULL,\n stderr=subprocess.DEVNULL,\n )\n\n\ndef ping_service(service_id, service_data):\n \"\"\"Ping service.\"\"\"\n with Service(service_id, service_data) as service:\n service_ok = service.ping()\n\n if not is_db_accessible(service.get_db_key(\"last-data\")):\n return False\n\n # register result in database\n with IVXVManagerDb(for_update=True) as db:\n db.set_value(\n service.get_db_key('last-data'),\n datetime.datetime.now().strftime(RFC3339_DATE_FORMAT))\n\n ping_errors_key = service.get_db_key('ping-errors')\n ping_errors_old = db.get_value(ping_errors_key)\n\n service_state_key = service.get_db_key('state')\n service_state_old = db.get_value(service_state_key)\n\n if service_state_old not in SERVICE_MONITORING_STATES:\n log.warning('Service has removed from monitoring')\n return False\n\n service_state_new = service_state_old\n if service_ok:\n log.debug('Service %s is alive', service_id)\n ping_errors_new = '0'\n service_state_new = SERVICE_STATE_CONFIGURED\n if ping_errors_old != '0':\n db.set_value(ping_errors_key, '0')\n else:\n ping_errors_new = str(int(ping_errors_old) + 1)\n if (int(ping_errors_new) >= 3 and\n service_state_old != SERVICE_STATE_FAILURE):\n log.warning('Status check failed three times, '\n 'setting service state from %s to FAILURE',\n service_state_old)\n service_state_new = SERVICE_STATE_FAILURE\n else:\n log.warning('Status check for service %s failed (%s times). '\n 'Service state is %s',\n service_id, ping_errors_new, service_state_old)\n\n if ping_errors_old != ping_errors_new:\n db.set_value(ping_errors_key, ping_errors_new)\n if service_state_old != service_state_new:\n db.set_value(service_state_key, service_state_new)\n register_collector_state(db)\n\n return service_ok\n\n\ndef generate_stats_data(force=False):\n \"\"\"Generate stats data and write it to :file:`stats.json`.\n\n :param force: Force check even the next check timestamp is in the future.\n :type force: bool\n \"\"\"\n # read existing stats file\n stats = {}\n try:\n with open(STATS_FILEPATH) as fp:\n stats = json.load(fp)\n except json.decoder.JSONDecodeError as err:\n log.error(\"Invalid JSON in existing stats file %r: %s\", STATS_FILEPATH, err)\n except OSError as err:\n log.error(\"Cannot load existing stats JSON file %r: %s\", STATS_FILEPATH, err)\n stats.setdefault('data', {})\n\n # import stats file from Log Monitor\n logmon_address, last_data_timestamp = get_logmon_data()\n if logmon_address:\n next_check_timestamp = (\n dateutil.parser.parse(last_data_timestamp) +\n datetime.timedelta(seconds=PING_INTERVAL))\n if not force and next_check_timestamp > datetime.datetime.now():\n log.debug('Log Monitor service next check is in the future, '\n 'skipping check')\n else:\n stats_data = query_logmon_stats(logmon_address)\n if 'error' in stats_data:\n stats['error'] = stats_data['error']\n else:\n normalize_stats(stats_data)\n stats['data'] = stats_data\n try:\n del stats['error']\n except KeyError:\n pass\n else:\n stats = {'error': 'Log Monitor address is not defined'}\n log.error(stats['error'])\n\n # update metadata\n stats['meta'] = get_agent_metadata()\n\n # write stats data to file\n with open(STATS_FILEPATH, 'w') as fp:\n fp.write(json.dumps(stats, indent=4, sort_keys=True))\n\n\ndef normalize_stats(stats_data):\n \"\"\"Normalize Log Monitor stats.\n\n Convert dictionaries to sorted lists.\n \"\"\"\n for district_id, district_stats in sorted(stats_data.items()):\n if district_id == 'time':\n continue\n for stats_key, stats_val in district_stats.items():\n if isinstance(stats_val, dict):\n stats_data[district_id][stats_key] = sorted(\n [[item[0], item[1]] for item in stats_val.items()],\n reverse=True\n )[:10 if stats_key in [\n 'voting-operating-systems',\n 'verify-operating-system'] else 100]\n\n # generate empty values for missing districts.\n # Log Monitor does not have district list and cannot generate stats for\n # districts that have no voter data. Generate empty data for such\n # districts.\n districts = []\n districts_filename = cfg_path('admin_ui_data_path', 'districts.json')\n try:\n with open(districts_filename) as fp:\n districts = json.load(fp)\n except FileNotFoundError:\n log.debug('Missing districts list. '\n 'Will not generate empty blocks for missing districts')\n empty_stats = dict(\n [key, (list() if isinstance(val, list) else 0)]\n for key, val in stats_data['TOTAL'].items())\n for district_id, _ in districts:\n if district_id not in stats_data:\n stats_data[district_id] = empty_stats\n\n\ndef query_logmon_stats(address):\n \"\"\"Query stats file from Log Monitor service.\n\n Query stats file from Log Monitor service and register last query timestamp\n in the management database.\n\n :return: Stats data. Existing stats data is returned with error message in\n ``error`` value if query fails.\n :rtype: dict\n \"\"\"\n ssh_cmd = [\n 'ssh', '-T', '-o', 'PreferredAuthentications=publickey',\n f\"logmon@{address}\", \"cat\", \"/var/lib/ivxv/stats.json\"\n ]\n\n log.debug('Querying stats from Log Monitor')\n proc = subprocess.run(\n ssh_cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE, check=False\n )\n\n stats = {}\n if proc.returncode:\n log.error(\n 'Querying stats from Log Monitor finished with error code %d',\n proc.returncode)\n stats['error'] = (\n 'Error while transporting stats data from Log Monitor over SSH:'\n f\"\\n {proc.stderr.decode('utf-8')}\"\n )\n else:\n try:\n stats = json.loads(proc.stdout.decode('utf-8'))\n except json.JSONDecodeError as err:\n errmsg = f\"{err.msg}: line {err.lineno} column {err.colno} (char {err.pos})\"\n stats['error'] = f'Invalid JSON data from Log Monitor: {errmsg}'\n log.error('Error while parsing JSON stats from Log Monitor: %s',\n errmsg)\n\n if is_db_accessible(\"logmonitor/last-data\"):\n with IVXVManagerDb(for_update=True) as db:\n db.set_value('logmonitor/last-data',\n datetime.datetime.now().strftime(RFC3339_DATE_FORMAT))\n\n return stats\n\n\ndef check_management_db():\n \"\"\"Check management database file.\n\n Wait if database file does not exist.\n \"\"\"\n # wait if database does not exist\n check_interval = 1\n check_notif_interval = 60\n check_counter = 0\n while not os.path.exists(DB_FILE_PATH):\n if check_counter % check_notif_interval == 0:\n log.warning('Collector management database does not exist, '\n 'waiting')\n check_counter += 1\n time.sleep(check_interval)\n\n log.info('Collector management database is available')\n\n\ndef get_collector_data():\n \"\"\"Read collector data from management database.\n\n :return: service data or None if election config is not loaded.\n :rtype: dict\n \"\"\"\n with IVXVManagerDb() as db:\n election_cfg_ver = db.get_value('config/election')\n if not election_cfg_ver:\n return None\n\n services = {}\n for key in db.keys():\n if re.match(r'service/', key):\n service_id, field_name = key.split('/')[1:]\n services[service_id] = services.get(service_id, {})\n services[service_id][field_name] = db.get_value(key)\n\n return services\n\n\ndef get_logmon_data():\n \"\"\"Read logmonitor address from management database.\n\n :return: Log Monitor data: [address, last_data_timestamp].\n :rtype: list\n \"\"\"\n with IVXVManagerDb() as db:\n address = db.get_value('logmonitor/address')\n last_data_timestamp = db.get_value('logmonitor/last-data')\n\n if not last_data_timestamp:\n last_data_timestamp = UNIX_EPOCH_TIMESTAMP\n\n return [address, last_data_timestamp]\n\n\ndef register_collector_state(db):\n \"\"\"Detect collector state and register state change in database.\"\"\"\n state = lib.generate_collector_state(db)\n last_state = state['collector']['state']\n if state['collector_state'] != last_state:\n log.info('Registering new state for collector: %s',\n state['collector_state'])\n db.set_value('collector/state', state['collector_state'])\n register_service_event(\n 'COLLECTOR_STATE_CHANGE',\n params={\n 'state': state['collector_state'],\n 'last_state': last_state\n })\n\n return state\n\n\ndef is_db_accessible(check_value):\n \"\"\"Try to read field value from database before writing it.\n\n If this fails, then something is happened with database (e.g. database is\n recreated during service reset) and writing to database must be cancelled.\n \"\"\"\n with IVXVManagerDb() as db:\n try:\n db.get_value(check_value)\n except KeyError:\n log.warning(\"Cannot read value %r from database\", check_value)\n return False\n\n return True\n" }, { "path": "collector-admin/ivxv_admin/cli_utils/__init__.py", "content": "# IVXV Internet voting framework\n\"\"\"CLI utilities.\"\"\"\n\nimport logging\nimport os\nimport sys\nimport textwrap\n\nfrom docopt import docopt\n\nfrom .. import __version__\nfrom ..config import CONFIG\n\nassert CONFIG # logging is configured by config module\nlog = logging.getLogger('ivxv_admin.admin_util')\n\n\ndef init_cli_util(docstr, allow_root=False):\n \"\"\"\n Initialize command line utility.\n\n 1. Validate command line arguments\n 2. Set up logging\n\n Config file :file:`ivxv-collector-admin.conf` is searched from the\n following locations:\n\n * current directory\n\n * :file:`/etc/ivxv`\n\n * directory specified by environment variable :envvar:`IVXV_ADMIN_CONF`\n\n * file specified by environment variable :envvar:`IVXV_ADMIN_CONF`\n \"\"\"\n # validate CLI arguments\n cli_args = docopt(textwrap.dedent(docstr), version=__version__)\n\n # set log level\n log.setLevel(cli_args.get('--log-level', 'INFO'))\n\n # check user rights\n if not allow_root and not os.getuid():\n log.error('IVXV collector admin utils cannot be run as root')\n sys.exit(1)\n\n return cli_args\n\n\ndef ask_user_confirmation(question):\n \"\"\"Ask user confirmation.\n\n :return: True if user answers \"Yes\" or False if not.\n \"\"\"\n while True:\n answer = input(question).upper()\n if answer in 'YN':\n return answer == 'Y'\n" }, { "path": "collector-admin/ivxv_admin/cli_utils/admin_storage_utils.py", "content": "# IVXV Internet voting framework\n\"\"\"CLI utilities for management service data storage.\"\"\"\n\nimport os\nimport re\nimport shutil\nimport sys\n\nfrom .service_utils import remove_ivxv_admin_crontab\nfrom ..config import CONFIG, cfg_path\nfrom ..db import IVXVManagerDb, check_db_dir\nfrom ..event_log import init_event_log\nfrom ..lib import IvxvError, clean_dir\nfrom . import ask_user_confirmation, init_cli_util, log\n\n#: Config value names for Management Service data directories\nMANAGEMENT_PATH_PARAM_NAMES = [\n 'ivxv_admin_data_path',\n 'admin_ui_data_path',\n 'permissions_path',\n 'command_files_path',\n 'active_config_files_path',\n 'file_upload_path',\n 'exported_votes_path',\n 'deb_pkg_path',\n 'ivxv_db_path',\n 'vis_path',\n]\n\n\ndef ivxv_create_data_dirs_util():\n \"\"\"Create management service data directories.\"\"\"\n init_cli_util(\n \"\"\"\n Create IVXV Collector Management Service data directories.\n\n NOTE: Directory owners and permissions are not set by this utility!\n\n Usage: ivxv-create-data-dirs\n \"\"\",\n allow_root=True)\n\n # config parameter names for directories\n for cfg_var in MANAGEMENT_PATH_PARAM_NAMES:\n dirname = CONFIG[cfg_var]\n if os.path.exists(dirname):\n log.info(\"Path %r already exist\", dirname)\n else:\n log.info(\"Creating data directory %r\", dirname)\n os.mkdir(dirname)\n if not os.path.isdir(dirname):\n log.error(\"Path %r is not a directory\", dirname)\n return 1\n\n return 0\n\n\ndef ivxv_collector_init_util():\n \"\"\"Initialize IVXV Collector.\"\"\"\n args = init_cli_util(\"\"\"\n Initialize IVXV Collector.\n\n Usage: ivxv-collector-init [--force]\n\n Options:\n --force Don't ask user confirmation\n \"\"\")\n\n # ask confirmation\n if not args['--force']:\n if not ask_user_confirmation(\n 'Do You want to initialize IVXV Collector (Y=yes) ?'):\n return 1\n\n # remove ivxv-admin crontab if exist\n remove_ivxv_admin_crontab()\n\n # initialize data directories\n try:\n init_data_directories()\n except IvxvError as err:\n log.error(err)\n return 1\n\n # initialize management database\n init_management_database()\n\n init_event_log()\n\n return 0\n\n\ndef database_util():\n \"\"\"Management service database utility.\"\"\"\n args = init_cli_util(\"\"\"\n Add, remove or modify key/value pairs in\n IVXV Collector Management Service database.\n\n WARNING!\n Use this utility only for testing purposes!\n Never change database in production systems!\n\n Usage: ivxv-db \n ivxv-db --del \n \"\"\")\n\n # check database directory\n if not check_db_dir():\n return 1\n\n # process record\n with IVXVManagerDb(for_update=True) as db:\n if args['--del']:\n db.rm_value(args[''])\n log.info(\"Database value %r successfully removed\", args[\"\"])\n else:\n db.set_value(args[''], args[''])\n log.info(\"Database value %r set to %r\", args[\"\"], args[\"\"])\n\n return 0\n\n\ndef database_dump_util():\n \"\"\"Dump management service database.\"\"\"\n args = init_cli_util(\"\"\"\n Dump IVXV Collector Management Service database.\n\n Usage: ivxv-db-dump [] ...\n \"\"\")\n\n log.info('Dumping IVXV management database')\n\n # check database directory\n if not check_db_dir():\n return 1\n\n with IVXVManagerDb() as db:\n db.dump(args[''])\n\n return 0\n\n\ndef database_reset_util():\n \"\"\"Reset management service database.\"\"\"\n args = init_cli_util(\"\"\"\n Reset IVXV Collector Management Service database.\n\n Usage: ivxv-db-reset [--force]\n\n Options:\n --force Don't ask user confirmation\n \"\"\")\n\n # check database directory\n db_file_path = check_db_dir()\n if not db_file_path:\n return 1\n\n # ask confirmation\n if not args['--force']:\n if not ask_user_confirmation(\n 'Do You want to reset IVXV management database (Y=yes) ?'):\n return 1\n\n # initialize database\n init_management_database()\n\n # initialize data files\n init_management_datafiles()\n\n # initialize data directories\n clean_dir(CONFIG['file_upload_path'])\n\n return 0\n\n\ndef init_data_directories():\n \"\"\"Initialize data directories.\"\"\"\n for cfg_var in MANAGEMENT_PATH_PARAM_NAMES:\n dirpath = CONFIG[cfg_var]\n if not os.path.exists(dirpath):\n log.info(\"Creating directory %r\", dirpath)\n os.mkdir(dirpath)\n elif not os.path.isdir(dirpath):\n raise IvxvError(f\"Path {dirpath!r} is not a directory\")\n if cfg_var not in [\n \"ivxv_admin_data_path\",\n \"deb_pkg_path\",\n \"active_config_files_path\",\n ]:\n clean_dir(dirpath)\n patterns = (\n r\"(choices|districts|election|technical|trust|voters0000)\\.bdoc$\",\n r\"voters[0-9]{2}\\.zip$\",\n )\n for filename in os.listdir(CONFIG[\"active_config_files_path\"]):\n if any(re.match(pattern, filename) for pattern in patterns):\n os.unlink(cfg_path(\"active_config_files_path\", filename))\n\n init_management_datafiles()\n\n\ndef init_management_database():\n \"\"\"Initialize management database.\"\"\"\n log.debug('Initializing IVXV management database')\n\n IVXVManagerDb.reset()\n\n log.info('New management database is created with default values')\n\n\ndef init_management_datafiles():\n \"\"\"Initialize management data files.\"\"\"\n # install empty stats.json to admin UI data path\n module_path = os.path.dirname(sys.modules['ivxv_admin'].__file__)\n file_path = os.path.join(module_path, 'templates/stats.json')\n shutil.copy(file_path, CONFIG['admin_ui_data_path'])\n" }, { "path": "collector-admin/ivxv_admin/cli_utils/backup_utils.py", "content": "# IVXV Internet voting framework\n\"\"\"CLI utilities for backup service.\"\"\"\n\nimport datetime\nimport os\nimport random\nimport subprocess\nimport sys\nimport time\n\nfrom jinja2 import Environment, PackageLoader\n\nfrom .. import SERVICE_STATE_CONFIGURED\nfrom ..config import CONFIG\nfrom ..lib import get_services\nfrom ..service.service import Service\nfrom . import init_cli_util, log\n\n\ndef insert_backup_crontab(data: str, crontab: str) -> str:\n \"\"\"Wrap crontab in an ivxv_backup_crontab block and insert it to a data.\n\n :param data: any data\n :type data: str\n :param crontab: rendered ivxv_backup_crontab Jinja2 crontab template file\n :type crontab: str\n :return: data with an ivxv_backup_crontab block\n :rtype: str\n \"\"\"\n header = '### block ivxv_backup_crontab ###'\n tail = '### endblock ivxv_backup_crontab ###'\n return data + \"\\n\\n\" + header + \"\\n\" + crontab + \"\\n\" + tail + \"\\n\"\n\n\ndef __get_backup_crontab_block(data: str) -> (str, bool):\n \"\"\"Get ivxv_backup_crontab block from a data.\n\n :param data: any data\n :type data: str\n :return: ivxv_backup_crontab block and True on success,\n otherwise data and False\n :rtype: str, bool\n :raise ValueError: if ivxv_backup_crontab block's header or tail is malformed,\n however though, if both header and tail are malformed then function assumes that\n ivxv_backup_crontab block doesn't exist in a data\n \"\"\"\n header = '### block ivxv_backup_crontab ###'\n tail = '### endblock ivxv_backup_crontab ###'\n\n # remove leading and trailing whitespaces/newlines\n data_stripped = data.strip()\n\n # get start index of a header\n header_start_index = data_stripped.find(header)\n\n # get start index of a tail\n tail_start_index = data_stripped.find(tail)\n\n # both header and tail aren't present in a data_stripped\n if header_start_index < 0 and tail_start_index < 0:\n return data, False\n # both header and tail present in a data_stripped\n elif header_start_index >= 0 and tail_start_index >= 0:\n # get end index of a tail\n tail_end_index = tail_start_index + len(tail)\n # extract ivxv_backup_crontab block from a data_stripped\n return data_stripped[header_start_index:tail_end_index], True\n else:\n if header_start_index < 0:\n raise ValueError(\"malformed ### block ivxv_backup_crontab ###\")\n else:\n raise ValueError(\"malformed ### endblock ivxv_backup_crontab ###\")\n\n\ndef remove_backup_crontab(data: str) -> str:\n \"\"\"Remove ivxv_backup_crontab block from a data.\n\n :param data: any data\n :type data: str\n :return: data without ivxv_backup_crontab block\n :rtype: str\n \"\"\"\n block, found = __get_backup_crontab_block(data=data)\n if not found:\n return data\n return data.replace(block, '').strip()\n\n\ndef backup_crontab_generator_util():\n \"\"\"Generate crontab for backup automation.\"\"\"\n args = init_cli_util(\"\"\"\n Generate crontab for IVXV backup automation.\n\n This utility must be called as editor by crontab utility:\n\n $ env VISUAL=ivxv-backup-crontab crontab -e\n\n Usage: ivxv-backup-crontab \n \"\"\")\n filepath = args['']\n\n crontab_tmp_file_content: str\n\n # check input file\n try:\n with open(filepath) as fp:\n crontab_tmp_file_content = fp.read()\n except OSError as err:\n log.error(\"Can't read file %r: %s\", filepath, err.strerror)\n return 1\n\n # load crontab template\n tmpl_env = Environment(loader=PackageLoader('ivxv_admin', 'templates'))\n template = tmpl_env.get_template('ivxv_backup_crontab.jinja')\n\n # detect service states\n template_params = {'backup_times': []}\n backup_services = get_services(\n include_types=['backup'], service_state=[SERVICE_STATE_CONFIGURED])\n for service_val in backup_services.values():\n if service_val['backup-times']:\n template_params['backup_times'] = sorted(\n [[int(timeval.split(':')[0]), int(timeval.split(':')[1])]\n for timeval in service_val['backup-times'].split(' ')])\n template_params['configured_backup_services'] = backup_services\n template_params['configured_voting_services'] = sorted(\n get_services(\n include_types=['voting'],\n service_state=[SERVICE_STATE_CONFIGURED]))\n template_params['configured_log_collectors'] = sorted(\n get_services(\n include_types=['log'],\n service_state=[SERVICE_STATE_CONFIGURED],\n ))\n\n # render crontab\n backup_crontab = template.render(\n time_generated=datetime.datetime.now().strftime('%d.%M.%Y %H:%M:%S'),\n **template_params,\n )\n\n # remove old block:\n # ### block ivxv_backup_crontab ###\n # ...\n # ### endblock ivxv_backup_crontab ###\n # from a crontab temporary file if any exists\n try:\n without_backup_crontab = remove_backup_crontab(\n data=crontab_tmp_file_content)\n except ValueError as err:\n msg = \"Can't remove ivxv_backup_crontab block from a temporary file %r: %s\"\n log.error(msg, filepath, err.__str__())\n return 1\n\n # add new block to a crontab temporary file\n crontab = insert_backup_crontab(\n data=without_backup_crontab, crontab=backup_crontab)\n\n # Pause for 1 second. Crontab checks mtime to detect file modifications. It\n # seems that crontab can't detect mtime change if changes happens too\n # quickly (tested in Ubuntu Xenial).\n time.sleep(1)\n\n # override crontab temporary file with a new content\n try:\n with open(filepath, 'w') as fp:\n fp.write(crontab)\n except OSError as err:\n log.error(\"Can't write file %r: %s\", filepath, err.strerror)\n return 1\n\n return 0\n\n\ndef backup_util():\n \"\"\"Backup collector data.\"\"\"\n args = init_cli_util(\"\"\"\n Backup IVXV collector data.\n\n Usage: ivxv-backup management-conf\n ivxv-backup ballot-box []\n ivxv-backup log\n \"\"\")\n\n # execute ballot box and log backup command with ssh-agent wrapper\n if ((args['ballot-box'] or args['log'])\n and not os.environ.get('SSH_AUTH_SOCK')\n and not os.environ.get('SSH_AGENT_PID')):\n log.debug('Starting command with ssh-agent wrapper')\n os.execvp('ssh-agent', ['ssh-agent'] + sys.argv)\n\n services = get_services(include_types=['backup'],\n service_state=[SERVICE_STATE_CONFIGURED])\n if not services:\n log.error('Backup service is not defined')\n return 1\n\n # Only 1 'CONFIGURED' backup service is allowed at the same time\n assert len(services) == 1\n\n with Service(*list(services.items())[0]) as backup_service:\n log.debug('Backup service: %s', backup_service.service_id)\n if backup_service.data['state'] != SERVICE_STATE_CONFIGURED:\n log.error(\"Backup service state is %r (expected state is %r)\",\n backup_service.data['state'], SERVICE_STATE_CONFIGURED)\n return 1\n\n if args['management-conf']:\n return backup_management_cfg(backup_service)\n\n # copy list of known SSH hosts to backup server\n backup_service.scp(\n os.path.expanduser('~/.ssh/known_hosts'), '~/.ssh/',\n 'list of known SSH hosts')\n backup_timestamp = datetime.datetime.now().strftime('%Y%m%d_%H%M')\n\n if args['ballot-box']:\n backup_target = datetime.datetime.now().strftime(\n f'ballot-box-{backup_timestamp}.zip')\n services = get_services(\n include_types=['voting'],\n service_state=[SERVICE_STATE_CONFIGURED],\n )\n voting_service_id = (\n args[''] or random.choice(list(services)))\n if args[''] and voting_service_id not in services:\n log.error('Unknown voting service ID: %s', voting_service_id)\n return 1\n\n with Service(voting_service_id, services[voting_service_id]) as service:\n proc = backup_service.ssh(\n [\n 'ivxv-admin-sudo',\n 'backup-ballot-box',\n service.hostname,\n voting_service_id,\n backup_target,\n ],\n fwd_auth_agent=True,\n )\n\n else:\n assert args['log']\n services = get_services(\n include_types=['log'], service_state=[SERVICE_STATE_CONFIGURED])\n for log_collector_id in services:\n with Service(log_collector_id, services[log_collector_id]) as service:\n proc = backup_service.ssh(\n [\n 'ivxv-admin-sudo',\n 'backup-log',\n service.hostname,\n backup_timestamp,\n ],\n fwd_auth_agent=True,\n )\n if proc.returncode:\n break\n\n if proc.returncode:\n log.error('Command execution failed with error code %d',\n proc.returncode)\n return 1\n\n return 0\n\n\ndef exec_backup_service_cmd(backup_service, *cmd):\n \"\"\"Execute command in backup service.\n\n :raises OSError: if command fails\n \"\"\"\n proc = backup_service.ssh(list(cmd))\n if proc.returncode:\n raise OSError(\n f\"Command {' '.join(cmd)} failed in backup service \"\n f\"with exit code {proc.returncode}\"\n )\n\n\ndef backup_management_cfg(backup_service):\n \"\"\"Creating management config backup.\"\"\"\n log.info('Creating management config backup')\n backup_target = datetime.datetime.now().strftime('%Y%m%d_%H%M')\n backup_basedir = '/var/backups/ivxv/management-conf'\n backup_tmpdir = os.path.join(backup_basedir, f'tmp-{backup_target}')\n backup_tgt_path = os.path.join(backup_basedir, backup_target)\n\n dirs_to_backup = [\n ['config', '/etc/ivxv', 'etc'],\n [\n 'admin UI permissions', CONFIG['permissions_path'],\n 'admin-ui-permissions'\n ],\n ['command history', CONFIG['command_files_path'], 'commands'],\n ]\n try:\n exec_backup_service_cmd(backup_service, \"rm\", \"-rfv\", backup_tmpdir)\n exec_backup_service_cmd(backup_service, \"mkdir\", \"-v\", backup_tmpdir)\n for description, src_dir, tgt_dir in dirs_to_backup:\n log.info(\"Backing up %s directory %r\", description, src_dir)\n subprocess.run(\n [\n 'rsync',\n '-av',\n '--del',\n f\"{src_dir}/\",\n f'{backup_service.hostname}:{backup_tmpdir}/{tgt_dir}/',\n ],\n check=True,\n )\n exec_backup_service_cmd(backup_service, \"rm\", \"-rfv\", backup_tgt_path)\n exec_backup_service_cmd(\n backup_service, \"mv\", \"-v\", backup_tmpdir, backup_tgt_path\n )\n except (OSError, subprocess.CalledProcessError) as err:\n log.error(err)\n return 1\n\n return 0\n" }, { "path": "collector-admin/ivxv_admin/cli_utils/config_utils/__init__.py", "content": "# IVXV Internet voting framework\n\"\"\"CLI utilities for management service configuration.\"\"\"\n" }, { "path": "collector-admin/ivxv_admin/cli_utils/config_utils/command_load.py", "content": "# IVXV Internet voting framework\n\"\"\"CLI utilities for command loading.\"\"\"\n\nimport json\nimport os\nimport re\nimport shutil\nimport subprocess\n\nfrom ...cli_utils.service_utils import (\n create_voter_list_download_crontab,\n remove_ivxv_admin_crontab,\n generate_detail_stats_crontab,\n generate_voting_facts_crontab,\n install_detail_stats_crontab,\n install_voting_facts_crontab\n)\nfrom ... import CFG_TYPES, CMD_DESCR, CMD_TYPES, VOTING_LIST_TYPES\nfrom ...command_file import (\n check_cmd_signature,\n load_cfg_file_content,\n load_collector_cmd_file,\n)\nfrom ...config import cfg_path\nfrom ...db import IVXVManagerDb\nfrom ...event_log import register_service_event\nfrom ...lib import (\n IvxvError,\n get_current_voter_list_changeset_no,\n manage_db_mobileid_fields,\n manage_db_tsp_fields,\n populate_user_permissions,\n register_tech_cfg_items,\n)\nfrom .. import init_cli_util, log\n\n\ndef main():\n \"\"\"Load command to IVXV Collector Management Service.\"\"\"\n args = init_cli_util(\"\"\"\n Load command to IVXV Collector Management Service.\n\n Usage: ivxv-cmd-load [--autoapply] [--show-version] FILE\n\n Options:\n Command type. Possible values are:\n - election: election config\n - technical: collector technical config\n - trust: trust root config\n - choices: choices list\n - districts: districts list\n - voters: voters list or voters list skipping\n - user: user account and role(s)\n --autoapply Apply command file automatically (by Agent Daemon).\n --show-version Output config file version and exit.\n \"\"\")\n\n # validate CLI arguments\n cmd_type = args[''].lower()\n if cmd_type not in CMD_TYPES:\n log.error(\"Invalid command type %r. Possible values are: %s\",\n cmd_type, ', '.join(CMD_TYPES))\n return 1\n cfg_filename = args['FILE']\n\n # check command file signature and loading state\n try:\n check_cmd_loading_state(cmd_type)\n cfg_timestamp, cfg_version = check_signer_permissions(\n cmd_type, filename=args['FILE'])\n except IvxvError as err:\n log.error(str(err))\n return 1\n\n # output config version\n log.info(\"Config file version is %r\", cfg_version)\n if args['--show-version']:\n return 0\n\n # raise error if reloading current version\n if cmd_type in CFG_TYPES:\n with IVXVManagerDb() as db:\n if db.get_value(f'config/{cmd_type}') == cfg_version:\n log.error(\"%s version %r is already loaded\",\n CFG_TYPES[cmd_type].capitalize(), cfg_version)\n return 1\n\n # load config (includes config validation)\n log.info(\"Loading command %r from file %r\", CMD_DESCR[cmd_type], cfg_filename)\n cfg_data = load_collector_cmd_file(cmd_type, args['FILE'])\n if cfg_data is None:\n return 1\n\n # validate voting lists consistency\n if cmd_type in VOTING_LIST_TYPES:\n if not validate_lists_consistency(cmd_type, args['FILE']):\n return 1\n\n register_service_event(\n 'CMD_LOAD', params={'cmd_type': cmd_type, 'version': cfg_version})\n\n # reset database and remove crontab on trust root config loading\n if cmd_type == 'trust':\n log.info('Resetting collector management database')\n db = IVXVManagerDb()\n db.reset()\n\n remove_ivxv_admin_crontab()\n register_service_event('COLLECTOR_RESET')\n\n # register new and removed services on technical config loading\n elif cmd_type == 'technical':\n register_tech_cfg_items(cfg_data, cfg_version)\n\n # write districts JSON to web server data directory\n elif cmd_type == 'districts':\n districts_filename = cfg_path('admin_ui_data_path', 'districts.json')\n districts_list = sorted(\n [[dist_id, f'{dist_id} - {val[\"name\"]}']\n for dist_id, val in cfg_data['districts'].items()])\n log.info(\"Writing simplified district list to %r\", districts_filename)\n with open(districts_filename, 'w') as fp:\n json.dump(districts_list, fp)\n\n # generate detail stats crontab\n elif cmd_type == 'election':\n create_voter_list_download_crontab(cfg_data)\n generate_detail_stats_crontab(cfg_data)\n install_detail_stats_crontab()\n generate_voting_facts_crontab(cfg_data)\n install_voting_facts_crontab()\n\n # register loaded config\n cfg_state = None\n if cmd_type == \"voters\":\n cfg_state = \"SKIPPED\" if \"skip_voter_list\" in cfg_data else \"PENDING\"\n register_cfg(\n cmd_type,\n cfg_data,\n cfg_filename,\n cfg_timestamp,\n cfg_version,\n args[\"--autoapply\"],\n state=cfg_state,\n )\n register_service_event(\n 'CMD_LOADED', params={'cmd_type': cmd_type, 'version': cfg_version})\n\n return 0\n\n\ndef register_cfg(\n cmd_type, cfg_data, cfg_filename, cfg_timestamp, cfg_version, autoapply, state\n):\n \"\"\"Register config version in database and file system.\"\"\"\n db_key = 'config' if cmd_type in CFG_TYPES else 'list'\n cfg_file_ext = \"bdoc\"\n\n # connect to management service database\n with IVXVManagerDb(for_update=True) as db:\n # detect order number for voters list\n if cmd_type == 'voters':\n if state == \"SKIPPED\":\n changeset_no = cfg_data[\"changeset\"]\n else:\n changeset_no = get_current_voter_list_changeset_no(db) + 1\n if changeset_no:\n cfg_file_ext = \"zip\"\n active_cfg_filename = f\"voters{changeset_no:04}.{cfg_file_ext}\"\n db_key += f\"/voters{changeset_no:04}\"\n else:\n active_cfg_filename = f'{cmd_type}.bdoc'\n db_key += f\"/{cmd_type}\"\n\n # write config file to admin ui data path\n cmd_filepath = cfg_path(\n \"command_files_path\", f\"{cmd_type}-{cfg_timestamp}.{cfg_file_ext}\"\n )\n log.debug(\"Copying file %r to %r\", cfg_filename, cmd_filepath)\n shutil.copy(cfg_filename, cmd_filepath)\n log.info('%s file loaded successfully',\n CMD_DESCR[cmd_type].capitalize())\n\n # register config file version\n if cmd_type in CFG_TYPES or cmd_type in VOTING_LIST_TYPES:\n db.set_value(db_key, cfg_version)\n if cmd_type == 'voters':\n db.set_value(f\"{db_key}-state\", state)\n\n # register user permissions\n if cmd_type == 'trust': # initial permissions\n log.info('Resetting user permissions')\n for user_cn in db.get_all_values('user'):\n db.rm_value(f\"user/{user_cn}\")\n for user_cn in cfg_data['authorizations']:\n register_user_permissions(db, user_cn, [\"admin\"])\n\n elif cmd_type == 'user': # permissions from user management command\n user_cn = cfg_data['cn']\n log.info(\"Resetting user %r permissions\", cfg_data['cn'])\n register_service_event(\n 'PERMISSION_RESET', params={'user_cn': user_cn})\n for existing_user_cn in db.get_all_values('user'):\n if existing_user_cn == user_cn:\n db.rm_value(f\"user/{user_cn}\")\n register_user_permissions(db, user_cn, cfg_data[\"roles\"])\n\n elif cmd_type == 'election': # register election params\n cfg_data = load_cfg_file_content(\n cmd_type,\n re.compile(r'(.+\\.)?{}.yaml'.format(cmd_type)), cfg_filename)\n db.set_value('election/election-id', cfg_data['identifier'])\n\n # start/stop times\n for key in [\n 'servicestart', 'electionstart', 'electionstop',\n 'servicestop', 'verificationstop'\n ]:\n db.set_value(f\"election/{key}\", cfg_data[\"period\"][key])\n register_service_event(\n 'SET_ELECTION_TIME',\n params={\n 'period': key, 'timestamp': cfg_data['period'][key]})\n\n # authentication methods\n auth_in_db = set(db.get_all_values('election').get('auth', []))\n auth_in_cfg = set(cfg_data.get('auth', []).keys())\n for key in auth_in_db.difference(auth_in_cfg):\n db.rm_value(f'election/auth/{key}')\n for key in auth_in_cfg.difference(auth_in_db):\n db.set_value(f'election/auth/{key}', 'TRUE')\n\n # TSP qualification protocol\n for key in cfg_data.get('qualification', []):\n if key.get('protocol') == 'tspreg':\n db.set_value('election/tsp-qualification', 'TRUE')\n break\n else:\n try:\n db.rm_value('election/tsp-qualification')\n except KeyError:\n pass\n\n if cmd_type in ['technical', 'election']:\n manage_db_mobileid_fields(db)\n manage_db_tsp_fields(db)\n\n register_cfg_in_fs(\n cmd_type, cmd_filepath, active_cfg_filename, cfg_version, autoapply)\n\n\ndef register_cfg_in_fs(cmd_type,\n src_path,\n tgt_filename,\n cfg_version,\n autoapply):\n \"\"\"Register config in file system.\n\n - Create symlink to active config directory\n (e.g. /var/lib/ivxv/commands/.bdoc -> /etc/ivxv/cmd.bdoc)\n - Create state file for some command types\n (/var/lib/ivxv/commands/.json)\n \"\"\"\n if cmd_type not in CFG_TYPES and cmd_type not in VOTING_LIST_TYPES:\n return\n\n tgt_path = cfg_path('active_config_files_path', tgt_filename)\n state_path = os.path.splitext(src_path)[0] + '.json'\n\n # create symlink to active config directory\n try:\n os.remove(tgt_path)\n except FileNotFoundError:\n pass\n log.debug(\"Creating symlink for config file %r -> %r\", src_path, tgt_path)\n os.symlink(src_path, tgt_path)\n\n # create state file for loaded command\n if cmd_type in [\"technical\", \"election\", \"choices\", \"districts\", \"voters\"]:\n try:\n os.remove(state_path)\n except FileNotFoundError:\n pass\n log.debug(\"Generating config state file %r\", state_path)\n default_state_data = {\n # config data\n 'config_type': CMD_DESCR[cmd_type],\n 'config_file': os.path.basename(tgt_path),\n 'config_version': cfg_version,\n # applying data\n 'autoapply': autoapply,\n 'completed': False,\n 'attempts': 0,\n 'log': [],\n }\n with open(state_path, 'w') as fp:\n json.dump(default_state_data, fp, indent=4, sort_keys=True)\n\n log.info('%s file is registered in management service',\n CMD_DESCR[cmd_type].capitalize())\n\n\ndef check_cmd_loading_state(cmd_type):\n \"\"\"Check command loading state.\n\n :raises IvxvError: on any known error\n \"\"\"\n # don't allow to load choices list more than once\n if cmd_type == 'choices':\n with IVXVManagerDb() as db:\n choices_list_version = db.get_value('list/choices')\n if choices_list_version:\n raise IvxvError(\n f\"Choices list is already loaded (version: {choices_list_version})\"\n )\n\n # don't allow to load technical config if trust root config is not loaded\n elif cmd_type == 'technical':\n with IVXVManagerDb() as db:\n trust_cfg = db.get_value('config/trust')\n if not trust_cfg:\n raise IvxvError(\n 'Trust root must be loaded before technical configuration')\n\n # don't allow to load voters list if districts list is not loaded\n elif cmd_type == \"voters\":\n with IVXVManagerDb() as db:\n districts_cfg = db.get_value(\"list/districts\")\n if not districts_cfg:\n raise IvxvError(\"Districts list must be loaded before voters list\")\n\n\ndef check_signer_permissions(cmd_type, filename):\n \"\"\"Check command file signer permissions.\n\n Detect config file timestamp and version based on signature(s).\n\n :return: config timestamp, config version\n :rtype: list\n\n :raises IvxvError: on any known error\n \"\"\"\n # check config permissions\n try:\n cfg_signatures, all_signatures = check_cmd_signature(\n cmd_type, filename)\n except LookupError as err:\n raise IvxvError(f'Failed to verify config file signatures: {err}')\n except (OSError, subprocess.SubprocessError) as err:\n raise IvxvError(str(err))\n\n for signature in all_signatures:\n log.info('Config file is signed by: %s', signature[2])\n if not cfg_signatures:\n raise IvxvError('No signatures by authorized users')\n cfg_version, role = cfg_signatures[0]\n log.info(\"User %s with role %r is authorized to execute %r commands\",\n cfg_version.split(' ')[0], role, cmd_type)\n log.info(\"Using signature %r as config file version\", cfg_version)\n cfg_timestamp = cfg_version.split(' ')[1]\n\n return cfg_timestamp, cfg_version\n\n\ndef register_user_permissions(db, user_cn, roles):\n \"\"\"Register user permissions.\"\"\"\n roles = sorted(roles)\n register_service_event(\n 'PERMISSION_SET',\n params={'user_cn': user_cn, 'permission': ','.join(roles)})\n db.set_value(f\"user/{user_cn}\", \",\".join(roles))\n populate_user_permissions(db)\n\n\ndef validate_lists_consistency(cmd_type, cmd_filepath):\n \"\"\"Validate voting lists consistency.\"\"\"\n # create list of existing voting lists\n list_files = {}\n with IVXVManagerDb() as db:\n for db_key, db_val in db.get_all_values('list').items():\n if re.match(r\"voters[0-9]{2}\", db_key):\n if db_key.endswith(\"-state\"):\n cli_key = db_key.replace(\"-state\", \"\")\n if db_val in [\"PENDING\", \"APPLIED\"]:\n list_files[cli_key] = cfg_path(\n \"active_config_files_path\",\n \"voters0000.bdoc\"\n if cli_key == \"voters0000\"\n else f\"{cli_key}.zip\",\n )\n elif db_val == \"SKIPPED\":\n list_files[cli_key] = cfg_path(\n \"active_config_files_path\",\n f\"{cli_key}.bdoc\",\n )\n continue\n if db_key.endswith(\"-loaded\") or not db_val:\n continue\n list_files[db_key] = cfg_path(\n 'active_config_files_path', f'{db_key}.bdoc')\n\n # add current list\n if cmd_type != 'voters':\n list_files[cmd_type] = cmd_filepath\n else: # change voters list key for proper ordering\n for _ in range(10_000):\n if f'voters{_:04d}' not in list_files:\n list_files[f'voters{_:04d}'] = cmd_filepath\n break\n\n # validate\n if len(list_files) > 1:\n election_cfg = cfg_path(\"active_config_files_path\", \"election.bdoc\")\n cmd = [\"ivxv-config-validate\", f\"--election={election_cfg}\"]\n for cfg_type, filepath in sorted(list_files.items()):\n cfg_type = re.sub(r'[0-9]+', '', cfg_type)\n cmd.append(f'--{cfg_type}={filepath}')\n log.info(\n 'Some voting lists are already loaded, '\n 'executing consistency checks: %s', ' '.join(cmd))\n proc = subprocess.run(cmd, check=False)\n if proc.returncode != 0:\n log.error('Config validation command raised exception')\n return False\n\n return True\n" }, { "path": "collector-admin/ivxv_admin/cli_utils/config_utils/config_apply.py", "content": "# IVXV Internet voting framework\n\"\"\"CLI utilities for config applying.\"\"\"\n\nimport json\nimport os\nimport shutil\nimport sys\n\nfrom ... import (CFG_TYPES, CMD_TYPES, SERVICE_STATE_CONFIGURED,\n SERVICE_TYPE_PARAMS, lib)\nfrom ...command_file import load_collector_cmd_file\nfrom ...config import cfg_path\nfrom ...db import IVXVManagerDb\nfrom ...lib.lockfile import PidLocker\nfrom ...service import generate_service_list, get_service_cfg_state\nfrom ...service.service import Service\nfrom .. import init_cli_util, log\n\n#: config types in applying order\nCFG_TYPES_DEFAULT = (\"technical\", \"election\", \"choices\", \"districts\", \"voters\")\n\n\ndef main():\n \"\"\"Apply loaded config to IVXV services.\"\"\"\n args = init_cli_util(\"\"\"\n Apply loaded IVXV Collector config to services.\n\n Usage: ivxv-config-apply [--type=] ... [] ...\n\n Options:\n --type= Config type. Possible values are:\n - election: election config file\n - technical: collector technical config file\n - choices: choices list\n - districts: districts list\n - voters: voters list\n \"\"\")\n\n # validate CLI arguments\n for cfg_type in args['--type']:\n if cfg_type not in CMD_TYPES or cfg_type == 'trust':\n log.error('Invalid config type specified: --type=%s', cfg_type)\n return 1\n\n cfg_types = args['--type'] or list(CFG_TYPES_DEFAULT)\n service_ids = args['']\n\n # load config data\n with IVXVManagerDb() as db:\n cfg_data = get_cfg_data(db)\n try:\n tech_cfg = load_tech_cfg(\n cfg_data['technical']['version'],\n cfg_data['election']['version'],\n 'election' in cfg_types)\n except lib.IvxvError as err:\n log.error(err)\n return 1\n\n # remove choices/voters list version record from config data\n # if list is not loaded and also not specified in CLI args\n if not args['--type']:\n if not cfg_data.get('choices', {}).get('version'):\n cfg_types.remove('choices')\n if not cfg_data.get('districts', {}).get('version'):\n cfg_types.remove('districts')\n if not cfg_data.get('voters0000', {}).get('version'):\n cfg_types.remove('voters')\n\n # generate service list from tech config\n services = generate_service_list(tech_cfg['network'], service_ids)\n if services is None:\n return 1\n services = prepare_service_list(services, service_ids)\n\n # create pidfile to avoid running of multiple instances\n pidfile_path = cfg_path('ivxv_admin_data_path', 'ivxv-config-apply.pid')\n log.debug(\"Creating pidfile %r\", pidfile_path)\n try:\n PidLocker(pidfile_path, timeout=5)\n except IOError:\n log.error(\"Creating pidfile %r failed. Is another %s running?\",\n pidfile_path, os.path.basename(sys.argv[0]))\n sys.exit(1)\n\n # apply config\n apply_result = apply_cfg(\n cfg_types=cfg_types,\n services=services,\n tech_cfg=tech_cfg,\n cfg_data=cfg_data)\n return int(not apply_result)\n\n\ndef get_cfg_data(db):\n \"\"\"Load config versions from database.\n\n :rtype: dict\n \"\"\"\n # get config versions\n cfg_data = {\n 'technical': {\n 'version': db.get_value('config/technical') or None\n },\n 'election': {\n 'version': db.get_value('config/election') or None\n },\n 'choices': {\n 'version': db.get_value('list/choices') or None\n },\n 'districts': {\n 'version': db.get_value('list/districts') or None\n },\n }\n if not cfg_data['choices']['version']:\n del cfg_data['choices']\n if not cfg_data['districts']['version']:\n del cfg_data['districts']\n try:\n for changeset_no in range(10_000):\n cfg_data[f\"voters{changeset_no:04}\"] = {\n \"version\": db.get_value(f\"list/voters{changeset_no:04}\") or None\n }\n except KeyError:\n pass\n\n # get config applying report filenames\n for cmd_type in cfg_data:\n cfg_filepath = lib.get_loaded_cfg_file_path(cmd_type)\n cfg_data[cmd_type][\"state_file\"] = (\n cfg_filepath.replace(os.path.splitext(cfg_filepath)[1], \".json\")\n if cfg_filepath\n else None\n )\n\n return cfg_data\n\n\ndef load_tech_cfg(tech_cfg_ver, election_cfg_ver, has_election_cfg):\n \"\"\"Load technical config.\n\n * Load technical config\n * Log election config state\n * Generate database records for undefined services\n\n :return: technical config\n :rtype: dicts\n\n :raises IvxvError: if technical config cannot be loaded\n \"\"\"\n # load technical config\n if not tech_cfg_ver:\n raise lib.IvxvError(\n 'Technical config is not loaded to management service')\n log.info('Technical config is signed by %s', tech_cfg_ver)\n tech_cfg = load_collector_cmd_file(\n 'technical', cfg_path('active_config_files_path', 'technical.bdoc'))\n if tech_cfg is None:\n raise lib.IvxvError('Error while loading technical config')\n\n # log election config state\n if has_election_cfg:\n if election_cfg_ver:\n log.info('Election config is signed by %s', election_cfg_ver)\n else:\n log.info('Election config is not loaded to management service')\n\n return tech_cfg\n\n\ndef prepare_service_list(services, service_ids):\n \"\"\"Prepare service list for applying config to services.\n\n Return services that are in service_ids list.\n \"\"\"\n services = [[service_type, service_data]\n for service_type, service_data in services\n if not service_ids or service_data['id'] in service_ids]\n\n # reorder services to satisfy dependencies\n for service_block in services[:]:\n # move log service record to beginning of list\n # to configure log collector(s) before other services\n if service_block[0] == 'log':\n services.remove(service_block)\n services.insert(0, service_block)\n\n # move proxy service records to end of list to ensure proxied services\n # are started and initial health checks can succeed\n if service_block[0] == 'proxy':\n services.remove(service_block)\n services.append(service_block)\n\n return services\n\n\ndef apply_cfg(cfg_types, services, tech_cfg, cfg_data):\n \"\"\"Apply config to services.\"\"\"\n results = dict([i, {}] for i in cfg_types)\n for cfg_type in CFG_TYPES_DEFAULT:\n if cfg_type not in cfg_types:\n continue\n # disallow applying choices/districts/voters list\n # if required services aren't operational\n if cfg_type in [\"choices\", \"districts\", \"voters\"]:\n list_services = lib.get_services(\n include_types=['choices', 'storage'],\n service_state=[SERVICE_STATE_CONFIGURED])\n if not list_services:\n log.error('Choices and/or storage services are not configured')\n return False\n result_by_service = apply_cfg_to_services(\n services=services,\n cfg_type=cfg_type,\n tech_cfg=tech_cfg,\n cfg_data=cfg_data,\n )\n results[cfg_type] = result_by_service\n\n # update config state file\n if (cfg_type in CFG_TYPES and result_by_service\n and False not in result_by_service.values()):\n state_filepath = cfg_data[cfg_type]['state_file']\n with open(state_filepath) as fp:\n cfg_state = json.load(fp)\n cfg_state['completed'] = True\n\n tmp_filepath = f'{state_filepath}.tmp'\n with open(tmp_filepath, 'x') as fp:\n json.dump(cfg_state, fp, indent=4, sort_keys=True)\n shutil.move(tmp_filepath, state_filepath)\n\n return aggregate_results(results)\n\n\ndef apply_cfg_to_services(services, cfg_type, tech_cfg, cfg_data):\n \"\"\"Helper to apply config to services.\n\n :param services: Service list\n :type services: list\n :param cfg_type: Config type to apply\n :type cfg_type: str\n :param tech_cfg: Technical configuration from config file\n :type tech_cfg: dict\n :param services: List of services, grouped by service type\n :type services: list\n :param cfg_data: Loaded config/list files data (version, filenames)\n :type cfg_data: dict\n\n :return: dict with results for every service\n \"\"\"\n # get list of registered services that require config update\n with IVXVManagerDb() as db:\n service_cfg_state = get_service_cfg_state(db, tech_cfg)\n hostnames = sorted(\n set(\n service_data['address'].split(':')[0]\n for _, service_data in services\n ))\n host_state = dict(\n [hostname, db.get_value(f'host/{hostname}/state')]\n for hostname in hostnames)\n\n # apply config to services\n def report_applying_result():\n \"\"\"Report process result.\"\"\"\n cfg_descr = '{} {}'.format(\n cfg_type, 'config' if cfg_type in CFG_TYPES else 'list')\n results[service_id] = cfg_success\n if cfg_success:\n log.info('Service %s: %s config applied successfully',\n service_id, cfg_descr)\n service.register_event(\n 'SERVICE_CONFIG_APPLY',\n params={'cfg_descr': cfg_descr, 'cfg_version': cfg_version})\n else:\n log.error('Service %s: failed to apply %s', service_id, cfg_descr)\n\n # apply config\n results = {}\n applied_lists = []\n attempt_no = 0\n for service_type, service_data in services:\n service_id = service_data['id']\n if not service_cfg_state[service_id][cfg_type]:\n continue\n\n service_data['service_type'] = service_type # used by Service()\n with Service(service_id, service_data) as service:\n # apply technical config\n if cfg_type == 'technical':\n # initialize service host if required\n if not host_state[service.hostname]:\n log.info(\"Initializing service host %r\", service.hostname)\n success = service.init_service_host()\n if not success:\n results[service_id] = False\n continue\n with IVXVManagerDb(for_update=True) as db:\n db.set_value(f'host/{service.hostname}/state',\n 'REGISTERED')\n host_state[service.hostname] = 'REGISTERED'\n\n # apply config\n log.info('Service %s: Applying technical config', service_id)\n cfg_version = cfg_data[cfg_type]['version']\n attempt_no = service.load_apply_state(\n cfg_data[cfg_type]['state_file'], attempt_no)\n cfg_success = service.apply_tech_cfg(cfg_version, tech_cfg)\n report_applying_result()\n service.update_apply_state()\n\n # apply election config\n elif (cfg_type == 'election'\n and SERVICE_TYPE_PARAMS[service_type]['require_config']):\n log.info('Service %s: Applying elections config', service_id)\n cfg_version = cfg_data[cfg_type]['version']\n attempt_no = service.load_apply_state(\n cfg_data[cfg_type]['state_file'], attempt_no)\n cfg_success = service.apply_election_cfg(cfg_version)\n report_applying_result()\n service.update_apply_state()\n\n # apply choices/districts list\n elif (cfg_type in [\"choices\", \"districts\"] and service_type == \"choices\"\n and cfg_type not in applied_lists):\n log.info(\"Service %s: Applying %s list\", service_id, cfg_type)\n cfg_version = cfg_data[cfg_type]['version']\n attempt_no = service.load_apply_state(\n cfg_data[cfg_type]['state_file'], attempt_no)\n cfg_success = service.apply_list(cfg_type)\n report_applying_result()\n service.update_apply_state(completed=True)\n applied_lists.append(cfg_type)\n\n # apply voters lists\n elif (cfg_type == 'voters' and service_type == 'voting'\n and 'voters' not in applied_lists):\n for changeset_no in service_cfg_state[service_id][\"voters\"]:\n log.info(\n \"Service %s: Applying voter list changeset #%d\",\n service_id,\n changeset_no,\n )\n voters_list_id = f\"voters{changeset_no:04}\"\n cfg_version = cfg_data[voters_list_id]['version']\n attempt_no = service.load_apply_state(\n cfg_data[voters_list_id]['state_file'])\n cfg_success = service.apply_list(cfg_type, changeset_no)\n report_applying_result()\n service.update_apply_state(completed=True)\n applied_lists.append('voters')\n\n return results\n\n\ndef aggregate_results(results):\n \"\"\"Aggregate and output collector config applying results for services.\n\n :rtype: bool\n :return: True if no error detected\n \"\"\"\n results_summary = []\n for cfg_type in CFG_TYPES_DEFAULT:\n if results.get(cfg_type):\n log.info('Results for %s:', lib.cfg_type_verbose(cfg_type))\n for service_id, result in sorted(results[cfg_type].items()):\n log.info(' Service %s: %s',\n service_id, 'success' if result else 'FAILED')\n results_summary.append(result)\n\n log.info('%d configuration packages successfully applied',\n results_summary.count(True))\n\n if False in results_summary:\n log.error('Failed to apply %d configuration packages',\n results_summary.count(False))\n\n return False not in results_summary\n" }, { "path": "collector-admin/ivxv_admin/cli_utils/config_utils/config_validate.py", "content": "# IVXV Internet voting framework\n\"\"\"CLI utilities for collector config validation.\"\"\"\n\nimport json\n\nfrom ... import CMD_DESCR, CMD_TYPES\nfrom ...command_file import load_collector_cmd_file\nfrom ...lib import IvxvError\nfrom .. import init_cli_util, log\n\n\ndef main():\n \"\"\"Validate IVXV collector config.\"\"\"\n args = init_cli_util(\"\"\"\n Validate IVXV collector config files.\n\n Validate single config files. Also validate voting lists consistency if\n multiple lists are provided.\n\n Usage:\n ivxv-config-validate [--plain] [--trust=]\n [--technical=] [--election=]\n [--choices=] [--districts=]\n [--voters= ...]\n\n Options:\n --plain Validate plain config file (Default: BDOC container)\n \"\"\")\n plain = args['--plain']\n\n # validate CLI arguments\n cfg_files = []\n for cfg_type in CMD_TYPES:\n files = args.get(f'--{cfg_type}')\n if isinstance(files, list):\n cfg_files += [[cfg_type, filepath] for filepath in files]\n elif files:\n cfg_files.append([cfg_type, files])\n if not cfg_files:\n log.error('Config file is not specified')\n return 1\n\n # validate single files\n try:\n validated_cfg = validate_cfg_files(cfg_files, plain)\n except IvxvError:\n return 1\n log.info('Config files are valid')\n\n if validate_cfg_consistency(\n validated_cfg,\n election=args[\"--election\"],\n choices=args[\"--choices\"],\n districts=args[\"--districts\"],\n voters=args[\"--voters\"],\n ):\n return 0\n return 1\n\n\ndef validate_cfg_consistency(\n validated_cfg,\n election=None,\n choices=None,\n districts=None,\n voters=None,\n):\n \"\"\"Perform consistency checks for config files.\"\"\"\n # validate election ID consistency\n if not validate_cfg_election_id(validated_cfg):\n log.info(\"Election ID consistency check failed\")\n return False\n log.info(\"Election ID consistency check succeeded\")\n\n # validate multiple voters lists consistency\n if len(voters) > 1:\n if not validate_voters_lists_consistency(validated_cfg):\n log.info('Voters lists consistency check failed')\n return False\n\n log.info('Voters lists consistency check succeeded')\n\n # determine voterforeignehak, there are no consistency checks\n voterforeignehak = \"0000\"\n if election:\n for cfg_type, cfg in validated_cfg:\n if cfg_type == \"election\":\n voterforeignehak = cfg.get(\"voterforeignehak\", voterforeignehak)\n break\n\n # validate districts and choices/voters lists consistency\n if districts and (choices or voters):\n if not validate_lists_consistency(validated_cfg, voterforeignehak):\n log.info('Voting lists consistency check failed')\n return False\n\n log.info('Voting lists consistency check succeeded')\n\n return True\n\n\ndef validate_cfg_election_id(validated_cfg):\n \"\"\"Validate election ID consistency in config files.\"\"\"\n # try to detect election ID\n election_id = None\n for cfg_type, cfg in validated_cfg:\n if cfg_type == \"election\":\n election_id = cfg[\"identifier\"]\n log.info(\"Detected election ID %r from election config\", election_id)\n break\n\n # validate election ID consistency\n for cfg_type, cfg in validated_cfg:\n if cfg_type in [\"election\", \"technical\", \"trust\"]:\n continue\n cfg_election_id = cfg[\"election\"]\n if not election_id:\n election_id = cfg_election_id\n log.debug(\"Detected election ID %r from %s config\", election_id, cfg_type)\n else:\n if election_id != cfg_election_id:\n log.error(\n \"Election ID %r in %s config does not match with %r\",\n cfg_election_id,\n cfg_type,\n election_id,\n )\n return False\n\n return True\n\n\ndef validate_cfg_files(cfg_files, plain):\n \"\"\"Load and validate config files.\"\"\"\n cfg_array = []\n for cfg_type, filepath in cfg_files:\n log.info(\"Validating %s file %r\", CMD_DESCR[cfg_type], filepath)\n try:\n cfg = load_collector_cmd_file(cfg_type, filepath, plain)\n except json.decoder.JSONDecodeError:\n cfg = None\n if cfg is None:\n raise IvxvError\n cfg_array.append([cfg_type, cfg])\n\n return cfg_array\n\n\ndef validate_voters_lists_consistency(cfg_objects):\n \"\"\"Validate voters lists consistency.\"\"\"\n check_failed = False\n voters_reg = None\n changeset = 0\n errors = []\n for cfg_type, cfg in cfg_objects:\n if cfg_type != 'voters':\n continue\n\n if changeset == 0:\n if int(cfg['changeset']) != 0:\n errors.append(\n f'Invalid changeset {cfg[\"changeset\"]} for initial voter list'\n )\n break\n voters_reg = dict(\n [voter[1], voter[3:5]] for voter in cfg['voters'])\n changeset = 1\n continue\n\n if int(cfg['changeset']) < changeset:\n errors.append(\n f'Invalid changeset {cfg[\"changeset\"]}, '\n f'expected {changeset} or greater')\n break\n\n changeset = int(cfg['changeset'])\n\n # voter list skipping command acts as an empty changeset\n if cfg.get('skip_voter_list'):\n continue\n\n log.info(\"Checking voters list changeset #%d consistency\", changeset)\n voters_in_patch = set()\n for rec_no, voter in enumerate(cfg['voters']):\n voter_id = voter[1]\n\n if voter[0] == 'lisamine':\n if (voter_id not in voters_reg\n and voter_id not in voters_in_patch):\n voters_reg[voter_id] = voter[3:5]\n else:\n errors.append(\n f'Record #{rec_no}: Adding voter ID {voter_id} '\n 'that is already in voters list')\n voters_in_patch.add(voter_id)\n else:\n if voter_id in voters_in_patch:\n errors.append(\n f'Record #{rec_no}: Removing ID {voter_id} '\n 'that is added with this patch')\n try:\n # just to test that voter id is valid before removing it\n voters_reg.pop(voter_id)\n except KeyError:\n errors.append(\n f'Record #{rec_no}: Removing voter ID {voter_id} '\n 'that is not in voters list')\n\n if errors:\n break\n\n for error in errors:\n log.error(error)\n\n check_failed = check_failed or bool(errors)\n\n return not check_failed\n\n\ndef validate_lists_consistency(cfg_objects, voterforeignehak):\n \"\"\"Validate voting lists consistency.\"\"\"\n districts_cfg = ([\n cfg\n for cfg_type, cfg in cfg_objects\n if cfg_type == 'districts'\n ][0])\n districts = set(districts_cfg['districts'])\n\n check_failed = False\n changeset_no = 0\n for cfg_type, cfg in cfg_objects:\n errors = []\n if cfg_type == 'choices':\n log.info('Checking districts and choices lists consistency')\n errors = validate_choices_consistency(districts, cfg)\n check_failed = check_failed or bool(errors)\n elif cfg_type == 'voters':\n log.info(\n \"Checking districts and voter list changeset #%d consistency\",\n changeset_no,\n )\n errors = validate_voters_consistency(districts_cfg, districts, cfg,\n voterforeignehak)\n check_failed = check_failed or bool(errors)\n changeset_no += 1\n for error in errors:\n log.error(error)\n\n return not check_failed\n\n\ndef validate_choices_consistency(districts, choices_cfg):\n \"\"\"Validate districts and choices lists consistency.\"\"\"\n choices = set(choices_cfg['choices'])\n errors = []\n\n # Each choice is in an existing district\n choices_wo_district = choices.difference(districts)\n if choices_wo_district:\n errors.append(\n 'The following choices have no matching district: {}'\n .format(','.join(sorted(choices_wo_district))))\n\n # In each district there must be at least one choice\n districts_wo_choices = districts.difference(choices)\n if districts_wo_choices:\n errors.append(\n 'The following districts have no choice defined: {}'\n .format(','.join(sorted(districts_wo_choices))))\n\n return errors\n\n\ndef validate_voters_consistency(\n districts_cfg, districts, voters_cfg, voterforeignehak\n):\n \"\"\"Validate voting lists consistency.\"\"\"\n errors = []\n\n if \"skip_voter_list\" in voters_cfg:\n return errors\n\n parish_to_district = {}\n\n for dist in districts_cfg[\"districts\"]:\n for parish in districts_cfg[\"districts\"][dist][\"parish\"]:\n if parish not in parish_to_district:\n parish_to_district[parish] = []\n\n parish_to_district[parish].append(dist)\n\n # check consistency\n for voter in voters_cfg['voters']:\n # if action is \"kustutamine\" then don't check districts/parish\n if voter[0] == \"kustutamine\":\n continue\n # Voterlist contains voter EHAK and district no which must be\n # translated into full district identifier\n voter_district = None\n voter_id = voter[1]\n voter_ehak = voter[3]\n voter_district_no = voter[4]\n\n # Voterlist uses parish FOREIGN, other configs may use some other code\n if voter_ehak == \"FOREIGN\":\n voter_ehak = voterforeignehak\n\n # Search district by parish, single parish may be in several districts\n # in this case the district no's must be different and match with voter\n if voter_ehak in parish_to_district:\n for dist in parish_to_district[voter_ehak]:\n if dist.split(\".\")[1] == voter_district_no:\n voter_district = dist\n break\n else:\n errors.append(f'Parish {voter_ehak} not found in districts')\n\n # Voter must belong to an existing district\n if voter_district is None:\n errors.append(\n f'District for voter {voter_id} in EHAK {voter_ehak} / '\n f'{voter_district_no} cannot be determined')\n elif voter_district not in districts:\n errors.append(\n f'District {voter_district} for voter {voter_id} not found')\n\n return errors\n" }, { "path": "collector-admin/ivxv_admin/cli_utils/config_utils/load_secret_data_file.py", "content": "# IVXV Internet voting framework\n\"\"\"CLI utilites for sercet loading.\"\"\"\n\nimport hashlib\n\nimport OpenSSL\n\nfrom ... import (COLLECTOR_STATE_CONFIGURED, COLLECTOR_STATE_FAILURE,\n COLLECTOR_STATE_INSTALLED, COLLECTOR_STATE_PARTIAL_FAILURE,\n SERVICE_SECRET_TYPES, SERVICE_STATE_CONFIGURED,\n SERVICE_STATE_FAILURE, SERVICE_STATE_INSTALLED,\n SERVICE_TYPE_PARAMS, lib)\nfrom ...event_log import register_service_event\nfrom ...lib import IvxvError\nfrom ...service.service import Service\nfrom .. import init_cli_util, log\n\n\ndef main():\n \"\"\"Load secret data to IVXV services.\"\"\"\n # validate CLI arguments\n args = init_cli_util(\"\"\"\n Load secret data to IVXV services.\n\n This utility loads file that contains secret data to services.\n\n Supported secret types are:\n\n tls-cert - TLS certificate for service.\n\n Certificate (and key) is used for securing\n communication between services and service instances.\n\n tls-key - TLS key for service.\n\n Key is used together with service certificate.\n\n tsp-regkey - PKIX TSP registration key for voting services.\n\n Key is used for signing Time Stamp Protocol requests.\n\n Key file must be in PEM format and must be not password protected.\n\n mid-token-key - Mobile-ID/Smart-ID/Web eID identity token for\n choices, mobile-id and voting services.\n\n Key file must be 32 bytes long.\n\n Usage: ivxv-secret-load [--service=] \n \"\"\")\n secret_type = args[''].lower()\n filepath = args['']\n if secret_type not in SERVICE_SECRET_TYPES:\n log.error(\"Invalid secret type %r\", secret_type)\n log.info('Supported secret types are: %s',\n ', '.join(SERVICE_SECRET_TYPES))\n return 1\n secret_descr = SERVICE_SECRET_TYPES[secret_type]['description']\n\n # load file\n log.debug('Loading %s file', secret_descr)\n try:\n with open(filepath, 'rb') as fp:\n file_content = fp.read()\n except (FileNotFoundError, PermissionError) as err:\n log.error(\"Unable to load file %r: %s\", filepath, err.strerror)\n return 1\n\n # validate file\n try:\n validate_secret_file(secret_type, file_content, args[\"--service\"])\n except IvxvError as err:\n log.error('Error while validating %s: %s', secret_descr, err)\n return 1\n\n # calculate file checksum\n file_checksum = hashlib.sha256(file_content).hexdigest()\n\n # generate list of services that are in required state\n key_param = {\n 'tls-cert': 'require_tls',\n 'tls-key': 'require_tls',\n 'tsp-regkey': 'tspreg',\n 'mid-token-key': 'mobile_id',\n }[secret_type]\n service_types_affected = sorted(\n set(\n service_type\n for service_type, service_params in SERVICE_TYPE_PARAMS.items()\n if service_params[key_param]\n )\n )\n\n services = lib.get_services(\n include_types=service_types_affected,\n require_collector_state=[\n COLLECTOR_STATE_INSTALLED, COLLECTOR_STATE_CONFIGURED,\n COLLECTOR_STATE_FAILURE, COLLECTOR_STATE_PARTIAL_FAILURE\n ],\n service_state=[\n SERVICE_STATE_INSTALLED, SERVICE_STATE_CONFIGURED,\n SERVICE_STATE_FAILURE\n ])\n if not services:\n return 1\n\n # copy key to service hosts\n # FIXME avoid multiple copying of shared secret to single host\n services_updated = []\n for service_id, service_data in sorted(services.items()):\n if args['--service'] and service_id != args['--service']:\n continue\n if (service_data.get(SERVICE_SECRET_TYPES[secret_type]['db-key']) ==\n file_checksum):\n log.info('Service %s already contains specified %s',\n service_id, secret_descr)\n continue\n\n with Service(service_id, service_data) as service:\n if not service.load_secret_file(secret_type, filepath, file_checksum):\n return 1\n register_service_event(\n 'SECRET_INSTALL',\n service=service_id,\n params={\n 'secret_descr': secret_descr,\n })\n services_updated.append(service_id)\n\n if args['--service'] and args['--service'] not in services_updated:\n log.error('%s was not loaded to service %s',\n secret_descr, args['--service'])\n return 1\n\n if args['--service']:\n log.info('%s is loaded to service %s', secret_descr, args['--service'])\n else:\n log.info('%s is loaded to services', secret_descr)\n\n return 0\n\n\ndef validate_secret_file(secret_type, file_content, service_id):\n \"\"\"Validate secret data file.\n\n :raises IvxvError:\n \"\"\"\n if secret_type in ('tls-cert', 'tls-key') and not service_id:\n raise IvxvError(\"Service ID is not specified\")\n if secret_type == 'mid-token-key' and len(file_content) != 32:\n raise IvxvError(\n f'File is not 32 bytes long '\n f'(actual size: {len(file_content)} bytes)')\n if secret_type == 'tsp-regkey':\n try:\n privkey = OpenSSL.crypto.load_privatekey(\n OpenSSL.crypto.FILETYPE_PEM, file_content\n )\n except OpenSSL.crypto.Error as err:\n err_lib, err_func, err_reason = err.args[0][0]\n raise IvxvError(\n f'Error in {err_lib} library {err_func} '\n f'function: {err_reason}')\n with open(\"/var/lib/ivxv/service/tspreg-pubkey.pem\", \"wb\") as fd:\n fd.write(\n OpenSSL.crypto.dump_publickey(OpenSSL.crypto.FILETYPE_PEM, privkey)\n )\n" }, { "path": "collector-admin/ivxv_admin/cli_utils/config_utils/voter_list_download.py", "content": "# IVXV Internet voting framework\n\"\"\"CLI utility to download voter list from VIS.\"\"\"\n\nimport datetime\nimport json\nimport os\nimport shutil\nimport sys\nimport zipfile\n\nimport requests\n\nfrom ... import command_file\nfrom ...config import CONFIG, cfg_path\nfrom ...db import IVXVManagerDb\nfrom ...event_log import register_service_event\nfrom ...lib import get_current_voter_list_changeset_no\nfrom ...lib.lockfile import PidLocker\nfrom .. import init_cli_util, log\nfrom .command_load import register_cfg, validate_lists_consistency\n\n\ndef main():\n \"\"\"Download voter list from VIS to IVXV Collector Management Service.\"\"\"\n args = init_cli_util(\n \"\"\"\n Download next available voter list changeset from VIS to IVXV Collector\n Management Service.\n\n Usage:\n ivxv-voter-list-download [--output-report=] [--log-level=]\n\n Options:\n --output-report= Write JSON report about HTTP request to VIS.\n --log-level= Logging level [Default: INFO].\n \"\"\"\n )\n\n # validate CLI arguments\n output_report_filepath = args[\"--output-report\"]\n\n # suppress error if executed from crontab before loading election config\n if not os.path.exists(\"/etc/ivxv/election.bdoc\") and not sys.stdout.isatty():\n return 0\n\n # check process lock to start voterlist download without interruption, otherwise\n # skip downloading until next time\n if PidLocker.pidfile_exists('ivxv-voter-list-download.pid'):\n log.info('Cannot start voterlist download, pidfile exists')\n return 0\n\n # create process lock and start voterlist downloading\n pidfile_path = cfg_path('ivxv_admin_data_path',\n 'ivxv-voter-list-download.pid')\n log.debug(\"Creating pidfile %r\", pidfile_path)\n try:\n PidLocker(pidfile_path, timeout=5)\n except IOError:\n log.error(\"Creating pidfile %r failed\", pidfile_path)\n return 1\n\n retries: int = 0\n\n try:\n while True:\n retries += 1\n\n # detect state of the last changeset\n with IVXVManagerDb() as db:\n changeset_no = get_current_voter_list_changeset_no(db)\n changeset_state = db.get_value(f\"list/voters{changeset_no:04d}-state\")\n\n # stop on INVALID changeset\n if changeset_state == \"INVALID\":\n log.info(\n \"State of the last registered voter list changeset #%d is %s\",\n changeset_no,\n changeset_state,\n )\n log.info(\"Skipping download of the next voter list changeset\")\n if output_report_filepath:\n with open(output_report_filepath, \"w\") as fd:\n json.dump(\n {\"voter-list-changeset\": {\"status\": \"Skipped\"}}, fd,\n indent=True\n )\n return 0\n changeset_no += 1\n\n # get params from election config\n command_file.log.setLevel(args[\"--log-level\"])\n cfg = command_file.load_collector_cmd_file(\n \"election\", \"/etc/ivxv/election.bdoc\")\n if not cfg:\n return 1\n election_id = cfg[\"identifier\"]\n vis_base_url_template = f\"{cfg['vis']['url']}{{endpoint}}\"\n ca_certs_filepath = None\n if cfg[\"vis\"].get(\"ca\"):\n ca_certs_filepath = cfg_path(\"vis_path\", \"ca.pem\")\n with open(ca_certs_filepath, \"w\") as fd:\n fd.write(\"\\n\".join(cfg[\"vis\"][\"ca\"]))\n\n # download voter list\n output_filepath = f\"{CONFIG.get('vis_path')}/voters{changeset_no:04d}.zip\"\n url = vis_base_url_template.format(endpoint=\"ehs-election-voters-changeset\")\n log.info(\"Query voter list update #%d from %r\", changeset_no, url)\n request_params = {\"electionCode\": election_id, \"changeset\": changeset_no}\n resp = requests.get(\n url,\n verify=ca_certs_filepath,\n cert=(\n \"/etc/ssl/certs/ivxv-admin-client.crt\",\n \"/etc/ssl/private/ivxv-admin-client.key\",\n ),\n params=request_params,\n )\n\n log.info(\n \"VIS responded to voter list update #%d: %r %s\",\n changeset_no,\n resp.status_code,\n resp.reason,\n )\n timestamp = datetime.datetime.utcnow().strftime(\"%Y-%m-%dT%H:%M:%SZ\")\n version = f\"{url} {timestamp}\"\n\n # write query report\n if output_report_filepath:\n report = {\n \"voter-list-changeset\": {\n \"operation\": f\"Download voter list update #{changeset_no} from \"\n + \"VIS\",\n \"request\": {\"url\": resp.url, \"method\": \"GET\",\n \"params\": request_params},\n \"response\": {\n \"status\": \"OK\" if resp.ok else \"ERROR\",\n \"status_code\": resp.status_code,\n \"reason\": resp.reason,\n \"time_elapsed\": str(resp.elapsed),\n \"retries\": retries,\n \"headers\": dict([key, val] for key, val in\n resp.headers.items()),\n \"content\": resp.text,\n },\n },\n }\n with open(output_report_filepath, \"w\") as fd:\n json.dump(report, fd, indent=True)\n\n # register download event / handle download errors\n if resp.status_code == 404:\n log.info(\"Voter list changeset #%d is not available in VIS\",\n changeset_no)\n return 0\n if resp.status_code != 200:\n log.error(\"Server responded with status %d - %r\", resp.status_code,\n resp.reason)\n register_service_event(\n \"VOTER_LIST_DOWNLOAD_FAILED\",\n level=\"INFO\",\n service=\"admin\",\n params={\"changeset_no\": changeset_no},\n )\n return 1\n register_service_event(\n \"VOTER_LIST_DOWNLOADED\",\n level=\"INFO\",\n service=\"admin\",\n params={\"changeset_no\": changeset_no},\n )\n\n # write downloaded content to file\n write_voter_list_zip(resp.content, version, output_filepath)\n\n # register voter list\n if changeset_no:\n register_voter_list(output_filepath, timestamp, version)\n finally:\n try:\n log.debug(\"Releasing pidfile %r\", pidfile_path)\n PidLocker.rm_stale_pidfile('ivxv-voter-list-download.pid')\n except FileNotFoundError: # pid file doesn't exist\n pass\n\n\ndef write_voter_list_zip(content, version, output_filepath):\n \"\"\"Write voter list ZIP file.\"\"\"\n # write list to temporary ZIP file\n tmp_filepath = f\"{output_filepath}.tmp\"\n with open(tmp_filepath, \"bw\") as fd:\n tmp_filepath = fd.name\n log.info(\"Writing VIS response to temporary file %r\", tmp_filepath)\n fd.write(content)\n\n # add version to ZIP\n comment = f\"Version: {version}\"\n log.info(\"Adding comment %r to %r\", comment, tmp_filepath)\n with zipfile.ZipFile(tmp_filepath, \"a\") as zip_file:\n zip_file.comment = bytes(comment, \"ASCII\")\n\n # move ZIP file to final place\n log.info(\"Moving temporary file %r to %r\", tmp_filepath, output_filepath)\n shutil.move(tmp_filepath, output_filepath)\n\n\ndef register_voter_list(filepath, timestamp, version):\n \"\"\"Register voter list in management service.\"\"\"\n cfg_data = command_file.load_collector_cmd_file(\"voters\", filepath)\n is_cfg_valid = cfg_data is not None\n if is_cfg_valid:\n is_cfg_valid = validate_lists_consistency(\"voters\", filepath)\n\n register_service_event(\n \"CMD_LOAD\", params={\"cmd_type\": \"voters\", \"version\": version}\n )\n register_cfg(\n cmd_type=\"voters\",\n cfg_data=cfg_data,\n cfg_filename=filepath,\n cfg_timestamp=timestamp,\n cfg_version=version,\n autoapply=is_cfg_valid,\n state=\"PENDING\" if is_cfg_valid else \"INVALID\",\n )\n register_service_event(\n \"CMD_LOADED\", params={\"cmd_type\": \"voters\", \"version\": version}\n )\n" }, { "path": "collector-admin/ivxv_admin/cli_utils/service_utils.py", "content": "# IVXV Internet voting framework\n\"\"\"CLI utilities for service management.\"\"\"\n\nimport datetime\nimport os\nimport shutil\nimport json\nimport logging\nimport random\nimport subprocess\nimport sys\nimport tempfile\nimport time\nimport zipfile\nfrom collections import OrderedDict\nfrom crontab import CronTab\nfrom jinja2 import Environment, PackageLoader\n\nimport fasteners\nimport yaml\nimport requests\n\nfrom .. import (\n COLLECTOR_STATE_CONFIGURED,\n COLLECTOR_STATE_FAILURE,\n COLLECTOR_STATE_INSTALLED,\n COLLECTOR_STATE_NOT_INSTALLED,\n COLLECTOR_STATE_PARTIAL_FAILURE,\n SERVICE_STATE_CONFIGURED,\n SERVICE_STATE_FAILURE,\n SERVICE_STATE_INSTALLED,\n SERVICE_STATE_REMOVED,\n SERVICE_TYPE_PARAMS,\n __version__,\n command_file,\n)\nfrom ..agent_daemon import get_collector_data, ping_service\nfrom ..config import cfg_path\nfrom ..db import IVXVManagerDb\nfrom ..lib import IvxvError, get_services\nfrom ..service import logging as service_logging\nfrom ..service.service import Service, exec_remote_cmd\nfrom . import init_cli_util, log\n\n#: JSON formatting options\nJSON_DUMP_ARGS = dict(indent=2, sort_keys=True)\n\nIVXV_ADMIN_CRON_USER = 'ivxv-admin'\nVOTER_LIST_DOWNLOAD_CRON_JOB = 'if [ -x /usr/bin/ivxv-voter-list-download ]; then /usr/bin/ivxv-voter-list-download --log-level=WARNING; fi' # noqa: E501\n\n\ndef export_votes_util():\n \"\"\"Export collected votes.\"\"\"\n args = init_cli_util(\"\"\"\n Export collected votes.\n\n This utility copies current ballot box from voting service to backup\n service and outputs ballot box content.\n\n Usage: ivxv-export-votes [--consolidate] \n\n Options:\n --consolidate Consolidate all collected votes\n \"\"\")\n\n try:\n export_votes(args[\"--consolidate\"], args[\"\"])\n except IvxvError as err:\n log.error(err)\n return 1\n\n return 0\n\n\ndef export_votes(must_consolidate, output_filename):\n \"\"\"Export votes.\"\"\"\n # fail if output file already exist\n if os.path.exists(output_filename):\n raise IvxvError(f\"Output file {output_filename!r} already exist\")\n\n # create backup of current ballot box\n log.info('Creating backup copy from current ballot box')\n try:\n subprocess.run(['ivxv-backup', 'ballot-box'], check=True)\n except OSError as err:\n raise IvxvError(f\"Creating ballot box backup failed: {err.strerror}\")\n except subprocess.CalledProcessError as err:\n raise IvxvError(f\"Creating ballot box backup failed: {err}\")\n\n # create handler for backup service\n services = get_services(include_types=['backup'])\n if not services:\n raise IvxvError('Backup service is not defined')\n assert len(services) == 1\n\n with Service(*list(services.items())[0]) as backup_service:\n log.debug('Backup service: %s', backup_service.service_id)\n ballot_box_filepath = datetime.datetime.now().strftime(\n '/var/lib/ivxv/ballot-box-consolidated-%Y%m%d_%H%M.zip')\n\n # run consolidation in backup service\n if must_consolidate:\n proc = backup_service.ssh([\n 'ivxv-voteunion', ballot_box_filepath,\n '/var/backups/ivxv/ballot-box/ballot-box-????????_????.zip'\n ])\n if proc.returncode:\n raise IvxvError('Consolidation command failed in backup service')\n else: # export without consolidation\n # detect last backup filename\n cmd = [\n 'ls', '/var/backups/ivxv/ballot-box/ballot-box-????????_????.zip'\n ]\n proc = backup_service.ssh(cmd, stdout=subprocess.PIPE, check=True)\n ballot_box_filepath = proc.stdout.decode('UTF-8').strip().split(\n '\\n')[-1]\n\n # copy consolidated ballot box from backup\n log.info('Copying ballot box to management service')\n if not backup_service.scp(\n output_filename,\n ballot_box_filepath,\n \"consolidated ballot box\" if must_consolidate else \"ballot box\",\n to_remote=False):\n raise IvxvError('Failed to copy ballot box to management service')\n if must_consolidate:\n log.info('Removing consolidated ballot box from backup service')\n backup_service.ssh(['rm', '-v', ballot_box_filepath])\n\n log.info(\"Collected votes archive is written to %r\", output_filename)\n\n\ndef generate_processor_input_util():\n \"\"\"Generate input for processor application.\"\"\"\n args = init_cli_util(\n \"\"\"\n Generate input for processor application.\n\n This utility generates ZIP container with data files\n for processor application to validate ballot box:\n\n 1. District list;\n 2. Voter lists;\n 3. Validation key for vote registration requests;\n 4. Configuration for processor application.\n\n Usage: ivxv-generate-processor-input \n \"\"\"\n )\n\n try:\n election_id, cfg = generate_processor_check_cfg()\n generate_processor_input(election_id, cfg, args[\"\"])\n except IvxvError as err:\n log.error(err)\n return 1\n\n return 0\n\n\ndef generate_processor_check_cfg():\n \"\"\"Generate config file for processor application.\"\"\"\n log.info(\"Generating processor application config\")\n\n processor_check_cfg = OrderedDict(\n districts=None,\n registrationlist=\"registrationlist.zip\",\n registrationlist_checksum=\"registrationlist.zip.sha256sum.asice\",\n vlkey=None,\n tskey=\"ts.key\",\n voterlists=[],\n election_start=None,\n voterforeignehak=None,\n out=None,\n )\n\n # read collector config from management database\n with IVXVManagerDb() as db:\n election_id = db.get_value(\"election/election-id\")\n processor_check_cfg[\"election_start\"] = db.get_value(\"election/electionstart\")\n districts_version = db.get_value(\"list/districts\")\n voter_list_states = []\n for changeset_no in range(10_000):\n try:\n voter_list_state = db.get_value(f\"list/voters{changeset_no:04d}-state\")\n except KeyError:\n break\n if voter_list_state not in [\"APPLIED\", \"SKIPPED\"]:\n raise IvxvError(\n f\"Voter list changeset #{changeset_no} \"\n f\"has unexpected state {voter_list_state!r}\"\n )\n voter_list_states.append(voter_list_state)\n if not election_id:\n raise IvxvError(\"Election is not configured\")\n if not districts_version:\n raise IvxvError(\"District list is not loaded\")\n if not voter_list_states:\n raise IvxvError(\"Initial voter list is not loaded\")\n\n processor_check_cfg.update(\n {\n \"districts\": f\"{election_id}.districts.json.bdoc\",\n \"out\": f\"{election_id}-out-1\",\n }\n )\n\n # read election config from command file\n try:\n election_cfg = command_file.load_cfg_file_content(\n \"election\", f\"{election_id}.election.yaml\", \"/etc/ivxv/election.bdoc\"\n )\n except (IvxvError, OSError) as err:\n raise IvxvError(f\"Error while loading config file: {err}\")\n except UnicodeDecodeError as err:\n raise IvxvError(f\"Error while decoding config file: {err}\")\n\n # copy election config values\n if \"voterforeignehak\" in election_cfg:\n processor_check_cfg[\"voterforeignehak\"] = election_cfg[\"voterforeignehak\"]\n else:\n processor_check_cfg.pop(\"voterforeignehak\")\n processor_check_cfg[\"vlkey\"] = election_cfg[\"voterlist\"][\"key\"]\n\n # generate voter list filenames\n for changeset_no, voter_list_state in enumerate(voter_list_states):\n voter_list_record = dict(\n path=f\"{changeset_no:02d}.{election_id}.voters.utf\",\n signature=f\"{changeset_no:02d}.{election_id}.voters.sig\",\n )\n if voter_list_state == \"SKIPPED\":\n voter_list_record[\n \"skip_cmd\"\n ] = f\"{changeset_no:02d}.{election_id}.voters-skip.yaml.bdoc\"\n processor_check_cfg[\"voterlists\"].append(voter_list_record)\n\n return election_id, processor_check_cfg\n\n\ndef generate_processor_input(election_id, processor_check_cfg, output_filename):\n \"\"\"Generate input file for processor application.\"\"\"\n # fail if output file already exist\n if os.path.exists(output_filename):\n raise IvxvError(f\"Output file {output_filename!r} already exist\")\n\n log.info(\"Creating input file for processor application\")\n\n with tempfile.TemporaryDirectory() as output_dir:\n log.info(\"Preparing container structure in directory %r\", output_dir)\n\n # district list\n filename = processor_check_cfg[\"districts\"]\n log.info(\"Copying district list %r\", filename)\n shutil.copy(\n cfg_path(\"active_config_files_path\", \"districts.bdoc\"),\n f\"{output_dir}/{filename}\",\n )\n\n # key to verify voter list signer\n filename = \"voterfile.pub.key\"\n log.info(\"Copying voter list signing key %r\", filename)\n with open(f\"{output_dir}/{filename}\", \"w\") as fd:\n fd.write(processor_check_cfg[\"vlkey\"])\n processor_check_cfg[\"vlkey\"] = filename\n\n # voter lists\n for changeset_no, voter_list_files in enumerate(\n processor_check_cfg[\"voterlists\"]\n ):\n input_filepath = cfg_path(\n \"active_config_files_path\",\n f\"voters{changeset_no:04d}.zip\" if changeset_no else \"voters0000.bdoc\",\n )\n with zipfile.ZipFile(input_filepath) as input_zip:\n for description, key in [\n [\"content\", \"path\"],\n [\"signature\", \"signature\"],\n [\"skipping command\", \"skip_cmd\"],\n ]:\n try:\n filename = voter_list_files[key]\n except KeyError:\n continue\n file_ext = os.path.splitext(filename)[-1]\n log.info(\n \"Copying voter list #%d %s %r\",\n changeset_no,\n description,\n filename,\n )\n if key == \"skip_cmd\":\n shutil.copy(\n cfg_path(\n \"active_config_files_path\",\n f\"voters{changeset_no:04d}.bdoc\",\n ),\n f\"{output_dir}/\"\n f\"{changeset_no:02d}.{election_id}.voters-skip.yaml.bdoc\",\n )\n else:\n with input_zip.open(\n f\"{election_id}-voters-{changeset_no}{file_ext}\"\n ) as zip_fd:\n with open(f\"{output_dir}/{filename}\", \"wb\") as fd:\n fd.write(zip_fd.read())\n\n # key to verify registration requests\n filename = processor_check_cfg[\"tskey\"]\n log.info(\"Copying registration requests verification key %r\", filename)\n shutil.copy(\n \"/var/lib/ivxv/service/tspreg-pubkey.pem\",\n f\"{output_dir}/{filename}\",\n )\n\n # setup YAML module to write OrderedDict\n def represent_dictionary_order(self, dict_data):\n return self.represent_mapping(\"tag:yaml.org,2002:map\", dict_data.items())\n\n def setup_yaml():\n yaml.add_representer(OrderedDict, represent_dictionary_order)\n\n setup_yaml()\n\n # config file for processor application\n filename = f\"{election_id}.processor.yaml\"\n log.info(\"Writing processor application config %r\", filename)\n with open(f\"{output_dir}/{filename}\", \"w\") as fd:\n fd.write(\n \"# Automaatselt genereeritud fail \"\n f\"{datetime.datetime.now():%d.%m.%Y %R}\\n\\n\"\n f\"# Generaator: {__file__}\\n\\n\"\n )\n yaml.dump(dict(check=processor_check_cfg), fd, default_flow_style=False)\n fd.write('\\n')\n fd.write(' # BALLOT BOX\\n')\n fd.write(' #ballotbox: votes.zip\\n')\n fd.write(' #ballotbox_checksum: votes.zip.sha256sum\\n')\n\n # generate ZIP container\n filenames = sorted(os.listdir(output_dir))\n output_filename_tmp = f\"{output_filename}.tmp\"\n log.info(\n \"Generating ZIP container %r with %d files\",\n output_filename_tmp,\n len(filenames),\n )\n with zipfile.ZipFile(output_filename_tmp, \"w\", allowZip64=True) as zip_file:\n for filename in filenames:\n log.info(\"Adding %r to ZIP container\", filename)\n zip_file.write(f\"{output_dir}/{filename}\", filename)\n\n shutil.move(output_filename_tmp, output_filename)\n\n log.info(\"Processor input is written to %r\", output_filename)\n\n\ndef copy_logs_to_logmon_util():\n \"\"\"Copy IVXV log files from service hosts to Log Monitor.\"\"\"\n # validate CLI arguments\n args = init_cli_util(\"\"\"\n Copy IVXV log files from service hosts to Log Monitor.\n\n This utility transports collected IVXV log files from IVXV services\n (including Log Collector Service) to Log Monitor.\n\n Usage: ivxv-copy-log-to-logmon [--log-level=] [ ...]\n\n Options:\n Service host name.\n --log-level= Logging level [Default: INFO].\n \"\"\")\n\n # check collector state\n with IVXVManagerDb() as db:\n collector_state = db.get_value('collector/state')\n logmonitor_address = db.get_value('logmonitor/address')\n services = db.get_all_values('service')\n if collector_state == COLLECTOR_STATE_NOT_INSTALLED:\n if not sys.stdout.isatty(): # suppress warning if executed from crontab\n return 0\n log.warning(\"Collector is not installed\")\n return 1\n\n # create service host list\n hostnames = args['']\n if not hostnames:\n hostnames = []\n for service in services.values():\n is_main_service = (\n SERVICE_TYPE_PARAMS[service['service-type']]['main_service'])\n if ((is_main_service\n or service['service-type'] == 'log')\n and service['state'] != SERVICE_STATE_REMOVED):\n hostnames.append(service['ip-address'].split(':')[0])\n hostnames = list(set(hostnames))\n\n # checking access to Log Monitor account\n if not logmonitor_address:\n log.error('Log monitor is not defined')\n return 1\n log.info(\"Using address %r for log monitor\", logmonitor_address)\n logmon_account = f'logmon@{logmonitor_address}'\n log.info('Checking SSH access to Log Monitor account %s', logmon_account)\n proc = exec_remote_cmd(['ssh', logmon_account, 'true'])\n if proc.returncode:\n log.error('Cannot access to Log Monitor (%s)', logmon_account)\n return 1\n\n # copy log file from service hosts to Log Monitor\n exit_code = 0\n for hostname in hostnames:\n remote_account = f'ivxv-admin@{hostname}'\n\n # check if service host have Log Monitor host key\n log.info(\"Checking if %r have Log Monitor host key\", remote_account)\n proc = exec_remote_cmd(\n ['ssh', hostname, 'ssh-keygen', '-F', logmonitor_address],\n stdout=subprocess.PIPE)\n if proc.returncode:\n log.error(\n 'Failed to check Log Monitor host key for %s', remote_account)\n log.info('Installing Log Monitor host key for %s', remote_account)\n proc = subprocess.run(\n ['sh', '-c',\n f'ssh-keygen -F {logmonitor_address} | '\n 'grep -v ^# | '\n f'ssh {hostname} tee --append .ssh/known_hosts'],\n check=False,\n )\n if proc.returncode:\n log.error('Failed to install Log Monitor host key for %s',\n remote_account)\n continue\n\n if not copy_logs_from_host_to_logmon(hostname, logmon_account):\n exit_code = 1\n\n return exit_code\n\n\ndef copy_logs_from_host_to_logmon(hostname, logmon_account):\n \"\"\"Copy log files from service host to Log Monitor.\"\"\"\n # acquire process lock\n lockfile_path = cfg_path(\n 'ivxv_admin_data_path',\n f'service/copy-log-from-{hostname}-to-logmon.lock')\n lock = fasteners.InterProcessLock(lockfile_path)\n if not lock.acquire(blocking=False):\n log.warning('Lock exists for process \"copy logs from host %s '\n 'to Log Monitor\"', hostname)\n return False\n\n # execute rsync command in host to copy log file to Log Monitor\n proc = None\n try:\n log.info(\n \"Copying IVXV service log files from host %r to Log Monitor\",\n hostname)\n transfer_cmd = [\n 'ivxv-admin-helper', 'copy-logs-to-logmon', hostname,\n logmon_account\n ]\n cmd = ['ssh-agent', 'ssh', '-A', hostname] + transfer_cmd\n\n proc = subprocess.run(cmd, check=False)\n finally:\n lock.release()\n\n if not proc.returncode:\n return True\n\n log.error(\"Failed to copy log file from host %r to Log Monitor\",\n hostname)\n return False\n\n\ndef update_software_pkg_util():\n \"\"\"Update service packages in service hosts.\"\"\"\n # validate CLI arguments\n args = init_cli_util(\"\"\"\n Update service packages in IVXV service hosts.\n\n This utility checks versions of software packages in service hosts\n and installs new versions if required.\n\n Usage: ivxv-update-packages [--force] [--service=] [--package=]\n\n Options:\n --force Update even package version does not require update\n --service= Update only specific service package (e.g. ivxv-voting)\n --package= Path to the service package\n \"\"\")\n\n if (not args['--service'] and args['--package']\n or args['--service'] and not args['--package']):\n log.error('--service and --package should be set at the same time')\n return 1\n\n # generate list of voting services that are in required state\n services = get_services(\n require_collector_state=[\n COLLECTOR_STATE_INSTALLED,\n COLLECTOR_STATE_CONFIGURED,\n COLLECTOR_STATE_FAILURE,\n COLLECTOR_STATE_PARTIAL_FAILURE,\n ],\n service_state=[\n SERVICE_STATE_INSTALLED,\n SERVICE_STATE_CONFIGURED,\n SERVICE_STATE_FAILURE,\n ],\n include_types=[args['--service'] or []]\n )\n if not services:\n return 1\n\n host_versions = dict(\n [services[service_id]['ip-address'].split(':')[0], '']\n for service_id in sorted(services))\n update_res = dict(failure=[], install=[], skip=[])\n\n def get_installed_pkg_ver():\n \"\"\"Get version string if installed package in service host.\"\"\"\n service.log.info('Detect %s package version', pkg_name)\n proc = service.ssh(\n f'dpkg --status {pkg_name} | grep ^Version: | cut -d: -f2',\n stdout=subprocess.PIPE,\n account='ivxv-admin')\n return proc.stdout.decode('UTF-8').strip()\n\n for service_id, service_data in sorted(services.items()):\n with Service(service_id, service_data) as service:\n # check ivxv-common version\n host_version = host_versions.get(service.hostname)\n pkg_name = 'ivxv-common'\n # if specific service is requested to update, then skip\n install_pkg = bool(args['--force']) or bool(args['--service'])\n if not install_pkg and host_version != __version__:\n host_versions[service.hostname] = get_installed_pkg_ver()\n install_pkg = host_versions[service.hostname] != __version__\n\n # install ivxv-common if required, don't install if specific service\n # is requested\n if install_pkg and not bool(args['--service']):\n if not service.update_ivxv_common_pkg():\n update_res['failure'].append([service_id, pkg_name])\n continue\n update_res['install'].append([service_id, pkg_name])\n host_versions[service.hostname] = __version__\n else:\n update_res['skip'].append([service_id, pkg_name])\n\n # check service package version and upgrade if required,\n # package will be upgraded if specific service requested\n pkg_name = service.deb_pkg_name\n install_pkg = (args['--force'] or get_installed_pkg_ver() != __version__\n or args['--service'])\n\n # install package if required\n if install_pkg:\n if not service.install_service_pkg(is_update=True,\n package=args['--package']):\n update_res['failure'].append([service_id, pkg_name])\n continue\n update_res['install'].append([service_id, pkg_name])\n else:\n update_res['skip'].append([service_id, pkg_name])\n\n # output result\n for service_id, pkg_name in update_res['install']:\n log.info('Successfully installed service %s package %s',\n service_id, pkg_name)\n for service_id, pkg_name in update_res['failure']:\n log.error('Failed to install service %s package %s',\n service_id, pkg_name)\n log.info('Service update stats: %d packages installed, '\n '%d package installations failed, %s packages skipped',\n len(update_res['install']),\n len(update_res['failure']),\n len(update_res['skip']))\n\n return 1 if update_res['failure'] else None\n\n\ndef manage_service():\n \"\"\"Manage IVXV services.\"\"\"\n # validate CLI arguments\n args = init_cli_util(\"\"\"\n Manage IVXV services.\n\n Usage: ivxv-service ...\n\n Options:\n Management action: start, stop, restart, ping\n \"\"\")\n action = args['']\n if action not in ['start', 'stop', 'restart', 'ping']:\n log.error('Invalid action: %s', action)\n return 1\n\n services = get_collector_data()\n if services is None:\n log.error('Election data is not loaded')\n return 1\n\n exit_code = 0\n for service_id in args['']:\n if service_id not in services:\n log.error('Unknown service %s', service_id)\n exit_code = 1\n continue\n if action == 'ping':\n log.info('Pinging service %s', service_id)\n if ping_service(service_id, services[service_id]):\n log.info('Service %s is alive', service_id)\n else:\n log.error('Failed to query service %s status', service_id)\n exit_code = 1\n continue\n\n with Service(service_id, services[service_id]) as service:\n if action == 'stop':\n log.info('Stopping service %s', service_id)\n if service.stop_service():\n log.info('Service %s stopped', service_id)\n else:\n log.error('Failed to stop service %s', service_id)\n exit_code = 1\n continue\n\n # start, restart\n log.info('%sing service %s', action.capitalize(), service_id)\n with Service(service_id, services[service_id]) as service:\n if service.restart_service():\n log.info('Service %s %sed', service_id, action)\n else:\n log.error('Failed to %s service %s', action, service_id)\n exit_code = 1\n\n return exit_code\n\n\ndef voterstats_util():\n \"\"\"Import voter stats from voting service and export to VIS.\"\"\"\n args = init_cli_util(\n \"\"\"\n Import voter stats from voting service and export common stats to VIS.\n\n Usage: ivxv-voterstats [--action=] [--file=]\n [--service-id=] [--log-level=]\n\n Options:\n Stats type \"common\" or \"detail\".\n --action= Limit actions for \"common\" stats type.\n Possible values are \"import\" and \"export\".\n [Default: all]\n --file= Path to stats file.\n --service-id= Voting service ID [Default: random].\n --log-level= Logging level [Default: INFO].\n \"\"\"\n )\n stats_type = args[\"\"]\n action = args[\"--action\"]\n filepath = args[\"--file\"]\n if not filepath:\n filepath = f\"/var/lib/ivxv/admin-ui-data/voterstats-{stats_type}.json\"\n service_id = args[\"--service-id\"]\n\n # validate CLI args\n if stats_type not in [\"common\", \"detail\"]:\n log.error(\"Unexpected stats type %r\", stats_type)\n return 1\n\n # check collector config state\n try:\n with IVXVManagerDb() as db:\n if not db.get_value(\"list/districts\"):\n raise IvxvError(\"District list is not loaded\")\n services = get_services(\n db=db, service_state=[\"CONFIGURED\"], include_types=[\"voting\"]\n )\n if not services:\n raise IvxvError(\"No configured voting service found\")\n except IvxvError as err:\n if not sys.stdout.isatty(): # suppress warning if executed from crontab\n return 0\n log.warning(err)\n return 1\n\n # choose voting service\n if service_id == \"random\":\n service_id = random.choice(list(services.keys()))\n if service_id not in services:\n services = get_services(include_types=[\"voting\"])\n if service_id in services:\n log.error(\n \"Voting service %r is not configured (current state: %s)\",\n service_id,\n services[service_id][\"state\"],\n )\n else:\n log.error(\"No voting service %r found\", service_id)\n return 1\n service_logging.log.setLevel(args[\"--log-level\"])\n with Service(service_id, services[service_id]) as service:\n # import stats\n try:\n if action in [\"all\", \"import\"]:\n import_voterstats(stats_type, service, filepath, args[\"--log-level\"])\n except IvxvError:\n log.error(\n \"Failed to import %s stats from service %r\", stats_type, service_id)\n return 1\n\n # export stats to VIS only if requested\n command_file.log.setLevel(args[\"--log-level\"])\n try:\n if action in [\"all\", \"export\"]:\n export_voterstats(stats_type, filepath)\n except IvxvError:\n log.error(\"Failed to export %s stats to VIS\", stats_type)\n return 1\n\n return 0\n\n\ndef import_voterstats(stats_type, service, filepath, log_level):\n \"\"\"Import voter stats from voting service.\"\"\"\n log.info(\"Generating %s stats in voting service %r\", stats_type, service.service_id)\n cmd = [\"ivxv-voterstats\", \"-instance\", service.service_id]\n if stats_type == \"detail\":\n cmd.append(\"-detailed\")\n if logging.getLevelName(log_level) >= 30:\n cmd.append(\"-q\")\n remote_filepath = (\n f\"/var/lib/ivxv/user/ivxv-voting/ivxv-voterstats-{os.getpid()}.json\"\n )\n cmd.append(remote_filepath)\n proc = service.ssh(cmd)\n if proc.returncode:\n raise IvxvError(\n f\"Failed to generate {stats_type} stats \"\n f\"in voting service {service.service_id}\"\n )\n\n log.info(\n \"Importing %s stats from voting service %r\", stats_type, service.service_id\n )\n if not service.scp(\n filepath, remote_filepath, f\"{stats_type} stats\", to_remote=False\n ):\n raise IvxvError(f\"Failed to {stats_type} stats to management service\")\n\n\ndef export_voterstats(stats_type, filepath):\n \"\"\"Export voter stats to VIS.\"\"\"\n log.info(\"Exporting %s stats to VIS\", stats_type)\n with open(filepath) as fd:\n stats = json.load(fd)\n\n # get params from election config\n cfg = command_file.load_collector_cmd_file(\"election\", \"/etc/ivxv/election.bdoc\")\n if not cfg:\n raise IvxvError(\"Election config not found\")\n ca_certs_filepath = None\n if cfg[\"vis\"].get(\"ca\"):\n ca_certs_filepath = cfg_path(\"vis_path\", \"ca.pem\")\n with open(ca_certs_filepath, \"w\") as fd:\n fd.write(\"\\n\".join(cfg[\"vis\"][\"ca\"]))\n\n # upload voter stats\n url = f\"{cfg['vis']['url']}voters-by-county\"\n log.info(\"Upload voter stats to %r\", url)\n resp = requests.post(\n url,\n verify=ca_certs_filepath,\n cert=(\n \"/etc/ssl/certs/ivxv-admin-client.crt\",\n \"/etc/ssl/private/ivxv-admin-client.key\",\n ),\n json=stats,\n )\n log.info(\n \"VIS responded to voter stats upload: %r %s\", resp.status_code, resp.reason\n )\n\n if resp.status_code != 204:\n raise IvxvError(\n f\"Server responded with status {resp.status_code} - {resp.reason}\"\n )\n\n\ndef voting_sessions_util():\n \"\"\"Utility to import voting sessions from Log Monitor.\"\"\"\n args = init_cli_util(\n \"\"\"\n Import list of voting sessions from Log Monitor.\n\n Session data is in CSV format.\n\n Usage: ivxv-voting-sessions (vote | verify) [--anonymize] [--uniq]\n [--log-level=]\n\n Options:\n Write sessions to file.\n --anonymize Anonymize session data\n (IP addresses and ID codes).\n --uniq Consolidate session data.\n --log-level= Logging level [Default: INFO].\n \"\"\"\n )\n\n # check collector state\n with IVXVManagerDb() as db:\n collector_state = db.get_value(\"collector/state\")\n logmonitor_address = db.get_value(\"logmonitor/address\")\n if collector_state == COLLECTOR_STATE_NOT_INSTALLED:\n # emit warning only if attached to console\n # (suppress if executed from crontab)\n if sys.stdout.isatty():\n log.warning(\"Collector is not installed\")\n return 1\n return 0\n\n # checking access to Log Monitor account\n if not logmonitor_address:\n log.error(\"Log monitor is not defined\")\n return 1\n log.info(\"Using address %r for log monitor\", logmonitor_address)\n logmon_account = f\"logmon@{logmonitor_address}\"\n log.info(\"Checking SSH access to Log Monitor account %s\", logmon_account)\n proc = exec_remote_cmd([\"ssh\", logmon_account, \"true\"])\n if proc.returncode:\n log.error(\"Cannot access to Log Monitor (%s)\", logmon_account)\n return 1\n\n try:\n import_voting_sessions(\n logmon_account,\n session_type=\"vote\" if args[\"vote\"] else \"verify\",\n anonymize=args[\"--anonymize\"],\n uniq=args[\"--uniq\"],\n output_filepath=args[\"\"],\n log_level=args[\"--log-level\"],\n )\n except IvxvError as err:\n log.error(err)\n return 1\n\n return 0\n\n\ndef import_voting_sessions(\n logmon_account, session_type, anonymize, uniq, output_filepath, log_level\n):\n \"\"\"Import voting sessions from Log Monitor.\"\"\"\n # generate CSV\n log.info(\"Generating voting sessions file in Log Monitor\")\n remote_outfile = f\"~logmon/voting-sessions-{session_type}-{os.getpid()}.json\"\n remote_cmd = [\"ivxv-export-voting-sessions\", f\"--log-level={log_level}\"]\n if anonymize:\n remote_cmd.append(\"--anonymize\")\n if uniq:\n remote_cmd.append(\"--uniq\")\n remote_cmd += [session_type, remote_outfile]\n cmd = [\"ssh\", logmon_account] + remote_cmd\n try:\n subprocess.run(cmd, stdout=subprocess.PIPE, check=True)\n except subprocess.CalledProcessError as err:\n raise IvxvError(\"Failed to generate voting sessions\") from err\n log.info(\"Voting sessions file successfully generated in Log Monitor\")\n\n # import CSV\n log.info(\"Importing voting sessions file from Log Monitor\")\n cmd = [\"scp\", f\"{logmon_account}:{remote_outfile}\", output_filepath]\n try:\n subprocess.run(cmd, stdout=subprocess.PIPE, check=True)\n except subprocess.CalledProcessError as err:\n raise IvxvError(\"Failed to import voting sessions\") from err\n log.info(\"Voting sessions file successfully imported from Log Monitor\")\n\n\ndef remove_ivxv_admin_crontab():\n \"\"\"Remove ivxv-admin user crontab if exists.\"\"\"\n log.info('Removing ivxv-admin user crontab (if exists)')\n proc = subprocess.run([\"crontab\", \"-r\"], check=False)\n assert proc.returncode in [0, 1], 'Unexpected exit code for crontab command'\n\n\ndef generate_detail_stats_crontab(cfg: dict):\n \"\"\"Generate crontab for detailed statistics exchange with VIS.\n Generated file will be stored to db.\n\n :param cfg: content of configuration file\n :type cfg: dict\n \"\"\"\n\n # load Jinja2 crontab template for detailed statistics\n template_dir = Environment(loader=PackageLoader('ivxv_admin', 'templates'))\n template = template_dir.get_template('ivxv_detail_stats_crontab.jinja')\n\n # read `stats:` section from a configuration file,\n # use default values if configuration file doesn't have `stats:` section\n cron_cfg = cfg.get('stats', {}).get('detail', {}).get('scheduler', {})\n crontab_params = {\n 'minute': cron_cfg.get('cron', {}).get('min', '*/15') or '*/15',\n 'hour': cron_cfg.get('cron', {}).get('hour', '*') or '*',\n 'day': cron_cfg.get('cron', {}).get('day', '*') or '*',\n 'month': cron_cfg.get('cron', {}).get('month', '*') or '*',\n 'weekday': cron_cfg.get('cron', {}).get('weekday', '*') or '*',\n }\n\n # render Jinja2 template\n rendered_template = template.render(\n time_generated=datetime.datetime.now().strftime('%d.%M.%Y %H:%M:%S'),\n **crontab_params,\n )\n\n # override crontab rendered template in a db\n with IVXVManagerDb(for_update=True) as db:\n db.set_value('stats/detail/scheduler/cron', rendered_template)\n\n\ndef detail_stats_crontab_editor() -> int:\n args = init_cli_util(\"\"\"\n Generate crontab for IVXV detail statistics export to VIS automation.\n\n This utility must be called as editor by crontab utility:\n\n $ env VISUAL=ivxv-detail-stats-crontab crontab -e\n\n Usage: ivxv-detail-stats-crontab \n \"\"\")\n filepath = args['']\n\n # when you run `crontab -e`, cron generates temporary file at '/tmp/XYZ/crontab',\n # and that temporary file is passed here as args[''], i.e 'filepath'\n crontab_tmp_file_content: str\n\n # read crontab temporary file\n with open(filepath, 'r') as fp:\n try:\n crontab_tmp_file_content = fp.read()\n except Exception as err:\n msg = \"Can't read crontab temporary file %r: %s\"\n log.error(msg, filepath, err.__str__())\n return 1\n\n # get rendered Jinja2 crontab template for detail stats from a db\n with IVXVManagerDb() as db:\n # get from db\n detail_stats_crontab = db.get_value('stats/detail/scheduler/cron')\n # remove old block:\n # ### block ivxv_detail_stats_crontab ###\n # ...\n # ### endblock ivxv_detail_stats_crontab ###\n # from a crontab temporary file if any exists\n try:\n without_detail_stats_crontab = remove_detail_stats_crontab(\n data=crontab_tmp_file_content)\n except ValueError as err:\n msg = \"Can't remove ivxv_detail_stats block from a temporary file %r: %s\"\n log.error(msg, filepath, err.__str__())\n return 1\n # add new block to a crontab temporary file\n crontab = insert_detail_stats_crontab(\n data=without_detail_stats_crontab, crontab=detail_stats_crontab)\n\n # Pause for 1 second. Crontab checks mtime to detect file modifications. It\n # seems that crontab can't detect mtime change if changes happens too\n # quickly (tested in Ubuntu Xenial).\n time.sleep(1)\n\n # override crontab temporary file with a new content\n with open(filepath, \"w\") as fp:\n try:\n fp.write(crontab)\n except Exception as err:\n msg = \"Can't write to a crontab temporary file %r: %s\"\n log.error(msg, filepath, err.__str__())\n return 1\n\n\ndef remove_detail_stats_crontab(data: str) -> str:\n \"\"\"Remove ivxv_detail_stats_crontab block from a data.\n\n :param data: any data\n :type data: str\n :return: data without ivxv_detail_stats_crontab block\n :rtype: str\n \"\"\"\n block, found = __get_detail_stats_crontab_block(data=data)\n if not found:\n return data\n return data.replace(block, '').strip()\n\n\ndef insert_detail_stats_crontab(data: str, crontab: str) -> str:\n \"\"\"Wrap crontab in an ivxv_detail_stats_crontab block and insert it to a data.\n\n :param data: any data\n :type data: str\n :param crontab: rendered ivxv_detail_stats Jinja2 crontab template file\n :type crontab: str\n :return: data with an ivxv_detail_stats_crontab block\n :rtype: str\n \"\"\"\n header = '### block ivxv_detail_stats_crontab ###'\n tail = '### endblock ivxv_detail_stats_crontab ###'\n return data + \"\\n\\n\" + header + \"\\n\" + crontab + \"\\n\" + tail + \"\\n\"\n\n\ndef __get_detail_stats_crontab_block(data: str) -> (str, bool):\n \"\"\"Get ivxv_detail_stats_crontab block from a data.\n\n :param data: any data\n :type data: str\n :return: ivxv_detail_stats_crontab block and True on success,\n otherwise data and False\n :rtype: str, bool\n :raise ValueError: if ivxv_detail_stats_crontab block's header/tail is malformed,\n however though, if both header and tail are malformed then function assumes that\n ivxv_detail_stats_crontab block doesn't exist in a data\n \"\"\"\n header = '### block ivxv_detail_stats_crontab ###'\n tail = '### endblock ivxv_detail_stats_crontab ###'\n\n # remove leading and trailing whitespaces/newlines\n data_stripped = data.strip()\n\n # get start index of a header\n header_start_index = data_stripped.find(header)\n\n # get start index of a tail\n tail_start_index = data_stripped.find(tail)\n\n # both header and tail aren't present in a data_stripped\n if header_start_index < 0 and tail_start_index < 0:\n return data, False\n # both header and tail present in a data_stripped\n elif header_start_index >= 0 and tail_start_index >= 0:\n # get end index of a tail\n tail_end_index = tail_start_index + len(tail)\n # extract ivxv_detail_stats_crontab block from a data_stripped\n return data_stripped[header_start_index:tail_end_index], True\n else:\n if header_start_index < 0:\n raise ValueError(\"malformed ### block ivxv_detail_stats_crontab ###\")\n else:\n raise ValueError(\"malformed ### endblock ivxv_detail_stats_crontab ###\")\n\n\ndef install_detail_stats_crontab():\n \"\"\"Install crontab for detail stats export with VIS automation.\"\"\"\n subprocess.run(\n [\"env\", \"VISUAL=ivxv-detail-stats-crontab\", \"crontab\", \"-e\"], check=True)\n\n\ndef generate_voting_facts_crontab(cfg: dict):\n \"\"\"Generate crontab for ivxv-storageorder automation.\n Generated file will be stored to db.\n\n :param cfg: content of configuration file\n :type cfg: dict\n \"\"\"\n\n # load Jinja2 crontab template for voting facts\n template_dir = Environment(loader=PackageLoader('ivxv_admin', 'templates'))\n template = template_dir.get_template('ivxv_voting_facts_crontab.jinja')\n\n # read `stats:` section from a configuration file,\n # use default values if configuration file doesn't have `stats:` section\n cron_cfg = cfg.get('stats', {}).get('voting_facts', {}).get('scheduler', {})\n crontab_params = {\n 'minute': cron_cfg.get('cron', {}).get('min', '*/15') or '*/15',\n 'hour': cron_cfg.get('cron', {}).get('hour', '*') or '*',\n 'day': cron_cfg.get('cron', {}).get('day', '*') or '*',\n 'month': cron_cfg.get('cron', {}).get('month', '*') or '*',\n 'weekday': cron_cfg.get('cron', {}).get('weekday', '*') or '*',\n }\n\n # render Jinja2 template\n rendered_template = template.render(\n time_generated=datetime.datetime.now().strftime('%d.%M.%Y %H:%M:%S'),\n **crontab_params,\n )\n\n # override crontab rendered template in a db\n with IVXVManagerDb(for_update=True) as db:\n db.set_value('stats/voting_facts/scheduler/cron', rendered_template)\n\n\ndef voting_facts_crontab_editor() -> int:\n args = init_cli_util(\"\"\"\n Generate crontab for ivxv-storageorder automation.\n\n This utility must be called as editor by crontab utility:\n\n $ env VISUAL=ivxv-voting-facts-crontab crontab -e\n\n Usage: ivxv-voting-facts-crontab \n \"\"\")\n filepath = args['']\n\n # when you run `crontab -e`, cron generates temporary file at '/tmp/XYZ/crontab',\n # and that temporary file is passed here as args[''], i.e 'filepath'\n crontab_tmp_file_content: str\n\n # read crontab temporary file\n with open(filepath, 'r') as fp:\n try:\n crontab_tmp_file_content = fp.read()\n except Exception as err:\n msg = \"Can't read crontab temporary file %r: %s\"\n log.error(msg, filepath, err.__str__())\n return 1\n\n # get rendered Jinja2 crontab template for voting facts from a db\n with IVXVManagerDb() as db:\n # get from db\n voting_facts_crontab = db.get_value('stats/voting_facts/scheduler/cron')\n # remove old block:\n # ### block ivxv_voting_facts_crontab ###\n # ...\n # ### endblock ivxv_voting_facts_crontab ###\n # from a crontab temporary file if any exists\n try:\n without_voting_facts_crontab = remove_voting_facts_crontab(\n data=crontab_tmp_file_content)\n except ValueError as err:\n msg = \"Can't remove ivxv_voting_facts_crontab block from a tmp file %r: %s\"\n log.error(msg, filepath, err.__str__())\n return 1\n # add new block to a crontab temporary file\n crontab = insert_voting_facts_crontab(\n data=without_voting_facts_crontab, crontab=voting_facts_crontab)\n\n # Pause for 1 second. Crontab checks mtime to detect file modifications. It\n # seems that crontab can't detect mtime change if changes happens too\n # quickly (tested in Ubuntu Xenial).\n time.sleep(1)\n\n # override crontab temporary file with a new content\n with open(filepath, \"w\") as fp:\n try:\n fp.write(crontab)\n except Exception as err:\n msg = \"Can't write to a crontab temporary file %r: %s\"\n log.error(msg, filepath, err.__str__())\n return 1\n\n\ndef remove_voting_facts_crontab(data: str) -> str:\n \"\"\"Remove ivxv_voting_facts_crontab block from a data.\n\n :param data: any data\n :type data: str\n :return: data without ivxv_voting_facts_crontab block\n :rtype: str\n \"\"\"\n block, found = __get_voting_facts_crontab_block(data=data)\n if not found:\n return data\n return data.replace(block, '').strip()\n\n\ndef insert_voting_facts_crontab(data: str, crontab: str) -> str:\n \"\"\"Wrap crontab in an ivxv_voting_facts_crontab block and insert it to a data.\n\n :param data: any data\n :type data: str\n :param crontab: rendered ivxv_voting_facts_crontab Jinja2 crontab template file\n :type crontab: str\n :return: data with an ivxv_voting_facts_crontab block\n :rtype: str\n \"\"\"\n header = '### block ivxv_voting_facts_crontab ###'\n tail = '### endblock ivxv_voting_facts_crontab ###'\n return data + \"\\n\\n\" + header + \"\\n\" + crontab + \"\\n\" + tail + \"\\n\"\n\n\ndef __get_voting_facts_crontab_block(data: str) -> (str, bool):\n \"\"\"Get ivxv_voting_facts_crontab block from a data.\n\n :param data: any data\n :type data: str\n :return: ivxv_voting_facts_crontab block and True on success,\n otherwise data and False\n :rtype: str, bool\n :raise ValueError: if ivxv_voting_facts_crontab block's header/tail is malformed,\n however though, if both header and tail are malformed then function assumes that\n ivxv_voting_facts_crontab block doesn't exist in a data\n \"\"\"\n header = '### block ivxv_voting_facts_crontab ###'\n tail = '### endblock ivxv_voting_facts_crontab ###'\n\n # remove leading and trailing whitespaces/newlines\n data_stripped = data.strip()\n\n # get start index of a header\n header_start_index = data_stripped.find(header)\n\n # get start index of a tail\n tail_start_index = data_stripped.find(tail)\n\n # both header and tail aren't present in a data_stripped\n if header_start_index < 0 and tail_start_index < 0:\n return data, False\n # both header and tail present in a data_stripped\n elif header_start_index >= 0 and tail_start_index >= 0:\n # get end index of a tail\n tail_end_index = tail_start_index + len(tail)\n # extract ivxv_voting_facts_crontab block from a data_stripped\n return data_stripped[header_start_index:tail_end_index], True\n else:\n if header_start_index < 0:\n raise ValueError(\"malformed ### block ivxv_voting_facts_crontab ###\")\n else:\n raise ValueError(\"malformed ### endblock ivxv_voting_facts_crontab ###\")\n\n\ndef install_voting_facts_crontab():\n \"\"\"Install crontab for ivxv-storageorder automation.\"\"\"\n subprocess.run(\n [\"env\", \"VISUAL=ivxv-voting-facts-crontab\", \"crontab\", \"-e\"], check=True)\n\n\ndef voting_facts_util():\n \"\"\"Launch log analyzer on IVXV Logmonitor to search for missing voting facts, then\n export these facts as .csv file and run 'ivxv-storageorder' on a first Collector\n host, where operation succeeds, in case of unsuccessful operation it will choose\n another Collector host, until succeeds, or returns an error.\"\"\"\n init_cli_util(\n \"\"\"\n Launch log analyzer on IVXV Logmonitor to search for missing voting facts, then\n export these facts as .csv file and then run 'ivxv-storageorder' on a first\n Collector host, where operation succeeds, in case of unsuccessful operation it\n will choose another Collector host, until succeeds, or returns an error.\n\n Usage: ivxv-voting-facts\n \"\"\"\n )\n\n filename = f\"votesorder-{time.time_ns()}.csv\"\n\n with IVXVManagerDb() as db:\n collector_state = db.get_value(\"collector/state\")\n services = db.get_all_values(\"service\")\n logmon_host = db.get_value('logmonitor/address')\n if not logmon_host:\n log.error(\"Log monitor is not defined\")\n return 1\n if collector_state != COLLECTOR_STATE_CONFIGURED:\n if not sys.stdout.isatty(): # suppress warning if executed from crontab\n return 0\n log.warning(\"Collector is not configured\")\n return 1\n\n votesorder_services = {}\n\n # Find all votesorder service host addresses\n for service_id, service in services.items():\n service_type = service[\"service-type\"]\n is_votesorder_service = service_type == \"votesorder\"\n if is_votesorder_service and service[\"state\"] != SERVICE_STATE_REMOVED:\n votesorder_services[service_id] = service[\"ip-address\"].split(\":\")[0]\n\n if len(votesorder_services.keys()) < 1:\n log.error(\"No votesorder services found\")\n return 1\n\n # Prepare missing voting facts .csv file on first succeeded Logmonitor host\n logmon_account = f\"logmon@{logmon_host}\"\n proc = exec_remote_cmd(['ssh', logmon_account,\n \"ivxv-storageorder-prepare-csv.sh\",\n \"--filename\", filename])\n if proc.returncode:\n logmon_account = \"\"\n if proc.returncode == 2:\n log.info(\"No missing voting facts found\")\n return 0\n log.error(\n f\"Error while preparing .csv: {proc}\")\n\n if logmon_account == \"\":\n log.error(f\"Logmonitor host is not active {proc}\")\n return 1\n\n # Copy .csv file from succeeded Log host to first active Collector host\n collector_account = \"\"\n for service_host in votesorder_services.values():\n collector_account = f\"ivxv-votesorder@{service_host}\"\n proc = exec_remote_cmd(\n [\"scp\", f\"{logmon_account}:{filename}\", f\"{collector_account}:{filename}\"])\n if proc.returncode:\n collector_account = \"\"\n log.error(\n f\"Cannot copy .csv file from {logmon_account} to {collector_account} \"\n f\"due to an error: {proc}\")\n continue\n\n if collector_account == \"\":\n log.error(f\"No active Collector hosts among {votesorder_services.values()}\")\n return 1\n\n # Add missing voting facts using ivxv-storageorder\n for service_id, service_host in votesorder_services.items():\n collector_account = f\"ivxv-votesorder@{service_host}\"\n proc = exec_remote_cmd(\n [\"ssh\", f\"{collector_account}\",\n \"ivxv-storageorder\", \"-file\", f\"{filename}\",\n \"-instance\", f\"{service_id}\"])\n if proc.returncode:\n collector_account = \"\"\n log.error(f\"Running ivxv-storageorder failed with error: {proc}\")\n continue\n\n if collector_account == \"\":\n log.error(f\"ivxv-storageorder failed on {votesorder_services.values()} hosts\")\n return 1\n\n return 0\n\n\ndef create_voter_list_download_crontab(cfg: dict):\n \"\"\"\n Creates a cron job for running CLI ivxv-voter-list-download every X minute as\n defined in configuration file vis:min: section, X defaults to 15 minutes.\n :param cfg: configuration file\n \"\"\"\n # read `vis:` section from a configuration file and parse 'min:' int value out\n minutes = cfg.get('vis', {}).get('min', 15)\n\n with CronTab(user=IVXV_ADMIN_CRON_USER) as cron:\n # remove old ivxv-voter-list-download job\n for job in cron:\n if job.command == VOTER_LIST_DOWNLOAD_CRON_JOB:\n cron.remove(job)\n\n # install new one\n cron.new(command=VOTER_LIST_DOWNLOAD_CRON_JOB).minute.every(minutes)\n" }, { "path": "collector-admin/ivxv_admin/cli_utils/status_utils.py", "content": "# IVXV Internet voting framework\n\"\"\"CLI utilities for management service state.\"\"\"\n\nimport json\nimport re\n\nfrom jinja2 import Environment, PackageLoader\n\nfrom .. import lib\nfrom ..db import IVXVManagerDb\nfrom . import init_cli_util, log\n\n\ndef users_list_util():\n \"\"\"User listing utility for collector administrator interface.\"\"\"\n init_cli_util(\"\"\"\n List IVXV Collector Management Service registered users.\n\n Usage: ivxv-users-list\n \"\"\")\n\n # read users from database\n with IVXVManagerDb() as db:\n users = db.get_all_values('user')\n\n # output users\n user_no = 0\n for user_cn, permissions in sorted(users.items()):\n user_no += 1\n print(f\"{user_no}. {user_cn} Permissions: {permissions}\")\n\n if not user_no:\n print('No users defined')\n\n\ndef status_util():\n \"\"\"Output collector state.\"\"\"\n args = init_cli_util(\"\"\"\n Output IVXV Collector state.\n\n Usage: ivxv-status [--json] [--service= ...] [ ...]\n\n Options:\n --json Output full data in JSON format.\n Note: filters have no effect in JSON output.\n --service= Filter output by service ID.\n Note: This filter conflicts other section\n filters than \"smart\" or \"service\".\n Filter output by section. Possible values are:\n * collector - collector state;\n * election - election data;\n * config - versions of loaded config;\n * list - versions of loades lists;\n * service - service information;\n * ext - external service information;\n * storage - storage information;\n * smart - output only relevant data;\n * all - output all data;\n [Default: smart].\n \"\"\")\n filters = args[''] or ['smart']\n\n # validate CLI args\n data_sections = [\n 'collector', 'election', 'config', 'list', 'service', 'ext', 'storage']\n for arg in filters:\n if arg not in data_sections + ['all', 'smart']:\n log.error('Invalid section: %s', arg)\n return 1\n if 'all' in filters:\n filters = data_sections\n if args['--service']:\n if filters not in (['smart'], ['service']):\n log.error('Service ID can only used with '\n '\"smart\" or \"service\" section filters')\n return 1\n filters = ['service']\n if 'smart' in filters:\n filters = ['smart', 'collector', 'storage']\n\n # generate state data\n with IVXVManagerDb() as db:\n state = lib.generate_collector_state(db)\n\n # output JSON\n if args['--json']:\n print(json.dumps(state, indent=4, sort_keys=True))\n return 0\n\n # apply smart filtering\n if 'smart' in filters:\n cfg_state_filters(filters, state)\n\n # apply service ID filters\n if args['--service']:\n for service_id in args['--service']:\n if service_id not in state['service'].keys():\n log.error(\"Unknown service ID %r\", service_id)\n return 1\n for network_id in list(state['network']):\n for service_id in list(state['network'][network_id]):\n if service_id not in args['--service']:\n del state['network'][network_id][service_id]\n if not state['network'][network_id]:\n del state['network'][network_id]\n\n # output plain text\n tmpl_env = Environment(loader=PackageLoader('ivxv_admin', 'templates'))\n template = tmpl_env.get_template('ivxv_status.jinja')\n output = template.render(state, sections=filters)\n output = re.sub(r'\\n\\n+', '\\n\\n', output)\n print(output.strip())\n\n return 0\n\n\ndef cfg_state_filters(filters, state):\n \"\"\"Reconfigure list of state filters depending on actual state.\"\"\"\n if (state['config']['trust'] or\n state['config']['technical'] or\n state['config']['election']):\n filters += ['config']\n if state['config']['election']:\n filters += ['election']\n if (state['list']['choices-loaded'] or\n state['list']['choices'] or\n state['list']['districts-loaded'] or\n state['list']['districts'] or\n state['list'].get('voters0000') or\n state['list'].get('voters0000-loaded')):\n filters += ['list']\n if state.get('service'):\n filters += ['service']\n" }, { "path": "collector-admin/ivxv_admin/collector_state.py", "content": "# IVXV Internet voting framework\n\"\"\"\nCollector state for collector management service.\n\"\"\"\n\nimport datetime\nimport json\nimport logging\nimport os\n\nimport dateutil.parser\n\nfrom . import (COLLECTOR_PKG_FILENAMES, COLLECTOR_STATE_CONFIGURED,\n COLLECTOR_STATE_FAILURE, COLLECTOR_STATE_INSTALLED,\n COLLECTOR_STATE_NOT_INSTALLED, COLLECTOR_STATE_PARTIAL_FAILURE,\n SERVICE_STATE_CONFIGURED, SERVICE_STATE_FAILURE,\n SERVICE_STATE_INSTALLED, SERVICE_STATE_NOT_INSTALLED,\n SERVICE_TYPE_PARAMS)\nfrom .config import CONFIG, cfg_path\nfrom .service import generate_service_hints\n\n\n# create logger\nlog = logging.getLogger(__name__)\n\n\ndef generate_collector_state(db):\n \"\"\"Generate collector state data.\"\"\"\n state = db.get_all_values()\n\n # generate service data\n if state.get('service'):\n generate_service_hints(state['service'])\n\n # group services by network\n state['network'] = dict()\n for service_id, service_rec in state.get('service').items():\n nw_name = service_rec.pop('network')\n state['network'].setdefault(nw_name, dict())\n state['network'][nw_name][service_id] = service_rec\n\n # check package files\n assert 'storage' not in state\n state[\"storage\"] = {\n \"debs_exists\": [],\n \"debs_missing\": [],\n \"command_files_active\": [],\n \"command_files_inactive\": [],\n }\n for pkg_filename in COLLECTOR_PKG_FILENAMES.values():\n pkg_filepath = cfg_path('deb_pkg_path', pkg_filename)\n key = 'debs_exists' if os.path.exists(pkg_filepath) else 'debs_missing'\n state['storage'][key].append(pkg_filepath)\n\n # collect command files state\n command_filepaths = [\n cfg_path(\"command_files_path\", filename)\n for filename in os.listdir(CONFIG[\"command_files_path\"])\n if not filename.endswith(\".json\")\n ]\n for filename in os.listdir(CONFIG[\"active_config_files_path\"]):\n filepath = os.path.join(CONFIG[\"active_config_files_path\"], filename)\n if os.path.islink(filepath):\n try:\n command_filepaths.remove(os.readlink(filepath))\n except ValueError:\n log.warning(\n \"Unresolved config file link %r -> %r\",\n filepath,\n os.readlink(filepath),\n )\n state[\"storage\"][\"command_files_active\"].append(\n os.path.basename(os.readlink(filepath))\n )\n state[\"storage\"][\"command_files_active\"].sort()\n state[\"storage\"][\"command_files_inactive\"] = sorted(\n os.path.basename(filename) for filename in command_filepaths\n )\n\n # detect collector state\n state['collector_state'] = detect_collector_state(state)\n\n generate_voter_list_state(state)\n generate_election_state(state)\n\n return state\n\n\ndef detect_collector_state(state):\n \"\"\"Detect collector state.\n\n :param state: Collector state data. Probably values from\n Collector Management Database.\n :type state: dict\n \"\"\"\n service_states = [\n val['state'] for val in state.get('service', {}).values()\n ]\n\n # NOT INSTALLED\n # Stay in NOT INSTALLED state while:\n # - some service is not installed\n if (state['collector']['state'] == COLLECTOR_STATE_NOT_INSTALLED and\n (not state['config']['technical'] or\n not service_states or\n SERVICE_STATE_NOT_INSTALLED in service_states)):\n return COLLECTOR_STATE_NOT_INSTALLED\n\n # INSTALLED\n # Stay in INSTALLED state until technical config is applied to all services\n if (state['collector']['state'] == COLLECTOR_STATE_INSTALLED\n and SERVICE_STATE_INSTALLED in service_states):\n return COLLECTOR_STATE_INSTALLED\n\n # CONFIGURED\n if SERVICE_STATE_FAILURE not in service_states:\n return COLLECTOR_STATE_CONFIGURED\n\n # collect service states by type\n service_state_by_type = {}\n for _, service_data in sorted(state['service'].items()):\n service_state_by_type[service_data['service-type']] = (\n service_state_by_type.get(service_data['service-type'], []))\n service_state_by_type[service_data['service-type']].append(\n service_data['state'])\n\n # FAILURE\n for service_type, service_params in SERVICE_TYPE_PARAMS.items():\n if not service_params['main_service']:\n continue\n if (service_type in service_state_by_type\n and SERVICE_STATE_CONFIGURED not in\n service_state_by_type[service_type]):\n return COLLECTOR_STATE_FAILURE\n\n # PARTIAL FAILURE\n return COLLECTOR_STATE_PARTIAL_FAILURE\n\n\ndef generate_voter_list_state(state):\n \"\"\"Generate voter list block for collector state data.\"\"\"\n state[\"list\"].update(\n {\n \"voters-list-total\": 0,\n \"voters-list-available\": 0,\n \"voters-list-pending\": 0,\n \"voters-list-applied\": 0,\n \"voters-list-invalid\": 0,\n \"voters-list-skipped\": 0,\n }\n )\n for changeset_no in range(10_000):\n key = f\"voters{changeset_no:04d}-state\"\n if key not in state['list']:\n break\n list_state = state[\"list\"][key].lower()\n state[\"list\"][f\"voters-list-{list_state}\"] += 1\n state[\"list\"][\"voters-list-total\"] += 1\n\n # compare with VIS changeset data\n vis_changesets_filepath = f\"{CONFIG.get('vis_path')}/voters-changesets.json\"\n if state[\"list\"][\"voters-list-total\"] and os.path.exists(vis_changesets_filepath):\n with open(vis_changesets_filepath) as fd:\n changesets = json.load(fd)\n\n for changeset_no, changeset in enumerate(changesets[\"changesets\"]):\n key = f\"voters{changeset_no:04d}\"\n if key not in state[\"list\"]:\n state[\"list\"][\"voters-list-available\"] += 1\n state[\"list\"].update(\n {key: \"[version not registered]\", f\"{key}-state\": \"AVAILABLE\"}\n )\n\n\ndef generate_election_state(state):\n \"\"\"Generate election block for collector state data.\"\"\"\n state['election']['phase'] = None\n state['election']['phase-start'] = None\n state['election']['phase-end'] = None\n\n if not state['election']:\n return\n\n def get_ts(name):\n \"\"\"\n Get timestamp value as datetime.datetime object\n or None if value is not set.\n \"\"\"\n value = state['election'][name]\n return dateutil.parser.parse(value) if value else None\n\n electionstart = get_ts('electionstart')\n electionstop = get_ts('electionstop')\n servicestart = get_ts('servicestart')\n servicestop = get_ts('servicestop')\n verificationstop = get_ts('verificationstop')\n ts_format = '%Y-%m-%dT%H:%M %Z'\n\n phases = [\n [not electionstart, 'PREPARING', None, None],\n [\n servicestart\n and datetime.datetime.now(servicestart.tzinfo) < servicestart,\n 'WAITING FOR SERVICE START', None, servicestart\n ],\n [\n electionstart\n and datetime.datetime.now(electionstart.tzinfo) < electionstart,\n 'WAITING FOR ELECTION START', servicestart, electionstart\n ],\n [\n electionstop\n and datetime.datetime.now(electionstop.tzinfo) < electionstop,\n 'ELECTION', electionstart, electionstop\n ],\n [\n servicestop\n and datetime.datetime.now(servicestop.tzinfo) < servicestop,\n 'WAITING FOR SERVICE STOP', electionstop, servicestop\n ],\n [\n verificationstop\n and datetime.datetime.now(verificationstop.tzinfo) < verificationstop,\n 'WAITING FOR VERIFICATION SERVICE STOP', servicestop, verificationstop\n ],\n [True, 'FINISHED', verificationstop, None],\n ]\n for phase_active, name, start_time, stop_time in phases:\n if phase_active:\n state['election']['phase'] = name\n state['election']['phase-start'] = (\n start_time.strftime(ts_format) if start_time else '-')\n state['election']['phase-end'] = (\n stop_time.strftime(ts_format) if stop_time else '-')\n break\n" }, { "path": "collector-admin/ivxv_admin/command_file.py", "content": "# IVXV Internet voting framework\n\"\"\"\nCommand file loading module collector management service.\n\"\"\"\n\nimport datetime\nimport json\nimport logging\nimport os\nimport re\nimport subprocess\nimport tempfile\nimport zipfile\n\nimport schematics.exceptions\nimport yaml\n\nfrom . import (CFG_TYPES, CMD_DESCR, CMD_TYPES, PERMISSION_ELECTION_CONF,\n PERMISSION_TECH_CONF, PERMISSION_USERS_ADMIN,\n RFC3339_DATE_FORMAT_WO_FRACT, USER_ROLES, VOTING_LIST_TYPES)\nfrom .config import CONFIG\nfrom .config_validator.validator_util import validate_cfg\nfrom .db import IVXVManagerDb\nfrom .lib import IvxvError\n\n# create logger\nlog = logging.getLogger(__name__)\n\n\ndef load_collector_cmd_file(cmd_type, filename, plain=False):\n \"\"\"Load and validate collector command file.\n\n :param plain: Load plain file or BDOC container.\n :type plain: bool\n :return: Config as data structure or None on error\n :rtype: dict\n \"\"\"\n assert cmd_type in CMD_TYPES, f\"Invalid command type {cmd_type!r}\"\n\n file_descr = CMD_DESCR[cmd_type]\n if plain:\n cmd_filename = filename\n filename = None\n elif cmd_type in CFG_TYPES:\n cmd_filename = re.compile(rf\"(.+\\.)?{cmd_type}.yaml$\")\n elif cmd_type in VOTING_LIST_TYPES:\n cmd_filename = None\n else:\n assert cmd_type == 'user'\n cmd_filename = 'user.json'\n\n # load content from file\n cfg = None\n try:\n cfg = load_cfg_file_content(cmd_type, cmd_filename, filename)\n except (IvxvError, OSError) as err:\n log.error('Error while loading config file: %s', err)\n except UnicodeDecodeError as err:\n log.error('Error while decoding config file: %s', err)\n except json.decoder.JSONDecodeError as err:\n log.error('JSON error in config file: %s', err)\n if cfg is None:\n return None\n\n # validate config file\n log.info('Validating %s', file_descr)\n try:\n cfg = validate_cfg(cfg, cmd_type)\n except ValueError as err:\n log.error(err)\n return None\n except schematics.exceptions.DataError as data_error:\n log_cfg_validation_errors(data_error.errors)\n return None\n\n # validate election ID in config\n if cmd_type not in ['technical', 'trust', 'user']:\n with IVXVManagerDb() as db:\n election_id = db.get_value('election/election-id')\n if election_id:\n if cmd_type == 'election':\n cfg_election_id = cfg.get('identifier')\n elif cmd_type in ['choices', 'districts', 'voters']:\n cfg_election_id = cfg.get('election')\n else:\n raise NotImplementedError(f\"Unknown config type {cmd_type}\")\n if election_id != cfg_election_id:\n log.error(\n \"Election ID %r in config file does not match \"\n \"with current election ID %r\",\n cfg_election_id, election_id)\n return None\n\n if plain:\n log.info('%s is valid', file_descr.capitalize())\n else:\n log.info('Files in %s package are valid', file_descr)\n\n return cfg\n\n\ndef load_cfg_file_content(cmd_type, cfg_filename, cmd_filename):\n \"\"\"Load config file content from command file container.\n\n :param cfg_filename: Config file name\n :type cfg_filename: str or regexp pattern\n :param cmd_filename: Container file name.\n Plain config file is used if None.\n :type cmd_filename: str\n :return: Config as data structure; string for voter list; or None on error\n :rtype: dict\n\n :raises UnicodeDecodeError: if config file is not in UTF-8\n :raises OSError: if some file operation fails\n :raises json.decoder.JSONDecodeError: if JSON decoding fails\n :raises IvxvError: if some internal check fails\n \"\"\"\n file_descr = CMD_DESCR[cmd_type]\n\n # load plain config file\n if cmd_filename is None:\n return load_plain_cfg_file(\n cmd_type, os.path.dirname(cfg_filename),\n os.path.basename(cfg_filename))\n\n # load BDOC command file\n log.info('Loading command file %r (%s)', cmd_filename, file_descr)\n try:\n cmd_file = zipfile.ZipFile(cmd_filename)\n except FileNotFoundError:\n raise IvxvError(f\"File {cmd_filename!r} not found\")\n except zipfile.BadZipFile:\n raise IvxvError(f\"File {cmd_filename!r} is not a valid ZIP container\")\n log.debug('Command file loaded')\n log.debug(\"Files in command file container: %r\", cmd_file.namelist())\n\n # parse contents of command file\n filenames_in_bdoc = cmd_file.namelist()\n for filename in filenames_in_bdoc[:]:\n if filename in [\n 'META-INF/manifest.xml', 'META-INF/signatures0.xml',\n 'mimetype'\n ]:\n filenames_in_bdoc.remove(filename)\n if cfg_filename is None:\n cfg_filename = get_command_filename(cmd_type, filenames_in_bdoc)\n if cfg_filename is None:\n raise IvxvError(\"No command filename detected\")\n log.debug(\"Detected command filename %r\", cfg_filename)\n\n if isinstance(cfg_filename, str) and cfg_filename not in filenames_in_bdoc:\n raise IvxvError(\n f'Command file does not contain expected file {cfg_filename} '\n f'for {file_descr}')\n if isinstance(cfg_filename, type(re.compile(''))):\n for filename in filenames_in_bdoc:\n if cfg_filename.match(filename):\n cfg_filename = filename\n break\n else:\n raise IvxvError(\n f'Command file does not contain expected '\n f'file {cfg_filename.pattern} for {file_descr}')\n\n # create temporary directory to extract container\n with tempfile.TemporaryDirectory() as dirpath:\n log.debug(\"Extracting command file to directory %r\", dirpath)\n cmd_file.extractall(dirpath)\n log.debug('Command file successfully extracted')\n cfg = load_plain_cfg_file(cmd_type, dirpath, cfg_filename)\n\n return cfg\n\n\ndef ck_json_dict_key_uniqueness(args):\n \"\"\"Json loader hook to check dict key uniqueness.\n\n Add strictness for json loader to detect JSON that violates dict key\n uniqueness.\n \"\"\"\n keys = [_[0] for _ in args]\n for key in keys:\n if keys.count(key) > 1:\n raise IvxvError(f\"Duplicate key {key!r} in JSON object\")\n return dict(args)\n\n\ndef load_plain_cfg_file(cmd_type, dirpath, filename):\n \"\"\"Load content from plain config file.\"\"\"\n log.debug(\"Reading file %r\", os.path.join(dirpath, filename))\n cwd = os.getcwd()\n if dirpath:\n os.chdir(dirpath)\n try:\n with open(filename, 'rb') as fp:\n # possible UnicodeDecodeError must be handled by caller\n file_content = fp.read().decode('utf-8')\n if cmd_type in CFG_TYPES:\n cfg = load_yaml_file(file_content)\n elif cmd_type in ('choices', 'districts', 'user'):\n cfg = json.loads(\n file_content, object_pairs_hook=ck_json_dict_key_uniqueness)\n else:\n assert cmd_type == 'voters'\n if filename.endswith(\".skip.yaml\"):\n cfg = load_yaml_file(file_content)\n else:\n cfg = file_content\n finally:\n if dirpath:\n os.chdir(cwd)\n\n return cfg\n\n\ndef get_command_filename(cmd_type, filenames_in_bdoc):\n \"\"\"Get command file name from list of filenames.\n\n Get command file for choice list, district list,\n voter list or voter list changeset skip command.\n\n :return: Command filename or None on error\n :rtype: str\n \"\"\"\n filename = None\n\n if cmd_type in ('choices', 'districts'):\n if len(filenames_in_bdoc) > 1:\n log.error(\n \"Too many files in %s file: %r\",\n CMD_DESCR[cmd_type], filenames_in_bdoc)\n elif not filenames_in_bdoc:\n log.error('Missing %s list in %s file',\n cmd_type, CMD_DESCR[cmd_type])\n else:\n filename = filenames_in_bdoc[0]\n\n elif cmd_type == 'voters':\n if len(filenames_in_bdoc) > 2:\n log.error(\"Too many files in %s file: %r\",\n CMD_DESCR[cmd_type], filenames_in_bdoc)\n elif (\n len(filenames_in_bdoc) == 1 and filenames_in_bdoc[0].endswith(\".skip.yaml\")\n ):\n filename = filenames_in_bdoc[0]\n elif len(filenames_in_bdoc) < 2:\n log.error('Missing voters list or signature in %s file',\n CMD_DESCR[cmd_type])\n else:\n sig_filename, utf_filename = sorted(filenames_in_bdoc)\n if (utf_filename.endswith('.utf')\n and sig_filename == utf_filename[:-4] + '.sig'):\n filename = utf_filename\n else:\n log.error('Voters list and signature file names do not '\n 'match (filenames: %s)',\n ', '.join([utf_filename, sig_filename]))\n log.error('List file must have \".utf\" extension and '\n 'signature file the same base with \".sig\" extension')\n else:\n raise NotImplementedError\n\n return filename\n\n\ndef check_cmd_signature(cmd_type, filename):\n \"\"\"\n Check collector command file signature.\n\n :return: Two lists, first one contains signatures by authorized users,\n second one contains all signatures.\n :rtype: tuple\n\n :raises OSError:\n if reading command file fails or\n if :command:`ivxv-verify-container` command not found\n :raises subprocess.SubprocessError:\n on :command:`ivxv-verify-container` error\n :raises LookupError: on invalid signature line\n :raises IvxvError: on trust root config validation error\n \"\"\"\n log.debug(\"Checking command file %r (%s) signature\", filename, cmd_type)\n\n # detect trust root file\n trust_container_filepath = (\n filename if cmd_type == 'trust'\n else os.path.join(CONFIG['active_config_files_path'], 'trust.bdoc'))\n\n # execute verifier command\n proc = exec_container_verifier(trust_container_filepath, filename)\n\n # parse command output and create signatures list\n all_signatures = []\n for line in proc.stdout.strip().split('\\n'):\n if not re.match(r'.+,.+,[0-9]{11} ', line):\n raise LookupError(f\"Invalid signature line: {line}\")\n signer, timestamp_str = line.split(' ')\n timestamp = datetime.datetime.strptime(\n timestamp_str, RFC3339_DATE_FORMAT_WO_FRACT).timestamp()\n all_signatures.append([timestamp, signer, line])\n all_signatures.sort()\n\n # check signers authorization for trust root config\n if cmd_type == 'trust':\n log.debug('Check signers authorization against trust root config')\n cfg = load_collector_cmd_file(cmd_type, filename)\n if cfg is None:\n raise IvxvError('Trust root file is not valid')\n trusted_signers = cfg.get('authorizations', [])\n authorized_signatures = [\n [signature, 'admin']\n for timestamp, signer, signature in all_signatures\n if signer in trusted_signers]\n return authorized_signatures, all_signatures\n\n # detect permission for command type\n if cmd_type == 'technical':\n permission = PERMISSION_TECH_CONF\n elif cmd_type in CFG_TYPES or cmd_type in VOTING_LIST_TYPES:\n permission = PERMISSION_ELECTION_CONF\n else:\n assert cmd_type == 'user'\n permission = PERMISSION_USERS_ADMIN\n\n # check signers authorization for other config files\n log.debug(\n 'Check signers authorization against collector management database')\n authorized_signatures = []\n with IVXVManagerDb() as db:\n for timestamp, signer, signature in all_signatures:\n try:\n roles = db.get_value(f'user/{signer}')\n except KeyError:\n log.debug('No database record for signer %s', signer)\n continue\n authorized_signatures += [\n [signature, role] for role in roles.split(',')\n if permission in USER_ROLES[role]['permissions']\n ]\n\n return authorized_signatures, all_signatures\n\n\ndef exec_container_verifier(trust_container_filepath, filepath):\n \"\"\"Execute container verifier command.\"\"\"\n cmd = [\n 'ivxv-verify-container', '-trust', trust_container_filepath, filepath\n ]\n log.debug(\"Executing command %r\", \" \".join(cmd))\n try:\n proc = subprocess.run(\n cmd,\n stdout=subprocess.PIPE,\n stderr=subprocess.PIPE,\n check=False,\n universal_newlines=True,\n )\n except OSError as err:\n err.strerror = (\n f\"Error while executing verifier command {' '.join(cmd)!r}: {err.strerror}\"\n )\n raise err\n\n if proc.returncode == 0:\n return proc\n\n verifier_errors = {\n 64: 'Command was used incorrectly',\n 65: 'Failed to open container',\n 66: 'Input file did not exist or was not readable',\n 74: 'Failed read trust root',\n }\n err_msg = verifier_errors.get(proc.returncode, 'Unhandled error')\n print('Container verifier output:')\n print(proc.stdout)\n print(proc.stderr)\n raise subprocess.SubprocessError(\n f'Failed to execute container verifier: {err_msg}')\n\n\ndef log_cfg_validation_errors(items, prefix=\"/\"):\n \"\"\"Log validation errors.\"\"\"\n for field_name, val in items.items():\n if isinstance(val, dict):\n log_cfg_validation_errors(val, f\"{prefix}{field_name}/\")\n else:\n log.error(\"Validation error for field %r: %s\", prefix + field_name, val)\n\n\ndef load_yaml_file(fp):\n \"\"\"Load YAML file.\n\n :return: Content of loaded file\n :rtype: dict\n\n :raises OSError: if some file operation fails\n \"\"\"\n\n def container_constructor_handler(loader, node):\n \"\"\"Handler for !container constructor.\"\"\"\n filename = loader.construct_scalar(node)\n if os.path.dirname(filename):\n raise OSError(\n f\"Referenced file {filename!r} must be in the same \"\n \"directory with YAML file.\"\n )\n with open(filename) as fp:\n content = (yaml.load(fp, yaml.Loader) if filename[-5:] == '.yaml'\n else fp.read(-1))\n return content\n\n def timestamp_constructor(loader, node):\n \"\"\"\n Handler for timestamp fields.\n\n Returns string field instead of datetime.\n \"\"\"\n assert loader # unused variable\n return node.value\n\n yaml.add_constructor('tag:yaml.org,2002:timestamp', timestamp_constructor)\n yaml.add_constructor('!container', container_constructor_handler)\n\n return yaml.load(fp, yaml.Loader)\n" }, { "path": "collector-admin/ivxv_admin/config.py", "content": "# IVXV Internet voting framework\n\"\"\"\nConfig file loader for collectors management service.\n\"\"\"\n\nimport configparser\nimport logging\nimport logging.config\nimport os\nimport sys\n\n#: Config file name.\nCFG_FILE_NAME = 'ivxv-collector-admin.conf'\n#: Default values for config.\nCFG_DEFAULTS = {\n # base directory for management service data files\n 'ivxv_admin_data_path': os.environ.get('IVXV_ADMIN_DATA_PATH',\n '/var/lib/ivxv'),\n # directory for admin UI static data files (used directly by web UI)\n 'admin_ui_data_path': '%(ivxv_admin_data_path)s/admin-ui-data',\n # directory for admin UI permissions\n 'permissions_path': '%(ivxv_admin_data_path)s/admin-ui-permissions',\n # directory for applied command files\n 'command_files_path': '%(ivxv_admin_data_path)s/commands',\n # directory for collector config files\n 'active_config_files_path': '/etc/ivxv',\n # directory for uploaded files\n 'file_upload_path': '%(ivxv_admin_data_path)s/upload',\n # directory for exported votes\n 'exported_votes_path': '%(ivxv_admin_data_path)s/ballot-box',\n # directory for ivxv debian packages\n 'deb_pkg_path': '/etc/ivxv/debs',\n # management database directory\n 'ivxv_db_path': '%(ivxv_admin_data_path)s/db',\n # management database file path\n 'ivxv_db_file_path': '%(ivxv_db_path)s/ivxv-management.db',\n # directory for other service related data files\n \"service_path\": \"%(ivxv_admin_data_path)s/service\",\n # directory for VIS related data files (used to download voter list\n # changesets)\n \"vis_path\": \"%(ivxv_admin_data_path)s/vis\",\n}\nCFG_PARSER = configparser.ConfigParser(defaults=CFG_DEFAULTS)\nCFG_FILES_USED = []\n#: Config file paths.\nCFG_PATHS = [\n os.path.join(os.curdir, CFG_FILE_NAME),\n os.path.join('/etc/ivxv', CFG_FILE_NAME)\n]\nif os.environ.get('IVXV_ADMIN_CONF'):\n CFG_PATHS += [\n os.environ.get('IVXV_ADMIN_CONF'),\n os.path.join(os.environ.get('IVXV_ADMIN_CONF'), CFG_FILE_NAME)\n ]\n\nfor FILE_PATH in CFG_PATHS:\n if os.path.isfile(FILE_PATH):\n CFG_FILES_USED.append(FILE_PATH)\n logging.config.fileConfig(FILE_PATH)\n CFG_PARSER.read(FILE_PATH)\n\n# check config files read\nif not CFG_FILES_USED:\n log = logging.getLogger(__name__)\n log.error(\n \"IVXV collector admin utils config file %r not found in the search paths %s\",\n CFG_FILE_NAME,\n CFG_PATHS,\n )\n\nCONFIG = CFG_PARSER['DEFAULT']\n\n\ndef cfg_path(cfg_path_name, filename):\n \"\"\"Generate full path for specified file.\"\"\"\n return os.path.join(CONFIG[cfg_path_name], filename)\n\n\nif __name__ == '__main__':\n log = logging.getLogger(__name__)\n log.info('Loading config file(s) %s succeeded',\n ', '.join((CFG_FILES_USED)))\n sys.exit()\n" }, { "path": "collector-admin/ivxv_admin/config_validator/__init__.py", "content": "# IVXV Internet voting framework\n\"\"\"\nValidator for collector config files and voting lists.\n\"\"\"\n" }, { "path": "collector-admin/ivxv_admin/config_validator/choices_list.py", "content": "# IVXV Internet voting framework\n\"\"\"\nChoices list validator.\n\"\"\"\n\nfrom schematics.exceptions import DataError\nfrom schematics.models import Model\nfrom schematics.types import DictType, StringType\n\nfrom .fields import ElectionIdType\n\n\nclass ChoicesListSchema(Model):\n \"\"\"Validating schema for choices list.\"\"\"\n election = ElectionIdType(required=True)\n choices = DictType(DictType(DictType(StringType)))\n\n def validate(self, partial=False, convert=True, app_data=None, **kwargs):\n \"\"\"Validate model.\"\"\"\n super().validate(partial, convert, app_data, **kwargs)\n\n choices = []\n for district_choices in self.choices.values():\n for choice in district_choices.values():\n for choice_id in choice.keys():\n if choice_id in choices:\n raise DataError(\n {'choices': f'Duplicate choice ID: {choice_id}'})\n choices.append(choice_id)\n" }, { "path": "collector-admin/ivxv_admin/config_validator/districts_list.py", "content": "# IVXV Internet voting framework\n\"\"\"\nDistricts list validator.\n\"\"\"\n\nfrom schematics.models import Model\nfrom schematics.types import DictType, ListType, ModelType, StringType\n\nfrom .fields import ElectionIdType\n\n\nclass DistrictsListSchema(Model):\n \"\"\"Validating schema for districts list.\"\"\"\n\n class DistrictSchema(Model):\n \"\"\"Validating schema for district record config.\"\"\"\n name = StringType(required=True)\n parish = ListType(StringType, required=True)\n\n class RegionSchema(Model):\n \"\"\"Validating schema for region record config.\"\"\"\n state = StringType()\n county = StringType()\n parish = StringType()\n\n election = ElectionIdType(required=True)\n districts = DictType(ModelType(DistrictSchema))\n regions = DictType(ModelType(RegionSchema))\n counties = DictType(ListType(StringType))\n" }, { "path": "collector-admin/ivxv_admin/config_validator/election_conf.py", "content": "# IVXV Internet voting framework\n\"\"\"\nElection config validator.\n\"\"\"\n\n# pylint: disable=no-self-use\n\nfrom schematics.exceptions import ValidationError\nfrom schematics.models import Model\nfrom schematics.types import (\n BooleanType,\n DateTimeType,\n IntType,\n ListType,\n ModelType,\n StringType,\n URLType,\n DictType,\n)\n\nfrom .fields import CertificateType, ElectionIdType, PublicKeyType\nfrom .schemas import ContainerSchema, OCSPSchema, TSPSchema, protocol_cfg\n\n\nclass ElectionConfigSchema(Model):\n \"\"\"Validating schema for election config.\"\"\"\n identifier = ElectionIdType(required=True)\n questions = ListType(ElectionIdType, min_size=1, required=True)\n\n class ElectionVerificationSchema(Model):\n \"\"\"Validating schema for election verification config.\"\"\"\n count = IntType(required=True, min_value=0)\n minutes = IntType(required=True, min_value=0)\n latestonly = BooleanType(default=False)\n\n verification = ModelType(ElectionVerificationSchema, required=True)\n\n class ElectionVotingSchema(Model):\n \"\"\"Validating schema for election voting config.\"\"\"\n ratelimitstart = IntType(default=0, min_value=0)\n ratelimitminutes = IntType(default=0, min_value=0)\n\n def validate_ratelimitminutes(self, data, value):\n \"\"\"Validate rate limit.\"\"\"\n try:\n if (data['ratelimitstart'] > 0\n and data['ratelimitminutes'] == 0):\n raise ValidationError(\n 'ratelimitstart set, but rate limiting disabled')\n except KeyError:\n pass # error in data structure is catched later\n return value\n\n voting = ModelType(ElectionVotingSchema)\n\n class ElectionPeriodSchema(Model):\n \"\"\"Validating schema for election period config.\"\"\"\n servicestart = DateTimeType(required=True)\n electionstart = DateTimeType(required=True)\n electionstop = DateTimeType(required=True)\n servicestop = DateTimeType(required=True)\n verificationstop = DateTimeType(required=True)\n\n period = ModelType(ElectionPeriodSchema, required=True)\n voterforeignehak = StringType(regex=r'^[0-9]{1,10}$')\n ignorevoterlist = StringType()\n\n class VoterListSchema(Model):\n \"\"\"Validating schema for voter list updating service config.\"\"\"\n key = PublicKeyType(required=True)\n\n voterlist = ModelType(VoterListSchema, required=True)\n\n class VisSchema(Model):\n \"\"\"Validating schema for VIS service config.\"\"\"\n\n url = URLType(required=True)\n ca = ListType(CertificateType)\n min = IntType(default=15)\n\n vis = ModelType(VisSchema, required=True)\n\n class XroadSchema(Model):\n \"\"\"Validating schema for VIS service config.\"\"\"\n\n ca = CertificateType(required=True)\n\n xroad = ModelType(XroadSchema, required=True)\n\n class BallotSchema(Model):\n \"\"\"Validating schema for voter ballot.\"\"\"\n encpkeygroup = StringType(required=True) # See available types in docs\n # PublicKeyType (OpenSSL library under the hood) no support for ElGamal\n encpkey = StringType(required=False)\n\n ballot = ModelType(BallotSchema, required=True)\n\n class AuthSchema(Model):\n \"\"\"Validating schema for voter authentication config.\"\"\"\n\n # FIXME: If service.mid exists, auth.ticket field must exist\n class TicketAuthSchema(Model):\n \"\"\"Validating schema for ticket authentication config.\"\"\"\n\n ticket = ModelType(TicketAuthSchema)\n\n class TLSAuthSchema(Model):\n \"\"\"Validating schema for TLS authentication config.\"\"\"\n roots = ListType(CertificateType, required=True)\n intermediates = ListType(CertificateType)\n ocsp = ModelType(OCSPSchema)\n\n tls = ModelType(TLSAuthSchema)\n\n auth = ModelType(AuthSchema, required=True)\n\n identity = StringType(\n required=True, choices=['commonname', 'serialnumber', 'pnoee'])\n\n class AgeSchema(Model):\n \"\"\"Validating schema for voters age check config.\"\"\"\n method = StringType(required=True, choices=['estpic'])\n timezone = StringType(required=True)\n limit = IntType(required=True, min_value=14)\n\n age = ModelType(AgeSchema)\n\n vote = ModelType(ContainerSchema, required=True)\n\n class MIDSchema(Model):\n \"\"\"Validating schema for Mobile ID config.\"\"\"\n url = URLType(required=True)\n relyingpartyuuid = StringType(required=True)\n relyingpartyname = StringType(required=True)\n language = StringType(\n required=True, choices=['EST', 'ENG', 'RUS', 'LIT'])\n authmessage = StringType(required=True, max_length=40)\n signmessage = StringType(required=True, max_length=40)\n messageformat = StringType(default='GSM-7', choices=['GSM-7', 'UCS-2'])\n authchallengesize = IntType(default=32, choices=[32, 48, 64])\n statustimeoutms = IntType()\n roots = ListType(CertificateType, required=True)\n intermediates = ListType(CertificateType)\n ocsp = ModelType(OCSPSchema)\n\n # pylint: disable=no-self-use\n def validate_phonerequired(self, data, value):\n \"\"\"Validate phone/idcode required field.\"\"\"\n try:\n if not data['idcoderequired'] and not data['phonerequired']:\n raise ValidationError('Either idcoderequired or '\n 'phonerequired must be true')\n except KeyError:\n pass # error in data structure is catched later\n return value\n\n mid = ModelType(MIDSchema)\n\n class SmartIDSchema(Model):\n \"\"\"Validating schema for Smart ID config.\"\"\"\n url = URLType(required=True)\n relyingpartyuuid = StringType(required=True)\n relyingpartyname = StringType(required=True)\n certificatelevel = StringType(\n required=True, choices=[\"QUALIFIED\", \"ADVANCED\", \"QSCD\"]\n )\n authinteractionsorder = ListType(DictType(StringType), required=True)\n signinteractionsorder = ListType(DictType(StringType), required=True)\n authchallengesize = IntType()\n statustimeoutms = IntType()\n roots = ListType(CertificateType, required=True)\n intermediates = ListType(CertificateType)\n ocsp = ModelType(OCSPSchema)\n\n smartid = ModelType(SmartIDSchema)\n\n qualification = ListType(\n protocol_cfg({\n \"ocsp\": OCSPSchema,\n \"ocsptm\": OCSPSchema,\n \"tsp\": TSPSchema,\n \"tspreg\": TSPSchema,\n }))\n\n class StatsSchema(Model):\n \"\"\"Validating schema for stats config.\"\"\"\n class DetailStatsSchema(Model):\n class SchedulerSchema(Model):\n class CronSchema(Model):\n min = StringType(required=False)\n hour = StringType(required=False)\n day = StringType(required=False)\n month = StringType(required=False)\n weekday = StringType(required=False)\n\n cron = ModelType(CronSchema, required=False, default={})\n scheduler = ModelType(SchedulerSchema, required=False, default={})\n detail = ModelType(DetailStatsSchema, required=False, default={})\n\n class VotingFactsSchema(Model):\n class SchedulerSchema(Model):\n class CronSchema(Model):\n min = StringType(required=False)\n hour = StringType(required=False)\n day = StringType(required=False)\n month = StringType(required=False)\n weekday = StringType(required=False)\n\n cron = ModelType(CronSchema, required=False, default={})\n scheduler = ModelType(SchedulerSchema, required=False, default={})\n voting_facts = ModelType(VotingFactsSchema, required=False, default={})\n stats = ModelType(StatsSchema, required=False, default={})\n\n # pylint: disable=unused-argument\n def validate_questions(self, data, value):\n \"\"\"Validate question field.\"\"\"\n if value and len(value) > len(set(value)):\n raise ValidationError('Election questions must be unique')\n return value\n\n def validate_period(self, data, value):\n \"\"\"Validate election period.\"\"\"\n try:\n if data['period']['servicestart'] >= data['period']['electionstart']:\n raise ValidationError(\"servicestart is >= than electionstart\")\n if data['period']['electionstart'] >= data['period']['electionstop']:\n raise ValidationError(\"electionstart is >= than electionstop\")\n if data['period']['electionstop'] > data['period']['servicestop']:\n raise ValidationError(\"electionstop is > than servicestop\")\n if data['period']['servicestop'] > data['period']['verificationstop']:\n raise ValidationError(\"servicestop is > than verificationstop\")\n except KeyError:\n pass # error in data structure is catched later\n return value\n" }, { "path": "collector-admin/ivxv_admin/config_validator/fields.py", "content": "# IVXV Internet voting framework\n\"\"\"\nCommon field validator classes.\n\"\"\"\n\n# pylint: disable=too-few-public-methods\n\nimport string\n\nimport OpenSSL\nfrom schematics.exceptions import ValidationError\nfrom schematics.types import StringType\n\n\nclass ElectionIdType(StringType):\n \"\"\"Election ID field validator.\"\"\"\n\n def validate(self, value, context=None):\n \"\"\"Validate field.\"\"\"\n min_length = 1\n max_length = 28\n\n if len(value) < min_length or len(value) > max_length:\n raise ValidationError(\n f\"Election ID length must be between {min_length} and {max_length}\"\n )\n if any(ws in value for ws in list(string.whitespace)):\n raise ValidationError('Election ID contains whitespace')\n\n return super().validate(value, context)\n\n\nclass CertificateType(StringType):\n \"\"\"A field that validates input as a PEM-encoded certificate.\"\"\"\n\n def validate(self, value, context=None):\n \"\"\"Validate field.\"\"\"\n try:\n OpenSSL.crypto.load_certificate(OpenSSL.crypto.FILETYPE_PEM, value)\n except OpenSSL.crypto.Error as err:\n err_lib, err_func, err_reason = err.args[0][0]\n raise ValidationError(\n f\"Error in {err_lib} library {err_func} function: {err_reason}\"\n )\n\n return super().validate(value, context)\n\n\nclass PublicKeyType(StringType):\n \"\"\"A field that validates input as a PEM-encoded public key.\"\"\"\n\n def validate(self, value, context=None):\n \"\"\"Validate field.\"\"\"\n try:\n OpenSSL.crypto.load_publickey(OpenSSL.crypto.FILETYPE_PEM, value)\n except OpenSSL.crypto.Error as err:\n err_lib, err_func, err_reason = err.args[0][0]\n raise ValidationError(\n f\"Error in {err_lib} library {err_func} function: {err_reason}\"\n )\n\n return super().validate(value, context)\n" }, { "path": "collector-admin/ivxv_admin/config_validator/schemas.py", "content": "# IVXV Internet voting framework\n\"\"\"\nCommon schema validator classes.\n\"\"\"\n\nfrom schematics.exceptions import ValidationError\nfrom schematics.models import Model\nfrom schematics.types import (IntType, ListType, ModelType, PolyModelType,\n StringType, URLType)\n\nfrom .fields import CertificateType\n\n\n# FIXME: constrainments on schemas passed to wrapper aren't enforced.\n# fields can be missing from the conf, type constrainments are ignored,\n# without raising any errors (e.g missing storage.conf.ca,\n# invalid URL in qualification.*.url)\ndef protocol_cfg(mapping, **kwargs):\n \"\"\"\n Return an alternative protocol configuration type.\n\n Alternative protocol configurations allow only one from a selection of\n alternatives to be used. The model looks like this::\n\n protocol: \n conf: \n\n schematics has PolyModelType which allows \"conf\" to be different models,\n but it must select the model to use based solely on the contents of \"conf\",\n which cannot be done with this construction. So create a new wrapper model\n for each protocol configuration model which also includes the \"protocol\"\n field and let PolyModelType choose from those.\n \"\"\"\n\n models = []\n for protocol, model in mapping.items():\n wrapper = type(\n f\"{model.__name__}Wrapper\", (Model, ), {\n \"protocol\": StringType(required=True, choices=[protocol]),\n \"conf\": ModelType(model, required=True),\n \"ordertimeout\": IntType(required=False, min_value=1)\n })\n mapping[protocol] = wrapper\n models.append(wrapper)\n\n def _claim(_, data):\n return mapping.get(data.get(\"protocol\"))\n\n return PolyModelType(models, claim_function=_claim, **kwargs)\n\n\nclass DummySchema(Model):\n \"\"\"Validating schema for Dummy container config.\"\"\"\n trusted = ListType(StringType)\n\n\nclass OCSPSchema(Model):\n \"\"\"Validating schema for OCSP config.\"\"\"\n url = URLType(required=True)\n responders = ListType(CertificateType)\n retry = IntType(default=0, min_value=0)\n maxSkew = IntType(default=300, min_value=0) # 300 milliseconds\n maxAge = IntType(default=1, min_value=0) # 1 minute\n maxAge = IntType(default=1, min_value=0) # 1 minute\n\n\nclass OCSPSchemaNoURL(Model):\n \"\"\"Validating schema for OCSP config.\"\"\"\n responders = ListType(CertificateType)\n maxSkew = IntType(default=300, min_value=0) # 300 milliseconds\n maxAge = IntType(default=1, min_value=0) # 1 minute\n\n\nclass TSPSchema(Model):\n \"\"\"Validating schema for timestamp protocol config.\"\"\"\n url = URLType(required=True)\n signers = ListType(CertificateType, required=True)\n delaytime = IntType(required=True, min_value=0)\n retry = IntType(default=0, min_value=0)\n maxSkew = IntType(default=2, min_value=0) # 2 seconds\n maxAge = IntType(default=1, min_value=0) # 1 minute\n\n\nclass TSPSchemaNoURL(Model):\n \"\"\"Validating schema for timestamp protocol config.\"\"\"\n signers = ListType(CertificateType, required=True)\n delaytime = IntType(required=True, min_value=0)\n maxSkew = IntType(default=2, min_value=0) # 2 seconds\n maxAge = IntType(default=1, min_value=0) # 1 minute\n\n\nclass BDocSchema(Model):\n \"\"\"Validating schema for BDoc config.\"\"\"\n filecount = IntType(required=True, min_value=1)\n bdocsize = IntType(required=True, min_value=1)\n filesize = IntType(required=True, min_value=1)\n roots = ListType(CertificateType, required=True)\n intermediates = ListType(CertificateType)\n profile = StringType(choices=['BES', 'TM', 'TS'], required=True)\n ocsp = ModelType(OCSPSchemaNoURL)\n tsp = ModelType(TSPSchemaNoURL)\n tsdelaytime = IntType(default=0, min_value=0)\n\n def validate_tsp(self, data, value):\n \"\"\"Check that tsp exists if profile is TS.\"\"\"\n try:\n if (data['profile'] == 'TS' and not data['tsp']):\n raise ValidationError('TS profile requires a tsp block')\n except KeyError:\n pass # error in data structure is catched later\n return value\n\n\nclass ContainerSchema(Model):\n \"\"\"Validating schema for signed container config.\"\"\"\n bdoc = ModelType(BDocSchema)\n dummy = ModelType(DummySchema)\n" }, { "path": "collector-admin/ivxv_admin/config_validator/tech_conf.py", "content": "# IVXV Internet voting framework\n\"\"\"\nCollector technical config validator.\n\"\"\"\n\nimport re\n\nfrom schematics.exceptions import ValidationError\nfrom schematics.models import Model\nfrom schematics.types import (BooleanType, IntType, ListType, ModelType,\n StringType)\n\nfrom .fields import CertificateType\nfrom .schemas import protocol_cfg\n\n\nclass ServicesSchema(Model):\n \"\"\"Validating schema for subservices config.\"\"\"\n\n class BackupServiceSchema(Model):\n \"\"\"Validating schema for backup subservice config.\"\"\"\n id = StringType(regex=r'.+@.+', required=True)\n address = StringType(required=True)\n\n class ServiceSchema(Model):\n \"\"\"Validating schema for subservice config.\"\"\"\n id = StringType(regex=r'.+@.+', required=True)\n address = StringType(regex=r'.+:[0-9]+', required=True)\n peeraddress = StringType(regex=r'.+:[0-9]+')\n origin = StringType(regex=r'.+:[0-9]+')\n\n proxy = ListType(ModelType(ServiceSchema))\n mid = ListType(ModelType(ServiceSchema))\n smartid = ListType(ModelType(ServiceSchema))\n webeid = ListType(ModelType(ServiceSchema))\n votesorder = ListType(ModelType(ServiceSchema))\n voting = ListType(ModelType(ServiceSchema))\n choices = ListType(ModelType(ServiceSchema))\n verification = ListType(ModelType(ServiceSchema))\n sessionstatus = ListType(ModelType(ServiceSchema))\n storage = ListType(ModelType(ServiceSchema))\n log = ListType(ModelType(ServiceSchema))\n backup = ListType(ModelType(BackupServiceSchema), max_size=1)\n\n\nclass CollectorTechnicalConfigSchema(Model):\n \"\"\"Validating schema for collector technical config.\"\"\"\n debug = BooleanType(default=False)\n snidomain = StringType(required=True)\n\n class FilterSchema(Model):\n \"\"\"Validating schema for connection filter config.\"\"\"\n\n class TLSFilterSchema(Model):\n \"\"\"Validating schema for TLS connection filter config.\"\"\"\n handshaketimeout = IntType(required=True, min_value=0)\n ciphersuites = ListType(\n StringType(choices=[\n 'TLS_RSA_WITH_AES_128_CBC_SHA',\n 'TLS_RSA_WITH_AES_256_CBC_SHA',\n 'TLS_RSA_WITH_AES_128_GCM_SHA256',\n 'TLS_RSA_WITH_AES_256_GCM_SHA384',\n 'TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA',\n 'TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA',\n 'TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA',\n 'TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA',\n 'TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256',\n 'TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256',\n 'TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384',\n 'TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384',\n ]),\n required=True)\n\n tls = ModelType(TLSFilterSchema, required=True)\n\n class CodecFilterSchema(Model):\n \"\"\"Validating schema for codec connection filter config.\"\"\"\n rwtimeout = IntType(required=True, min_value=0)\n requestsize = IntType(min_value=0)\n logrequests = BooleanType(default=False)\n\n codec = ModelType(CodecFilterSchema, required=True)\n\n filter = ModelType(FilterSchema, required=True)\n\n class SegmentSchema(Model):\n \"\"\"Validating schema for network segment config.\"\"\"\n id = StringType(required=True)\n services = ModelType(ServicesSchema, required=True)\n\n network = ListType(ModelType(SegmentSchema), required=True)\n\n class LogServerSchema(Model):\n \"\"\"Validating schema for log collecting server config.\"\"\"\n address = StringType(required=True)\n port = IntType(default=20514)\n\n logging = ListType(ModelType(LogServerSchema))\n\n class StatusServerSchema(Model):\n \"\"\"Validating schema for status servers config.\"\"\"\n class SessionServiceSchema(Model):\n name = StringType(required=True)\n servername = StringType(required=True)\n authttl = IntType(required=True)\n choicettl = IntType(required=True)\n votettl = IntType(required=True)\n verifyttl = IntType(required=True)\n session = ModelType(SessionServiceSchema)\n\n status = ModelType(StatusServerSchema, required=True)\n\n class FileStorageServiceSchema(Model):\n \"\"\"Validating schema for file storage service config.\"\"\"\n wd = StringType(required=True)\n\n class EtcdStorageServiceSchema(Model):\n \"\"\"Validating schema for etcd storage service config.\"\"\"\n ca = CertificateType(required=True)\n conntimeout = IntType(required=True, min_value=0)\n optimeout = IntType(required=True, min_value=0)\n # FIXME: Compare to network.#.services.storage.#.id on first load.\n bootstrap = ListType(StringType(regex=r'.+@.+'))\n size = IntType(required=False)\n snapshotcount = IntType(required=False)\n heartbeattimeout = IntType(required=False)\n electiontimeout = IntType(required=False)\n storage = protocol_cfg(\n {\n \"file\": FileStorageServiceSchema,\n \"etcd\": EtcdStorageServiceSchema,\n },\n required=True)\n\n class BackupTimeType(StringType):\n \"\"\"Field validator for backup time.\"\"\"\n\n def validate(self, value, context=None):\n if not re.match(r'[0-9]{2}:[0-9]{2}', value):\n raise ValidationError(f\"Value must be in format HH:MM (not {value!r})\")\n hour, minute = value.split(':')\n if int(hour) >= 24:\n raise ValidationError(f\"Hour must be smaller than 24 (not {value!r})\")\n if int(minute) >= 60:\n raise ValidationError(f\"Minute must be smaller than 60 (not {value!r})\")\n return super().validate(value, context)\n\n backup = ListType(BackupTimeType)\n" }, { "path": "collector-admin/ivxv_admin/config_validator/trust_conf.py", "content": "# IVXV Internet voting framework\n\"\"\"\nCollector trust root config validator.\n\"\"\"\n\nfrom schematics.models import Model\nfrom schematics.types import ListType, ModelType, StringType\n\nfrom .schemas import ContainerSchema\n\n\nclass TrustRootSchema(Model):\n \"\"\"Validating schema for trust root config.\"\"\"\n container = ModelType(ContainerSchema, required=True)\n authorizations = ListType(StringType, required=True)\n" }, { "path": "collector-admin/ivxv_admin/config_validator/user_management.py", "content": "# IVXV Internet voting framework\n\"\"\"\nCollector user management command validator.\n\"\"\"\n\nfrom schematics.exceptions import DataError\nfrom schematics.models import Model\nfrom schematics.types import ListType, StringType\n\nfrom .. import USER_ROLES\n\n\nclass UserManagementCommandSchema(Model):\n \"\"\"Validating schema for user management command.\"\"\"\n action = StringType(required=True, regex='user-permissions')\n cn = StringType(required=True, regex='.+,.+,[0-9]{11}')\n roles = ListType(StringType(), required=True)\n\n def validate(self, partial=False, convert=True, app_data=None, **kwargs):\n \"\"\"Validate model.\"\"\"\n super().validate(partial, convert, app_data, **kwargs)\n\n # role list checks\n if not isinstance(self.roles, list):\n raise DataError({'roles': 'Value is not a list'})\n # pylint: disable=not-an-iterable\n for role in self.roles:\n if role not in USER_ROLES:\n raise DataError({\"roles\": f\"Unknown role {role!r}\"})\n if len(self.roles) != len(set(self.roles)):\n raise DataError({'roles': 'Duplicate roles'})\n # pylint: disable=unsupported-membership-test\n if 'none' in self.roles and len(self.roles) > 1:\n raise DataError({\n 'roles':\n 'Role \"none\" can\\'t be used with other roles'\n })\n" }, { "path": "collector-admin/ivxv_admin/config_validator/validator_util.py", "content": "# IVXV Internet voting framework\n\"\"\"Config validator utility for collector config files and voting lists.\"\"\"\n\nimport json\nimport os\n\nimport jsonschema\nimport pkg_resources\n\nfrom .choices_list import ChoicesListSchema\nfrom .districts_list import DistrictsListSchema\nfrom .election_conf import ElectionConfigSchema\nfrom .tech_conf import CollectorTechnicalConfigSchema\nfrom .trust_conf import TrustRootSchema\nfrom .user_management import UserManagementCommandSchema\nfrom .voters_list import VoterListChangesetSkipSchema, parse_voters_list\n\n\ndef validate_cfg(cfg, schema_name):\n \"\"\"Validate collector config.\n\n :param cfg: Configuration data structure\n :type cfg: dict\n\n :raises ValueError:\n :raises schematics.exceptions.DataError:\n \"\"\"\n # validate choices and districts list with jsonschema\n if schema_name in ['choices', 'districts']:\n jsonschema_src = pkg_resources.resource_string(\n 'ivxv_admin',\n os.path.join('jsonschema', f'ivxv.{schema_name}.schema'))\n schema = json.loads(jsonschema_src.decode('UTF-8'))\n try:\n jsonschema.validate(instance=cfg, schema=schema)\n except jsonschema.exceptions.ValidationError as err:\n raise ValueError(err)\n\n # validate voters list\n if schema_name == \"voters\" and isinstance(cfg, str):\n return parse_voters_list(cfg)\n\n if not isinstance(cfg, dict):\n raise ValueError('Configuration data is not dictionary')\n\n # detect config schema\n schemas = {\n 'trust': TrustRootSchema,\n 'technical': CollectorTechnicalConfigSchema,\n 'election': ElectionConfigSchema,\n 'choices': ChoicesListSchema,\n 'districts': DistrictsListSchema,\n 'user': UserManagementCommandSchema,\n \"voters\": VoterListChangesetSkipSchema,\n }\n validator = schemas[schema_name](cfg.copy())\n validator.validate()\n\n return validator.to_primitive()\n" }, { "path": "collector-admin/ivxv_admin/config_validator/voters_list.py", "content": "# IVXV Internet voting framework\n\"\"\"Voters list validator.\"\"\"\n\nimport re\n\nimport dateutil.parser\nfrom schematics.models import Model\nfrom schematics.types import IntType, StringType\n\nfrom .fields import ElectionIdType\n\nISOPARSER = dateutil.parser.isoparser(\"T\")\n\n\nclass VoterListChangesetSkipSchema(Model):\n \"\"\"Validating schema for voter list changeset skipping command.\"\"\"\n\n election = ElectionIdType(required=True)\n skip_voter_list = StringType(regex=r\"^[^ ]+ [^ ]+$\", required=True)\n changeset = IntType(required=True)\n\n\ndef parse_voters_list(list_content):\n \"\"\"Parse voters list.\n\n :return: Voters list data\n :rtype: dict\n\n :raises ValueError:\n \"\"\"\n lines = list_content.split('\\n')\n if len(lines) < 4:\n raise ValueError(f'Too few lines in voters list ({len(lines)})')\n\n # parse header\n data = dict(version=lines[0].rstrip('\\r'))\n data['election'] = lines[1].rstrip('\\r')\n try:\n data['election'].encode('ASCII')\n except UnicodeEncodeError:\n raise ValueError('Election ID contains non-ASCII characters')\n data['changeset'] = lines[2].rstrip('\\r')\n data['period'] = lines[3].rstrip('\\r')\n timestamps = data['period'].split('\\t')\n if len(timestamps) != 2:\n raise ValueError('Period does not contain two tab-separated fields')\n data['period_from'] = timestamps[0]\n data['period_to'] = timestamps[1].rstrip('\\r')\n\n # validate header\n # version-no = \"2\"\n if data[\"version\"] != \"2\":\n raise ValueError(\n f\"Invalid voters list version {data['version']!r} in line 1. \"\n \"Expected value: 2\"\n )\n ElectionIdType(required=True).validate(data['election'])\n # changeset = integer\n if not data['changeset'].isdigit():\n raise ValueError(\n f\"Unknown voters list changeset {data['changeset']!r} in line 3. \"\n \"Must be an integer\"\n )\n # period_from, period_to = RFC 3339 timestamp\n try:\n # FIXME: Accepts all ISO 8601 timestamps, not only RFC 3339.\n ISOPARSER.isoparse(data['period_from'])\n ISOPARSER.isoparse(data['period_to'])\n except ValueError as err:\n raise ValueError(f'Period contains invalid timestamp: {err.args[0]}')\n\n # parse list\n is_original_list = data['changeset'] == '0'\n data['voters'] = []\n for line_no, line in enumerate(lines[:-1], 1):\n if '\\r' in line:\n raise ValueError(f'Line #{line_no}: Invalid character ')\n if line_no < 5:\n continue\n fields = line.split('\\t')\n try:\n validate_voter_record(fields, is_original_list)\n except ValueError as err:\n raise ValueError(f'Line #{line_no}: {err.args[0]}')\n data['voters'].append(fields)\n\n if lines[-1] != '':\n raise ValueError(f'Line #{len(lines)}: Must end with character')\n\n return data\n\n\ndef validate_voter_record(fields, is_original_list):\n \"\"\"Validate voter record in voters list.\"\"\"\n # field count\n if len(fields) == 5:\n action, voter_personalcode, voter_name, adminunit_code, no_district = fields\n if not voter_name:\n raise ValueError(\"voter-name is empty\")\n if action != \"lisamine\":\n raise ValueError(\n f\"Unknown action {action!r}. Must be 'lisamine' or 'kustutamine'\"\n )\n # voter-personalcode = 11DIGIT\n if not re.match(r\"[0-9]{11}$\", voter_personalcode):\n raise ValueError(f\"Invalid voter-personalcode {voter_personalcode!r}\")\n if len(voter_name) > 100:\n raise ValueError(f\"voter-name lenght {len(voter_name)} exceeds 100 chars\")\n # adminunit-code = 1*4UTF-8-CHAR | \"FOREIGN\"\n if not adminunit_code:\n raise ValueError(\"Missing adminunit-code\")\n if len(adminunit_code) > 4 and adminunit_code != \"FOREIGN\":\n raise ValueError(\n f\"adminunit-code {adminunit_code!r} is longer than 4 chars\")\n # no-district = 1*10DIGIT\n if not re.match(r\"[0-9]{1,10}$\", no_district):\n raise ValueError(f\"Invalid no-district {no_district!r}\")\n\n elif len(fields) == 2:\n action, voter_personalcode = fields\n if action != \"kustutamine\":\n raise ValueError(\n f\"Unknown action {action!r}. Must be 'lisamine' or 'kustutamine'\"\n )\n # voter-personalcode = 11DIGIT\n if not re.match(r\"[0-9]{11}$\", voter_personalcode):\n raise ValueError(f\"Invalid voter-personalcode {voter_personalcode!r}\")\n if is_original_list:\n raise ValueError(f\"Action {action!r} is not allowed in initial list\")\n\n else:\n raise ValueError(f\"Invalid field count {len(fields)}, expected 2 or 5 fields\")\n" }, { "path": "collector-admin/ivxv_admin/db.py", "content": "# IVXV Internet voting framework\n\"\"\"\nDatabase abstraction layer for collector management service.\n\"\"\"\n\nimport datetime\nimport dbm.gnu\nimport logging\nimport os\nimport re\nimport time\n\nimport dateutil.parser\n\nfrom . import (COLLECTOR_STATE_NOT_INSTALLED, COLLECTOR_STATES,\n RFC3339_DATE_FORMAT, SERVICE_STATE_NOT_INSTALLED,\n SERVICE_STATES)\nfrom .config import CONFIG\n\n#: Path to database file\nDB_FILE_PATH = CONFIG['ivxv_db_file_path']\n\n#: Database keys with default values\nDB_KEYS = {\n # collector state\n 'collector/state': COLLECTOR_STATE_NOT_INSTALLED,\n # election config file version in management service\n 'config/election': '',\n # technical config file version in management service\n 'config/technical': '',\n # trust root config file version in management service\n 'config/trust': '',\n # logmonitor address\n 'logmonitor/address': '',\n # logmonitor timestamp of last fetch\n 'logmonitor/last-data': '',\n # choices list file version in management service\n 'list/choices': '',\n # choices list file version in choices service\n 'list/choices-loaded': '',\n # districts list file version in management service\n 'list/districts': '',\n # districts list file version in choices service\n 'list/districts-loaded': '',\n # election ID\n 'election/election-id': '',\n # election start time\n 'election/electionstart': '',\n # election stop time\n 'election/electionstop': '',\n # collector service start time\n 'election/servicestart': '',\n # collector service stop time\n 'election/servicestop': '',\n # verification service stop time\n 'election/verificationstop': '',\n}\n#: Database keys for service hosts with default values\nDB_HOST_SUBKEYS = {\n # host state\n 'state': '',\n}\n#: Database keys for services with default values\nDB_SERVICE_SUBKEYS = {\n # service type\n 'service-type': None,\n # technical config file version in service\n 'technical-conf-version': '',\n # election config file version in service\n 'election-conf-version': '',\n # service network ID\n 'network': None,\n # service state\n 'state': SERVICE_STATE_NOT_INSTALLED,\n # last data by service PING (timestamp)\n 'last-data': '',\n # count of ping errors\n 'ping-errors': '0',\n # service IP address\n 'ip-address': None,\n # registered background information (usually error message)\n 'bg_info': '',\n}\n#: Database keys for certain service types\nDB_SERVICE_CONDITIONAL_SUBKEYS = {\n # mobile ID identity token key file checksum (sha256)\n 'mid-token-key': '',\n # TLS certificate file checksum (sha256)\n 'tls-cert': '',\n # TLS key file checksum (sha256)\n 'tls-key': '',\n # TSP registration key file checksum (sha256)\n 'tspreg-key': '',\n # automatic backup times for backup service\n 'backup-times': '',\n}\n#: Full list of allowed database keys\nALLOWED_SERVICE_KEYS = (\n list(DB_SERVICE_SUBKEYS) + list(DB_SERVICE_CONDITIONAL_SUBKEYS))\n\n# create logger\nlog = logging.getLogger(__name__)\n\n\nclass IVXVManagerDb:\n \"\"\"\n Management service database abstraction class.\n\n Based on :py:mod:`dbm.gnu` module.\n \"\"\"\n db = None #: Database object.\n read_only = None #: Database access mode.\n _retries = None #: Retry count for failed database open.\n _retry_delay = None #: Delay between retries.\n _db_mode = None #: Mode string for :py:func:`dbm.open`.\n\n def __init__(self, for_update=False, retries=30, retry_delay=0.1):\n \"\"\"\n Constructor.\n\n :param for_update: Open database for update\n :type for_update: bool\n :param retries: Retries before giving up\n :type retries: int\n :param retry_delay: Pause between retries (in seconds)\n :type retry_delay: float\n \"\"\"\n self.read_only = not for_update\n self._db_mode = 'ws' if for_update else 'r'\n self._retries = retries\n self._retry_delay = retry_delay\n\n def __enter__(self, mode=None):\n \"\"\"Enter the runtime context, open database.\"\"\"\n mode = mode or self._db_mode\n log.debug(\"Opening management database %r (mode: %s)\", DB_FILE_PATH, mode)\n retries = self._retries\n if mode != 'n' and not os.path.exists(DB_FILE_PATH):\n log.error(\"Database file %r not found\", DB_FILE_PATH)\n raise FileNotFoundError()\n db_error = OSError()\n while retries > 0:\n try:\n self.db = dbm.gnu.open(DB_FILE_PATH, mode)\n break\n except OSError as err:\n if err.errno == 11: # database is locked\n log.debug('Database is locked, retrying')\n else:\n log.debug(\"Can't open database, retrying (%s)\", err)\n db_error = err\n retries -= 1\n time.sleep(self._retry_delay)\n else:\n log.error('Error while opening management database: %s', db_error)\n raise db_error\n\n return self\n\n def __exit__(self, *args):\n \"\"\"Exit the runtime context, close database.\"\"\"\n log.debug('Closing management database')\n self.db.close()\n\n def get_value(self, key):\n \"\"\"Get value from database.\"\"\"\n return self.db[key].decode('UTF-8')\n\n def set_value(self, key, value, safe=False):\n \"\"\"Validate and set database value.\n\n :param key: Key name\n :type key: str\n :param value: Value to set\n :type value: str\n :param safe: Is operation safe or not. Safe operation will try to read\n old value before writing new one.\n :type safe: bool\n \"\"\"\n assert isinstance(key, str)\n\n # validate value\n if isinstance(value, datetime.datetime):\n value = value.strftime(RFC3339_DATE_FORMAT)\n assert isinstance(value, str), f\"Invalid value type: {type(value)}\"\n\n # set value\n if key in [\n 'election/election-id', 'logmonitor/address',\n 'logmonitor/last-data', 'stats/detail/scheduler/cron',\n 'stats/voting_facts/scheduler/cron',\n ]:\n pass\n elif key == 'collector/state':\n assert value in COLLECTOR_STATES, f\"Invalid value for {key!r}: {value!r}\"\n elif re.match('election/(election|service|verification)(start|stop)$', key):\n assert not value or dateutil.parser.parse(value)\n elif (re.match('election/auth/.+$', key)\n or key == 'election/tsp-qualification'):\n assert value == 'TRUE'\n elif key in DB_KEYS or key == \"list/voters0000\":\n if value != '':\n assert value.count(\" \") == 1, f\"Invalid value {value!r}\"\n cn, timestamp = value.split(' ')\n assert re.match(r'^(.+,){2}\\d{11}$', cn)\n dateutil.parser.parse(timestamp)\n elif re.match(r\"list/voters[0-9]{4}$\", key):\n assert value\n assert value.count(\" \") == 1, f\"Invalid value {value!r}\"\n url_or_signature, timestamp = value.split(\" \")\n dateutil.parser.parse(timestamp)\n elif re.match(r\"list/voters[0-9]{4}-state$\", key):\n assert value in [\"PENDING\", \"APPLIED\", \"INVALID\", \"SKIPPED\"]\n elif re.match(r'host/.+/.+$', key):\n key_type = key.split('/')[2]\n assert key_type in DB_HOST_SUBKEYS, f\"Invalid host key type {key_type}\"\n elif re.match(r'service/.+/.+$', key):\n key_type = key.split('/')[2]\n assert (\n key_type in ALLOWED_SERVICE_KEYS\n ), f\"Invalid service key type {key_type}\"\n if key_type == 'state':\n assert value in SERVICE_STATES, f\"Invalid value for {key!r}: {value!r}\"\n elif key_type == 'backup-times':\n assert value == \"\" or re.match(\n r\"[0-9]{2}:[0-9]{2}( [0-9]{2}:[0-9]{2})*$\", value\n ), f\"Invalid value for {key!r}: {value!r}\"\n elif re.match(r'user/.+$', key):\n assert re.match(r'user/(.+,){2}\\d{11}$', key), (\n f\"Invalid user CN {key.split('/')[1]!r}\")\n else:\n raise KeyError(f\"Invalid database field name {key!r}\")\n\n # Safe operation reads value before writing it.\n # This is to avoid unneeded values after database initialization (e.g.\n # agent daemon may try to update service data in background).\n if safe:\n self.db[key]\n\n log.debug(\"Setting value %r = %r\", key, value)\n self.db[key] = value\n\n def rm_value(self, key):\n \"\"\"Remove database record.\"\"\"\n assert isinstance(key, str)\n\n log.debug(\"Removing record %r\", key)\n del self.db[key]\n\n def get_all_values(self, section=None):\n \"\"\"\n Get all database values as a dictionary.\n\n :param section: Config section to get\n :type section: string\n\n :return: dict\n \"\"\"\n values = {}\n for key in sorted(self.keys()):\n path = key.split('/')\n # len(path) == 4 is for stats/detail/scheduler/cron\n # or stats/voting_facts/scheduler/cron\n assert len(path) in (2, 3, 4)\n if path[0] not in values:\n values[path[0]] = {}\n if len(path) == 2:\n values[path[0]][path[1]] = self.get_value(key) or None\n else:\n if path[1] not in values[path[0]]:\n values[path[0]][path[1]] = {}\n values[path[0]][path[1]][path[2]] = self.get_value(key) or None\n\n return values.get(section, {}) if section else values\n\n @classmethod\n def reset(cls):\n \"\"\"Reset database.\"\"\"\n log.info(\"Initializing management database %r\", DB_FILE_PATH)\n db = cls()\n db.__enter__(mode='n')\n\n # write default values\n for key, value in sorted(DB_KEYS.items()):\n db.set_value(key, value)\n\n db.__exit__()\n\n def dump(self, filter_keys=None):\n \"\"\"\n Dump database to stdout.\n\n :param filter_keys: Limit dump with specified values\n :type filter_keys: list\n \"\"\"\n for key in self.keys():\n if not filter_keys or key in filter_keys:\n print(f'{key}: {self.get_value(key)}')\n\n def keys(self):\n \"\"\"Return all database keys in sorted order.\"\"\"\n return [key.decode('UTF-8') for key in sorted(self.db.keys())]\n\n\ndef check_db_dir():\n \"\"\"\n Check database directory exist or not.\n\n :return: Database file directory path or None if path does not exist.\n :rtype: str\n \"\"\"\n db_file_path = CONFIG['ivxv_db_file_path']\n db_path = os.path.dirname(db_file_path)\n if os.path.exists(db_path):\n return db_file_path\n\n log.error('Database directory %r does not exist', db_path)\n\n return None\n" }, { "path": "collector-admin/ivxv_admin/event_log.py", "content": "# IVXV Internet voting framework\n\"\"\"Event logging for Collector Management service.\"\"\"\n\nimport datetime\nimport json\nimport os\n\nfrom . import EVENT_LOG_FILENAME, EVENTS, RFC3339_DATE_FORMAT\nfrom .cli_utils import init_cli_util\nfrom .config import cfg_path\n\nEVENT_LOG_FILEPATH = cfg_path('ivxv_admin_data_path', EVENT_LOG_FILENAME)\n\n\ndef init_event_log():\n \"\"\"Initialize Management Service event log.\"\"\"\n try:\n os.unlink(EVENT_LOG_FILEPATH)\n except FileNotFoundError:\n pass\n register_service_event('COLLECTOR_INIT')\n\n\ndef register_service_event(event, level='INFO', service=None, params=None):\n \"\"\"Register Management Service event in event log file.\"\"\"\n params = params or {}\n assert level in ['INFO', 'ERROR']\n log_event = {\n 'event': event,\n 'level': level,\n 'message': EVENTS[event].format(**params),\n 'service': service or 'management',\n 'timestamp': datetime.datetime.now().strftime(RFC3339_DATE_FORMAT),\n }\n with open(EVENT_LOG_FILEPATH, 'a') as fp:\n json.dump(log_event, fp, sort_keys=True)\n fp.write('\\n')\n\n\ndef event_log_dump_util():\n \"\"\"Dump collector management event log.\"\"\"\n init_cli_util(\n \"\"\"\n Dump IVXV Collector Management event log in human readable format.\n\n Usage: ivxv-eventlog-dump\n \"\"\",\n allow_root=True)\n\n with open(EVENT_LOG_FILEPATH) as fp:\n while True:\n line = fp.readline()\n if not line:\n break\n event = json.loads(line)\n print(\n '{timestamp} {level} {service} {event} {message}'\n .format(**event))\n" }, { "path": "collector-admin/ivxv_admin/http_daemon.py", "content": "# IVXV Internet voting framework\n\"\"\"\nManagement daemon for collector management service.\n\nThis daemon is based on :py:mod:`bottle` module and listens as web service.\n\"\"\"\n\nimport datetime\nimport json\nimport logging\nimport os\nimport subprocess\n\nfrom bottle import get, post, request, response, route, run\n\nfrom . import MANAGEMENT_DAEMON_PORT\nfrom .config import cfg_path\n\n# create logger\nlog = logging.getLogger(__name__)\n\n\n@route('/')\ndef index():\n \"\"\"\n Index page method.\n\n :return: Service identification message.\n \"\"\"\n return 'This is a web server for IVXV Collector Management Service!'\n\n\n@post('/upload-command')\ndef upload_cmd_file():\n \"\"\"Upload command file.\"\"\"\n filename = request.forms.get('filename')\n original_filename = request.forms.get('original_filename')\n cmd_type = request.forms.get('cmd_type')\n file_path = cfg_path('file_upload_path', filename)\n log.info(\"Uploading command file %r (type: %s)\", filename, cmd_type)\n\n # execute command loading utility\n cmd = ['ivxv-cmd-load', '--autoapply', cmd_type, file_path]\n log.info('Executing command: %s', ' '.join(cmd))\n proc = subprocess.run(\n cmd, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, check=False\n )\n log.info('Command finished with exit code %d', proc.returncode)\n\n # report upload result\n body = {\n 'success': bool(proc.returncode == 0),\n 'log': proc.stdout.decode('utf-8').split('\\n'),\n }\n if proc.returncode: # error\n body[\"message\"] = f\"Viga faili {original_filename!r} üleslaadimisel\"\n else: # command loaded\n body[\"message\"] = f\"Fail {original_filename!r} on edukalt üles laaditud\"\n\n # start response\n response.content_type = 'application/json'\n return json.dumps(body)\n\n\n@get('/download-ballot-box')\n@get('/download-consolidated-ballot-box')\ndef download_ballots():\n \"\"\"Export votes into ballot box folder.\"\"\"\n timestamp = '{:%Y.%m.%d_%H.%M}'.format(datetime.datetime.now())\n\n # prepare command\n cmd = ['ivxv-export-votes']\n if 'download-consolidated-ballot-box' in request.url:\n cmd.append('--consolidate')\n filename = f'exported-votes-consolidated-{timestamp}.zip'\n else:\n filename = f'exported-votes-{timestamp}.zip'\n path = cfg_path('exported_votes_path', filename)\n cmd.append(path)\n\n cmd_str = ' '.join(cmd)\n logfile_path = cfg_path(\n 'exported_votes_path', filename.replace('.zip', '.log'))\n cmd = [\n 'sh', '-e', '-c',\n f'( {cmd_str} && chmod 664 {path} ) > {logfile_path}'\n ]\n subprocess.Popen(cmd)\n\n # start response\n response.content_type = 'application/json'\n return json.dumps('OK')\n\n\n@get(\"/download-voter-detail-stats\")\ndef download_voter_stats():\n \"\"\"Download voter stats.\"\"\"\n # import detail stats from Collector, don't export to VIS\n cmd = [\"ivxv-voterstats\", \"detail\", \"--action=import\"]\n log.info(\"Executing command: %s\", \" \".join(cmd))\n proc = subprocess.run(\n cmd, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, check=False\n )\n log.info(\"Command finished with exit code %d\", proc.returncode)\n\n # report result\n if proc.returncode: # error\n body = {\n \"success\": True,\n \"log\": proc.stdout.decode(\"utf-8\").split(\"\\n\"),\n \"message\": \"Viga statistika hankimisel\",\n }\n else: # success\n with open(\"/var/lib/ivxv/admin-ui-data/voterstats-detail.json\") as fd:\n body = json.load(fd)\n\n # start response\n response.content_type = 'application/json'\n return json.dumps(body)\n\n\n@get(\"/download-processor-input\")\ndef download_processor_input():\n \"\"\"Download processor input.\"\"\"\n timestamp = \"{:%Y.%m.%d_%H.%M}\".format(datetime.datetime.now())\n filename = f\"processor-cfg-{timestamp}.zip\"\n output_filepath = f\"/var/lib/ivxv/admin-ui-data/{filename}\"\n try:\n os.unlink(output_filepath)\n except FileNotFoundError:\n pass\n cmd = [\"ivxv-generate-processor-input\", output_filepath]\n log.info(\"Executing command: %s\", \" \".join(cmd))\n proc = subprocess.run(\n cmd, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, check=False\n )\n log.info(\"Command finished with exit code %d\", proc.returncode)\n\n # report result\n if proc.returncode: # error\n body = {\n \"success\": True,\n \"log\": proc.stdout.decode(\"utf-8\").split(\"\\n\"),\n \"message\": \"Viga töötlemisrakenduse sisendi aluse genereerimisel\",\n }\n response.content_type = 'application/json'\n return json.dumps(body)\n\n # success\n with open(output_filepath, \"rb\") as fd:\n body = fd.read()\n response.content_type = \"application/zip\"\n response.set_header(\"Content-Disposition\", f'attachment; filename=\"{filename}\"')\n return body\n\n\n@get(\"/download-voting-sessions\")\ndef download_voting_sessions():\n \"\"\"Download voting sessions.\"\"\"\n cmd = [\"ivxv-voting-sessions\"]\n filename = \"voting-sessions\"\n if request.forms.get(\"verifications\"):\n cmd.append(\"verify\")\n filename += \"-with-verifications\"\n else:\n cmd.append(\"vote\")\n if request.forms.get(\"anonymize\"):\n cmd.append(\"--anonymize\")\n filename += \"-anonymized\"\n if request.forms.get(\"uniq\"):\n cmd.append(\"--uniq\")\n filename += \"-uniq\"\n filename += \"-{:%Y.%m.%d_%H.%M}.csv\".format(datetime.datetime.now()) # timestamp\n filepath = f\"/var/lib/ivxv/admin-ui-data/{filename}\"\n cmd.append(filepath)\n log.info(\"Executing command: %s\", \" \".join(cmd))\n proc = subprocess.run(\n cmd, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, check=False\n )\n if proc.returncode: # error\n body = {\n \"success\": False,\n \"log\": proc.stdout.decode(\"utf-8\").split(\"\\n\"),\n \"message\": \"Viga hääletamise seansside hankimisel\",\n }\n response.content_type = \"application/json\"\n return json.dumps(body)\n\n # success\n log.info(\"Command finished with exit code %d\", proc.returncode)\n\n response.content_type = \"text/csv\"\n response.set_header(\"Content-Disposition\", f'attachment; filename=\"{filename}\"')\n with open(filepath) as fd:\n return fd.read()\n\n\n@get('/skip-voters-list')\ndef skip_voters_lists():\n \"\"\"Remove loaded but unapplied voters lists\"\"\"\n cmd = [\"ivxv-voter-list-skip\"]\n log.info('Executing command: %s', ' '.join(cmd))\n proc = subprocess.run(\n cmd, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, check=False\n )\n log.info('Command finished with exit code %d', proc.returncode)\n\n # report result\n body = {\n 'success': bool(proc.returncode == 0),\n 'log': proc.stdout.decode('utf-8').split('\\n'),\n }\n\n if proc.returncode: # error\n body[\"message\"] = \"Viga nimekirja märkimisel vahelejätmiseks\"\n else: # command loaded\n body[\"message\"] = \"Nimekiri on märgitud vahelejätmiseks\"\n\n # start response\n response.content_type = 'application/json'\n return json.dumps(body)\n\n\ndef daemon():\n \"\"\"Daemon main loop.\"\"\"\n log.info('Starting Management daemon')\n run(host='localhost', port=MANAGEMENT_DAEMON_PORT)\n" }, { "path": "collector-admin/ivxv_admin/lib/__init__.py", "content": "# IVXV Internet voting framework\n\"\"\"Library for collector management service.\"\"\"\n\nimport datetime\nimport json\nimport logging\nimport os\nimport shutil\n\nfrom .. import (\n CFG_TYPES,\n RFC3339_DATE_FORMAT_WO_FRACT,\n SERVICE_STATE_REMOVED,\n SERVICE_TYPE_PARAMS,\n VOTING_LIST_TYPES,\n)\nfrom ..collector_state import generate_collector_state\nfrom ..config import CONFIG, cfg_path\nfrom ..db import DB_SERVICE_SUBKEYS, IVXVManagerDb\nfrom ..event_log import register_service_event\nfrom ..service import generate_service_list\nfrom ..service.service import Service\n\n# create logger\nlog = logging.getLogger('lib')\n\n\nclass IvxvError(Exception):\n \"\"\"IVXV exception class.\"\"\"\n\n\ndef register_tech_cfg_items(cfg, cfg_version):\n \"\"\"Register technical config items in management database.\n\n Create database records for service hosts and services if not created and\n register removed services.\n\n :param cfg: Technical config\n :param cfg_version: Config version\n \"\"\"\n with IVXVManagerDb(for_update=True) as db:\n register_removed_services(db, cfg, cfg_version)\n gen_service_record_defaults(db, cfg)\n gen_host_record_defaults(db, cfg)\n gen_logmon_data(db, cfg.get('logging'))\n\n\ndef register_removed_services(db, cfg, cfg_version):\n \"\"\"Mark removed services in database with REMOVED state.\n\n Change state of removed services to REMOVED.\n\n :param db: Database handler\n :param cfg: Technical config\n \"\"\"\n existing_services = get_services(db=db)\n services_from_cfg = generate_service_list(cfg['network'])\n\n # find removed services\n existing_service_ids = set(existing_services.keys())\n new_service_ids = set(\n new_service_cfg[1]['id']\n for new_service_cfg in services_from_cfg)\n removed_service_ids = existing_service_ids.difference(new_service_ids)\n if not removed_service_ids:\n return\n\n # change loading states for choices, districts and voters lists\n # if all existing storage services are removed\n storages_removed = set(\n service_id\n for service_id, service_data in existing_services.items()\n if service_data['service-type'] == 'storage' and\n service_data['state'] != SERVICE_STATE_REMOVED)\n storages_added = set(\n new_service_cfg['id']\n for service_type, new_service_cfg in services_from_cfg\n if service_type == 'storage')\n if not storages_removed.intersection(storages_added):\n # all storages removed\n log_msg = (\n f'All existing storage service instances are removed with '\n f'technical config {cfg_version}')\n log.warning(log_msg)\n reset_list_loading_state(db, \"choices\", \"choices list\", log_msg)\n reset_list_loading_state(db, \"districts\", \"districts list\", log_msg)\n for changeset_no in range(get_current_voter_list_changeset_no(db), -1, -1):\n reset_list_loading_state(\n db,\n f\"voters{changeset_no:04d}\",\n f\"voter list #{changeset_no:04d}\",\n log_msg,\n )\n\n # change removed service states\n db_values = db.get_all_values()['service']\n for service_id in sorted(removed_service_ids):\n log.info('Changing service %s state to REMOVED', service_id)\n with Service(service_id, db_values[service_id]) as service:\n service.register_state(\n db,\n SERVICE_STATE_REMOVED,\n bg_info=f'Service removed with technical config: {cfg_version}',\n )\n\n\ndef reset_list_loading_state(db, list_type, list_descr, log_msg):\n \"\"\"Reset choices, districts and voters list loading state.\"\"\"\n # check if list is loaded\n list_version = db.get_value(f'list/{list_type}')\n if not list_version:\n return\n\n log_msgs = [log_msg]\n timestamp = datetime.datetime.now().strftime(RFC3339_DATE_FORMAT_WO_FRACT)\n\n # load list metadata file\n filepath = get_loaded_cfg_file_path(list_type)\n assert filepath, f\"Config file for {list_descr} {list_version!r} does not exist\"\n filepath = filepath.replace(os.path.splitext(filepath)[1], \".json\")\n with open(filepath) as fp:\n cfg_state = json.load(fp)\n\n # set list state in management database\n log_msg = \"\"\n if list_type.startswith(\"voters\"): # APPLIED -> PENDING for voters\n db_key = f\"list/{list_type}-state\"\n list_state = db.get_value(db_key)\n if list_state == \"APPLIED\":\n log_msg = f\"Setting {list_descr} state from APPLIED to PENDING\"\n db.set_value(db_key, \"PENDING\")\n else: # PENDING for choices/districts\n db_key = f\"list/{list_type}-loaded\"\n if db.get_value(db_key):\n log_msg = f\"Setting {list_descr} state to PENDING\"\n db.set_value(db_key, \"\")\n if log_msg:\n log.info(log_msg)\n log_msgs.append(log_msg)\n\n # write config metadata file\n log_msgs = [f'{timestamp} {log_msg}' for log_msg in log_msgs]\n cfg_state[\"log\"] += [log_msgs]\n cfg_state[\"attempts\"] = 0\n cfg_state[\"completed\"] = False\n tmp_filepath = f'{filepath}.tmp'\n with open(tmp_filepath, 'w') as fp:\n json.dump(cfg_state, fp)\n shutil.move(tmp_filepath, filepath)\n\n\ndef gen_service_record_defaults(db, cfg):\n \"\"\"Add database records for services with default values.\n\n Parse the list of services from technical config and create\n missing database records for every defined service.\n\n :param db: Database handler\n :param cfg: Technical config\n \"\"\"\n assert 'network' in cfg\n\n # generate list of default values\n service_values = {}\n for network in cfg['network']:\n for service_type, services in sorted(network['services'].items()):\n for service in services or []:\n service_id = service['id']\n service_values[service_id] = DB_SERVICE_SUBKEYS.copy()\n service_values[service_id].update({\n 'service-type': service_type,\n 'network': network['id'],\n 'ip-address': service['address'],\n })\n\n # set service default values\n for service_id, service_defaults in sorted(service_values.items()):\n db_key_prefix = f'service/{service_id}'\n try:\n db.get_value(f\"{db_key_prefix}/service-type\")\n continue\n except KeyError:\n log.info('Registering new service %s in management service',\n service_id)\n register_service_event(\n 'SERVICE_REGISTER',\n service=service_id,\n params={'service_type': service_defaults['service-type']})\n\n for key, val in service_defaults.items():\n db.set_value(f\"{db_key_prefix}/{key}\", val)\n\n set_tech_cfg_service_cond_values(db, cfg)\n\n\ndef set_tech_cfg_service_cond_values(db, cfg):\n \"\"\"Set/remove service conditional values related to technical config.\"\"\"\n for network in cfg['network']:\n for service_type, services in sorted(network['services'].items()):\n for service in services or []:\n # create 'tls-key' and 'tls-cert' for\n # choices/mid/storage/verification/voting services\n if SERVICE_TYPE_PARAMS[service_type]['require_tls']:\n manage_db_cond_value(db, service[\"id\"], \"tls-key\", True)\n manage_db_cond_value(db, service[\"id\"], \"tls-cert\", True)\n # create 'backup-times' for backup service\n elif service_type == 'backup':\n manage_db_cond_value(\n db, service['id'], 'backup-times',\n True, ' '.join(cfg.get('backup') or []))\n\n\ndef manage_db_cond_value(db, service_id, key, set_value, value=None):\n \"\"\"Manage (create/remove) service conditional database value.\"\"\"\n key = f'service/{service_id}/{key}'\n if set_value: # create key\n try:\n db.get_value(key)\n except KeyError:\n db.set_value(key, value or '')\n else: # remove key\n try:\n db.rm_value(key)\n except KeyError:\n pass\n\n\ndef manage_db_mobileid_fields(db):\n \"\"\"Create/remove service Mobile-ID/Smart-ID/Web eID token keys in database.\n\n Check 'ticket' authentication method in election config and manage\n \"mid-token-key\" keys in management database for mid, choices and voting\n services. Keys will created or removed as 'ticket' authentication method is\n used or not.\n \"\"\"\n ticket_auth = 'ticket' in db.get_all_values('election').get('auth', {})\n for service_id, service_data in db.get_all_values('service').items():\n if service_data['service-type'] not in [\n 'mid', 'smartid', 'webeid', 'choices', 'voting']:\n continue\n key = f'service/{service_id}/mid-token-key'\n if ticket_auth:\n if 'mid-token-key' not in service_data:\n db.set_value(key, '')\n elif 'mid-token-key' in service_data:\n db.rm_value(key)\n\n\ndef manage_db_tsp_fields(db):\n \"\"\"Create/remove service TSP registration keys in database.\n\n Check 'qualification' protocol in election config and manage \"tspreg-key\"\n keys in management database for voting services. Keys will created or\n removed as 'tspreg' protocol is used or not.\n \"\"\"\n tspreg = db.get_all_values('election').get('tspreg', '')\n for service_id, service_data in db.get_all_values('service').items():\n if service_data['service-type'] not in ['voting']:\n continue\n key = f'service/{service_id}/tspreg-key'\n if tspreg:\n if 'tspreg-key' not in service_data:\n db.set_value(key, '')\n elif 'tspreg-key' in service_data:\n db.rm_value(key)\n\n\ndef gen_host_record_defaults(db, cfg):\n \"\"\"Add database records for service hosts with default values.\n\n Parse the list of services from technical config and create\n missing database records for service hosts.\n\n :param db: Database handler\n :param cfg: Technical config\n \"\"\"\n # generate list of default values\n hostnames = set()\n for network in cfg['network']:\n for services in network['services'].values():\n for service in services or []:\n hostnames |= {service['address'].split(':')[0]}\n\n # set host default values\n for hostname in sorted(hostnames):\n db_key_prefix = f'host/{hostname}'\n try:\n db.get_value(f\"{db_key_prefix}/state\")\n continue\n except KeyError:\n log.info(\n 'Registering new service host %s in management service',\n hostname)\n db.set_value(f\"{db_key_prefix}/state\", \"\")\n\n\ndef gen_logmon_data(db, logging_params):\n \"\"\"Add database record for Log Monitor service.\n\n :param logging_params: Logging params from technical config.\n :type logging_params: list of dicts\n \"\"\"\n if logging_params:\n db.set_value('logmonitor/address', logging_params[0]['address'])\n\n\ndef cfg_type_verbose(cfg_type):\n \"\"\"Get config type as human readable string.\"\"\"\n try:\n return CFG_TYPES[cfg_type]\n except KeyError:\n return VOTING_LIST_TYPES[cfg_type]\n\n\ndef get_services(db=None,\n require_collector_state=None,\n service_state=None,\n include_types=None,\n exclude_types=None):\n \"\"\"Generate filtered list of services.\n\n :param require_collector_state: Require specified state for collector\n :type require_collector_state: list\n :param include_types: Include specified service types\n :type include_types: list\n :param exclude_types: Exclude specified service types\n :type exclude_types: list\n :return: dict of services (key is service ID and value\n is dict with service database values) or\n None if collector is not in expected state\n \"\"\"\n require_collector_state = require_collector_state or []\n assert isinstance(require_collector_state, list)\n service_state = service_state or []\n assert isinstance(service_state, list)\n include_types = include_types or []\n exclude_types = exclude_types or []\n assert isinstance(include_types, list)\n assert isinstance(exclude_types, list)\n assert not include_types or not exclude_types\n\n # get collector state\n if db:\n collector_state = generate_collector_state(db)\n else:\n with IVXVManagerDb() as _db:\n collector_state = generate_collector_state(_db)\n\n # check collector state\n if (require_collector_state and\n collector_state['collector_state'] not in require_collector_state):\n log.info('Collector service state is %s',\n collector_state['collector_state'])\n if len(require_collector_state) == 1:\n log.error('Collector state must be %s for this operation',\n require_collector_state[0])\n else:\n log.error('Collector state must be %s or %s for this operation',\n ', '.join(require_collector_state[:-1]),\n require_collector_state[-1])\n return None\n\n # create list of services\n services = {}\n for service_id, service_data in collector_state.get('service', {}).items():\n if service_state and service_data.get('state') not in service_state:\n continue\n if include_types:\n if service_data['service-type'] in include_types:\n services[service_id] = service_data\n continue\n if exclude_types:\n if service_data['service-type'] not in exclude_types:\n services[service_id] = service_data\n continue\n services[service_id] = service_data\n\n return services\n\n\ndef clean_dir(path):\n \"\"\"Remove all files from directory.\"\"\"\n log.debug(\"Cleaning directory %r\", path)\n for filename in os.listdir(path):\n role_filename = os.path.join(path, filename)\n os.unlink(role_filename)\n\n\ndef populate_user_permissions(db):\n \"\"\"Populate user permissions for Apache web server.\"\"\"\n permissions_path = CONFIG['permissions_path']\n permissions_to_create = []\n\n for user_cn, permissions in db.get_all_values('user').items():\n for permission_name in permissions.split(','):\n permissions_to_create.append(f\"{user_cn}-{permission_name}\")\n\n # removing permission files\n for permission_name in os.listdir(permissions_path):\n if permission_name not in permissions_to_create:\n filepath = os.path.join(permissions_path, permission_name)\n log.info(\"Removing Apache Web Server user permission file %r\", filepath)\n os.remove(filepath)\n\n # creating permission files\n for permission_name in permissions_to_create:\n filepath = os.path.join(permissions_path, permission_name)\n if not os.path.exists(filepath):\n log.info(\"Creating Apache Web Server user permission file %r\", filepath)\n with open(filepath, 'x') as fp:\n fp.write(f\"Created {datetime.datetime.now().strftime('%c')}\")\n\n\ndef get_current_voter_list_changeset_no(db):\n \"\"\"Get changeset number from database for last loaded voter list.\n\n :return: changeset number or -1 if initial voter list is not loaded to database\n :rtype: int\n \"\"\"\n for changeset_no in range(10_000):\n try:\n db.get_value(f\"list/voters{changeset_no:04d}\")\n except KeyError:\n return changeset_no - 1\n return 0\n\n\ndef get_loaded_cfg_file_path(cfg_type):\n \"\"\"Get real file path for loaded config file.\n\n :return: File path or None if file does not exist\n :rtype: str\n \"\"\"\n ext = (\n \"zip\" if cfg_type.startswith(\"voters\") and cfg_type != \"voters0000\" else \"bdoc\"\n )\n filepath = cfg_path(\"active_config_files_path\", f\"{cfg_type}.{ext}\")\n if not os.path.exists(filepath):\n return None\n\n assert os.path.islink(filepath), (\n f\"Config file {filepath!r} is not a symbolic link\"\n )\n\n return os.path.realpath(filepath)\n" }, { "path": "collector-admin/ivxv_admin/lib/lockfile.py", "content": "# IVXV Internet voting framework\n\"\"\"Lockfile implementation for collector management service.\"\"\"\n\nimport argparse\nimport atexit\nimport errno\nimport fcntl\nimport logging\nimport os\nimport signal\nimport sys\nimport time\n\nfrom ..config import cfg_path\n\n# create logger\nlog = logging.getLogger(\n f\"{__package__}.lockfile\" if __name__ == \"__main__\" else __name__\n)\n\n\nclass PidLocker:\n \"\"\"Pidfile creator and locker.\n\n Create pidfile and keep it locked until program exit.\n Raise IOError on locking failure.\n\n >>> try:\n ... PidLocker(\"/path/to/pidfile\", timeout = 5)\n ... except IOError:\n ... print('Locking failed even after waiting 5 seconds')\n ... exit(1)\n \"\"\"\n\n filepath = None #: Pidfile name\n fp = None #: Pidfile descriptor\n\n def __init__(self, pidfile_name, timeout=0):\n \"\"\"Create and lock pidfile.\n\n :raises OSError: On locking failure\n \"\"\"\n self.fp = None\n self.filepath = pidfile_name\n atexit.register(self.rm_pid)\n self.fp = open(pidfile_name, \"ab\")\n self.acquire_lock_with_timeout(timeout)\n self.fp.write(bytes(f\"{os.getpid()}\\n\", \"ASCII\"))\n self.fp.flush()\n\n def acquire_lock_with_timeout(self, to):\n\n def handler(signum, frame):\n raise OSError(errno.EACCES,\n f\"Failed to lock {self.filepath} in {to} sec\")\n\n signal.signal(signal.SIGALRM, handler)\n\n retry_interval = 0.1\n\n try:\n signal.alarm(to)\n while True:\n try:\n fcntl.flock(self.fp, fcntl.LOCK_EX | fcntl.LOCK_NB)\n # Successfully acquired a lock\n break\n except Exception: # pylint: disable=broad-except\n if to == 0:\n raise OSError(errno.EACCES,\n f\"Failed to lock {self.filepath} in {to} sec.\")\n # Wait for another process to release the lock\n time.sleep(retry_interval)\n\n finally:\n signal.alarm(0)\n\n def rm_pid(self):\n \"\"\"Remove pidfile.\"\"\"\n try:\n os.remove(self.filepath)\n if self.fp is not None:\n self.fp.close()\n except FileNotFoundError:\n log.warning(\"PID file %r already removed\", self.filepath)\n\n @classmethod\n def get_pidfile_path(cls, pidfile_name):\n \"\"\"Get pidfile path.\"\"\"\n pidfile_path = cfg_path(\"ivxv_admin_data_path\", pidfile_name)\n return pidfile_path\n\n @classmethod\n def pidfile_exists(cls, pidfile_name):\n \"\"\"Check if pidfile exist.\"\"\"\n pidfile_path = cls.get_pidfile_path(pidfile_name)\n return os.path.exists(pidfile_path)\n\n @classmethod\n def rm_stale_pidfile(cls, pidfile_name):\n \"\"\"Remove stale or invalid pidfile.\"\"\"\n if not cls.pidfile_exists(pidfile_name):\n return\n\n pidfile_path = cls.get_pidfile_path(pidfile_name)\n with open(pidfile_path) as fp:\n pidline = fp.readline()\n\n reason = \"\" if pidline.strip() else \"empty\"\n if not reason:\n try:\n pid = int(pidline)\n except ValueError:\n reason = \"invalid\"\n if not reason and not os.path.exists(f\"/proc/{pid}\"):\n reason = \"stale\"\n if reason:\n log.error(\"Removing %s pidfile %r\", reason, pidfile_path)\n os.remove(pidfile_path)\n\n\ndef main():\n \"\"\"Lockfile testing utility.\"\"\"\n # parse CLI args\n parser = argparse.ArgumentParser(\n description=\"\"\"\n Create lock file and related process to hold it for a specified period.\n \"\"\"\n )\n parser.add_argument(\"--file\", required=True, type=str, help=\"Lock file name\")\n parser.add_argument(\n \"--time\", required=True, type=int, help=\"Period to hold lock file (in seconds)\"\n )\n parser.add_argument(\n \"--attempts\",\n required=False,\n type=int,\n default=1,\n help=\"Attempts to acquire lock file\",\n )\n parser.add_argument(\n \"--background\", action=\"store_true\", help=\"Fork process to background\"\n )\n\n args = parser.parse_args()\n assert args.time >= 0, \"--time can't have negative value\"\n assert args.attempts > 0, \"--attempts must have positive value\"\n\n filepath = PidLocker.get_pidfile_path(args.file)\n attempts_left = args.attempts\n proc_type = \"background\" if args.background else \"foreground\"\n\n # fork to background if requested\n if args.background:\n log.info(\"Forking to background\")\n pid = os.fork()\n if pid:\n log.info(\"Forked child process %d, exiting foreground process\", pid)\n return 0\n\n # acquire lockfile\n PidLocker.rm_stale_pidfile(args.file)\n log.info(\"Creating lockfile %r for PID %d in %s\", filepath, os.getpid(), proc_type)\n while attempts_left:\n attempts_left -= 1\n try:\n PidLocker(filepath)\n except BlockingIOError as err:\n if not attempts_left:\n log.error(\"Failed to create lockfile (%s), no attempts left\", err)\n return 1\n log.warning(\n \"Failed to create lockfile %r, waiting for 1 second (%d attempts left)\",\n filepath,\n attempts_left,\n )\n time.sleep(1)\n continue\n log.info(\"Lockfile %r successfully acquired\", filepath)\n break\n\n # sleep\n log.info(\"Sleeping for %d seconds\", args.time)\n time.sleep(args.time)\n\n # cleanup\n log.info(\"Removing lockfile %r for PID %d in %s\", filepath, os.getpid(), proc_type)\n\n return 0\n\n\nif __name__ == \"__main__\":\n sys.exit(main())\n" }, { "path": "collector-admin/ivxv_admin/service/__init__.py", "content": "# IVXV Internet voting framework\n\"\"\"Microservice management module.\"\"\"\n\nfrom .. import SERVICE_STATE_REMOVED, SERVICE_TYPE_PARAMS\nfrom .logging import log\n\n#: Path to users SSH public key file.\nIVXV_ADMIN_SSH_PUBKEY_FILE = '~/.ssh/id_ed25519.pub'\n#: Path to rsyslog config filename.\nRSYSLOG_CFG_FILENAME = '/etc/rsyslog.d/ivxv-logging.conf'\n\n\ndef get_service_cfg_state(db, cfg):\n \"\"\"Get list of services that requires config update.\n\n Check technical config records against database and generate list of\n services that require config update.\n\n :param db: Database handler\n :param cfg: Technical config\n\n :return: Service list with config update params:\n\n .. code-block:: text\n\n {\n 'service-id': {\n 'technical': bool,\n 'election': bool,\n 'choices': bool,\n 'districts': bool,\n 'voters': [list-number, ...],\n },\n ...\n }\n\n :rtype: dict\n\n \"\"\"\n assert 'network' in cfg\n\n # detect config versions\n tech_cfg_ver = db.get_value('config/technical')\n election_cfg_ver = db.get_value('config/election')\n\n # detect need for list updates\n update_choices_list = (db.get_value('list/choices') !=\n db.get_value('list/choices-loaded'))\n update_districts_list = (db.get_value('list/districts') !=\n db.get_value('list/districts-loaded'))\n update_voters_list = []\n for changeset_no in range(10_000):\n try:\n if db.get_value(f\"list/voters{changeset_no:04d}-state\") == \"PENDING\":\n update_voters_list.append(changeset_no)\n except KeyError:\n break\n\n # create list of services\n service_list = {}\n for network in cfg['network']:\n for service_type, services in sorted(network['services'].items()):\n for service in services or []:\n db_key_prefix = f'service/{service[\"id\"]}'\n\n service_tech_cfg_ver = db.get_value(\n f\"{db_key_prefix}/technical-conf-version\"\n )\n service_election_cfg_ver = election_cfg_ver and db.get_value(\n f\"{db_key_prefix}/election-conf-version\"\n )\n\n service_list[service['id']] = {\n 'technical': service_tech_cfg_ver != tech_cfg_ver,\n 'election': service_election_cfg_ver != election_cfg_ver,\n 'choices':\n service_type == 'choices' and update_choices_list,\n 'districts':\n service_type == 'choices' and update_districts_list,\n 'voters': update_voters_list,\n }\n if service_list[service['id']]['technical']:\n log.debug('Service %s have no latest version of '\n 'technical config', service['id'])\n\n if service_list[service['id']]['election']:\n log.debug('Service %s have no latest version of '\n 'election config', service['id'])\n\n return service_list\n\n\ndef generate_service_list(service_networks, service_id_filter=None):\n \"\"\"Generate service list from collector technical config.\n\n .. code-block:: text\n\n [\n [, {param: value, ...}],\n ...\n ]\n\n :param service_networks: Service networks from collector technical config\n (section 'networks').\n :type service_networks: dict\n :param service_id_filter: Service IDs to include.\n All services are included if None.\n :type service_id_filter: list\n\n :return: List of services or None if some of specified services not found.\n \"\"\"\n service_id_filter = service_id_filter or []\n service_list = []\n service_ids = service_id_filter[:]\n for network in service_networks:\n for service_type, services in sorted(network['services'].items()):\n for service_data in services or []:\n service_id = service_data['id']\n if service_id_filter and service_id not in service_ids:\n log.debug('Skipping service %s', service_id)\n continue\n if service_ids:\n service_ids.remove(service_id)\n service_list.append([service_type, service_data])\n\n if service_ids:\n log.error('Invalid service ID: %s', ', '.join(service_ids))\n return None\n\n return service_list\n\n\ndef generate_service_hints(services):\n \"\"\"Generate configuration hints for services and inject it to service data.\n\n :param services: Service data\n :type services: dict\n \"\"\"\n for service_id, params in services.items():\n if params['state'] == SERVICE_STATE_REMOVED:\n continue\n # ordered list of hints\n hints = [\n ['Apply technical config', not params['technical-conf-version']],\n ]\n service_type_params = SERVICE_TYPE_PARAMS[params['service-type']]\n if service_type_params['require_tls']:\n hints += [\n ['Install service TLS key', not params.get('tls-key', True)],\n ['Install service TLS certificate',\n not params.get('tls-cert', True)],\n ]\n if service_type_params['mobile_id']:\n hints.append(\n ['Install Mobile-ID/Smart-ID/Web eID identity token key',\n not params.get('mid-token-key', True)])\n if service_type_params['tspreg']:\n hints.append(\n ['Install TSP registration key',\n not params.get('tspreg-key', True)])\n if service_type_params['require_config']:\n hints.append(\n ['Apply election config', not params['election-conf-version']])\n\n for hint, is_relevant in hints:\n if is_relevant:\n services[service_id]['bg_info'] = hint\n break\n" }, { "path": "collector-admin/ivxv_admin/service/backup_service.py", "content": "# IVXV Internet voting framework\n\"\"\"Backup service management helper.\"\"\"\n\nimport subprocess\n\n\ndef install_backup_crontab():\n \"\"\"Install crontab for backup automation.\"\"\"\n subprocess.run([\"env\", \"VISUAL=ivxv-backup-crontab\", \"crontab\", \"-e\"], check=True)\n" }, { "path": "collector-admin/ivxv_admin/service/logging.py", "content": "# IVXV Internet voting framework\n\"\"\"Logging helper for microservice management.\"\"\"\n\nimport logging\n\n# create logger\nlog = logging.getLogger('.'.join(__name__.split('.')[:-1]))\n\n\nclass ServiceLogger(logging.LoggerAdapter):\n \"\"\"Logger adapter for service object.\n\n Include service ID for logged messages.\n Include message level for levels other than INFO.\n \"\"\"\n\n def process(self, msg, kwargs):\n \"\"\"\n Process the logging message and keyword arguments passed in to\n a logging call to insert contextual information.\n \"\"\"\n return f\"SERVICE {self.extra['service_id']}: {msg}\", kwargs\n\n def log(self, level, msg, *args, **kwargs):\n \"\"\"\n Delegate a log call to the underlying logger, after adding\n contextual information from this adapter instance.\n \"\"\"\n if self.isEnabledFor(level):\n if level != logging.INFO:\n msg = f\"{logging.getLevelName(level).upper()}: {msg}\"\n msg, kwargs = self.process(msg, kwargs)\n self.logger.log(level, msg, *args, **kwargs)\n" }, { "path": "collector-admin/ivxv_admin/service/remote_exec.py", "content": "# IVXV Internet voting framework\n\"\"\"Remote execution helper for microservice management.\"\"\"\n\nimport subprocess\n\nfrom .logging import log\n\n\ndef exec_remote_cmd(cmd, **kw):\n \"\"\"Perform remote operation in service host.\n\n Execute service management command in service host (over OpenSSH SSH\n client) or copy file to service host file system (over secure copy).\n\n :param cmd: Command for subprocess.run()\n :type cmd: list\n :param kw: Parameters for subprocess.run()\n :type kw: dict\n :return: subprocess.CompletedProcess\n \"\"\"\n assert cmd[0] in ('ssh', 'scp')\n\n # patch command\n if cmd[0] == 'ssh':\n cmd.insert(1, '-T') # disable pseudo-terminal allocation\n cmd.insert(1, '-o') # set preferred authentication method\n cmd.insert(2, 'PreferredAuthentications=publickey')\n\n # execute command\n log.debug('Executing command: %s', ' '.join(cmd))\n try:\n check = kw.pop('check')\n except KeyError:\n check = False\n proc = subprocess.run(cmd, **kw, check=check)\n if proc.returncode:\n log.debug('Command finished with error code %d', proc.returncode)\n else:\n log.debug('Command successfully executed')\n\n return proc\n" }, { "path": "collector-admin/ivxv_admin/service/service.py", "content": "# IVXV Internet voting framework\n\"\"\"Microservice management helper.\"\"\"\n\nimport datetime\nimport json\nimport os\nimport re\nimport shutil\nimport subprocess\nimport tempfile\nfrom logging.handlers import MemoryHandler\n\nfrom jinja2 import Environment, PackageLoader\n\nfrom debian import debfile\n\nfrom .. import (\n COLLECTOR_PKG_FILENAMES,\n DEB_PKG_VERSION,\n RFC3339_DATE_FORMAT_WO_FRACT,\n SERVICE_SECRET_TYPES,\n SERVICE_STATE_CONFIGURED,\n SERVICE_STATE_INSTALLED,\n SERVICE_STATE_NOT_INSTALLED,\n SERVICE_TYPE_PARAMS,\n)\nfrom ..config import CONFIG, cfg_path\nfrom ..db import IVXVManagerDb\nfrom ..event_log import register_service_event\nfrom . import IVXV_ADMIN_SSH_PUBKEY_FILE, RSYSLOG_CFG_FILENAME, generate_service_hints\nfrom .backup_service import install_backup_crontab\nfrom .logging import ServiceLogger, log\nfrom .remote_exec import exec_remote_cmd\n\n#: Path to service directory.\nSERVICE_DIR = cfg_path('ivxv_admin_data_path', 'service')\n\n\nclass Service:\n \"\"\"Service management for collector services.\"\"\"\n service_id = None #: Service ID (str)\n data = None #: Service data (dict)\n #: State report file name for currently applied config (str)\n cfg_state_filepath = None\n cfg_state = None #: State report for currently applied config (dict)\n\n def __init__(self, service_id, service_data):\n \"\"\"Constructor.\"\"\"\n self.service_id = service_id\n\n # Service data from config file and the same data from\n # management service database are slithgtly different.\n # Convert service data to database format.\n if 'service_type' in service_data:\n service_data = {\n 'service-type': service_data.get('service_type'),\n 'ip-address': service_data.get('address'),\n }\n self.data = service_data\n self.log = ServiceLogger(log, {\"service_id\": service_id})\n self.memory_log_handler = MemoryHandler(1000) #: Mem-handler for log buffering\n log.addHandler(self.memory_log_handler)\n\n def __enter__(self):\n return self\n\n def __exit__(self, *args):\n self.close()\n\n def __repr__(self):\n \"\"\"Printable representation of an object.\"\"\"\n return f''\n\n def close(self):\n self.memory_log_handler.close()\n log.removeHandler(self.memory_log_handler)\n\n @property\n def hostname(self):\n \"\"\"Hostname (str).\"\"\"\n return self.data['ip-address'].split(':')[0]\n\n @property\n def service_type(self):\n \"\"\"Service type (str).\"\"\"\n return self.data['service-type']\n\n @property\n def service_account_name(self):\n \"\"\"Service account name (str).\"\"\"\n if self.service_type in ['backup', 'log']:\n return 'ivxv-admin'\n if self.service_type == 'proxy':\n return 'haproxy'\n return f\"ivxv-{self.service_type}\"\n\n @property\n def service_systemctl_id(self):\n \"\"\"Service ID to use with systemctl (str).\"\"\"\n return f'ivxv-{self.service_type}@{self.service_id}'\n\n @property\n def service_data_dir(self):\n \"\"\"Path to service data directory (str).\"\"\"\n return os.path.join(SERVICE_DIR, self.service_id)\n\n @property\n def deb_pkg_name(self):\n \"\"\"Debian package name (str).\"\"\"\n return f'ivxv-{self.service_type}'\n\n def get_db_key(self, name):\n \"\"\"Get database key for this service.\"\"\"\n return f'service/{self.service_id}/{name}'\n\n def register_event(self, event, params, level='INFO'):\n \"\"\"Register service event.\"\"\"\n register_service_event(\n event, level=level, service=self.service_id, params=params)\n\n def register_bg_info(self, bg_info):\n \"\"\"Register service error message in database.\"\"\"\n if bg_info:\n self.log.info('Registering background info: %s',\n bg_info.split('\\n')[0])\n with IVXVManagerDb(for_update=True) as db:\n db.set_value(self.get_db_key('bg_info'), bg_info, safe=True)\n\n def remove_root_access(self):\n \"\"\"Remove management service access to service host root account.\n\n :return: True on success, False on error.\n :rtype: bool\n \"\"\"\n # disable ivxv-admin key in authorized_keys file\n self.log.info(\n \"Removing management service access to root account in service host %r\",\n self.hostname,\n )\n proc = self.ssh(\n 'sudo ivxv-admin-sudo remove-admin-root-access', account='root')\n\n # report result\n if proc.returncode:\n self.log.info('Failed to remove management service access '\n 'to service host root account')\n return False\n\n self.log.info('Management service access to service host '\n 'root account removed successfully')\n return True\n\n def install_service(self):\n \"\"\"Install service in service host.\n\n :return: True on success, False on error.\n :rtype: bool\n \"\"\"\n self.log.info(\"Installing service to host %r\", self.hostname)\n\n # initialize service on the first tech config\n with IVXVManagerDb() as db:\n current_cfg_ver = db.get_value(\n self.get_db_key('technical-conf-version'))\n if not current_cfg_ver:\n if not self.init_service():\n return False\n\n # install service package\n error = not self.install_service_pkg()\n\n # create SSH access to service account\n if not error and self.service_account_name != 'ivxv-admin':\n self.log.info(\n \"Creating access to the service account %r in service host\",\n self.service_account_name,\n )\n proc = self.ssh(\n 'sudo ivxv-admin-sudo create-ssh-access {}'.format(\n self.service_account_name),\n account='ivxv-admin')\n error = bool(proc.returncode)\n\n if error:\n self.log.error('Failed to create access '\n 'to the service account in service host')\n\n # report result\n if error:\n self.log.error('Failed to install service')\n return False\n\n self.log.info('Service installed successfully')\n return True\n\n def install_service_pkg(self, is_update=False, package=None):\n \"\"\"Install service package to service host.\n\n :return: True on success, False on error.\n :rtype: bool\n \"\"\"\n if not package:\n pkg_path = cfg_path(\n 'deb_pkg_path', COLLECTOR_PKG_FILENAMES[self.deb_pkg_name])\n else:\n pkg_path = package\n\n # check package status in service host\n if not is_update and not package:\n self.log.info(\n 'Querying state of the service software package %r version %s',\n self.deb_pkg_name, DEB_PKG_VERSION)\n proc = self.ssh(\n f'dpkg --status {self.deb_pkg_name}',\n account='ivxv-admin',\n stdout=subprocess.PIPE)\n if proc.returncode == 0:\n for line in proc.stdout.decode('UTF-8').split('\\n'):\n if line.find('Version:') == 0:\n pkg_version = line.split(':')[1].strip()\n if DEB_PKG_VERSION == pkg_version:\n self.log.info(\n \"Package %r is already installed\",\n self.deb_pkg_name,\n )\n return True\n self.log.info(\n \"Package %r is installed with wrong version %s\",\n self.deb_pkg_name,\n pkg_version,\n )\n break\n\n # copy packages to service host\n if not self.scp(\n local_path=pkg_path,\n remote_path=CONFIG['deb_pkg_path'],\n description='software package file',\n account='ivxv-admin'):\n return False\n\n # install service package\n self.log.info(\"Installing package %r\", self.deb_pkg_name)\n proc = self.ssh(\n 'sudo ivxv-admin-sudo install-pkg {}'.format(\n pkg_path),\n account='ivxv-admin')\n if proc.returncode:\n self.log.error(\"Failed to install package %r\", self.deb_pkg_name)\n return False\n self.log.info(\"Package %r is installed successfully\", self.deb_pkg_name)\n\n return True\n\n def update_ivxv_common_pkg(self):\n \"\"\"Update ivxv-common package in service host.\n\n :return: True on success, False on error.\n :rtype: bool\n \"\"\"\n # copy package file to service host\n pkg_name = 'ivxv-common'\n pkg_path = cfg_path('deb_pkg_path', COLLECTOR_PKG_FILENAMES[pkg_name])\n if not self.scp(\n local_path=pkg_path,\n remote_path=CONFIG['deb_pkg_path'],\n description='ivxv-common package file',\n account='ivxv-admin'):\n return False\n\n # install ivxv-common package\n self.log.info('Installing ivxv-common package')\n proc = self.ssh(\n 'sudo ivxv-admin-sudo install-pkg {}'.format(\n COLLECTOR_PKG_FILENAMES[pkg_name]),\n account='ivxv-admin')\n if proc.returncode:\n self.log.info('Failed to install {} package', pkg_name)\n return False\n\n self.log.info(\"Package %r is installed successfully\", pkg_name)\n return True\n\n def init_service(self):\n \"\"\"Initialize service.\n\n :return: True on success, False on error.\n :rtype: bool\n \"\"\"\n # remove service package with all dependent packages\n if not self.remove_service_pkg():\n return False\n\n # initialize service data\n self.log.info('Initializing service data directory in service host')\n\n service_id = (\n 'backup' if self.service_type == 'backup' else self.service_id)\n proc = self.ssh(\n f'sudo ivxv-admin-sudo init-service {service_id}',\n account='ivxv-admin')\n\n if proc.returncode:\n self.log.error('Failed to initialize service data directory')\n return False\n\n self.log.info('Service data directory initialized successfully')\n return True\n\n def init_service_host(self):\n \"\"\"Initialize service host.\n\n :return: True on success, False on error.\n :rtype: bool\n \"\"\"\n self.log.info('Initializing service host')\n\n # install ivxv-common package in service host if required\n self.log.info('Detect ivxv-common package status')\n proc = self.ssh('dpkg --list ivxv-common', account='ivxv-admin')\n if proc.returncode:\n self.log.info('Failed to detect ivxv-common package status')\n # detect ivxv-common package dependencies\n pkg_path = cfg_path(\n 'deb_pkg_path', COLLECTOR_PKG_FILENAMES['ivxv-common'])\n\n # copy package file to service host\n remote_path = os.path.join(\n '/root', COLLECTOR_PKG_FILENAMES['ivxv-common'])\n if not self.scp(\n local_path=pkg_path,\n remote_path=remote_path,\n description='ivxv-common package file',\n account='root'):\n return False\n\n # update package list\n self.log.info('Updating package list')\n cmd = [\n 'env', 'TERM=dumb', 'DEBIAN_FRONTEND=noninteractive',\n 'apt-get', 'update'\n ]\n proc = self.ssh(cmd, account='root')\n if proc.returncode:\n self.log.info('Failed to update package list')\n return False\n\n # install ivxv-common package\n if not self.install_ivxv_common_pkg(pkg_path, remote_path):\n return False\n\n # create management service access to\n # service host ivxv-admin account\n self.log.info('Creating access to the management account '\n '\"ivxv-admin\" in service host')\n cmd = [\n 'tee', '--append',\n os.path.join(\n os.path.expanduser('~ivxv-admin'), '.ssh',\n 'authorized_keys')\n ]\n with open(os.path.expanduser(IVXV_ADMIN_SSH_PUBKEY_FILE),\n 'rb') as key_fp:\n proc = self.ssh(cmd, account='root', stdin=key_fp)\n if proc.returncode:\n self.log.error('Failed to remove create SSH access '\n 'to management account in service host')\n return False\n\n # remove management service access to service host root account\n if not self.remove_root_access():\n return False\n\n # initialize service host\n proc = self.ssh('sudo ivxv-admin-sudo init-host', account='ivxv-admin')\n if proc.returncode:\n self.log.error('Failed to initialize service host')\n return False\n\n self.log.info('Service host initialized successfully')\n return True\n\n def install_ivxv_common_pkg(self, pkg_path, remote_path):\n \"\"\"Install ivxv-common package with dependent packages.\"\"\"\n # detect package dependencies\n deb = debfile.DebFile(pkg_path)\n deps = []\n for field in 'Depends', 'Recommends':\n deps_str = deb.control.debcontrol().get(field)\n if deps_str is not None:\n deps += [dep.split(' ')[0] for dep in deps_str.split(', ')]\n\n # install package dependecies\n self.log.info('Installing ivxv-common package dependencies')\n cmd = [\n 'env', 'TERM=dumb', 'DEBIAN_FRONTEND=noninteractive',\n 'apt-get', '--yes', 'install'\n ] + deps\n proc = self.ssh(cmd, account='root')\n if proc.returncode:\n self.log.info('Failed to install ivxv-common package dependencies')\n return False\n\n # install package\n self.log.info('Installing ivxv-common package')\n proc = self.ssh(f'dpkg --install {remote_path}', account='root')\n if proc.returncode:\n self.log.info('Failed to install ivxv-common package')\n return False\n\n return True\n\n def remove_service_pkg(self):\n \"\"\"Remove service package with all dependent packages in service host.\n\n :return: True on success, False on error.\n :rtype: bool\n \"\"\"\n # check package state\n self.log.info(\"Checking package %r state in service host\", self.deb_pkg_name)\n cmd = f'dpkg --list {self.deb_pkg_name}'\n proc = self.ssh(cmd, account='ivxv-admin', stdout=subprocess.PIPE)\n if proc.returncode:\n self.log.info(\n \"Package %r is not installed in service host\",\n self.deb_pkg_name,\n )\n return True\n\n # detect packages to remove\n pkg_to_remove = []\n for line in proc.stdout.decode().split('\\n'):\n if line[:2] != 'un':\n for key in COLLECTOR_PKG_FILENAMES:\n if f' {key} ' in line:\n assert key != 'ivxv-common'\n pkg_to_remove.append(key)\n\n # remove packages\n self.log.info(\"Removing package %r in service host\", self.deb_pkg_name)\n cmd = 'apt-get purge --yes {}'.format(' '.join(pkg_to_remove))\n proc = self.ssh(cmd, account='root', stdout=subprocess.PIPE)\n if proc.returncode:\n self.log.info(\n \"Failed to remove package %r in service host\",\n self.deb_pkg_name,\n )\n if proc.stdout:\n for line in proc.stdout.decode().split('\\n'):\n self.log.info(line)\n if proc.stderr:\n for line in proc.stderr.decode().split('\\n'):\n self.log.error(line)\n return False\n\n self.log.info(\n \"Package %r in service host removed successfully\",\n self.deb_pkg_name,\n )\n return True\n\n def restart_service(self):\n \"\"\"Restart service.\n\n :return: True on success, False on error.\n :rtype: bool\n \"\"\"\n # detect service state\n with IVXVManagerDb() as db:\n state = db.get_all_values('service')\n state[self.service_id]['bg_info'] = None\n generate_service_hints(state)\n\n # skip restarting of unconfigured service\n if state[self.service_id]['bg_info']:\n self.log.info(\n 'Skipping restart of unconfigured service: %s',\n state[self.service_id]['bg_info'])\n return True\n\n # restart service\n self.log.info('Restarting service')\n\n cmd = [\n 'ivxv-admin-helper', 'restart-service', self.service_type,\n self.service_id, self.service_systemctl_id\n ]\n proc = self.ssh(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE)\n error = bool(proc.returncode)\n\n if error:\n self.register_bg_info(\n 'Service restart error: {}'\n .format(proc.stderr.decode('UTF-8').strip()))\n self.log.error('Failed to restart service')\n return False\n\n with IVXVManagerDb(for_update=True) as db:\n self.register_state(db, SERVICE_STATE_CONFIGURED)\n self.log.info('Service restarted successfully')\n return True\n\n def stop_service(self):\n \"\"\"Stop service.\n\n :return: True on success, False on error.\n :rtype: bool\n \"\"\"\n self.log.info('Stopping service')\n\n cmd = ['systemctl', 'stop', '--user', self.service_systemctl_id]\n proc = self.ssh(cmd)\n error = bool(proc.returncode)\n\n if error:\n self.log.error('Failed to stop service')\n return False\n\n self.log.info('Service stopped successfully')\n return True\n\n def configure_logging(self, tech_cfg):\n \"\"\"Configure rsyslog logging in service host.\n\n :return: True on success, False on error.\n :rtype: bool\n \"\"\"\n self.log.info(\"Configuring syslog logging in service host %r\", self.hostname)\n\n # prepare log collector services data\n log_collectors = []\n for network in tech_cfg['network']:\n for service_type, services in network['services'].items():\n if service_type == 'log' and services:\n for service in services:\n log_collectors.append({\n 'id': service['id'],\n 'address': service['address'].split(':')[0],\n 'port': service['address'].split(':')[1],\n })\n\n # prepare external log collectors data (first record is Log Monitor)\n ext_log_collectors = tech_cfg.get('logging', [])\n\n # load rsyslog config template\n tmpl_env = Environment(loader=PackageLoader('ivxv_admin', 'templates'))\n template = tmpl_env.get_template('ivxv_service_rsyslog_conf.jinja')\n\n # create rsyslog config content\n rsyslog_cfg = template.render(\n cfg_filepath=RSYSLOG_CFG_FILENAME,\n log_collectors=log_collectors,\n ext_log_collectors=ext_log_collectors)\n\n # read existing config file\n cmd = f\"test -f {RSYSLOG_CFG_FILENAME} && cat {RSYSLOG_CFG_FILENAME}\"\n proc = self.ssh(cmd, account='ivxv-admin', stdout=subprocess.PIPE)\n existing_rsyslog_cfg = proc.stdout.decode()\n\n # don't replace file if not required\n if rsyslog_cfg == existing_rsyslog_cfg:\n self.log.info(\n \"Rsyslog config file %r already exist with required content\",\n RSYSLOG_CFG_FILENAME,\n )\n return True\n\n # write config file\n temp_file = tempfile.NamedTemporaryFile(delete=False)\n temp_file.write(bytes(rsyslog_cfg, 'UTF-8'))\n temp_file.close()\n if not self.scp(\n local_path=[temp_file.name],\n remote_path='/etc/ivxv/ivxv-logging.conf',\n description='logging configuration file',\n account='ivxv-admin'):\n return False\n os.unlink(temp_file.name)\n\n # restart rsyslog service\n proc = self.ssh(\n 'sudo ivxv-admin-sudo rsyslog-config-apply', account='ivxv-admin')\n\n if proc.returncode:\n self.log.info('Failed to restart rsyslog server in service host')\n return False\n\n self.log.info('Logging configuration for service created successfully')\n return True\n\n def load_apply_state(self, filepath, attempt_no=0):\n \"\"\"Load config applying state from state file.\n\n :return: Attempt number\n :rtype: int\n \"\"\"\n self.cfg_state_filepath = filepath\n with open(filepath) as fp:\n self.cfg_state = json.load(fp)\n\n if not attempt_no:\n self.cfg_state['attempts'] += 1\n self.cfg_state['log'].append([])\n attempt_no = self.cfg_state['attempts']\n assert attempt_no == self.cfg_state['attempts']\n assert attempt_no <= len(self.cfg_state['log'])\n self.update_apply_state()\n\n return attempt_no\n\n def update_apply_state(self, **kw):\n \"\"\"Update config applying state file.\"\"\"\n self.cfg_state.update(kw)\n self.cfg_state[\"log\"][-1] = list(self.get_log_buffer())\n tmp_filepath = f\"{self.cfg_state_filepath}.tmp\"\n with open(tmp_filepath, 'x') as fp:\n json.dump(self.cfg_state, fp, indent=4, sort_keys=True)\n shutil.move(tmp_filepath, self.cfg_state_filepath)\n\n def apply_tech_cfg(self, cfg_ver, tech_cfg):\n \"\"\"Apply collector technical config to service.\n\n :return: True on success, False on error.\n :rtype: bool\n \"\"\"\n self.update_apply_state()\n\n # install service package to service host\n if not self.install_service():\n return False\n self.update_apply_state()\n\n # configure service logging\n if self.service_type != 'log' and not self.configure_logging(tech_cfg):\n return False\n self.update_apply_state()\n\n # mark services that does not require config packages as CONFIGURED\n # after install\n if not SERVICE_TYPE_PARAMS[self.service_type]['require_config']:\n self.register_cfg_version(\n 'technical', cfg_ver, SERVICE_STATE_CONFIGURED)\n install_backup_crontab()\n return True\n\n # create data directory for service\n proc = self.ssh(f'mkdir --verbose --parents {self.service_data_dir}')\n if proc.returncode:\n self.log.error('Failed to generate service data directory')\n return False\n self.update_apply_state()\n\n # apply trust root config to service\n self.log.info('Applying trust root config to service')\n if not self.copy_cfg_to_service('trust'):\n self.log.error('Failed to apply trust root config to service')\n return False\n self.log.info('Trust root config successfully applied to service')\n self.update_apply_state()\n\n # apply technical config to service\n self.log.info('Applying technical config to service')\n if not self.copy_cfg_to_service('technical'):\n self.log.error('Failed to apply technical config to service')\n return False\n self.update_apply_state()\n\n # notify service about config change\n with IVXVManagerDb() as db:\n election_cfg_ver = db.get_value(\n self.get_db_key('election-conf-version'))\n if election_cfg_ver and not self.restart_service():\n return False\n self.log.info('Technical config successfully applied to service')\n self.update_apply_state()\n\n # detect service current state\n with IVXVManagerDb() as db:\n service_old_state = db.get_value(self.get_db_key('state'))\n\n # register config version (and new service state for NOT INSTALLED\n # service) in management database\n self.register_cfg_version(\n 'technical', cfg_ver,\n SERVICE_STATE_INSTALLED\n if service_old_state == SERVICE_STATE_NOT_INSTALLED\n else None\n )\n\n return True\n\n def apply_election_cfg(self, cfg_ver):\n \"\"\"Apply elections config to service.\n\n :return: True on success, False on error.\n :rtype: bool\n \"\"\"\n # detect service state\n with IVXVManagerDb() as db:\n state = db.get_all_values('service')\n\n # service issues must be fixed before installing first election config\n if not state[self.service_id]['election-conf-version']:\n state = {self.service_id: state[self.service_id]}\n generate_service_hints(state)\n if state[self.service_id].get('bg_info') not in [\n None, 'Apply election config'\n ]:\n self.log.error('Cannot apply election config: %s',\n state[self.service_id].get('bg_info'))\n return False\n del state\n\n self.log.info('Applying election config to service')\n if not self.copy_cfg_to_service('election'):\n return False\n self.update_apply_state()\n\n # enable service systemd unit if first config is loaded\n self.log.info('Enabling systemd unit')\n cmd = f'systemctl enable --user {self.service_systemctl_id}'\n proc = self.ssh(cmd)\n if proc.returncode:\n self.log.error('Failed to enable systemd unit')\n return False\n self.update_apply_state()\n\n # register config version and service state in management database\n self.register_cfg_version(\n 'election', cfg_ver, SERVICE_STATE_CONFIGURED)\n\n # notify service about config change\n if not self.restart_service():\n return False\n self.update_apply_state()\n\n # install crontab for automatic backups\n if self.service_type == 'voting':\n install_backup_crontab()\n\n return True\n\n def apply_list(self, list_type, changeset_no=None):\n \"\"\"Apply choices list to service.\n\n :param list_type: List type (choices, voters)\n :type list_type: str\n :param changeset_no: Changeset number for voter list\n :type changeset_no: int\n :return: True on success, False on error.\n :rtype: bool\n \"\"\"\n # apply list\n self.log.info('Applying %s list to service', list_type)\n if not self.copy_cfg_to_service(list_type, changeset_no):\n self.log.error('Failed to apply %s list to service', list_type)\n return False\n self.update_apply_state()\n\n # register list version\n with IVXVManagerDb(for_update=True) as db:\n if list_type in [\"choices\", \"districts\"]:\n cfg_ver = db.get_value(f\"list/{list_type}\")\n self.log.info(\n \"Registering applied %s list version %r in management database\",\n list_type,\n cfg_ver,\n )\n db.set_value(f\"list/{list_type}-loaded\", cfg_ver)\n else:\n assert list_type == \"voters\"\n cfg_ver = db.get_value(f\"list/voters{changeset_no:04}\")\n self.log.info(\n \"Registering applied voters list #%d \"\n \"version %r in management database\",\n changeset_no,\n cfg_ver,\n )\n db.set_value(f\"list/voters{changeset_no:04}-state\", \"APPLIED\")\n\n self.log.info('%s list applied successfully to service',\n list_type.capitalize())\n return True\n\n def load_secret_file(self, secret_type, filepath, checksum):\n \"\"\"Load secret key file to service and register file checksum.\n\n :param secret_type: Secret type\n :type secret_type: str\n :param filepath: Source file path\n :type filepath: str\n :param checksum: File checksum\n :type checksum: str\n :return: True on success, False on error.\n :rtype: bool\n \"\"\"\n secret_descr = SERVICE_SECRET_TYPES[secret_type]['description']\n target_path = (SERVICE_SECRET_TYPES[secret_type]['target-path']\n .format(service_id=self.service_id))\n shared_sercet = SERVICE_SECRET_TYPES[secret_type]['shared']\n file_mode = '0640' if shared_sercet else '0600'\n remote_account = ('ivxv-admin' if shared_sercet\n else self.service_account_name)\n\n # copy file to service host\n self.log.info('Loading %s to service', secret_descr)\n if not self.scp(\n local_path=[filepath],\n remote_path=target_path,\n account=remote_account,\n description=secret_descr):\n return False\n\n # set file permissions\n proc = self.ssh(\n f'chmod --changes {file_mode} {target_path}',\n account=remote_account)\n if proc.returncode:\n self.log.error('Failed to set %s file permissions '\n 'in service host', secret_descr)\n return False\n\n # register key checksum\n with IVXVManagerDb(for_update=True) as db:\n self.log.info(\n 'Registering loaded %s checksum in management database',\n secret_descr)\n db.set_value(\n self.get_db_key(SERVICE_SECRET_TYPES[secret_type]['db-key']),\n checksum)\n\n self.log.info('%s loaded successfully to service', secret_descr)\n\n # restart service\n return self.restart_service()\n\n def copy_cfg_to_service(self, cfg_type, changeset_no=None):\n \"\"\"Copy config to service host and reload service if needed.\n\n :param cfg_type: Config type\n (trust, technical, elections, choices, voters)\n :type cfg_type: str\n :param changeset_no: Changeset number for voter list\n :type changeset_no: int\n :return: True on success, False on error.\n :rtype: bool\n \"\"\"\n # copy config to host\n cfg_filename_suffix = f\"{changeset_no:04}\" if cfg_type == \"voters\" else \"\"\n cfg_filename_ext = \"zip\" if changeset_no else \"bdoc\"\n cfg_filename = f\"{cfg_type}{cfg_filename_suffix}.{cfg_filename_ext}\"\n cfg_filepath = cfg_path('active_config_files_path', cfg_filename)\n target_path = f'/etc/ivxv/{cfg_filename}'\n if not self.scp(\n local_path=[cfg_filepath],\n remote_path=target_path,\n account='ivxv-admin',\n description=f'{cfg_type} config'):\n return False\n\n # set config file permissions\n self.log.info('Set %s config file permissions in service host',\n cfg_type)\n cmd = ['chmod', '--changes', '0640', target_path]\n proc = self.ssh(cmd, account='ivxv-admin')\n if proc.returncode:\n self.log.error('Failed to set %s config file permissions '\n 'in service host', cfg_type)\n return False\n\n # notify choices service about list change\n list_change_util = {\n 'choices': 'ivxv-choiceimp',\n 'districts': 'ivxv-districtimp',\n 'voters': 'ivxv-voterimp'\n }.get(cfg_type)\n if list_change_util:\n self.log.info('Notify service about %s list change', cfg_type)\n cmd = [list_change_util, '-instance', self.service_id, target_path]\n proc = self.ssh(cmd)\n if proc.returncode:\n self.log.info('Failed to notify service about %s list change',\n cfg_type)\n return False\n\n return True\n\n def register_cfg_version(self, cfg_type, cfg_ver, service_state):\n \"\"\"Register config version and service state in database.\"\"\"\n with IVXVManagerDb(for_update=True) as db:\n self.log.info(\n \"Registering %s config version %r in management database\",\n cfg_type,\n cfg_ver,\n )\n db.set_value(\n self.get_db_key(f\"{cfg_type}-conf-version\"), cfg_ver)\n\n if service_state is not None:\n self.register_state(db, service_state)\n\n def register_state(self, db, state, bg_info=None):\n \"\"\"Register service state in database.\"\"\"\n last_state = db.get_value(self.get_db_key('state'))\n if state == last_state:\n self.log.info(\"Service state %r not changed\", state)\n return\n\n # set background info\n if state in SERVICE_STATE_CONFIGURED:\n bg_info = ''\n if bg_info is not None:\n db.set_value(self.get_db_key('bg_info'), bg_info, safe=True)\n\n # set service state\n self.log.info(\n \"Registering service state as %r \"\n \"in management database (last state: %r)\",\n state,\n last_state,\n )\n db.set_value(self.get_db_key('state'), state, safe=True)\n self.register_event(\n 'SERVICE_STATE_CHANGE',\n params={\n 'state': state,\n 'last_state': last_state\n })\n\n def ping(self):\n \"\"\"Ping service.\n\n :return: True on success, False on error.\n :rtype: bool\n \"\"\"\n self.log.debug('Pinging service')\n\n # query service status\n cfg_check_enabled = False\n if self.service_type == 'backup':\n ping_cmd = 'true'\n elif self.service_type == 'log':\n ping_cmd = 'systemctl status rsyslog'\n else:\n ping_cmd = 'env LC_ALL=C systemctl status --user {}'.format(\n self.service_systemctl_id)\n cfg_check_enabled = True\n ping_proc = self.ssh(\n ping_cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE)\n\n if not ping_proc.returncode:\n if cfg_check_enabled:\n try:\n self._verify_cfg_version()\n except LookupError as err:\n self.register_bg_info(str(err))\n self.log.error('Failed to detect service status')\n return False\n self.register_bg_info('')\n self.log.debug('Service is alive')\n return True\n\n # return without config check\n cmd_err_output = ping_proc.stderr.decode('UTF-8').strip()\n if not cfg_check_enabled or cmd_err_output:\n self.register_bg_info(\n 'Ping error: {}'.format(\n cmd_err_output or\n ping_proc.stdout.decode('UTF-8').strip() or\n f\"Command {' '.join(ping_cmd)!r} failed\"))\n self.log.error('Pinging service failed')\n return False\n\n # check service config\n cfg_check_cmd = [\n 'ivxv-admin-helper', 'check-service-config', self.service_type,\n self.service_id\n ]\n cfg_check_proc = self.ssh(\n cfg_check_cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE)\n if cfg_check_proc.returncode == 0: # valid config\n self.register_bg_info(\n 'Ping error: {}'.format(\n ping_proc.stdout.decode('UTF-8').strip() or\n f\"Command {' '.join(ping_cmd)!r} failed\"))\n self.log.error('Pinging service failed')\n else: # invalid config\n self.register_bg_info(\n 'Ping error: Invalid config: {}'.format(\n cfg_check_proc.stderr.decode('UTF-8').strip() or\n cfg_check_proc.stdout.decode('UTF-8').strip()))\n self.log.error('Pinging service failed (invalid configuration)')\n\n return False\n\n def _get_cfg_versions_from_service(self):\n \"\"\"Get config versions from service.\n\n Service version data is provided by commands:\n\n * ``systemctl show`` - trust, technical and election config\n * ``ivxv-choiceimp`` - choices list\n * ``ivxv-districtimp`` - districts list\n * ``ivxv-voterimp`` - voters lists\n\n :raises LookupError: if some internal check fails\n \"\"\"\n cfg_versions = {\n 'service_state': {},\n 'choices_list_versions': [],\n 'districts_list_versions': [],\n 'voters_lists_versions': [],\n }\n\n # query status text for trust, technical and election config\n cmd = ('systemctl --user show --property StatusText '\n f'{self.service_systemctl_id}')\n proc = self.ssh(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE)\n if proc.returncode:\n raise LookupError(\n 'Error while querying service status text: {}'.format(\n proc.stderr.decode('UTF-8')))\n status_text = proc.stdout.decode('UTF-8')\n\n # parse status\n re_pattern = re.compile(r'StatusText=(.+)')\n if not re_pattern.match(status_text):\n raise LookupError(f'Invalid service state text: {status_text}')\n state_json = re_pattern.sub('\\\\1', status_text)\n try:\n cfg_versions['service_state'] = json.loads(state_json)\n except json.decoder.JSONDecodeError as err:\n raise LookupError(\n f'Error while decoding JSON data from service state: {err}. '\n f'JSON: {state_json}')\n self.log.debug('Service internal status: %s',\n cfg_versions['service_state']['Status'])\n\n # query status text for choices and districts list\n if self.service_type == 'choices':\n for cfg_type in [\"choices\", \"districts\"]:\n utility = f\"ivxv-{cfg_type[:-1]}imp\"\n cmd = f\"{utility} --check version --instance {self.service_id}\"\n proc = self.ssh(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE)\n if proc.returncode:\n raise LookupError(\n f\"Error while querying {cfg_type} list version: \"\n f\"{proc.stderr.decode('UTF-8')}\"\n )\n status_text = proc.stdout.decode(\"UTF-8\")\n try:\n list_versions = json.loads(status_text) if status_text else []\n assert isinstance(list_versions, list)\n except json.decoder.JSONDecodeError as err:\n raise LookupError(\n \"Error while decoding JSON data from service state: \"\n f\"{err}. JSON: {status_text}\"\n )\n\n # query status text for voters lists\n elif self.service_type == 'voting':\n cmd = (\n f'ivxv-voterimp --check version --instance {self.service_id}')\n proc = self.ssh(\n cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE)\n if proc.returncode:\n raise LookupError(\n 'Error while querying voters list versions: {}'.format(\n proc.stderr.decode('UTF-8')))\n status_text = proc.stdout.decode('UTF-8')\n try:\n cfg_versions['voters_lists_versions'] = (\n json.loads(status_text) if status_text else [])\n assert isinstance(cfg_versions['voters_lists_versions'], list)\n except json.decoder.JSONDecodeError as err:\n raise LookupError(\n 'Error while decoding JSON data from service state: '\n f'{err}. JSON: {status_text}')\n\n return cfg_versions\n\n def _verify_cfg_version(self):\n \"\"\"Verify config version.\n\n Compare config version data provided by service and version in\n management database.\n\n :return: Message to register in service background info\n :raises LookupError: if some internal check fails\n \"\"\"\n cfg_versions = self._get_cfg_versions_from_service()\n version_in_db = None\n with IVXVManagerDb() as db:\n for cfg_type in 'trust', 'technical', 'election':\n db_key = (\n 'config/trust' if cfg_type == 'trust' else\n self.get_db_key(f'{cfg_type}-conf-version'))\n version_in_db = db.get_value(db_key)\n versions_in_service = cfg_versions['service_state']['Version'][\n cfg_type.capitalize()]\n if version_in_db not in versions_in_service:\n raise LookupError(\n f\"{cfg_type.capitalize()} config version \"\n \"in service status info \"\n f\"does not contain version {version_in_db!r} \"\n \"registered in management database. \"\n f\"Service status info: {versions_in_service}\"\n )\n for list_type in [\"choices\", \"districts\"]:\n versions_in_service = cfg_versions[f\"{list_type}_list_versions\"]\n if versions_in_service:\n version_in_db = db.get_value(f\"list/{list_type}\")\n if version_in_db not in versions_in_service:\n raise LookupError(\n f\"{list_type.capitalize()} list version \"\n \"in service status info \"\n f\"does not contain version {version_in_db!r} \"\n \"as registered in management database. \"\n \"Choices list versions in services: \"\n f\"{versions_in_service}\"\n )\n\n version_lists_in_service = cfg_versions['voters_lists_versions']\n if version_lists_in_service:\n for changeset_no in range(10_000):\n key = f\"list/voters{changeset_no:04d}-loaded\"\n try:\n version_in_db = db.get_value(key)\n except KeyError:\n break\n try:\n versions_in_service = version_lists_in_service[\n changeset_no - 1]\n except IndexError:\n raise LookupError(\n \"Service status info does not contain \"\n \"version info for voters list \"\n f\"#{changeset_no:04d}. \"\n \"Version for this list in management database \"\n f\"is {version_in_db!r}\"\n )\n if version_in_db not in versions_in_service:\n raise LookupError(\n f\"Voters list #{changeset_no:04d} version \"\n \"in service status info \"\n f\"does not contain version {version_in_db!r} \"\n \"as registered in management database. \"\n \"Voters list versions in services: \"\n f\"{versions_in_service}\"\n )\n\n def scp(self,\n local_path,\n remote_path,\n description,\n account=None,\n to_remote=True):\n \"\"\"Copy file using SCP protocol.\n\n :param local_path: Local file path(s)\n :type local_path: str or list of strings\n :param remote_path: Remote file path\n :type remote_path: str\n :param description: Description of files to copy (for logging)\n :type description: str\n :param account: Remote account name (None = default service account)\n :type account: str\n :param to_remote: Copy to remote host (True) or from remote host\n :type to_remote: bool\n :return: True on success, False on error.\n :rtype: bool\n \"\"\"\n if not isinstance(local_path, list):\n local_path = [local_path]\n assert to_remote or len(local_path) == 1\n remote_path = '{}@{}:{}'.format(account or self.service_account_name,\n self.hostname, remote_path)\n direction_str = 'to' if to_remote else 'from'\n\n # prepare command\n cmd = ['scp'] + (local_path + [remote_path]\n if to_remote else [remote_path] + local_path)\n\n # execute command\n self.log.info('Copying %s %s service host', description, direction_str)\n proc = exec_remote_cmd(cmd)\n\n # return results\n if proc.returncode:\n self.log.error('Failed to copy %s %s service host',\n description, direction_str)\n\n return proc.returncode == 0\n\n def ssh(self, cmd, account=None, fwd_auth_agent=False, **kw):\n \"\"\"Execute command in remote host.\n\n :param cmd: Command to execute\n :type cmd: str or list\n :param account: Remote account name\n :type account: str\n :param fwd_auth_agent: Start ssh with authentication agent forwarding\n :type fwd_auth_agent: bool\n :param kw: Command arguments\n\n :return: subprocess.CompletedProcess\n \"\"\"\n if not isinstance(cmd, list):\n cmd = [cmd]\n ssh_cmd = ['ssh', '-A'] if fwd_auth_agent else ['ssh']\n ssh_cmd.append(\n '{}@{}'.format(\n account or self.service_account_name, self.hostname))\n\n return exec_remote_cmd(ssh_cmd + cmd, **kw)\n\n def get_log_buffer(self):\n \"\"\"Get formatted log messages from log buffer.\"\"\"\n for rec in self.memory_log_handler.buffer:\n timestamp = datetime.datetime.fromtimestamp(rec.created).strftime(\n RFC3339_DATE_FORMAT_WO_FRACT\n )\n msg = rec.getMessage()\n yield f\"{timestamp} {msg}\"\n" }, { "path": "collector-admin/ivxv_admin/templates/ivxv_backup_crontab.jinja", "content": "{#\n\nIVXV Internet voting framework\n\nTemplate file for backup automation crontab.\n\n-#}\n# Crontab for IVXV Management Service backup automation\n\n# This file is managed by IVXV Management Service\n# Current version is generated @ {{ time_generated }}\n\n# This file is (re)generated automatically on the following events:\n#\n# - Backup service comes to configured state\n# - Any of voting service instances comes to configured state\n# - Any of log collectors comes to configured state\n#\n# This file is removed automatically on the following events:\n#\n# - Management database is initialized\n\n{% if not configured_backup_services %}\n# Backup service is NOT CONFIGURED\n{% else %}\n# Backup service is configured\n# Configured voting services: {{ configured_voting_services }}\n# Configured log collectors: {{ configured_log_collectors }}\n\n{% for hour, minute in backup_times -%}\n\n# @ {{ \"%02d\"|format(hour) }}:{{ \"%02d\"|format(minute) }}\n {%- if configured_backup_services %}\n{{ minute }} {{ hour }} * * * ivxv-backup management-conf\n {%- endif -%}\n {%- if configured_voting_services %}\n{{ minute }} {{ hour }} * * * ivxv-backup ballot-box\n {%- endif -%}\n {%- if configured_log_collectors %}\n{{ minute }} {{ hour }} * * * ivxv-backup log\n {%- endif %}\n\n{% endfor -%}\n{% endif %}\n{#-\nvim:ft=jinja:\n#}\n" }, { "path": "collector-admin/ivxv_admin/templates/ivxv_detail_stats_crontab.jinja", "content": "{#\n\nIVXV Internet voting framework\n\nCrontab template file to automate detail statistics export to VIS.\n\n-#}\n# Crontab for IVXV Management Service detail statistics export to VIS automation\n\n# This file is managed by IVXV Management Service\n# Current version is generated @ {{ time_generated }}\n\n# This file is (re)generated automatically on the following events:\n#\n# - `ivxv-cmd-load election `\n#\n# This file is removed automatically on the following events:\n#\n# - `ivxv-collector-init`\n\n# Import detail voting stats from voting service and export it to VIS\n{{ minute }} {{ hour }} {{ day }} {{ month }} {{ weekday }} if [ -x /usr/bin/ivxv-voterstats ]; then /usr/bin/ivxv-voterstats detail --log-level=WARNING; fi\n\n" }, { "path": "collector-admin/ivxv_admin/templates/ivxv_service_rsyslog_conf.jinja", "content": "{#\n\nIVXV Internet voting framework\n\nTemplate file for rsyslog config in service host.\n\n-#}\n# IVXV Internet voting framework\n\n# Rsyslog logging configuration file\n# {{ cfg_filepath }}\n\n# This file is automatically generated\n# by collector management service! DO NOT CHANGE!\n\n# load RELP output module\nmodule(load=\"omrelp\")\n\n# increase max message size\nglobal(maxMessageSize=\"32k\")\n\n# LOCAL LOGGING\n\n# write IVXV log to file (up to level INFO)\nif ($programname startswith 'ivxv-') and ($syslogfacility-text == 'local0') and\n ($syslogseverity <= '6') then\naction(\n type=\"omfile\"\n dynaFile=\"IVXV_DEFAULT_LOG_FILENAME\"\n template=\"ivxv-json\"\n)\n\n# write IVXV request log to /var/log/ivxv/ivxv-request-YYYY-MM-DD-HH.log\nif ($programname startswith 'ivxv-') and ($syslogfacility-text == 'local1') then\naction(\n type=\"omfile\"\n dynaFile=\"IVXV_REQUEST_LOG_FILENAME\"\n)\n\n# write IVXV debug log and log of related\n# services (haproxy, etcd, rsyslog, sshd) to /var/log/ivxv/ivxv-debug-YYYY-MM-DD-HH.log\nif ($programname startswith 'ivxv-') or ($programname startswith 'rsyslog') or\n ($programname == 'haproxy') or ($programname == 'sshd') or ($programname == 'etcd') then\naction(\n type=\"omfile\"\n dynaFile=\"IVXV_DEBUG_LOG_FILENAME\"\n)\n\n\n# REMOTE LOGGING - log collector services\n{% for log_collector in log_collectors %}\n# forward log messages to log collector \"{{ log_collector.id }}\" using RELP protocol\naction(\n type=\"omrelp\"\n target=\"{{ log_collector.address }}\"\n port=\"{{ log_collector.port }}\"\n)\n{% else %}\n# --- no log collectors defined ---\n{% endfor %}\n\n# REMOTE LOGGING - Log Monitor and other external log collectors\n{% if ext_log_collectors %}\n{% for log_collector in ext_log_collectors -%}\n{% if loop.index == 1 %}\n# forward log messages to Log Monitor using RELP protocol\nif ($programname startswith 'ivxv-') and ($syslogfacility-text == 'local0') and\n ($syslogseverity <= '6') then\n{% else %}\n# forward log messages to external log collector using RELP protocol\n{% endif -%}\naction(\n type=\"omrelp\"\n target=\"{{ log_collector.address }}\"\n port=\"{{ log_collector.port }}\"\n)\n{% endfor %}\n{% else %}\n# --- no log montitors defined ---\n{% endif %}\n{#-\nvim:ft=jinja:\n#}\n" }, { "path": "collector-admin/ivxv_admin/templates/ivxv_status.jinja", "content": "{#\n\nIVXV Internet voting framework\n\nTemplate file for ivxv-status utility output.\n\n-#}\n{# COLLECTOR #}\n{% if 'collector' in sections %}\nCollector state: {{ collector_state }}\n{% endif %}\n\n{# ELECTION #}\n{% if 'election' in sections %}\nElection ID: {{ election['election-id'] or '-' }}\nVoting period config:\n Service start: {{ election['servicestart'] or '-' }}\n Service end: {{ election['servicestop'] or '-' }}\n Verification end: {{ election['verificationstop'] or '-' }}\n Election start: {{ election['electionstart'] or '-' }}\n Election stop: {{ election['electionstop'] or '-' }}\nVoting phase: {{ election['phase'] or '-' }}\n Phase start: {{ election['phase-start'] or '-' }}\n Phase end: {{ election['phase-end'] or '-' }}\n{% endif %}\n\n{# CONFIG #}\n{% if 'config' in sections %}\nConfig state:\n Trust root config: {{ config.trust or '-' }}\n Technical config: {{ config.technical or '-' }}\n Election config: {{ config.election or '-' }}\n{% endif %}\n\n{# LIST #}\n{% if 'list' in sections %}\nLists state:\n Choices list: {{ list.choices or '-' }}\n{%- if list.choices %}\n Choices list state: {{ list.choices == list['choices-loaded'] and\n 'LOADED TO SERVICE' or 'PENDING' }}\n{% endif %}\n Districts list: {{ list.districts or '-' }}\n{%- if list.districts %}\n Districts list state: {{ list.districts == list['districts-loaded'] and\n 'LOADED TO SERVICE' or 'PENDING' }}\n{% endif %}\n Voters lists: {{ list['voters-list-total']\n }} [ APPLIED {{ list['voters-list-applied']\n }} ; PENDING {{ list['voters-list-pending']\n }} ; INVALID {{ list['voters-list-invalid']\n }} ; SKIPPED {{ list['voters-list-skipped']\n }} ]\n{%- if not list['voters0000'] %}\n [No voter lists loaded]\n{% else %}\n{%- set ns = namespace(changeset_no=0) %}\n{%- for key in list if key.startswith('voters') and key.endswith('-state') %}\n {% set ns.changeset_no = ns.changeset_no + 1 -%}\n {% set prefix = key|replace('-state', '') -%}\n {{ ns.changeset_no }}. {{ \"%-7s\"|format(list[prefix + '-state']) }} {{ list[prefix] }}\n{%- endfor %}\n{%- endif %}\n{% endif %}\n\n{# SERVICE #}\n{% if 'service' in sections %}\nServices: {{ service|count }} services in {{ network|count }} network(s)\n{%- for network_name in network|sort %}\n Service network: {{ network_name }}, {{\n network[network_name]|count }} service(s)\n{%- for service_id in network[network_name]|sort %}\n{% set service = network[network_name][service_id] %}\n Service ID: {{ service_id }}\n Type: {{ service['service-type'] }}\n State: {{ service['state'] }}\n Address: {{ service['ip-address'] }}\n Technical config: {{ service['technical-conf-version']\n or '-' }}\n{%- if service['service-type'] not in ['backup', 'log'] %}\n Election config: {{ service['election-conf-version']\n or '-' }}\n{%- endif %}\n{%- if service['service-type'] == 'backup' %}\n Automatic backup times: {{ service['backup-times'] or '-' }}\n{%- endif %}\n{%- if 'tls-key' in service %}\n Service TLS key: {{ service['tls-key'] or '-' }}\n Service TLS certificate: {{ service['tls-cert'] or '-' }}\n{%- endif %}\n{%- if 'mid-token-key' in service %}\n Mobile-ID/Smart-ID/Web eID identity token key: {{ service['mid-token-key'] or '-' }}\n{%- endif %}\n{%- if 'tspreg-key' in service %}\n PKIX TSP registration key: {{ service['tspreg-key'] or '-' }}\n{%- endif %}\n Last data received: {{ service['last-data'] or '-' }}\n Background info: {{ service['bg_info'] or '-' }}\n{% endfor %}\n{% endfor %}\n{% endif -%}\n\n{# STORAGE #}\n{% if 'storage' in sections %}\nData storage:\n Software packages: {{ storage.debs_exists|count }} exists, {{\n storage.debs_missing|count }} missing\n{%- if storage.debs_missing %}\n Missing packages:\n{%- for pkg in storage.debs_missing %}\n {{ pkg }}\n{%- endfor %}\n{%- endif %}\n Users count: {{ user|count }}\n Commands: {{\n storage.command_files_active|count + storage.command_files_inactive|count }} loaded ({{\n storage.command_files_active|count }} active, {{\n storage.command_files_inactive|count }} inactive)\n Active commands:\n {%- for command_file in storage.command_files_active %}\n {{ loop.index }}. {{ command_file }}\n {%- endfor %}\n Inactive commands:\n {%- for command_file in storage.command_files_inactive %}\n {{ loop.index }}. {{ command_file }}\n {%- endfor %}\n{% endif %}\n{#-\nvim:ft=jinja:\n#}\n" }, { "path": "collector-admin/ivxv_admin/templates/ivxv_voting_facts_crontab.jinja", "content": "{#\n\nIVXV Internet voting framework\n\nCrontab template file to automate ivxv-storageorder tool.\n\n-#}\n# Crontab for IVXV Management Service ivxv-storageorder automation\n\n# This file is managed by IVXV Management Service\n# Current version is generated @ {{ time_generated }}\n\n# This file is (re)generated automatically on the following events:\n#\n# - `ivxv-cmd-load election `\n#\n# This file is removed automatically on the following events:\n#\n# - `ivxv-collector-init`\n\n# Generate .csv file from Logmonitor logs of failed voting facts and run ivxv-storageorder on first active Collector host\n{{ minute }} {{ hour }} {{ day }} {{ month }} {{ weekday }} if [ -x /usr/bin/ivxv-voting-facts ]; then /usr/bin/ivxv-voting-facts; fi\n\n" }, { "path": "collector-admin/ivxv_admin/templates/stats.json", "content": "{\n \"data\": {\n \"TOTAL\": {\n \"age_group_16-17\": 0,\n \"age_group_18-24\": 0,\n \"age_group_25-34\": 0,\n \"age_group_35-44\": 0,\n \"age_group_45-54\": 0,\n \"age_group_55-64\": 0,\n \"age_group_65-74\": 0,\n \"age_group_75plus\": 0,\n \"authentication-methods\": [],\n \"voting-operating-systems\": [],\n \"verify-operating-systems\": [],\n \"revoters-2-times\": 0,\n \"revoters-3-times\": 0,\n \"revoters-more-than-3-times\": 0,\n \"revoters-total\": 0,\n \"revotes-from-changed-ip\": 0,\n \"revotes-with-different-card\": 0,\n \"top-10-revoters\": [],\n \"total-checkers\": 0,\n \"total-voters\": 0,\n \"total-votes-checked\": 0,\n \"total-votes-collected\": 0,\n \"votes-by-country\": [],\n \"voters-females\": 0,\n \"voters-males\": 0\n }\n },\n \"meta\": {\n \"generator\": \"IVXV Management Service Agent Daemon\",\n \"time_generated\": \"2017-09-01T00:00:00\"\n },\n \"error\": \"IVXV Agent Daemon has not generated statistics. This is a default placeholder stats file from IVXV Collector Management Service package\"\n}\n" }, { "path": "collector-admin/ivxv_admin/wsgi.py", "content": "# IVXV Internet voting framework\n\"\"\"\nWSGI application for collector management service.\n\nDefault path for application is \"/ivxv/cgi/\"\n\"\"\"\n\nimport datetime\nimport json\nimport logging\nimport os\nimport re\nimport urllib\nimport urllib.request\n\nimport bottle\nfrom bottle import request, response\n\nfrom . import (\n COLLECTOR_STATE_CONFIGURED,\n COLLECTOR_STATE_FAILURE,\n COLLECTOR_STATE_INSTALLED,\n COLLECTOR_STATE_NOT_INSTALLED,\n COLLECTOR_STATE_PARTIAL_FAILURE,\n EVENT_LOG_FILENAME,\n MANAGEMENT_DAEMON_URL,\n USER_ROLES,\n __version__,\n)\nfrom .config import CONFIG, cfg_path\n\nFILE_UPLOAD_PATH = CONFIG['file_upload_path']\n\nAPP = bottle.Bottle()\n#: Default value for \"Expires\" header (don't allow to cache responses)\nEXPIRES_DEFAULT = datetime.datetime(1970, 1, 1)\n\nlog = logging.getLogger(__name__)\n\n\ndef abort(code=500, text='Unknown Error.'):\n \"\"\"\n Abort execution and raise a HTTP error.\n\n :raises bottle.HTTPResponse:\n \"\"\"\n body = json.dumps(dict(message=text))\n raise bottle.HTTPResponse(\n body, code, headers={'content_type': 'application/json'})\n\n\n@APP.hook('before_request')\ndef log_query():\n \"\"\"Log query data.\"\"\"\n log.info('%s %s', request.method, request.urlparts.path)\n if request.forms:\n log.info('POST params: %s', dict(request.forms))\n for key, fileobj in request.files.items():\n log.info(\"FILE: field %r, filename %r\", key, fileobj.raw_filename)\n\n\n@APP.route('/context.json')\ndef context():\n \"\"\"\n Output context data (logged in user, collector state).\n\n :return: Context data as JSON\n :rtype: str\n \"\"\"\n # read user information from Apache environment\n user_cn = request.environ.get('SSL_CLIENT_S_DN_CN')\n assert user_cn\n assert ',' in user_cn\n\n # parse user information\n surname, name, idcode = user_cn.split(',')\n user_data = {\n 'cn': user_cn,\n 'user_name': f'{name} {surname}',\n 'idcode': idcode,\n 'role': [],\n 'role-description': [],\n 'permissions': [],\n }\n\n # detect user role\n for role in sorted(USER_ROLES):\n access_filename = cfg_path(\n 'permissions_path', '-'.join([user_cn, role]))\n if os.path.exists(access_filename):\n user_data['role'].append(role)\n user_data['role-description'].append(\n USER_ROLES[role]['description'])\n user_data['permissions'] += USER_ROLES[role]['permissions']\n\n # prepare context data\n if not user_data['role']:\n context_data = {}\n user_data.update({\n 'role': ['none'],\n 'role-description': [USER_ROLES['none']['description']],\n 'permissions': USER_ROLES['none']['permissions'],\n })\n else:\n filepath = cfg_path('admin_ui_data_path', 'status.json')\n with open(filepath) as ifp:\n state_json = json.load(ifp)\n context_data = {\n 'collector': state_json['collector'],\n 'election': {\n 'id': state_json['election']['election-id'],\n 'stage': state_json['election']['phase']\n }\n }\n context_data[\"collector\"][\"version\"] = __version__\n user_data['permissions'] = sorted(set(user_data['permissions']))\n context_data['current-user'] = user_data\n\n if 'collector' in context_data:\n state_info = {\n COLLECTOR_STATE_NOT_INSTALLED: ['Paigaldamata', 'info'],\n COLLECTOR_STATE_INSTALLED: ['Paigaldatud', 'info'],\n COLLECTOR_STATE_CONFIGURED: ['Seadistatud', 'success'],\n COLLECTOR_STATE_FAILURE: ['Tõrge', 'danger'],\n COLLECTOR_STATE_PARTIAL_FAILURE: ['Osaline tõrge', 'danger'],\n }\n state = context_data['collector']['state']\n context_data['collector'].update({\n 'state-description': state_info[state][0],\n 'state-indication': state_info[state][1],\n })\n\n # start response\n response.content_type = 'application/json'\n response.expires = EXPIRES_DEFAULT\n return json.dumps({'data': context_data})\n\n\n@APP.post('/download-ballot-box')\n@APP.post('/download-consolidated-ballot-box')\n@APP.post('/skip-voters-list')\n@APP.post('/download-voter-detail-stats')\n@APP.post('/download-voting-sessions')\n@APP.post('/download-processor-input')\ndef fwd_request():\n \"\"\"Forward request to IVXV Management Service Daemon.\"\"\"\n path = request.fullpath.split('/')[-1]\n daemon_url = MANAGEMENT_DAEMON_URL + path\n\n data = urllib.parse.urlencode(request.forms).encode(\"UTF-8\")\n fwd_request = urllib.request.Request(daemon_url, data=data, method=\"GET\")\n max_response_size = 1024 * 1024 * 1024 # 1GB\n with urllib.request.urlopen(fwd_request) as req_fp:\n daemon_response = req_fp.read(max_response_size)\n if len(daemon_response) == max_response_size:\n response.content_type = \"application/json\"\n return json.dumps(\n {\n \"success\": False,\n \"message\": f\"Vastus on suurem kui {max_response_size} baiti\",\n }\n )\n response.content_type = req_fp.headers[\"Content-Type\"] or \"application/json\"\n for header in [\"Content-Length\", \"Content-Disposition\"]:\n if req_fp.headers[header]:\n response.set_header(header, req_fp.headers[header])\n\n # start response\n response.expires = EXPIRES_DEFAULT\n return daemon_response\n\n\n@APP.post('/upload-config')\ndef upload_cfg():\n \"\"\"\n Upload command file.\n\n Command file is a digitally signed file that contains one of the following\n commands:\n\n 1. User management command (add, change role)\n 2. Collector config command (contains config file or voting list)\n \"\"\"\n upload = request.files.get('upload')\n if upload is None:\n abort(400, 'Üleslaaditav fail on määramata')\n\n # save file to local directory\n assert os.path.isdir(FILE_UPLOAD_PATH)\n filename = '-'.join(\n [datetime.datetime.now().strftime('%s.%f'), upload.filename])\n file_path = os.path.join(FILE_UPLOAD_PATH, filename)\n upload.save(file_path)\n\n # forward command to management daemon\n daemon_url = MANAGEMENT_DAEMON_URL + 'upload-command'\n post_data = urllib.parse.urlencode({\n 'filename': filename,\n 'original_filename': upload.filename,\n 'cmd_type': request.forms.get('type')\n })\n post_data = post_data.encode('UTF-8')\n with urllib.request.urlopen(daemon_url, post_data) as req_fp:\n daemon_response = req_fp.read()\n\n # start response\n response.content_type = 'application/json'\n response.expires = EXPIRES_DEFAULT\n return daemon_response\n\n\n@APP.route('/eventlog')\ndef eventlog():\n \"\"\"Convert Collector event log file to valid JSON.\n\n :return: Event log as JSON\n :rtype: str\n \"\"\"\n records = []\n filepath = cfg_path('ivxv_admin_data_path', EVENT_LOG_FILENAME)\n try:\n with open(filepath) as fp:\n while True:\n line = fp.readline()\n if not line:\n break\n records.append(json.loads(line))\n except OSError as err:\n log.error(err)\n abort(text=str(err))\n\n # start response\n response.content_type = 'application/json'\n response.expires = EXPIRES_DEFAULT\n return json.dumps({'data': records})\n\n\n@APP.route('/ballot-box-state')\ndef get_ballot_box_state():\n \"\"\"Output state of ballot boxes.\n\n :return: State as JSON\n :rtype: str\n \"\"\"\n state = []\n for filename in os.listdir(CONFIG['exported_votes_path']):\n if not filename.endswith('.log'):\n continue\n timestamp = datetime.datetime.strptime(\n re.sub(r'.+-(\\d.+).log', '\\\\1', filename),\n '%Y.%m.%d_%H.%M')\n filepath = os.path.join(CONFIG['exported_votes_path'], filename)\n with open(filepath) as fp:\n log_lines = fp.readlines()\n if len(log_lines) > 12:\n log_lines = log_lines[:6] + ['...\\n'] + log_lines[-6:]\n zip_filename = filename.replace('.log', '.zip')\n file_state = (\n 'ready'\n if 'Collected votes archive is written to' in log_lines[-1]\n else 'prepare')\n state.append({\n 'timestamp': timestamp.strftime('%d.%m.%Y %H:%M'),\n 'filename': zip_filename,\n 'state': file_state,\n 'log': ''.join(log_lines),\n })\n\n # start response\n response.content_type = 'application/json'\n response.expires = EXPIRES_DEFAULT\n return json.dumps({'data': state})\n" }, { "path": "collector-admin/site/cgi/ivxv-admin.wsgi", "content": "# IVXV Internet voting framework\n\"\"\"\nCollectors administrator interface\nWSGI application definition for Apache web server\n\"\"\"\n\nfrom ivxv_admin import wsgi\n\napplication = wsgi.APP\n" }, { "path": "collector-admin/site/index.html", "content": "\n\n\n\n \n IVXV Koguja haldusteenus\n \n\n\n\n Go to /ivxv/index.html\n\n\n" }, { "path": "collector-admin/site/ivxv/about.html", "content": "\n\n\n\n\n \n \n \n \n Tarkvara andmed – IVXV Kogumisteenuse haldusteenus\n \n \n \n \n \n \n \n \n\n\n\n
\n \n \n
\n\n
\n
\n

IVXV Kogumisteenuse haldusteenus

\n
\n \n
\n \n\n \n \n \n\n \n
\n
\n
\n
\n Viga!\n
\n
\n

Veateade

\n
\n
\n
\n \n
\n \n\n
\n
\n
\n
\n Versioon\n
\n
\n
Elektroonilise hääletamise infosüsteem IVXV.
\n
Kogumisteenuse haldusteenus.
\n
\n Versioon:\n 1.10.3\n
\n
\n
\n
\n \n
\n \n\n
\n
\n
\n
\n Kasutajaliides\n
\n
\n Haldusteenuse kasutajaliidese funktsioonid:\n \n
\n
\n
\n \n\n
\n
\n
\n Masinloetavad andmed\n
\n
\n Masinloetavad andmed (JSON):\n \n
\n
\n
\n \n
\n \n\n
\n
\n Kasutajaliidese ehitamiseks on kasutatud BootsTrap teemat\n SB\n Admin 2.\n
\n \n
\n \n\n
\n \n
\n \n\n \n \n \n \n \n \n \n \n \n \n \n \n\n\n\n" }, { "path": "collector-admin/site/ivxv/config.html", "content": "\n\n\n\n\n \n \n \n \n Seadistuste rakendamise seisund – IVXV Kogumisteenuse haldusteenus\n \n \n \n \n \n \n \n \n\n\n\n
\n \n \n
\n\n
\n
\n

Seadistuste rakendamise seisund

\n
\n \n
\n \n\n \n
\n
\n
\n
\n

Andmete laadimise seisund

\n
\n
\n
\n
\n \n\n \n
\n
\n
\n
\n Viga!\n
\n
\n

Veateade

\n
\n
\n
\n \n
\n \n\n
\n
\n
\n
\n Seadistuste üleslaadimine\n
\n
\n
\n
\n Faili üleslaadimise veateade\n
\n
\n
\n \n \n
\n
\n Seadistuse tüüp:\n \n
\n \n
\n
\n
\n
\n \n
\n \n
\n \n\n
\n \n
\n \n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n\n\n" }, { "path": "collector-admin/site/ivxv/downloads.html", "content": "\n\n\n\n\n \n \n \n \n Väljavõtete allalaadimised – IVXV Kogumisteenuse haldusteenus\n \n \n \n \n \n \n \n \n\n\n\n
\n \n \n
\n\n
\n
\n

Väljavõtete allalaadimised

\n
\n \n
\n \n\n \n \n \n\n \n
\n
\n
\n
\n Viga!\n
\n
\n

Veateade

\n
\n
\n
\n \n\n
\n \n\n \n
\n
\n
\n
\n Hoiatus!\n
\n
\n

Hoiatusteade

\n
\n
\n
\n \n\n
\n \n\n
\n
\n
\n
\n Hääletamise detailstatistika\n
\n
\n

\n Hääletamise detailstatistika koostatakse\n hääletusteenuses ja see on JSON-vormingus.\n

\n
\n \n
\n
\n
\n
\n \n\n
\n
\n
\n Hääletamise seansid\n
\n
\n

\n Hääletamise ja hääle kontrollimise seansside\n väljavõte koostatakse logiseire teenuses ja\n see on CSV-vormingus.\n

\n
\n
\n \n
\n
\n \n
\n
\n \n
\n \n
\n
\n
\n
\n \n
\n \n\n
\n
\n \n
\n \n\n
\n \n
\n \n
\n \n\n
\n
\n
\n
\n Töötlemisrakenduse sisendi alus\n
\n
\n

\n Töötlemisrakenduse sisendi alus on häälte\n töötlemiseks vajalike sisendfailide komplekt\n ZIP-vormingus konteinerina ja see koostatakse\n haldusteenuses.\n

\n
\n \n
\n
\n
\n
\n \n
\n \n\n
\n \n
\n \n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n\n\n" }, { "path": "collector-admin/site/ivxv/index.html", "content": "\n\n\n\n\n \n \n \n \n Üldseisund – IVXV Kogumisteenuse haldusteenus\n \n \n \n \n \n \n \n \n\n\n\n
\n \n \n
\n\n
\n
\n

Kogumisteenuse üldseisund

\n
\n \n
\n \n\n \n
\n
\n
\n
\n

Andmete laadimise seisund

\n
\n
\n
\n
\n \n\n \n
\n
\n
\n
\n Viga!\n
\n
\n

Veateade

\n
\n
\n
\n \n
\n \n\n
\n
\n
\n
\n
\n
\n
Valimiste identifikaator:
\n
 
\n
\n
\n
\n
\n
\n \n
\n
\n
\n
\n
\n
Kogumisteenuse seisund:
\n
\n
\n
\n
\n
\n
\n \n
\n
\n
\n
\n
\n
Käimasolev hääletusetapp:
\n
 
\n
\n
\n
\n
    \n
  • Algus: -
    • \n
  • Lõpp: -
    • \n
\n
\n
\n \n
\n
\n
\n
\n
\n
Valijanimekirjade uuendus on saadaval!
\n
\n
\n
\n \n
\n Vaata lähemalt\n \n
\n
\n \n
\n
\n \n
\n \n
\n
\n
\n
\n Haldusteenusesse laaditud seadistuste versioonid:\n
\n
    \n
  • Usaldusjuure seadistused: -
    • \n
  • Tehnilised seadistused: -
    • \n
  • Valimiste seadistused: -
    • \n
\n
\n \n
\n \n
\n
\n
\n Valimisnimekirjade seisundid ja versioonid:\n
\n
    \n
  • \n Valikute nimekiri:\n -
    • \n
  • \n Valikute nimekirja seisund:\n -
    • \n
  • \n Ringkondade nimekiri:\n -\n
    • \n
  • \n Ringkondade nimekirja seisund:\n -
    • \n
  • \n Valijate nimekirjad\n -\n \n  \n \n rakendamise ootel -\n \n  \n \n rakendatud -\n \n  \n \n vigaseid -\n \n  \n \n vahele jäetud -\n \n  \n \n saadaval -\n \n
    • \n
    \n
\n
\n \n
\n \n
\n \n\n
\n
\n
\n
\n Teenuste kokkuvõte seisundi järgi\n
\n
\n Paigaldamata: \n
Paigaldatud: \n
Seadistatud: \n
Osaline tõrge: \n
Tõrge: \n
Eemaldatud: \n
\n
\n
\n \n
\n
\n
\n
\n Kogumisteenuse tarkvarapakid:\n – olemas,\n – puudu\n
\n \n
\n
\n \n
\n
\n Kasutajate arv: \n
\n \n
\n \n
\n
\n Korraldused -\n  \n \n aktiivseid -\n \n  \n \n arhiveeritud -\n \n
\n \n
\n \n
\n \n
\n \n
\n \n\n
\n \n
\n \n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n\n\n" }, { "path": "collector-admin/site/ivxv/lists.html", "content": "\n\n\n\n\n \n \n \n \n Valimiste nimekirjad – IVXV Kogumisteenuse haldusteenus\n \n \n \n \n \n \n \n \n\n\n\n
\n \n \n
\n\n
\n
\n

Valimiste nimekirjad

\n
\n \n
\n \n\n \n
\n
\n
\n
\n

Andmete laadimise seisund

\n
\n
\n
\n
\n \n\n \n
\n
\n
\n
\n Viga!\n
\n
\n

Veateade

\n
\n
\n
\n \n
\n \n\n
\n
\n
\n Nimekirjade rakendamise logid on jälgitavad\n seadistuste lehel.\n
\n
\n \n\n
\n
\n
\n Valikute nimekiri\n
\n
\n
\n
\n
\n Valikute nimekiri on laadimata\n
\n
\n
\n
    \n
  • Valikute nimekiri: -
    • \n
  • Valikute nimekirja seisund: -
    • \n
\n
\n
\n
\n
\n
\n \n\n
\n
\n
\n Valijate nimekirjad\n
\n\n
\n
\n
\n
    \n
  • \n Valijate nimekirjad\n -\n \n  \n \n rakendamise ootel -\n \n  \n \n rakendatud -\n \n  \n \n vigaseid -\n \n  \n \n vahele jäetud -\n \n  \n \n saadaval -\n \n
    • \n
    \n
\n
\n
\n
\n
\n
\n \n\n
\n
\n
\n Ringkondade nimekiri\n
\n
\n
\n
\n
    \n
  • Ringkondade nimekiri: -
    • \n
  • Ringkondade nimekirja seisund: -
    • \n
\n
\n
\n
\n
\n
\n \n\n
\n
\n
\n

\n Nimekirjade üleslaadimine\n

\n
\n
\n
\n Faili üleslaadimise veateade\n
\n
\n
\n
\n \n \n
\n
\n
\n Nimekirja tüüp:\n
\n \n
\n \n
\n
\n
\n
\n \n
\n \n\n
\n \n
\n \n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n\n\n" }, { "path": "collector-admin/site/ivxv/log.html", "content": "\n\n\n\n\n \n \n \n \n Haldussündmuste logi – IVXV Kogumisteenuse haldusteenus\n \n \n \n \n \n \n \n \n \n \n\n\n\n
\n \n \n
\n\n
\n
\n

Haldussündmuste logi

\n
\n \n
\n \n\n \n
\n
\n
\n
\n

Andmete laadimise seisund

\n
\n
\n
\n
\n \n\n \n
\n
\n
\n
\n Viga!\n
\n
\n

Veateade

\n
\n
\n
\n \n
\n \n\n
\n
\n \n \n \n \n \n \n \n \n \n \n
AegTeenusTaseSündmusKirjeldus
\n \n
\n \n
\n \n\n
\n \n
\n \n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n\n\n" }, { "path": "collector-admin/site/ivxv/services.html", "content": "\n\n\n\n\n \n \n \n \n Teenused – IVXV Kogumisteenuse haldusteenus\n \n \n \n \n \n \n \n \n\n\n\n
\n \n \n
\n\n
\n
\n

Hallatavad teenused

\n
\n \n
\n \n\n \n
\n
\n
\n
\n

Andmete laadimise seisund

\n
\n
\n
\n
\n \n\n \n
\n
\n
\n
\n Viga!\n
\n
\n

Veateade

\n
\n
\n
\n \n
\n \n\n
\n
\n
\n
\n Teenuste kokkuvõte seisundi järgi\n
\n
\n Paigaldamata: \n
Paigaldatud: \n
Seadistatud: \n
Tõrge: \n
Eemaldatud: \n
\n
\n
\n \n
\n
\n
\n Kogumisteenuse koosseisus olevad teenused\n
\n
\n \n \n \n \n \n \n \n \n \n \n \n \n
#IDVõrkLiikSeisund
\n
\n
\n
\n \n
\n \n\n
\n \n
\n \n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n\n\n" }, { "path": "collector-admin/site/ivxv/stats.html", "content": "\n\n\n\n\n \n \n \n \n E-hääletamise statistika – IVXV Kogumisteenuse haldusteenus\n \n \n \n \n \n \n \n \n\n\n\n
\n \n \n
\n\n
\n
\n

E-hääletamise statistika

\n
\n \n
\n \n\n \n
\n
\n
\n
\n

Andmete laadimise seisund

\n
\n
\n
\n
\n \n\n \n
\n
\n
\n
\n Viga!\n
\n
\n

Veateade

\n
\n
\n
\n \n
\n \n\n
\n
\n
\n
\n Viga hääletamise statistika hankimisel\n
\n
\n

Veateade

\n
\n
\n
\n \n
\n \n\n
\n
\n
\n \n\n
\n
\n
\n

Ringkondade ja jaoskondade filter:

\n \n
\n
\n
\n \n
\n \n\n
\n
\n
\n
\n
\n
\n \n
\n
\n
 
\n
Kogutud häält
\n
\n
\n
\n
\n
\n \n
\n
\n
\n
\n
\n \n
\n
\n
 
\n
Hääletajat
\n
\n
\n
\n
\n
\n \n
\n
\n
\n
\n
\n \n
\n
\n
 
\n
Kontrollitud häält
\n
\n
\n
\n
\n
\n \n
\n
\n
\n
\n
\n \n
\n
\n
 
\n
Hääle kontrollijat
\n
\n
\n
\n
\n
\n \n
\n \n\n
\n
\n
\n
\n Hääletajate jaotumine\n
\n
\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
Sugu
Mehi 
Naisi 
Vanusegrupp
16-17 
18-24 
25-34 
35-44 
45-54 
55-64 
65-74 
75+ 
\n \n
\n
\n
\n \n
\n
\n
\n Korduvhääletamiste statistika\n
\n
\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
Täpselt 2 korda hääletanute arv 
Täpselt 3 korda hääletanute arv 
Rohkem kui 3 korda hääletanute arv 
Korduvhääletamised muutunud IP-aadressilt 
Korduvhääletamised erineva kaardiga 
\n \n
\n
\n
\n \n
\n
\n
\n Hääletajate jagunemine riigiti\n
\n
\n \n \n \n
\n \n
\n
\n
\n \n
\n \n\n
\n \n
\n \n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n\n\n" }, { "path": "collector-admin/site/ivxv/users.html", "content": "\n\n\n\n\n \n \n \n \n Haldusteenuse kasutajad – IVXV Kogumisteenuse haldusteenus\n \n \n \n \n \n \n \n \n\n\n\n
\n \n \n
\n\n
\n
\n

Haldusteenuse kasutajad

\n
\n \n
\n \n\n \n
\n
\n
\n
\n

Andmete laadimise seisund

\n
\n
\n
\n
\n \n\n \n
\n
\n
\n
\n Viga!\n
\n
\n

Veateade

\n
\n
\n
\n \n
\n \n\n \n
\n
\n
\n
\n

\n Kasutajate nimekiri\n

\n
\n
\n \n \n \n \n \n \n \n \n \n \n
#CNRollid
\n
\n
\n
\n \n
\n \n\n \n
\n
\n
\n
\n

\n Volituste rakendamine\n

\n
\n
\n
\n Faili üleslaadimise veateade\n
\n
\n
\n
\n \n \n
\n
\n \n
\n
\n
\n
\n \n
\n \n\n
\n \n
\n \n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n\n\n" }, { "path": "collector-admin/site/js/config.js", "content": "/*\n * IVXV Internet voting framework\n *\n * Administrator interface - Configuration status page\n */\n\n/**\n * Load page data\n */\nfunction loadPageData() {\n var loadDate = new Date();\n loadDate.setTime(Date.now());\n\n // load collector state\n $.getJSON('data/status.json', function(state) {\n /*\n * HTTP GET on https://admin.?.ivxv.ee/ivxv/data/status.json\n * HTTP GET response that contains HTML tags is not allowed!\n * state is always an JSON object\n */\n state = sanitizeJSON(state);\n display_cfg_panel(\n 'trust', state, state['config']['trust'], 'Usaldusjuure seadistus');\n display_cfg_panel(\n 'technical', state, state['config-apply']['technical'], 'Tehniline seadistus');\n display_cfg_panel(\n 'election', state, state['config-apply']['election'], 'Valimiste seadistus');\n display_cfg_panel(\n 'choices', state, state['config-apply']['choices'], 'Valikute nimekiri');\n display_cfg_panel(\n 'districts', state, state['list']['districts'], 'Ringkondade nimekiri');\n var changeset_no;\n display_cfg_panel(\n 'voters0000', state, state['config-apply']['voters0000'], 'Valijate nimekiri (algne)');\n for (var i = 1; i < 10000; i++) {\n var iStr = 'voters' + String(i).padStart(4, '0');\n if (!(iStr + '-state' in state['list']))\n break;\n if (iStr in state['config-apply']) {\n display_cfg_panel(\n iStr, state, state['config-apply'][iStr],\n 'Valijate muudatusnimekiri nr. ' + i);\n } else {\n display_cfg_panel(\n iStr, state, state['list'][iStr],\n 'Valijate muudatusnimekiri nr. ' + i);\n }\n }\n\n hideErrorMessage();\n\n // data loading stats\n var genDate = new Date();\n genDate.setTime(Date.parse(state['meta']['time_generated']));\n $('#loadstatus')\n .removeClass('text-danger')\n .addClass('text-info')\n .html(\n 'Andmete laadimise aeg: ' + formatTime(loadDate, 0) + '
' +\n 'Andmete genereerimise aeg: ' + genDate.toLocaleTimeString('et-EE', {}));\n })\n .fail(function() {\n $('#loadstatus')\n .removeClass('text-info')\n .addClass('text-danger')\n .html('Viga andmete laadimisel: ' + formatTime(loadDate, 0));\n showErrorMessage('Viga seisundi laadimisel', true);\n });\n}\n\nvar state_filenames = {};\n\n/**\n * Display config state panel\n *\n * @param {string} id_prefix\n * @param {Object} state\n * @param {Object} cfg\n * @param {string} title\n */\nfunction display_cfg_panel(id_prefix, state, cfg, title) {\n id_prefix = sanitizePrimitive(id_prefix);\n state = sanitizeJSON(state);\n cfg = sanitizeJSON(cfg);\n // Create panel if required\n var panel = $('#' + id_prefix + '-cfg-state-panel');\n if (!panel.length) {\n $('#upload-row').before(\n '
' +\n '
' +\n '
' +\n '
' +\n '

' + sanitizePrimitive(title) + '

' +\n '
' +\n '
' +\n '
' + // Placeholder for config info text\n ' ' +\n ' 
' + // Placeholder for log content\n      '
' +\n '
' +\n '
' +\n '
'\n );\n panel = $('#' + id_prefix + '-cfg-state-panel');\n }\n\n // Configure panel\n var panel_body = panel.find('.panel-body');\n panel\n .removeClass('panel-green')\n .removeClass('panel-warning')\n .removeClass('panel-danger');\n if ((id_prefix === 'trust') || (id_prefix === 'districts')) {\n var ver_element_id = 'cfg-ver-' + id_prefix;\n panel.addClass(cfg === null ? 'panel-danger' : 'panel-green');\n panel_body\n .find('div:first')\n .html(\n '
Seisund: ' + (cfg === null ? 'Laadimata' : 'Rakendatud haldusteenusele') + '
' +\n '
' +\n (cfg === null ? '-' : 'Versioon: ') +\n '
');\n outputCmdVersion('#' + ver_element_id, id_prefix, state)\n panel_body.find('button').hide();\n } else if (cfg === undefined) {\n panel.addClass('panel-danger');\n panel_body.find('div:first').html('
Laadimata
');\n panel_body.find('button').hide();\n } else {\n state_filenames[id_prefix] = cfg['state_file'];\n if (cfg['completed']) {\n panel.addClass('panel-green');\n } else {\n panel.addClass('panel-warning');\n }\n\n if (id_prefix.startsWith('voters')) {\n stateStr = voterListStateDescriptions.get(state['list'][id_prefix + '-state']);\n } else {\n stateStr = cfg['completed'] ? 'rakendatud' : 'rakendamisel';\n }\n if (id_prefix.startsWith('voters') && !(id_prefix in state['config-apply'])) {\n panel_body\n .find('div:first')\n .html(\n '
Seisund: ' + sanitizePrimitive(stateStr) + '
' +\n '
Rakendatav versioon: [ määramata ]
' +\n '
Rakendamise katseid: 0
'\n );\n } else {\n panel_body\n .find('div:first')\n .html(\n '
Seisund: ' + sanitizePrimitive(stateStr) + '
' +\n '
Rakendatav versioon: ' + cfg['version'] + '
' +\n '
Rakendamise katseid: ' + cfg['attempts'] + '
'\n );\n outputCmdVersion('#cfg-ver-' + id_prefix, id_prefix, state);\n }\n\n if (cfg['attempts']) {\n panel_body.find('button').show('slow');\n var logbox = panel_body.find('pre');\n if (logbox.is(':visible')) {\n refresh_log(logbox, cfg['state_file']);\n }\n } else {\n panel_body.find('button').hide('slow');\n panel_body.find('pre').hide('slow');\n }\n }\n}\n\n/**\n * Toggle config log box\n */\nfunction toggle_apply_log(toggle_button) {\n var parent_element = $(toggle_button).parent();\n var logbox = parent_element.find('pre');\n logbox.toggle();\n if (logbox.is(':visible')) {\n var cfg_type = parent_element.parent().attr('id').replace('-cfg-state-panel', '');\n refresh_log(logbox, state_filenames[cfg_type]);\n }\n}\n\n\n/**\n * Refresh logbox content\n */\nfunction refresh_log(logbox, filename) {\n var url = '/ivxv/data/commands/' + filename;\n $.getJSON(encodeURI(url), function(state) {\n /*\n * HTTP GET on https://admin.?.ivxv.ee/ivxv/data/commands/??\n * HTTP GET response that contains HTML tags is not allowed!\n * state is always an JSON object\n */\n state = sanitizeJSON(state);\n logbox.text(state['log'][state['attempts'] - 1].join('\\n'));\n })\n .fail(function(response) {\n logbox.text(sanitizePrimitive(response.responseText));\n });\n}\n\n/**\n * Reset upload form\n */\nfunction reset_upload_form() {\n $('input[type=file]').val(null);\n $('#file-upload-submit').attr('disabled', '');\n}\n\n// Variable to store uploaded files\nvar files;\n\n/**\n * Grab the files and set them to our variable\n */\nfunction prepareUpload(event) {\n files = event.target.files;\n $('#file-upload-submit').attr('disabled', null);\n $('#upload-message').hide();\n}\n\n/**\n * Catch the form submit and upload the files\n */\nfunction uploadFiles(event) {\n $('#upload-message')\n .removeClass('alert-danger')\n .removeClass('alert-success')\n .hide();\n\n event.stopPropagation(); // Stop stuff happening\n event.preventDefault(); // Totally stop stuff happening\n // Create a formdata object and add the files\n var data = new FormData();\n data.append('upload', files[0]);\n data.append('type', sanitizePrimitive($('#drop').find(':selected').val()));\n\n var form = $('#config-upload-form');\n $.ajax({\n url: encodeURI(form.attr('action')),\n type: sanitizePrimitive(form.attr('method')),\n data: data,\n cache: false,\n dataType: 'json',\n processData: false, // Don't process the files\n contentType: false, // Set content type to false as jQuery will tell the server its a query string request\n\n // Success\n success: function(data, textStatus, jqXHR) {\n console.log(jqXHR.responseJSON.message);\n $('#upload-message')\n .html(\n sanitizePrimitive(jqXHR.responseJSON.message) +\n '
' +\n '
' + sanitizePrimitive(jqXHR.responseJSON.log.join('\\n')) + '
'\n )\n .addClass(jqXHR.responseJSON.success ? 'alert-success' : 'alert-danger')\n .show();\n reset_upload_form();\n },\n\n // Handle errors\n error: function(jqXHR, textStatus, errorThrown) {\n console.log(jqXHR);\n $('#upload-message')\n .html(sanitizePrimitive(jqXHR.responseText))\n .addClass('alert-danger')\n .show();\n }\n });\n}\n" }, { "path": "collector-admin/site/js/downloads.js", "content": "/*\n * IVXV Internet voting framework\n *\n * Administrator interface - Ballot box download page\n */\n\n/**\n * Load page data\n */\nfunction loadPageData() {\n var loadDate = new Date();\n loadDate.setTime(Date.now());\n\n // load collector state\n $.getJSON('data/status.json', function(state) {\n /*\n * HTTP GET on https://admin.?.ivxv.ee/ivxv/data/status.json\n * HTTP GET response that contains HTML tags is not allowed!\n * state is always an JSON object\n */\n state = sanitizeJSON(state);\n hideErrorMessage();\n\n if ((state.collector_state == 'NOT INSTALLED') ||\n (state.collector_state == 'INSTALLED')) {\n $('#common-warning-msg').show('slow');\n $('#common-warning-msg .panel-body p').text('Kogumisteenus pole seadistatud. Valimiskasti allalaadimine pole võimaik.');\n $('#panel-download-form').hide();\n } else if (state.election.phase == 'PREPARING') {\n $('#common-warning-msg').show('slow');\n $('#common-warning-msg .panel-body p').text('Hääletamine on ettevalmistamise faasis. Valimiskasti allalaadimine pole võimaik.');\n $('#panel-download-form').hide();\n } else if (state.election.phase != 'FINISHED') {\n $('#common-warning-msg').show('slow');\n $('#common-warning-msg .panel-body p').text('Hääletusperioodil on võimalik väljastada vaid e-valimiskasti varukoopiat.');\n $('#panel-download-form').show();\n } else {\n $('#common-warning-msg').hide('slow');\n $('#panel-download-form').show();\n }\n })\n .fail(function() {\n $('#loadstatus')\n .removeClass('text-info')\n .addClass('text-danger')\n .html('Viga andmete laadimisel: ' + formatTime(loadDate, 0));\n showErrorMessage('Viga seisundi laadimisel', true);\n });\n\n // load ballot box state\n $.getJSON('cgi/ballot-box-state', function(state) {\n /*\n * HTTP GET on https://admin.?.ivxv.ee/ivxv/cgi/ballot-box-state\n * HTTP GET response that contains HTML tags is not allowed!\n * state is always an JSON object\n */\n state = sanitizeJSON(state);\n $('#panel-download-ballot-box').remove();\n\n if (state.data.length === 0) {\n console.log('There is no ballot box created for download');\n return;\n }\n\n var panel = $('#panel-download-ballot-box-template').clone().prop({\n id: 'panel-download-ballot-box'\n });\n panel.find('.list-group').empty();\n\n $(state.data).each(function() {\n var line = null;\n var message = this.filename.search('consolidated') === -1 ?\n 'Eksporditud e-valimiskast' :\n 'Eksporditud ja konsolideeritud e-valimiskast';\n if (this.state == 'ready') {\n line = $('#panel-download-ballot-box-template .list-group-item-success')\n .clone()\n .attr('href', '/ivxv/data/ballot-box/' + this.filename);\n } else if (this.state == 'prepare') {\n line = $('#panel-download-ballot-box-template .list-group-item-info')\n .clone();\n line.find('pre').text(this.log).show();\n } else {\n line = $('#panel-download-ballot-box-template .list-group-item-danger')\n .clone();\n message = 'Unknown ballot box state: ' + this.state;\n }\n\n line.find('span').first().text(message);\n line.find('span em').text(this.timestamp);\n panel.find('.list-group').append(line);\n });\n\n $('#panel-download-ballot-box-template').after(panel);\n panel.show();\n })\n .fail(function(jqXHR, textStatus) {\n $('#panel-download-ballot-box').remove();\n var panel = $('#panel-download-ballot-box-template').clone().prop({\n id: 'panel-download-ballot-box'\n });\n panel.find('.list-group').empty();\n $('#panel-download-ballot-box-template').after(panel);\n\n var line = $('#panel-download-ballot-box-template .list-group-item-danger')\n .clone();\n line\n .find('span')\n .first()\n .text(\n 'Serveri viga allalaadimiseks ettevalmistatud valimiskastide olekuandmete laadimisel');\n line.find('span em').remove();\n\n panel.find('.list-group').append(line);\n panel.show();\n });\n}\n\n/**\n * Download ballot box\n */\nfunction downloadBallot(consolidate) {\n $('#loading').show();\n url = (\n consolidate === 1 ?\n '/ivxv/cgi/download-consolidated-ballot-box' :\n '/ivxv/cgi/download-ballot-box')\n\n $.ajax({\n method: 'POST',\n url: url,\n\n success: function(url) {\n $('#loading').hide();\n $('#panel-download-form .panel-body')\n .text('Server alustas valimiskasti ettevalmistamist allalaadimiseks');\n },\n\n error: function(jqXHR, textStatus, errorThrown) {\n $('#loading').hide();\n alert(errorThrown);\n }\n\n });\n}\n" }, { "path": "collector-admin/site/js/index.js", "content": "/*\n * IVXV Internet voting framework\n *\n * Administrator interface - Overview page\n */\n\n/**\n * Load page data\n */\nfunction loadPageData() {\n var loadDate = new Date();\n loadDate.setTime(Date.now());\n\n // data mappings\n var states = {\n 'NOT INSTALLED': ['Paigaldamata', 'warning', 0],\n 'INSTALLED': ['Paigaldatud', '', 0],\n 'CONFIGURED': ['Seadistatud', 'success', 0],\n 'PARTIAL FAILURE': ['Osaline tõrge', 'danger', 0],\n 'FAILURE': ['Tõrge', 'danger', 0],\n 'REMOVED': ['Eemaldatud', '', 0]\n };\n var phases = {\n 'PREPARING': 'Ettevalmistamine',\n 'WAITING FOR SERVICE START': 'Teenuse käivitamise ootamine',\n 'WAITING FOR ELECTION START': 'Valimise alguse ootamine',\n 'ELECTION': 'Häälte kogumine',\n 'WAITING FOR SERVICE STOP': 'Teenuse seiskamise ootamine',\n 'FINISHED': 'Lõpetatud'\n };\n\n // load collector state\n $.getJSON('data/status.json', function(state) {\n /*\n * HTTP GET on https://admin.?.ivxv.ee/ivxv/data/status.json\n * HTTP GET response that contains HTML tags is not allowed!\n * state is always an JSON object\n */\n state = sanitizeJSON(state);\n hideErrorMessage();\n\n // election ID\n $('#electionid').toggle(state['election']['election-id'] !== null);\n $('#election-id').text(state['election']['election-id']);\n\n // collector state\n $('#collector-state')\n .html(\n state['collector']['state'] in states ?\n states[state['collector']['state']][0] :\n 'Tundmatu');\n $('#collector-state-panel')\n .removeClass('panel-danger')\n .removeClass('panel-warning')\n .removeClass('panel-success')\n .addClass(\n state['collector']['state'] in states ?\n 'panel-' + states[state['collector']['state']][1] :\n 'panel-danger');\n\n // voting phase\n $('#voting-phase').toggle(state['config']['election'] !== null);\n $('#voting-stage')\n .text(\n state['election']['phase'] in phases ?\n phases[state['election']['phase']] :\n 'Tundmatu');\n $('#voting-stage-start').text(state['election']['phase-start']);\n $('#voting-stage-end').text(state['election']['phase-end']);\n\n // config packages\n $('#trust')\n .addClass('list-group-item-warning')\n .removeClass('list-group-item-success');\n if (state['config']['trust']) {\n outputCmdVersion('#config-trust', 'trust', state)\n $('#trust')\n .removeClass('list-group-item-warning')\n .addClass('list-group-item-success');\n }\n $('#tech')\n .addClass('list-group-item-warning')\n .removeClass('list-group-item-success');\n if (state['config']['technical']) {\n outputCmdVersion('#config-tech', 'technical', state)\n $('#tech')\n .removeClass('list-group-item-warning')\n .addClass('list-group-item-success');\n }\n $('#election')\n .addClass('list-group-item-warning')\n .removeClass('list-group-item-success');\n if (state['config']['election']) {\n outputCmdVersion('#config-election', 'election', state)\n $('#election')\n .removeClass('list-group-item-warning')\n .addClass('list-group-item-success');\n }\n\n // voting lists - choices\n outputCmdVersion('#list-choices', 'choices', state)\n $('#choiceslist')\n .removeClass('list-group-item-danger')\n .removeClass('list-group-item-success')\n .removeClass('list-group-item-warning');\n $('#choicesliststatus')\n .removeClass('list-group-item-danger')\n .removeClass('list-group-item-success')\n .removeClass('list-group-item-warning');\n if (!state['list']['choices']) {\n $('#list-choices-status').text('Laadimata');\n $('#choiceslist').addClass('list-group-item-danger');\n $('#choicesliststatus').addClass('list-group-item-danger');\n } else if (!state['list']['choices-loaded']) {\n $('#list-choices-status').text('Laaditud haldusteenusesse');\n $('#choiceslist').addClass('list-group-item-warning');\n $('#choicesliststatus').addClass('list-group-item-warning');\n } else if (state['list']['choices'] === state['list']['choices-loaded']) {\n $('#list-choices-status').text('Rakendatud kogumisteenusele');\n $('#choiceslist').addClass('list-group-item-success');\n $('#choicesliststatus').addClass('list-group-item-success');\n }\n\n // voting lists - districts\n outputCmdVersion('#list-districts', 'districts', state)\n $('#districtslist')\n .removeClass('list-group-item-danger')\n .removeClass('list-group-item-success');\n $('#districtsliststatus')\n .removeClass('list-group-item-danger')\n .removeClass('list-group-item-success');\n if (state['list']['districts']) {\n $('#districtslist').addClass('list-group-item-success');\n $('#districtsliststatus').addClass('list-group-item-success');\n $('#list-districts-status').text('Laaditud haldusteenusesse');\n } else {\n $('#districtslist').addClass('list-group-item-danger');\n $('#districtsliststatus').addClass('list-group-item-danger');\n $('#list-districts-status').text('-');\n }\n\n // voting lists - voters\n fillVoterListStateCounters(state['list']);\n $('#voterslist')\n .removeClass('list-group-item-danger')\n .removeClass('list-group-item-success');\n if ((state['list']['voters-list-total'] === 0) ||\n (state['list']['voters-list-invalid'] !== 0)) {\n $('#voterslist').addClass('list-group-item-danger');\n } else if (state['list']['voters-list-pending'] === 0) {\n $('#voterslist').addClass('list-group-item-success');\n\n $('#list-list').empty();\n for (var changeset_no = 0; changeset_no < 10000; changeset_no++) {\n var iStr = 'voters' + String(changeset_no).padStart(4, '0');\n if (!(iStr + '-state' in state['list']))\n break;\n var listStatus = voterListStateDescriptions.get(state['list'][iStr + '-state']);\n $('#list-list').append(\n '
  • ' +\n (changeset_no + 1) + '. ' + sanitizePrimitive(listStatus) + ': ' + state['list'][iStr] +\n '
    • '\n );\n }\n } else {\n $('#voterslist').addClass('list-group-item-warning');\n }\n\n // service summary\n var serviceexists = false;\n $.each(state['service'], function(serviceName, service) {\n if (service['state'] in states) {\n states[service['state']][2]++;\n serviceexists = true;\n }\n });\n $('#service_summary').toggle(serviceexists);\n if (serviceexists) {\n $('#not_installed').html(states['NOT INSTALLED'][2]);\n $('#configured').html(states['CONFIGURED'][2]);\n $('#installed').html(states['INSTALLED'][2]);\n $('#failure').html(states['FAILURE'][2]);\n $('#p_failure').html(states['PARTIAL FAILURE'][2]);\n $('#removed').html(states['REMOVED'][2]);\n }\n\n // debian packages\n $('#debs-exist-count').text(state['storage']['debs_exists'].length);\n if (state['storage']['debs_missing'].length === 0) {\n $('#packagepanel')\n .removeClass('panel-danger')\n .addClass('panel-success')\n } else {\n $('#packagepanel')\n .removeClass('panel-success')\n .addClass('panel-danger')\n }\n $('#debs-missing-count').text(state['storage']['debs_missing'].length);\n $('#missing-debs-list').empty();\n for (var i = 0; i < state['storage']['debs_missing'].length; i++) {\n $('#missing-debs-list').append(\n '
    ' +\n '
    ' +\n state['storage']['debs_missing'][i] +\n '
    ' +\n '
    '\n );\n }\n\n // users\n var usercount = 0;\n if (state['user']) {\n usercount = Object.keys(state['user']).length;\n }\n $('#user-count').text(usercount);\n\n // command packages\n $('#command-files-count').text(\n state['storage']['command_files_active'].length +\n state['storage']['command_files_inactive'].length\n );\n $('#command-files-active-count').text(state['storage']['command_files_active'].length);\n $('#command-files-inactive-count').text(state['storage']['command_files_inactive'].length);\n\n // data loading stats\n var genDate = new Date();\n genDate.setTime(Date.parse(state['meta']['time_generated']));\n $('#loadstatus')\n .removeClass('text-danger')\n .addClass('text-info')\n .html('Andmete laadimise aeg: ' + formatTime(loadDate, 0) + '
    ' +\n 'Andmete genereerimise aeg: ' + genDate.toLocaleTimeString('et-EE', {}));\n })\n .fail(function() {\n $('#loadstatus')\n .removeClass('text-info')\n .addClass('text-danger')\n .html('Viga andmete laadimisel: ' + formatTime(loadDate, 0));\n showErrorMessage('Viga seisundi laadimisel', true);\n });\n}\n" }, { "path": "collector-admin/site/js/ivxv.js", "content": "/*\n * IVXV Internet voting framework\n *\n * Administrator interface - JavaScript helpers\n */\n\nvar pageContext = null; // Page context data\nvar userContext = null; // User context data (subset of pageContext)\n\n/**\n * Query page context data and write it\n * to pageContext and userContext variables.\n */\nfunction getContextData() {\n // query page context data\n console.debug('Loading context data');\n $.getJSON('cgi/context.json', function(context) {\n /*\n * HTTP GET on https://admin.?.ivxv.ee/ivxv/cgi/context.json\n * HTTP GET response that contains HTML tags is not allowed!\n * context is always an JSON object\n */\n context = sanitizeJSON(context);\n pageContext = context.data;\n userContext = pageContext['current-user'];\n console.debug('Current user: ' + userContext['cn'] +\n ' ' + userContext['idcode']);\n console.debug('Current role: ' + userContext['role'] +\n ' (' + userContext['role-description'] + ')');\n copyObjectToHtml(userContext, 'user-');\n\n // append election ID to page title\n if (pageContext['election']['id']) {\n $('title').prepend(pageContext['election']['id'] + ' – ');\n }\n\n $('.navbar-brand').html(\n 'Kogumisteenuse haldusteenus ' + pageContext['collector']['version']\n );\n\n // check user permissons and take action\n if (userContext['permissions'].length === 0) {\n // user has no permissons, generate error message and paint navbar to red\n $('.navbar').addClass('label-danger').find('li').addClass('label-danger');\n showErrorMessage('Puuduvad kasutajaõigused');\n }\n\n // Hide menu items if user has no permissions to access it\n var permission_page_map = [\n ['election-conf-admin', 'lists.html'],\n ['stats-view', 'stats.html'],\n ['user-admin', 'users.html'],\n ['tech-conf-admin', 'services.html'],\n ['tech-conf-admin', 'config.html'],\n ['download-ballot-box', 'downloads.html'],\n ['log-view', 'log.html']\n ];\n $.each(permission_page_map, function(index, value) {\n var hide = true;\n for (var i = 0; i < value.length - 1; i++) {\n if ($.inArray(value[i], userContext['permissions']) !== -1) {\n hide = false;\n break;\n }\n }\n if (hide) {\n $('#side-menu').find('a[href~=\"' + value[1] + '\"]').parent().hide();\n }\n });\n })\n .fail(function() {\n showErrorMessage('Viga kontekstiandmete laadimisel', false);\n });\n}\n\n/**\n * Show error message\n *\n * @param msg\n * @param {boolean} retain_content - Retain page content\n */\nfunction showErrorMessage(msg, retain_content) {\n console.error(msg);\n if (!retain_content) {\n $('#page-wrapper').find('.row').hide('slow');\n }\n $('#common-error-msg').find('p').text(msg);\n $('#common-error-msg').show('slow');\n $('#page-wrapper').css({\n 'background-color': 'rgba(217, 83, 79, 0.2)'\n });\n}\n\n/**\n * Hide error message\n */\nfunction hideErrorMessage() {\n $('#common-error-msg').hide('slow');\n $('#page-wrapper').css({\n 'background-color': ''\n });\n}\n\n/**\n * Check user permissions\n *\n * @param {string} permission - Permission name to check\n * @return {boolean} Do user have permission\n */\nfunction userHasPermission(permission) {\n return -1 !== $.inArray(permission, userContext['permissions']);\n}\n\n/**\n * Copy values from dictionary object to HTML element text nodes.\n *\n * @param {object} object_val - Dictionary object\n * @param {string} targetPrefix - Prefix for DOM id values\n */\nfunction copyObjectToHtml(object_val, targetPrefix) {\n if ('undefined' === typeof(targetPrefix))\n targetPrefix = '';\n $.each(object_val, function(key, val) {\n $('#' + sanitizePrimitive(targetPrefix) + sanitizePrimitive(key)).text(val);\n });\n}\n\n/**\n * Format datetime object as string\n *\n * @param {object} dateTime - datetime object\n * @param {number} offset - time offset\n */\nfunction formatTime(dateTime, offset) {\n var seconds = dateTime.getSeconds();\n var minutes = dateTime.getMinutes();\n var hours = dateTime.getHours() + offset;\n\n seconds = seconds < 10 ? '0' + seconds : seconds;\n minutes = minutes < 10 ? '0' + minutes : minutes;\n hours = hours < 10 ? '0' + hours : hours;\n\n return hours + ':' + minutes + ':' + seconds;\n}\n\n/**\n * Output config file version\n *\n * Add link to download config file command package.\n *\n * @param {string} selector - DOM selector\n * @param {string} cfg_type - config type\n * @param {Object} cfg - config data from status.json\n */\nfunction outputCmdVersion(selector, cfg_type, cfg) {\n selector = sanitizePrimitive(selector);\n cfg = sanitizeJSON(cfg);\n\n if ((cfg_type === 'trust') ||\n (cfg_type === 'technical') ||\n (cfg_type === 'election')) {\n var cfg_ver = cfg['config'][cfg_type];\n } else if ((cfg_type === 'choices') ||\n (cfg_type === 'districts')) {\n var cfg_ver = cfg['list'][cfg_type];\n } else if (cfg_type.search('voters') === 0) {\n var cfg_ver = cfg['config-apply'][cfg_type]['version'];\n } else {\n console.error('Unknown config: ' + cfg_type);\n }\n if (cfg['config-apply'][cfg_type] === undefined) {\n $(selector).html('' + (cfg_ver === null ? '-' : cfg_ver) + '');\n } else {\n var cmd_file = cfg['config-apply'][cfg_type]['cmd_file'];\n $(selector).html(\n '' +\n '' + cfg_ver + '' +\n ''\n );\n }\n}\n\n/**\n * Voter list state descriptions\n */\nconst voterListStateDescriptions = new Map();\nvoterListStateDescriptions.set('APPLIED', 'RAKENDATUD')\nvoterListStateDescriptions.set('PENDING', 'OOTEL')\nvoterListStateDescriptions.set('INVALID', 'VIGANE')\nvoterListStateDescriptions.set('SKIPPED', 'VAHELE JÄETUD')\nvoterListStateDescriptions.set('AVAILABLE', 'SAADAVAL')\n\n/**\n * Fill voter list state counters\n */\nfunction fillVoterListStateCounters(list_state) {\n $('#list-voters-total').text(list_state['voters-list-total']);\n $('#list-voters-loaded').text(list_state['voters-list-applied']);\n $('#list-voters-pending').text(list_state['voters-list-pending']);\n $('#list-voters-invalid').text(list_state['voters-list-invalid']);\n $('#list-voters-skipped').text(list_state['voters-list-skipped']);\n $('#list-voters-available').text(list_state['voters-list-available']);\n}\n\n/**\n * If Object (JSON!) contains XSS vulnerable content like HTML attributes\n * or HTML context, it will be replaced and XSS-free Object (JSON!) is returned.\n *\n * If somehow Object type data parsing fails - empty {} is returned.\n * Note, that even if Object data contains XSS vulnerabilities it\n * doesn't automatically mean, that it isn't a valid JavaScript Object,\n * however if data isn't valid Object, then it doesn't make sense to\n * proceed with XSS validation at all.\n *\n * @param {Object} context - JSON object\n * @return {Object} - XSS-free JSON object\n */\nfunction sanitizeJSON(context) {\n try {\n return JSON.parse(JSON.stringify(context).replaceAll('<', '<'));\n } catch (err) {\n console.error(err);\n return {};\n }\n}\n\n/**\n * If primitive type contains XSS vulnerable content like HTML attributes\n * or HTML context, it will be replaced and returned as XSS-free string.\n *\n * If somehow primitive type data parsing fails - empty string is returned.\n * Note, that even if primitive data contains XSS vulnerabilities it\n * doesn't automatically mean, that it isn't a valid JavaScript primitive,\n * however if data isn't valid primitive, then it doesn't make sense to\n * proceed with XSS validation at all.\n *\n * @param {string | number | boolean} context - primitive data\n * @return {string} - XSS-free string\n */\nfunction sanitizePrimitive(context) {\n try {\n return String(context).replaceAll('<', '<');\n } catch (err) {\n console.error(err);\n return '';\n }\n}\n" }, { "path": "collector-admin/site/js/lists.js", "content": "/*\n * IVXV Internet voting framework\n *\n * Administrator interface - Voting lists management page\n */\n\n/**\n * Load page data\n */\nfunction loadPageData() {\n var loadDate = new Date();\n loadDate.setTime(Date.now());\n\n // load collector state\n $.getJSON('data/status.json', function(state) {\n /*\n * HTTP GET on https://admin.?.ivxv.ee/ivxv/data/status.json\n * HTTP GET response that contains HTML tags is not allowed!\n * state is always an JSON object\n */\n state = sanitizeJSON(state);\n hideErrorMessage();\n\n // choices list\n outputCmdVersion('#list-choices', 'choices', state)\n if (!state['list']['choices']) {\n $('#list-choices-status').text('Laadimata');\n $('#panel-choices-list').attr('class', 'panel panel-red');\n } else {\n $('#choicesoption').hide();\n $('#votersoption').parent().val('voters');\n $('#drop').find('option[value=\"voters\"]').prop('selected', true);\n if (!state['list']['choices-loaded']) {\n $('#list-choices-status').text('Laaditud haldusteenusesse');\n $('#panel-choices-list').attr('class', 'panel panel-warning');\n } else if (state['list']['choices'] === state['list']['choices-loaded']) {\n $('#list-choices-status').text('Rakendatud kogumisteenusele');\n $('#panel-choices-list').attr('class', 'panel panel-success');\n }\n }\n\n // voters lists\n if (state['list']['voters-list-applied']) {\n $('#votersoption').contents().replaceWith('Valijate muudatusnimekirja vahelejätmine');\n }\n fillVoterListStateCounters(state['list']);\n $('#panel-voters-list').attr('class', 'panel panel-warning');\n\n if (state['list']['voters-list-applied'] === 0) {\n $('#panel-voters-list').attr('class', 'panel panel-red');\n } else if (state['list']['voters-list-pending'] === 0) {\n $('#panel-voters-list').attr('class', 'panel panel-success');\n\n $('#list-list').empty();\n for (var changeset_no = 0; changeset_no < 10000; changeset_no++) {\n var iStr = 'voters' + String(changeset_no).padStart(4, '0');\n if (!(iStr + '-state' in state['list']))\n break;\n var listStatus = voterListStateDescriptions.get(state['list'][iStr + '-state']);\n $('#list-list').append(\n '
  • ' +\n (changeset_no + 1) + '. ' + sanitizePrimitive(listStatus) + ': ' + state['list'][iStr] +\n '
    • '\n );\n }\n }\n\n // districts list\n outputCmdVersion('#list-districts', 'districts', state)\n if (!state['list']['districts']) {\n $('#list-districts-status').text('Laadimata');\n $('#panel-districts-list').attr('class', 'panel panel-red');\n } else {\n $('#list-districts-status').text('Laaditud haldusteenusesse');\n $('#panel-districts-list').attr('class', 'panel panel-success');\n }\n\n // data loading stats\n var genDate = new Date();\n genDate.setTime(Date.parse(state['meta']['time_generated']));\n $('#loadstatus')\n .removeClass('text-danger')\n .addClass('text-info')\n .html('Andmete laadimise aeg: ' + formatTime(loadDate, 0) + '
    ' +\n 'Andmete genereerimise aeg: ' + genDate.toLocaleTimeString('et-EE', {}));\n })\n .fail(function() {\n $('#loadstatus')\n .removeClass('text-info')\n .addClass('text-danger')\n .html('Viga andmete laadimisel: ' + formatTime(loadDate, 0));\n showErrorMessage('Viga seisundi laadimisel', true);\n });\n}\n\n/**\n * Reset upload form\n */\nfunction reset_upload_form() {\n $('input[type=file]').val(null);\n $('#file-upload-submit').attr('disabled', '');\n}\n\n// Variable to store uploaded files\nvar files;\n\n/**\n * Grab the files and set them to our variable\n */\nfunction prepareUpload(event) {\n files = event.target.files;\n $('#file-upload-submit').attr('disabled', null);\n $('#upload-message').hide();\n}\n\n/**\n * Catch the form submit and upload the files\n */\nfunction uploadFiles(event) {\n $('#upload-message').hide()\n .removeClass('alert-danger')\n .removeClass('alert-success');\n\n event.stopPropagation(); // Stop stuff happening\n event.preventDefault(); // Totally stop stuff happening\n // Create a formdata object and add the files\n var data = new FormData();\n data.append('upload', files[0]);\n data.append('type', sanitizePrimitive($('#drop').find(':selected').val()));\n\n var form = $('#config-upload-form');\n $.ajax({\n url: encodeURI(form.attr('action')),\n type: sanitizePrimitive(form.attr('method')),\n data: data,\n cache: false,\n dataType: 'json',\n processData: false, // Don't process the files\n contentType: false, // Set content type to false as jQuery will tell the server its a query string request\n // Success\n success: function(data, textStatus, jqXHR) {\n console.log(jqXHR.responseJSON.message);\n $('#upload-message')\n .html(\n sanitizePrimitive(jqXHR.responseJSON.message) +\n '
    ' +\n '
    ' + sanitizePrimitive(jqXHR.responseJSON.log.join('\\n')) + '
    '\n )\n .addClass(jqXHR.responseJSON.success ? 'alert-success' : 'alert-danger')\n .show();\n reset_upload_form();\n },\n // Handle errors\n error: function(jqXHR, textStatus, errorThrown) {\n console.log(jqXHR);\n $('#upload-message')\n .html(sanitizePrimitive(jqXHR.responseText))\n .addClass('alert-danger')\n .show();\n }\n });\n}\n" }, { "path": "collector-admin/site/js/log.js", "content": "/*\n * IVXV Internet voting framework\n *\n * Administrator interface - Event log browsing page\n */\n\n/**\n * Load page data\n */\nfunction loadPageData() {\n var loadDate = new Date();\n loadDate.setTime(Date.now());\n\n // fill log table with data\n $('#dataTables-log').DataTable({\n 'ajax': '/ivxv/cgi/eventlog',\n stateSave: true,\n responsive: true,\n 'columns': [{\n 'data': 'timestamp'\n }, {\n 'data': 'service'\n }, {\n 'data': 'level'\n }, {\n 'data': 'event'\n }, {\n 'data': 'message'\n }],\n 'order': [\n [0, 'desc']\n ],\n 'fnRowCallback': function(nRow, aData) {\n if (aData.level === 'INFO') {\n $(nRow).addClass('success');\n } else {\n $(nRow).addClass('danger');\n }\n }\n })\n .on('xhr', function(e, settings, json) {\n if (json === null) {\n $('#loadstatus')\n .removeClass('text-info')\n .addClass('text-danger')\n .html('Viga andmete laadimisel: ' + formatTime(loadDate, 0));\n } else {\n $('#loadstatus')\n .removeClass('text-danger')\n .addClass('text-info')\n .html('Andmete laadimise aeg: ' + formatTime(loadDate, 0));\n }\n });\n};\n" }, { "path": "collector-admin/site/js/services.js", "content": "/*\n * IVXV Internet voting framework\n *\n * Administrator interface - Services management page\n */\n\n/**\n * Load page data\n */\nfunction loadPageData() {\n var loadDate = new Date();\n loadDate.setTime(Date.now());\n\n // data mappings\n var service_states = {\n 'NOT INSTALLED': ['Paigaldamata', 'warning', 0],\n 'INSTALLED': ['Paigaldatud', '', 0],\n 'CONFIGURED': ['Seadistatud', 'success', 0],\n 'FAILURE': ['Tõrge', 'danger', 0],\n 'REMOVED': ['Eemaldatud', '', 0]\n };\n var service_types = {\n 'backup': 'Varundusteenus',\n 'choices': 'Nimekirjateenus',\n 'mid': 'Mobiil-ID abiteenus',\n 'smartid': 'Smart-ID abiteenus',\n 'webeid': 'Web-eID abiteenus',\n 'sessionstatus': 'SessionID staatust raporteeriv abiteenus',\n 'proxy': 'Vahendusteenus',\n 'storage': 'Talletusteenus',\n 'log': 'Logikogumisteenus',\n 'votesorder': 'Järjekorrateenus',\n 'voting': 'Hääletamisteenus',\n 'verification': 'Kontrollteenus'\n };\n\n // load collector state\n $.getJSON('data/status.json', function(state) {\n /*\n * HTTP GET on https://admin.?.ivxv.ee/ivxv/data/status.json\n * HTTP GET response that contains HTML tags is not allowed!\n * state is always an JSON object\n */\n state = sanitizeJSON(state);\n hideErrorMessage();\n\n var i = 1;\n $('#service_list_table').toggle(state['service'] !== undefined);\n\n // register service details block visibility states\n var is_service_visible = {};\n $.each(state['service'], function(k, v) {\n var details_block_id = k.replace(/[@\\.]/g, '_') + '_details';\n is_service_visible[details_block_id] = $('#' + details_block_id).is(':visible');\n });\n\n $('#services-list').empty();\n $.each(state['service'], function(k, v) {\n var zone = 'Tundmatu';\n var state_str = 'Tundmatu';\n var status_class = 'warning';\n var service_type = v['service-type'] in service_types ? service_types[v['service-type']] : 'Tundmatu';\n var show_mobile = 'mid-token-key' in state['service'][k] ? '' : 'display: none';\n var show_tlskey = 'tls-key' in state['service'][k] ? '' : 'display: none';\n var show_tlscert = 'tls-cert' in state['service'][k] ? '' : 'display: none';\n var lastdata = state['service'][k]['last-data'] ? state['service'][k]['last-data'] : '-';\n var econf = state['service'][k]['election-conf-version'] ? state['service'][k]['election-conf-version'] : '-';\n var tlsc = state['service'][k]['tls-cert'] ? state['service'][k]['tls-cert'] : '-';\n var tlsk = state['service'][k]['tls-key'] ? state['service'][k]['tls-key'] : '-';\n var midk = state['service'][k]['mid-token-key'] ? state['service'][k]['mid-token-key'] : '-';\n var pingerr = state['service'][k]['ping-errors'] ? state['service'][k]['ping-errors'] : '-';\n var bg_info = state['service'][k]['bg_info'];\n var tconf = state['service'][k]['technical-conf-version'] ? state['service'][k]['technical-conf-version'] : '-';\n var ipaddr = state['service'][k]['ip-address'] ? state['service'][k]['ip-address'] : '-';\n\n // Service field in json doesn't have info about its zone, have to find it by going through all of them\n $.each(state['network'], function(network_key, network_value) {\n if (k in network_value) {\n zone = network_key;\n return false;\n }\n });\n\n if (v['state'] in service_states) {\n service_states[v['state']][2]++;\n state_str = service_states[v['state']][0];\n status_class = service_states[v['state']][1];\n }\n\n var details_block_id = k.replace(/[@\\.]/g, '_') + '_details';\n var details_block_style = is_service_visible[details_block_id] ? '' : 'display: none;';\n $('#services-list').append(\n '' +\n '' + i + '' +\n '' + k + '' +\n '' + zone + '' +\n '' + service_type + '' +\n '' + state_str + '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '' +\n '
    Vigade arv:' + pingerr + '
    Viimane kontroll:' + lastdata + '
    Tehniline seadistus:' + tconf + '
    Valimiste seadistus:' + econf + '
    IP-aaddress:' + ipaddr + '
    TLS-sertifikaat:' + tlsc + '
    TLS-võti:' + tlsk + '
    Mobiil-ID krüptimissaladus:' + midk + '
    ' +\n '' +\n ''\n );\n if (bg_info) {\n $('#services-list').append(\n '' +\n '' +\n '' +\n ' Taustainfo: ' +\n ' ' + bg_info.replace(/\\n/g, '
    ') + '    ' +\n '' +\n ''\n );\n }\n i++;\n });\n\n // data loading stats\n var genDate = new Date();\n genDate.setTime(Date.parse(state['meta']['time_generated']));\n $('#loadstatus')\n .removeClass('text-danger')\n .addClass('text-info')\n .html('Andmete laadimise aeg: ' + formatTime(loadDate, 0) + '
    ' +\n 'Andmete genereerimise aeg: ' + genDate.toLocaleTimeString('et-EE', {}));\n\n }).done(function() {\n $('#not_installed').html(service_states['NOT INSTALLED'][2]);\n $('#configured').html(service_states['CONFIGURED'][2]);\n $('#installed').html(service_states['INSTALLED'][2]);\n $('#failure').html(service_states['FAILURE'][2]);\n $('#removed').html(service_states['REMOVED'][2]);\n }).fail(function() {\n $('#loadstatus')\n .removeClass('text-info')\n .addClass('text-danger')\n .html('Viga andmete laadimisel: ' + formatTime(loadDate, 0));\n showErrorMessage('Viga seisundi laadimisel', true);\n });\n}\n" }, { "path": "collector-admin/site/js/stats.js", "content": "/*\n * IVXV Internet voting framework\n *\n * Administrator interface - Stats page\n */\n\n/**\n * Load page data\n */\nfunction loadPageData() {\n var loadDate = new Date();\n loadDate.setTime(Date.now());\n\n // manage districts selection\n if ($('#districts option').length == 1) {\n $.getJSON('data/districts.json', function(data) {\n /*\n * HTTP GET on https://admin.?.ivxv.ee/ivxv/data/districts.json\n * HTTP GET response that contains HTML tags is not allowed!\n * data is always an JSON object\n */\n data = sanitizeJSON(data);\n var dropdown = $('#districts');\n $.each(data, function() {\n dropdown.append($('