はじめに3ステップで使うよ
使い方はこれだけ。覚えるのは3つだよ。
Windows:INSTALL_WSA.bat / Mac:INSTALL_WSA.command
ダブルクリックするだけ。準備が自動で走るよ。初回はインターネット接続がいるよ。
Windows:START_WSA.bat / Mac:START_WSA.command
ダブルクリックすると、準備ができてブラウザが自動で開くよ。診断を選んで使ってね。
Windows:FORCE_STOP_WSA_PORTS.bat / Mac:STOP_WSA_PORTS.command
ダブルクリックすると、WSAが使うポート 8790 と 8791 を解放するよ。裏で動き続けないようにする、大事な片付けだよ。
sudo)で動かしてみてね。なお、8790 / 8791 をほかのアプリが使っている場合、そのアプリは勝手に止めないよ。名前と番号を表示して、止めていいか聞くよ。2b613b148d96f09357f6eddd5a8c0d6eeb2030f777a148d3be2e43451fb8b408 だよ。起動時に表示される指紋と一致するか確かめてね。ウイルス対策ソフト(Defender)を切る必要はないよ。切らないでね。登場人物まずは仲間を紹介するね
パソコンの中は小さな街。WSAはその街を見回るチームだよ。
みんなを各手順へ案内するよ。
フォルダの森を巡回するよ。スキャンの主役だよ。
調べたファイルの特徴を覚えておくよ。
見つけた情報を記録して伝えるよ。
困ったときの対処を教えてくれるよ。
危ないものには「近づくな」と警告するよ。WSAは削除しないから、ボクの役目は止めることだよ。
第1話WSAってなに?
WSAは、パソコンの中を見回って「気になるもの」をお知らせする診断チームだよ。
第2話じゅんびするもの
- Node.js 24以降 — みんなの動力源。入っていないと動けないよ。
- Python 3.12以降(Macの場合)— スキャン用のエンジンを動かすよ。
python3 --versionで確認してね。古かったら python.org から入れるか、Docker Desktop を入れてね。 - Docker・Compose・Python 3(Windowsの場合)— WSL 2 の Ubuntu で使うよ。
- 展開したフォルダ — ZIPは「すべて展開」してから開いてね。Windowsの人は Windows フォルダ、Macの人は Mac フォルダの中身を使うよ。
- スペック — 高い性能はいらないよ。最近のパソコンなら大丈夫。スキャンの速さはCPUよりディスクの速さで決まるよ(SSDだと速いよ)。
第3話3つのしんだん
ブラウザが開いたら、3つのうち1つを選んでね。
| 診断 | なにをするの? | 使えるのは? |
|---|---|---|
| Webサイト | 試験用サイトの設定を診断して、見直し方を教えてくれるよ。 | Windows・Mac |
| このPC | Windows 11の保護設定を確認するよ。 | Windowsだけ |
| フォルダ・ファイル | 白血球がフォルダを歩き回って、気になるファイルをお知らせするよ。 | Windows・Mac |
第4話スキャンの見方 — カードの色でわかるよ
「フォルダ・ファイルをスキャン」を選んだら、フォルダ・ドライブ・全固定ドライブ(または全ボリューム)のどれかを選んで「スキャン開始」を押してね。白血球が出発するよ。
白血球がフォルダの森を1つずつ見回るよ
気になる特徴があるよ。場所や入手先を思い出して確認してね。
気になる特徴が重なっているよ。内容を確認するまでは開かないでね。
内容を確認できなかったよ。開く前に、入手先や使っているアプリを確認してね。
白血球がチェックする特徴は、たとえばこんな感じ。
- 拡張子と中身がちがう(
写真.jpgの中身がプログラム、など) - 二重拡張子(
請求書.pdf.exeのような名前) - デジタル署名がない/無効な実行ファイル
- 自動起動の場所(Windowsのスタートアップ、MacのLaunchAgents/LaunchDaemons)にある
- インターネットから取得した(WindowsのMark of the Web、Macの隔離属性)
結果の画面では、ファイルごとに「保存場所を開く」で場所を確認したり、SHA-256をコピーしたり、レポート(HTML / JSON / CSV)を保存したりできるよ。
第5話順番モード — ドライブを1台ずつ回るよ
「全ドライブを1台ずつ」を選ぶと、ドライブ隊が C: → D: → E: と順番に回るよ。1回のスキャンには上限が100万件あるから、全ドライブを1回でやると大きなドライブが他の分の枠を食いつぶしちゃうんだ。1台ずつなら、ドライブごとに100万件の枠が使えるよ。
第6話はやくなるコツ — マクロファージのノート
マクロファージは、一度調べたファイルの特徴をノートに記録しているよ。だから2回目のスキャンは、変わっていないファイルの読み取りを省略して、ぐっと速くなるんだ。途中で中止しても、確認済みの分はノートに残るよ。
マクロファージのノート。2回目はノートを見るだけだから速いよ
ほかにも、30秒以上まったく進まないファイルは自動で飛ばして先へ進むよ。2GBを超える大きなファイルは、ハッシュも署名確認も省略するよ。
第7話こまったときは — 症状別チェック表
困ったときは血小板たちが応急処置するよ
| こんなとき | どうする? |
|---|---|
| 画面が止まって見える | 終わっていないだけかも。進捗バー・件数・確認中の場所を見てね。30秒以上進まないファイルは自動で飛ばすよ。 |
| 100万件で止まった | 1回のスキャンの上限だよ。ドライブごと・フォルダごとに分けてスキャンしてね。 |
| ドライブ一覧が出ない(Windows) | PowerShellの実行がブロックされているかも。「フォルダを選択」か、フォルダのパスを直接入力してね。 |
| Macで開けない | 門番が止めているよ。右クリック →「開く」で開いてね。 |
| 中止が効かないように見える | 「中止しています…」と出たら、少し待ってね。止まらないときは STOP を開いてね。 |
| ポートが解放できない | ポートを閉じるファイルを「管理者として実行」(Macはターミナルで sudo)で動かしてみてね。 |
| 起動時に「起動不可(BLOCKED)」と出た | 配布物が壊れているか、変わっているか、脅威が見つかったよ。起動しないで、配布元に連絡してね。ZIPを解凍し直すときは、空の新しいフォルダに展開してね。 |
| 起動時に「要確認(REVIEW)」と出た | 一部を確認できなかったよ。表示された理由を読んでね。マニフェストにないファイルがあるときは、中身を確認してから「y」で起動してね。Defenderが使えない環境ではこの表示になるよ。 |
| 受け取ったZIPがあやしい | 展開する前に VERIFY_ZIP.bat(Macは VERIFY_ZIP.command)を動かして、ZIPを検査してね。「展開不可」と出たら展開しないで、配布元に連絡してね。 |
最終話おやくそく — 3つだけ覚えてね
見るだけ。 WSAはファイルを削除・隔離・移動・変更・実行しないよ。列挙・読み取り・ハッシュ・署名確認・表示・レポートだけだよ。
このパソコンの中だけ。 診断はローカルテスト専用。ファイル情報は外部へ送信しないよ。本番環境への導入はできないよ。
ウイルス対策ソフトの代わりじゃないよ。 白血球のお知らせは「気になる特徴があるよ」という目安だよ。ふだんのウイルス対策はそのまま続けてね。
WSA v1.4.3 Windows / macOS Local Test 専用 Production Ready ではないよ