sshfinder

sshfinder는 하나 또는 여러 대상에서 열린 SSH 서비스를 발견하는 빠르고 안정적인 도구입니다. 열린 TCP 포트를 스캔한 다음 실제로 SSH를 사용하는 포트를 확인하며, 두 단계를 동시에 실행하여 속도를 높입니다.

기능

• 다중 대상 — 단일 실행에서 여러 IP, 호스트명, CIDR 네트워크(예: 10.0.0.0/24)를 스캔하거나 파일에서 불러올 수 있습니다.
• 병렬 스캔 — 포트는 동시에 프로브되고 호스트는 병렬로 스캔되어 대규모 스캔이 훨씬 빨라집니다.
• 두 가지 스캔 백엔드:
  • connect — 권한이 필요 없는 휴대용 TCP connect 스캔(기본값).
  • syn — Scapy를 통한 하프 오픈 SYN 스캔(더 빠르며 root 필요).
• 신뢰할 수 있는 SSH 검증 — 기본적으로 SSH 식별 배너(RFC 4253)를 읽고, 선택적으로 전체 Paramiko 핸드셰이크 검증을 지원합니다.
• SSH 보안 감사(--audit) — 펜테스터를 위해 탐색을 공격 표면 인텔리전스로 전환합니다: 허용된 인증 방법을 열거하고(비밀번호 인증 플래그 지정), 제공된 KEX/암호/MAC/호스트 키 알고리즘을 나열하고 취약하거나 더 이상 사용되지 않는 알고리즘에 플래그를 지정하며, Terrapin(CVE-2023-48795) 을 탐지하고, 대상 간 공유 호스트 키를 상호 연관시켜 복제되거나 로드 밸런싱된 인프라를 드러냅니다.
• 필수 의존성 없음 — 기본 connect 스캔과 배너 검증은 Python 표준 라이브러리만으로 실행됩니다.
• 파이프라인 식별 — 각 열린 포트 뒤의 서비스는 포트가 발견되는 즉시 나머지 포트 스캔과 병렬로 식별(및 감사)됩니다. 전체 스캔이 끝날 때까지 기다리지 않고 SSH 서비스가 확인되며, 모든 열린 포트는 [SSH] / [not ssh]로 표시되어 열린 포트가 SSH 포트로 오인되지 않습니다.
• 실시간 소켓별 발견 — 열린 포트와 확인된 SSH 서비스는 발견되는 즉시 host:port 형식으로 출력되므로 여러 호스트를 스캔할 때 어떤 결과가 어떤 대상에 속하는지 항상 명확합니다.
• 실시간 진행 상황 및 강력한 Ctrl+C — 실시간 진행 표시기가 스캔이 작동 중임을 보여줍니다. Ctrl+C는 Windows에서도(무제한 스레드 대기가 일반적으로 이를 삼키는 환경) 존중됩니다: 첫 번째 누름은 정상적으로 중지되고 부분 결과를 반환하며, 두 번째 누름은 즉시 종료를 강제합니다.
• 명확한 호스트 상태 — 열린 포트, 닫힌 포트, 필터링된 포트를 구분하므로 방화벽으로 보호되거나 연결할 수 없는 호스트가 멈춘 것처럼 보이지 않고 그렇게 보고됩니다.
• 기계가 읽을 수 있는 출력 — 사람이 읽기 쉬운 텍스트 또는 --json, 선택적으로 파일에 기록할 수 있습니다.

설치

git clone https://github.com/kabiri-labs/sshfinder.git
cd sshfinder

# paramiko 설치(권장: 전체 --audit 심층 검사 및
# --validate paramiko 활성화):
pip install -r requirements.txt

# 선택 사항, 하프 오픈 SYN 스캔 전용(root 필요):
pip install scapy>=2.5

핵심 connect 스캔, 배너 검증 및 --audit의 의존성 없는 부분(알고리즘 인벤토리, 취약 암호 플래그, Terrapin)은 타사 패키지 없이 작동합니다. paramiko는 호스트 키 지문, 인증 방법 열거 및 공유 키 상호 연관을 활성화합니다.

Python 3.9+ 가 필요합니다.

사용법

python sshfinder.py [targets ...] [options]

옵션

느린 스캔에 대한 참고. 방화벽으로 보호되거나 연결할 수 없는 호스트를 대상으로 전체 1-65535 범위를 스캔하는 것은 본질적으로 느립니다. 모든 필터링된 포트는 타임아웃을 기다려야 하기 때문입니다. 진행 표시기가 여전히 작동 중임을 보여주며, Ctrl+C로 즉시 중지할 수 있습니다. 더 빠르게 하려면 포트 범위를 좁히거나(예: -p 22,2222), 타임아웃을 낮추거나(-t 1), 동시성을 높이십시오(-w).

auto는 root로 실행 중이고 Scapy가 설치된 경우 SYN 스캔을 선택하고, 그 외에는 권한이 필요 없는 connect 스캔으로 대체됩니다.

예제

일반 SSH 포트에서 단일 호스트 스캔:

python sshfinder.py 192.168.1.1 -p 22,2222

전체 서브넷을 스캔하고 JSON 출력:

python sshfinder.py 10.0.0.0/24 -p 22,2222 --json -o results.json

빠른 SYN 스캔으로 파일에서 여러 대상 스캔(root로 실행):

sudo python sshfinder.py -iL targets.txt --scan-method syn

전체 핸드셰이크로 SSH를 엄격하게 검증:

python sshfinder.py example.com -p 22 --validate paramiko

서브넷 전체에서 SSH 공격 표면 감사(인증 방법, 취약 암호, Terrapin, 공유 호스트 키):

python sshfinder.py 10.0.0.0/24 -p 22,2222 --audit

감사 출력 예:

=== 10.0.0.5 ===
  open: 10.0.0.5:22
  SSH  10.0.0.5:22  (SSH-2.0-OpenSSH_7.4)
       host key: ssh-ed25519 SHA256:T/ZM4jOL4amTsO5K3AaCdg2...
       auth: publickey, password  [!] password auth enabled
       [!] Terrapin (CVE-2023-48795): VULNERABLE
       [!] weak ciphers: aes128-cbc

Shared SSH host keys (possible shared/cloned hosts):
  SHA256:T/ZM4jOL4amTsO5K3AaCdg2...
    -> 10.0.0.5:22, 10.0.0.9:22

알고리즘 인벤토리, 취약 암호 플래그 및 Terrapin 검사는 의존성 없이 작동합니다. 호스트 키 지문, 인증 방법 열거 및 공유 키 상호 연관은 Paramiko를 사용합니다(pip install paramiko).

개발

pip install -r requirements-dev.txt
pytest

법적 고지

소유하거나 테스트할 명시적 권한이 있는 시스템만 스캔하십시오. 승인되지 않은 스캔은 관할 지역에서 불법일 수 있습니다.