導入と設定

RoamSwitch が守るもの

点検コマンド(doctor)で、動かせる状態かを確かめます。検知の範囲の自己点検(detection-coverage)で、見えない部分を読みます。

  • レベル: 入門
  • 約25分
  • 2026-11-13

#RoamSwitch が守るもの

RoamSwitch は、Mac と Linux のマシンを攻撃から守る製品です。守る対象は、ランサムウェア、認証情報の盗難、不審なプログラムの実行、ネットワークからの攻撃、サプライチェーン、AI エージェントなどに分けて、章ごとに整理しています。全体の一覧は 機能一覧 で見られます。

この教材では、それぞれの機能を題材に、次の順で学びます。

  1. 攻撃がどう成り立つかを知る
  2. 無害なデータで、同じ状況を作る
  3. RoamSwitch が何を見つけるかを、実際の出力で確かめる
  4. 何が見えないかを知る
読み方

どのモジュールも、4 の「見えない部分」まで読んでください。何を見ていないかが分かって、はじめて守りを組み立てられます。

#7つの動作と、版ごとの役割

機能は、動作で分けると 7 種類です。1 つの機能が、複数の動作を持つこともあります。

動作意味
検知異常を見つけて知らせる
遮断通信や実行を止める
隔離疑わしいファイルやマシンを、ほかから切り離す
監査設定や状態を点検して、弱いところを示す
記録後から調べられるように、事実を残す
報告結果をまとめて伝える
制御設定やサービスを、決めたとおりに保つ

守る対象に合わせて、版が分かれています。

版守る対象
MacMac の端末
Linux ClientLinux のデスクトップ
Linux Server動かし続けるサーバー(動作中のプログラムの監視、ファイルの改ざん検知、SSH の保護など)
SensorLAN の状態を、ネットワークの側から調べる

一緒に入るアプリもあります。AccessScope はアクセスログの診断に、PathScope は権限昇格の経路の分析に使います。

通知だけの機能と、自動で止める機能

同じ「検知」でも、知らせるだけの機能と、自動で対処する機能があります。どちらなのかは、機能一覧の「検知したときの動き」で確かめられます。自動で止める機能は、誤検知のときの影響が大きいので、初めからオンのものと、自分で選んでオンにするものに分かれています。

#自分の環境で動かせるかを確かめる

動かせる状態かを確かめる

RoamSwitch には、RoamSwitch 自身の点検(doctor) という点検コマンドがあります。何も変更せずに、このマシンで RoamSwitch が動く条件がそろっているかを調べます。管理者権限で実行すると、すべてを確認できます。

sudo roamswitch doctor

次は、管理者権限なしで実行した例の抜粋です(Server Edition、Ubuntu 24.04、入れて1分ほどあと)。

実行結果
[注意] root ではないため、root だけが読める状態は確認できません。sudo roamswitch doctor で実行すると、すべて確認できます
[正常] nft: /usr/sbin/nft
[正常] systemctl: /usr/bin/systemctl
[正常] RoamSwitch のデーモンが動いています
[注意] fail2ban も動いていて、ファイアウォールの規則を書き換えます。RoamSwitch の規則と重なることがあります
[正常] 署名つきデータの更新は動いています。最後の成功: 2026-11-13 08:00 UTC

失敗はありません(注意 5 件)

出力は、次のように読みます。

  • 正常: 条件がそろっています
  • 注意: 動きますが、知っておきたいことがあります。上の例では、fail2ban もファイアウォールの規則を書き換えていて、規則が重なる可能性を示しています。root でないために確かめられなかったことも、注意として出ます
  • 失敗: 動かせない理由があります。終了コードが 1 になるので、スクリプトからも判定できます

#「見えない部分」を読む

RoamSwitch は、攻撃の手法(MITRE ATT&CK)ごとに、自分が何を見ていて、何を見ていないかを書き出せます。これが 検知範囲の自己点検 です。何も実行せず、どこにも送りません。

検知の範囲を自己点検する
roamswitch detection-coverage --server | head -12
出力の抜粋
=====================================================
  🧭 検知の範囲の自己点検 (MITRE ATT&CK) (Server Edition)
=====================================================

  39件中: 検知 0 / 一部 26 / 見ていない 13。対応するガードが止まっている項目: 0

  🟡 T1685 Disable or Modify Tools  [一部]  一部のみ稼働
      担当: selfMonitor, logTamperWatch, ebpfHeartbeat, criticalPathFim
      見えない部分: デーモン自身が異常終了したとき(強制終了、クラッシュ、メモリ不足による停止)は systemd が再起動し、次の起動で通知します。応答しなくなったときも systemd のウォッチドッグ(WatchdogSec=30)が再起動します。通常の手順で止められたときは、ホストが動き続けたまま3分以上止まっていて、ログ改ざん監視が有効な場合だけ、次の起動で通知します。止まっている間は何も知らせられません。(以下略)

  ⬜ T1686 Disable or Modify System Firewall  [見ていない]  -
      見えない部分: フラッシュされても、デーモンは自分のテーブルを30秒ほどで作り直しますが、それは自分のルールの自己修復です。ホストのファイアウォールの変更は見ておらず、知らせもしません。

数字は版によって変わります。この出力は 1.17.41 のものです。2.6.0 の Server Edition は 46 手法(一部 35・見ていない 11)で、Client Edition は 46 手法(一部 39・見ていない 7)です(コードから出した値で、実機では取り直していません)。見てほしいのは、「検知 0」の部分です。この出力は、どの手法についても「完全に検知できる」とは書いていません。 見えない部分を、製品自身が言葉にして示します。

行の右端は、担当のガードがいま動いているかです。この VM では、T1685 の担当の 4 つのうち、ebpfHeartbeat だけが動いていませんでした(--json の guards で確かめられます)。そのため「一部のみ稼働」です。

見えない部分

このモジュールでは、次のことは確かめていません。

  • 管理者権限を持つ攻撃者が RoamSwitch 自身を止めたり、設定を書き換えたりしたときに、そのすべてを見つけられるか。上の出力にあるとおり(この出力の版)、デーモンが止まっている間は、何も知らせられません。異常終了(kill -9 など)は、起動し直したあとで知らせます(更新・脅威データ・アンインストール で確かめます)。systemctl stop で止められたときは、3分以上止まっていて、ログ改ざん監視が有効な場合だけ、次の起動で知らせます。2.6.0 は、デーモンが終わった直後に、unit の ExecStopPost が通常の停止と異常終了を通知します(コードと文書で確認。実機では確かめていません)
  • 点検コマンドで「失敗はありません」と出ても、攻撃を受けていない証明にはなりません。意味は、動かせる条件がそろっている、ということだけです
確認問題

detection-coverage で「見ていない」と表示された手法は、何を意味しますか

解説を見る

「見ていない」は、その手法が製品の検知の範囲の外にある、という意味です。攻撃があるかどうかとは関係がありません。ガードが止まっている場合は、別の欄(「対応するガードが止まっている項目」)に数えます。

#次に学ぶこと

扱う機能
確認した内容

2026-11-13に確認しました。対象は Linux 1.17.41 です。公開の apt から入れた 1.17.41 の Server Edition(使い捨ての Ubuntu 24.04 arm64 の VM)で、purge のあと入れ直し、doctor(一般ユーザーと sudo)と detection-coverage(表と --json)を、日本語と英語で実行しました。2026-11-18 に、Linux 2.6.0 のコードと文書を読んで、検知範囲の手法の数と、デーモンが止まったときの通知の注記だけを足しました。実機では確かめていません。

コマンドの出力は、製品の版や環境によって変わります。違いが出たら、まず製品の版を確かめてください。