Skip to content
KitploitKITPLOIT
ツールブログ
Log in
提出
ツールブログ
提出

ハッキング、侵入テスト、サイバーセキュリティツールをあなたのセキュリティアーセナルに!

Kitploitはハッキング、サイバーセキュリティ、ペネトレーションテストのツールディレクトリです。最新のプロジェクトアップデートを見つけて、脆弱性の発見、システム分析、テストの自動化、セキュリティの強化を行いましょう。

フィードお問い合わせプライバシー© 2026 Kitploit

ツールディレクトリ

カテゴリ

すべてのカテゴリを見る
Loading categories
halo-record — AIエージェント向けの改ざん防止監査証跡:ハッシュチェーン化されたRuntime Records、依存関係なし、誰でも検証可能 | Kitploit
ツール/GitHubGitHub/bkuan001/halo-record
フォレンジックサプライチェーンセキュリティインシデントレスポンスAIセキュリティ
GitHubbkuan001/halo-record

halo-record

AIエージェント向けの改ざん防止監査証跡:ハッシュチェーン化されたRuntime Records、依存関係なし、誰でも検証可能

リポジトリを見る
63612017日前Kitploit レビュー済み
共有
ウェブサイト

halo-record

改ざん検知可能なAIエージェントの監査証跡 — ハッシュチェーンで連結されたRuntime Recordを、顧客自身が検証できるRuntime Reportとしてレンダリングします。

計測機構が捕捉するあらゆるアクション(ツール呼び出し、モデル呼び出し、データアクセス、承認)は、追記専用でハッシュチェーン化されたログ内の1つのRuntime Recordになります。Runtime Reportは、そのチェーンをHTMLページとしてレンダリングしたもので、読者のブラウザ内でハッシュチェーンを再計算し、検証済みのレコードから表示内容をレンダリングします(ページ自身のコードに依存しない検証を行うには、JSONLに対してhalo verifyを実行してください)。チェーンのチェックポイントを保持している者は誰でも、そのチェックポイントまでのレコードが取得以降に改変されていないことを、作成者を信頼することなく検証できます。このチェックポイントこそが要となる部分です。チェーン単体では、記録装置を運用する当事者以外の全員に対して改ざん検知可能です(LIMITS.md §1)。顧客のセキュリティチームが「あなたのエージェントは我々のデータで何をしたのか」と尋ねてきたとき、長い説明文の代わりにリンクを1つ渡せば済みます。セキュリティレビューではすでにSOC 2チェックリストの隣でAIに関する質問がなされており、さらに近年はISO 42001、EU AI Actの記録保持条項、顧客独自のアンケートからそうした質問が来るようになっています。今日のところは、書面による保証でもまだ通ります。このプロジェクトの背後にある賭けは、それが長くは続かないというものです。

「フォレンジックに20年携わると、証拠は相手側が検証できて初めて証拠になるということが身に染みてわかる……信頼を求めるAI製品ばかりの分野において、[Halo]は信頼を不要にするよう設計された稀有な存在だ。」

Johannes Stillig、Tidebreak AIの創業者兼CEO、某プライベート投資オフィスのグループCISO

Help Net Securityで紹介 · その週のShow HNローンチで上位4% · 5つのコントロールに対してAgentic Trust Controlsに掲載

レコード形式はオープンで、自由に実装できます。本パッケージはリファレンス実装です:レコーダー、検証ツール、ウィットネスクライアント、レポートサーバー。

halo-recordを使っていますか、導入を検討していますか? あなたが誰で、何のために使うのか教えてください → Who's using halo-record?

自分で確認する

