Zum Inhalt springen
Condorcet.vote Alpha
← Technische Dokumentation

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

Gemeinsames Format

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.
Prüfbeleg · .condorcet_receipt

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.
version Zeichenkette
Immer condorcet-receipt/1.
election UUID
Die Kennung der Wahl, ein Parameter der Signatur. Beim Lesen auch in Großbuchstaben akzeptiert, beim Schreiben immer in Kleinbuchstaben.
ring nicht leere Zeichenkette
Die Kennung (UUID) des Rings, unter dem der Stimmzettel signiert wurde, wie im Register veröffentlicht.
ring_digest ring_…
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_id UUID
Ihre Wähler-ID, die einzige veröffentlichte Kennung, die Sie betrifft.
public_key pk_…
Ihr öffentlicher Schlüssel, Mitglied des Rings aus dem Feld ring.
secret_key sk_…
Ihr geheimer Schlüssel, der den Stimmzettel signiert hat.
ballot.signed_payload Zeichenkette (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.signature blsag_…
Die Ringsignatur des Stimmzettels.
ballot.key_image ki_…
Das Schlüsselabbild des Stimmzettels, an diese Wahl gebunden: die öffentliche Kennung Ihres Stimmzettels im Register.
public/docs/voter-files.example_label · recu-vote-0c2e7e2a.condorcet_receipt
{
    "version": "condorcet-receipt/1",
    "election": "0c2e7e2a-5df3-4c0e-9d2b-3f6a8f0c9e21",
    "ring": "7b1d4f90-2c3a-4e8b-a6d5-91f0e2c47a38",
    "ring_digest": "ring_ffeeddccbbaa99887766554433221100ffeeddccbbaa99887766554433221100_8b7a6f5e",
    "voter_id": "3e9a5c71-8d24-4b6f-b0e3-5a7c19d2f846",
    "public_key": "pk_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef_a1b2c3d4",
    "secret_key": "sk_fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210_d4c3b2a1",
    "ballot": {
        "signed_payload": "{\"v\":1,\"election\":\"0c2e7e2a-5df3-4c0e-9d2b-3f6a8f0c9e21\",\"ballot\":\"Alice > Bob = Chloé\",\"weight\":1}",
        "signature": "blsag_0a1b2c3d4e5f6a7b0a1b2c3d4e5f6a7b0a1b2c3d4e5f6a7b0a1b2c3d4e5f6a7b0a1b2c3d4e5f6a7b0a1b2c3d4e5f6a7b0a1b2c3d4e5f6a7b0a1b2c3d4e5f6a7b_e5f6a7b8",
        "key_image": "ki_00112233445566778899aabbccddeeff00112233445566778899aabbccddeeff_5e6f7a8b"
    }
}

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.

Private Schlüsseldatei · .condorcet_private_key

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.
version Zeichenkette
Immer condorcet-private-key/1.
public_key pk_…
Der öffentliche Schlüssel, der bei der Hinterlegung an die Plattform übermittelt wurde.
secret_key sk_…
Der geheime Schlüssel, in Ihrem Browser erzeugt und nie übermittelt.
public/docs/voter-files.example_label · condorcet-vote-a1b2c3d4.condorcet_private_key
{
    "version": "condorcet-private-key/1",
    "public_key": "pk_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef_a1b2c3d4",
    "secret_key": "sk_fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210_d4c3b2a1"
}

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.

Geheimnisse

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.
Was ein Stimmnachweis offenlegt

Legen Sie fest, was Condorcet.Vote auf seinen öffentlichen Seiten misst. Ihre Auswahl wird auf diesem Gerät gespeichert und lässt sich jederzeit ändern.

Notwendig Immer aktiv

Sprache, Design und Speicherung dieser Auswahl.