Signal OPS

보안 연구 및 교육을 위한 전 스펙트럼, 전 소스 신호 정보 융합 플랫폼입니다. Signal OPS는 수십 개의 공개 수집 소스(WiFi/Bluetooth/기지국 데이터베이스, 인터넷 노출 스캐너, 카메라 인덱스, ADS-B 항공편 피드, 위성 TLE 추적, SDR/APRS 네트워크)를 하나의 전술 지도와 Flask API로 통합하여 RF, 셀룰러, 항공, 궤도, 감시 영역을 하나의 실시간 작전 상황으로 상호 연관시키며, 선택적으로 AI 지원 위협 요약을 추가로 제공합니다.

기능

• 통합 RF/OSINT 스캔 — 한 번의 호출로 WiFi, Bluetooth, 기지국, IoT, 카메라, 항공기 소스에 병렬로 분산되어 중복을 제거하고 결과에 점수를 매깁니다.
• 카메라 탐지 — Shodan, FOFA, BinaryEdge, Windy Webcams, OpenStreetMap 감시 노드, Insecam을 좌표 또는 국가별로 검색합니다.
• 셀룰러 인텔리전스 — 오프라인 MCC/MNC → 통신사/국가 변환 및 IMSI 캐처/Stingray 휴리스틱을 지원하는 기지국 조회(WiGLE, OpenCellID).
• 무선 위협 탐지 — 로그/이블 트윈 액세스 포인트 탐지 및 Bluetooth 추적기(AirTag, Tile, SmartTag 등) 식별.
• 항공 모니터링 — adsb.fi 및 OpenSky를 통한 실시간 ADS-B, 비상 스쿼크 디코딩, 드론 휴리스틱, 항공기 NAC-P에서 파생된 GPS 재밍 히트맵.
• 궤도 추적 — SGP4 전파를 통한 CelesTrak TLE 수집, 임무 분류, SatNOGS 지상국 오버레이.
• SDR 및 APRS — 공개 KiwiSDR 수신기 지도 및 APRS.fi 스테이션 조회.
• IP 위협 인텔리전스 — 다중 소스 집계(ipinfo, AbuseIPDB, CriminalIP, LeakIX, ZoomEye)와 경량 포트 스캔 및 결합 위험 점수.
• 관심 목록 및 알림 — 특정 BSSID, SSID, IP, MAC 또는 ICAO 헥스를 추적하고 스캔 중 적중을 확인합니다.
• AI 분석(선택 사항) — Google Gemini가 키가 제공되면 스캔 결과를 평가 및 위험 수준으로 요약합니다.

거의 모든 소스는 선택 사항입니다. 키가 설정되지 않으면 해당 페처는 정상적으로 건너뜁니다 — 무료 소스(OpenStreetMap, Insecam, ipinfo.io, ADS-B, CelesTrak, KiwiSDR)는 키 없이도 작동합니다.

스크린샷

SIGINT 지도 — 통합 다중 소스 보기

메인 지도는 WiFi, Bluetooth, 셀룰러, 카메라, 항공기 레이어를 동일한 영역에 융합하며, OSM 카메라, ALPR/Flock 네트워크, 경찰서 오버레이를 토글할 수 있습니다.

감시 및 CCTV

감시 피드	CCTV 탐지

감시 목록은 각 장치에 점수를 매기고(예: "의심도 35/100: 인증되지 않은 카메라") WiGLE, Insecam, OSM에서 라우터, TV, 노출된 카메라를 병합합니다. CCTV 보기는 발견된 카메라를 소스별로 그룹화하고 카메라별 위험 및 라이브/메타데이터 상태를 표시합니다.

기지국 인텔리전스 및 SDR / APRS

기지국 히트맵	SDR / APRS 네트워크

기지국 인텔리전스는 MCC/MNC 통신사 조회로 기지국 밀도를 표시합니다; SDR 보기는 콜사인 조회와 함께 공개 KiwiSDR 수신기 및 APRS 스테이션을 매핑합니다.

요구 사항

• Python 3.9+
• 아래에 나열된 Python 패키지

핵심 종속성:

flask
requests
python-dotenv

권장 사항(전체 기능 활성화 — 캐싱, 속도 제한, 위성 전파):

cachetools        # 제한된 지리 캐시(없으면 무제한 dict로 대체)
flask-limiter     # 요청 속도 제한
sgp4              # /api/satellites용 위성 위치 전파
google-genai      # Gemini AI 분석(GEMINI_API_KEY 사용 시에만)

모두 설치:

pip install flask requests python-dotenv cachetools flask-limiter sgp4 google-genai

설정

1. 프로젝트 클론 및 진입

git https://github.com/emrekybs/signalops.git
unzip signalops-v1.zip

2. (선택 사항) 가상 환경 생성

python -m venv venv
source venv/bin/activate      # Windows: venv\Scripts\activate

3. 종속성 설치

pip install -r requirements.txt

requirements.txt가 없으면 위 요구 사항 섹션의 pip install 줄을 사용하세요.

4. 환경 구성

예제 파일을 복사하고 보유한 키를 입력하세요:

cp .env.example .env

그런 다음 .env를 열고 API 키를 붙여넣으세요. 모든 키는 선택 사항입니다 — 해당 소스를 비활성화하려면 줄을 비워두거나(또는 삭제) 하세요. 각 키의 용도와 획득 방법은 다음 섹션을 참조하세요.

5. (선택 사항) 로컬 데이터셋 추가

즉각적인 오프라인 카메라 및 경찰서 조회를 위해 data/ 디렉토리 아래에 배치하세요(또는 DATA_DIR을 다른 곳으로 지정):

data/CAMERAS_WITH_NETWORK_DATA.geojson   # 포인트 피처(카메라)
data/police_precincts_usa.geojson        # 폴리곤 피처(미국 경찰서)
data/camera_networks.json                # 네트워크 공유 메타데이터
data/tiles/{z}/{x}/{y}.json              # 선택적 타일 카메라 데이터셋

이 파일들이 없으면 앱은 자동으로 실시간 OpenStreetMap Overpass 쿼리로 대체합니다.

6. 실행

python app_v2.py

서버는 **http://0.0.0.0:8080**에서 시작됩니다. 브라우저에서 http://localhost:8080을 여세요.

언제든지 로드된 공급자를 확인하세요:

GET /api/status     # 활성 vs. 누락 키
GET /api/debug      # 키별 부울 + 실시간 WiGLE 인증 테스트

환경 변수

프로젝트 루트에 .env 파일을 생성하세요. 아래는 앱이 읽는 전체 목록입니다.

데이터 소스 API 키(모두 선택 사항)

앱 구성

키 없는 소스(항상 활성)

구성이 필요 없는 소스: OpenStreetMap Overpass, Insecam, EarthCam, ipinfo.io, ADS-B(adsb.fi / OpenSky), CelesTrak TLE, SatNOGS, KiwiSDR.

.env.example

다른 사람들이 형식을 알 수 있도록 저장소에 .env.example로 저장하세요:

# ── Signal OPS 환경 ──
# 모든 키는 선택 사항입니다. 해당 소스를 비활성화하려면 비워두세요.

# WiFi / Bluetooth / 셀룰러
WIGLE_API_NAME=
WIGLE_API_TOKEN=
OPENCELLID_API_KEY=

# 인터넷 노출 스캐너
SHODAN_API_KEY=
CENSYS_API_ID=
CENSYS_API_SECRET=
ZOOMEYE_API_KEY=
FOFA_EMAIL=
FOFA_API_KEY=
HUNTERHOW_API_KEY=
NETLAS_API_KEY=
LEAKIX_API_KEY=
CRIMINALIP_API_KEY=
BINARYEDGE_API_KEY=

# 카메라 및 IP 평판
WINDY_API_KEY=
ABUSEIPDB_API_KEY=

# 항공기 및 햄 라디오
ADSB_API_KEY=
APRS_FI_KEY=

# AI 분석
GEMINI_API_KEY=
GEMINI_MODEL=gemini-2.0-flash

# 앱 구성
DATA_DIR=./data
FLASK_SECRET_KEY=

API 개요

노출된 엔드포인트 중 일부(전체 목록은 소스 참조):

참고 사항 및 제한 사항

• 일부 공급자(예: ZoomEye, CriminalIP)는 특정 ISP의 TLS 간섭 영향을 받을 수 있으며 기본적으로 일부 스캔 목록에서 비활성화되어 있습니다 — VPN/프록시 뒤에서 다시 활성화하려면 소스의 인라인 주석을 참조하세요.
• 공급자 간 속도 제한은 크게 다르며 무료 티어는 작을 수 있습니다(예: WiGLE 셀은 하루 약 100회 쿼리). 앱은 가능한 경우 건너뛰거나 백오프하지만 각 공급자의 제한을 준수하는 것은 사용자의 책임입니다.
• 로컬 데이터셋은 선택 사항이지만 실시간 Overpass 쿼리보다 카메라/경찰서 조회 속도를 크게 향상시킵니다.