
Goで書かれたSpipネットワークセンサー
Spip は Go で書かれた Linux 向けの低インタラクション型ネットワークハニーポットセンサーです。ホストがリダイレクトした任意のポートで TCP 接続を受け付け(平文または TLS)、クライアントに次のメッセージを送らせるのに十分なだけ応答し、各やり取りを ECS フィールド名を持つ 1 つの JSON レコードとして書き出します。SIEM やデータレイクですぐに利用できます。オプションの UDP キャプチャはデータグラムを記録し、決して応答しません。
HoneyLabs は honeylabs.net で公開されているデータを収集するために Spip を運用しています。
前提条件:
iptables と root 権限git clone https://github.com/honeylabshq/Spip-Go.git
cd Spip-Go
go build -o spip-agent ./cmd/spip-agent
observer.version と agent.version で報告されるバージョン(デフォルトは dev)を設定するには、-ldflags "-X main.version=v1.2.3" を追加します。
sudo ./scripts/initial_setup.sh
下記の初期セットアップヘルパーを参照してください。
config.toml を作成または編集する
最小限の config.toml:name = "spip-agent"
ip = "0.0.0.0"
port = 8080
オプションの設定キー:
cert_path / key_path: 両方設定すると TLS を有効化します。相対パスは設定ファイルのディレクトリを基準に解決されます。log_file: レコードを stdout ではなくこのファイルに追記します。下記のログ出力を参照してください。[loom]: レコードを HTTP 経由でも送信します。下記の Loom を参照してください。read_timeout_seconds / write_timeout_seconds: 接続ごとのアイドル読み取りタイムアウトと書き込みタイムアウト。rate_limit_per_second / rate_limit_burst: 新しい TCP 接続に対するレート制限で、すべてのソースで共有されます。制限を超えた接続は読み取られることなく閉じられます。community_id_seed: Community ID v1 フローハッシュ用のオプションの 16 ビットシード(省略または 0 でデフォルト)。capture_client_hello: false に設定すると tls.client.hello_hex を省略します。フィンガープリンティングを参照してください。ignore_sources: 接続やデータグラムが何も読み取られる前に閉じられるか破棄されるアドレスまたはネットワーク。これらはログ記録、フィンガープリンティング、送信が一切行われません。ベアアドレスおよび CIDR、IPv4 または IPv6:
ignore_sources = ["192.0.2.10", "198.51.100.0/24", "2001:db8::/32"]。レンタルホスト上のハニーポットはそのホスト自身の監視によってポーリングされ、そうしたスクレイプをカウントするとポートランキングやスキャナ数が歪められます。パースできないエントリがあるとエージェントの起動が停止します。ここでのタイポは、破棄されていると信じているトラフィックを黙って記録してしまうからです。ドロップはソースごとにカウントされ、1 時間ごとおよびシャットダウン時にログに報告されます。udp_enabled および udp_* キー: UDP キャプチャを参照してください。これらのランタイムチューニングフィールドが省略されるか 0 に設定された場合、Spip は以下のデフォルトを適用します:
read_timeout_seconds: 30write_timeout_seconds: 10rate_limit_per_second: 20rate_limit_burst: 50000sudo iptables -t nat -F
sudo iptables -t nat -A PREROUTING -p tcp --dport 22 -j RETURN
sudo iptables -t nat -A PREROUTING -p tcp -j REDIRECT --to-port 8080
最初のコマンドは nat テーブル全体をフラッシュします。独自の NAT ルールを持つホストでは省略してください。同じ2つのルールを ip6tables で適用すると IPv6 をカバーできます。Spip は各接続の元の宛先をカーネルのコネクショントラッキングから読み取り、destination.ip と destination.port として記録します。
./spip-agent -config config.toml
-config は唯一のフラグで、デフォルトは作業ディレクトリ内の config.toml です。SIGINT または SIGTERM はリスナーを停止し、開いている接続を最大 15 秒待ち、保留中の Loom バッチがあればスプールに書き込み、送信に 5 秒与えます。残りは次回起動時に送信されます。
Spip は元の宛先ポートに基づいてレスポンダーを選択します。各レスポンダーは、クライアントに次のメッセージ(認証情報、コマンド、またはメールエンベロープ)を送信させるのに十分な情報だけを返します。
| ポート | レスポンス |
|---|---|
| 23, 2323 | Telnet オプション交渉と login: プロンプト、続いて Password:、そして Login incorrect を返して切断 |
| 21, 990 | FTP グリーティング、最初の行の後にパスワード要求、続いて 530 Login incorrect. を返して切断 |
| 25, 465, 587 | SMTP グリーティング、最初の 3 行に 250 応答、4 行目に 354、そして切断。何も中継されず、外向き接続も行われません。 |
| 110, 995 | POP3 グリーティング、最初の行の後に +OK、2 行目の後に -ERR invalid login、そして切断 |
| 143, 993 | IMAP グリーティング、続いて * BAD Login failed を返して切断 |
| 6379, 6380、または Redis コマンドのように見える任意のペイロード | PING には +PONG、それ以外には +OK |
| その他のポート | HTTP リクエストにはクライアントの IP アドレスをボディとした HTTP/1.1 200 OK、それ以外には IP アドレスのみ |
鍵交換メッセージなしで SSH-2.0 を送信するクライアントにはバナー SSH-2.0-spip が返され、Spip はクライアントのフィンガープリントを計算できるよう、鍵交換を最大 2 秒待ちます。
telnet、FTP、SMTP、POP3、IMAP のグリーティングは接続時に送信されます。TLS が有効な場合、Spip はまず 1 バイトを読み取って TLS とプレーンテキストを区別するため、これらのグリーティングはクライアントが何かを送信した後にのみ送信されます。
Spip は ECS ログを単一のローカル宛先に書き込み、同じレコードを Loom サーバーにも送信できます:
| 宛先 | 設定 | 動作 |
|---|---|---|
| ローカル | log_file | 省略または空:stdout。パスを設定:レコードはそのファイルに追記されます。常に有効。 |
| Loom | [loom] で enabled = true | オプション。同じレコードがバッチ化され、ローカル出力に加えて Loom の取り込み URL に POST されます。 |
ローカル出力には、エージェント自身のログ行(毎時のドロップ数や警告など)も {"timestamp": <unix seconds>, "level": "INFO", "message": "...", "target": "...", "record_type": "log"} として含まれます。Loom に送信されるのは接続レコードのみです。起動メッセージは stderr に出力されます。
Spipは各レコードをECSフィールド名を持つ1行のJSONとして書き出し、接続自体から導出できる情報のみを使用します(ASNやジオ情報のエンリッチメントは行いません)。複数のメッセージを送信する接続では、メッセージごとに1レコードが生成され、すべて同じevent.idを持ちます。フィールドには以下が含まれます:
@timestamp:レコードのRFC 3339時刻(秒単位)event.id:接続ごとのセッション識別子;event.sequence:セッション内でのレコードの位置(1から開始)event.duration:接続開始からのナノ秒event.module、event.dataset(spip.tcpまたはspip.udp)、event.kind、event.category、event.type:SIEMがSpipのレコードを選択できるようにするobserver.vendor、observer.product、observer.type、observer.version、agent.type、agent.versionobserver.hostname、observer.id、host.name:設定のエージェントnamesource.ip、source.port、destination.ip、destination.portsource.bytes、destination.bytes、network.bytes:セッション中にこれまでに受信および送信されたバイト数network.transport(tcpまたはudp)およびnetwork.protocol(tls、dns、netbiosまたはquic、判明している場合)http.request.method、http.request.headers、http.request.body.content、http.request.body.bytes、url.path、url.domain、url.port:ペイロードがHTTPリクエストの場合user_agent.original:利用可能な場合event.summary:HTTPリクエストではないペイロードのテキスト表現event.original_payload_hex:生のペイロードを16進数で表したもの(常に保持)network.community_id、tls.client.*、ssh.client.hash.hassh、http.request.hash.akinを追加します。レコードの例(整形表示):
{
"@timestamp": "2026-10-12T09:14:03Z",
"agent": {"type": "spip", "version": "dev"},
"destination": {"bytes": 78, "ip": "203.0.113.10", "port": 80},
"event": {
"category": ["network", "intrusion_detection"],
"dataset": "spip.tcp",
"duration": 100000000,
"id": "3f0c9a52-6d1e-4b8a-9c27-5e41b7d08a6f",
"ingested_by": "spip",
"kind": "event",
"module": "spip",
"original_payload_hex": "474554202f2e656e7620485454502f312e310d0a486f73743a203230332e302e3131332e31300d0a557365722d4167656e743a204d6f7a696c6c612f352e300d0a4163636570743a202a2f2a0d0a436f6e6e656374696f6e3a20636c6f73650d0a0d0a",
"sequence": 1,
"type": ["connection", "info"]
},
"host": {"name": "example-sensor"},
"http": {
"request": {
"hash": {"akin": "b11cun040_00040015_4c87b06e"},
"headers": {
"accept": "*/*",
"connection": "close",
"host": "203.0.113.10",
"user-agent": "Mozilla/5.0"
},
"method": "GET"
}
},
"network": {"bytes": 177, "community_id": "1:HL0iYZHtkKWecl0HBQsLeL+lIc8=", "transport": "tcp"},
"observer": {
"hostname": "example-sensor",
"id": "example-sensor",
"product": "Spip",
"type": "honeypot",
"vendor": "HoneyLabs",
"version": "dev"
},
"source": {"bytes": 99, "ip": "198.51.100.23", "port": 51234},
"url": {"domain": "203.0.113.10", "path": "/.env"},
"user_agent": {"original": "Mozilla/5.0"}
}
下流のシステムは、必要に応じてこれらのレコードを拡充できます(地理情報、ASN など)。
Spip は、キャプチャ内容を変更することなく、各レコードにパッシブフィンガープリンティングのフィールドを追加します: