Go로 작성된 Spip 네트워크 센서
Spip은 Go로 작성된 Linux용 저상호작용 네트워크 허니팟 센서입니다. 호스트가 Spip으로 리다이렉트하는 모든 포트에서 TCP 연결을 수락하며, 평문이든 TLS든 관계없이 클라이언트가 다음 메시지를 보내도록 유도할 만큼만 응답하고, 각 교환을 ECS 필드 이름을 사용한 하나의 JSON 레코드로 기록하여 SIEM이나 데이터 레이크에서 바로 사용할 수 있게 합니다. 선택적 UDP 캡처는 데이터그램을 기록하며 절대 응답하지 않습니다.
HoneyLabs는 honeylabs.net에 게시된 데이터를 수집하기 위해 Spip을 운영합니다.
사전 요구 사항:
iptables 및 root 권한git clone https://github.com/honeylabshq/Spip-Go.git
cd Spip-Go
go build -o spip-agent ./cmd/spip-agent
observer.version과 agent.version에 보고되는 버전(기본값 dev)을 설정하려면 -ldflags "-X main.version=v1.2.3"을 추가하세요.
sudo ./scripts/initial_setup.sh
아래의 초기 설정 도우미를 참조하세요.
config.toml 생성 또는 편집
최소 config.toml:name = "spip-agent"
ip = "0.0.0.0"
port = 8080
선택적 구성 키:
cert_path / key_path: 둘 다 설정되면 TLS를 활성화합니다. 상대 경로는 구성 파일이 있는 디렉터리를 기준으로 확인됩니다.log_file: 레코드를 stdout 대신 이 파일에 추가합니다. 아래 로그 출력을 참조하세요.[loom]: 레코드를 HTTP를 통해서도 전송합니다. 아래 Loom을 참조하세요.read_timeout_seconds / write_timeout_seconds: 연결별 유휴 읽기 타임아웃 및 쓰기 타임아웃입니다.rate_limit_per_second / rate_limit_burst: 모든 소스가 공유하는 새 TCP 연결에 대한 속도 제한입니다. 제한을 초과한 연결은 읽지 않은 채로 닫힙니다.community_id_seed: Community ID v1 흐름 해싱을 위한 선택적 16비트 시드입니다(기본값을 사용하려면 생략하거나 0으로 설정).capture_client_hello: tls.client.hello_hex를 제외하려면 false로 설정합니다. 핑거프린팅을 참조하세요.ignore_sources: 연결 및 데이터그램이 아무것도 읽기 전에 닫히거나 폐기되어 절대 기록, 핑거프린팅 또는 전송되지 않는 주소 또는 네트워크입니다. 단일 주소 및 CIDR, IPv4 또는 IPv6:
ignore_sources = ["192.0.2.10", "198.51.100.0/24", "2001:db8::/32"]. 임대 호스트의 허니팟은 해당 호스트 자체의 모니터링에 의해 폴링되며, 이러한 스크레이프를 집계하면 포트 순위와 스캐너 수가 왜곡됩니다. 파싱되지 않는 항목은 에이전트 시작을 중단시킵니다. 여기의 오타는 폐기된다고 믿는 트래픽을 조용히 기록하게 되기 때문입니다. 폐기 건수는 소스별로 집계되어 매시간 및 종료 시 로그에 보고됩니다.udp_enabled 및 udp_* 키: UDP 캡처를 참조하세요.이러한 런타임 튜닝 필드를 생략하거나 0으로 설정하면 Spip는 다음 기본값을 적용합니다:
read_timeout_seconds: 30write_timeout_seconds: 10rate_limit_per_second: 20rate_limit_burst: 50000sudo iptables -t nat -F
sudo iptables -t nat -A PREROUTING -p tcp --dport 22 -j RETURN
sudo iptables -t nat -A PREROUTING -p tcp -j REDIRECT --to-port 8080
첫 번째 명령은 전체 nat 테이블을 비웁니다. 자체 NAT 규칙이 있는 호스트에서는 이를 생략하십시오. ip6tables를 사용한 동일한 두 규칙이 IPv6를 처리합니다. Spip은 커널의 연결 추적에서 각 연결의 원래 목적지를 읽어 destination.ip와 destination.port로 기록합니다.
./spip-agent -config config.toml
-config는 유일한 플래그이며 기본값은 작업 디렉터리의 config.toml입니다. SIGINT 또는 SIGTERM은 리스너를 중지하고, 열린 연결을 최대 15초 동안 기다리며, 대기 중인 Loom 배치를 스풀에 기록하여 전송에 5초를 부여합니다. 나머지는 다음 시작 시 전송됩니다.
Spip은 원래 목적지 포트를 기준으로 응답자를 선택합니다. 각 응답자는 클라이언트가 다음 메시지(자격 증명, 명령 또는 메일 봉투)를 보내도록 하기에 충분한 정보만 전달합니다.
| 포트 | 응답 |
|---|---|
| 23, 2323 | Telnet 옵션 협상과 login: 프롬프트, 이어서 Password:, 그다음 Login incorrect 후 연결 종료 |
| 21, 990 | FTP 인사말, 첫 줄 이후 비밀번호 요청, 이어서 530 Login incorrect. 후 연결 종료 |
| 25, 465, 587 | SMTP 인사말, 처음 세 줄에 250 응답, 네 번째 줄에 354 응답, 그다음 연결 종료. 아무것도 릴레이되지 않으며 아웃바운드 연결도 이루어지지 않습니다. |
| 110, 995 | POP3 인사말, 첫 줄 이후 +OK, 두 번째 줄 이후 -ERR invalid login, 그다음 연결 종료 |
| 143, 993 | IMAP 인사말, 이어서 * BAD Login failed 후 연결 종료 |
| 6379, 6380, 또는 Redis 명령처럼 보이는 모든 페이로드 | PING에는 +PONG, 그 외 모든 것에는 +OK |
| 그 밖의 모든 포트 | HTTP 요청에는 클라이언트의 IP 주소를 본문으로 하는 HTTP/1.1 200 OK, 그 외에는 IP 주소만 |
키 교환 메시지 없이 SSH-2.0을 보내는 클라이언트는 SSH-2.0-spip 배너를 받으며, Spip은 클라이언트 지문을 계산할 수 있도록 키 교환을 최대 2초 동안 기다립니다.
telnet, FTP, SMTP, POP3 및 IMAP 인사말은 연결 시 전송됩니다. TLS가 활성화된 경우 Spip은 먼저 1바이트를 읽어 TLS와 일반 텍스트를 구분하므로, 해당 인사말은 클라이언트가 무언가를 보낸 후에만 전송됩니다.
Spip은 ECS 로그를 단일 로컬 대상에 기록하며, 동일한 레코드를 Loom 서버로도 보낼 수 있습니다:
| 대상 | 설정 | 동작 |
|---|---|---|
| 로컬 | log_file | 생략하거나 비워 두면: stdout. 경로로 설정하면: 해당 파일에 레코드가 추가됩니다. 항상 켜져 있습니다. |
| Loom | enabled = true인 [loom] | 선택 사항. 동일한 레코드가 로컬 출력에 더해 배치로 묶여 Loom 수집 URL로 POST됩니다. |
로컬 출력에는 시간별 드롭 수 및 경고와 같은 에이전트 자체의 로그 줄도 {"timestamp": <unix seconds>, "level": "INFO", "message": "...", "target": "...", "record_type": "log"} 형식으로 포함됩니다. Loom에는 연결 레코드만 전송됩니다. 시작 메시지는 stderr로 전송됩니다.
Spip은 ECS 필드 이름을 사용하여 각 레코드를 한 줄의 JSON으로 기록하며, 연결 자체에서 도출할 수 있는 정보만 사용합니다(ASN 또는 지리적 보강 없음). 여러 메시지를 보내는 연결은 메시지마다 하나의 레코드를 생성하며, 모두 동일한 event.id를 가집니다. 필드는 다음과 같습니다:
@timestamp: 레코드의 RFC 3339 시간, 정수 초 단위event.id: 연결별 세션 식별자; event.sequence: 세션 내 레코드의 위치, 1부터 시작event.duration: 연결이 열린 이후 경과한 나노초event.module, event.dataset (spip.tcp 또는 spip.udp), event.kind, event.category, event.type: SIEM이 Spip의 레코드를 선택할 수 있도록 함observer.vendor, observer.product, observer.type, observer.version, agent.type, agent.versionobserver.hostname, observer.id 및 host.name: 설정의 에이전트 namesource.ip, source.port, destination.ip, destination.portsource.bytes, destination.bytes, network.bytes: 세션에서 지금까지 수신 및 송신된 바이트network.transport (tcp 또는 udp) 및 network.protocol (tls, dns, netbios 또는 quic) (알려진 경우)http.request.method, http.request.headers, http.request.body.content, http.request.body.bytes, url.path, url.domain, url.port: 페이로드가 HTTP 요청인 경우user_agent.original: 사용 가능한 경우event.summary: HTTP 요청이 아닌 페이로드의 경우, 텍스트로 된 페이로드event.original_payload_hex: 16진수로 된 원시 페이로드, 항상 유지됨network.community_id, tls.client.*, ssh.client.hash.hassh 및 http.request.hash.akin을 추가합니다.예시 레코드, 보기 좋게 출력:
{
"@timestamp": "2026-10-12T09:14:03Z",
"agent": {"type": "spip", "version": "dev"},
"destination": {"bytes": 78, "ip": "203.0.113.10", "port": 80},
"event": {
"category": ["network", "intrusion_detection"],
"dataset": "spip.tcp",
"duration": 100000000,
"id": "3f0c9a52-6d1e-4b8a-9c27-5e41b7d08a6f",
"ingested_by": "spip",
"kind": "event",
"module": "spip",
"original_payload_hex": "474554202f2e656e7620485454502f312e310d0a486f73743a203230332e302e3131332e31300d0a557365722d4167656e743a204d6f7a696c6c612f352e300d0a4163636570743a202a2f2a0d0a436f6e6e656374696f6e3a20636c6f73650d0a0d0a",
"sequence": 1,
"type": ["connection", "info"]
},
"host": {"name": "example-sensor"},
"http": {
"request": {
"hash": {"akin": "b11cun040_00040015_4c87b06e"},
"headers": {
"accept": "*/*",
"connection": "close",
"host": "203.0.113.10",
"user-agent": "Mozilla/5.0"
},
"method": "GET"
}
},
"network": {"bytes": 177, "community_id": "1:HL0iYZHtkKWecl0HBQsLeL+lIc8=", "transport": "tcp"},
"observer": {
"hostname": "example-sensor",
"id": "example-sensor",
"product": "Spip",
"type": "honeypot",
"vendor": "HoneyLabs",
"version": "dev"
},
"source": {"bytes": 99, "ip": "198.51.100.23", "port": 51234},
"url": {"domain": "203.0.113.10", "path": "/.env"},
"user_agent": {"original": "Mozilla/5.0"}
}
다운스트림 시스템은 원한다면 이 레코드들을 보강할 수 있습니다(지리 정보, ASN 등).
Spip은 캡처하는 내용을 변경하지 않고 각 레코드에 수동 핑거프린팅 필드를 추가합니다: