OVERVIEW / 要点06 ATTESTATION
- GET https://D/.well-known/mosimo/attest/revocations が publisher 鍵で署名した RevocationList を返す。since と ETag に対応する。
- 自身が発行した通知、活性化された事前発行形、親鍵や祖先による失効を掲載する。子孫ごとの個別通知は発行しない。
- 接続できた参加者はチェーン中の issuerDomain を収集してリストを取得し、保持する投稿を再評価する。
- 取得の失敗は最後の状態を保ち、表示・中継を止めない。
位置づけ
失効リスト配信attest.revocation.list
これを前提とするプロトコル
失効要求attest.revocation.request目的
認証局が失効通知を自身のドメインで公開・購読・再掲する方法と、クライアント・Mosimo サーバーがインターネットに接続できたときに行う確認を定義する。通知自体の検証は失効通知プロトコルに従い、エンドポイントの到達性や応答は失効の有無の根拠にならない。本プロトコルはインターネットに接続できる参加者の動作を追加するものであり、オフラインの受信者に要件を課さない。
前提
| 識別子 | 役割 |
|---|---|
dev.jisaku.mosimo.attest.revocation |
失効通知の形式と受信者の状態 |
dev.jisaku.mosimo.attest |
issuerDomain ブロックとエンドポイントの共通規約 |
1. エンドポイント
鍵署名の issuerDomain.domain を D とする。
| 用途 | URL | 定義 |
|---|---|---|
| 失効リスト | https://D/.well-known/mosimo/attest/revocations |
本書 |
| 失効要求 | https://D/.well-known/mosimo/attest/revocation-requests |
失効要求 |
| 署名要求 | https://D/.well-known/mosimo/attest/signing-requests |
署名要求 |
HTTP の共通規約は 鍵署名 §2.3 に従う。
2. 失効リスト
type ListBody = {
$type: "dev.jisaku.mosimo.attest.revocation.list";
publisher: PublicKey; // この認証局の鍵
generatedAt: Timestamp;
revocations: Revocation[];
};
type RevocationList = Signed<ListBody>; // publisher 鍵が署名
GETにapplication/cborでC(RevocationList)を返す。Accept: application/jsonには JSON を返してよい。generatedAtとpublisherの署名は「この時点で認証局が公開していた集合」の表明である。各通知の真正性は内側の署名で独立に検証し、リストの署名が検証できなくても内側の有効な通知は適用してよい。- 任意の
?since=<Timestamp>で、issuedAtまたはactivation.effectiveAtがそれ以降の通知だけを返してよい。ETagとIf-None-Matchの対応を推奨する。 - 既定の全量応答は 1 MiB 以下とし、超える場合は
sinceの利用を求める応答を返す。古い通知を応答から黙って落としてはならない。受信者が失効を見逃す原因になるためである。
3. 掲載する内容
| 内容 | 掲載 |
|---|---|
| 自身が発行した即時形の通知 | 必須 |
自身が発行した事前発行形の通知のうち、activation を受け取ったもの |
必須 |
| 親鍵が失効した通知を知った場合、その通知 | 必須 |
| 自身または子孫の鍵が祖先によって失効された通知を知った場合 | 必須 |
保持期間は subject の keyValidity.until までとし、無期限の鍵の通知は恒久に保持する。親鍵の失効を知った認証局は、自身の子孫のそれぞれについて個別の失効通知を発行すべきではない。祖先の失効は既に子孫全体に及んでおり、個別通知は失効情報の流量を増やすだけである。
4. 伝播の規則
- 認証局は親の失効リストを購読するなどして、親鍵・自身・子孫の失効を知る。経路は HTTPS のほか、制御イベントの購読でもよい。
- 認証局が鍵を失効させたとき、同じ鍵に鍵署名を発行している他の認証局を知っていれば、自身の鍵で署名した失効要求をその認証局へ送ってよい。受け入れるかは相手の認証局が決める。
- 認証局が自身の鍵を失効させる手順は次のとおり。
- 親認証局の失効要求エンドポイントへ、自身の鍵で署名した失効要求を送る。
- 失敗した場合、事前発行形の
noticeにactivationを付け、制御イベントとして配送する。 - いずれの場合も、自身の失効リストに掲載する。
5. クライアントと Mosimo サーバーの確認
クライアント、PDS、Nostr リレーは、インターネットに接続できたとき次を行う。
- 受け取った投稿のチェーンに含まれる
issuerDomain.domainを収集する。同じドメインへの取得頻度は認証局側の資源制限に従って抑える。 - 各ドメインの失効リストを取得し、通知を検証して永続保持する。
- 保持している投稿を再評価し、
revokedとなった投稿に失効フラグを立て、新たな広告・転送の対象から外す。 - 自身がメッシュや他リレーへ投稿を渡していた場合、該当する
Revocationを制御イベントとして一度配送する。 - ドメインごとに最終確認時刻を記録し、表示の「失効情報の確認時点」に用いる。
取得の失敗は最後の状態を保つ。失効リストが取得できないことを理由に投稿の表示・中継を止めてはならない。配布基盤の障害が災害時の情報の流れを止める単一障害点になるためである。
6. 認証局の運用要件
- 失効リストの改ざんは内側の署名で検出されるため、配布に CDN・ミラーを用いてよい。
- 認証局の鍵が失効した後も、そのドメインの失効リストは子孫の通知を提供し続けることを推奨する。
参照
Lexicon
正規の型定義
dev.jisaku.mosimo.attest.revocation.list#main#listBody/protocol/attest/revocation/list/lexicon.json ↗
protocol/mosimo/attest/revocation/list/lexicon.json を表示
{
"lexicon": 1,
"id": "dev.jisaku.mosimo.attest.revocation.list",
"defs": {
"main": {
"type": "object",
"required": [
"body",
"sig"
],
"properties": {
"body": {
"type": "union",
"refs": [
"#listBody"
],
"closed": true
},
"sig": {
"type": "bytes",
"minLength": 64,
"maxLength": 64,
"description": "64-byte signature over SHA-256 of the canonical CBOR of body. Schnorr for 32-byte keys, low-S compact ECDSA for 33-byte keys."
}
},
"description": "Revocation list published by a certificate authority at its well-known endpoint."
},
"listBody": {
"type": "object",
"required": [
"publisher",
"generatedAt",
"revocations"
],
"properties": {
"publisher": {
"type": "bytes",
"minLength": 32,
"maxLength": 33,
"description": "Public key. 32 bytes: BIP-340 x-only; 33 bytes: SEC1 compressed secp256k1."
},
"generatedAt": {
"type": "string",
"format": "datetime",
"description": "Generation time."
},
"revocations": {
"type": "array",
"items": {
"type": "ref",
"ref": "dev.jisaku.mosimo.attest.revocation"
}
}
}
}
}
}