dev.jisaku.mosimo.attest.signing

署名要求と自動発行Signing request · 鍵署名

鍵の所有者が認証局に鍵署名を要求する手順と、認証局が要求を自動または手動で審査して鍵署名と事前発行形の失効通知を返すエンドポイントを定義する。自動発行は検証できる外部の事実に限る。

OVERVIEW / 要点06 ATTESTATION
  1. SigningRequest は subject 鍵で署名し、宛先の issuer を含めて他の認証局への転用を防ぐ。応答は issued・pending・rejected。
  2. 認証局は要求内容を縮小して発行してよいが、拡大してはならない。
  3. NIP-05 プロファイルは nostr.json の照合で identity 役割の鍵署名を trustLevel 1 で自動発行する。
  4. trustLevel 2 以上を要する発行は手動審査とし、確認資料と発行 ID を記録する。

位置づけ

目的

鍵の所有者が認証局に鍵署名を要求する手順と、認証局が要求を自動または手動で審査して鍵署名と事前発行形の失効通知を返すエンドポイントを定義する。自動発行は検証できる外部の事実に限って行い、その旨を trustLevel に表す。エンドポイントの提供は任意であり、オフライン発行だけの認証局は本拡張を実装しなくてよい。

前提

識別子 役割
dev.jisaku.mosimo.attest 鍵署名の構造、エンドポイントの共通規約、信頼度
dev.jisaku.mosimo.attest.revocation 発行時に渡す事前発行形の失効通知

1. 構造

type RequestBody = {
  $type: "dev.jisaku.mosimo.attest.signing";
  issuer: PublicKey;           // 宛先の認証局の鍵
  subject: PublicKey;          // 署名を求める鍵
  owner: Owner;
  roles: Text[];
  blocks: Block[];             // 希望する追加ブロックと検証材料
  requestedAt: Timestamp;
};
type SigningRequest = Signed<RequestBody>;   // subject 鍵が署名

type Response = {
  $type: "dev.jisaku.mosimo.attest.signing#response";
  status: "issued" | "pending" | "rejected";
  requestId?: Bytes;           // pending のとき。H(request.body)
  attestation?: KeyAttestation;
  revocation?: Notice;         // 事前発行形
  text?: Text;
};

issuer を含めるのは、同じ要求を別の認証局へ転用できないようにするためである。requestedAt から一定時間(24 時間を推奨)を過ぎた要求は受け付けない。

2. エンドポイント

操作 URL 内容
要求 POST https://D/.well-known/mosimo/attest/signing-requests C(SigningRequest) を送り、Response を受ける
状態照会 GET https://D/.well-known/mosimo/attest/signing-requests/<hex(requestId)> pending の要求の現在の Response

HTTP の共通規約は 鍵署名 §2.3 に従う。認証局は送信元ごとの受付数に上限を設ける。

3. 署名要求

alt [自動発行プロファイルに該当] [手動審査] POST SigningRequest(subject 鍵で署名) 署名検証、requestedAt、issuer 一致 希望する役割・ブロックが自身の役割・ブロック・maxDepth に収まるか 外部事実の検証(§4) 結果 KeyAttestation と事前発行形 notice を署名 issued {attestation, revocation} pending {requestId} GET .../signing-requests/<requestId> issued または rejected 所有者(subject 鍵) 認証局 外部の検証先
  • 要求の署名は subject 鍵の所持の証明である。認証局は別のチャレンジ応答を追加してよい。
  • 認証局は要求の owner・roles・blocks を縮小して発行してよいが、拡大してはならない。発行内容は応答の attestation が正本である。
  • 手動審査で発行した鍵署名は確認過程に応じて trustLevel 2 以上を表明できる。自動発行は 1 以下とする。

4. NIP-05 ドメイン検証プロファイル

企業等が自身のドメインで管理する Nostr 鍵に、簡易な鍵署名を自動発行するためのプロファイルである。

