jamesalmeida/agent-honeypot

これは何？

主な機能

• 01正規のflag.txtをインストールし、一般的な偵察対象の場所にシンボリックリンクを作成する。
• 02自分が使っているエージェントをフラグに記載し、処理を中断されないようにする。
• 03訪問者が自分の情報を記録できる、追記専用で全ユーザーが書き込めるゲストブックを提供する。
• 04再起動後に表示される、macOS用のオプションの合成/flag.txtエントリを利用できる。
• 05Linux、macOS、Windows向けのインストールおよびアンインストールスクリプトを同梱する。

ユースケース

• 個人の開発マシンにチェックポイントを設置し、未知のエージェントが探索するかを確認する。
• 共有サーバーやCIランナーにトリップワイヤーを設置し、どのエージェントが訪れたかを記録する。
• 管理された環境で、AIエージェント向けのプロンプトインジェクション対策を試す。

クイックスタート

1. 1

   リポジトリをクローンする

   git clone https://github.com/jamesalmeida/agent-honeypot.git
2. 2

   プロジェクトディレクトリに移動する

   cd agent-honeypot
3. 3

   Linux または macOS でインストーラーを実行する

   ./install.sh

使う前に知っておきたいこと

• !エージェントにフラグの場所を示すものがないため、エージェントがたまたまその場所を調べた場合にしか機能しません。
• !フラグはプロンプトレベルの要求であり、問題のあるエージェントは無視できます。
• !ゲストブックは自己申告式で、誰でも書き込めるため、記載内容は証明ではなく申告にすぎません。
• !Windows で完全インストールするには、昇格された PowerShell セッションが必要です。

収録されている特集

トピック

よくある質問

agent-honeypot とは？

マシンに入り込んだAIエージェントを検知するため、チェックポイントとゲストブックを設置するハニーポット用フラグファイル。 agent-honeypotは、訪問したAIエージェントが確認しそうなホームディレクトリ、/etc、/tmp、rootのホームなどにflag.txtを配置します。フラグはプレーンテキストのメッセージで、見慣れないエージェントに探索をやめ、秘密情報に触れず、確実に特定できるものだけを修正して、結果を報告するよう求めます。

agent-honeypot は無料で使えますか？ライセンスは？

agent-honeypot は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

agent-honeypot は今もメンテナンスされていますか？

活発にメンテナンス中。agent-honeypot の最終コミットは 2026年10月23日 です。

agent-honeypot は何に使えますか？

個人の開発マシンにチェックポイントを設置し、未知のエージェントが探索するかを確認する。 共有サーバーやCIランナーにトリップワイヤーを設置し、どのエージェントが訪れたかを記録する。 管理された環境で、AIエージェント向けのプロンプトインジェクション対策を試す。

agent-honeypot のインストール方法は？

リポジトリをクローンする: git clone https://github.com/jamesalmeida/agent-honeypot.git プロジェクトディレクトリに移動する: cd agent-honeypot Linux または macOS でインストーラーを実行する: ./install.sh

agent-honeypot はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/jamesalmeida/agent-honeypot