Zum Inhalt springen
Condorcet.vote Alpha
← Technische Dokumentation

Vertrauenswürdige Plattform

Wie die Plattform intern arbeitet: was sie während der Stimmabgabe tut, an welche Regeln sie sich hält und was sich danach im Register nachprüfen lässt.

Diese Seite beschreibt die Regeln auf der Ebene der Grundsätze, wie das Whitepaper: Datenbank, Signaturfenster, Transport, Veröffentlichung, Umgang mit Geheimnissen, Hosting. Die Regeln ersetzen keine Überprüfung. Jede Aussage der Plattform wird im Register veröffentlicht und lässt sich ohne sie prüfen.

Protokoll v1

Vertrauensmodell

Vertrauenswürdig während der Stimmabgabe, danach überprüfbar.

Die Plattform ist ein vertrauenswürdiger Dritter, dem man nur für begrenzte Zeit vertrauen muss. Diese Angriffsfläche ist eine bewusste und dokumentierte Entwurfsentscheidung, kein Versehen.

  • Während der Stimmabgabe

    Was ihr anvertraut ist

    Die Plattform liefert die Abstimmungsseite aus, übergibt im standardmäßigen Bereitstellungsmodus die geheimen Schlüssel und empfängt jeden signierten Stimmzettel über die VoteLink-Sitzung des Wählers. In diesem Zeitfenster weiß sie vorübergehend, wer abstimmt, und im Standardmodus auch, welchen Schlüssel sie wem übergeben hat.

  • Danach

    Was sich ohne sie prüfen lässt

    Jede ihrer Aussagen ist im öffentlichen Register festgehalten und unabhängig überprüfbar. Die beiden Seiten des Registers, Teilnahmeliste und Stimmzettel, werden so veröffentlicht, dass sie sich nicht zu einer Verbindung zwischen Wähler und Stimmzettel zusammenführen lassen.

Wie viel Vertrauen nötig ist, wird pro Wahl festgelegt. Im Modus BYO-only bringt jeder Wähler seinen eigenen Schlüssel mit: Die Plattform besitzt dann nie das Signaturgeheimnis eines Wählers, und das Vertrauensfenster beschränkt sich auf den Empfang der Stimmzettel.

Wozu die Rolle als „vertrauenswürdiger Dritter“ die Plattform verpflichtet und wozu nicht, steht in der Charta. Diese Rolle ist weder eine Zulassung noch eine von einer Behörde erteilte Zertifizierung noch ein Gütesiegel.

Die Charta des vertrauenswürdigen Dritten
Datenbank

PostgreSQL entscheidet allein.

Jede Invariante, auf die sich Nutzer verlassen, setzt PostgreSQL mit abgesicherten bedingten Schreibvorgängen und Eindeutigkeitsbedingungen durch, nie ein Zustand im Arbeitsspeicher eines Prozesses. Das ist per Konstruktion korrekt, unabhängig von der Zahl der Worker und Instanzen, ohne Sperrreihenfolge und ohne Deadlocks.

Die im Schema verankerten Regeln

ballots (election_id, key_image) eindeutig
Ein Schlüsselabbild stimmt pro Wahl nur einmal ab. Ein Sicherheitsnetz, das selbst bei einem Anwendungsfehler hält.
ring_keys (election_id, public_key) eindeutig
Ein öffentlicher Schlüssel kommt unter den Ringmitgliedern der Wahl nur einmal vor.
chain_blocks (election_id, block_number) eindeutig
Die letzte Absicherung gegen Verzweigungen der Kette: Ein unterlegener paralleler Schreiber scheitert und versucht es erneut am neuen Kettenkopf.
ballots append-only · Trigger
Jedes UPDATE oder DELETE löst eine Ausnahme aus. Einzige festgeschriebene Ausnahme: das Flag is_chain_published, das in der Transaktion, die einen Block festschreibt, von false auf true wechselt.
chain_blocks append-only · Trigger
Dieselbe Regel für die Kettenanker. Einzige Ausnahme ist der OpenTimestamps-Status, der sich nur in eine Richtung ändert: pending → completed.
ballots.payload bytea
Die signierten Bytes, unverändert gespeichert. Nie in einem normalisierenden JSON-Typ: jsonb ordnet die Felder neu und schreibt Leerraum um, was die bytegenaue Prüfung zunichtemachen würde.
ballots.id UUID v4, ohne Zeitstempel
Eine zufällige Kennung und kein Erstellungsdatum: Nichts verrät die Reihenfolge der Abgabe.
Was das Register veröffentlicht