項目 内容
要求 subject は 32 バイト鍵。blocks に subjectDomain { domain, method: "nip05" } と nip05 { name } を含める。name は <local-part>@<domain> または _@<domain>
検証 認証局が https://<domain>/.well-known/nostr.json?name=<local-part> を取得し、names[<local-part>] が hex(subject) に一致することを確認する。redirect を追わず、サイズ・時間を制限する
発行 owner.id = "nip05:" + name、owner.name は要求値、roles = ["identity"]、delegation と organization なし、subjectDomain { domain, method: "nip05" }、trustLevel { level: 1, method: "nip05" }、keyValidity.until は認証局の方針
type Nip05Block = { $type: "dev.jisaku.mosimo.attest.signing#nip05"; name: Text };

このプロファイルで確認できるのは「そのドメインの nostr.json が、その時点でこの鍵を名乗らせていた」ことである。_@<domain> はドメイン自体を所有者名とする。更新時は再検証する。

5. 手動審査プロファイル

公的機関・自治体など trustLevel 2 以上を要する発行は手動審査とする。確認の方法は認証局の方針であり、少なくとも次を記録する。

  • 確認した資料・連絡先の種別と確認日
  • 発行した鍵署名の ID と事前発行形 notice の ID
  • 所有者へ渡した事前発行形 notice と、用いる場合は副鍵の保管方法についての案内

参照

Lexicon

正規の型定義

dev.jisaku.mosimo.attest.signing#main#requestBody#response#nip05/protocol/attest/signing/lexicon.json ↗
protocol/mosimo/attest/signing/lexicon.json を表示
{
  "lexicon": 1,
  "id": "dev.jisaku.mosimo.attest.signing",
  "defs": {
    "main": {
      "type": "object",
      "required": [
        "body",
        "sig"
      ],
      "properties": {
        "body": {
          "type": "union",
          "refs": [
            "#requestBody"
          ],
          "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": "Signing request, signed by the subject key to prove possession."
    },
    "requestBody": {
      "type": "object",
      "required": [
        "issuer",
        "subject",
        "owner",
        "roles",
        "blocks",
        "requestedAt"
      ],
      "properties": {
        "issuer": {
          "type": "bytes",
          "minLength": 32,
          "maxLength": 33,
          "description": "Public key. 32 bytes: BIP-340 x-only; 33 bytes: SEC1 compressed secp256k1."
        },
        "subject": {
          "type": "bytes",
          "minLength": 32,
          "maxLength": 33,
          "description": "Public key. 32 bytes: BIP-340 x-only; 33 bytes: SEC1 compressed secp256k1."
        },
        "owner": {
          "type": "ref",
          "ref": "dev.jisaku.mosimo.attest#owner"
        },
        "roles": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "blocks": {
          "type": "array",
          "description": "Requested blocks and verification material.",
          "items": {
            "type": "union",
            "refs": [
              "dev.jisaku.mosimo.attest#keyValidity",
              "dev.jisaku.mosimo.attest#delegation",
              "dev.jisaku.mosimo.attest#organization",
              "dev.jisaku.mosimo.attest#subjectDomain",
              "#nip05",
              "dev.jisaku.mosimo.attest.revocation.subkey",
              "dev.jisaku.mosimo.attest.external",
              "dev.jisaku.mosimo.attest.importer"
            ]
          }
        },
        "requestedAt": {
          "type": "string",
          "format": "datetime",
          "description": "Request time."
        }
      }
    },
    "response": {
      "type": "object",
      "required": [
        "status"
      ],
      "properties": {
        "status": {
          "type": "string",
          "knownValues": [
            "issued",
            "pending",
            "rejected"
          ]
        },
        "requestId": {
          "type": "bytes",
          "minLength": 32,
          "maxLength": 32
        },
        "attestation": {
          "type": "ref",
          "ref": "dev.jisaku.mosimo.attest#keyAttestation"
        },
        "revocation": {
          "type": "ref",
          "ref": "dev.jisaku.mosimo.attest.revocation#notice"
        },
        "text": {
          "type": "string",
          "maxLength": 1024
        }
      }
    },
    "nip05": {
      "type": "object",
      "required": [
        "name"
      ],
      "properties": {
        "name": {
          "type": "string",
          "description": "NIP-05 identifier: <local-part>@<domain> or _@<domain>."
        }
      }
    }
  }
}