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는 캡처한 것을 분석하지만 캡처하지는 않으며, 이들 중 어느 것도 공통된 대상 뷰를 공유하지 않습니다.
이 트리는 의도적으로 넓습니다: 하나의 데스크, 하나의 런처, 셀 서베이, NAS 디코드, Diameter 메시지, 암호 감사가 모두 같은 TSV에 모이는 한 곳입니다.
다른 점이 하나 더 있습니다: 대부분의 도구는 작업이 성공했다고 알려줍니다. 이 도구는 성공하지 못했을 때를 알려주도록 만들어졌습니다. 모든 모듈에는 --selftest가 있고, 하드웨어가 필요한 모듈은 빈 결과를 반환하는 대신 누락된 무선 장치를 명시하며, 작업을 수행할 수 없는 모듈은 성공을 보고하는 대신 0이 아닌 값으로 종료합니다.
어떤 모듈에도 승인 게이트가 없습니다. 플래그나 환경 변수가 먼저 설정되지 않았다는 이유로 거부하는 것은 없습니다. 폐기된 --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는 박스의 상태를 한 페이지로 출력합니다.
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
조회는 세 가지 상태를 구분하며, 툴킷은 이들을 절대 하나로 합치지 않습니다: ok(운영자), absent(레지스터를 읽었으나 해당 행이 없음 — 이것이 바로 발견임), silent(테이블이 이 머신에 없음 — 답은 부정이 아니라 관측되지 않음). 02_cell_recon --status-tsv는 plmn_register 아래의 레지스터를 보고하며, 26_ss7_map --ispc는 모든 조회에서 owner_state를 출력합니다.
data/opops/는 비공개 부분입니다: 글로벌 타이틀 접두사, 셀 아이덴티티 블록, 코어 주소 범위 및 SMSC 아이덴티티에 대한 운영자 제공 테이블입니다. 이 트리는 로더와 스키마만 포함하고 내용은 절대 포함하지 않으며, 누락된 파일을 빈 답변이 아니라 silent로 보고합니다.
GUI는 Dashboard에서 열립니다 — 모든 모듈이 카드로 표시되며 카테고리별로 그룹화됩니다. 카드를 클릭하면 해당 모듈이 자체 탭으로 열립니다. 여섯 개의 탭은 영구적입니다:
| 탭 | 설명 |
|---|---|
| Dashboard | 모든 모듈이 카드로 표시되며 카테고리별로 그룹화됩니다. 메인 메뉴입니다. |
| Live Traffic | 실시간 GSMTAP 뷰(아래 참조). 열면 수신을 시작합니다. |
| Casebook | 케이스, 선택된 셀, 증거/캡처, 타임라인, IDS 경보, 수동 센서 노드 및 HTML/JSON/TSV 보고서. Evidence 페이지는 모듈별 loot 브라우저와 미리보기를 유지합니다. |
| Map | 툴킷이 위치를 파악한 모든 것(셀, TA 링, 지오로케이션된 프레임 및 loot/map/layers/*.tsv의 영역)을 번들된 Natural Earth 베이스맵 위에 그리는 하나의 영구 지도입니다. 이동, 확대/축소 및 레이어 전환이 가능합니다. |
| Fleet | 원격 노드와 각 노드가 측정한 내용: 클래스, 전송 방식, 역할, 기능, 마지막 확인 시각 및 이벤트 스트림이 얼마나 뒤처져 있는지. 노드를 조사하고, 스트림 윈도우를 수집하고, 케이스로 복사하거나, 모듈을 그곳에서 실행하도록 디스패치할 수 있습니다. |
| Stats | 모듈 및 수집 개수, 상태 표시줄, 그리고 툴킷이 두터운 부분. |
| Notifications | 이 트리가 알려주기로 결정한 내용을 오래된 순서로 표시합니다. |
| Help | 이 트리가 어떻게 구성되어 있고 어떻게 구동하는지. |
| Settings | 환경 정보와 의존성 및 SDR 프로브 작업. |
| Workflows | 패널에서 실행되는 저장된 체인. |
모듈 탭은 이들과 나란히 나타나며 닫을 수 있지만, 영구 탭은 닫을 수 없습니다.
Settings → Interface → Theme은 전체 데스크를 두 가지 팔레트 사이에서 전환합니다: 앱이 그려진 청흑색 팔레트인 Night와, 같은 데스크를 한 단계 다른 온도로 옮긴 Ember — 따뜻한 편향을 지닌 거의 검은 표면과 단일 엠버 악센트입니다.
생성기를 변경한 후:
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>/에 저장되므로, 이후 모든 기존 verb가 로컬 경로에서 동작하며 저장소는 두 파일을 모두 보관합니다.
노드가 정직하게 제공할 수 있는 것은 전송 방식에 따라 다르며, 툴킷은 빈틈을 메우는 대신 그대로 알려줍니다: local 및 ssh 노드는 실제 survey를 실행하고, adb 핸드셋은 자체 서빙 셀과 이웃 셀을 보고하며 누락된 필드는 표시됩니다. serial/qmi/mbim 모뎀은 하나의 서빙 셀을 보고하고 그렇게 라벨링되며, diag/sms는 누락된 조항을 명시하며 거부합니다. 모든 행은 source node:<name>:<transport>:<kind>를 포함하므로, 테이블은 셀이 어디서 수신되었는지 절대 잃지 않습니다. 저장소가 비어 있는 노드는 빈 survey가 아니라 핸드오프(종료 코드 3)입니다.
모듈 페이지는 옆에 콘텐츠가 배치된 뷰들의 좌측 메뉴로, STATUS, ACTIONS, ALL MODULE VERBS 카드로 그룹화됩니다. 액션 버튼은 가장 자주 사용하는 verb를 다루며, 생성된 선택기는 모듈 인덱스로부터 구축되어 나머지 모든 것을 노출합니다. 별도의 인자 필드와 명령 복사 버튼이 있어 어떤 것도 접근 불가능하지 않습니다.
Live Traffic은 실제 테이블(순서, 시간, 유형, 채널, ARFCN, 타임슬롯, 신호, 방향, 길이, 페이로드)이며, 그 위에 유형, 채널 또는 페이로드와 일치하는 필터 상자가 있습니다. 업링크 행은 표시됩니다.
대시보드는 구성 가능하며, 설정을 기억합니다. 모든 카드에는 별표가 있어, 고정된 모듈은 정렬 설정과 관계없이 그리드 선두에 옵니다. Sort는 Workflow(카테고리 순서), Most used(실행 횟수 기준), Name, Category를 제공하며, Density는 Compact, Comfortable, Spacious 카드 크기를 전환합니다. 이 모든 것은 바이너리가 아닌 state/에 저장되므로 재시작 후에도 유지되며, 두 검색 모두 조용히 비워지는 대신 no match를 표시합니다.
Stats는 주요 카운트를 타일로, 카테고리별 분석을 막대로, 그리고 모든 것이 디스크 어디에 있는지를 보여줍니다. 열 때마다 다시 집계하므로, 방금 loot를 기록한 모듈이 여전히 실행 시점의 숫자를 보여주는 일은 없습니다.
좌측의 모듈 목록은 접을 수 있습니다 — 헤더 바의 Modules 버튼을 사용합니다. 모듈 페이지에 전체 너비가 필요할 때 접으십시오.
헤더 스트립은 모듈 자체에서 읽어온 라이브 셀룰러 상태를 표시하므로 모듈과 불일치할 수 없습니다:
SDR 선택된 라디오 (01_radio --status-tsv)
TX 해당 라디오가 전송할 수 있는지 여부 — 대부분의 공격 verb에 필요
FREQ 튜닝된 주파수
CELLS survey 저장소의 셀 (02_cell_recon)
GPS survey 위치 소스 (04_tower_map)