§1
Linux용 RoamSwitch는 macOS RoamSwitch의 제로 트러스트 네트워크 방어 모델을 Linux(systemd + nftables 환경)에 제공하는 상주 네트워크 보안 및 시스템 진단 애플리케이션입니다.
이 에디션은 클라이언트 단말(워크스테이션·노트북·싱글 보드 컴퓨터)용이며, 네트워크 이동을 따라 프로필을 자율적으로 전환하는 것을 전제로 합니다. 서버/헤드리스 기반용 강화판은 별도의 전용 에디션인 RoamSwitch Server Edition으로 제공합니다. 강화판은 기본 거부를 바탕으로, 공개하는 서비스 포트만 명시적으로 허용해 인바운드를 최소화하고 아웃바운드 통신도 제한합니다. 네트워크 이동에는 자율적으로 따르지 않으며, 정적인 서명된 정책과 원격 관리·감사로 운용합니다.
게이트웨이의 MAC으로 네트워크를 식별하고 nftables 프로필을 자동으로 전환합니다. 중간자 공격에는 VPN 터널 + 킬 스위치, 예방적 ARP/NDP 잠금, ARP 스푸핑 탐지의 3층으로 대비합니다. 그 밖에 랜섬웨어 탐지, 링크 가드, 커널 권한 상승(LPE) 대책(CVE-2026-53362 완화. 기본은 꺼짐), eBPF 센서 연동에 의한 동결(SIGSTOP)과 Air-Gap 격리, 31개 항목의 진단, MCP 서버 등을 갖추고 있습니다.
이 문서는 설계와, “완전 로컬 처리. 기본으로 머신 밖으로 나가는 것은 서명된 검출 데이터의 요청뿐이며, 사용자 정보는 일절 포함하지 않는다”는 원칙을 어떻게 보증하는지 설명합니다. 옵트인 기능(이벤트 전송 등)은 예외이며, 아래 표와 §9.4에 나열합니다. 독점 프리웨어이며, 소스는 공개하지 않습니다(§11).
| 원리 | 세부정보 |
|---|---|
| 원격측정 제로 | 이 제품은 기본값에서 사용자·단말에 관한 정보를 외부로 일절 전송하지 않습니다. 텔레메트리, 분석, 크래시 리포트, 사용 통계, 원격 설정, 라이선스 인증 서버 중 어느 것도 존재하지 않습니다. 운영자가 명시적으로 켜는 옵트인 기능은 다음 행 “기본값의 예외”와 9.4에 나열한 것뿐입니다. |
| 기본값의 예외(모두 옵트인) | 운영자가 명시적으로 켰을 때만, 다음 기능이 운영자가 설정한 대상으로 통신합니다(내장된 대상은 없습니다). (1) 이벤트 전달(forward_enabled, 기본값 OFF): syslog, JSON Lines 파일, 서명된 Webhook으로 보냅니다. (2) Fleet(Business 등급, 단말 쪽 코드만): 등록되지 않은 단말은 아무것도 보내지 않으며 이름 확인도 하지 않습니다. 관리 서비스는 배포되지 않았고 출시되지 않았습니다. 모두 9.4에 나열합니다. |
| 수신 전용 업데이트 | 기본 외부 통신은 하루 1회 lafine.net/updates/v1의 서명된 매니페스트와 그 서명을 GET하는 것뿐입니다(ClamAV의 freshclam 통신은 §9.4). 매니페스트에서는 사기 사이트 목록, 최신 버전, 커널·OS·언어 패키지의 CVE 맵 등을 가져옵니다. 커널과 패키지의 CVE 맵은 약 7일마다(KEV에 새로 올라왔을 때는 기다리지 않음), 그 밖의 목록은 버전이 새로울 때만 가져옵니다. 쿼리 문자열과 쿠키는 없고, 헤더는 고정된 User-Agent: RoamSwitch-Updater뿐이며, 사용자나 단말의 정보는 일절 포함하지 않습니다. updates.enabled = false로 완전히 멈추며, 내장 데이터로 동작합니다. |
| 완전한 로컬 처리 | 모든 평가, 탐지 및 감사는 로컬 시스템에서 완료될 때까지 실행됩니다. URL 안전 분석 및 비밀 스캐닝은 입력 내용을 어디에도 전송하지 않고 경험적으로 평가합니다. |
| 최소 권한 | 특권 작업은 root 데몬만 수행하고, UI·CLI·MCP는 Unix 도메인 소켓으로 요청합니다. 데몬은 기본으로 TCP/UDP 소켓을 열지 않습니다(옵트인 기능 제외. §9.4). 상태를 바꾸는 요청은 root나 로컬에 로그인한 UID만 보낼 수 있습니다. /etc/roamswitch/admin-only(root 소유이고 다른 사용자가 쓸 수 없을 때만 유효, 기본은 꺼짐)를 만들면, 머신 전체의 변경을 root나 sudo·wheel·roamswitch 그룹으로 제한합니다. |
| 실패로 종료 | Air-Gap(긴급 격리)은 데몬을 다시 시작해도 유지되며 해당 규칙이 외부에서 삭제되면 몇 초 내에 다시 확인됩니다. |
| 오프라인 라이선스 | Pro/Business 라이선스는 Ed25519 서명 확인만으로 확인됩니다. 활성화 서버에 대한 호출이 발생하지 않습니다. |
§2
Linux용 RoamSwitch는 주로 신뢰할 수 없는 네트워크 간에 로밍하는 노트북/모바일 워크스테이션을 대상으로 합니다.
범위 내의 공격자
- 같은 LAN 상의 공격자: 공용 Wi-Fi에서의 포트 스캔, ARP/NDP 스푸핑(불법 RA 포함)을 통한 중간자 공격, 불법 DHCP, MAC 플러딩 이후의 수동 도청, 실수로
0.0.0.0에 바인드된 개발 서버·로컬 LLM API에 대한 무단 접근. - 악성 USB 장치(BadUSB): 키보드로 위장해 화면이 잠기기 전에 키 입력을 주입하는 물리 공격. 승인되지 않은 USB 대용량 저장 장치를 통한 데이터 반출과 악성코드 반입.
- 랜섬웨어/파일리스 악성코드: 다운로드한 파일을 통해 침입하여 문서를 일괄 암호화합니다.
- DNS를 통한 C2 통신·피싱: 악성코드가 이름 해석을 통해 C2 서버나 피싱 사이트에 도달합니다.
범위 외
- 이미 루트를 보유하고 있는 공격자 커널 또는 펌웨어 수준 루트킷.
- 디스크를 물리적으로 제거하는 공격(전체 디스크 암호화 도메인, RoamSwitch는 암호화가 있는지 여부를 진단하지만 암호화하지는 않음)
- AirDrop 스타일 근접 무선 공유 제어(Linux에는 OS 기본 메커니즘이 없으며 지원되지 않음)
§3
Rust로 구현했으며, 패키지에는 9개의 실행 파일(roamswitch-daemon·roamswitch-app·roamswitch-mcp 등)이 들어 있습니다. 데몬과의 통신은 모두 /run/roamswitch/roamswitch.sock(Unix 도메인 소켓)을 통합니다. 데몬, 앱, MCP 중 어느 것도 TCP/UDP 수신 소켓을 가지지 않습니다. 앱이 bind하는 것은 중복 실행을 막는 Unix 소켓 하나뿐입니다.
# 사용자 공간(비특권)
roamswitch-app / roamswitch (CLI) / roamswitch-mcp
│ AF_UNIX /run/roamswitch/roamswitch.sock (로컬 IPC 전용)
▼
roamswitch-daemon root / systemd Type=notify + WatchdogSec=30
·nftables 제어 / VPN + 킬 스위치 / ARP/NDP 잠금
·링크 가드 / fanotify 가드 / 카나리아 / 격리 Vault
·eBPF 연동 → SIGSTOP 동결 & Air-Gap
·USB 감시(BadUSB) / Ed25519 라이선스 검증
roamswitch-updater HTTP/TLS를 가진 유일한 크레이트(일일 서명된 매니페스트 GET)
roamswitch-honeytokens / roamswitch-incident-capture 데몬의 보조 프로세스
roamswitch-core / roamswitchkit 로직 라이브러리 / MCP 클라이언트 SDK
| 구성 요소 | 특권 | 역할 |
|---|---|---|
| roamswitch-데몬 | 루트(시스템, Type=notify + WatchdogSec=30) | 모든 권한 있는 작업. 단일 작성자로서 nftables, DNS 및 systemd 장치를 제어합니다. |
| roamswitch 앱 | 로그인 사용자 | GTK3 GUI + AppIndicator 트레이. 구성 편집 및 시각화만 가능합니다. 모든 권한 있는 작업은 IPC를 거칩니다. |
| 로밍스위치(CLI) | 로그인 사용자 | 동일한 IPC 소켓을 사용하는 얇은 쉘 프런트 엔드. |
| 로암스위치-mcp | AI 클라이언트에 의해 생성된 프로세스 | stdio JSON-RPC. 진단 정보를 제공하며 설정은 바꾸지 않습니다. |
통신은 /run/roamswitch/roamswitch.sock(디렉터리 0755, 소켓 0666)을 통하며, SO_PEERCRED의 UID로 시스템 계정(UID 1~999와 nobody)을 거부합니다. 데몬은 각 사용자의 ~/.config/roamswitch/config.json 중 본인 소유이고 링크가 아니며 다른 사용자가 쓸 수 없는 것만 읽습니다. 설정은 기기 밖으로 나가지 않으며, 계정 등록도 클라우드 동기화도 없습니다.
§4
sentinel 루프(3초 주기)가 기본 게이트웨이의 MAC 주소를 /proc/net/arp와 ip neigh에서 가져와 config.json에 등록된 MAC과 대조합니다. SSID는 쉽게 위조할 수 있으므로 SSID가 아니라 MAC을 사용합니다. 프로필 전환 시의 데스크톱 알림에는 전환 이유(“미등록 네트워크이기 때문” / “등록된 네트워크 ‘…’의 설정” / “네트워크에 연결되어 있지 않기 때문”)가 포함됩니다.
| 프로필 | 상황 | nftables 동작 |
|---|---|---|
| 열기(신뢰할 수 있음) | 등록된 집 또는 회사 네트워크 | policy accept. 로컬 트래픽이 허용됩니다. |
| 균형 | 등록되지 않았지만 비교적 안전한 것으로 구성됨 | 수신은 기본 거부. 확립된 연결·lo·ICMP/ICMPv6만 허용. 공개 포트 노출을 감시. |
| 봉쇄(외출 보호) | 공용 Wi-Fi / 미등록 네트워크 | 모든 인바운드 패킷을 스텔스 차단합니다. 공유 서비스는 자동으로 중지되고 신뢰 네트워크로 돌아오면 복원됩니다(기본적으로 켜짐, 언제든 끌 수 있음). |
모든 규칙은 inet roamswitch라는 전용 nftables 테이블에 격리되어 있어 다른 방화벽 설정(ufw / firewalld 등)과 충돌하지 않습니다. 수동 오버라이드의 기한(1시간 / 2시간 / 4시간 / 오늘 하루 / 해제할 때까지 / 다음 연결 끊김까지)은 데몬이 유일한 기록자로서 강제합니다. GUI는 만료 처리를 전혀 기록하지 않고, 데몬이 다시 쓴 config.json을 다음 틱에 다시 읽어 UI에 반영할 뿐입니다(경합 회피).
Air-Gap(긴급 네트워크 격리)
inet roamswitch 테이블의 입력 및 출력 후크 모두에 policy drop(우선순위 -100)을 설정하고 lo만 허용하는 전체 격리 모드입니다.
- 페일 클로즈드: 데몬을 재시작할 때 마커 파일(
/run/roamswitch/airgap.active)을 발견하면 차단을 다시 적용합니다. - 자기 복구: 외부 프로세스가
nft delete table로 규칙을 지워도 sentinel 루프가 몇 초 안에 다시 적용합니다. - 저확신 트리거는 짧은 타이머로 해제합니다. 경고 없는 수동 Air-Gap(
roamswitch airgap등)은airgap_low_confidence_secs(기본 600초) 후에 완전히 복구됩니다. ARP 이상 같은 저확신 탐지는 클라이언트에서 Air-Gap을 발동하지 않고 알림이나 포트 차단에서 그칩니다. - 확신도가 높은 트리거는 조용히 복구하지 않습니다. 카나리아 변조, eBPF의 Emergency/Alert(Critical은 봉쇄에 실패했을 때), lockdown 중 게이트웨이의 ARP 스푸핑, ARP 경고에서 누른 Air-Gap, 랜섬웨어의 엔트로피 버스트, 옵트인했을 때 실행 레코더의 높은 중요도 규칙(§5)이 대상입니다. 시간으로는 해제하지 않고, 짧은 타이머 이후에는 매번 원인을 다시 확인하며, 원인이 사라진 것을 확인했을 때만 알림과 함께 해제합니다. 판정할 수 없는 경우도 「미해소」입니다.
- DEGRADED(축퇴) 모드: 확신도가 높은 격리가 상한(
airgap_hard_cap_secs, 기본값 3600초,0= 상한 없음)에 이르러도 해제도 원인 소멸 확인도 없으면 DEGRADED로 넘어갑니다. 차단은 FULL과 같고, 시간이 지났다는 이유만으로는 절대 자동으로 열리지 않습니다. 해제는 사용자의 조작(roamswitch emergency-restore등)이나 원인 소멸을 다시 확인했을 때뿐입니다. Wi-Fi의 rfkill은airgap_degraded_lift_rfkill이 true가 아닌 한 계속 막아 둡니다. - 전환의 기록과 알림: FULL에서 DEGRADED로의 이동, 각종 자동 해제, 사용자에 의한 해제는 모두 인시던트 타임라인에 기록되고 데스크톱 알림이 나옵니다. 격리 상태는
/run/roamswitch/airgap_isolation.json에 저장되어 데몬을 재시작해도 이어집니다(재시작하면 ARP 재확인의 연속 횟수가 처음부터 다시 시작되며, 해제에 불리한, 즉 fail-closed 쪽으로 기웁니다). - 해제 확인 화면의 안내: 격리 해제 화면에 사고 후 첫 1시간에 할 일을 적은 페이지의 링크와 QR 코드를 표시해, 다른 회선의 스마트폰으로 읽을 수 있게 합니다. QR의 내용은 공개된 고정 주소뿐이며 호스트명도 쿼리 문자열도 넣지 않고, 그릴 때도 통신하지 않습니다. 링크는 사용자가 눌렀을 때만 열리며, RoamSwitch가 스스로 접속하는 일은 없습니다.
table inet roamswitch {
chain input {
type filter hook input priority -100; policy <accept|drop>;
iif "lo" accept
ct state established,related accept
# open은 policy accept로 규칙 없음. balanced / lockdown은 policy drop(ICMP·ICMPv6 허용은 balanced만)
}
chain output {
type filter hook output priority -100; policy <accept|drop>;
# Air-Gap(격리) 중에는 같은 테이블을 다시 만든다. input / output 모두 policy drop, 허용은 lo뿐(확립된 연결도 통과시키지 않음)
}
}
패시브 링크 가드(피싱 연결 감지)
데몬이 외부로 나가는 연결의 대상을 감시하여 위험한 호스트로의 연결을 경고합니다(좁은 의미의 “명백한 피싱”에 해당하면 차단합니다). 사용자의 조작이 필요했던 기존의 “URL을 붙여넣어 진단하는” 기능을 대체합니다.
- 가로채기:
inet roamswitch_linkguard의output훅이 DNS 질의와 새 웹 연결을 NFQUEUE(AF_NETLINK)로 워커에 넘깁니다. 소켓을 bind하지도 패킷을 송출하지도 않습니다.bypass덕분에 워커가 멈춰도 통신은 통과합니다. - 호스트명을 얻는 곳: DNS 질의 이름, TLS ClientHello의 SNI(DoH를 쓰는 브라우저에서도 호스트명은 파악할 수 있음), 평문 HTTP의
Host헤더. ECH(Encrypted ClientHello)가 보급되면 해당 호스트는 사각지대가 됩니다(알려진 한계). - 판정(
roamswitch-core의 순수 로직): 호스트를 로컬 피싱/위협 피드와 오프라인 휴리스틱(보호 대상 브랜드의 IDN/혼동 호모글리프, 비공식 도메인에 포함된 브랜드명, IP 직접 입력, 고위험 TLD)에 비추어 봅니다.
모드(linkGuard.mode) | 피드 히트 또는 브랜드 동형이의어 | 기타 의심스러운 신호 |
|---|---|---|
off | 검사받지 않음 | 검사받지 않음 |
warn | 연결은 최대 8개까지 유지 + 허용/차단 승인 프롬프트 | 알림만 표시 (차단하지 않음) |
block(기본값) | 연결이 끊어졌습니다 + 허용 대화 상자(호스트당 한 번) | 알림만 표시 (차단하지 않음) |
hard-block은 피드 적중과 브랜드 호모글리프뿐입니다. 휴리스틱만으로 적중한 경우는 알림만 보냅니다(같은 이름은 6시간에 1회, 전체로는 1시간에 6건까지). warn은 연결을 최대 8초 보류하며, 응답이 없으면 fail-closed(drop, 판정은 캐시하지 않음)입니다. block에서도 알림은 호스트당 1회입니다. “허용”하면 linkGuard.allowlist에 영구적으로 들어갑니다.
DNS는 검사하지만 위조하지 않습니다: 차단 목록의 DNS 질의는 알림만 보내고, 차단은 이후의 TCP 연결에서 합니다. 피드(사기 도메인 목록)는 동봉되어 있으며, 일일 업데이터(§11)가 Ed25519 서명과 SHA-256을 검증한 뒤 갱신합니다. 피드가 없어도 “휴리스틱만”으로 동작하며, “모두 허용”이 되지는 않습니다.
진단용 외부 서버(OAST)로의 통신은 알림으로만 알립니다. 대상은 interact.sh, oast.pro, burpcollaborator.net 등과 그 서브도메인입니다(레이블 경계로 대조하므로 toast.pro는 대상이 아닙니다). SSRF·XXE·RCE 진단 도구는 성공을 확인하기 위해 피해 측에서 이들에 접속하게 합니다. DNS 질의도 연결도 대상이며, warn이든 block이든 차단하거나 보류하지 않습니다. 같은 호스트의 알림은 1회이며, 접속한 프로세스는 표시하지 않습니다. webhook.site와 ngrok은 대상이 아닙니다.
VPN 터널 + 킬 스위치(기본 MITM 방어)
L2의 무결성에 의존하지 않는 중간자 공격 대책입니다. 신뢰할 수 없는 네트워크에서는 신뢰할 수 있는 엔드포인트로의 암호화 터널을 항상 유지합니다. 이로써 로컬의 ARP/NDP 스푸핑·불법 DHCP·수동 도청은 모두 무의미해지고, 공격자에게 보이는 것은 암호문뿐입니다. 아래의 ARP/NDP 고정과 탐지는 이 기능의 보조라는 위치입니다.
백엔드는 둘 중에서 고를 수 있습니다. “WireGuard(설정 파일)” 또는 “Tailscale(Exit Node)”입니다. RoamSwitch 자체는 암호 처리를 구현하지 않으며 VPN 사업자가 되지도 않습니다. 둘 다 선택적 의존성이며, 설치되어 있지 않으면 GUI가 설치 방법을 안내합니다.
(A) WireGuard 백엔드
- VPN 서버는 제공하지 않습니다: 사용자가 준비한 WireGuard 설정을 사용합니다. Mullvad·IVPN·Proton VPN 같은 WireGuard 지원 프로바이더의
.conf, 또는 직접 운영하는 WireGuard 서버(VPS·자택 서버)를 상정합니다. 동봉된 기본 설정은 없습니다. - 설정:
.conf를 검증하고/etc/wireguard/roamswitch.conf(0600, IF 이름roamswitch)에 저장합니다. Ubuntu 24.04+ / Debian 13의wg-quickAppArmor 프로필이/etc/wireguard/외의 경로를 거부하기 때문입니다.AllowedIPs가0.0.0.0/0(::/0)이 아니면 경고합니다. - 킬 스위치:
inet roamswitch_vpn(policy drop)이 루프백, 터널 IF(roamswitch), 고정한 엔드포인트 IP로의 UDP, DHCP, ICMP 외에는 모두 차단합니다. 터널 앞에 설치하므로 새어 나갈 틈이 없고,wg-quick up이 실패해도 유지합니다.
(B) Tailscale 백엔드
- 이미 Tailscale을 사용하는 사용자용입니다. RoamSwitch는
tailscale up, 로그인,tailscaled설치를 하지 않습니다.tailscale status --json을 읽고tailscale set --exit-node=<노드>(와 그 해제)를 실행할 뿐입니다. - Exit Node 필수: 중간자 공격 대책은 “모든 통신을 경유시키는 Exit Node”를 지정해야 비로소 성립합니다. 지정이 없으면 보호를 활성화하지 않고 “보호되지 않음”이라고 경고합니다. 선택한 노드가 오프라인이 되면 보호를 자동으로 해제하고 알립니다(죽은 노드로 모든 통신을 보내는 블랙홀을 피하기 위해서입니다).
- 킬 스위치(
inet roamswitch_ts,policy drop)는 WireGuard보다 느슨합니다. DERP와 NAT 통과로 피어의 주소가 움직이기 때문입니다. 허용하는 것은 루프백,tailscale0,100.64.0.0/10과fd7a:115c:a1e0::/48, STUN(udp/3478), DERP(tcp/443),udp/41641, DHCP, ICMP, MagicDNS(100.100.100.100:53), 확립된 연결입니다. 그 외에는 모두 차단합니다. - 알려진 한계: (1) 허용 범위가 WireGuard보다 넓습니다(
udp/3478·tcp/443·CGNAT /10). (2) 경로상에서는 이용 사실과 타이밍이 보이고 차단도 당하지만, 내용은 읽을 수 없습니다. (3) 직접 연결 UDP가 차단되면 DERP의 TLS에 의존합니다. (4) MagicDNS가 꺼져 있고 로컬 리졸버를 쓰면 DNS를 조회할 수 없습니다. (5) 캡티브 포털에는 먼저 로그인합니다.
공통. vpn_on_untrusted_enabled이고 lockdown일 때만 동작합니다(기본 OFF). Tailscale은 lockdown이 아닐 때 Exit Node를 해제합니다(tailscale down은 하지 않습니다). 통신 대상은 사용자 자신의 VPN/tailnet이며 lafine과는 무관합니다(§9).
예방적 ARP/NDP 잠금
신뢰할 수 없는 네트워크에 연결하는 시점에 공격자가 사칭하려 하는 동일 링크상의 인프라 장비의 MAC 주소를 커널의 neigh 테이블에 PERMANENT(정적) 엔트리로 고정합니다. 고정 후에는 커널이 위조된 ARP 응답/이웃 광고를 무시하므로 공격자는 poisoning을 성립시킬 수 없습니다.
- 고정 대상: (1) IPv4 기본 게이트웨이, (2) IPv6 기본 라우터(대부분
fe80::링크 로컬), (3) 동일 링크상의 DNS 리졸버(공개 리졸버는 게이트웨이를 경유하므로 대상 외). IPv6는ip -6 neigh replace ... nud permanent로 NDP 엔트리를 고정합니다. - 신뢰할 수 있는 네트워크에서는 고정하지 않습니다. 자택 라우터를 재부팅했을 때 통신이 안 되는 것을 막기 위해서입니다. 네트워크를 전환할 때마다 다시 고정합니다(TOFU). 정당한 페일오버는 다음 재연결 때 따라갑니다. 고정 엔트리는
/var/lib/roamswitch/arp_lock.json에 기록되며 확실하게 해제됩니다. - 기본적으로 켜짐(Community Edition 정책, macOS Pro 빌드와 동일한 분류). 토글:
gateway_arp_lock_enabled.
ARP 스푸핑 탐지(알림 우선)
/proc/net/arp로 중복 MAC과 게이트웨이 MAC의 급변을 탐지합니다. lockdown 중에는 게이트웨이가 관련되면 전면 차단(Air-Gap)합니다. balanced/신뢰할 수 있는 네트워크에서는 알림만 보냅니다. 가짜 ARP 하나로 오프라인이 되는 DoS와, 라우터 재부팅 시의 오작동을 막기 위해서입니다. 설정은 arp_spoof_guard_enabled입니다.
Air-Gap 해제 전 확인(ARP 재확인)
ARP 스푸핑이 원인인 Air-Gap은 게이트웨이의 MAC이 발동 시점의 신뢰 MAC과 계속 일치할 때만 해제합니다. 이웃 테이블(ip -j neigh show)을 읽고, 같은 MAC을 사칭하는 다른 호스트도 없는 상태가 연속 arp_recheck_consecutive회(기본값 3), 그리고 arp_recheck_min_secs초 이상(기본값 60) 이어지면 해소로 봅니다.
항목이 없고 링크가 올라와 있을 때는 ARP who-has를 한 번(20초 이상 간격) 보냅니다(arp_recheck_active_probe, 기본값 true). 불일치, 누락, 읽기 실패 등은 모두 「미해소」(fail-closed)로 보고 횟수를 되돌립니다. 진짜 게이트웨이의 MAC을 복제하는 공격은 MAC 비교로는 탐지할 수 없습니다.
ARP 스푸핑으로 자동 Air-Gap을 발동하는 것은 게이트웨이의 MAC이 바뀌었을 때와, 게이트웨이의 IP가 다른 IP와 MAC을 공유할 때뿐입니다. 다른 호스트의 변화나, 한 대가 여러 IP에 같은 MAC으로 응답하는 경우(가상 머신, NAS 등)는 알림만 하며, 해제 판정도 같은 규칙입니다. 1.10.7 수정 때(2026-09-26)의 실제 LAN 시험에서는 위조 ARP로 약 1초 만에 발동했고, 공격을 멈춘 약 11분 뒤(기본 10분과 확인 60초)에 자동으로 해제했습니다.
포트 이상 감시
외부 LAN에 새로 공개된 수신 대기 포트(백도어, 0.0.0.0의 개발 서버 등)를 격리합니다. 판정은 기준선 상대이며, 활성화 후에 새로 나타난 공개 실행 파일만 다루고(snap은 snap:<name>) 시스템 데몬은 제외합니다. inet roamswitch_dev_guard는 lo 이외에서 오는 연결을 차단하므로 본인은 사용할 수 있습니다. 확인 대화상자에서 영구 허용할 수 있습니다. 기본값 ON(port_anomaly_guard_enabled)입니다.
Bluetooth 가드(신뢰할 수 없는 네트워크에서 "검색 가능"을 끔)
보호 수준이 open이 아니게 되면 Bluetooth의 「검색 가능」을 끕니다(bluetooth_guard_enabled, 기본값 true). 전원은 끄지 않으며 연결 중인 기기도 끊지 않습니다. roamswitch bluetooth-audit는 BlueZ 설정이 페어링되지 않은 기기의 키보드 연결을 허용하는지 읽기 전용으로 점검합니다. MCP의 get_bluetooth_guard_status는 가드와 컨트롤러의 상태를 반환합니다.
DNS 터널링/데이터 유출 탐지
수동 링크 가드의 DNS 경로에서 항상 동작합니다. 레이블 길이가 40바이트를 넘고 엔트로피가 3.8을 넘거나 qtype이 TXT/NULL인 질의를 세어, 최근 60초 안에 10건에 도달하면 알립니다. 같은 apex domain의 재알림은 300초 간격을 두고, 계속되면 600·1200초, 최대 1800초로 늘어납니다. 보는 것은 DNS(53번 포트)뿐이며 알림 전용입니다. clamav.net의 TXT는 세지 않습니다. NFQUEUE 규칙에는 bypass가 있어, 탐지가 멈춰도 이름 해석은 멈추지 않습니다.
알려진 한계. 하이픈으로 구분된 긴 호스트 이름(예: prod-us-east-1-web-server-node-0042)과, 목적지를 구분하지 않는 TXT/NULL 집계가 오탐을 일으켰습니다. 둘 다 2026-09-23에 대응을 마쳤습니다. entropy 허용 목록과 apex domain별 카운터로 해결했습니다. apex domain은 끝의 2개 레이블로 근사한 것이며, Public Suffix List의 엄밀한 구현은 아닙니다.
허용 목록에는 CDN·클라우드·PaaS 접미사 16개(cloudfront.net·amazonaws.com·vercel.app 등)가 기본으로 들어 있습니다. 운영자는 LinkGuardCfg.dns_tunnel_entropy_allowlist에 내부 도메인을 추가할 수 있습니다. 면제되는 것은 레이블 길이와 엔트로피 판정뿐이며, TXT/NULL 판정은 면제되지 않습니다(clamav.net의 TXT는 별도로 제외).
Docker 위험 감지 & 방화벽 우회 방지
Docker의 공개 포트(-p)는 방화벽을 우회하므로, DOCKER-USER에서 허가 없는 외부 통신을 상시 차단합니다. --privileged나 /var/run/docker.sock 마운트는 docker events로 탐지하며, 알림만 보냅니다.
적용 범위 — 이 DOCKER-USER 체인 검사는 iptables(IPv4), IPv6, Docker의 네이티브 nftables 백엔드를 지원하며 60초마다 다시 확인하고 스스로 복구합니다(데스크톱 에디션에서도 1.10.4부터 동일하며, 이전 버전은 iptables(IPv4) 백엔드만 대상이었습니다).
기밀 정보・API 키 유출 스캐너
API 키(OpenAI·AWS·GitHub 등)와 SSH 개인 키를 엔트로피와 패턴으로 탐지합니다. roamswitch audit-secrets <text|파일|디렉터리>는 디렉터리도 재귀적으로 조사합니다(.git 등, 2MB 초과, 바이너리는 제외). MCP의 audit_secrets와 SDK roamswitch-linux-kit에서도 호출할 수 있습니다. 내용은 외부로 보내지 않습니다.
SSH 무차별 대입의 탐지와 차단(sshd가 동작 중일 때만)
클라이언트 버전의 데몬도 서버 버전과 같은 엔진을 실행합니다(ssh_guard_enabled, 기본값 true). sshd가 실행 중일 때만 동작하며, 1분마다 수신 대기 여부를 확인하고 3회 연속으로 없으면 멈춥니다. sshd가 없는 단말에서는 로그를 읽지 않고 nftables에도 손대지 않습니다.
설정은 서버 버전과 같은 키와 기본값입니다. 실패가 임계값(기본 600초에 6회)에 도달한 접속 원본은 새 연결도 기존 SSH 연결도 끊습니다(인증이 끝난 세션은 제외). 알림은 데스크톱 알림이며 Air-Gap은 시작하지 않습니다. fail2ban이나 CrowdSec이 보호 중일 때는 탐지와 알림만 합니다. 해제는 sudo roamswitch unban <IP>입니다.
최초 실행 설정 마법사 및 확인 UI
패키지가 /etc/xdg/autostart/roamswitch.desktop을 포함해 제공하며, 설치 후 다음 로그인에서 설정 마법사가 자동으로 시작됩니다(완료 후에는 트레이에만 상주). 보안 가드를 켜거나 끌 때는 macOS 버전과 같은 대상(포트 이상, ARP 자동 차단, USB 저장 장치, BadUSB 키보드, Bluetooth)에 대해 확인 대화상자를 표시합니다. 이벤트 발생 시의 판단(알 수 없는 USB 키보드, 미등록 USB 메모리, 알 수 없는 포트의 자동 차단, 긴급 차단)은 모달 대화상자에 표시합니다.
§5
섀넌 엔트로피 버스트 감지 · YARA 스캐닝
쓰기를 PID별로 추적해, 한 프로세스가 5초 안에 엔트로피 7.92 이상의 서로 다른 파일을 20개 이상 만들면 SIGSTOP으로 동결하고 Air-Gap과 증거 수집도 수행합니다. 최근 50건은 /var/lib/roamswitch/entropy_incidents.json에 남으며(쓰는 것은 데몬뿐이고 명령줄은 저장하지 않습니다), MCP의 get_ransomware_entropy_guard_status로 읽을 수 있습니다.
2026-09-26에 실기(Ubuntu 24.04, 커널 7.0)에서 40개 파일을 다시 쓰는 재현 프로그램을 시험했습니다. 전체 암호화는 20개 파일을 넘어서 탐지했고 31번째 파일에서 동결했습니다. 이름을 python3나 git으로 바꿔도 탐지했으며, cp -r·rsync -a·tar -x는 오탐하지 않습니다.
32바이트 중 16바이트를 부분 암호화하는 방식(LockBit 계열)은 모의 파일의 94%를 탐지했고, 일반 파일 19,997개에서 오탐은 2건(0.01%)이었습니다. 전속력으로 쓰면 동결 전에 40개를 다 씁니다(0.2초씩이면 20번째에서 정지). 앞부분만 또는 Base64로 암호화한 것은 기록만 하고 동결하지 않으며, python3 등으로 쓴 것은 이름으로 구별할 수 없습니다.
- YARA 스캔과 엔트로피 탐지의 분리. YARA는 쓰인 파일의 앞 256 KB를 확장자로 제외하지 않고 검사합니다. 제외하는 것은
scan_exclusions, 격리 Vault,/proc등의 위치, 시스템 프로세스가 쓰는 것입니다. 엔트로피 판정에서는 압축 형식, 앞부분이 정상적인 압축·미디어 형식인 파일(1.10.25 이후), 패키지 관리자 캐시 작업을 제외해 오탐에 따른 SIGSTOP 동결을 막습니다.
RoamSwitch 자체의 데이터 파일(/var/lib/roamswitch·/run/roamswitch)은 탐지 내용을 인용해 쓰므로 YARA에서 제외합니다. 그곳에 있는 실행 파일과 스크립트는 검사합니다. - 동일한 파일의 반복 덮어쓰기(예:
shred의 3회 패스)는 하나의 이벤트로 계산됩니다. - 중요 프로세스 보호.
systemd나sshd같은 보호 대상과 이름이 일치하고 실행 파일이/usr등 시스템 영역에 있는 프로세스는, 머신 전체의 멈춤을 막기 위해 결코 동결하지 않습니다. 이름을 흉내 낸/tmp나/home의 프로그램은 보호되지 않습니다.
웹 애플리케이션 계층 탐지 규칙(웹셸·삽입 코드)
PHP·JavaScript·JSP·ASP 웹 셸, 주입된 난독화 코드, 이미지로 위장한 PHP, .htaccess를 통한 실행 탈취를 ELF나 shell용과는 별도의 전용 규칙으로 검출합니다. 규칙의 언어는 리터럴, 상한이 있는 간격을 두고 이어지는 어구의 열, 2가지 통계값(극단적으로 긴 한 줄, 거대한 Base64)뿐입니다. 정규 표현식을 쓰지 않으므로, 악의적인 규칙 파일이라도 일어날 수 있는 것은 오검출까지입니다. 규칙은 20개이며, 공개된 수법(unescape를 통한 주입 등)만 기술하고, 실제 검체에서 얻은 서명이나 악성코드 이름이 붙은 서명은 포함하지 않습니다. PHP 세션 파일(sess_)도 대상이며, roamswitch web-scan을 폴더 없이 실행하면 저장 위치 바로 아래를 읽습니다.
규칙은 3개 층입니다. 동봉된 것, 일일 업데이터(11.3)가 서명을 검증하고 두는 것, /etc/roamswitch/rules.d/*.json의 자체 규칙(root 소유이며 그룹·다른 사람이 쓸 수 없는 것만). 심각도는 critical·high·medium·low이고, 승인과 격리의 대상은 critical과 high이며 medium 이하는 보고만 합니다. 자동 격리는 기본적으로 critical만(/etc/roamswitch/web_rules.conf의 quarantine)이며, 클라이언트판은 종전대로 승인 대화상자에서 사용자가 정합니다. tests/·fixtures/·.git/ 아래는 기본적으로 대상에서 제외됩니다. 자체 규칙의 오류는 읽어 들일 때 알려 주며, roamswitch web-rules validate <파일>로 미리 확인할 수 있습니다.
검출 후에는 /etc/roamswitch/hooks/post-detection의 실행 파일에 검출 내용(JSON)을 표준 입력으로 전달합니다(root 소유이고 안전한 것만, 셸을 거치지 않고 최소한의 환경 변수로 실행하며, 30초 후에 중단). 계정 대처(기본 꺼짐)는 격리한 파일 소유자의 로그인 셸을 비활성화합니다. root, UID가 account_min_uid(기본 1000) 미만인 계정, 로그인 중인 사용자, 데몬 자신에게는 아무것도 하지 않으며, roamswitch web-rules unlock-account로 되돌릴 수 있습니다. 오검출은 WordPress 본체 2,409개, phpMyAdmin 3,356개, npm 의존성 14,743개 파일에서 0건이었습니다. 한계로, 읽는 것은 앞부분 256 KB(쓰기·실행 시)와 4 MB(스캔)뿐이며, 'ev'.'al' 같은 분할은 따라가지 못하고, 알려진 악성코드의 개별 서명은 동봉하지 않습니다.
카나리아(미끼 파일)
미끼 파일은 사용자의 문서, 데스크톱, 다운로드, 사진 폴더 및 전용 디렉터리에 배치되며 3초 주기로 SHA-256 기준과 비교됩니다. 이름 바꾸기, 삭제, 잘림 또는 콘텐츠 변경은 즉시 Air-Gap을 트리거합니다. 데몬은 루트로 실행되기 때문에 /home/*을 열거하고 모든 실제 사용자 디렉터리에 카나리아를 배포합니다.
증거 보전 번들(포렌식 자동 수집)
엔트로피 버스트 탐지나 eBPF Critical 이벤트로 프로세스 단위 격리(SIGSTOP + 네트워크 차단)가 성립했을 때만, roamswitch-incident-capture가 <상태 디렉터리>/incident-evidence/<타임스탬프>-<짧은 ID>/에 증거를 저장합니다.
내용은 tshark로 30초간 수집한 패킷과, PID가 있으면 /proc/<pid> 스냅샷입니다(environ에서 기밀로 보이는 값은 [REDACTED]이며, 파일 내용은 가져오지 않습니다). 쓰기를 한 프로세스가 판정 전에 종료되었다면 패킷만 저장합니다. 호스트 전체가 Air-Gap으로 전환된 경우와 Emergency/Alert 이벤트에서는 수집하지 않습니다.
수집 결과는 manifest.json에 모으고, 번들 안 모든 파일의 SHA-256 해시를 기록합니다(사후 변조 탐지를 위해서입니다). 번들은 자동으로 삭제되지 않습니다. roamswitch-incident-capture prune(기본 보존 기간 30일)을 명시적으로 실행했을 때만 오래된 번들이 삭제됩니다.
증거 번들을 저장한 검지는 타임라인에서 이어집니다. roamswitch timeline은 저장 행을 검지 아래에 └─로 표시하고, 번들 이름과 manifest의 SHA-256을 붙입니다. --json과 MCP의 get_incident_timeline에는 evidence_refs(최대 8건. 이름과 SHA-256만 있고 내용은 포함하지 않습니다) 등이 붙습니다. 계기가 된 ID를 알 때만 연결하며, 시각이 가깝다는 이유로 묶지 않습니다. 수동 snapshot에는 --trigger-event-id ID로 전달할 수 있습니다.
수집된 증거는 수집 시점에는 검증되지 않습니다. 이후 변조 여부를 확인하려면 roamswitch-incident-capture verify <번들 디렉터리> [--json]를 실행하십시오. 번들 내 현재 파일을 다시 해시하여 manifest.json에 기록된 값과 대조하고, 변경됨·누락·미기록(매니페스트에 없는 파일이 혼입됨) 중 하나로 각각 보고합니다.
알려진 한계. manifest.json의 SHA-256을 추가 전용 기록 체인(evidence_anchor.log)과 시스템 로그(태그 roamswitch-evidence)에 대조하므로, manifest.json이나 기록을 고쳐 쓰면 verify가 실패합니다. root 공격자가 둘 다 고쳐 쓰면 막을 수 없으므로 로그 전송을 권장합니다. 서명은 없으며, 오래된 번들은 "기록 없음"입니다.
랜섬웨어 피해 파일 복구(스냅샷)
btrfs 서브볼륨과 LVM 논리 볼륨의 스냅샷을 만들고, 필요한 파일만 현재 파일을 덮어쓰지 않고 다른 위치로 꺼냅니다(roamswitch-ransomware-rollback. 상주 서비스 roamswitch-ransomware-rollback-watch.service는 최초 설치 때 활성화됩니다). ext4처럼 스냅샷을 만들 수 없는 파일 시스템에서는 만들 수 없다는 안내만 표시하고 아무것도 하지 않습니다.
기본적으로 6시간마다 사전 스냅샷을 만듭니다(btrfs는 4세대, LVM은 2세대). 대량 덮어쓰기나 카나리아 변조를 탐지했을 때도 만들며, 내장된 작은 모델이 「암호화처럼 보이는 정도」를 0~1로 조언합니다(동작은 바꾸지 않습니다). 탐지 후에는 손상되지 않은 세대를 지키기 위해 정기 생성을 7일간 멈추고, restore는 탐지 시점의 스냅샷을 --accept-tampered 없이는 거부합니다.
「랜섬웨어 복구」 탭에서는 목록에서 스냅샷을 고르고(권장은 ★, 탐지 시점의 것은 경고 표시) 파일이나 폴더를 RoamSwitch-Recovered/<ID>/로 꺼냅니다. 전체를 되돌리는 restore는 명령으로만 가능하며, 화면에서는 생성이나 간격 변경도 할 수 없습니다. 꺼낼 수 있는 것은 사용자가 소유자인 경로뿐입니다.
허니토큰(자격 증명 미끼)
시작할 때 인포스틸러 도구가 훑는 경로(~/.aws/credentials·~/.ssh/id_rsa·~/.docker/config.json·~/.pypirc·~/.env.backup)에 ROAMSWITCH_HONEYTOKEN을 포함한 가짜 인증 정보를 둡니다. 실제 파일이 있으면 덮어쓰지 않습니다. 읽히면 미끼를 추가로 둡니다. RoamSwitch 자체의 docker는 빈 DOCKER_CONFIG로 동작하므로 미끼에 반응하지 않습니다.
감시 프로세스가 알림 전용 fanotify(FAN_OPEN/FAN_ACCESS)로 미끼의 읽기를 지켜봅니다(쓸 수 없으면 inotify). 접근은 정찰(MITRE ATT&CK T1552)로서 심각도 Critical로 타임라인에 기록합니다(팝업은 띄우지 않습니다). RoamSwitch 자신과, SSH 미끼에 대한 OpenSSH 클라이언트(ssh, scp 등)는 기록하지 않습니다. 기록 전용이며 동결이나 차단은 하지 않습니다. MCP의 get_honeytoken_status로 상태와 최근 50건의 접근을 읽을 수 있습니다(읽기 전용).
알려진 한계: ~/.ssh/id_rsa 미끼는 개인 키로서는 유효하지 않은 형식입니다. 많은 스캐너가 -----BEGIN ... PRIVATE KEY----- 헤더만으로 판정하므로 영향은 작다고 봅니다. inotify로 전환했을 때만 fuser를 사용하므로 금방 끝나는 프로세스를 특정하지 못할 수 있지만, 탐지는 수행합니다.
fanotify 모니터링 · 격리 보관소 · ClamAV
- 데몬은
/home·/tmp·/var/tmp·/dev/shm을 파일 시스템 단위로 감시하고(1.10.18 이후), 쓰기 완료는/전체에서 받습니다. 1.10.4 이후 허가 이벤트는 실행 시에만 해당하며open은 알림입니다(fanotify_open_perm으로 되돌릴 수 있습니다). 깨끗한 실행 파일은 60초간 캐시하고, 데몬의 자식 프로세스는 제외합니다. - notify-first·확인 전 격리 없음(fanotify 가드). fanotify 가드는 YARA/ClamAV 적중만으로는 확인 없는 격리나
FAN_DENY를 하지 않습니다. 탐지하면 확인을 요청하고, 확인될 때까지 Vault에 넣지 않습니다.FAN_DENY는pre_exec_blocking_enabled가 활성일 때의 실제 실행에만 적용되며, 승인이 시간 초과되면 통과시킵니다.
다운로드 감시(기본~/Downloads와~/Desktop)는 별도 경로로, 탐지한 파일(EICAR 제외)을 확인 없이 Vault로 옮기고 알립니다. - EICAR 등의 테스트 서명은 알림 이력에 기록만 합니다. 업계 표준 테스트 문자열은 "무해"로 취급해, 알림은 띄우지 않고 알림 이력에 기록만 하며 격리도 차단도 하지 않습니다(fanotify 가드와 다운로드 가드 모두에서).
- 사용자 설정
scan_exclusions(하위를 포함한 절대 경로. 예전clamav_exclusions를 통합)은 YARA와 ClamAV 모두 존중합니다. 승인 대화상자의 "허용"과 격리 탭의 "복원"은 모두 이 목록에 추가되므로, 같은 파일이 다시 걸리는 일은 없습니다. - 탐지한 실제 악성코드(fanotify 가드에서는 사용자가 확인한 것)는 root 전용
/var/lib/roamswitch/quarantine/로 옮깁니다. Vault는 root 소유의0700이고, 샘플은0400(읽기 전용, 실행 불가)입니다. 사용자는 IPC를 통해 자신이 격리한 항목만 목록 조회, 복원, 삭제할 수 있습니다. 복원은 사용자 권한으로0644로 기록하며, 기존 파일은 덮어쓰지 않습니다. - 허용 이벤트 루프는 설정 파일을 읽지 않습니다. 설정 읽기는 전용 백그라운드 스레드가
Mutex<GuardConfig>스냅샷에 대해 수행하며, 설정에 대한 핫 패스 처리는 락과 복사뿐입니다(실행하려는 파일의 앞부분을 읽어 판정하는 처리는 별개입니다).FAN_OPEN_EXEC_PERM을 지연시켜 머신이 멈추는 일을 막기 위한 설계상의 불변 조건입니다. - ClamAV가 있는 경우(
clamav_enabled, 기본값은 활성) 다운로드 감시 폴더의 새 파일을 YARA에 이어 로컬 DB로 스캔합니다. Windows용 실행 파일과 위험한 AI 모델(.pkl등)은 알리고, Linux 배포 형식은 기록만 합니다. ClamAV는 선택적 의존성이며, 없어도 다른 방어는 동작합니다. 있으면 일일 업데이터(§11)가freshclam으로 DB를 갱신합니다.
프로세스 실행 레코더(로컬 전용)
netlink 프로세스 커넥터로 exec와 uid 변화를 기록하는, 로컬 전용 기능입니다. 경로, 인자(최대 64개, 1개당 512자, 합계 4096자), 부모 계보, SHA-256 등을 남깁니다. 기본으로 켜져 있고, 메모리가 1 GiB 미만이면 기본으로 꺼집니다. CPU는 1코어의 3% 이내, nice 10으로 동작합니다. 커넥터를 열 수 없을 때는 /proc의 저빈도 스캔으로 축퇴하며, 수명이 짧은 프로세스는 놓칩니다.
- 보존:
/var/lib/roamswitch/exec_log에 8 MiB 단위의 JSON Lines(0600)로 저장하며, 기본적으로 200 MB / 14일을 보관합니다. 해시 체인으로 변조를 탐지할 수 있지만 방지는 할 수 없습니다(root를 빼앗기면 고쳐 쓸 수 있습니다).
검색은roamswitch events search|tree|export|verify입니다. 쓰는 중에도 10초마다 체크포인트를 끼워 넣고,roamswitch events verify가 그 이전의 편집, 삭제, 교체를 탐지합니다. 최신 체크포인트 이후(최대 약 10초분)는 검증할 수 없습니다. - 알림 전용 상관 규칙(EXR-001~012): 모두 12종이며, 각 규칙에 MITRE ATT&CK 기법 ID를 붙입니다. 웹 서비스에서의 셸 기동,
/tmp나 삭제된 파일에서의 실행, 관리 도구가 아닌 것에 의한 스냅샷 삭제(EXR-008, 1.10.11), 30초 안에 8종 이상의 공격 도구 탐색(EXR-009, 1.11.0), 스크립트 처리계에 의한 2분 안의 3종 이상 공격 도구 기동(EXR-010, 1.11.0) 등을 봅니다.
단독으로는 격리하지 않으며,exec_rules_isolation_optin(기본값 false)을 켰을 때만 높은 중요도의 규칙이 Air-Gap의 확신도 높은 트리거가 됩니다(§4). EXR-011(리버스 셸의 형태)과 EXR-012(서비스 계정에 의한 디버거 기동)는 옵트인해도 격리에 쓰지 않습니다. - Sigma 규칙 가져오기:
/etc/roamswitch/sigma.d에 둔 Sigma 규칙(process_creation의 일부)을 기록된 이벤트에 적용합니다. 일치는 알림만 하며, 중지, 격리, 자동 격리 판단에는 쓰지 않습니다. 피드는 없고, 놓아 둔 파일만 읽습니다. 지원하지 않는 작성 방식의 규칙은 이유를 붙여 거부합니다.roamswitch sigma-check로 로딩과 시험 일치를 확인할 수 있습니다. - 단말 밖으로는 보내지 않습니다: 기록의 원본 로그는 전달되지 않습니다. 이벤트 전달(§9.4)을 켠 경우에 한해, 규칙의 알림(중요도, 규칙 ID, 프로세스 이름, 요약)과 세그먼트의 봉인 해시만 운영자가 설정한 대상으로 보냅니다.
자격 증명 파일 접근 감시(기본값 ON, 알림 전용)
기본으로 켜져 있습니다(credential_access_watch_enabled). SSH 개인 키, ~/.aws/credentials, gcloud와 브라우저의 인증 정보, AI 에이전트의 로그인용 파일, Git이나 netrc의 인증 정보 등이 예상 밖의 프로그램에 열리면 알립니다. fanotify FAN_OPEN을 소수의 파일에 설정할 뿐이며, 차단, 동결, 거부는 일절 하지 않고 커널은 응답을 기다리지 않습니다.
실행 파일 이름을 허용 목록(ssh, git, 브라우저, 백업 도구 등)과 대조하고, 같은 쌍의 재알림은 10분간 억제합니다. 허용 추가는 credential_access_watch_allow로 하며 약 30초 안에 반영됩니다.
이름으로 판정하므로 허용된 이름으로 동작하는 프로그램은 알리지 않습니다. AWS와 gcloud에서는 python도 허용하므로 python 스크립트로 동작하는 탈취 프로그램도 알리지 않습니다(python -c는 알립니다). ~/.kube/config, ~/.docker/config.json, ~/.azure는 각 도구가 매번 열기 때문에 대상에서 제외합니다.
수상한 자동 시작 탐지(기본 ON·알림 전용)
새로 만들어졌거나 다시 쓰인 자동 시작 등록을 점검합니다(persistence_watch_enabled, 기본값 true). 대상은 systemd, cron, XDG autostart, 셸 시작 파일(.bashrc 등), ~/.ssh/rc, /etc/rc.local, motd, udev, apt 훅, modprobe, git 훅 등이며, 패키지 유닛(/usr/lib/systemd)은 제외합니다.
5초마다 작은 파일을 읽기만 하고, 처음 한 번은 기록만 합니다. 알리는 것은 리버스 셸, 복호화 또는 다운로드 후 즉시 실행, /tmp 등에서의 프로그램 실행처럼 악성코드로 보이는 경우뿐입니다. 셸 시작 파일처럼 소유자가 자주 편집하는 파일은 새로 추가된 줄만 봅니다.
비교는 SHA-256으로 하고(1 MiB까지), 타임라인에는 ATT&CK 기법이 붙습니다. 탐지만 하며 쓰기를 막지는 않습니다.
리버스 셸 탐지(기본값 ON, 알림만)
Server Edition과 같은 리버스 셸 탐지를 클라이언트 버전에서도 실행합니다(reverse_shell_watch_enabled, 기본값 true). 2초마다 /proc을 읽어, 표준 입출력이 바깥으로 나가는 TCP 연결 하나(또는 연결된 UDP)인 셸 인터프리터를 찾습니다. 대기 중인 포트의 연결과 루프백은 제외하고, 사설 주소의 상대는 reverse_shell_watch_include_private가 true일 때만 봅니다. socat 같은 중계나, 대화형 셸이 파이프 또는 pty로 연결된 형태(약한 경고)도 찾아냅니다.
연속 2회 발견된 것을 프로세스마다 한 번 알립니다. 알림만 하며 격리도 중지도 하지 않습니다. 제외는 reverse_shell_watch_allow에 적습니다. cat을 끼운 중계, 스캔 사이에 끝나는 연결, 이름이 셸이 아닌 프로세스는 찾지 못합니다.
네트워크 설정 변화 감시(기본값 ON, 알림만)
가짜 DHCP 응답이나 심어 둔 프록시 자동 설정(PAC / WPAD)으로 생긴 변화를 알립니다(netconf_watch_enabled, 기본값 true). 1분마다 DHCP 리스 파일을 읽고(NetworkManager 자체 DHCP는 nmcli에 읽기 전용으로 질의), 네트워크별로 DHCP 서버, 게이트웨이, DNS를 기억합니다. 같은 네트워크에 새 주소가 나타나면 한 번 알리고, 새 네트워크의 첫 리스는 알리지 않습니다. Firefox, KDE, NetworkManager 설정 등에 새 PAC나 WPAD가 나타날 때도 알립니다.
기준값은 /var/lib/roamswitch/netconf_baseline.json에 저장하며, 처음에는 기록만 합니다. 예상된 값은 netconf_watch_trusted에 적을 수 있습니다. DHCP 알림은 ATT&CK T1557.003에 연결됩니다. 아무것도 변경하지 않고 아무것도 보내지 않으며, 파일을 읽기만 합니다. 수락되지 않은 가짜 오퍼, DHCPv6, 라우터 광고는 보이지 않으며, 네트워크상의 가짜 오퍼는 별도 제품인 Sensor가 감시합니다.
ClickFix 클립보드 탐지
가짜 광고나 CAPTCHA 페이지가 명령을 붙여 넣게 하여 실행시키는 ClickFix 공격을 클립보드에서 탐지합니다. 데스크톱 앱이 동작하는 동안에만 작동하며 스위치는 없습니다. base64를 복호화해 셸에 넘기는 형태나 리버스 셸 규칙에 일치할 때만 알림과 대화상자를 표시합니다. 클립보드는 자동으로 지우지 않으며, 대화상자에서 비울 수 있습니다.
파일 변조 알림에 덧붙이는 침입 경로
클라이언트 버전의 변조 감시(FIM과 락 파일) 알림에, 변경한 프로세스와 그것이 속한 SSH 로그인(접속 원본·시각·인증 방식)을 덧붙입니다(fim_intrusion_context_enabled, 기본값 true, 외부로는 아무것도 보내지 않습니다). 인증 정보 파일 감시 알림에는 SSH 로그인에 속할 때만 1줄을 추가합니다. 확인하지 못한 경우에 로그인이 아니라고 적지 않습니다. 기록은 /var/lib/roamswitch/fim_intrusions.json에 남습니다.
가드가 입력을 읽지 못했을 때의 기록
로그나 표를 읽는 가드가 읽지 못한 분량을 조용히 건너뛰면, 아무 일도 없는 가드와 구별할 수 없습니다. 그래서 각 가드는 확실히 잃은 것만 세어(읽지 못한 횟수, 버린 줄, 마지막으로 놓친 시각 등) /run/roamswitch/collectors.json과 MCP의 get_guard_status 등에 내보냅니다.
입력을 읽지 못하는 가드는 활성이어도 off, 최근 24시간에 놓친 것이 있으면 partial입니다. 2분 이상 읽지 못하면 알리며, 같은 종류는 24시간에 한 번까지입니다. 셀 수 없는 손실은 사실과 시각만 기록하고 수는 추측하지 않습니다.
커널 로컬 권한 확대(LPE) 선점 및 강화
공격자나 맬웨어가 권한이 없는 사용자의 기반을 확보하면 심층 방어 기능을 통해 Linux 커널 취약점을 악용하여 루트 권한을 얻는 것을 방지합니다.
- 비특권 User Namespace 처리(Frag Gap CVE-2026-53362 대책). 커널 권한 상승 공격 중 상당수는 비특권 사용자가 만드는 사용자 네임스페이스를 발판으로 삼습니다. 진단은
user.max_user_namespaces와kernel.unprivileged_userns_clone의 상태를 표시합니다. 비활성화하면 브라우저나 Flatpak 등이 동작하지 않을 수 있어 Client 버전은 권장하지 않으며, 원클릭 강화에도 포함하지 않습니다.
신뢰할 수 없는 네트워크에 있는 동안만 제한하는 동작은guard.yaml에서 명시적으로 활성화했을 때만 작동합니다(기본값은 비활성). Server Edition은 기본으로 영구 적용합니다. 비활성화는 일부 경로만 막는 임시 조치이며, 근본 대책은 수정된 커널로 업데이트하고 재부팅하는 것입니다. - Yama LSM에 의한 메모리 보호.
kernel.yama.ptrace_scope = 1(또는2)을 적용하여, 일반 프로세스가 다른 프로세스에ptrace로 연결하거나/proc/$pid/mem을 통해 메모리 공간(브라우저 세션이나 SSH/GPG 개인 키)을 읽는 것을 거부합니다. - 코어 덤프 억제.
fs.suid_dumpable = 0으로, 충돌한 프로세스의 메모리 이미지가 디스크에 평문으로 덤프되는 것을 막습니다. /tmp&/dev/shm의noexec마운트 방어. 임시 디렉터리에 페이로드를 두고 실행하는 것을 막기 위해, 외출 중(신뢰할 수 없는 네트워크)에는noexec,nosuid,nodev로 마운트합니다.
eBPF 런타임 위협 센서 및 자율 프로세스 동결(데스크톱 eBPF 가드)
RoamSwitch 클라이언트 데몬은 커널 공간에서 동작하는 Modern eBPF 센서(Falco / Tetragon / BTF)와 연계하는 구조를 기본으로 갖추고 있습니다.
# eBPF 런타임 위협 탐지와 자율 요격 흐름
[악성 프로세스] → [커널 (eBPF)] → 링 버퍼 (2MB)
→ [Falco] → UNIX 소켓 (/var/run/roamswitch/events.sock)
→ [roamswitch-daemon (root)]
├─► ① kill(pid, SIGSTOP) [상태: Ts]
├─► ② 차단: Critical은 해당 사용자만, Emergency / Alert는 Air-Gap
└─► ③ GTK3 모달 & libnotify 알림
- UNIX 도메인 소켓 직접 연계(
/var/run/roamswitch/events.sock). Falco 등 eBPF 센서의 경보를 디스크 로그를 거치지 않고 메모리상의 UNIX 소켓으로 직접 받습니다. 디스크 I/O는 발생하지 않으며, 전달은 밀리초 단위입니다. - 밀리초 단위 자율 대응(프로세스 동결 및 네트워크 차단).
Critical(커널 LPE, 랜섬웨어 암호화 등) 이벤트에서는 해당 PID에SIGSTOP을 보내 멈추고, 그 프로세스의 실제 사용자(컨테이너라면 cgroup)의 통신만 차단한 뒤 알립니다. PID를 알 수 없거나 동결이나 격리를 할 수 없는 경우, 그리고Emergency/Alert에서는policy drop(Air-Gap)을 전개하고, PID를 알면SIGSTOP도 보냅니다.Critical미만은 차단하지 않고 기록합니다. - 데스크톱용 저부하 & 로그 비대화 방지 튜닝(RoamSwitch Optimized) 노트북과 워크스테이션의 배터리 소모·CPU 부하·디스크 고갈을 억제하기 위해, Falco를 도입하는 환경을 위한 최적화 프로필(
99-roamswitch-optimized.yaml)과 logrotate 설정을 마련해 두었습니다. Client 버전의 패키지는 Falco를 도입하지 않으며 이 프로필도 배치하지 않습니다(Server Edition의 패키지가 배치합니다). Client에서 Falco를 사용하는 경우에는 사용자가 Falco를 직접 도입하고, 필요하면 이 프로필을 직접 배치합니다. 주요 설정은 다음과 같습니다.- 중요도 필터링(
priority: warning). 일상 작업의 노이즈를 95% 줄입니다. - 커널 사전 폐기(
drop_failed_exit: true). 실패한 시스템 콜을 커널 드라이버 단계에서 폐기하여 CPU 부하를 절반으로 줄입니다. - 메모리 절약형 링 버퍼(
cpus_for_each_buffer: 2). 버퍼 크기를 2MB로 줄여 상주 메모리를 30~50MB, CPU 부하를 1% 미만으로 억제합니다. - 로그 상한 강제 로테이션(
/etc/logrotate.d/roamswitch-falco). 50MB 상한, 7세대 압축 보관.
- 중요도 필터링(
- 스탠드얼론 강화 vs eBPF 확장의 하이브리드 내성. Falco가 없어도 커널 sysctl(Yama의 ptrace 제한, 코어 덤프 억제, 네트워크 보호. 프로파일을 전환할 때마다 적용), nftables 프로파일, fanotify, 카나리아 감시로 자율적으로 방어합니다. Falco를 도입하면 실시간 eBPF 이벤트에 의한 제로데이 요격과 프로세스 동결이 더해집니다.
§6
USB 이벤트를 감시하여 키보드(HID) 클래스 장치와 USB 대용량 저장 장치를 추적합니다. 기본값은 OFF입니다(macOS판의 USBKeyboardGuard / USBStorageGuard와 같이 isEnabled = false로 출하). 최초 설정 마법사와 USB 탭에서 옵트인할 수 있으며, 활성화할 때 확인 대화상자를 표시합니다.
악성 USB 키보드(키스트로크 주입)
- 커널 계층에서 포트를 물리적으로 차단하지 않습니다(중요). 이전 구현(≤1.0.6)은 미등록 키보드를 USB째로 끊었고, 일체형 수신기에서는 마우스까지 끊겨 조작할 수 없게 되었습니다. 현재는 HID 장치에 대한
authorized=0쓰기를 거부하고, 시작할 때 이미 끊긴 HID 장치를 다시 인가하여 스스로 복구합니다. - 키 입력은 소프트웨어에서 삭제됩니다. 등록되지 않은 키보드를 감지하면 해당 장치의
/dev/input/eventN에서 독점적인 evdevEVIOCGRAB이 사용됩니다(VID:PID와 일치하는/proc/bus/input/devices에kbd처리기가 있는 노드만 해당). 마우스 노드는 그대로 유지됩니다. 이는 macOSCGEventTap에 해당하는 Linux입니다. 장치에 전원이 계속 공급됩니다. - 안전 장치. 그랩은 "입력할 수 있는 다른 키보드가 있는" 경우(내장 키보드, 또는 승인되어 연결 중인 USB 키보드)에만 겁니다. 새 키보드 하나뿐인 머신은 잠그지 않습니다.
- 승인 대화상자. 그랩과 동시에
/run/roamswitch/approvals.json에 승인 요청을 쌓고, GUI가 모달(허용/거부)을 표시합니다. 허용하면 화이트리스트에 등록하고 그랩을 해제합니다. 승인되지 않은 채 3분이 지나도 기본값으로는 키보드를 해제하지 않습니다(1.10.4 이후. 그 이전 버전은 3분 뒤 페일 오픈이었습니다.usb_keyboard_timeout_release를 활성화하면 이전 동작으로 되돌릴 수 있습니다).
악성 USB 대용량 저장 장치
미등록 USB 대용량 저장 장치(HID를 갖지 않는 것)가 삽입되고 가드가 활성일 때, authorized=0으로 보류하고(HID가 없으므로 안전) 승인 대화상자를 표시합니다. 신뢰 네트워크인지는 묻지 않습니다. 마운트되었거나 스왑으로 사용 중인 드라이브(사용 중인 외장 디스크, 라이브 USB 등)는 뽑은 것과 다를 바 없어 망가질 수 있으므로 보류하지 않고 로그에만 남깁니다. 허용하면 다시 인가하여 화이트리스트에 등록하고, 거부하면 보류를 계속합니다. macOS판은 1.7.4에서 이 "읽기 전용으로 보류 + 승인 프롬프트" 방식으로 통일했습니다.
식별 및 기득권 부여
HID 판정은 bInterfaceClass == "03"과 /proc/bus/input/devices로 합니다. 기존 키보드를 허용 목록에 등록하는 grandfathering은 데몬이 아니라 GUI가 합니다. 최초 설정 마법사에서 활성화했을 때 등에 연결 중인 키보드를 등록하며, USB 탭에서 나중에 활성화할 때는 등록하지 않습니다. 데몬 시작 시 이미 연결된 미등록 키보드는 교체되었을 가능성이 있으므로 미등록으로 취급합니다.
§7
LinuxHealthChecker가 31개 항목을 평가하여 0~100점의 점수, 등급(100점이 S, 85~99점이 A, 70~84점이 B, 그 미만이 C), 개선 조언을 제공합니다. GTK, CLI(roamswitch status), MCP 어느 쪽에서든 31개 항목 모두가 사용자의 언어로 표시됩니다(10개 언어 지원).
| 카테고리 | 예시 항목 |
|---|---|
| 디스크 / 부팅 | LUKS / dm-crypt 암호화, UEFI 보안 부팅 |
| 접근 통제 | LSM(AppArmor/SELinux), SSH/sudo 구성 감사 |
| 커널 강화 | sysctl 강화, 비특권 User Namespace 상태 확인(Frag Gap 대응. Client 버전에서는 비활성화를 권장하지 않음), Yama의 ptrace 제한, 코어 덤프 제어, /tmp 및 /dev/shm의 noexec |
| 업데이트 | 자동 보안 업데이트 구성 |
| 네트워크 | ARP 스푸핑 모니터링, 게이트웨이 ARP/NDP 잠금 상태, 노출된 포트 감사, Wi-Fi 암호화 강도 |
| 악성코드 | ClamAV(EICAR 실동작 탐지 테스트 포함) / fanotify(가드의 실제 가동 여부와 큐 오버플로로 인한 이벤트 누락도 확인) / 엔트로피 모니터링 / noexec / 보조 프로그램(허니토큰과 증거 수집)의 설치 확인 |
| 브라우저 | Firefox/Chrome/Chromium 세이프 브라우징 설정 |
| DNS / USB | 위협 방지 DNS, USB 버스의 제로 트러스트 상태 |
| 컨테이너 및 취약점 | Docker 소켓 마운트 노출, 특권 컨테이너(--privileged) 감사, 컨테이너 런타임 격리 수준(runc / gVisor / Kata), 실행 중인 커널의 알려진 CVE 노출, Docker 데몬 설정(daemon.json) |
| 이름 조회 응답 | /proc/net/udp와 /proc/net/udp6를 읽어, 이 호스트가 LLMNR(UDP 5355)이나 NBNS(UDP 137)에 응답하고 있지 않은지 확인합니다. 응답하고 있으면 같은 네트워크의 다른 기기가 가짜 응답으로 통신을 가로챌 수 있는 입구(LLMNR / NBT-NS 포이즈닝)가 되므로 불합격입니다. mDNS(UDP 5353)는 표시만 합니다. 명령은 실행하지 않으며 관리자 권한도 필요하지 않습니다. 네트워크 상의 가짜 응답 자체는 보이지 않습니다. |
| 백업 최신성 | restic, borg, Timeshift, snapper, rsnapshot, systemd 타이머, cron 등에서 마지막 백업 시각을 찾아 7일 이내인지 확인합니다. 복원 가능 여부는 확인하지 않습니다. 복원 테스트는 사용자 파일에 쓰기를 하므로 자동으로 실행하지 않습니다. |
| 삭제된 실행 파일 | 실행 중인 프로그램의 파일이 삭제되지 않았는지를 /tmp, /dev/shm, /home, /opt 등에서 조사합니다. 같은 위치에 새 파일이 있으면 업데이트로 간주합니다. /usr, /lib와 개발용 폴더는 대상에서 제외하며, 중요도는 /opt가 중간, 나머지는 높음입니다. 진단 시의 확인이며 상시 감시가 아닙니다. 모든 사용자의 프로세스는 sudo roamswitch status로 조사합니다. 발견된 것은 최대 3건을 표시하고, 나머지는 건수로 나타냅니다. |
모든 검사는 로컬 파일 및 명령 출력(getenforce, mokutil, resolvectl, ss, …) 읽기를 기반으로 합니다. 어떤 종류의 외부 쿼리도 없습니다.
신뢰 네트워크를 고려한 판정. 신뢰(자택) 네트워크에서는 게이트웨이 MAC 고정, /tmp·/dev/shm의 noexec화, 위협 방어 DNS를 의도적으로 보류합니다. 이들은 🔴 "미대책"이 아니라 🟢 + 설명으로 표시하며, 신뢰할 수 없는 네트워크에서 자동 적용된다고 명시합니다. 실제 상태는 데몬이 매 주기 기록하는 /run/roamswitch/state.json에서 읽고, fanotify는 가드가 실제로 가동 중인지까지 확인합니다.
항목별 강화. 자동 수정(커널 sysctl/Yama/코어 덤프, /tmp noexec, USB 제로 트러스트, 게이트웨이 ARP 고정, 위협 방지 DNS, fanotify 가드가 다운되었을 때 데몬 다시 시작)이 있는 실패한 항목에는 GTK 대시보드에 "🔧 강화" 버튼이 있습니다. 데몬은 루트로 실행되므로 데몬을 다시 시작하는 것 외에는 pkexec이 필요하지 않습니다.
NIST CSF 2.0 / CIS Controls v8 매핑
31개 항목에 NIST CSF 2.0 식별자(예: PR.DS-01, DE.CM-09)를, 확실한 항목에는 CIS Controls v8 번호(예: 3.11, 4.1)도 붙입니다. MCP(get_security_report)와 roamswitch status --json(nistCsf/cisControl)에 포함되며, GUI와 Client 버전 CLI의 일반 표시에는 나오지 않습니다(roamswitch status --server에는 나옵니다).
패키지 취약점 검출의 취급
패키지 CVE 검출은 사유와 기한을 붙여 수용할 수 있습니다. 키는 (에코시스템, 패키지, CVE ID, 설치된 버전)이며, roamswitch vuln-accept나 GTK 화면에서 수행합니다. MCP는 건수만 돌려주며 수용할 수는 없습니다. 기한이 지나면 일반 검출로 돌아가며, 인시던트 타임라인과 알림 기록에 한 번 남깁니다. CVE 맵에 EPSS 값(epss, epssDate)이 있는 CVE는 같은 심각도 안에서 EPSS가 높은 순으로 정렬합니다.
설치 시 실행되는 코드를 확인이 끝난 상태와 비교해, 스크립트의 추가·변경 등을 알립니다. 확인 완료로 만들 수 있는 것은 사람뿐이며(roamswitch scan-scripts --accept 등), MCP는 비교만 합니다. 기준 파일 ~/.config/roamswitch/package_install_baseline.json(0600)에는 다이제스트만 남깁니다.
pip·uv의 extra-index-url, .npmrc로 고정하지 않은 npm 레지스트리, 갓 공개된 버전을 피하는 설정의 부재도 파일에서 짚어냅니다(통신하지 않으며 환경 변수는 읽지 않습니다).
등록한 폴더는 변경 후, 시작 직후, 하루 한 번 자동으로 조사합니다(통신도 실행도 하지 않으며 기록도 고쳐 쓰지 않습니다). npm_supply_watch_enabled(기본값 활성)로 끌 수 있습니다.
§8
roamswitch-mcp는 AI 클라이언트(Claude Desktop, Cursor 등)가 실행하는 stdio MCP 서버입니다. 설정, 방어, 포트, 장치를 바꾸는 도구는 없습니다. 기록하는 것은 3개의 도구가 자신의 기록 파일을 갱신할 때뿐입니다. 외부 호스트에 연결할 수 있는 것은 기본적으로 비활성인 run_npm_audit_signatures뿐입니다. 진단 평가는 LAN에 아무것도 보내지 않으며, 게이트웨이도 ARP 캐시 등 로컬 정보로 확인합니다.
MCP의 모든 도구에 주석(readOnlyHint, openWorldHint 등)이 붙습니다. readOnlyHint가 false인 것은 기록 파일을 갱신하는 3개의 도구뿐입니다. openWorldHint가 true인 것은 기본적으로 비활성인 run_npm_audit_signatures뿐입니다. 스캔 이력의 각 행에는 프로브가 상대에게 남기는 것(sideEffects)이 붙습니다. 스캔 지적에는 확인된 것인지 버전 일치만인지를 나타내는 evidenceKind가 붙습니다.
| 도구 | 목적 |
|---|---|
| get_security_report | 31개 항목 평가, 점수, 권장사항 |
| verify_security_findings | get_security_report의 항목을 현재 상태로 다시 평가하여 stillPresent, resolved, inconclusive 중 하나와 이유를 반환합니다. 수정이 효과가 있었는지 확인하는 용도입니다. 측정할 수 없는 항목은 안전으로 보지 않고 inconclusive로 처리합니다. checkIds를 생략하면 전체 항목이 대상입니다(Mac 50건, Linux 64건까지). Mac의 일부 항목은 앱 내 설정값에 따라 결정됩니다. 읽기 전용이며 복구도 설정 변경도 하지 않습니다. 결과에는 verificationStatus와 rationale이 포함되고, 아직 해당되는 경우 counterEvidence와 severityChangesIf가 붙습니다. |
| audit_mcp_configs | AI 클라이언트의 MCP 설정 파일(Claude Desktop, Cursor 등과 등록 폴더의 .mcp.json)을 읽고, 확인 없는 자동 승인, 평문 http://, 버전을 고정하지 않은 npx 등을 지적합니다. 읽기 전용이며 아무것도 전송하지 않습니다. 값이나 비밀은 반환하지 않고 서버 이름 등만 반환합니다. 분석할 수 없는 파일은 unreadableFiles에 나열됩니다. |
| audit_agent_setup | AI 에이전트의 지시 파일, 스킬, 설정(Claude Code, Codex 등)과 등록 폴더의 VS Code 작업 및 GitHub Actions를 읽고, 보이지 않는 문자로 숨긴 문장, 가져와서 그대로 실행하는 기술, 지나치게 넓은 허용 등을 지적합니다. 일치는 확인할 곳이며 악의를 단정하는 것이 아닙니다. 읽기 전용이며 아무것도 전송하지 않고, 본문이나 비밀은 반환하지 않습니다. format=sarif를 지정하면 SARIF 2.1.0을 반환합니다. |
| get_detection_coverage | 방어를 약화시키거나 흔적을 지우거나 상주하는 MITRE ATT&CK 기법마다 탐지할 수 있는지(detects / partial / none), 보이지 않는 부분(blindSpot), 가드의 상태(liveState)를 반환합니다. 아무것도 실행하지 않고 아무것도 전송하지 않습니다. none은 공격이 없었다는 뜻이 아니며, liveState도 동작의 증명이 아닙니다. format=navigator를 지정하면 ATT&CK Navigator 레이어(4.5)를 반환합니다. |
| get_exposed_ports | 외부에 공개된 포트 목록과 방화벽 차단 상태. 로컬 AI 실행 기반(Ollama, vLLM 등)은 프로세스 이름과 포트로 식별하며, aiRuntimes에 확도(confirmed/likely)를 붙입니다. 추측은 위험도를 올리지 않습니다. Linux판은 응답 헤더를 읽지 않습니다. |
| get_guard_status | 현재 보호 수준과 각 방어 모듈의 동작 상태. 입력을 읽지 못한 가드의 기록(collectors)도 반환합니다. |
| audit_url_safety | 경험적 URL 안전성 분석(대상을 가져오지 않음) |
| 감사_비밀 | 텍스트 내 API 키/비밀 감지(텍스트를 전송하지 않음). 디렉터리를 지정할 때 선택 인수 include_build_output(불리언)을 true로 하면, 재귀 스캔이 건너뛰는 dist·build 등 공개되는 프런트엔드 폴더도 읽습니다(결과에 buildOutput을 더합니다). |
| audit_security_logs | 로컬 저널/인증 로그 집계 |
| get_quarantine_status / get_canary_status | 검역과 카나리아 주 |
| get_app_help | 내장된 지식 베이스 검색 |
| run_active_vuln_scan | 127.0.0.1만을 대상으로 한 비파괴 취약점 검증입니다. 네트워크 요청을 보내는 도구이므로 기본값은 비활성입니다. Mac에서는 각 확인의 부작용(probesRun의 sideEffects. 1개 포트에 5건 초과 등)도 싣습니다. 지적은 확인한 것(confirmed)과 버전이 범위에 있을 뿐인 것(version_range_match)을 구별합니다. |
| run_package_cve_scan | 설치된 패키지(Homebrew / dpkg, dnf 등)를 로컬 CVE 맵과 대조합니다. 통신은 하지 않습니다. 목록을 가져오지 못하면 complete를 false로 합니다. Ubuntu(20.04~26.04)는 수정 버전이 있는 CVSS 7.0 이상만 대조하므로 “해당 없음”이 CVE가 없다는 뜻은 아닙니다. Mac은 심각도와 EPSS(epss) 순입니다. 사람이 수용한 검출은 건수(acceptance)를 반환하며, 수용은 MCP에서는 할 수 없습니다. |
| run_package_cve_scan_languages | npm, PyPI, crates.io 등의 의존성 락 파일을 같은 로컬 CVE 맵과 대조합니다. 통신은 일절 하지 않습니다. |
| get_vulnerability_scan_history | scan-vulns --confirm이 기록한 각 프로브에 대해, 마지막으로 실제 실행·확인된 이후 경과한 일수(pass_age_days)를 반환합니다. |
| verify_fim | 고정된 27개의 핵심 시스템 파일, 인증·cron·systemd·SSH 설정 등 19개 디렉터리 바로 아래의 모든 파일, RoamSwitch 자체 바이너리, 각 사용자의 authorized_keys를 다시 해시하여 기준선과 비교해 변조와 새 파일을 검증합니다. root로 실행하면 결과에 추가 필드 recentIntrusionContext도 포함됩니다. 최근 변경마다 변경한 프로세스(계정·실행 파일·명령)와 그 프로세스가 속한 SSH 로그인(접속 출처·로그인 시각·인증 방식), 또는 확인하지 못한 이유가 들어갑니다. |
| get_file_scan_guard_status | 파일 스캔 가드(ClamAV)의 설정과 그것이 사용하는 격리 Vault의 상태를 반환합니다. Server Edition용 도구이며, 클라이언트 버전의 멀웨어 가드 설정이 아닙니다. |
| get_port_anomaly_incidents | 포트 이상 가드의 베이스라인 취득 상황, 자동 차단 중인 포트, 최근 50건까지의 인시던트를 반환합니다. 자동 차단 중인 포트는 시각이 없는 현재 상태로, 시각이 붙은 인시던트 이력과는 별개입니다. 이 구별은 응답의 주석 필드에 적혀 있습니다. |
| get_ebpf_incidents | eBPF 런타임 가드의 현재 격리 상태와 발동 이유의 인시던트 이력을 반환합니다. Server Edition에서는 각 기록에 검지부터 대처까지의 시간(밀리초. detect_to_receive_ms, receive_to_action_ms, detect_to_action_ms)이 추가되며, Falco 하트비트 상태(heartbeat)도 반환합니다. |
| get_ssh_guard_incidents | SSH 무차별 대입 가드의 상태와 기록을 반환합니다. 금지까지 하는지 검지만 하는지, 지금 금지 중인 접속원과 남은 시간, 최근 기록(최대 200건)을 포함합니다. 시도된 사용자 이름은 Linux에서는 저장하지 않고 수만 반환하며, Mac에서는 무해화하여 최대 5건까지 반환합니다. 읽기 전용이며, 금지를 해제하는 MCP 도구는 없습니다. Linux는 Server Edition과 sshd가 동작하는 Client Edition, Mac은 Pro 버전에서 사용할 수 있습니다. |
| get_resource_guard_incidents | 자원 고갈·프로세스 이상 검지 가드(메모리 누수 / 크래시 루프)의 이력을 확도 티어와 함께 반환합니다. Server Edition의 가드이므로 클라이언트 버전에서는 결과가 항상 비어 있습니다. |
| get_notification_history | RoamSwitch가 보낸 알림(보안 로그 감사 이상, ClickFix 탐지 등)의 기록을 최근 1주일간, 최신순으로 반환합니다. |
| get_incident_timeline | 각 가드의 검지를 하나의 시계열로 모아 반환합니다(프로세스 계보·MITRE ATT&CK 태그 포함, 실험적). 다른 검지가 계기가 되어 기록된 행에만 계기가 된 행의 ID와 저장한 증거 번들의 이름이 붙습니다(Linux는 parent_event_id, root_event_id, evidence_refs, Mac은 parentEventID, rootEventID, evidenceRefs). |
| get_honeytoken_status | 인증 정보 허니토큰의 활성화 상태와 최근 접근 탐지 이벤트를 반환합니다. Linux에서는 미끼의 배치 위치, 감시 프로세스의 상태, 미끼에 대한 최근 50건의 접근(시각, 종류, 경로, 의심스러운 프로세스)도 반환합니다. 기록을 읽을 수 없으면 eventsReadable이 false가 되며, 빈 목록은 “접근 없음”을 의미하지 않습니다. 다른 사용자의 홈 경로는 root와 관리자에게만 보여 줍니다. 통신은 하지 않습니다. |
| get_ransomware_entropy_guard_status | 범용 엔트로피 기반 랜섬웨어 탐지의 활성화 상태와 최근 버스트 탐지 인시던트(Linux는 최근 50건. 시각, pid, 프로세스 이름, 영향받은 파일, 평균 엔트로피, 쓰기 프로세스를 동결했는지 여부)를 반환합니다. 저장된 파일을 읽을 수 없으면 incidentsReadable이 false가 되며, 빈 목록은 “탐지 없음”을 의미하지 않습니다. 다른 사용자의 홈 경로는 root와 관리자에게만 보여 줍니다. 통신은 하지 않습니다. |
| get_lan_sensor_overview | 같은 호스트에서 동작하는 RoamSwitch Sensor가 보고 있는 LAN의 개요(기기 수·VLAN·캡처 상태와 보이지 않는 범위·위협 건수)를 반환합니다. Sensor의 로컬 소켓에서 읽을 뿐이며, Sensor가 없으면 available: false와 이유를 반환합니다. 기기에서 온 문자열은 신뢰할 수 없는 데이터로 취급합니다. |
| get_lan_network_threats | 같은 호스트의 Sensor가 가진 LAN 위협 목록을 반환합니다(불법 DHCP·불법 IPv6 라우터, ARP·NDP 스푸핑, DNS 터널, 미도입 기기의 취약 지점 등. limit과 minSeverity로 좁힐 수 있습니다). 목록은 Sensor의 알림 이력(최근 500건, 메모리상)과 저장된 경량 감사로 만들므로 완전한 로그는 아닙니다. 보이지 않는 범위가 있을 때 위협 0건은 "아무 문제 없음"이라는 뜻이 아닙니다. |
| get_privilege_escalation_paths | 동봉된 PathScope를 고정된 인자로 실행하여, 계정이 root에 도달하는 경로(경로 수와 절차, 긴급·높음 대책 항목과 ATT&CK, 수집하지 못한 범위)를 반환합니다. 수정 명령은 반환하지 않으며 실행도 하지 않습니다. complete가 false일 때(root 없이 실행했거나 수집하지 못한 범위가 있는 경우), 경로 0개는 '안전'이 아닙니다. 다른 계정을 start에 지정할 수 있는 것은 root와 관리자뿐입니다. PathScope가 없을 때는 available: false를 반환합니다. |
| get_access_log_report | 동봉된 AccessScope를 고정된 인자로 실행하여, 웹 서버·SSH·인증 로그에 있는 공격의 요약(위험도, 탐지 목록, 마스킹된 근거 행, 읽지 못한 로그)을 반환합니다. since는 24h나 7d처럼 1~90일이며, 호출한 사용자가 읽을 수 있는 로그만 대상입니다. complete가 false일 때 탐지 0건은 '안전'이 아닙니다. 로그의 문자열은 공격자가 쓸 수 있으므로 신뢰하지 않습니다. AccessScope가 없을 때는 available: false를 반환합니다. 통신도 LLM도 사용하지 않습니다. |
실증형 취약점 진단은 "기능이 존재한다는 것"과 "실제로 최근에 확인되었다는 것"을 구분하기 위해, 확인된 각 프로브에 대해 마지막으로 실행·확인한 시각을 기록하고 거기서부터의 경과 일수(pass_age_days)를 보여 줍니다. 스케줄 실행 기능은 아직 없으므로, 이 값은 실제로 스캔을 실행한 빈도에 좌우됩니다. CLI(roamswitch vuln-status)·GUI·MCP(get_vulnerability_scan_history) 어디에서든 같은 경과 일수를 참조할 수 있어, 운영자와 감사 담당자는 "언제 마지막으로 확인되었는지"를 기능의 존재만으로 추측하지 않고 파악할 수 있습니다.
외부 사람이 바꿔 쓸 수 있는 문자열(로그, Wi-Fi 이름, 명령줄 등)을 포함하는 결과에는 "신뢰할 수 없는 외부 데이터" 주의 문구를 붙이고 길이를 잘라냅니다. AI에 대한 지시와 비슷한 표현이나 도구 호출 사칭 등 6종류가 발견되면, 별도 블록에서 종류와 건수만 경고하고 문장은 반복하지 않습니다. 보이지 않는 문자 등으로 흐트러뜨린 표현도 복원하여 검사합니다.
이것은 보조 감시이며, 진짜 방어는 설정이나 방어를 바꾸는 도구가 하나도 없다는 점입니다. Linux 버전은 비슷한 다른 문자로의 치환과 영어·일본어 이외의 언어는 탐지하지 않습니다.
Linux의 Debian에서는 패키지 CVE 지도가 Debian 릴리스를 구분하지 않습니다. Debian 12·13 기기에도 Debian 14에만 있는 수정 버전 번호가 표시될 수 있습니다(Ubuntu는 전용 지도로 바꾸어 해소했습니다).
MCP 서버 자체는 네트워크를 열지 않습니다. 데몬의 소켓에 연결하는 것은 get_sensor_audit_results뿐이며, 나머지는 roamswitch-core를 직접 호출하거나 상태 파일을 읽을 뿐입니다. 예외로, Sensor용 도구 2개는 같은 단말의 Sensor 소켓에 읽기 전용 요청을 1개 보냅니다. get_privilege_escalation_paths와 get_access_log_report는 번들된 PathScope와 AccessScope를 고정된 인수로 실행합니다(네트워크도 LLM도 사용하지 않습니다).
기본적으로 비활성인 run_active_vuln_scan은 127.0.0.1로 비파괴 프로브를 보내고, run_npm_audit_signatures는 npm을 통해 npm 레지스트리에 조회합니다(MCP 바이너리에 HTTP / TLS 스택은 없습니다). 진단 평가는 LAN에 아무것도 보내지 않습니다.
로컬 LLM 실전 훈련에서 발견된 오귀속 문제와 그 수정
2026년 9월, 이 MCP 서버로 로컬 LLM(Qwen 3.8 27B)에게 인시던트 조사를 시켰다. 모델은 get_port_anomaly_incidents의 결과를 잘못 읽고, 과거의 포트 차단을 진행 중인 인시던트에 연결했다. 시각이 없는 스냅숏과 시각이 붙은 이력을 구별 없이 반환했기 때문이다. 주석을 추가하자 같은 모델은 연결을 거부했다. 회귀 테스트와 실제 기기에서의 재실행으로 확인했다.
§9
RoamSwitch for Linux가 기본값으로 하는 외부 통신은 한 종류뿐이며, 일일 업데이터의 서명된 매니페스트 GET입니다(§11). 나머지는 모두 로컬에서 완결되며, 명시적으로 활성화한 기능의 통신은 9.4에 나열합니다. 소스는 비공개이므로 lafine이 검사하고, 결과를 9.2에, 재현 절차를 부록 C에 제시합니다.
9.1 감사방법
- 크레이트 격리 — HTTP 클라이언트/TLS 스택을 허용하는 것은 1개 크레이트뿐이며
roamswitch-updater입니다. CI의scripts/audit_no_network.sh는 다른 크레이트가 HTTP/TLS 라이브러리를 끌어들이거나 허용 범위 밖의.rs가 소켓을 사용하면 빌드를 실패시킵니다. 예외는tonic/hyper로, Tetragon과의 UNIX 도메인 소켓 gRPC용으로roamswitch-core에만 허용하며 TLS와의 병용은 금지합니다. - 의존성 트리 검사.
Cargo.lock전체에서 텔레메트리/분석/크래시 리포트 SDK(sentry,opentelemetry등)를 검색합니다. roamswitch-updater리뷰. 요청 대상은 하나뿐이고, 쿼리 문자열과 쿠키가 없으며, 소프트웨어를 나타내는 헤더는 고정된 User-Agent뿐이고, 다운로드하는 모든 것에 Ed25519 검증을 수행합니다.- 서브프로세스 호출 열거.
Command::new(...)의 모든 호출 위치를 확인합니다.
9.2 결과
| 감사항목 | 결과 |
|---|---|
| HTTP/TLS 스택 | roamswitch-updater에만 (ureq + rustls)에만 존재합니다. core / daemon / app / mcp / kit에는 없음 |
| 원격 측정/분석/충돌 보고 SDK | 존재하지 않음 어디에도 없음 |
TcpStream / TcpListener / UdpSocket | roamswitch-updater 외에는 9.4에 나열한 옵트인 기능 파일 4개에만 존재 |
| 사용 중인 소켓 API | AF_UNIX(로컬 IPC) / AF_NETLINK(nftables 등의 제어. 외부로 보내지 않음) / AF_INET은 roamswitch-updater와 9.4의 옵트인 기능에서만 사용 / AF_PACKET은 ARP 재확인(§4)에서 게이트웨이로 ARP를 1개 보낼 때만 사용(LAN 내부). VPN 터널(§4)을 활성화하면 wg-quick 또는 tailscaled가 사용자 자신의 VPN으로 송신합니다 |
| 일일 업데이터 | 약 24시간마다 GET https://lafine.net/updates/v1/manifest와 서명 manifest.sig의 2회(데이터 본체는 버전이 새로울 때만 추가로 가져옴). 쿼리 문자열 없음, 쿠키 없음, 고정된 User-Agent: RoamSwitch-Updater(소프트웨어를 나타내는 유일한 헤더), 기기별 식별자 없음. 모든 페이로드를 Ed25519로 검증. updates.enabled = false로 완전히 중지 |
| VPN 터널(§4) | 기본적으로 꺼져 있습니다. 활성화되면 wg-quick은 Lafine과 관련되지 않은 사용자 자신의 .conf에 있는 엔드포인트 에 WireGuard 터널을 구축합니다. Rust 소켓 API가 아닌 getent ahosts(glibc NSS)를 통한 엔드포인트 호스트 이름 확인 |
| 라이선스 활성화 | 오프라인 Ed25519 서명 확인. 활성화 서버와 통신하지 않음 |
RoamSwitch for Linux가 기본으로 시작하는 외부 통신은 한 종류뿐입니다. 하루 한 번, 수신 전용으로 서명된 매니페스트를 확인하고, 새 버전이 있으면 서명된 탐지 데이터를 다운로드합니다. 어느 쪽에도 사용자나 단말에 관한 정보는 전혀 포함되지 않습니다. 운영자나 사용자가 명시적으로 활성화하거나 조작하지 않는 한, 제품의 다른 부분이 외부 서버와 통신하는 일은 없습니다(9.4). 이웃 테이블 고정이나 ARP 감시를 위해 LAN 내부로 보내는 ping(9.3의 #2)은 대상이 루프백, 사설, 링크 로컬, ULA 주소로 한정되며 공인 주소로는 보내지 않습니다.
9.3 외부 대면 작업의 전체 목록
로컬 머신 밖으로 패킷이 나갈 수 있는 동작을 직접·간접을 가리지 않고 나열합니다. 아래 표는 기본으로 발생하는 것이고, 운영자나 사용자가 활성화하거나 조작한 경우에만 발생하는 것은 9.4에 나열합니다.
| # | 작동 | 목적지 | 트리거 | 전송되는 내용 |
|---|---|---|---|---|
| 1 | 일일 업데이터. GET /v1/manifest와 그 서명을 가져옵니다. 각 데이터는 버전이 새로울 때만 가져옵니다(커널, OS 패키지, 언어 CVE 맵은 주 1회 확인. Ubuntu CVE 맵이 아직 없는 Ubuntu 단말은 다음 일일 실행에서 가져옴). 다만 OS 패키지 CVE 맵은 CISA KEV에 새로 올라온 CVE를 반영하기 위해, 매니페스트에 그 맵의 새 버전이 있고 로컬 맵이 KEV 목록보다 이전에 만들어졌다면 7일을 기다리지 않고 다음 일일 확인에서 가져옵니다. | lafine.net/updates/v1(CDN) | systemd 타이머. 부팅 15분 후에 시작되며 이후 약 24시간마다(최대 3시간의 무작위 지연 있음). updates.enabled = false 또는 roamswitch-update.timer 비활성 시에는 발생하지 않음 | 일반 HTTPS GET: 쿼리 문자열 없음, 쿠키 없음, 고정된 User-Agent: RoamSwitch-Updater, 사용자 또는 시스템에 대한 정보 없음. 서명된 매니페스트 + 피드 수신 |
| 1a | freshclam(ClamAV 자체 업데이트 프로그램), ClamAV가 설치될 때 일일 업데이트 프로그램에 의해 호출됩니다. | ClamAV 프로젝트의 CDN | #1의 일부로. 그 밖에 사용자가 화면의 “바이러스 정의 지금 업데이트 (freshclam)” 버튼을 눌렀을 때도 실행 | ClamAV 자체의 트래픽(별도 프로젝트) RoamSwitch만 실행합니다. |
| 2 | ping -c 1 -w 1 -W 1 <게이트웨이 IP>(같은 종류의 ping을 IPv6 라우터와 LAN 안의 DNS 서버 앞으로도 각 1회) | LAN의 기본 게이트웨이. ARP/NDP 고정 확인에서는 IPv6 기본 라우터와 resolv.conf(systemd-resolved에서는 /run/systemd/resolve/resolv.conf)에 기재된 DNS 서버 중 루프백·사설·링크 로컬·ULA 주소인 것. 공개 리졸버(위협 방어 DNS인 Quad9 등)에는 패킷을 보내지 않음 | 게이트웨이는 ARP 감시 등에서 MAC이 필요한데 ARP 캐시·근접 테이블·15초 이내의 보관본 어디에도 없을 때만(같은 대상에는 8초에 1회까지). IPv6 라우터와 DNS 서버 앞으로는 게이트웨이 ARP 고정(gateway_arp_lock_enabled, 기본값 켜짐)이 근접 테이블로의 고정을 다시 수행할 때(신뢰 네트워크 외로 전환할 때와 설정을 전환할 때) | ICMP 에코 요청 1회만(ping의 표준 데이터 포함). DNS 확인 없음 |
| 3 | 시스템 브라우저 실행(xdg-open) | https://roamswitch.com/linux(제품 사이트), https://lafine.net/(운영자 사이트, 이용 약관, 문의), https://github.com/lafine1211/roamswitch-support(릴리스 노트와 지원) | 사용자가 '릴리스 노트 열기'와 같은 버튼을 클릭하는 경우에만 | RoamSwitch 프로세스는 소켓을 열지 않습니다. OS 브라우저에 URL을 전달합니다. |
| 4 | resolvctl dns | —(RoamSwitch 자체의 통신은 발생하지 않음) | 신뢰할 수 없는 네트워크의 위협 방지 DNS(기본적으로 켜짐, 끌 수 있음). <iface>은 기본 경로(유선 + 무선 동시, lo / tailscale* / wg* / docker* / veth* 제외)를 전달하는 모든 물리적 NIC입니다. dns_scope = always_on일 때 신뢰할 수 있는 네트워크에도 적용됩니다. 모든 감시 주기를 조정했습니다. | OS의 리졸버 설정을 변경할 뿐입니다. RoamSwitch 자체는 DNS 쿼리를 보내지 않습니다. 설정 후에는 이 NIC의 이름 확인이 선택한 위협 방어 DNS(기본값은 Quad9)로 향합니다 |
| 5 | 패키지 관리자 업데이트 | 배포판의 apt / dnf / zypper / pacman 저장소 | 사용자가 apt upgrade 등을 실행하거나 GUI의 “지금 업그레이드” 버튼(pkexec을 통해 apt-get / dnf / zypper / pacman 실행)을 눌렀을 때 | apt 계열에서는 로컬 apt-cache policy 출력을 읽고 패키지 관리자를 실행할 뿐입니다. dnf 계열에서는 업데이트 탭을 열었을 때 등에 dnf check-update를 실행하여 설정된 저장소에 조회할 수 있습니다(zypper는 zypper list-updates, pacman은 pacman -Qu). 어느 쪽이든 lafine과는 무관 |
| 6 | VPN 터널(§4) — WireGuard 백엔드: 터널 wg-quick 빌드/Tailscale 백엔드: tailscale set --exit-node은 출구 노드를 통해 모든 트래픽을 라우팅합니다. | 사용자 자신의 VPN 엔드포인트 / tailnet(WireGuard: .conf의 엔드포인트, Tailscale: 선택한 종료 노드 및 DERP 릴레이) | vpn_on_untrusted_enabled 및 네트워크를 신뢰할 수 없는 경우. 기본적으로 꺼짐 | 암호화된 WireGuard/Tailscale 트래픽; 목적지는 라피네와 무관한 사용자 본인의 VPN 서버/테일넷입니다. getent ahosts(glibc NSS)을 통한 WireGuard 엔드포인트 확인; Tailscale은 tailscaled(별도의 프로세스)에 의해 구동됩니다. |
위 외의 기능(nftables 제어, ARP/NDP 고정, 링크 가드, 포트 스캔, fanotify, USB 감시 등)은 로컬 파일 읽기와 서브프로세스 출력 분석만으로 완결됩니다. §4 VPN 터널의 대상은 사용자 자신의 VPN 서버이며, lafine 인프라로는 어떤 데이터도 흐르지 않습니다. 9.4 기능의 대상은 9.4에 기재했습니다.
9.4 옵트인 또는 사용자 조작 시에만 외부에 접촉하는 동작
9.3의 표는 기본 동작입니다. 아래는 명시적으로 활성화하거나 조작했을 때만 통신하는 부분입니다. scripts/audit_no_network.sh는 소켓 API를 event_forward.rs·webhook_guard.rs·active_vuln_scan.rs·web_vuln_scan.rs·sensor_pairing.rs 5개 파일에만 허용하며, 다른 곳에서 사용하면 빌드가 실패합니다.webhook_guard.rs는 기본값이 꺼짐인 설정을 활성화했을 때만 대상 이름을 조회하며, 연결은 하지 않습니다. TLS와 HTTP는 시스템의 openssl과 curl에 맡깁니다. 예외는 테스트의 2곳이며, 둘 다 127.0.0.1에만 연결합니다.
- 이벤트 전송(
event_forward.rs): 기본값은 꺼짐이며 내장된 대상은 없고, 운영자가 설정한 대상에게만 보냅니다. 종류는 syslog(RFC 5424 또는 CEF, UDP/TCP/TLS), JSON Lines 파일, HMAC-SHA256 서명이 붙은 Webhook이며, 비밀 값은 명령줄 인수에 싣지 않습니다. 보내는 것은 호스트명·이벤트 ID·시각·종류·심각도·규칙·조치·PID·프로세스명·요약뿐이며, 파일 내용이나 실행 기록의 원본 로그는 포함하지 않습니다. 도달하지 못한 이벤트는0600큐(기본 20 MB/72시간)에 쌓아 두었다가 다시 보냅니다. - Fleet(Business 등급·단말 측만): 등록하지 않은 단말은 아무것도 보내지 않으며, Fleet 호스트명의 이름 확인도 하지 않습니다. 등록은
roamswitch fleet enroll을 실행했을 때만 이루어지고, 관리 서비스는 미배포·미출하입니다.
단말은 등록 시에 고정한 조직의 공개 키로 검증할 수 있었던 정책만 적용하며, 서명 키는 lafine이 아니라 고객이 가집니다. 원격 명령 경로는 없습니다. 정책은 로컬의 하한을 약하게 할 수 없고, 값은 더 엄격한 쪽을 택합니다. 보내는 것은 앱 버전·OS 종류·격리 상태·정책 버전·건전성 점수(0~100)·키 세대와, 단말 ID·조직 ID뿐입니다. - Sensor 페어링(
sensor_pairing.rs): 기본값은 꺼짐입니다(sensor_pairing_enabled). 운영자가 입력한 Sensor의 주소로 직접 연결할 뿐이며, 내장된 대상은 없습니다. TLS 1.3(시스템의openssl, 인증서 지문 고정)을 지원하지만, 핀이 없는 기존 방식의 페어링은 경고와 함께 평문으로 폴백합니다. Sensor는 별도 제품이며, 이 문서의 Zero Telemetry 대상이 아닙니다. - 실증형 취약점 진단: 기본값은 비활성이며 옵트인이 필요합니다. 단말 버전은 자기 기기에서 관찰한 수신 대기 포트에 대한
127.0.0.1의 프로브로 한정됩니다. SSRF 검사는127.0.0.1에 임시 수신 대기를 만들고, 대상이 그곳으로 가져오러 오는지만 확인합니다. - GUI의 '업데이트 확인' 버튼: 눌렀을 때만, apt 계열에서는
curl로https://lafine.net/apt/dists/stable/main/<arch>/Packages를 1회 가져옵니다(타임아웃 4초, 식별자나 쿼리 문자열은 붙이지 않습니다). dnf·zypper·pacman 계열은 각 패키지 관리자에 문의합니다. - npm 서명 검증:
roamswitch audit-npm-signatures <DIR> --confirm은 설정npm_audit_signatures_enabled(기본값 false)를 활성화하고, 사용자가--confirm을 붙여 실행했을 때만 동작하며,npm자체가 registry.npmjs.org에 문의합니다.
§10
- 계정 불필요. 사용자 등록, 로그인, 이메일 주소 입력이 전혀 없습니다.
- 설정은 로컬에만 저장.
~/.config/roamswitch/config.json에 평문으로 저장되며 머신 밖으로 나가지 않습니다. 클라우드 동기화는 존재하지 않습니다. - 진단 결과는 로컬에만 보관. 보안 리포트와 로그 감사 결과는 화면 표시와 (사용자가 선택하면) 로컬 파일로 내보내기만 이루어집니다.
- 라이선스 키는 오프라인 검증. Pro / Business 라이선스 토큰은 Ed25519 서명을 포함하며 공개 키로 검증됩니다. lafine 서버에 문의하지 않습니다.
- 크래시 리포트 없음. 패닉이 발생해도 스택 트레이스를 외부로 보내지 않습니다.
- 일일 업데이터는 사용자 정보를 전혀 보내지 않습니다. 쿼리 문자열 없음, 쿠키 없음, 단말이나 설치별 식별자 없음,
User-Agent는 고정된RoamSwitch-Updater뿐입니다. 이것은 리포트가 아니라 다운로드입니다. 링크 가드의 판정 결과, 차단한 호스트, 스캔 결과는 로컬 활동 보기/journald에만 기록되며 전송되지 않습니다. - 위협 방어 DNS를 사용하는 동안 DNS 질의는 외부 리졸버에 전달됩니다. 위협 방어 DNS(§4.5. 기본값은 켜짐, 대상은 신뢰되지 않은 네트워크뿐)는 OS의 DNS 리졸버를 Quad9(
9.9.9.9. Cloudflare의1.1.1.2, AdGuard DNS의94.140.14.14, CleanBrowsing의185.228.168.9도 선택할 수 있습니다)로 향하게 합니다. 이 동안의 질의는 RoamSwitch가 아니라 OS가 해당 리졸버로 보내며, RoamSwitch 자체는 아무것도 보내지 않습니다. 중지하려면dns_enabled를false로 설정합니다. - 알림 이력은 7일 후 자동 삭제되며 길이도 제한됩니다: 보낸 알림의 이력은 로컬에 저장되고, 기록할 때마다 7일이 지난 분을 삭제합니다. 1건의 제목은 200자, 본문은 2000자까지로 잘라 냅니다(데스크톱 알림 팝업은 본문 1000자까지). 이 이력은 이벤트 전송(기본값 꺼짐)을 활성화하지 않는 한 단말 밖으로 나가지 않습니다.
- 실행 기록도 로컬에만: 프로세스 실행 레코더(§5)의 기록은 기본값에서도 단말 안(
/var/lib/roamswitch/exec_log,0600)에만 저장됩니다. 명령줄 인수를 포함하므로 보존 기간(기본 14일)과 용량(기본 200 MB)에 따라 자동으로 삭제합니다.
§11
| 에디션 | 에 대한 | 가격 | 라이센스 |
|---|---|---|---|
| 커뮤니티 에디션 | Linux 개인용·사내 업무용(대수 제한 없음) | 무료 | 독점 프리웨어(번들 EULA) |
| 비즈니스(예정) | 차량 관리, 정책 배포, 서명된 내부 아파트, 조직을 위한 SLA | 유료 | 상업용 라이센스. 동일한 바이너리 + 계층 게이트 |
Business 티어 제공을 시작하는 시점에, macOS 버전 Pro Lifetime 구매자에게는 본인의 Linux 머신에서 쓸 수 있는 Business 기능을 무상으로 부여하는 방침입니다. 현재 Business 티어는 제공하지 않으며 관리 서버도 없습니다.
유통 및 공급망
| 채널 | 세부정보 |
|---|---|
| 아파트 | https://lafine.net/apt (stable main). Release는 RSA-4096 키로 서명되었습니다. |
| RPM | https://lafine.net/rpm(Fedora/openSUSE 별도). repomd.xml GPG 서명 |
| pacman (Arch) | https://lafine.net/archlinux(저장소 이름 roamswitch, x86_64와 aarch64. roamswitch-bin, Server 에디션은 roamswitch-server-bin). 패키지와 .db를 apt·rpm과 같은 RSA-4096 키로 서명하며 pacman이 검증합니다. AUR은 신규 등록이 중단되어 등록하지 않았습니다. PKGBUILD에서 makepkg로 설치할 수도 있습니다. |
| 타르볼 | https://lafine.net/linux/dl/에 x86_64 / aarch64의 .tar.gz + .sha256 + .asc(저장소 서명 키에 의한 분리 서명). 소스 저장소는 비공개이므로 일반 사용자용 배포처는 GitHub Releases가 아니라 이곳입니다 |
- glibc 하한 고정: 릴리스 바이너리는 Debian 12(bookworm, glibc 2.36) 컨테이너 안에서 빌드되므로, Debian 12 / Ubuntu 22.04 이후에서 심볼 버전 불일치가 일어나지 않습니다. CI에 "glibc 플로어 검증" 단계를 두어, 2.36을 넘는 의존성이 섞이면 빌드를 실패시킵니다.
- 서명 키 관리: apt/rpm 저장소 서명의 비밀 키는 GitHub Actions의 암호화된 시크릿에만 존재하며, 저장소에는 공개 키만 커밋합니다.
11.3 일일 업데이트
roamswitch-updater는 systemd 타이머(roamswitch-update.timer, 부팅 15분 후에 동작하고 그 뒤 24시간마다, 최대 3시간의 무작위 지연)로 실행되는 단독 바이너리입니다. 기본값에서 외부 배포 URL에 접촉하는 유일한 구성 요소입니다(9.4의 옵트인 기능 제외). 매 실행마다:
GET https://lafine.net/updates/v1/manifest및 해당 분리된 서명.- Sparkle 앱 업데이트 키와 별도로 전용 위협 피드 서명 키를 사용하여 매니페스트의 Ed25519 서명을 확인하세요. 피드는 서버 측 CI에 의해 매일 다시 서명되므로 개인 키는 CI 비밀에 보관됩니다. 범위를 피드로 지정한다는 것은 유출로 인해 공격자가 잘못된 차단 목록(싱크홀/경고 - 코드 경로 없음, 앱 업데이트 경로 없음)만 제공할 수 있음을 의미합니다. 앱 업데이트 서명 키는 macOS 키체인을 벗어나지 않습니다. 확인되지 않은 매니페스트는 삭제됩니다. 업데이트 프로그램은 서명되지 않은 데이터로 대체되지 않습니다.
- 위협 피드는 버전이 바뀌면 가져와 SHA-256과 Ed25519 서명을 검증한 뒤 원자적으로 설치합니다. 실증형 진단의 CVE 맵과 npm 패키지 이름 목록은 매니페스트 버전이 새로울 때만 가져옵니다. 커널, OS 패키지, 언어 CVE 맵은 약 7일마다 가져옵니다. 다만 Ubuntu CVE 맵(지원 버전의 Ubuntu만)이 아직 설치되지 않았을 때와 OS 패키지 CVE 맵이 KEV보다 오래되었을 때는 다음 일일 실행에서 가져옵니다. 모두 서명을 검증한 뒤에 설치합니다.
- 매니페스트 버전이 새로우면 웹 애플리케이션 계층 탐지 규칙(§5)도 가져옵니다. SHA-256과 Ed25519 서명을 검증하고 규칙으로 읽을 수 있는지도 확인한 뒤 원자적으로 설치합니다. 읽을 수 없는 파일은 설치되지 않으며 동작 중인 규칙은 교체되지 않습니다. 새로운 접속처는 늘지 않고 같은 매니페스트 가져오기에 포함됩니다. Server Edition에서는
cve_kernel_map_updates_enabled를 따르며, 끄면 통신이 전혀 일어나지 않습니다. - ClamAV가 설치된 경우
freshclam을 호출합니다. - 알림을 위한 최신 앱 버전을 기록합니다(업데이터 never는 앱을 설치하지 않습니다. Linux에서는 사용자가
apt upgrade을 실행합니다).
실패(오프라인, 서명 불량, freshclam 없음)는 lastError에 기록하고 항상 exit 0으로 끝나므로 systemd의 실패 알림은 나오지 않습니다. systemctl disable --now roamswitch-update.timer 등으로 비활성화할 수 있으며, 그 경우 동봉된 데이터만으로 동작합니다. 위협 피드는 패키지에도 동봉되어 있어, 업데이터를 비활성화해도 apt upgrade로 갱신됩니다.
§12
- OS: Ubuntu 22.04 / 24.04 이상, Debian 12 이상, Linux Mint / Pop!_OS / elementary / Zorin, Fedora / RHEL 계열, openSUSE, Arch 계열(pacman 저장소에서 설치, x86_64와 aarch64, 클라이언트와 Server 에디션), Raspberry Pi OS 64-bit(Bookworm), Ubuntu for Raspberry Pi
- 아키텍처: x86_64 / aarch64
- 필수:
systemd,nftables,iproute2(ip neigh, ARP/NDP 고정),conntrack,libnotify(데스크톱 알림)(systemd외에는.deb/.rpm종속성에 의해 자동으로 설치) - 선택:
clamav(악성코드 스캔),nmcli·iw(Wi-Fi 판정),bluez(Bluetooth 가드),systemd-resolved(위협 보호 DNS),lsof(포트 탐지),nmap(능동적 검증),wireguard-tools·tailscale(VPN, §4),polkit/pkexec(GUI에서의 관리 작업) - 지원되지 않음: 시스템화되지 않은 배포판(Alpine / Void / Devuan)
- 디스플레이: 1280×720 이상(창 및 글꼴은 화면 크기에 맞게 자동 조정되며 소형 Raspberry Pi 디스플레이 지원)
부록 A
| 상자 | 목적 | 네트워크 |
|---|---|---|
| serde / serde_json | 구성 및 IPC 직렬화 | 없음 |
| 토키오 | 비동기 런타임(features = ["full"]. 기본값에서 사용하는 것은 Unix 소켓뿐) | 없음(기본값에서 TCP 미사용. 옵트인 Sensor 페어링은 예외) |
| 추적 / 추적 구독자 | 로깅(로컬/저널링) | 없음 |
| 이 오류 / 어쨌든 | 오류 처리 | 없음 |
| 정규식 | 문자열 구문 분석(진단, CSS 크기 조정) | 없음 |
| URL | URL 구문 분석(audit_url_safety 경험적 방법) | 없음(가져오지 않음) |
| 크로노 | 날짜/시간 처리 | 없음 |
| ed25519-달렉 | 라이선스 서명과, 업데이터의 매니페스트·위협 피드 등 서명된 데이터의 오프라인 검증(옵트인 Sensor 페어링에서도 사용) | 없음 |
| base64 / sha2 | 라이센스 토큰, 카나리아 해시 | 없음 |
| libc | chown / kill / 시스템콜 | 없음 |
| 이드나 | 동형이의어 감지를 위한 IDN/퓨니코드 호스트 디코딩 | 없음 |
| nfq(데몬 전용) | 링크 가드의 NFQUEUE 바인딩(순수 Rust, AF_NETLINK) | 없음(판정 채널, 송신 없음) |
| 열다 | “릴리스 노트 열기”나 EULA·지원 페이지 링크를 열기 위해 xdg-open을 호출 | 프로세스 자체는 통신하지 않습니다. |
| GTK3 / ksni(앱 전용) | GUI 및 트레이 | 없음 |
| serde_yaml | /etc/roamswitch/guard.yaml 읽기(core) | 없음 |
| toml | Cargo.lock / poetry.lock 분석(언어 패키지 CVE 스캔, core) | 없음 |
| md-5 | 링크 가드의 JA3 핑거프린트 해시(인증이나 무결성 용도가 아님, core) | 없음 |
| bs58 | 암호화폐 개인 키의 Base58 체크(비밀 정보 탐지, core) | 없음 |
| rand | 옵트인 Sensor 페어링의 단말 키 생성(core) | 없음 |
| tonic / tonic-prost / prost / tower / hyper-util | Tetragon 센서와의 gRPC. Unix 도메인 소켓만, TLS 없음(core) | 없음(Unix 소켓만) |
| flate2 | RHEL 계열 패키지 CVE 맵의 gzip 압축 해제(updater만. 순수 Rust) | 없음(압축 해제만) |
| inotify | 허니토큰(인증 정보 미끼)에 대한 접근 감시(roamswitch-honeytokens)와 랜섬웨어 복구용 파일 덮어쓰기 감시(ransomware-rollback) | 없음 |
| aya | 실험적인 XDP 부트 게이트 로더(roamswitch-xdp-gate. daemon이 참조) | 없음(bpf() / netlink만) |
| urlencoding / gdk / gdk-pixbuf / glib / pango | GUI의 URL 디코드와 GTK3 주변 크레이트(app만) | 없음 |
| qrcode | 격리 해제 확인 화면에 표시하는 QR 코드 행렬 계산(그리기는 자체 구현이며 이미지 라이브러리는 사용하지 않음. app 전용) | 없음 |
| zeroize | 패스프레이즈 같은 비밀 값을 사용한 뒤 메모리에서 지움(daemon·app) | 없음 |
| ureq + Rustls(roamswitch-updater 전용) | 일일 업데이터의 HTTPS GET(매니페스트, 서명, 갱신된 데이터) | 트리의 유일한 HTTP/TLS 스택입니다. 업데이터 바이너리로 제한됨 |
roamswitch-core, roamswitch-daemon, roamswitch-app, roamswitch-mcp, roamswitchkit에는 인터넷으로 나가는 HTTP 클라이언트도 TLS 스택도 없습니다. roamswitch-core의 tonic / hyper는 Tetragon과의 로컬 gRPC용이며 TLS가 없습니다. HTTP/TLS는 roamswitch-updater에만 있으며(CI가 강제), 텔레메트리 SDK는 어디에도 없습니다.
부록 B
table inet roamswitch { # 프로필 방화벽(open / balanced / lockdown)
chain input {
type filter hook input priority 0; policy <accept|drop>;
ct state established,related accept
iif "lo" accept
ip protocol icmp accept # open은 policy accept로 규칙 없음. balanced / lockdown은 policy drop(ICMP·ICMPv6 허용은 balanced만)
}
chain output {
type filter hook output priority 0; policy accept;
}
}
table inet roamswitch { # Air-Gap(격리) 중에는 같은 테이블을 다시 만든다. input / output 모두 policy drop, 허용은 lo뿐(확립된 연결도 통과시키지 않음)
chain input { type filter hook input priority -100; policy drop; iif "lo" accept }
chain output { type filter hook output priority -100; policy drop; oif "lo" accept }
}
table inet roamswitch_linkguard { # §4.5 — 프로필 테이블과 독립
chain output {
type filter hook output priority 0; policy accept;
udp dport 443 reject with icmpx type port-unreachable # block_quic이 활성화되었을 때만(기본값은 꺼짐)
meta l4proto udp udp dport 53 queue num 92 bypass
meta l4proto tcp tcp dport 53 queue num 92 bypass
meta l4proto tcp tcp dport { 80, 443 } ct state new,established ct original packets 1-14 queue num 92 bypass # 각 연결의 처음 14개 패킷만 검사 대상으로 보냄
}
}
table inet roamswitch_dev_guard { # §4 포트 이상 가드 / 수동 포트 격리, 별도 테이블
chain input {
type filter hook input priority -10; policy accept;
iif != "lo" tcp dport { … } drop
}
}
table inet roamswitch_portscan { # 포트 스캔 탐지 및 차단(기본적으로 켜짐)
chain block { type filter hook input priority -200; policy accept; ip saddr @blocked_ips ct state new log … drop }
chain detect { type filter hook input priority -100; policy accept; iifname != "lo" ct state new tcp flags syn log … }
}
table inet roamswitch_sshguard { # §4 SSH 무차별 대입 차단(sshd가 실행 중일 때만)
set banned4 { type ipv4_addr; flags timeout; }
set banned6 { type ipv6_addr; flags interval, timeout; }
chain block { # 금지된 접속원이 SSH 포트로 보내는 새 연결을 차단합니다. 이미 맺어져 있던 연결도 응답 방향을 차단해 끊습니다
type filter hook input priority -200; policy accept;
ip saddr @banned4 tcp dport { <SSH> } ct state new limit rate 5/minute log …
ip saddr @banned4 tcp dport { <SSH> } ct state new drop
ip6 saddr @banned6 tcp dport { <SSH> } ct state new limit rate 5/minute log …
ip6 saddr @banned6 tcp dport { <SSH> } ct state new drop
ip saddr @banned4 tcp dport { <SSH> } ct direction reply drop
ip6 saddr @banned6 tcp dport { <SSH> } ct direction reply drop
}
}
table inet roamswitch_egress_block { # 악성 IP로의 아웃바운드 통신 차단 목록(기본적으로 켜짐)
chain output { type filter hook output priority -150; policy accept; ip daddr { … } log … drop }
chain forward { type filter hook forward priority -150; policy accept; ip daddr { … } log … drop }
}
table inet roamswitch_docker_guard { # Docker 공개 포트에 의한 방화벽 우회 대책(Docker의 네이티브 nftables 백엔드가 있을 때만)
chain forward { type filter hook forward priority -10; policy accept; … iifname { … } drop }
}
table inet roamswitch_isolate { # eBPF 탐지 시의 프로세스 단위 차단(cgroup / UID 지정)
chain process_block { type filter hook output priority -100; policy accept; … drop }
}
table inet roamswitch_vpn { # §4 WireGuard 백엔드 킬 스위치
chain output {
type filter hook output priority -150; policy drop;
oifname "lo" accept
oifname "roamswitch" accept
meta l4proto { icmp, ipv6-icmp } accept
udp sport 68 udp dport 67 accept # DHCP
ip daddr { <endpoint v4> } udp dport <port> accept
ip6 daddr { <endpoint v6> } udp dport <port> accept
ct state established,related accept
}
chain input { type filter hook input priority -150; policy drop; … } # 대칭
}
table inet roamswitch_ts { # §4 Tailscale 백엔드 킬 스위치(더 느슨함)
chain output {
type filter hook output priority -150; policy drop;
oifname "lo" accept
oifname "tailscale0" accept
meta l4proto { icmp, ipv6-icmp } accept
udp sport 68 udp dport 67 accept # DHCP(v6 쪽도 대칭)
ip daddr 100.64.0.0/10 accept # tailnet CGNAT
ip6 daddr fd7a:115c:a1e0::/48 accept
ip daddr 100.100.100.100 udp dport 53 accept # MagicDNS
ip daddr 100.100.100.100 tcp dport 53 accept
udp dport 3478 accept # STUN
udp dport 41641 accept # WireGuard 직접 연결
tcp dport 443 accept # DERP 폴백
ct state established,related accept
}
chain input { type filter hook input priority -150; policy drop; … } # 대칭
}
게이트웨이/IPv6 라우터/DNS 확인자(§4)의 ARP/NDP 고정은 nftables가 아닌 커널 인접 테이블(ip neigh replace … nud permanent)에서 에서 수행됩니다. 고정된 항목은 /var/lib/roamswitch/arp_lock.json에 기록됩니다.
부록 C
이 문서의 모든 주장은 귀하의 컴퓨터에서 확인할 수 있습니다. 아래 명령은 roamswitch 패키지가 설치된 호스트에서 실행됩니다.
C.1 아웃바운드 트래픽 확인
데몬/앱/MCP 바이너리는 HTTP/TLS 라이브러리를 연결하지 않습니다:
for b in roamswitch-daemon roamswitch-app roamswitch-mcp; do
ldd "$(command -v $b)" | grep -iE 'ssl|crypto|nghttp|curl' && echo " ^ in $b"
done
# → 출력 없음. HTTP/TLS 스택은 roamswitch-updater에만 정적으로 링크되어 있습니다.
실행 중인 데몬에는 인터넷 소켓이 없습니다:
sudo lsof -p "$(pgrep -x roamswitch-daem)" -a -i
# → 출력 없음 = TCP/UDP 인터넷 연결이 하나도 없음
sudo lsof -p "$(pgrep -x roamswitch-daem)" -a -U | grep roamswitch
# → /run/roamswitch/roamswitch.sock과 events.sock(eBPF 탐지 이벤트 수신용)뿐(링크 가드는 AF_NETLINK 소켓을
# 추가하지만, 이는 커널 채널이며 인터넷 소켓이 아닙니다)
RoamSwitch로 인해 발생하는 유일한 송신은 일일 업데이트입니다:
watch -n 5 'sudo ss -tupn | grep -E "roamswitch-(daem|app|mcp)" || echo "(none)"'
# → 항상 "(none)". 이 3개는 인터넷 소켓을 전혀 열지 않습니다.
systemctl list-timers roamswitch-update.timer
sudo systemctl start roamswitch-update.service
journalctl -u roamswitch-update.service -n 20 --no-pager
# → lafine.net/updates/v1로의 HTTPS GET(매니페스트, 서명, 갱신된 데이터)만 수행하고 종료한다. ClamAV가 설치되어 있으면 freshclam이 ClamAV 미러에도 접속한다.
해제하고 완전히 침묵을 확인하세요:
sudo systemctl disable --now roamswitch-update.timer
# 또는 /var/lib/roamswitch/updates.json을 "enabled": false로 편집
sudo strace -f -e trace=network -p "$(pgrep -x roamswitch-daem)" 2>&1 | grep -i 'connect('
# → AF_UNIX / AF_NETLINK로만 connect. AF_INET / AF_INET6는 전혀 나타나지 않습니다.
C.2 재현 가능한 방어 검증(Docker 테스트 스위트)
Air-Gap 차단이나 자가 복구 같은 방어 기구는 roamswitch-support의 Docker 테스트 스위트로 재현할 수 있습니다. 스위트는 독립된 네임스페이스와 컨테이너 안의 파일만 조작하며, 호스트의 네트워크와 파일에는 영향을 주지 않습니다. 다만 --privileged로 동작하므로 Yama의 ptrace_scope 같은 커널 전체 설정은 호스트에도 반영되고, 컨테이너를 지워도 되돌아가지 않습니다. 일회용 환경에서 실행하십시오.
# 검증 스위트 가져오기 및 재현 실행(공식 배포 패키지를 사용해 격리된 컨테이너 내에서 자동 검증)
git clone https://github.com/lafine1211/roamswitch-support.git
cd roamswitch-support/test/docker
docker build -t roamswitch-test .
docker run --rm --privileged roamswitch-test
테스트 컨테이너는 공식 APT 저장소에서 배포 패키지를 가져와 독립된 네임스페이스에서 검증합니다. 공개 스위트는 pentest.sh(PENT-1~7의 7개 시나리오)와 selftest.sh(데몬의 파괴적 셀프 테스트)입니다. 표의 ID는 기록상의 일련번호이며 스크립트의 검사와 일대일이 아닙니다. SP-6~SP-11 계열과 PENT-8·9는 공개 스위트에 없으며, 실제 기기 등 다른 절차로 확인했습니다.
(1) 자율 네트워크 방어 및 Air-Gap Self-Healing
| 아이디 | 시나리오 | 검증방법 | 합격 기준 |
|---|---|---|---|
| SP-3 | Air-Gap 활성화 → 송신 중단 | enable_air_gap IPC 보내기 | policy drop은 출력 후크에 적용됩니다. 모든 아웃바운드 트래픽이 차단됨 |
| SP-3b | 방화벽 강제 제거 및 자가 복구 | nft delete table inet roamswitch을 통한 제거 규칙 | Anti-Clobber 자가 치유 기능은 5초 이내에 드롭 규칙을 복원합니다. |
| SP-3c | 데몬 재시작 시 페일클로즈됨 | Air-Gap 중에 데몬을 종료(selftest.sh에서는 kill에 의한 SIGTERM)하고 재시작 | 송신 삭제 정책은 다시 시작해도 원활하게 유지됩니다. |
| SP-3d | 승인된 Air-Gap 복구 | 승인된 disable_air_gap IPC 보내기 | 삭제 정책 해제, 모든 마커 파일 제거, 송신 복원 |
| SP-8 | 예방적 ARP/NDP 고정 | 격리된 netns 게이트웨이 환경에서 활성화 → 스푸핑된 무상 ARP 전송 | 게이트웨이 인접 항목은 PERMANENT로 유지됩니다. 스푸핑된 ARP가 무시됨 |
| SP-9 | VPN 킬 스위치(WireGuard) | 별도의 netns에 있는 Live WireGuard 서버, .conf → vpn_up 가져오기 | 핸드셰이크는 inet roamswitch_vpn을 통해 완료됩니다. 터널 사망 시 누출 없음 |
| SP-10 | VPN 킬 스위치(Tailscale) | 스텁 tailscale CLI + 별도의 netns, tailscale0 IF | 터널 외부 일반 텍스트 TCP/80 및 로컬 DNS가 차단되었습니다. DERP 및 MagicDNS 허용 |
(2) 커널 및 마운트 강화
| 아이디 | 시나리오 | 검증방법 | 합격 기준 |
|---|---|---|---|
| SP-11a | 네트워크 sysctl 강화 | apply_kernel_sysctl_hardening IPC 실행 | rp_filter=1, tcp_syncookies=1, accept_redirects=0 목표 값에 도달 |
| SP-11b | 메모리 보호 및 Yama LSM | ptrace_scope 및 suid_dumpable 확인 | kernel.yama.ptrace_scope=1(스누핑 차단), fs.suid_dumpable=0(코어 덤프 없음) |
| SP-11c | /tmp 및 /dev/shm noexec 방어 | apply_mount_hardening IPC 실행 | /tmp 및 /dev/shm이 noexec,nosuid,nodev을(를) 다시 마운트했습니다. 실행이 거부됨 |
| SP-11d | 합법적인 사용자 실행이 보존됩니다. | 표준 홈 디렉터리(~/)에서 스크립트 실행 | 합법적인 개발자/관리자 작업 흐름을 방해하지 않고 방해 없이 실행됩니다. |
(3) 다층 악성코드 및 랜섬웨어 방어 및 카나리아
| 아이디 | 시나리오 | 검증방법 | 합격 기준 |
|---|---|---|---|
| SP-1 | 카나리아 변조 감지 | ~/Documents/에서 미끼 카나리아 파일(.xlsx)을 자르거나 이름을 바꿉니다. | 몇 초 안에 변조가 감지되어 즉각적인 Air-Gap이 발생합니다. |
| SP-2 | 랜섬웨어 대량 암호화 버스트 감지 | 단일 프로세스로 여러 개의 고엔트로피 파일을 빠르게 생성 | SIGSTOP로 인해 위반 작업자 프로세스가 정지되었습니다. Air-Gap이 트리거됨 |
| SP-2b | shred에는 거짓양성이 없습니다. | 테스트 파일 전체에서 shred -n 3 -u 실행 | 허용 목록 일치로 오탐지 감지 또는 정지 방지 |
| SP-2c | 중요한 프로세스는 동결되지 않습니다. | 버스트 감지 중 동결 대상 논리 검증 | 중요 데몬(dockerd, systemd, containerd)은 동결되지 않습니다. |
| SP-4 | EICAR 테스트 문자열은 알림 전용입니다. | ~/Downloads/에 EICAR 테스트 문자열 쓰기 | 알림 없이 알림 기록에만 남습니다. 파일은 자동으로 격리되지 않습니다. |
| SP-4b | 실제 악성코드 서명 확인 우선 | 감시 폴더 외부에 실제 서명 쓰기 | 모달 승인 대화 상자를 표시합니다. 사용자 확인 시에만 격리 |
| SP-4c | 검역소 권한 강화 | Vault 디렉터리 및 샘플 파일의 권한 검사 | 0700로 설정된 Vault 디렉터리, 0400로 설정된 격리된 샘플 |
| SP-4d | 권한 있는 IPC 안전 원본 파일 복원 | restore_quarantine_file IPC 보내기 | 파일이 사용자 권한(0644)으로 원래 경로로 복원되고 제외 항목에 추가되었습니다. |
(4) 패시브 링크 가드 및 피싱 방어
| 아이디 | 시나리오 | 검증방법 | 합격 기준 |
|---|---|---|---|
| SP-7 | mode = block 강력한 집행 | 피드 목록 또는 blocklistExtra 호스트에 연결 | TLS 레이어에서 삭제됨(SNI 구문 분석됨) 목록에 없는 안전한 호스트가 HTTP 200에 도달함 |
| SP-7b | mode = warn 페일클로즈 보류 | 사용자 응답 없이 경고 호스트에 연결(시간 초과 8초) | 시간 초과 시 패킷을 삭제합니다(fail-closed). 명시적인 승인이 있는 경우에만 허용됨 |
| SP-7c | mode = off 완전 분해 | 링크 가드 비활성화 | inet roamswitch_linkguard 테이블이 완전히 제거되었습니다. |
(5) BadUSB 완화 및 장치 제어
| 아이디 | 시나리오 | 검증방법 | 합격 기준 |
|---|---|---|---|
| SP-6 | 연결된 키보드 할아버지 | 데몬 시작 시 연결된 키보드 확인 | 기존 장치는 유효합니다. 후속 핫플러그만 확보됨 |
(6) 공격을 모방한 셀프 체크 항목(PENT-1~7은 공개 Docker 스위트, PENT-8·9는 별도의 수동 검증)
| 아이디 | 공격 벡터 | 시뮬레이션 세부정보 | 방어/탐지 기준 |
|---|---|---|---|
| 펜트-1 | C2 유출 | Air-Gap에서 C2로의 송신 HTTP/TCP 시도 | 모든 패킷은 netfilter에서 삭제됩니다. 누출 제로 |
| 펜트-1b | FW 강제 삭제 | nft delete table inet roamswitch을(를) 사용한 제거 규칙 | Anti-Clobber 자가 치유 기능으로 몇 초 내에 규칙을 복원합니다. |
| 펜트-1c | Air-Gap 안전 복원 | 인증된 disable_air_gap IPC 발행 | 삭제 규칙이 제거되었습니다. 마커가 삭제되었습니다. 연결이 복원되었습니다 |
| 펜트-2 | /tmp 백도어 | /tmp에서 삭제된 백도어 스크립트 실행 | noexec 마운트 보호(Permission denied)에 의해 거부됨 |
| 펜트-2b | /dev/shm 공유 메모리 | /dev/shm에 배치된 바이너리 페이로드 실행 | noexec 마운트 방어에 의해 차단됨 |
| 펜트-2c | 사용자 공간 보존 | 합법적인 사용자 디렉터리(/home/tester/)에서 스크립트 실행 | 방해받지 않는 실행; 작업흐름 중단 제로 |
| 펜트-3 | ptrace 메모리 스누핑 | 비밀/토큰 추출을 목표로 하는 PTRACE_ATTACH | Yama LSM kernel.yama.ptrace_scope=1에 의해 거부됨 |
| 펜트-3b | 코어 덤프 비밀 스크래핑 | 메모리 코어 덤프를 얻기 위해 프로세스 충돌을 유발합니다. | fs.suid_dumpable=0에 의해 방지됨 |
| 펜트-4 | 카나리아 변조 | ~/Documents/의 제로아웃 카나리아 미끼 파일 | 크기 이상 및 해시 변화 실시간 감지 |
| 펜트-4b | 카나리아 대량 삭제 | 카나리아 미끼 파일 대량 삭제 | 파일 사라짐 즉시 감지해 사건 제기 |
| 펜트-5 | IP 주소 스푸핑 | 스푸핑된 소스 IP로 패킷 전송 | rp_filter=1(역방향 경로 필터)에 의해 삭제됨 |
| 펜트-5b | SYN 폭주 DoS | 반개방 TCP 연결 플러드 | tcp_syncookies=1에 의해 보호되는 상태 테이블 |
| 펜트-5c | ICMP 경로 하이재킹 | 가짜 ICMP 리디렉션 패킷 삽입 | accept_redirects=0로 인해 무시되었습니다. |
| 펜트-6 | 키릴 문자 동음이의어 피싱 | gооgle.com(키릴 동형이의어)로 이동합니다. | LinkGuard에 의해 식별됨, 점수 40(위험/블록) |
| 펜트-6b | 원시 IP 및 일반 텍스트 트래픽 | 원시 IP에 대한 직접 아웃바운드 연결 | 안전 위험 요인으로 정확하게 표시됨 |
| 펜트-7 | OpenAI API 키 유출 | 코드 또는 로그에 sk-proj-... 토큰 노출 | Shannon 엔트로피 분석을 통해 감지 및 마스크 처리 |
| 펜트-7b | GitHub 토큰 유출 | 코드에 ghp_... 개인 토큰 노출 | 토큰 패턴과 엔트로피 검증으로 일치 |
| 펜트-8 | 커널 LPE(Frag Gap) 선점 | 권한이 없는 unshare -U -r(CVE-2026-53362 시도) | v1.1.0 측정에서는 user.max_user_namespaces = 0에 의해 Operation not permitted로 즉시 거부. 현행 Client Edition은 이 거부를 기본적으로 수행하지 않음(guard.yaml의 auto_enable_userns_restriction은 기본값이 비활성. Server Edition은 상시 적용) |
| 펜트-9 | eBPF 위협 센서 및 프로세스 정지 | Falco eBPF 소켓을 통해 주입된 중요/긴급 경고 | 밀리초 내에 SIGSTOP을 통해 프로세스가 정지되었습니다(상태: Ts). Air-Gap 배포 |
검증의 종류: PENT-2·2b, 3·3b, 5·5b·5c, 8은 커널과 mount의 표준 기능 설정이 효력을 내고 있는지 확인하는 항목입니다(PENT-8은 현행 Client Edition에서는 기본으로 적용하지 않습니다). PENT-1·1b·1c, 4·4b, 6·6b, 7·7b, 9는 자체 탐지와 차단을 공격하는 쪽에서 시험한 항목입니다. PENT-2c는 평소 작업이 깨지지 않는지 확인하는 항목입니다.
(7) 셀프 체크 총괄(Falco 없음 [독립형] 및 Falco 있음 [eBPF 연동])
독립된 Docker 환경(Ubuntu 24.04 + Client Edition을 Nmap / curl / hping3 등으로 공격)에서 수행한 셀프 체크 결과입니다. 표는 Client v1.1.0의 2026-09-06 측정입니다. 2026-09-25에는 1.10 계열의 미공개 수정 버전에서 11개 항목 중 11개가 성공했습니다(audit/RESULTS-PENTEST-2026-09-25.ja.md).
| 검증항목 | Falco 없음(독립형 강화) | Falco 사용(eBPF 강화) | 국방 평결 |
|---|---|---|---|
| 외부 포트 스캔 저항(Nmap SYN) | PASS(100% 필터링됨 / Lockdown에서 삭제) | PASS(100% 필터링됨 / Lockdown에서 삭제) | 완전한 외부 스텔스 |
| 외부 직접 액세스 차단(TCP/80, 3306) | PASS(시간 초과 감소/0 응답) | PASS(시간 초과 감소/0 응답) | 인바운드 노출 제로 |
| 커널 LPE(프래그 갭) 완화 | 합격(v1.1.0 측정. user.max_user_namespaces = 0 환경에서 unshare를 차단. 현행 Client Edition에서는 기본적으로 꺼져 있음) | PASS(eBPF 경고 + SIGSTOP 동결 + Air-Gap) | 심층방어 검증됨 |
| 무단 포트 감지(비정상) | PASS (0.0.0.0 바인드 플래그가 높음 위험) | PASS (0.0.0.0 바인드 플래그가 높음 위험) | 100% 감지 및 유도 |
| 로그 팽창 및 CPU 오버헤드 방지 | 제로 로그 공간(제거됨) | PASS (95% 노이즈 컷 / 2MB 버퍼 / 50MB 캡) | 데스크톱 최적화 |
C.3 알려진 제한사항
| 한계 | 영향 | 완화 |
|---|---|---|
일부 커널에서는 tmpfs(/tmp)의 FAN_MARK_MOUNT이 이벤트를 전달하지 않습니다. | /tmp 아래의 파일 쓰기는 fanotify에 의해 모니터링되지 않습니다. | /tmp은(는) 임시 폴더이며 모니터링되는 사용자 폴더가 아닙니다. 랜섬웨어는 ~/을 목표로 합니다. 표시 실패는 명시적으로 기록됩니다. |
| 컨테이너 오버레이fs/tmpfs에서는 fanotify 전달이 없습니다. | 컨테이너 내 엔트로피 버스트 감지를 검증할 수 없습니다. | 실제 하드웨어(ext4)에서 검증되었습니다. 프로브를 통해 하네스 자동 건너뛰기 |
RoamSwitch의 nftables 작업은 Docker의 iptables-nft과 netfilter 공간을 공유합니다. | RoamSwitch 규칙 작업은 Docker의 NAT 규칙을 방해할 수 있습니다. | 전용 테이블(inet roamswitch 외 roamswitch_*)로 분리되지만, nft flush ruleset 등의 전체 조작은 피해야 함 |
| 링크 가드는 TLS SNI를 통해서만 브라우저의 DoH를 확인합니다. ECH(Encrypted Client Hello)는 이를 숨깁니다. | ECH가 널리 배포되면 ECH 지원 사이트에 대한 ECH 사용 연결을 호스트 이름으로 식별할 수 없습니다. | 로컬 차단 목록과 휴리스틱은 여전히 DNS/HTTP 및 비 ECH TLS에 적용됩니다. DNS 위협 보호(§4.5, 기본적으로 켜짐)는 확인자 경로를 포함합니다. |
updates.json의 enabled가 false인 경우, 피드의 최신성은 릴리스 주기에 따라 달라짐 | 업데이트를 끄면 피드는 마지막 apt upgrade만큼만 최신 상태가 됩니다. | 심각도가 가장 높은 탐지(브랜드 동형이의어)에는 피드가 필요하지 않습니다. 항상 최신 범위를 유지하려면 다시 선택하거나 위협 방지 DNS를 활성화하세요. |