Schreibvorgänge ohne Race Conditions

  • Abgesicherte Schreibvorgänge. Das Umschalten von has_voted, die Obergrenze der Schlüsselverteilung und das Beanspruchen eines Schlüssels sind bedingte UPDATEs: Wird keine Zeile geändert, gilt das als Ablehnung. Nie ein Lesen-Ändern-Schreiben im Speicher.
  • Kryptografie ohne Sperre. Die Signaturprüfung, eine reine Berechnung auf öffentlichen Daten, läuft vor der Schreibtransaktion. Die Kryptografie hält also nie eine Sperre.
  • Offene Wahl, erneut geprüft. Bei der Abgabe wird in der Transaktion erneut geprüft, dass die Wahl offen ist, serialisiert gegenüber dem Schließen der Stimmabgabe. Ein Stimmzettel wird entweder vor dem Schließen festgeschrieben und mit ihm veröffentlicht, oder er wird abgelehnt. Nie ein gespeicherter Stimmzettel, den die Kette auslassen würde.
  • Serialisierte Blöcke. Blöcke entstehen in Jobs aus einer Warteschlange, pro Wahl serialisiert; die festgeschriebene Zeile in der Datenbank entscheidet über jeden Block.
Daten & Chronologie

Nur das Nötige behalten, nichts datieren.

Die Plattform speichert nichts, was das Protokoll nicht braucht, und veröffentlicht nichts, was einen Stimmzettel datiert oder identifiziert. Der Zeitpunkt der Stimmabgabe gilt als Seitenkanal und wird durchgängig beseitigt.

Datenminimierung

  • Die Daten des Wählers. Seine E-Mail-Adresse, optional sein Name und sein Gewicht: Mehr wird vom Organisator nicht verlangt.
  • Geheimnisse verschlüsselt, dann gelöscht. Die geheimen Wahlschlüssel werden verschlüsselt gespeichert und gelöscht, sobald sie verwendet werden. Nach der Übergabe existiert ein Schlüssel nicht mehr in der Datenbank. Er bleibt nur verschlüsselt in einem Cache erhalten, höchstens 180 Minuten lang für eine erneute Übergabe, und wird bei der Stimmabgabe daraus gelöscht.
  • Bereinigter Speicher. Flüchtige Geheimnisse werden ausdrücklich mit Nullen überschrieben, auf der PHP-Seite (Wertobjekte auf Basis von sodium_memzero) ebenso wie auf der Rust/WASM-Seite (genullte Puffer).
  • Kein Tracking. Weder Webanalyse noch Tracking auf den Abstimmungsseiten: Es bleiben nur die Serverprotokolle.

Keine zeitlichen Spuren

  • Kein Zeitstempel am Stimmzettel. Weder in der Datenbank noch im Register; zufällige UUID-v4-Kennungen auf der gesamten öffentlichen Oberfläche.
  • Veröffentlichung in Stapeln. Die Stimmzettel erscheinen in Stapeln von mindestens 600, nach einem zufälligen Zeitplan und sortiert nach Schlüsselabbild. Die Teilnahmeliste wird nur einmal veröffentlicht, beim Schließen der Stimmabgabe.
  • Physische Bereinigung. PostgreSQL versieht jede Zeile mit einem Stempel der Transaktion, die sie geschrieben hat. Ein Stimmzettel und der zugehörige Vermerk in der Teilnahmeliste tragen deshalb kurz denselben Stempel: In einem logischen Export ist er unsichtbar, mit direktem Datenbankzugriff aber lesbar. Ein Job schreibt diese Zeilen zweimal täglich in einer einzigen neutralen Transaktion neu und führt danach ein VACUUM aus. Ein frischer Stempel überdauert so höchstens einen Bereinigungszyklus.
