Wählerdateien
Die beiden Dateien, die ein Wähler aufbewahren kann: der Prüfbeleg und die private Schlüsseldatei. Ihr Inhalt Feld für Feld, was sich damit prüfen lässt und was geheim bleiben muss.
Beide entstehen in Ihrem Browser und existieren nur, wenn Sie sie herunterladen. Die Plattform empfängt sie nicht, speichert sie nicht und verschickt sie nie. Beide enthalten Ihren geheimen Schlüssel.
Protokoll v1
Dieselben Regeln für beide Dateien.
Prüfbeleg und private Schlüsseldatei folgen denselben Konventionen; gelesen und geschrieben werden sie von der Bibliothek voter-artifacts der Abstimmungsseite. Für die kryptografische Gültigkeit der Werte (Prüfsumme, Zugehörigkeit zur Kurve) ist CryptoVote zuständig, nicht der Leser des Umschlags.
- Ein JSON-Objekt in UTF-8. Jede Datei ist ein einzelnes JSON-Objekt, in einer Zeile und ohne Leerzeichen geschrieben. Die Beispiele auf dieser Seite sind zur besseren Lesbarkeit eingerückt.
- Zuerst die Version. Das Feld version nennt den Umschlag und seine Version. Ein Leser muss es prüfen und jeden anderen Wert zurückweisen.
- Präfixierte Werte, nie bloßes Hex. Jeder kryptografische Wert ist die kanonische Zeichenkette <Kennung>_<hex>_<Prüfsumme>, die CryptoVote ausgibt, unverändert übernommen. Ein Hex-Wert ohne Präfix wird zurückgewiesen.
- Eine Prüfsumme gegen Tippfehler. 4 Byte BLAKE3 (8 Hex-Zeichen), über den Wert einschließlich Präfix: Ein falsch abgeschriebener Wert oder ein pk_, der statt eines ki_ eingefügt wurde, fällt sofort auf. Eine Sicherheitsgarantie ist das nicht. Die Authentizität beruht allein auf der Ringsignatur.
- Unbekannte Felder werden ignoriert. Ein Leser muss Felder, die er nicht kennt, ignorieren, damit er mit künftigen Versionen des Formats kompatibel bleibt; er schreibt sie nicht zurück.
Die Präfixe
-
pk_32 Byte · 64 Hex-Zeichen - Öffentlicher Schlüssel: der Schlüssel, der im Ring steht.
-
sk_32 Byte · 64 Hex-Zeichen - Geheimer Schlüssel: der Schlüssel, der signiert. Darf nie weitergegeben werden.
-
ki_32 Byte · 64 Hex-Zeichen - Schlüsselabbild (key image): die öffentliche Kennung eines Stimmzettels, an eine Wahl gebunden.
-
ring_32 Byte · 64 Hex-Zeichen - Ring-Hashwert: der kanonische Hashwert der Schlüsselmenge eines Rings, unabhängig von der Reihenfolge der Schlüssel.
-
blsag_32 × (1 + Ringgröße) Byte - bLSAG-Ringsignatur: 38.464 Hex-Zeichen bei einem Ring mit 600 Schlüsseln.
Der Prüfbeleg, ausgestellt nach Annahme des Stimmzettels.
Ihre persönliche Kopie des abgegebenen Stimmzettels, des Rings (in der Oberfläche „virtuelles Wahllokal“ genannt), unter dem Sie ihn signiert haben, und des Schlüssels, der ihn signiert hat. Damit finden und prüfen Sie Ihren Stimmzettel selbst im öffentlichen Register.
Wann, und in wessen Händen
- Erst nach der Annahme. Der Prüfbeleg erscheint auf der Abstimmungsseite erst, wenn der Server Ihren Stimmzettel angenommen hat. Er wird nur einmal angezeigt; das Herunterladen ist freiwillig.
- In Ihrem Browser erstellt. Die Seite setzt ihn aus dem geheimen Schlüssel zusammen, der seit dem Signieren im Speicher liegt. Er wird nie per E-Mail verschickt (die Bestätigungs-E-Mail belegt nur Ihre Teilnahme) und nie von der Plattform gespeichert.
- Nicht erneut ausstellbar. Die Plattform besitzt Ihren geheimen Schlüssel nicht mehr und kann den Prüfbeleg deshalb nicht neu erstellen. Auf der Seite liegen die sensiblen Werte hinter den Schaltflächen „Anzeigen“ und „Kopieren“. „Details endgültig ausblenden“ entfernt sie für immer vom Bildschirm, und der geheime Schlüssel löscht sich nach einer festen Frist von selbst. Kopieren Sie den Prüfbeleg vorher oder laden Sie ihn herunter.
Was Sie damit tun können
- Ihren Stimmzettel finden. Geben Sie ballot.key_image in die Suche des öffentlichen Registers der Wahl ein, auch vor der Veröffentlichung im Stapel, und vergleichen Sie den veröffentlichten Stimmzettel Byte für Byte mit signed_payload.
- Ihren Ring prüfen. Vergleichen Sie ring_digest mit dem Hashwert, den das Register für den Ring aus dem Feld ring veröffentlicht. Weichen sie ab, haben Sie unter einem anderen Ring signiert als dem veröffentlichten.
- Ihre Zeile in der Teilnahmeliste prüfen. voter_id bezeichnet Ihre Zeile in der Teilnahmeliste: Anzahl der Schlüsselübergaben, Vermerk „hat abgestimmt“.
- Die Signatur offline erneut prüfen. signed_payload, signature, die Kennung der Wahl und die öffentlichen Schlüssel des Rings genügen, um die Signatur ohne die Plattform erneut zu prüfen.
- Einen Stimmnachweis erstellen. Das Tool „Stimmnachweis“ liest den Prüfbeleg und übernimmt daraus den geheimen Schlüssel, die Wahl und das Schlüsselabbild.
-
versionZeichenkette - Immer condorcet-receipt/1.
-
electionUUID - Die Kennung der Wahl, ein Parameter der Signatur. Beim Lesen auch in Großbuchstaben akzeptiert, beim Schreiben immer in Kleinbuchstaben.
-
ringnicht leere Zeichenkette - Die Kennung (UUID) des Rings, unter dem der Stimmzettel signiert wurde, wie im Register veröffentlicht.
-
ring_digestring_… - Der Hashwert dieses Rings, von Ihrem Browser aus den erhaltenen Schlüsseln berechnet. Der Server liefert ihn nie mit, denn ein zusammen mit dem Ring gesendeter Wert ließe sich passend zu ihm manipulieren.
-
voter_idUUID - Ihre Wähler-ID, die einzige veröffentlichte Kennung, die Sie betrifft.
-
public_keypk_… - Ihr öffentlicher Schlüssel, Mitglied des Rings aus dem Feld ring.
-
secret_keysk_… - Ihr geheimer Schlüssel, der den Stimmzettel signiert hat.
-
ballot.signed_payloadZeichenkette (JSON) - Die signierten Nutzdaten (Payload), Byte für Byte: genau die Zeichenkette, die signiert und an den Server übermittelt wurde. Behandeln Sie sie als opake Zeichenkette: Neu geparst und neu kodiert, stimmt sie nicht mehr mit dem Register überein.
-
ballot.signatureblsag_… - Die Ringsignatur des Stimmzettels.
-
ballot.key_imageki_… - Das Schlüsselabbild des Stimmzettels, an diese Wahl gebunden: die öffentliche Kennung Ihres Stimmzettels im Register.
{
"version": "condorcet-receipt/1",
"election": "0c2e7e2a-5df3-4c0e-9d2b-3f6a8f0c9e21",
"ring": "7b1d4f90-2c3a-4e8b-a6d5-91f0e2c47a38",
"ring_digest": "ring_ffeeddccbbaa99887766554433221100ffeeddccbbaa99887766554433221100_8b7a6f5e",
"voter_id": "3e9a5c71-8d24-4b6f-b0e3-5a7c19d2f846",
"public_key": "pk_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef_a1b2c3d4",
"secret_key": "sk_fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210_d4c3b2a1",
"ballot": {
"signed_payload": "{\"v\":1,\"election\":\"0c2e7e2a-5df3-4c0e-9d2b-3f6a8f0c9e21\",\"ballot\":\"Alice > Bob = Chloé\",\"weight\":1}",
"signature": "blsag_0a1b2c3d4e5f6a7b0a1b2c3d4e5f6a7b0a1b2c3d4e5f6a7b0a1b2c3d4e5f6a7b0a1b2c3d4e5f6a7b0a1b2c3d4e5f6a7b0a1b2c3d4e5f6a7b0a1b2c3d4e5f6a7b_e5f6a7b8",
"key_image": "ki_00112233445566778899aabbccddeeff00112233445566778899aabbccddeeff_5e6f7a8b"
}
}
Fiktive Werte: ungültige Prüfsummen, Signatur auf ihre Mindestlänge gekürzt. Die zum Herunterladen angebotene Datei heißt recu-vote-, gefolgt von den ersten 8 Zeichen der Kennung der Wahl.
Die private Schlüsseldatei, heruntergeladen bei der Schlüsselhinterlegung.
Wenn Sie Ihren Schlüssel selbst hinterlegen, wird das Schlüsselpaar in Ihrem Browser erzeugt. Diese Datei ist seine Sicherungskopie: Mit ihr stimmen Sie später ab.
Wann, und in wessen Händen
- Bei der Hinterlegung eines erzeugten Schlüssels. In der Phase der Schlüsselhinterlegung einer Wahl oder einer Wahlgruppe, wenn Sie sich entscheiden, einen Schlüssel zu erzeugen. CryptoVote erzeugt das Schlüsselpaar in Ihrem Browser.
- Nur der öffentliche Schlüssel wird gesendet. public_key geht an die Plattform, die ihn einem Ring zuordnet. Der geheime Schlüssel wird einmal angezeigt und lässt sich kopieren; die Datei entsteht in Ihrem Browser.
- Ohne Wahl und ohne Gruppe. Die Datei enthält nur das Schlüsselpaar. Derselbe Schlüssel kann für mehrere unabhängige Wahlen dienen, weil das Schlüsselabbild erst beim Signieren an die jeweilige Wahl gebunden wird. Benannt ist die Datei nach dem Schlüssel selbst: condorcet-vote-, gefolgt von der Prüfsumme von public_key.
Was Sie damit tun können
- Abstimmen. Fügen Sie auf der Abstimmungsseite den Schlüssel sk_… ein oder laden Sie die Datei. Die Seite leitet daraus den öffentlichen Schlüssel ab und prüft, ob er in dem Ring steht, der Ihnen zugewiesen wurde.
- Denselben Schlüssel anderswo hinterlegen. Laden Sie bei einer anderen Hinterlegung die Datei. Der öffentliche Schlüssel wird im Browser ausgelesen, der geheime Schlüssel verlässt Ihr Gerät nicht.
- Ihren Stimmzettel finden, Ihre Stimme nachweisen. Mit dem geheimen Schlüssel und der Kennung einer Wahl berechnet das Tool „Stimmnachweis“ Ihr Schlüsselabbild neu, auch ohne Prüfbeleg.
-
versionZeichenkette - Immer condorcet-private-key/1.
-
public_keypk_… - Der öffentliche Schlüssel, der bei der Hinterlegung an die Plattform übermittelt wurde.
-
secret_keysk_… - Der geheime Schlüssel, in Ihrem Browser erzeugt und nie übermittelt.
{
"version": "condorcet-private-key/1",
"public_key": "pk_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef_a1b2c3d4",
"secret_key": "sk_fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210_d4c3b2a1"
}
Fiktive Werte, ungültige Prüfsummen. Kein Feld für Wahl oder Gruppe: Eine ältere Datei mit einem informativen Feld election bleibt lesbar, dieses Feld wird ignoriert.
Was geheim bleiben muss, und warum.
Beide Dateien enthalten Ihren geheimen Schlüssel. Behandeln Sie sie wie ein Passwort: Andere dürfen nicht an sie herankommen, verlieren dürfen Sie sie aber auch nicht.
Die Risiken, offen benannt
- Der geheime Schlüssel verrät Ihre Stimme. Mit ihm lässt sich Ihr Schlüsselabbild für jede beliebige Wahl berechnen. So findet man Ihre veröffentlichten Stimmzettel, auch rückwirkend, in jeder Wahl, in der er verwendet wurde, und kann in Ihrem Namen einen Stimmnachweis erstellen.
- Der geheime Schlüssel signiert. Er erzeugt eine gültige Signatur in jedem Ring, der Ihren öffentlichen Schlüssel enthält. Die Plattform nimmt einen Stimmzettel aber nur über Ihren Wahllink an, und nur einen pro Wähler.
- Der Prüfbeleg verrät Ihre Stimme jedem Leser. Er stellt Ihre Wähler-ID neben Ihren Stimmzettel. Er ist bewusst als Beweis geeignet: Das Protokoll gibt der individuellen Überprüfbarkeit den Vorrang und bietet deshalb keinen Schutz vor Nötigung. Zeigen Sie ihn nur jemandem, dem Sie Ihre Stimme offenlegen wollen.
- Schlüssel verloren, Stimme verloren. Für einen hinterlegten Schlüssel gibt es auf dem Server keinen Ersatz. Ist die Stimmabgabe eröffnet, können Sie ohne ihn nicht abstimmen. Solange die Hinterlegungsphase geöffnet ist, können Sie stattdessen einen neuen Schlüssel hinterlegen, für die Wahlen, deren Ringe noch nicht gebildet sind.
- Kein neuer Prüfbeleg bei Verlust. Ihr Stimmzettel zählt weiterhin. Haben Sie Ihren geheimen Schlüssel aufbewahrt, genügt er, um Ihr Schlüsselabbild neu zu berechnen und Ihren Stimmzettel zu finden.
Was die Plattform nie sieht
- Ihre Dateien. Prüfbeleg und private Schlüsseldatei werden in Ihrem Browser geschrieben und heruntergeladen; sie gehen nie über unsere Server.
- Einen selbst erzeugten geheimen Schlüssel. Er entsteht in Ihrem Browser und wird nie übermittelt. Wer bei einer Hinterlegung eine Schlüsseldatei lädt, sendet nur deren öffentlichen Schlüssel.
- Einen verteilten Schlüssel nach Ihrer Stimmabgabe. Im Standardmodus erzeugt die Plattform den Schlüssel und bewahrt ihn verschlüsselt auf. Aus ihrer Datenbank löscht sie ihn, sobald sie ihn Ihnen übergibt, aus ihrem temporären Cache bei der Stimmabgabe. Ihren Prüfbeleg kann sie danach nicht mehr rekonstruieren.
- Die Verbindung von Schlüssel und Stimmzettel. Ihr öffentlicher Schlüssel steht im veröffentlichten Ring, Ihr Stimmzettel im öffentlichen Register. Verknüpfen lassen sich beide nur mit dem geheimen Schlüssel.
Siehe auch
- Signierter Stimmzettel Der Stimmzettel, wie der Wähler ihn signiert: Nutzdaten, Ringsignatur, Schlüsselabbild, Ring-Hashwert.
- Öffentliches Register Was jede Wahl veröffentlicht, unabhängig vom Transportweg: Definition, Ringe, Teilnahmeliste, Stimmzettel.
- Stimmnachweis Der Umschlag cvproof/1: aus eigenem Entschluss nachweisen, dass ein veröffentlichter Stimmzettel der eigene ist. Der Nachweis legt die Stimme offen.