ドキュメント

長期保存

dns、git-hosting、pgp の公開鍵は検証のたびに取得します。署名者が鍵を削除すると古い署名は検証できなくなり、ドメインやアカウントが乗っ取られると第三者の鍵が公開されます。このページでは、数年後の検証に備えて文書に証拠を保持する方法を説明します。

3つの手段

ts は署名者の申告にすぎません。第三者の時刻認証局(TSA)による RFC 3161 タイムスタンプと、署名に用いた公開鍵の埋め込みを組み合わせて使用します。

手段 示すこと 付与の時点 指定方法
tsa_token その署名が、TSA の時刻に存在したこと 署名時。tsa_url と tsa_token はペイロード外のため、仕様上は署名後にも付与できる mdsig sign --tsa
tsaUrl
method: tsa それより前のチェーン全体(以前のタイムスタンプを含む)が、TSA の時刻に存在したこと いつでも、何度でも。末尾に追記する mdsig timestamp
timestampDocument
pubkey 署名に用いた公開鍵そのもの。鍵が削除された後も、その鍵で署名が成立することを確認できる 署名時のみ(ペイロード内) mdsig sign --embed-key
embedKey

スナップショットだけでは、その鍵が署名者のものだったことは示せません。タイムスタンプと併用すると、「この鍵による署名が、この時刻に存在した」ことまでを示せます。

署名へのタイムスタンプ(tsa_token)

署名ブロックに tsa_url と tsa_token を付与すると、その署名がある時刻に存在したことを TSA が証明します。証拠のチェーンは document → hash → sig → tsa_token です。

生成者の手順

  1. sig の base64 をデコードしたバイト列の SHA-256 を計算する。
  2. その値を messageImprint とし、certReq を TRUE に、ランダムな nonce を付与した TimeStampReq を tsa_url に送信する。
  3. DER 形式の TimeStampResp 全体を tsa_token に格納する。形式は gzip+base64: を推奨。

検証者の確認事項

  1. 応答ステータスが granted または grantedWithMods で、messageImprint が SHA-256(sig の生バイト列) と一致する。
  2. トークンの CMS 署名と TSA 証明書チェーンを、検証者が選択したトラストストアに照らして検証する。成功した場合に限り、genTime と TSA の名前を報告する。
  3. 展開後のサイズは 1 MB まで。tsa_token はペイロード外で第三者が差し替えられるため、上限を設ける。
証拠のチェーン
document → hash → sig → tsa_token
messageImprint = SHA-256(base64-decode(sig))
tsa_token を持つブロック
<!-- md-signature
v: 0.0.2
method: git-hosting
signer: github.com/alice
…
sig: base64:q1Xv…
tsa_url: http://ts.ssl.com
tsa_token: |
  gzip+base64:H4sIAAAAAAAA/+3SW0hTURwG8G+m…
-->