Signaturfenster & Transport

Den Moment schützen, in dem der Schlüssel im Speicher liegt.

Der geheime Schlüssel des Wählers existiert in seinem Browser nur, solange die Abstimmungsseite geöffnet ist. Auf der Client-Seite ist das der verwundbarste Moment, und die Plattform schützt ihn am strengsten.

Die Abstimmungsseite

  • Eigenständig. Eine Seite ohne Framework, außerhalb der Anwendung des Organisators. Wer die Abstimmung verlässt, löst immer ein vollständiges Neuladen aus, das den Schlüssel aus dem Speicher löscht.
  • Die strengste CSP. Nur eigene Ressourcen, kein Skript von Dritten, keine Webanalyse; WASM-Ausführung erlaubt, Formularübermittlung deaktiviert, die Abgabe erfolgt ausschließlich per fetch.
  • Integrität des signierenden Codes. Die kompilierten Assets tragen Subresource-Integrity-Hashwerte (SHA-384): Ein kompromittierter CDN-Knoten kann den Code, der signiert, nicht unbemerkt verändern.
  • Eigene Subdomain. Die Stimmabgabe läuft auf voting.condorcet.vote, mit Cookies, die auf diesen Host beschränkt sind. Der Sitzungszustand der Stimmabgabe ist vom Rest der Website getrennt.

Transport, Links und Sitzungen

  • TLS bis zur Anwendung. Die TLS-Verschlüsselung übernimmt der Webserver der Anwendung selbst, Caddy (in Go geschrieben, über FrankenPHP), ohne zwischengeschalteten Proxy. Seine Zertifikate von Let's Encrypt werden automatisch ausgestellt und erneuert, jeder HTTP-Zugriff wird auf HTTPS umgeleitet, und moderne TLS-Einstellungen gelten standardmäßig: TLS 1.3 bevorzugt, mindestens 1.2.
  • Kein Zugriffsprotokoll bei der Stimmabgabe. Die Subdomain der Stimmabgabe wird nie protokolliert. Ihre Adressen enthalten das Token des VoteLink, und Protokolle mit Zeitstempel würden die Chronologie der Stimmabgabe wiederherstellen, die die Datenbank bewusst nicht speichert.
  • Direkt zum Ursprungsserver, über TLS. Ringe (in der Oberfläche „virtuelle Wahllokale“ genannt), Schlüsselverteilung und Abgabe der Stimmzettel laufen direkt zwischen Browser und Plattform. Bei Abstimmungsdaten ist kein CDN dazwischengeschaltet; nur die kompilierten statischen Assets werden am Netzwerkrand zwischengespeichert.
  • Ein Berechtigungslink, ohne Konto. Der Wähler legt weder Konto noch Passwort an. Sein VoteLink, den die Plattform per E-Mail verschickt, ist eine Inhaberberechtigung (bearer capability). Gespeichert wird nur der Hashwert des Tokens; der Link gehört zu genau einem Wähler, seine Sitzung hat einen engen Geltungsbereich, und die Zahl der Anfragen ist begrenzt.
  • Serverseitige Sitzungen. Die Sitzungen liegen in Valkey (Redis). Im Browser steht nur der unbedingt nötige Zustand: Sitzung, Sprache, Design.
  • Der Rest der Website. Alles, auch Skripte und WASM, wird von der eigenen Domain ausgeliefert, unter einer strengen CSP; die öffentlichen Seiten laden nichts von fremden Ursprüngen.
  • Organisatoren. Anmeldung mit Passwort oder Passkey, optionaler zweiter Faktor per TOTP, Anmeldeversuche begrenzt pro Benutzerkennung und pro IP-Adresse.
Veröffentlichung & Signatur

Was die Anwendung nicht umschreiben kann.