あなたはエージェント内にレコーダーを組み込むよう求められています。それを鵜呑みにするべきではありません:

  • ランタイム依存ゼロ。 標準ライブラリのみ。pip install halo-record でインストールされるパッケージはちょうど1つだけです。
  • ネットワーク呼び出しなし、ただしオプトインの4つを除く — ウィットネスへのアンカリング(サブジェクトID、レコード数、2つのチェーンフィンガープリント(ヘッドとチェーンルート)を送信)、ウィットネスのチェックポイントの読み戻し(サブジェクトIDを送信)、RFC 3161タイムスタンプ(チェックポイントの状態ハッシュのみをタイムスタンプ局に送信)、そしてhalo serve --verify-email($HALO_SMTP_HOSTで設定したサーバー経由のSMTPで、ワンタイムコードとレポートのサブジェクト名を、レポート閲覧者が入力したアドレスに送信)。いずれも明示的に呼び出さない限り無効であり、その他のレコード内容があなたのインフラ外に出ることはありません。
  • 生のツール引数はハッシュ化され、併せて秘匿化されたサマリーが付きます。 引数は正規化ハッシュとサマリーとして保存されます。サマリーは、既知のシークレットおよびPIIパターンをマスクした引数テキストで、200文字までに制限されます。どのパターンにも一致しない短い入力はサマリーにそのまま表示されます。ハッシュのみモード(summaries=False)ではサマリーは一切保持されません。秘匿化はベストエフォートです(一般的なシークレットおよびPII形式に対する正規表現に加え、エントロピーによるキャッチオール)。防御の多層化として扱い、保証とは考えないでください。summary以外に指定した結果フィールドも同じパターンでスキャン・マスクされますが、200文字に切り詰められることはありません(LIMITS §13)。
  • 監査できるほど小さい。 レポートページに埋め込まれたJavaScriptとCSSを含めて約8,700行のPython(空行、コメント、docstringを除いたコード行数)。1日で全部読めます。
  • Apache-2.0。
  • ドキュメントは第一級の扱い。 LIMITS.md(チェーンが証明できないこと)、PRIVACY.md(レコードに含まれるものと、あなたのマシンから出ていくもの)、RETENTION.md(保持ポリシーの下での運用)、そしてREVIEWERS.md — 4コマンドによる独立検証と、レビュー所見のための引用形式。

各レイヤーが証明するもの — このプロジェクトにおける最重要の区別(LIMITS.md §1):自分で保持するチェーンは、すでに誰かが保持しているヘッドを基準として、レコードが編集されていないことを証明します。運用者の外部で保持されるチェックポイントのみが、レコードが削除されていないことを証明します。そして、すべてのアクションが捕捉されたことを証明するハッシュは存在しません。

主張自己保持チェーン+ 外部チェックポイント+ 信頼できる捕捉
確立済みアーティファクトへの編集を検出✔✔✔
コミット済み履歴の書き換えを検出—✔✔
欠落/遅延チェックポイントを検出—✔(合意された頻度)✔
すべてのアクションが記録されたことを証明——捕捉境界に依存

インストール前に実物を見る: サンプルのRuntime Report — 架空のデータ、本物のチェーン。開くと、そのスクリプトが埋め込まれたレコードのハッシュチェーンをブラウザ内で再計算します。

60秒デモ

エージェントは不要です。uvがあれば、インストールするものは何もありません:

uvx --from halo-record halo demo --serve

または従来の方法:

pip install halo-record
halo demo --serve

いずれかを選ぶと、2社の顧客を持つ架空のサポートエージェントベンダーをスキャフォールドし、チェーンを目撃し(オペレーター外部の1つを代行するローカルwitnessファイルについてはLIMITS.md §1を参照)、ゲート付きのRuntime Reportsを配信し、ブラウザでオペレーターコンソールを開きます。次に改ざんテストを試してください:.jsonlファイルの1つから行を削除して再読み込みします。レポートがそれを検出します。

自分のエージェントを記録する

境界での1行:

from halo_record import trace

agent = trace(run_my_agent, profile="my-agent", log="audit.jsonl")   # wraps your entrypoint; records the run boundary to ./audit.jsonl — add record_call() or a framework adapter at each tool boundary to capture individual calls

from halo import ... という便利なシムも同梱されていますが、PyPI 上の halo という名前は無関係なターミナルスピナーパッケージのものであり、そのパッケージがインストールされている場合はそちらがインポートされます。halo_record は曖昧さがないため、例ではこちらを使用しています。

log= を指定しない場合、レコードは ~/.halo/my-agent.jsonl に書き込まれます(エージェントごとに1つのチェーン)。ラッパーは実行境界を封止し、証拠は呼び出しごとのレコードに残ります。これらはフレームワークアダプター(下のマトリックス)で取得するか、明示的に取得します。後者は委任リンクの仕組みも示します:

from halo_record import Recorder, record_call

rec = Recorder("audit.jsonl")

with record_call(rec, "crm.lookup", {"account": "acct-9"}) as call:            # one sealed record per tool call
    call.result = crm.lookup("acct-9")

with record_call(rec, "payments.refund", {"amount": 120},
                 parent_id=rec.last_record_id()) as call:                      # child links to the action that spawned it
    call.result = payments.refund(120)

次に、レポートをレンダリングします:

halo report audit.jsonl -o report.html    # one chain -> HTML that re-verifies in the browser
halo serve ./records --port 8721          # all tenants, gated per customer

0.2.45 で最初に配信されたディレクトリをアップグレードする場合、halo serve は起動時に以前の各グラントを再読み込みします。レコードに subject id が含まれていないファイル(agent.jsonl のような単純な Recorder ファイル)に対するグラントは隔離され、起動のたびに、それを再発行する halo grant コマンドとともに出力されます — LIMITS.md §17, "Serving a directory first served by 0.2.45" を参照してください。

クイックスタートは、ブラウザで自分のエージェントの Runtime Report を表示した時点で終了します。JSONL ファイルだけが得られてレポートがない場合は、何かがおかしいので issue を開いてください。

検証ブロック

ガードレールまたはポリシーレイヤーがアクションを検査した場合、その判定結果はレコードに付随させることができます — ゲートが何を決定したかを記録するオプションのブロックで、他のすべてのフィールドと同様にハッシュチェーンに封入されます:

from halo_record import build

build("tool_call", "security", tool="payments.refund",
      verification={"status": "allowed", "verifier": "gate/1.2",
                    "policy_ref": "sha256:1f3a...",
                    "checked_at": "2026-08-01T12:00:00Z"})

命名に関する注意点が1つあります。パッケージは record 関数(デコレータ)をエクスポートしており、これがパッケージオブジェクト上の halo_record.record モジュールを隠蔽します。内部を利用したい場合は、import halo_record.record as record ではなく、モジュールパスから直接インポートしてください — from halo_record.record import build。

これは次のようにレコードに封入されます:

"verification": {"status": "allowed", "verifier": "gate/1.2", "policy_ref": "sha256:1f3a...", "checked_at": "2026-08-01T12:00:00Z"}

record_call(...) は同じ verification= キーワードを受け付けます。status はブロック内で必須であり、verifier、policy_ref、checked_at は任意です。各ステータスの意味は次のとおりです:

ステータスゲートが報告する内容アクションは実行されたか?
allowedアクションを許可したはい — アクションは続行された
blockedアクションを拒否した統合側によって決まるものであり、このフィールドによるものではない — レコードが結果を保持している場合もあり、ブロックだけでは未実行を証明できない
modified実行前にアクションを変更した — action.input は変更後の、実行されたままのアクションを記述するはい、変更された形で
unverified実行された(または参照された)が、判定は下されなかった — ブロックが存在しない場合とは異なる。後者は検証の主張が一切なされなかったことを意味するはい — アクションは判定なしで続行された

このブロックはオペレーターの統合コードによって提供され、ゲートが述べたと報告する内容を記録します — principal と同じ信頼姿勢です(LIMITS を参照)。封印はステータスが事後に編集されていないことを証明しますが、チェックが実際に行われたこと、判定が正しかったこと、またはブロックされたアクションが実行されなかったことを証明するものではありません。これは独立した検証ではありません。

policy_ref を証拠として使用可能にするには、ルールセットのコンテンツハッシュを使用し、ルールセットの成果物を保持してください — 解決できないラベルはこのフィールドを飾りにするだけです。

既に運用しているものへの接続

境界でキャプチャ既存のテレメトリから取り込み
ネイティブレコーダー(from halo_record import trace)OpenTelemetry GenAI スパン
MCP インターセプターLiteLLM コールバック
LangChain / LangGraph コールバックLangfuse エクスポート
OpenAI Agents SDK フック任意のゲートウェイ / リバースプロキシログ
Claude Agent SDK フックClaude Code および Codex CLI の PostToolUse フック(ツール実行後に発火)
halo door によってバイヤー側で読み取られるプラットフォームログエクスポート(GitHub セキュリティログ、Salesforce Event Monitoring)
ツールをダウンロード

人気

すべて見る →

コミュニティで最も使われているツールを見つけましょう。

まだ人気データがありません。

すべてのツールを探索

ツールコレクションを閲覧

すべてのツールを見る →