CLI は mdsig sign --tsa で付与します(URL を省略すると http://ts.ssl.com)。チェーンを検証できないトークンでも署名自体の判定は変わりませんが、時刻は表示しません。

タイムスタンプ専用ブロック(method: tsa)

署名者を持たないブロックで、それより前のチェーン全体がある時刻に存在したことを示します。TSA 証明書の失効やハッシュアルゴリズムの危殆化に備え、重ねて追記することでタイムスタンプを更新できます。考え方は RFC 4998 と同じです。

キー 内容
method alg method: tsa と alg: rfc3161 の組。一方だけを持つブロックは malformed。
signer TSA の http:// または https:// の URL。検証で認証されるのはトークンの TSA 証明書で、この値ではない。
hash 通常のブロックと同じく、スライスのダイジェスト。sha256 または sha512。
sig DER 形式の TimeStampResp。messageImprint は、署名対象ペイロードを hash と同じアルゴリズムでダイジェストした値。
v ts reason x_* v は 0.0.2 以降。ts は生成者の申告。任意で reason と x_*。ほかのフィールドを含むブロックは malformed。

検証の手順(5.4 節の手順 4 以降に代えて)

  1. トークンをデコードできない malformed
  2. 応答ステータスが granted または grantedWithMods でない、または messageImprint のアルゴリズムと値がペイロードのダイジェストと一致しない invalid · bad-signature
  3. CMS 署名と TSA 証明書チェーンを検証できた。genTime と TSA の名前を報告する valid
  4. チェーンを、検証者のトラストストアに照らして検証できない unresolved · not-found

tsa ブロックは require を満たしません。署名ブロックのないファイルには追記できません。

重ねて追記したタイムスタンプ
  1. 本文
  2. method: git-hosting署名。本文を対象とする
  3. method: tsahash: sha256:…本文と署名を対象とする
  4. method: tsahash: sha512:…更新。以前のタイムスタンプも含めて対象とする

SHA-256 の危殆化に備える更新では --hash sha512 を指定します。古い TSA 証明書が期限切れや失効となる前に、新しいブロックを追記してください。

tsa ブロック(examples/valid-tsa-renewal.md)
<!-- md-signature
v: 0.0.2
method: tsa
signer: http://ts.ssl.com
reason: renewal
ts: 2026-11-16T09:40:00Z
alg: rfc3161
hash: sha512:8b911dfab58d07761aff28d482fb390a…
sig: |
  gzip+base64:H4sIAAAAAAAAE82YeTyU6/vH53lmjGEwZDdh…
-->
CLI で追記する
mdsig timestamp contract.md
mdsig timestamp contract.md --hash sha512 --reason renewal

公開鍵のスナップショット(pubkey)

dns と git-hosting のブロックは、署名に用いた公開鍵を pubkey に埋め込めます(v が 0.0.2 以降、指定した場合のみ)。pgp のブロックには埋め込めません。pubkey は署名者自身が書いた値で、偽造者も自身の鍵を埋め込めるため、公開中の鍵との照合を経なければ有効とはしません。

検証の結果

状況 結果
鍵種別が alg と一致しない、デコードできない、key_fp が pubkey のフィンガープリントと一致しない malformed
埋め込まれた鍵で sig が成立しない。鍵の取得より前に判定するため、オフラインでも確定する invalid · bad-signature
公開中の鍵に、埋め込まれた鍵と同じ鍵がある valid
取得には成功したが同じ鍵がない、または鍵が存在しない unresolved · key-not-published
ネットワークの障害で鍵を取得できない unresolved · network

key-not-published のブロックを、検証者は有効として提示してはなりません。報告できるのは、埋め込まれた鍵で署名が成立すること、およびタイムスタンプを検証できた場合はその時刻に署名が存在したことです。

pubkey を持つ dns ブロック(examples/valid-key-snapshot.md)
<!-- md-signature
v: 0.0.2
method: dns
signer: example.com
selector: 2026
pubkey: ed25519:PUAXw+hDiVqStwqnTRt+vJyYLM8uxJaMwM1V8Sr0Zgw=
role: approver
ts: 2026-11-16T09:00:00Z
alg: ed25519
hash: sha256:f06c734545219e83074ab04481e4b4715054a8f1ac88367c90d2ce24bc76705c
sig: |
  base64:2gPP7bXr+yIxseGa3InxmDVKNz2GCDedDiUNOVvwgDeq1bg30tcR9xKXhURq65a85svc1
  0oDK12IYUR0uEDLBA==
-->
スナップショットとタイムスタンプを付与して署名する
mdsig sign contract.md -m dns -s example.com --selector 2026 \
  -k ~/.mdsig/example --embed-key --tsa

TypeScript は signDocument の embedKey: true、Go は SignOptions.EmbedKey で指定します。デモとエディタでは、連署の追加画面の「公開鍵を埋め込む」で指定できます。

TSA のルート証明書

タイムスタンプの時刻を報告できるのは、TSA 証明書のチェーンを信頼するルート証明書まで検証できた場合のみです。信頼するルートは実装ごとに異なるため、同じトークンが一方の実装で検証でき、他方では検証できないことがあります。

実装 信頼するルート 追加・置換
Go(CLI、mdsig serve) OS のトラストストア --tsa-root <file>
TSAVerifyOptions.ExtraRoots
TypeScript(@md-signature/core) 同梱する公開 TSA のルート証明書。tsaRoots で置換、extraTsaRoots で追加する(DER、または PEM テキスト) tsaRoots
extraTsaRoots
デモ、エディタ 起動時に tsa-roots.json を読み込む。読み込めない場合はライブラリの同梱分 「TSA ルート証明書」欄で PEM/DER を追加(メモリ内のみ)

同梱するルートは、CCADB が公開する Microsoft のルート一覧で「Included」かつ「Time Stamping」用途のものに限ります。tsa-roots.json は GitHub Actions が毎月照合し、一覧から外れたルートの削除や新しいルートの追加を Pull Request で提案します。

同梱するルート証明書

名称 有効期限 SHA-256
Certum Trusted Network CA2029-12-315c58468d55f58e49…
DigiCert Trusted Root G42038-01-15552f7bdcf1a7af9e…
GlobalSign Root CA - R62034-12-102cabeafe37d06ca2…
GlobalSign Timestamping Root R452045-03-182bcbbfd66282c680…
IdenTrust Public Sector Root CA 12034-01-1630d0895a9a448a26…
QuoVadis Root CA 1 G32042-01-128a866fd1b276b57e…
Security Communication RootCA32038-01-1824a55c2ab051442d…
Sectigo Public Time Stamping Root R462046-03-214941b001b8a97e96…
SSL.com Root Certification Authority RSA2041-02-1285666a562ee0be5c…
USERTrust RSA Certification Authority2038-01-18e793c9b02fd8aa13…

Security Communication RootCA3 と GlobalSign Timestamping Root R45 は、総務大臣の認定を受けたタイムスタンプサービスのためのルートです。

仕様書 §5.5 RFC 3161 タイムスタンプ§4.5 鍵のスナップショット§4.6 タイムスタンプ専用ブロック