Öffentliches Register
Was jede Wahl öffentlich macht, unabhängig vom Transportweg, und was jeder davon prüfen kann, ohne der Plattform zu vertrauen.
Das Register ist die überprüfbare Aufzeichnung der Wahl. Während der Stimmabgabe ist die Plattform ein vertrauenswürdiger Dritter; alles, was sie getan hat, lässt sich danach allein anhand des veröffentlichten Registers kontrollieren. Diese Seite beschreibt seinen Inhalt unabhängig vom Transportweg. Die Blockchain ist nur ein Weg, ihn zu verbreiten: derjenige, über den jeder seine Integrität und Unveränderlichkeit prüfen kann.
Protokoll v1
Wer abgestimmt hat, und getrennt davon, was abgestimmt wurde.
Eine Definition und Ringe (in der Oberfläche „virtuelle Wahllokale“ genannt), die für die ganze Wahl gelten, dazu zwei bewusst getrennte Teile: Die Teilnahmeliste sagt, wer teilgenommen hat. Das Register der Stimmzettel sagt, was abgestimmt wurde, mit dem kryptografischen Nachweis, aber ohne Spur davon, von wem oder wann. Daraus ergibt sich das Ergebnis.
-
Kontext
Definition der Wahl
Titel, Organisator, Typ, Sitze, Kandidaten, Stimmzettelregeln und Datenschutzoptionen, fixiert vor dem ersten Stimmzettel.
Bei der Eröffnung · configuration-Block
-
Kontext
Ringe
Die vollständige Liste der öffentlichen Schlüssel, die signieren dürfen, Ring für Ring, mit dem Hashwert jedes Rings.
Bei der Eröffnung, dann je Ausweichring · rings-Blöcke
-
Teilnahme
Teilnahmeliste
Eine Zeile pro Wähler unter einer zufälligen Wähler-ID: abgestimmt oder nicht, in welchem Ring, wie viele Schlüssel erhalten, welches Gewicht. Standardmäßig pseudonym.
Beim Ende der Stimmabgabe, als einmalige Momentaufnahme · closure-Block
-
Stimmzettel
Signierte Stimmzettel
Jeder Stimmzettel so, wie er signiert wurde, Byte für Byte, mit Ringsignatur und Schlüsselabbild (key image), ohne Identität und ohne Zeitstempel.
Während der Stimmabgabe, in Stapeln von mindestens 600 · votes-Blöcke
-
Berechnung
Veröffentlichtes Ergebnis
Die maßgebliche Rangfolge mit der gespeicherten Methode und den Berechnungsversionen, dazu die Stimmzettel im CEF-Format. Nie ein Block: Das Ergebnis wird neu berechnet.
Bei Veröffentlichung durch den Organisator · Ergebnisseite
-
Außerhalb des Registers
Nie veröffentlicht
Zeitstempel, Eingangsreihenfolge, die Zuordnung von Wähler-ID zu Identität (außer bei namentlicher Teilnahmeliste), die optische Gestaltung: Logo, Fotos, Dankesnachricht.
Weder auf der Seite noch in einem Block
Was vor dem ersten Stimmzettel fixiert wird.
Die Definition wird beim Start der Wahl fixiert, jeder Ring bei seiner Erstellung. Danach ändern sich beide nicht mehr: Jeder Stimmzettel wird gegen die veröffentlichte Definition und den veröffentlichten Ring geprüft.
Definition der Wahl
-
protocol_versionGanzzahl - Die Protokollversion, derzeit 1, dauerhaft an die Wahl gebunden.
-
election_idUUID v4 - Die ID der Wahl, enthalten in jedem signierten Stimmzettel und in jeder Signaturprüfung.
-
title, description?, organizer_nameZeichenketten - Informativer Kontext, im Klartext veröffentlicht, nie eine Eingabe der Auszählung.
-
election_type, seatspreferential | fptp, Ganzzahl ≥ 1 - Rangfolge oder eine einzige Auswahl; Anzahl der Sitze, also der an der Spitze der Rangfolge gewählten Kandidaten.
-
candidates[].labelArray - Die Bezeichnungen der Kandidaten, ihre einzige Kennung, sortiert nach Bezeichnung.
-
ballot_rulesObjekt - Die Parameter des Stimmzettels (Gleichstände, teilweise Rangfolge, leerer Stimmzettel, vollständige Rangfolge), aus denen sich die Bedingungen der Auszählung nach einer dokumentierten Regel ergeben.
-
non_anonymous_voting, nominative_participation, weighted_votingboolesche Werte - Die Optionen für Datenschutz und Gewichtung, standardmäßig deaktiviert. Die nicht anonyme Stimmabgabe erzwingt die namentliche Teilnahmeliste.
-
max_ring_size, initial_electoral_roll_sizeGanzzahlen - Die Obergrenze der Ringgröße (derzeit 600) und die Größe des Wählerverzeichnisses bei der Eröffnung.
Die Einzelheiten Feld für Feld, einschließlich voter_access_mode und enrolment_mandatory, stehen in der Spezifikation der Blockchain. Die maßgebliche Methode gehört dazu (Feld method): Sie wird vor der Stimmabgabe festgelegt, und das Ergebnis wird mit ihr neu berechnet.
Ringe
-
ring_idUUID - Der Ring, gegen den ein Stimmzettel signiert wird; jeder Stimmzettel nennt ihn.
-
public_keys[]pk_<64 hex>_<8 hex> - Alle öffentlichen Schlüssel des Rings, eindeutig, aufsteigend sortiert, höchstens max_ring_size.
-
ring_digestring_<64 hex>_<8 hex> - Der kanonische, von der Reihenfolge unabhängige Hashwert der Mitgliedermenge, aus den Schlüsseln nachrechenbar.
Die Anonymität eines Stimmzettels ist genau der Ring, unter dem er signiert wurde: Eine Plattform, die einem Wähler einen Ring liefert, der sich in nur einem Mitglied unterscheidet, könnte seinen Stimmzettel wiedererkennen. Die Abstimmungsseite berechnet den Hashwert aus dem erhaltenen Ring (sie bekommt ihn nie von der Plattform), zeigt ihn vor der Signatur an und schreibt ihn in den Prüfbeleg. Der Wähler vergleicht ihn mit dem Wert, der hier für alle veröffentlicht ist. Das ist Erkennung, keine Verhinderung.
Wächst das Wählerverzeichnis während der Stimmabgabe, wird ein Ausweichring angelegt und bei seiner Erstellung veröffentlicht. Jeder Ring lässt sich auf der Registerseite als JSON herunterladen, mit seinem Hashwert und seinen Schlüsseln in derselben Reihenfolge wie in seinem Block.
Wer teilgenommen hat, einmalig veröffentlicht.
Die Teilnahmeliste wird als einmalige Momentaufnahme im Abschlussblock veröffentlicht, sobald das Wählerverzeichnis endgültig ist. Während der Stimmabgabe zeigt die Registerseite nichts davon: Keine Teilnahmezeile teilt sich je ein Veröffentlichungsfenster mit einem Stimmzettel.
Eine Zeile pro Wähler
-
voter_idUUID v4, zufällig - Die einzige Kennung der Zeile; die Zeilen sind nach voter_id sortiert. In allen Wahlen einer Gruppe identisch.
-
key_provisioning_modeserver_generated | organizer_imported | voter_enrolled - Die Herkunft des Schlüssels: von der Plattform erzeugt, vom Organisator importiert oder vom Wähler selbst hinterlegt.
-
has_votedboolescher Wert - Abgestimmt oder nicht.
-
ring_idUUID oder null - Der Ring, in dem der Wähler abgestimmt hat, oder null, wenn er nicht abgestimmt hat: die Verbindung Wähler → Ring, auf der die Prüfung pro Ring beruht.
-
distribution_countGanzzahl ≥ 0 - Die Anzahl der verteilten Wahlschlüssel: standardmäßig höchstens 3, mehr nur, wenn der Organisator zusätzliche gewährt, was sichtbar bleibt. Die einzelnen Verteilungen werden nicht aufgeschlüsselt.
-
weightGanzzahl ≥ 1 - Das Gewicht (etwa Miteigentumsanteile), immer vorhanden, 1 ohne Stimmgewichtung: der Wert, gegen den das im Stimmzettel signierte Gewicht geprüft wird.
Das Wählerverzeichnis zum Ende der Stimmabgabe enthält auch die Wähler, die während der Stimmabgabe hinzugefügt wurden: Seine Größe minus initial_electoral_roll_size ergibt, wie viele es sind, nie aber, welche. Der Abschlussblock enthält außerdem die Summen: Blöcke, Stimmzettel, Ringe, Wähler, abgegebenes Gewicht.
Namentliche Teilnahmeliste: eine Option
Sie ist standardmäßig deaktiviert. Der Organisator kann sie beim Start aktivieren, und die Wähler werden darauf hingewiesen; bei nicht anonymer Stimmabgabe ist sie zwingend. Nur die Zeilen der Wähler, die abgestimmt haben, erhalten dann zwei zusätzliche Felder.
-
voter_nameZeichenkette - Der Name im Klartext, so wie der Organisator ihn beim Import angegeben hat.
-
email_digest64 Hex-Zeichen - SHA3-256(election_id ‖ normalisierte E-Mail-Adresse), Hex in Kleinbuchstaben: ein Hashwert, der nur für diese Wahl gilt.
- Wer nicht abgestimmt hat, wird nie genannt. Diese Zeilen bleiben pseudonym: Die Option zeigt, wer abgestimmt hat, nie, wer sich enthalten hat.
- Offengelegt wird die Teilnahme, nicht der Stimmzettel. Für sich genommen verknüpft die Option einen Namen mit der Tatsache, abgestimmt zu haben, nie mit einem Stimmzettel. Zusammen mit der nicht anonymen Stimmabgabe, bei der die Wähler-ID im signierten Stimmzettel steht, entsteht die Verknüpfung Stimmzettel → Wähler-ID → Name.
- Ein schwacher Hashwert, bewusst gewählt. Das Salt (election_id) ist öffentlich, und eine E-Mail-Adresse lässt sich erraten: Wer eine Adresse kennt, kann die Teilnahme ihres Inhabers bestätigen und über mehrere Wahlen hinweg verknüpfen. Der Hashwert dient der Kontrolle des Verzeichnisses, nicht dem Schutz, und bleibt ein personenbezogenes Datum.
Was abgestimmt wurde, ohne Wer und Wann.
Ein Datensatz pro Stimmzettel, sortiert nach Schlüsselabbild: eine deterministische, aus dem Inhalt abgeleitete Reihenfolge, die nichts mit der Eingangsreihenfolge zu tun hat.
Ein Datensatz pro Stimmzettel
-
ring_idUUID - Der Ring, mit dessen Schlüsseln sich die Signatur prüfen lässt.
-
payloadJSON-Zeichenkette - Die signierten Nutzdaten, unverändert, Byte für Byte: Version, Wahl, Inhalt des Stimmzettels, Gewicht und bei nicht anonymer Stimmabgabe die Wähler-ID.
-
signatureblsag_… - Die Ringsignatur (bLSAG) über die Nutzdaten.
-
key_imageki_… - Das Schlüsselabbild: Derselbe Schlüssel ergibt in einer Wahl immer dasselbe Abbild, ohne zu verraten, welcher Schlüssel des Rings signiert hat.
- Veröffentlichung in Stapeln. Die Stimmzettel werden in Stapeln von mindestens 600 veröffentlicht, in einem zufällig gewählten Zeitfenster; ein zu kleiner Stapel wartet auf den nächsten. Beim Ende der Stimmabgabe wird alles veröffentlicht; der letzte Stapel kann weniger als 600 Stimmzettel enthalten. Eine Wahl mit weniger als 600 Wählern veröffentlicht ihre Stimmzettel daher beim Ende der Stimmabgabe.
- Eine Regel für Seite und Kette. Registerseite und Blockchain lesen dasselbe Flag, is_chain_published: Sie zeigen immer genau dieselbe Menge an Stimmzetteln. Während der Stimmabgabe zeigt die Seite die Anzahl der eingegangenen Stimmzettel, die auf Veröffentlichung warten, ohne deren Inhalt.
- Den eigenen Stimmzettel vor der Veröffentlichung finden. Die Suche nach Schlüsselabbild (POST-Anfrage mit Ratenbegrenzung) findet auch einen Stimmzettel, der eingegangen, aber noch nicht veröffentlicht ist. Ein Schlüsselabbild lässt sich nicht erraten: Nur wer den Prüfbeleg besitzt, kann es eingeben. Die öffentliche Liste zeigt dagegen nur veröffentlichte Stimmzettel.
- Eine Seite pro veröffentlichtem Stimmzettel. Nutzdaten, Signatur, Schlüsselabbild und Hashwert seines Rings. Die ID des Stimmzettels, die die Seite anzeigt, ist eine zufällige UUID v4; sie steht in keinem Block.
Wann welcher Teil erscheint.
Vor der Eröffnung der Stimmabgabe ist nichts öffentlich. Danach wächst das Register nur noch, bis das Ende der Stimmabgabe es abschließt.
Je nach Status der Wahl
-
Draft, Enrolment, OpeningVorbereitung - Nichts ist öffentlich. Bei Opening werden die Definition und die beim Start angelegten Ringe fixiert und versiegelt.
-
OpenStimmabgabe offen - Die Registerseite ist online: Definition, Ringe, in Stapeln veröffentlichte Stimmzettel, Anzahl der Stimmzettel, die auf Veröffentlichung warten, Suche nach Schlüsselabbild. Ein Ausweichring erscheint bei seiner Erstellung. Keine Teilnahmeliste.
-
ClosedStimmabgabe geschlossen - Der letzte Stapel Stimmzettel, dann der Abschlussblock: vollständige Teilnahmeliste und Summen. Danach kann kein Block mehr folgen.
-
PublishedErgebnis veröffentlicht - Der Organisator veröffentlicht das Ergebnis: Ergebnisseite und CEF-Download.
-
ArchivedArchiviert - Das Register bleibt schreibgeschützt einsehbar; das Ergebnis wird nicht mehr öffentlich angezeigt.
-
CancelledAnnulliert - Alle öffentlichen Ansichten werden entfernt, die Registerseite weist darauf hin. Es wird kein Abschlussblock erzeugt: Bereits veröffentlichte Blöcke bleiben gültig, die Kette endet.
Das veröffentlichte Ergebnis
- Nie ein Block. Das Ergebnis wird aus der Definition und den veröffentlichten Stimmzetteln neu berechnet; es gehört nicht zu den Daten der Kette.
- Methode und Versionen gespeichert. Das Ergebnis speichert die verwendete Methode, die Version der Bibliothek CondorcetPHP und die Version des Auszählungsvertrags, damit eine Nachzählung genau dieselbe Semantik nachvollzieht. Die Ergebnisseite zeigt die Methode und die Version der Bibliothek an.
- Die Stimmzettel im CEF-Format. Auf der Ergebnisseite herunterladbar. Die Datei dient nur der Bequemlichkeit: Sie lässt sich allein aus dem Register rekonstruieren, und ein Prüfer kann sie zum Vergleich neu erzeugen.
- Die Gewählten. Die ersten Plätze der neu berechneten Rangfolge, so viele, wie seats angibt, und nicht mehr.
Dieselben Daten, zwei Lesarten.
Die Registerseite ist die wichtigste Ansicht der veröffentlichten Daten, paginiert und durchsuchbar, aber nicht unveränderlich. Die Blockchain ist ein Weg, dieselben Daten zu verbreiten: per Hash verkettete, von der Plattform signierte JSON-Dateien, die jeder herunterladen und aufbewahren kann. Die Seite bindet sie als Unterabschnitt ein.
Öffentliche Adressen pro Wahl
- /elections/{election}/register
- Die Registerseite: Status der Wahl, Zähler, Teilnahmeliste, Ringe, Suche, Stimmzettel, Blockchain.
- POST /elections/{election}/register/lookup
- Die Suche nach einem Stimmzettel per Schlüsselabbild, mit Ratenbegrenzung; das Schlüsselabbild erscheint nie in einer URL.
- /elections/{election}/register/ballots/{ballot}
- Die Seite eines veröffentlichten Stimmzettels.
- /elections/{election}/register/rings/{ring}/keys
- Ein Ring als JSON: election_id, ring_id, ring_number, ring_digest, public_keys.
- /elections/{election}/results
- Das Ergebnis, nur im Status Published.
- /elections/{election}/results/ballots.cef
- Die Stimmzettel im CEF-Format, unter derselben Bedingung.
- /elections/{election}/chain
- Das Manifest der Blockchain, das zu jedem Block und seinen Sidecar-Dateien führt.
Diese Adressen haben kein Sprachpräfix und werden von Suchmaschinen nicht indexiert. Es gibt sie, solange die Wahl ein öffentliches Register hat, von Open bis Archived.
Was die Blockchain hinzufügt
- Dieselben Daten. Vier Blocktypen (configuration, rings, votes, closure), die genau den auf dieser Seite beschriebenen Inhalt tragen.
- Integrität. Jeder Block enthält den SHA3-512-Hash des vorherigen und eine abgetrennte Signatur der Plattform: Eine nachträgliche Änderung bricht die Kette für jeden späteren Beobachter.
- Unveränderlichkeit, die man prüfen muss. Die Signatur beweist die Herkunft, nicht die Unveränderlichkeit: Die Plattform besitzt ihren Schlüssel. Erst die von Dritten aufbewahrten Kopien und die Bitcoin-Verankerung über OpenTimestamps, die die Bytes jedes Blocks datiert, machen ein Umschreiben erkennbar.
- Ohne API. Statische Dateien, cachebar und archivierbar, die jeder spiegeln kann.
Was jeder allein anhand des Registers prüfen kann.
Ohne der Plattform zu vertrauen, nur mit den veröffentlichten Daten.
- 1 Jeder Stimmzettel ist von einem Mitglied seines Rings signiert. Für jeden Stimmzettel die Prüfung der Ringsignatur auf (Nutzdaten, ID der Wahl, Signatur, Schlüsselabbild, Ring) wiederholen.
- 2 Ein Schlüssel, ein Stimmzettel. Alle Schlüsselabbilder der Wahl sind verschieden: Kein Schlüssel wurde zweimal verwendet. Da ein Wähler mehrere Schlüssel erhalten haben kann, ergibt sich erst zusammen mit den Prüfungen 3 und 4 ein Stimmzettel pro Wähler.
- 3 Kein Stimmzettel in einen Ring eingeschleust. Für jeden Ring ist die Anzahl der Stimmzettel gleich der Anzahl der Zeilen in der Teilnahmeliste, deren Abstimmungsring dieser Ring ist.
- 4 Nicht mehr Stimmzettel als Wähler. Die Gesamtzahl der Stimmzettel übersteigt nicht die Anzahl der Zeilen mit has_voted: Diese Schranke ist der maßgebliche Schutz gegen das Einschleusen zusätzlicher Stimmzettel. Bei Stimmgewichtung bilden die signierten Gewichte und die Gewichte der Wähler in der Teilnahmeliste dieselbe Multimenge, mit der Summe voted_weight.
- 5 Die Nachzählung. Die Nutzdaten in CEF serialisieren und mit CondorcetPHP oder einer beliebigen CEF-Implementierung auszählen, unter den Bedingungen, die sich aus den veröffentlichten Stimmzettelregeln ergeben: Man erhält dieselbe Rangfolge und dieselben Zahlen gewerteter, leerer und ungültiger Stimmzettel.
- 6 Die Gewählten. Die ersten Plätze der neu berechneten Rangfolge ablesen, so viele, wie seats angibt.
Was jeder Wähler zusätzlich prüfen kann
- Seine Zeile in der Teilnahmeliste. Über seine Wähler-ID: abgestimmt oder nicht, Anzahl der erhaltenen Schlüssel. Eine in seinem Namen erfundene Aktivität fällt auf.
- Sein Ring. Der Ring-Hashwert in seinem Prüfbeleg, von seinem Browser berechnet, muss dem Wert entsprechen, den das Register veröffentlicht.
- Sein Stimmzettel. Mit dem Schlüsselabbild aus seinem Prüfbeleg findet er seinen Stimmzettel und prüft dessen Inhalt Byte für Byte, sogar vor der Veröffentlichung.
Die zentrale Garantie ist die feststehende Liste der signierten Stimmzettel: Prüfungen 1 bis 4, dazu die Integrität der Kette. Die Nachzählung ist eine Gegenprüfung: Kämen zwei Implementierungen zu verschiedenen Ergebnissen, läge ein Fehler in einer Berechnungssoftware vor, kein Mangel der Überprüfbarkeit.
PrüfverfahrenWas das Register nicht sagt.
Was es bewusst verschweigt, was es nicht beweisen kann und was es durchscheinen lässt.
Was es nicht offenlegt
- Keine Zeitstempel. Kein veröffentlichter Datensatz trägt ein Datum; die technischen Zeitangaben bleiben in der Datenbank.
- Keine Eingangsreihenfolge. Die Stimmzettel sind nach Schlüsselabbild sortiert, die Teilnahmeliste nach Wähler-ID: zwei verschiedene Sortierschlüssel ohne Bezug zur zeitlichen Abfolge.
- Keine Verbindung zwischen Wähler und Stimmzettel. Die Teilnahmeliste wird erst beim Ende der Stimmabgabe veröffentlicht, nie in Zeitfenstern: Ihre Zeilen lassen sich zeitlich nicht mit den Stimmzetteln abgleichen. Nur die nicht anonyme Stimmabgabe stellt diese Verbindung her, wenn der Organisator sie wählt.
- Standardmäßig keine Identität. Ohne namentliche Teilnahmeliste und ohne nicht anonyme Stimmabgabe enthält das Register keine Namensangaben; die Zuordnung von Wähler-ID zu Identität kennen nur die Plattform und der Organisator.
- Keine optische Gestaltung. Logo, Fotos der Kandidaten, Dankesnachricht: weder veröffentlicht noch gehasht.
Was es nicht beweisen kann oder durchscheinen lässt
- Der Moment der Stimmabgabe. Dass der Server einen Wähler nicht beobachtet hat, während er abstimmte: In diesem Moment ist die Plattform ein vertrauenswürdiger Dritter.
- Eine erfundene Teilnahme. Dass eine Zeile „hat abgestimmt“ nicht für jemanden erfunden wurde, der gar nicht abgestimmt hat: Das kann nur dieser Wähler feststellen.
- Wer im Ring signiert hat. Konstruktionsbedingt.
- Eine grobe Reihenfolge. Die votes-Blöcke folgen aufeinander: Jeder Stimmzettel eines Blocks wurde abgegeben, bevor der nächste Block versiegelt wurde, mit einer Granularität von mindestens 600 Stimmzetteln. Ebenso zeigt ein später veröffentlichter Ausweichring, dass seine Stimmzettel später kamen.
- Kleine Ringe und seltene Gewichte. In einem Ring, in dem nur ein Wähler abgestimmt hat, ist seine Wähler-ID mit seinem Stimmzettel verknüpft, bei namentlicher Teilnahmeliste auch sein Name. Der Organisator, der den Namen hinter jeder Wähler-ID kennt, kann diese Verknüpfung unabhängig vom Schlüsselmodus herstellen. Bei anonymer Stimmabgabe mit Stimmgewichtung verrät ein nahezu einmaliges Gewicht seinen Wähler.
- Eingetragene Wähler ohne Schlüssel. In einer Wahl, in der die Wähler ihren Schlüssel selbst hinterlegen müssen, kann ein eingetragener Wähler, der keinen hinterlegt hat, nicht abstimmen und erscheint derzeit nicht in der veröffentlichten Teilnahmeliste.
- Die Unveränderlichkeit der Seite. Die Registerseite kann sich ändern; die Unveränderlichkeit wird an der Blockchain geprüft, soweit Dritte Kopien davon aufbewahrt haben.
Siehe auch
- Signierter Stimmzettel Der Stimmzettel, wie der Wähler ihn signiert: Nutzdaten, Ringsignatur, Schlüsselabbild, Ring-Hashwert.
- Blockchain Das Zusatzprotokoll, das das Register versiegelt: Umschlag, vier Blocktypen, Serialisierung, Verkettung, Signatur, Zeitstempelung.
- Prüfverfahren Eine Wahl von Anfang bis Ende prüfen: allein anhand des Registers oder mit der Blockchain.