deedlog

オープンソースの、検証できる記録

行われたことを
書き換えられない記録に

deedlog(ディードログ)は、システムが何をしたかを追記専用のチェーンに記録し、独立した連署サーバーと信頼できるタイムスタンプで固定するオープンソースです。削除した、移した、決められたことだけをした。それを、運営者を信頼しなくても誰でも確かめられる形で示せます。

導入のご相談 GitHub で見る

現在 v0.1。v1.0 までは互換性のない変更があり得ます。

なぜ、いま deedlog なのか?

漏れるのは「残っていたデータ」

何年も前の問い合わせフォームの入力が外部サービスに残っていた。書き出したファイルが共有フォルダに置かれたままだった。最近の情報漏洩の多くで流出したのは、そこに残っている必要のなかったデータです。不要になったら削除し、保管が必要なものは安全な場所に移す。この階層化が対策になります。

証拠を持っているのは、当の組織

「削除しました」を示す記録は、いまは組織自身が持っています。書き換えることも、記録から外すことも、相手ごとに違う内容を見せることもできます。信じてもらうには、自分でも変えられない記録が要ります。

エージェントが仕事をする時代に

AIエージェントやローコードの自動化は、本物の権限で文書を読み、メールを送り、データを書き換えます。決められたことだけをしたと示すログが、エージェントの手の届く同じシステムに置かれていては、証拠になりません。

3分でわかる仕組み

問い合わせフォームの内容を、回答後に削除する場面を例にします。

運営者のシステム チェーンとチェックポイント 確かめる人 連署サーバー、タイムスタンプ局 出来事を追記 公開して検証 連署と時刻の証明 運営者を信頼しなくても、誰でも確かめられる
  1. 行われたことを、その場で記録する

    受け付けた、保管場所へ移した、削除した。出来事のたびに、チェーンに1行を追記します。各行は直前の行のハッシュを持つので、途中の1行を変えると、それ以降のすべてが合わなくなります。記録に入るのは証拠のハッシュだけで、問い合わせの本文は入りません。

  2. チェックポイントに署名し、連署を受ける

    運営者はチェーン全体をまとめた値(マークル木の根)に署名します。これがチェックポイントです。独立した連署サーバーが、以前に見た履歴と矛盾しないことを確かめて連署し、タイムスタンプ局が時刻を証明します。連署サーバーは記録の中身を見ません。

  3. 誰でも、あとから検証する

    チェーンとチェックポイントと公開鍵があれば、dlog verify で誰でも確かめられます。オフラインでも、ブラウザの中でもできます。「7日以内に移す」「3年で削除する」と宣言しておけば、行われるはずだった削除が行われていないことも、記録の空白として見えます。

書き換えても、抜いても、あとから証明される

記録を持つ運営者がその気になれば、履歴を書き換えたり、都合の悪い出来事を記録から外したりできてしまいます。deedlog は運営者を信じる代わりに、それが必ず表に出るようにしています。

相手ごとに違う履歴を見せられない

連署サーバー(英語では witness)は、以前のチェックポイントと矛盾しないものにだけ連署します。C2SP の witness プロトコルに準拠しているので、公開の witness ネットワークを含め、対応した連署サーバーならどれでも使えます。誰でも自分で運用できます。

書き換えは、署名そのものが証拠になる

運営者が履歴を書き換えると、矛盾する2つのチェックポイントに運営者自身の署名が残ります。古いほうを持っている人は誰でも、運営者の公開鍵だけで不正を証明できます(dlog misbehavior)。連署サーバーを信頼する必要はなく、控えが世界のどこかに1つあれば足ります。

記録から外すと、受領証で分かる

出来事に関わった人には「チェーンの何番に記録した」という署名付きの約束(受領証)を渡せます。あとでその番号に別のものが入っていれば、受領証とチェックポイントを並べるだけで証明できます。リンクや QR コードで渡し、ブラウザの中だけで確かめられます。

証明できるのは「このハッシュがこの時刻に存在し、それから変わっていない」ことです。記録された内容がそもそも真実かどうかは、deedlog にもブロックチェーンにも証明できません。重要なところでは、削除した委託先など、運営者と利害の異なる当事者の署名を記録に入れてください。

