投票者のファイル
投票者が手元に保存できる2つのファイル、投票受領証と秘密鍵ファイルについて、フィールドごとの内容、確認できること、秘密にすべきことを説明します。
どちらもブラウザー内で作成され、ダウンロードした場合にだけ存在します。プラットフォームがこれらのファイルを受け取ることも、保存することも、送信することもありません。どちらのファイルにも秘密鍵が含まれています。
プロトコル v1
2つのファイルに共通のルール。
受領証と秘密鍵ファイルは同じ規則に従い、投票サイトのvoter-artifactsライブラリが読み書きします。値の暗号的な妥当性(チェックサム、曲線上の点であること)を確かめるのはCryptoVoteの役割で、エンベロープの読み取り側の役割ではありません。
- UTF-8のJSONオブジェクト1つ。 各ファイルは1つのJSONオブジェクトで、空白を入れずに1行で書かれます。このページの例は、読みやすいようにインデントしています。
- 先頭にバージョン。 versionフィールドが、エンベロープの種類とそのバージョンを示します。読み取り側はこれを確認し、ほかの値はすべて拒否しなければなりません。
- 接頭辞付きの値。接頭辞なしの16進は不可。 暗号に関わる値はすべて、CryptoVoteが出力する正規の文字列<タグ>_<16進の本体>_<チェックサム>を、そのまま写したものです。接頭辞なしの16進の値は拒否されます。
- 入力ミスを防ぐチェックサム。 BLAKE3の4バイト(16進8桁)で、タグも計算に含みます。写し間違えた値や、ki_の代わりに貼り付けたpk_は、すぐに検出されます。ただし、セキュリティを保証するものではありません。真正性を保証するのはリング署名だけです。
- 未知のフィールドは無視。 読み取り側は、知らないフィールドを無視しなければなりません。形式が将来変わっても互換性を保つためです。無視したフィールドは書き戻しません。
タグ
-
pk_32バイト · 16進64桁 - 公開鍵。リングに含まれる鍵です。
-
sk_32バイト · 16進64桁 - 秘密鍵。署名に使う鍵です。決して他人に知られてはなりません。
-
ki_32バイト · 16進64桁 - キーイメージ。投票用紙の公開識別子で、選挙ごとに異なります。
-
ring_32バイト · 16進64桁 - リングダイジェスト。リングに含まれる鍵の集合から求める正規のダイジェストで、鍵の順番には左右されません。
-
blsag_32 × (1 + リングの鍵数)バイト - bLSAGリング署名。鍵600個のリングでは16進38,464桁です。
投票用紙の受付時に発行される受領証。
投じた投票用紙、署名に使ったリング(インターフェースでは「仮想投票所」と呼びます)、署名した鍵の、ご自身用の控えです。これがあれば、公開台帳でご自身の投票用紙を見つけ、自分で検証できます。
いつ、誰の手に渡るか
- 受け付け後のみ。 受領証が投票ページに表示されるのは、サーバーが投票用紙を受け付けたあとだけです。表示されるのは一度だけで、ダウンロードは任意です。
- ブラウザー内で作成。 署名のときからメモリに残っている秘密鍵をもとに、ページが受領証を組み立てます。メールで送られることはなく(確認メールが証明するのは投票に参加したことだけです)、プラットフォームが保存することもありません。
- 再発行はできない。 プラットフォームはもう秘密鍵を持っていないため、受領証を作り直せません。ページ上では、機密性の高い値は「表示」と「コピー」のボタンの奥に隠れています。「詳細を完全に非表示にする」を押すと画面から完全に消え、秘密鍵も一定時間が経つと自動で消去されます。その前に、受領証をコピーするかダウンロードしてください。
この受領証でできること
- 投票用紙を見つける。 選挙の公開台帳の検索にballot.key_imageを入力します。バッチ単位で公開される前でも検索できます。見つかった投票用紙を、signed_payloadとバイト単位で比較してください。
- リングを確認する。 ring_digestを、ringで示されたリングについて公開台帳が公開しているダイジェストと比較します。一致しなければ、公開されたものとは別のリングで署名したことになります。
- 投票参加記録の行を確認する。 voter_idは、投票参加記録の中のご自身の行を指します。鍵の配布回数と「投票済み」の表示を確認できます。
- 署名をオフラインで再検証する。 signed_payload、signature、選挙の識別子、リングの公開鍵があれば、プラットフォームを使わずに署名を再検証できます。
- 投票証明を作成する。 「投票証明」ツールは受領証を読み込み、そこから秘密鍵、選挙、キーイメージを取り出します。
-
version文字列 - 常にcondorcet-receipt/1。
-
electionUUID - 選挙の識別子で、署名のパラメーターです。読み込み時は大文字も受け付け、書き出すときは常に小文字にします。
-
ring空でない文字列 - 投票用紙の署名に使ったリングの識別子(UUID)。公開台帳に公開されているものと同じです。
-
ring_digestring_… - そのリングのダイジェスト。受け取った鍵をもとに、ブラウザーが計算します。サーバーがこの値を提供することはありません。リングと一緒に送られた値なら、リングに合わせて細工できてしまうからです。
-
voter_idUUID - 投票者ID。ご自身について公開される唯一の識別子です。
-
public_keypk_… - 公開鍵。ringで示されたリングのメンバーです。
-
secret_keysk_… - 秘密鍵。投票用紙に署名した鍵です。
-
ballot.signed_payload文字列(JSON) - 署名済みペイロードを、バイト単位でそのまま収めたもの。署名され、サーバーに送信された文字列そのものです。中身を解釈しない文字列として扱ってください。解析して再エンコードすると、公開台帳との比較ができなくなります。
-
ballot.signatureblsag_… - 投票用紙のリング署名。
-
ballot.key_imageki_… - 投票用紙のキーイメージで、この選挙に固有の値です。公開台帳でご自身の投票用紙を示す公開識別子です。
{
"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"
}
}
値は架空のものです。チェックサムは無効で、署名は最小限の長さに切り詰めています。ダウンロードされるファイルの名前は、recu-vote-のあとに選挙の識別子の先頭8文字が続きます。
鍵の提出時にダウンロードする秘密鍵ファイル。
ご自身で鍵を提出する場合、鍵ペアはブラウザー内で生成されます。このファイルはそのバックアップで、投票するときに必要になります。
いつ、誰の手に渡るか
- 生成した鍵を提出するとき。 選挙または選挙グループの鍵の提出期間中に、鍵の生成を選んだ場合です。鍵ペアはCryptoVoteがブラウザー内で生成します。
- 送信されるのは公開鍵だけ。 public_keyがプラットフォームに送信され、プラットフォームがそれをリングに入れます。秘密鍵は一度だけコピーできる形で表示され、ファイルはブラウザー内で作成されます。
- 選挙もグループも含まない。 ファイルには鍵ペアしか含まれません。キーイメージは署名の時点で選挙ごとに固有の値になるため、同じ鍵を複数の独立した選挙で使えます。ファイル名は鍵そのものにちなんで付けられ、condorcet-vote-のあとにpublic_keyのチェックサムが続きます。
この秘密鍵ファイルでできること
- 投票する。 投票ページでsk_…の鍵を貼り付けるか、ファイルを読み込みます。ページが公開鍵を導き出し、割り当てられたリングに含まれているかを確認します。
- 同じ鍵をほかの選挙でも提出する。 別の提出の際にファイルを読み込むと、ブラウザー内で公開鍵が取り出されます。秘密鍵が端末の外に出ることはありません。
- 投票用紙を見つけ、投票を証明する。 秘密鍵と選挙の識別子があれば、受領証がなくても、「投票証明」ツールがキーイメージを計算し直します。
-
version文字列 - 常にcondorcet-private-key/1。
-
public_keypk_… - 公開鍵。提出時にプラットフォームに送信した鍵です。
-
secret_keysk_… - 秘密鍵。ブラウザー内で生成され、一度も送信されません。
{
"version": "condorcet-private-key/1",
"public_key": "pk_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef_a1b2c3d4",
"secret_key": "sk_fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210_d4c3b2a1"
}
値は架空のもので、チェックサムは無効です。electionフィールドもグループのフィールドもありません。参考情報としてelectionフィールドを含む古いファイルも読み込めますが、そのフィールドは無視されます。
秘密にすべきものと、その理由。
どちらのファイルにも秘密鍵が含まれています。パスワードと同じように、他人の手の届かないところに保管し、なくさないようにしてください。
リスクをありのままに
- 秘密鍵から投票内容がわかる。 秘密鍵があれば、どの選挙のキーイメージでも計算し直せます。そのため、その鍵を使ったすべての選挙で、公開された投票用紙をさかのぼって見つけられます。ご自身の名前で投票証明を作成することもできます。
- 秘密鍵は署名できる。 秘密鍵は、ご自身の公開鍵を含むどのリングでも有効な署名を作成できます。ただし、プラットフォームが投票用紙を受け付けるのはご本人の投票用リンクを通じた場合だけで、1人1件に限られます。
- 受領証を読めば、投票内容がわかる。 受領証には、投票者IDと投票用紙が並んで記載されています。設計上、証明に使えるものです。このプロトコルは個々の投票者による検証を重視しているため、強制耐性はありません。投票内容を明かしてもよいと決めた相手にだけ見せてください。
- 鍵をなくせば、投票できない。 提出した鍵の予備は、サーバー側にありません。投票受付が始まってから鍵をなくせば、投票できなくなります。鍵の提出期間中であれば、リングがまだ作られていない選挙について、代わりに新しい鍵を提出できます。
- 受領証をなくしても再発行されない。 投票用紙は引き続き集計されます。秘密鍵を保存していれば、それだけでキーイメージを計算し直し、投票用紙を見つけられます。
プラットフォームが決して見ないもの
- 投票者のファイル。 受領証と秘密鍵ファイルはブラウザー内で作成・ダウンロードされ、サーバーを経由することはありません。
- ご自身で生成した秘密鍵。 ブラウザー内で生成され、一度も送信されません。提出の際に鍵ファイルを読み込んでも、送信されるのは公開鍵だけです。
- 配布された鍵(投票後)。 既定のモードでは、プラットフォームが鍵を生成し、暗号化して保管します。鍵を渡した時点でデータベースから消去し、投票した時点で一時キャッシュからも消去します。そのため、プラットフォームが受領証を作り直すことはできません。
- 鍵と投票用紙の結び付き。 公開鍵は公開されたリングに、投票用紙は公開台帳に載っています。両者を結び付けられるのは秘密鍵だけです。