Skip to content
KitploitKITPLOIT
ツールエクスプロイトブログ
Log in
提出
ツールエクスプロイトブログ
提出

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

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

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

ツールディレクトリ

カテゴリ

すべてのカテゴリを見る
Loading categories
USBvalve — USBアクティビティをオンザフライで可視化する | Kitploit
ツール/GitHubGitHub/cecio/usbvalve
組み込みシステムセキュリティ動的分析 (サンドボックス)フォレンジックマルウェア分析ハードウェアセキュリティ
GitHubcecio/usbvalve

USBvalve

USBアクティビティをオンザフライで可視化する

リポジトリを見る
1.3k436318日前Kitploit レビュー済み
共有
<h1><img width="300" alt="logo, landscape, dark text, transparent background" src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/USBvalve_logo_scaled.png"></a></h1>

> [!NOTE]
> **USBvalve バージョン 1.0.0**
>
> アプリケーションを全面的に書き直しました:
> - Arduino IDE 環境から離れ、コードは [Pi Pico SDK](https://github.com/raspberrypi/pico-sdk) 向けに書かれています
> - 外部ライブラリへの依存を大幅に削減しました
> - Low Speed デバイス (ATTiny85、EvilCrow など) に対する USB ホストサポートがより堅牢になりました
> -  ハードウェアと機能はほぼ変わっていません。詳細は下記の[注記](https://github.com/cecio/USBvalve#notes-about-bootsel-and-version--100)を参照してください

### *USB アクティビティをその場で可視化*

<p float="left">
<img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/versions.png" alt="The two models" width="30%" height="30%" />
<img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/USBvalve_PIWATCH.png" alt="The Watch" width="26%" height="26%" />
<img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/version1_2.png" alt="1.2" width="26%" height="26%" />
</p>

きっとあなたも私と同じように、*未知の*デバイスに USB ドライブを挿すよう頼まれたことがあるでしょう...そして疑問が浮かびます:

私のかわいそうなドングルは、裏で何をされたのか? ファイルを盗まれた? 暗号化された? それとも *ただ* マルウェアをインストールされただけ? **USBvalve** を使えばこれを数秒で見抜けます: 超安価な既製品ハードウェアで構築されているので、あらゆる USB ファイルシステムアクティビティを素早くテストし、手遅れになる前に何が起きているのかを理解できます!

**USBvalve** を使えば、ドライブに何が起きたかを即座にフィードバックできます。デバイス上に構築された*偽の*ファイルシステムがアクセス、読み取り、書き込みされたかどうかを画面に表示します:

<p float="left">
<img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/selftest.png" alt="Selftest" width="15%" height="15%" />
<img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/readme.png" alt="Readme" width="15%" height="15%" />
</p>

またバージョン `0.8.0` 以降では、USB ホストとして使用して *BADUSB* デバイスを検出することもできます:

<p float="left">
<img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/hid.png" alt="HID" width="15%" height="15%" />
</p>

これはシリアルポートで利用可能な *BADUSB* デバッガの例です:

<p float="left">
<a href="https://asciinema.org/a/NWfC9Mvzzpj3eZfsC7s5Dz1sJ" target="_blank"><img src="https://asciinema.org/a/NWfC9Mvzzpj3eZfsC7s5Dz1sJ.svg" width="65%" height="65%" /></a>
</p>

動画の方がよければ、私の [Insomni'hack プレゼンテーション](https://www.youtube.com/watch?v=jy1filtQY4w)もご覧ください

## USBvalve Watch

バージョン `0.15.0` 以降、新しい *Pi Pico Watch* バージョンがサポートされています。新しいバージョンをコンパイルするには、コードの先頭にある `#define PIWATCH` 行のコメントを解除する必要があります。ハードウェアは RP2040 ベースの 1.28 インチ TFT ディスプレイ付き腕時計ボードです。詳細は[こちら](https://www.raspberrypi.com/news/how-to-build-your-own-raspberry-pi-watch/)で確認できます。
これは [Waveshare RP2040-LCD-1.28](https://www.waveshare.com/wiki/RP2040-LCD-1.28) とも完全に互換性があります。

## リポジトリ構成

`docs`: プロジェクトに関するドキュメント。すべての機能を確認できるプレゼンテーションも含まれます

`firmware`: Raspberry Pi Pico 用のビルド済みファームウェア。これらをそのまま使用してボードに書き込むことができます。32 行または 64 行 OLED 用、Pico 1 または Pico2 用、Pi Pico Watch 用など、いくつかの異なるバージョンがあります

`PCB`: カスタム PCB を印刷したい場合の Gerber ファイル。必須ではなく、独自のものを使用したりブレッドボード上に構築したりできます

`src` と `data`: ソース。ファームウェアを自分で変更してビルドしたい場合に使用します

`utils`: カスタム FS を構築する際に使用できるユーティリティ

`pictures`: このドキュメントで使用されている画像とリソース

`STL`: エンクロージャ用の STL ファイル。`1.1` と `1.2` フォルダには完全なエンクロージャがあります ([WhistleMaster](https://github.com/WhistleMaster) に感謝)。フォルダ `1.2_64` と `1.2_64_simple` には 128x64 スクリーン用のエンクロージャがあります ([rtmq0227](https://github.com/rtmq0227) に感謝)。LCD を保護するより軽量なものが必要な場合は `USBvalve_sliding_cover.stl` を使用できます。

## USBvalve のビルド

### 部品リスト

自分でビルドしたい場合、必要なものは:

- Raspberry Pi Pico 1 または 2 (または別の RP2040 ベースのボード)
- I2C OLED スクリーン 128x64 または 128x32 (**SSD1306**)
- (オプション) **USBvalve** PCB またはブレッドボード
- (オプション) スクリーンをボードから隔離するための 3D プリントスペーサー (https://www.thingiverse.com/thing:4748043)。ただし、代わりに電気テープを使用することもできます

### BOOTSEL とバージョン >= 1.0.0 に関する注記

`0.x.x` バージョンでは、BOOTSEL はデバイスのリセットや HID イベント数の表示 (> 2 秒押す) に使用されていました。
BOOTSEL のポーリングが *BADUSB* 検出にいくつかの問題を引き起こしていたため、これはバージョン `1.0.0` から削除され、以下の 2 つのオプションに置き換えられました:
- `GP0` と `GND` の間にボタンをはんだ付けする (パッド 1 と 3、例は下の写真を参照) ことで同じ機能を持たせる
- シリアルモニタからコマンド `r` (リセット) と `h` (HID イベント) を使用する

<img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/reset_button.jpg" width="35%" height="35%" />

`PCB` には、ボタンの取り付けを容易にするためにパッド 1 と 3 に穴が開けられたバージョン `1.3` のボードもあります。しかしご覧のとおり、古いバージョンも使用できます。

*BADUSB* 機能を使用しない場合、または検出範囲を狭めて BOOTSEL の使用を維持したい場合は、*bootsel* を有効にして作成したファームウェアも提供しています (フォルダとリリースを参照)。


### ビルド手順

> [Tz1rf](https://github.com/Tz1rf) のおかげで、2 つの素晴らしい動画もあります: 1 つは[ビルド](https://youtu.be/7ymk8hD7-Hc)プロセスをステップバイステップで説明し、もう 1 つは[ファームウェアのアップロード](https://youtu.be/Tp8xvrlqxUY)とツールの使用方法を示しています。

作業のほとんどはソフトウェアによってボード上で直接行われるため、出力用に OLED との接続を準備するだけで済みます。

ファームウェアのバージョン 0.8.0 以降、**USBvalve** は HID デバイスを検出できます (*BADUSB* の検出に使用)。これにはホストとして動作する追加の USB ポートが必要です。これに興味がない場合は、[docs フォルダにある](https://github.com/cecio/USBvalve/blob/main/docs/BUILDING-1.1.md)古い手順を使用して PCB バージョン `1.1` を使用できます。そうでなければ PCB バージョン `1.2` に進んでください (USB-A または USB-B 用のバージョンがあります。フォルダを参照)。

#### USBvalve PCB を使用する場合

<p float="left">
  <img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/USB_valve_1-2_front.png" width="25%" height="25%" />
  <img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/USB_valve_1-2_back.png" width="24%" height="24%" /> 
</p>


- `USBH` エリアに USB メス ポートをはんだ付けします。これはバージョン `A` 用ですが、好みに応じて USB `Micro-B` 用のバージョンもあります
- シルクスクリーン上に Raspberry Pi Pico を前面に配置します
- すべての PIN をはんだ付けする必要はありません。以下のみで十分です:
  - D4 と D5 (左側)
  - D14 と D15 (左側)
  - GND (右側、上から 3 番目のピン)
  - GND (右側、下から 3 番目のピン)
  - 3v3_OUT (右側)
  - VBUS (右側)
  - 下部の 3 つの DEBUG ピン: SWCLK、GND、SWDIO
- OLED が Raspberry に触れる可能性のある部分に 3D プリントスペーサーまたはテープを貼ります
- 4 PIN スペースに OLED (ヘッダー付き) をはんだ付けします

一部の OLED は GND と VCC の PIN が入れ替わっているため、PCB は両方のバージョンと互換性があるように設計しました:

例えば、OLED の PIN1 に GND、PIN2 に VCC がある場合:

<img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/usb_valve_oled.png" width="35%" height="35%" />

PCB の裏面にあるこれらの 2 つのパッドにはんだを盛る必要があります:

<img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/usb_valve_pads.png" width="15%" height="15%" />

そうでない場合は逆にして、もう一方の PAD にはんだを盛ります:

<img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/usb_valve_pads_2.png" width="15%" height="15%" />

#### USBvalve PCB を使用しない場合

<img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/pico-pinout.svg" alt="Pico Pi" width="85%" height="85%" />

ブレッドボードまたは単なる配線を使用する場合、OLED スクリーンとホスト USB ポートに適切な PIN を接続することだけを確認すればよいです。

マッピングは以下のとおりです:

- Pi の PIN6 --> OLED SDA
- Pi の PIN7 --> OLED SCL 
- Pi の PIN19 --> USB ホストの D+
- Pi の PIN20 --> USB ホストの D-
- Pi の PIN23 (GND) --> USB ホストの GND
- Pi の PIN38 (GND) --> OLED GND
- Pi の PIN36 (3V3OUT) --> OLED VCC
- Pi の PIN40 (VBUS) --> USB ホストの VCC

DEBUG 機能を使用したい場合は、ボード下部の 3 つの SWD PIN にヘッダーを配置することもできます。

#### USBpipe PCB を使用する場合

> [!CAUTION]
> この PCB は経験豊富な電子工作愛好家向けです
> **扱える自信がない場合は使用しないでください!**

> [!NOTE]
> R7 と R8 は実際には何にも接続されていません。回路デバッグ目的で追加されています。
> そのため BOM には表示されません

<img src="https://assets.kitploit.com/production/public/readmes/48341/248d33e236b13cc7c59905288ca1e06ae7a0ff36a3b7e99d2f66c4b27e5ab2bf.jpg" alt="USBpipe PCB" width="15%" height="15%"/>

<img src="https://assets.kitploit.com/production/public/readmes/48341/0159e8d6a4d68b6edcad459a6ebfcdce0f5787f2bca0ea5f06c6b3538baf75a2.jpg" alt="USBpipe" width="15%" height="15%"/>

[USBpipe](https://github.com/LiPolymer/smartUSBPipe) はこのプロジェクト専用の PCB です。

必要なものはすべて `./PCB/USBpipe/` フォルダにあります。

<img src="https://assets.kitploit.com/production/public/readmes/48341/39c4a838734e4710cfe68529931961f387b1723654d5a4d3b1243d05925aa765.png" alt="Front" width="20%" height="20%"/>

<img src="https://assets.kitploit.com/production/public/readmes/48341/b34c6e01b06808aa0c21f17086d864b4b02fe4b4b453374d2840ae914aa524d6.png" alt="Back" width="20%" height="20%"/>

### ファームウェアの書き込み

ファームウェアを書き込むには、以下の手順に従ってください:

- *BOOTSEL* ボタン (ボード上の大きな白いボタン) を押しながら USB ケーブルで Raspberry Pi Pico を接続します
- ボタンを離します
- システム上に `RPI-RP2` という名前の新しいドライブが表示されます (Linux 環境では手動でマウントする必要がある場合があります)
- 使用した OLED に応じて、適切なファームウェアファイル (拡張子 `uf2`) をフォルダにコピーします
- マウントされたフォルダが消えるまで数秒待ちます

完了です!

### アンチ検出

そうなるかどうかはわかりませんが、*USBvalve を認識する*マルウェアによる検出を避けるためにファームウェアをカスタマイズしたい場合があるかもしれません :-)

変更したい可能性のある変数のほとんどを `usb_config.h` のこのセクションにまとめました ([再ビルドについては下記の Dockerfile を参照](https://github.com/cecio/USBvalve#dockerfile))

```C
// USB anti-detection settings
//
// Set USB IDs strings and numbers, to avoid possible detections.
// Remember that you can cusotmize FAKE_DISK_BLOCK_NUM as well
// for the same reason. Also DISK_LABEL in ramdisk.h can be changed.
//
// You can see here for inspiration: https://the-sz.com/products/usbid/
//
#define USB_VENDORID       0xCAFE
#define USB_PRODUCTID      0x1337
#define USB_DESCRIPTOR     "DataStore"
#define USB_MANUF          "USB Acme"
#define USB_SERIAL         "123456789A"
#define USB_VENDORID_STR   "Acme"            // Up to 8 chars
#define USB_PRODUCTID_STR  "DataStore"       // Up to 16 chars
#define USB_VERSION_STR    "1.0"             // Up to 4 chars
```


### ファームウェアのビルド

もちろん、独自のファームウェアをビルドすることもできます。ビルドには *Raspberry Pi Pico SDK* とこのリポジトリが必要です。

基本的な再コンパイル手順:
```
export PICO_SDK_PATH=</path/to/pico-sdk>

git clone --recursive https://github.com/cecio/USBvalve.git
cd USBvalve
mkdir build && cd build
cmake -DPICO_BOARD=pico ..   # or pico2 for standard build
make -j$(nproc)
# Output: build/src/USBvalve.uf2
```

新しい偽のファイルシステムを再作成したい場合は、新しいものを構築するためのユーティリティを配置した `utils` フォルダを確認するとよいでしょう。

#### Dockerfile

独自のファームウェアをカスタマイズした後にビルドしたい場合、完全なビルド環境を構築してファームウェアをコンパイルする `Dockerfile` を提供しています。

ビルドするには、メインの `USBvalve` フォルダで以下のコマンドを入力します:

```
# To Build:
#       docker build -t usbvalve-sdk -f Dockerfile.sdk .
#
# To Run (default: pico, SSD1306 OLED 128x32):
#       docker run --rm -v $PWD:/mnt usbvalve-sdk
#
# Options (via environment variables):
#       BOARD=pico|pico2          Board target (default: pico)
#       OLED_HEIGHT=32|64         OLED display height (default: 32)
#       PIWATCH=1                 Use GC9A01 round TFT instead of SSD1306
#       USE_BOOTSEL=1             Enable BOOTSEL button (disrupts Low Speed USB)
#
# Examples:
#       docker run --rm -e BOARD=pico2 -v $PWD:/mnt usbvalve-sdk
#       docker run --rm -e PIWATCH=1 -v $PWD:/mnt usbvalve-sdk
#       docker run --rm -e BOARD=pico2 -e OLED_HEIGHT=64 -v $PWD:/mnt usbvalve-sdk
```

ファームウェアは拡張子 `uf2` でフォルダ `USBvalve_out` に配置されます。

### コントリビュート

アイデアや改善点があれば、issue を開いて一緒にプロジェクトを改善しましょう! ありがとう!

### サポート

質問やサポートが必要な場合は、ここで `Issue` を開くか、Twitter/X [@red5heep](https://twitter.com/red5heep) で私に連絡してください

### コミュニティバージョン

コミュニティは他のボードのサポートやその他の変更を実装したフォークを作成しました。**USBvalve** の開発に貢献してくださった**すべての方に感謝します**。
以下は非公式/不完全/非サポートのリストです:
- [USBvalve-tbfa-Mod](https://github.com/TryBreakFixAgain/USBvalve-tbfa-Mod)

## 安全に関する警告

> [!WARNING]
> **USBvalve** と *USB killer デバイス*について多くの質問を受けています。**USBvalve** はこれらのデバイスをテストするために作られたものではなく、いかなる種類の絶縁や保護も備えていません。したがって、これらのデバイスの 1 つを扱っている疑いがある場合は、**USBvalve** ではなく別のものでテストしてください。そうしないと、デバイス、自分自身、または近くの物体を損傷する可能性があります。
ツールをダウンロード

人気

すべて見る →

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

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 究極のOSINTツールキット:調査グラフ、信頼度スコアリング、エイリアスファミリー、マップ、タイムライン、レポート。49個のモジュール、400以上のサイト、APIキー不要。

    708
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    GhostLock ワンタップ実行アプリ(CVE-2026-43499)

    500
  • 3

    ARTEX

    baarai/artex

    プランナー/ワーカーエージェント、資産グラフと探索グラフ、MITMトラフィック記録、脆弱性の再テストを備えたLLMマルチエージェント自律ペネトレーションテストプラットフォーム。

    398
  • 4

    redforge

    cybersecurity91/redforge

    ブラウザ側のレッドチームツールキット。偵察、ペイロード生成、認証情報攻撃、暗号、エンコーディング、エンゲージメントレポート向けの102のオフラインツールを備えています。

    341
  • 5

    CyberStrikeAI

    ed1s0nz/cyberstrikeai

    AIネイティブなサイバーセキュリティのためのアクションシステム。意図がガバナンスされた実行に変わり、証拠が運用記憶となり、すべての操作が次の操作を改善する。

    259
  • 6

    antifox

    antifox-ai/antifox

    偵察、攻撃対象領域の探索、エクスプロイト検証、証拠に基づくレポート提供を実行するAIマルチエージェント自律ペネトレーションテストプラットフォーム。

    257

すべてのツールを探索

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

すべてのツールを見る →