스마트홈 기기를 직접 감사하는 단 하나의 명령: 기기가 어디로 통신하는지, 평문 vs TLS, 열린 포트, A-F 등급, 그리고 로컬 HTML/PDF 보고서. CLI + MCP 서버, 클라우드 불필요.
이 도구가 유용하다면 제 다른 프로젝트인 SkinToScan 팩을 구매하여 저를 후원할 수 있습니다. 일회성 구매이며 제 오픈소스 작업에 직접적인 자금이 됩니다.
iotaudit은 카메라, 플러그, 급식기, 전구, 도어벨 등 자신의 스마트홈 기기에 대해 명확한 답을 원하는 모든 사람을 위한 도구입니다. 기기가 네트워크에서 하는 일을 관찰하고 각 기기에 A-F 등급, 한 줄짜리 안전 판정, 한 페이지짜리 HTML 보고서를 제공합니다. 모든 것이 로컬에서 실행됩니다: 계정도, 텔레메트리도, 클라우드도 없습니다.
저는 가정용 Wi-Fi에 연결되는 저렴한 기기들을 위해 이 도구를 작성했습니다. 질문은 보통 비슷합니다: 어떤 대상과 통신하는가, 그 트래픽은 암호화되어 있는가, 예상치 못한 포트가 열려 있는가, 그리고 지난번 이후로 무엇이 바뀌었는가.
pipx install iotaudit
트래픽 캡처에는 root 권한이 필요합니다(sudo). 선택적 포트 스캔에는 nmap이 필요합니다. PDF 내보내기와 MCP 서버는 추가 기능입니다: pip install "iotaudit[pdf]" 및 pip install "iotaudit[mcp]". macOS sudo의 PATH에 iotaudit를 추가하는 방법을 포함한 자세한 설치 참고 사항은 사용 가이드에 있습니다.
국가 조회에는 번들로 제공되는 DB-IP Lite 데이터베이스를 사용하며, iotaudit geoip update를 실행하면 더 최신의 월간 파일이 설치됩니다.
하나의 명령으로 이 네트워크가 본인의 네트워크인지 확인하고, 장치를 찾고, 안전한 검사를 실행하고, 수동으로 캡처하고, 보고서를 작성합니다:
sudo iotaudit auto
파일은 HTML 및 JSON(그리고 해당 추가 기능이 설치된 경우 PDF)으로 ~/iotaudit/YYYY-MM-DD/에 저장됩니다. Wireshark, 라우터, OpenWrt tcpdump 또는 PCAPdroid에서 이미 캡처한 데이터가 있다면 root 권한 없이 분석할 수 있습니다:
iotaudit analyze capture.pcap
OpenWrt 라우터에서의 단계별 캡처(SSH를 통한 tcpdump, 그다음 iotaudit analyze)는 OpenWrt 가이드에 있습니다.
이것이 자신의 네트워크임을 이미 알고 있다면 --i-own-this-network로 입력 확인을 건너뛸 수 있습니다. 한 기기의 트래픽을 이 컴퓨터를 통해 끌어오려면 ARP 또는 핫스팟 모드를 사용하세요. 캡처 모드를 참조하세요.
iotaudit profile export로 저장된 감사를 공유 가능한 프로필 초안으로 변환합니다(기기 프로필 참조).iotaudit diff(및 --compare)로 마지막 감사 이후 변경된 사항을 확인합니다.--summary-json는 stdout에 간결한 등급 요약을 출력하고, --fail-under B는 최악의 등급이 B보다 나쁠 때 종료 코드 1로 종료합니다.--redact.--ha-mqtt, 디스커버리를 사용하여 YAML 없이 센서 표시) JSON 파일로 전송할 수 있습니다(--ha-json). Home Assistant 가이드를 참조하세요.현재 릴리스는 0.1.25입니다. 샘플 보고서와 짧은 데모는 보고서 페이지에 있습니다. 전체 취약점 피드는 여전히 로드맵에 있습니다.
pip install "iotaudit[mcp]"
iotaudit-mcp
이것은 로컬 MCP 서버(stdio)를 시작하여, 사용자 머신의 클라이언트가 동일한 감사 도구를 실행할 수 있게 합니다. diff_results은 iotaudit diff이 하는 것과 같은 방식으로 저장된 두 개의 JSON 감사 결과를 비교합니다. 이 서버는 mcpservers.org와 공식 MCP Registry에 등록되어 있습니다. 도구 목록과 옵션: MCP server.
iotaudit은 자신의 네트워크와 자신의 기기만 감사합니다. 비사설(non-private) 대상은 거부하며, --i-own-this-network 또는 대화형 I OWN THIS NETWORK 확인을 요구합니다. 소유하지 않은 네트워크에서의 ARP 또는 NDP 스푸핑은 불법일 수 있습니다. 모든 데이터는 로컬에 유지됩니다. 텔레메트리는 없습니다.
발견 사항은 관찰된 트래픽에 기반한 지표이며, 어떤 벤더의 위법 행위에 대한 증거가 아닙니다. IP 지리 위치는 DB-IP를 사용합니다. MIT 라이선스.
auto, PDF, diff, cron, 내보내기, credcheck, UPnP, 웹 UI