2G GSM、3G UMTS、4G LTE、5G NRのエアインターフェース、コアネットワーク、SIM識別情報、RF追跡、攻撃分析に対応する57個のモジュールを備えたGTK4およびCLIのセルラーセキュリティツールキット。
Linux向けのGTK4セルラーセキュリティツールキットで、その背後に完全なCLIを備えています。2G/GSM、3G/UMTS、4G/LTE、5G/NRをカバーするシェルモジュールに加え、キャプチャに対するパッシブ解析と世代別CVEキットを提供します。
すべてのモジュールはスタンドアロンのスクリプトです。GUIはそれらのビューであり、コンテナではありません — インターフェースの背後に何も閉じ込められていません。
初期開発段階であり、その点について正直に述べています。 このツリー内のどのモジュールも、実際の無線機に対して実行されたことはありません。ビルドされたマシンにはSDRが搭載されていないため、すべての無線経路は書かれ、レビューされていますが、テストはされていません。実際に動作するもののセクションでは、どれがどれかを正確に説明しており、バグを報告する前に読む価値があります。
セルラーツールはレイヤーと世代によって分断されています。gr-gsmは2Gです。srsRANは4G/5Gです。Osmocomはその下にあるスタックです。Wiresharkはキャプチャしたものを解析しますが、キャプチャはしません。そしてそれらのどれもターゲットビューを共有していません。
このツリーは意図的に広範です。1つのデスク、1つのランチャー、セルサーベイ、NASデコード、Diameterメッセージ、暗号監査がすべて同じTSVに集まる1つの場所です。
もう1つの違いは、ほとんどのツールは動作したと伝えてくるということです。このツールは、動作しなかったときにそれを伝えるように作られています。すべてのモジュールには--selftestがあり、ハードウェアに依存するモジュールは空の結果を返す代わりに不足している無線機を明示し、職務を果たせないモジュールは成功を報告するのではなく非ゼロで終了します。
どのモジュールにも承認ゲートはありません。 フラグや環境変数が事前に設定されていないという理由で拒否することはありません。廃止された--i-have-a-lab-and-authorisation、--ack-isolated-lab、LTE_ARMED、NR_ARMED、MAP_ARMED、FEMT_S1_ARMED、SBA_ARMED、BEXP_TX_ARMED、NRJ_TX_ARMED、JAMD_LAB_AUTHORISEDは受け入れられますが無視されるため、古いコマンドラインは引き続き動作します。bash modules/00_deps.sh --preflightはマシンの状態を1ページで出力します。
GUIをビルドします:
cd native
meson setup builddir
meson compile -C builddir
次に、プロジェクトルートから:
sudo ./imsisting.sh # CLI menu
./imsisting.sh --list # module list
./imsisting.sh --index # the module index as TSV
./imsisting.sh --gui # launch the GUI
./imsisting.sh --tui # launch the TUI (modules listed by their menu keys)
または、ビルド済みのバイナリを直接起動します:
./native/builddir/imsisting-gui
ショートカット。 このリポジトリには bin/ ラッパーが同梱されているため、フルパスを入力せずに imsisting、imsisting-gui、imsisting-tui と入力できます。これらを PATH に追加してください:
export PATH="$PWD/bin:$PATH" # add to ~/.bashrc or ~/.profile
imsisting --list # works from any directory
imsisting-gui # launch the GUI
imsisting-tui # launch the TUI
GUI は起動時に一度だけではなく、アクションごとに pkexec 経由でパスワードを要求します。
必須: GTK4 (4.14+)、meson、ninja、C コンパイラ、python3。
# Debian / Ubuntu
sudo apt install build-essential meson ninja-build libgtk-4-dev \
python3 python3-numpy python3-scipy
# Arch
sudo pacman -S base-devel meson ninja gtk4 python python-numpy python-scipy
オプションだが特定のモジュールで使用: gnuradio + gr-gsm、srsRAN、
Open5GS/free5GC、tshark、pcsc-tools、gpsd、python3-cryptography。
00_deps は何が存在し何が欠けているかを報告し、インストール済みのツールと
実際に完全なスタックとを区別します。
デコードによって識別子が得られ、参照テーブルによって所有者が得られます。これらは 公開されていますが同梱されていません。数十万行に及び、古くなるためです — チェックアウトごとに一度フェッチャーを実行してください:
tools/fetch-reference-data.sh # ~2 500 PLMNs, ~6 300 ISPCs, ~67 000 PENs
tools/fetch-reference-data.sh --check # what is present, without downloading
ルックアップは3つの状態を区別し、ツールキットがそれらを混同することは決してありません。ok(オペレーター)、absent(レジスタは読み取られたが該当する行が存在しない — それ自体が発見です)、そしてsilent(テーブルがこのマシン上に存在しない — 答えは未観測であり、否定的なものではありません)。02_cell_recon --status-tsvはplmn_register配下のレジスタを報告し、26_ss7_map --ispcはすべてのルックアップでowner_stateを出力します。
data/opops/はプライベートな部分です。グローバルタイトルプレフィックス、セル識別ブロック、コアアドレス範囲、SMSC識別子に関するオペレーター提供のテーブルです。ツリーにはローダーとスキーマのみが同梱され、内容は決して含まれず、ファイルが見つからない場合は空の答えとしてではなくsilentとして報告されます。
GUIはダッシュボードで開きます — すべてのモジュールがカードとしてカテゴリ別にグループ化されています。カードをクリックすると、モジュールが独自のタブとして開きます。6つのタブは常設です:
| タブ | 内容 |
|---|---|
| ダッシュボード | すべてのモジュールがカードとしてカテゴリ別にグループ化されています。メインメニューです。 |
| ライブトラフィック | ライブGSMTAPビュー(下記)。開くとリスニングを開始します。 |
| ケースブック | ケース、選択したセル、証拠/キャプチャ、タイムライン、IDSアラート、パッシブセンサーノード、HTML/JSON/TSVレポート。証拠ページにはモジュールごとのルートブラウザとプレビューが保持されています。 |
| マップ | ツールキットが特定したすべてのもの(セル、TAリング、ジオロケートされたフレーム、loot/map/layers/*.tsvからのエリア)を表示する常設マップで、同梱のNatural Earthベースマップ上に描画されます。パン、ズーム、レイヤーの切り替えが可能です。 |
| フリート | リモートノードと各ノードが測定した内容:クラス、トランスポート、ロール、機能、最終確認時刻、イベントストリームの遅延度。ノードを調査し、ストリームウィンドウを収集してケースにコピーしたり、そこで実行するモジュールをディスパッチしたりできます。 |
| 統計 | モジュールとコレクションの数、ヘルス状態の行、ツールキットが充実している箇所。 |
| 通知 | ツリーが通知することを決めた内容を古い順に表示します。 |
| ヘルプ | ツリーの構成と操作方法。 |
| 設定 | 環境情報に加え、依存関係とSDRプローブのアクション。 |
| ワークフロー | 保存されたチェーンをパネルから実行します。 |
モジュールタブはこれらと並んで表示され、閉じることができますが、常設タブは閉じることができません。
設定 → インターフェース → テーマで、デスク全体を2つのパレット間で切り替えます:アプリが描かれた青黒いパレットであるナイトと、同じデスクを1段階温度を変えたもの — ほぼ黒のサーフェスに暖色のバイアスと単一のエンバーアクセントを加えたエンバーです。
ジェネレーターを変更した後:
tools/gen-theme.py # write native/resources/theme-ember.css
tools/check-theme.sh # packaged? generated? in step with the base sheet?
cd native && ninja -C builddir
tools/check-theme.sh が存在するのは、パッケージ化されていない テーマが
無言で失敗するからです。GTK はベースシートを描画し、ドロップダウンには依然として「Ember」と表示されます。
GUI の --selftest も同じことを検証します(gui-theme-ember PASS packaged)。
調査は、目の前のマシン上で行われる必要はありません。空気を読み取るモジュールは 登録済みのノードを指定でき、ノードは実際に測定した内容で応答します。
modules/02_cell_recon.sh --node desk # survey through the node, store rows here
modules/03_gsmtap.sh --node desk # fetch its newest capture and decode it
modules/17_pcap_analysis.sh --node desk # list the captures that node holds
modules/18_imsi_exposure.sh --node desk # audit the node's newest capture
tools/node_source.py support # what each transport can answer
tools/node_source.py cells desk # the node's cells, in the store's table
tools/node_source.py events desk # the node's spool, as event rows
tools/node_source.py captures desk # the node's capture store
取得したキャプチャは captures/nodes/<name>/ に保存されるため、以降は既存のすべての動詞がローカルパス上で動作し、ストアは両方のファイルを保持します。
ノードが正直に提供できる内容はそのトランスポートに依存し、ツールキットはその隙間を埋めるのではなく、そのまま伝えます。local および ssh ノードは実際のサーベイを実行し、adb 端末は自身のサービングセルとネイバーを報告し、伏せられたフィールドにはその旨が示され、serial/qmi/mbim モデムは1つのサービングセルのみを報告し、そのようにラベル付けされ、diag/sms は不足している条項を明示して拒否します。すべての行には source node:<name>:<transport>:<kind> が付与されるため、テーブルがセルをどこで受信したかの情報を失うことはありません。ストアが空のノードはハンドオフ(終了コード3)であり、空のサーベイではありません。
モジュールページは、左側にビューのメニュー、その横にコンテンツを配置し、カード(STATUS、ACTIONS、ALL MODULE VERBS)にグループ化されています。アクションボタンは最もよく使う動詞をカバーし、生成されたセレクターはモジュールインデックスから構築されてその他すべてを公開し、引数フィールドとコマンドコピーボタンを別途備えているため、何も到達不能にはなりません。
Live Traffic は実際のテーブル(シーケンス、時刻、タイプ、チャネル、ARFCN、タイムスロット、信号、方向、長さ、ペイロード)で、その上にタイプ、チャネル、ペイロードにマッチするフィルターボックスがあります。アップリンクの行にはマークが付きます。
ダッシュボードは設定可能で、その設定を記憶します。 すべてのカードにはスターが付いており、ピン留めされたモジュールはソート設定に関係なくグリッドの先頭に表示されます。Sort は Workflow(カテゴリ順)、Most used(実行回数順)、Name、Category を提供し、Density は Compact、Comfortable、Spacious のカードサイズを切り替えます。これらはすべてバイナリ内ではなく state/ に保存されるため、再起動後も維持されます。また、両方の検索は静かに空白になるのではなく no match と表示します。
Stats は主要なカウントをタイルで、カテゴリ別の内訳をバーで、そしてすべてがディスク上のどこに存在するかを表示します。開いたときに再集計するため、ちょうどルートを書き込んだモジュールが起動時の数値を表示し続けることはありません。
左側のモジュールリストは折りたたみ可能です — ヘッダーバーの Modules ボタンで操作します。モジュールページで全幅が必要な場合は折りたたんでください。
ヘッダーストリップはライブのセルラー状態を表示し、モジュール自体から読み取るため、モジュールと矛盾することはありません。
SDR 選択された無線 (01_radio --status-tsv)
TX その無線が送信可能かどうか — ほとんどの攻撃動詞はこれが必要
FREQ 同調周波数
CELLS サーベイストア内のセル (02_cell_recon)
GPS サーベイの位置ソース (04_tower_map)
--tab N はタブを直接開きます(0 Dashboard、1 Live Traffic、2 Casebook、3 Stats、4 Notifications、5 Help、6 Settings、7 Workflows、8 Map、9 Fleet):
./native/builddir/imsisting-gui --tab 1