Real-time network monitor + outbound firewall — see & block every connection. Privacy-first, local-first, Rust fleet agent, SIEM exports, 8 languages. / Moniteur réseau temps réel + pare-feu sortant, agent de flotte Rust, exports SIEM. 100 % local.
Snitch — エンタープライズ統合
Community translated — PRs welcome for refinement / コミュニティ翻訳 — 改善PR歓迎。
日本語: Snitch を SOC スタックに組み込むためのステップバイステップ ガイド — Wazuh、Splunk、Graylog/Loki、Ansible、Docker/Kubernetes。 すべて無料・セルフホストで、Snitch のローカルファースト方針と一致します。 Snitch 自身はテレメトリを一切送信しません。外部への接続は、ここで 設定するものだけです。
1. SIEM 出力
アラート転送用に3つのネイティブ形式を提供:
| 設定 | 値 | 効果 |
|---|---|---|
syslog_addr |
host:514 または tcp://host:514 |
syslog 転送を有効化(UDP がデフォルト、tcp:// プレフィックスで TCP) |
syslog_format |
rfc3164 (デフォルト) |
古典的 BSD syslog — あらゆるコレクターで読める |
cef |
`CEF:0 | |
webhook_url + webhook_enabled |
URL | 汎用 JSON POST(Discord/Slack/Telegram のペイロードは自動検出) |
GET /forensics/export?format=… |
json、csv、stix、ecs |
ワンショットのフォレンジックバンドル — ecs は Elastic Common Schema NDJSON を出力 |
UI(設定 → セキュリティ)または snitch.toml で設定:
syslog_addr = "siem.example.com:514"
syslog_format = "cef"
2. Wazuh
Wazuh マネージャーで syslog リスナーを有効化(
/var/ossec/etc/ossec.conf):<remote> <connection>syslog</connection> <port>514</port> <protocol>udp</protocol> <allowed-ips>your-agent-subnet</allowed-ips> </remote>各 Snitch エージェントを向ける — Ansible:
snitch_syslog_addr: "wazuh.example.com:514" snitch_syslog_format: "cef"Wazuh の CEF デコーダーが
CEF:0|Snitch|…を拾い、severityは syslog PRI にマップされます(critical→2、warning→4、info→6)。
3. Splunk
- 設定 → データ入力 → UDP → 514 の新規入力、sourcetype
syslog(tcp://…送信側には TCP 入力)。 syslog_format = "cef"でsrc、dst、dpt、cs1Labelが無料で 使えます。ダッシュボードには scripted input でGET /forensics/export?format=ecsをポーリング — JSON は自動抽出。
4. Graylog / Loki
- Graylog: System → Inputs → Syslog UDP、514 にバインド。CEF 拡張 フィールドはメッセージフィールドとして届きます。
- Loki/Grafana:
syslog_addrをpromtailの syslog ターゲットに 向けるか、cron → Loki push ジョブで/forensics/export?format=ecsをスクレイプ。
5. 宣言的設定(Security-as-Code)
バックエンドは起動時に1つのファイルを適用します — $SNITCH_CONFIG、
なければデータディレクトリの snitch.toml/snitch.json。宣言された
キーは UI/DB の値を上書き — このファイルがフリートの真実の源です:
syslog_addr = "siem.example.com:514"
syslog_format = "cef"
kill_switch_enabled = true
ask_enabled = false # headless サーバー
gossip_peers = ["sec-01:8000"]
ports = [80, 443]
完全な語彙は packaging/snitch.toml.example を参照。
6. Ansible / Puppet / Salt / GPO
Ansible —
deploy/ansible/に完成済みロール:ansible-playbook -i inventory deploy/ansible/site.yml/opt/snitch、venv、/etc/snitch/snitch.toml、強化 systemd ユニットを インストールし、snitch.serviceを有効化します。Puppet / SaltStack —
deploy/puppet/とdeploy/salt/に コミュニティ製スケルトン(help wantedラベル):同じ3つの プリミティブ — バックエンドツリー配置、snitch.tomlレンダリング、snitch.service管理。Windows GPO —
deploy/gpo/Install-Snitch.ps1がサイレント インストールを実行(ProgramData 設定、venv、127.0.0.1 の SYSTEM タスク)。Windows の ask-on-connect には署名済み WFP コールアウトが さらに必要 —docs/SIGNING.md参照。
7. Docker & Kubernetes
単一ホスト:
docker compose up—network_mode: host+cap_add: NET_RAW/NET_ADMINはdocker-compose.yml設定済み。フリートコンソール:
deploy/helm/snitch—mode: collectorは 設定済みエージェントの監査をGET /remote/fleetに集約する ClusterIP Deployment を起動;mode: agentはNET_RAW/NET_ADMIN付きのホストネットワーク DaemonSet をレンダリング。helm install snitch ./deploy/helm/snitch \ --set token=$(openssl rand -hex 32) \ --set config.gossip_peers='["agent-1:8000","agent-2:8000"]'
8. Sigma ルール
POST /alerts/rules/sigma は Sigma 検出 YAML を受け取り、サポート済み
サブセット(フィールド→値セレクション、|contains/|startswith/
|endswith/|re/|cidr/|gt/|lt/|all、1 of/all of 条件)を
Snitch カスタムルールにコンパイル — アラートのみ、非対応部分は
skipped に理由を返します。フィールドはパケットセンサーが見えるものに
マッピング(DestinationIp→remote_ip、Image→process_name、
Domain→host など)。
Google SecOps/Chronicle 向け YARA-L:GET /alerts/rules/yaral が全
ルール(Sigma 由来を含む)を .yar ファイルとしてエクスポート —
Sigma→YARA-L パスはこれでカバー済み。
9. リモートエージェント(snitch-agent/1)
agent/ には軽量 Rust デーモン(依存ゼロ、単一 ~1MB バイナリ)があり、
ホストのソケットテーブル(/proc/net/*)を監視し、新しいアウトバウンド
フローを POST /ingest/events にプッシュします。ソケットを観測する
だけ — ペイロード/SNI なし(それはローカルキャプチャの仕事);
プロセス帰属は TODO マーク済み。トランスポートは HTTP + Bearer
(gossip_peers と同じトラストドメイン)。
10. 無料脅威インテリジェンスフィード
POST /firewall/blocklist は両方の形式をインポート:
kind: "domain"— hosts/ドメインリスト(StevenBlack、EasyList…)→domainファイアウォールルール;kind: "ip"— IP フィード(Blocklist.de、URLhaus/Feodo エクスポート) →ipルール;プライベート/予約/ループバックは絶対にインポートしない。
path: はローカルファイルを読む(完全オフライン);url: は明示的で
監査可能なオプトインフェッチ(レスポンスに remote_fetch: true)。
上限 max_entries ≤ 5000 — 巨大フィードはリゾルバーの仕事。
オプトイン API プロバイダー(AbuseIPDB / OTX / VirusTotal)は
ti_provider + ti_api_key で利用可能 — キーを設定しない限り
何も送信しません。
11. ヘッドレス/デーモンモード
GUI はオプション:バックエンドが製品のすべて。直接起動
(uvicorn api.main:app)、同梱 systemd ユニット、またはコンテナ —
上記すべての機能がフロントエンドなしで動作します。
SNITCH_DEMO=1 は研修や CTF 向けに root 不要の合成フィードを
提供し続けます。