Ein Block ist genau dann gültig, wenn seine Bytes den festgeschriebenen Hash ergeben und seine Signatur die Prüfung besteht, gleich woher er gelesen wird. Der Speicher setzt zusätzlich eigene Schranken.

Getrennte Veröffentlichung

  • Eigener Speicher. Die Dateien der Kette liegen in einem eigenen Object-Storage-Bucket mit eigenen Zugangsdaten, getrennt von allen anderen gespeicherten Inhalten, und werden über einen eigenen CDN-Hostnamen ausgeliefert. Ein Fehler in einem Upload-Pfad kann deshalb nie in die Kette schreiben.
  • Nur einmal beschreibbar. Für den Bucket ist die Objektsperre (Object Lock) des Anbieters aktiviert: Eine einmal geschriebene Blockdatei lässt sich weder überschreiben noch löschen, auch nicht mit den Speicherzugangsdaten der Plattform. Das ergänzt die Trigger in der Datenbank und die Hash-Kette.
  • Rohe Bytes. Die Blöcke werden unverändert ausgeliefert; keine Framework-Schicht kann sie umformatieren. Da der Inhalt deterministisch ist, ist ein wiederholter Schreibvorgang idempotent.

Der Signaturschlüssel

  • Ein fest versioniertes Werkzeug. Jeder Block wird in Hintergrund-Jobs mit OpenPGP v6 (RFC 9580, Ed25519) signiert, von einer fest versionierten, mitgelieferten Ausgabe von Sequoia sq. Auf der PHP-Seite findet keine Signaturberechnung statt.
  • Private Schlüssel außerhalb der Datenbank. Die öffentlichen Zertifikate liegen in der Datenbank, die privaten Schlüssel gelangen nie hinein. Verwahrt werden sie im Secret Manager von OVHcloud (OKMS), nach den strengsten Sicherheitsstandards: verschlüsselt gespeichert, eine isolierte Domäne pro Umgebung, Zugriff per Client-Zertifikat über gegenseitiges TLS. OKMS bewahrt sie nur auf. Signiert wird weiterhin lokal, mit einer fest bestimmten Version des Schlüssels, deren Fingerabdruck vorher geprüft wird.
  • Rotation mit klarer Grenze. Bei einer Rotation läuft der bisherige Schlüssel im selben Augenblick ab, und seine Versionen werden deaktiviert. Signaturen eines außer Dienst gestellten Schlüssels lassen sich weiterhin prüfen, neue erzeugt er nicht mehr.
  • Was die Signatur nicht beweist. Die Signatur beweist, dass die Plattform einen Block erzeugt hat, nicht aber, dass sie die Geschichte der Kette nicht umgeschrieben hat, denn sie besitzt den Schlüssel. Die Unveränderlichkeit ergibt sich aus der unabhängigen Spiegelung, und die OpenTimestamps-Verankerung jedes Blocks beweist, wann seine Bytes existierten.
Hosting & Entwicklung

Wo sie läuft, wie sie gebaut ist.

Der Betrieb im weiteren Sinne wird hier nicht beschrieben. Aufgeführt sind nur die Punkte, an denen eine Garantie hängt.

Hosting

  • In Frankreich. Die Plattform wird in Frankreich gehostet, und alles wird von ihrer eigenen Domain ausgeliefert: Im Browser der Wähler lädt kein Dienst eines Dritten.
  • Ein schlanker Stack. PostgreSQL für die Daten; Valkey für Sitzungen, Warteschlangen und Cache, nie als Hauptspeicher. Getrennte Job-Warteschlangen, damit eine Lastspitze auf einer davon den anderen nie die Worker entzieht.
  • Geheimnisse außerhalb der Konfiguration. In den Server-Umgebungen stehen keine Zugangsdaten in Umgebungsdateien. Sie alle verwahrt OKMS, der Secret Manager von OVHcloud, mit einer isolierten Domäne pro Umgebung.

Entwicklungsdisziplin

  • Echte Kryptografie in den Tests. Die Testsuite nutzt das echte WASM-Modul, nie einen Mock, auf dem Server wie im Browser, bis hin zu vollständigen, browsergesteuerten Abstimmungsabläufen.
  • Fixierte Testvektoren. Der kryptografische Kern fixiert Protokollvektoren: Jede stillschweigende Änderung an einem Domain-String, einem Format oder einer Byte-Anordnung lässt den Build scheitern. Außerdem prüft er alle seine Parser bitweise auf Verformbarkeit (Malleability) und mit Fuzzing-Zielen, und er auditiert seine Abhängigkeiten in der CI.
  • Synchrone Spezifikationen. Die Spezifikationen werden mit dem Code versioniert und nach einer ausdrücklichen Konvention mit ihm auf demselben Stand gehalten. Das Whitepaper und diese Seiten sind ihre veröffentlichte Form.
Grenzen

Was Vertrauenssache bleibt.

Diese Grenzen sind dokumentiert, nicht verschwiegen. Betroffen ist vor allem der Zeitraum der Stimmabgabe; danach begrenzt das Register, was eine Plattform unbemerkt tun könnte.

Was man ihr anvertrauen muss

  • Eine böswillige Plattform während der Stimmabgabe. Erzeugt der Server die Schlüssel, könnte die Plattform das Schlüsselabbild jedes übergebenen Schlüssels vorab berechnen und die Stimmzettel deanonymisieren. Importierte oder vom Wähler hinterlegte Schlüssel nehmen ihr diese Möglichkeit; Wahlen im Modus BYO-only lassen kein Geheimnis mehr auf dem Server.
  • Eine erfundene Teilnahme. Die Plattform könnte einen Wähler, der nicht abgestimmt hat, als abgestimmt markieren und innerhalb der veröffentlichten Grenzen einen Stimmzettel hinzufügen. Nur der betroffene Wähler kann das erkennen, indem er seine eigene Zeile in der Teilnahmeliste prüft.
  • Der Browser während der Signatur. Eine Skript-Injektion im Signaturfenster bleibt das Restrisiko auf der Client-Seite: Die CSP verringert es, kann es aber nicht ausschließen.
  • Gespeicherte Kontaktdaten. Namen und E-Mail-Adressen der Wähler liegen im Klartext vor, denn die VoteLinks werden per E-Mail verschickt und der Organisator braucht eine lesbare Liste. Eine Kompromittierung der Datenbank würde sie offenlegen. Die geheimen Wahlschlüssel dagegen sind immer verschlüsselt.
  • Der physische Speicher. Archivierte WAL-Dateien, Sicherungen und Zugriffsprotokolle des Webservers bleiben eine Frage der Infrastruktur und der Aufbewahrungsfristen.
  • Eine externe Prüfung steht noch aus. Eine unabhängige Prüfung des Protokolls und seiner Implementierung ist geplant; ihr Bericht wird auf der Seite „Sicherheit“ verlinkt.

Was dieses Vertrauen begrenzt

  • Das Register. Gültige Ringsignaturen, kein Schlüssel, der zweimal signiert hat, nicht mehr Stimmzettel als Wähler mit erfasster Stimmabgabe: Alles lässt sich allein anhand des veröffentlichten Registers prüfen.
  • Die Nachzählung. Das Ergebnis wird aus dem Register neu berechnet, mit einer anderen Software als der der Plattform.
  • Die Kette und ihre Spiegel. Rohdateien, signiert und verkettet, die jeder aufbewahren kann. Ein Umschreiben fällt jedem Zeugen auf, der einen früheren Kettenkopf aufbewahrt hat.
  • Der Code, auf den es ankommt. Der kryptografische Kern (CryptoVote) und die Auszählungsbibliothek (CondorcetPHP) sind Open Source: Was signiert, prüft und auszählt, kann jeder einsehen.
  • Schriftliche Zusagen. Die Charta legt fest, wozu sich die Plattform verpflichtet und wozu nicht. Ein veröffentlichtes Register wird nie auf Wunsch des Organisators zurückgezogen oder geändert.

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.