連署サーバーを提供している組織

運営者とは別の立場から、チェックポイントに連署している組織です。連署サーバーは複数の運営者で共同で使えます。登録簿に記録の名前と検証用の鍵を載せると、連署を受けられます。

連署サーバーは、そのチェーンに関心のある組織なら誰でも運用できます。自分の組織で運用し、ここに載せたい場合はご相談ください。

記録に入るもの、入らないもの

入らないもの

  • 証拠そのもの(ログの行、画面、API の応答、問い合わせの本文)
  • 個人情報。本文は別に保管し、チェーンを壊さずに削除できる
  • 推測できる識別子。受付番号などは鍵付きハッシュ(HMAC)にする

入るもの

  • 証拠のハッシュ(SHA-256 または HMAC-SHA-256)と大きさ
  • 出来事の種類、記録した時刻、記録したシステムの名前
  • 直前の記録のハッシュ(これが鎖になる)

チェーンは公開する前提で設計しています。公開しても、証拠の中身は分かりません。

使いみち

deedlog そのものは分野を問いません。導入するのは「信頼してもらいたい側」です。分野ごとに、動かせるサンプルがあります。

データの階層化と削除

期限どおりに移し、削除していること。どの保管場所にも、期限を過ぎたデータが残っていないこと。保存期間の規程や、漏洩時の説明の裏付けになります。

AIエージェントと自動化

エージェントが呼んだ道具のすべてを、使ってよい道具の一覧と照らして記録します。MCP の中継と Claude Code のフックのサンプルがあります。

運営者が公開した約束

削除する、個人を識別しない、といった公開の約束を守っていること。プライバシーポリシーや監査の横に置きます。

データ連携と同意

自治体のデータ連携基盤で、個人データの提供の前に同意があったこと。データスペースのコネクタ間の契約、転送、ポリシーの適用。

コンテンツと機器のデータ

機器が署名したデータ、撮影から編集、公開までの来歴(C2PA)、登録済みの素材だけで作られた公式動画。

支払いと価値の証明

AIエージェントの支払い(x402)で何が求められ何が渡されたか。顧客データベースなしで精算するポイント。カーボンクレジットの計測と検証。

それぞれの説明と動かし方は、GitHub の examples にあります。政治資金の公開サイトに組み込んだ連携デモ(架空のデータ)もあります。

監査ログやブロックチェーンとの違い

自社で持つ監査ログブロックチェーンdeedlog
書き換えを防ぐもの運営者の管理と良識参加者の合意形成ハッシュの鎖、運営者の署名、独立した連署
あとから書き換えると外からは分からない事実上できないできるが、署名付きの証拠が残る
誰が確かめられるか監査人など、見せてもらえた人ノードを動かす人、信頼できる閲覧サービスを使う人誰でも。オフラインでも、ブラウザでも
時刻の根拠サーバーの時計ブロックの時刻RFC 3161 のタイムスタンプ局。必要なら認定タイムスタンプも
記録に入るものログの本文(個人情報を含むことが多い)取引の内容。一度書くと消せないハッシュだけ。本文は別に保管し、削除できる
動かすのに要るものログの基盤と保管ノード、合意形成、多くはトークンファイル1本と dlog コマンド。合意形成もトークンもなし
費用の構造保管と監査手数料、またはノードの運用ソフトは無料(Apache-2.0)。認定タイムスタンプを使う場合は1件ごと

導入に必要なもの

役割ごとに、持つものと動かすものを分けて示します。

運営者(信頼してもらいたい側)

  • 出来事が起きる場所から、チェーンに1行を追記する。チェーンは JSON Lines のファイル1本
  • 運営者の鍵を作り、定期的に(たとえば1時間ごとに)チェックポイントに署名し、連署とタイムスタンプを受ける
  • チェーン、チェックポイント、公開鍵を公開する。守ると宣言するルール(保存期間、点検の間隔)も公開する
  • 必要なら、関わった人に受領証を渡す

連署サーバーを動かす人

  • 運営者の公開鍵を登録して dlog witness を動かす。記録の中身は見ない
  • 保管するのは、連署したチェックポイントの控え(数百バイト)だけ
  • 監査人、業界団体、利用者の団体、競合。そのチェーンに関心のある人なら誰でもよい

確かめる人

  • 公開されたチェーンとチェックポイントを dlog verify で検証する。登録も許可も要らない
  • 受領証を受け取った人は、リンクを開くだけ。検証はブラウザの中で完結する
  • 宣言されたルールと記録を照らし、守られていないところを指摘する

現在のバージョンでできること

できること

  • チェーンの形式と検証
  • C2SP 形式のチェックポイント(マークル木)、包含と整合性の証明、不正の証明
  • RFC 3161 のタイムスタンプと、その検証
  • 連署サーバーのクライアントとサーバー(c2sp.org/tlog-witness)
  • 受領証、QR コード用のリンク、dlog serve による公開、ブラウザの検証ページ
  • 使いみちごとの動かせるサンプル(AIエージェント用の MCP 中継と Claude Code のフックを含む)

これから

  • 製品に組み込むためのライブラリと、ほかの言語向けの記録部品
  • 受領証の SD-JWT VC 形式(OpenID4VCI / OpenID4VP)
  • ML-DSA-44 による連署(耐量子)
  • 長期保存のためのタイムスタンプの更新
  • 記録する範囲と間隔の宣言、情報源の署名、チェーン間の参照
  • OSCAL の評価結果や、法的な証拠一式への書き出し

技術者向け

go install github.com/eucassoc/deedlog/cmd/dlog@latest

dlog keygen -name example.com/log -out operator
dlog checkpoint -key operator.key chain.jsonl > checkpoint
dlog cosign -key operator.vkey -witness w1.vkey=https://w1.example -out checkpoint.cosigned chain.jsonl checkpoint
dlog timestamp -tsa https://timestamp.sectigo.com -out checkpoint.tsr checkpoint
dlog verify -checkpoint checkpoint.cosigned -key operator.vkey -witness w1.vkey -quorum 1 chain.jsonl
インストール
go install github.com/eucassoc/deedlog/cmd/dlog@latest。Go 1.24 以上。外部のライブラリには依存しません。
チェーンの形式
JSON Lines。1行が1記録で、seq、prev(直前の行のバイト列の SHA-256)、source、subject(証拠のダイジェスト)、meta を持つ。ダイジェストは行のバイト列そのものから計算するので、JSON の正規化は要りません。
チェックポイント
c2sp.org/tlog-checkpoint の署名付きノート。運営者は Ed25519 で署名し、連署サーバーは c2sp.org/tlog-witness に従って連署する。包含と整合性の証明はマークル木で行います。
タイムスタンプ
RFC 3161 のタイムスタンプ局ならどれでも使えます。1回のタイムスタンプがそれ以前のすべての記録を押さえるので、記録ごとではなくチェックポイントごとに押します。
受領証
チェックポイントとは別の鍵で署名したノート。dlog receipt issue / check、dlog prove、dlog serve。検証ページは静的なページで、受領証は URL のフラグメントに入るため、サーバーには送られません。
証明できないこと
情報源が真実を述べたこと。侵害されたホストは嘘を記録できます。記録したらすぐにそのホストの外へ出す、情報源に署名させる、複数の場所で記録する、で補います。量子計算機に対しては、ML-DSA-44 の連署を予定しています。
仕様
チェーン、チェックポイント、信頼モデル。運用の手引きはガイド。
ライセンス
Apache-2.0。GitHub。
関連
ルールと記録から「いま誰が何をすべきか」を出す tsutome は、deedlog のチェーンを読み書きします。フォームの入力を暗号化したまま保管する shinten、顧客情報を持たない共通ポイント kangoh も、同じ「必要以上に持たない」設計の姉妹プロジェクトです。

導入のご相談

何を記録するかの設計、既存システムへの組み込み、連署サーバーやタイムスタンプの運用についてご相談ください。ソフトウェアは無料で使えます。費用がかかるのは設計と組み込みの支援です。

送信された内容は、お問い合わせへの対応にのみ使用します。このサイトには保存されません。取り扱いは プライバシーポリシーをご覧ください。