ドキュメント
公開鍵の解決
method は、検証者が公開鍵を取得する場所を指定します。有効な署名が示すのは「解決した鍵の保持者が、このバイト列に署名した」という事実です。その鍵が誰に結び付くかは方式によって異なります。
方式と鍵の取得先
| 方式 | 鍵の取得先 | 結び付く対象 |
|---|---|---|
dns |
selector があれば
<selector>._mdsig.<signer>、なければ
_mdsig.<signer> の TXT レコード。値は
v=mdsig1; k=ed25519; p=<base64>。レコードが複数あれば、いずれかで検証できれば有効(鍵のローテーション用)。ブラウザなどシステムのリゾルバを使用できない環境では
DNS-over-HTTPS で取得する。 |
ドメインの運用者 |
git-hosting |
https://<signer>.keys(例:https://github.com/alice.keys)の
ssh-ed25519
行。key_fp(SHA256:…)があればその鍵のみを使用する。sig
はペイロードに対する生の Ed25519 署名で、ssh-keygen -Y sign の SSHSIG 形式は使用しない。 |
Git ホスティングサービスのアカウント |
tofu |
ブロック内の pubkey: ed25519:<base64>。状態を保持する検証者は signer と pubkey の対応を記録し、同じ signer の鍵が変化すれば、利用者が新しい鍵を承認するまで invalid(key-changed)とする。 |
鍵そのもののみ。署名後に改変されていないことは示すが、署名者が誰であるかは示さない。 |
pgp |
fpr の鍵を、ローカルの鍵束、signer のドメインの WKD、検証者が設定した鍵サーバ(既定は keys.openpgp.org)の順に取得を試みる。鍵サーバは署名ブロックでは指定できない。署名は gpg でも作成できるため、スマートカード上の鍵も使用できる。 |
メールアドレス(WKD ではドメインの運用者、keys.openpgp.org では確認済みのアドレス) |
dns、git-hosting、pgp(WKD・鍵サーバ)は検証時点の鍵を取得します。署名者が鍵を削除すると古い署名は検証できなくなり、ドメインやアカウントが乗っ取られると攻撃者の鍵が公開されます。どちらも文書だけでは検出できないため、長期の証拠にはタイムスタンプと公開鍵のスナップショットを併用します(「長期保存」を参照)。
パスキー(alg: webauthn-es256)
認証器は任意のデータには署名しません。生成者は
challenge = SHA-256(payload) と rpId = rp_id を指定して
navigator.credentials.get() を呼び出し、応答を3つのフィールドに格納します。公開鍵は
tofu(pubkey: es256:…)または
dns(k=es256)から取得します。
challenge = SHA-256(payload)
signed = authenticatorData || SHA-256(clientDataJSON)
sig = "base64:" DER(ECDSA-P256-SHA256(signed))
検証者の確認事項
clientDataJSONのtypeがwebauthn.getで、challengeがSHA-256(payload)の base64url と一致する。originのホストがrp_idまたはそのサブドメインで、localhost以外は https である。authenticatorDataの先頭32バイトがSHA-256(rp_id)と等しく、User Present フラグが立っている。- 上の式の
signedに対する ECDSA P-256 / SHA-256 署名が、候補のes256鍵で検証できる。
公開鍵の公開手順
検証者が鍵を取得できるよう、署名の前に方式ごとの公開先へ鍵を登録します。CLI の mdsig keygen は Ed25519 の鍵ペアと、DNS に登録する TXT レコードを出力します。
dnsmdsig keygen -o ~/.mdsig/example -d example.com --selector 2026
# DNS TXT record:
# 2026._mdsig.example.com. IN TXT "v=mdsig1; k=ed25519; p=11qY…URo="
mdsig sign file.md -m dns -s example.com --selector 2026 -k ~/.mdsig/example
表示された TXT レコードをドメインの DNS に登録します。セレクタを変えて複数のレコードを置けば、鍵を切り替える期間も古い署名を検証できます。
git-hostingmdsig sign file.md -m git-hosting -s github.com/alice
GitHub に登録済みの ssh-ed25519 鍵をそのまま使用します。鍵は ssh-agent または ~/.ssh/id_ed25519 から自動で検出します。
pgpgpg --quick-gen-key "Alice <[email protected]>" ed25519 sign,cert
gpg --export [email protected] | curl -T - https://keys.openpgp.org
mdsig sign file.md -m pgp
keys.openpgp.org はメールアドレスの確認後に鍵を公開します。ドメインを運用している場合は WKD での公開も可能です。-s を省略すると、鍵のユーザ ID のメールアドレスを signer とします。
tofumdsig keygen -o ~/.mdsig/bob
mdsig sign file.md -m tofu -s bob@laptop -k ~/.mdsig/bob
公開の手順は不要です。署名者の識別は検証者に委ねられるため、鍵のフィンガープリントを別の経路で伝達してください。
dns と git-hosting の署名では、--embed-key で署名に用いた鍵をブロックに埋め込めます。鍵を削除した後も、その鍵で署名が成立することを確認できます。詳しくは「長期保存」の「公開鍵のスナップショット」を参照してください。