sshfinder

sshfinder es una herramienta rápida y fiable para descubrir servicios SSH abiertos en uno o varios objetivos. Escanea en busca de puertos TCP abiertos y después confirma cuáles hablan realmente SSH, ejecutando ambas fases de forma concurrente para mayor velocidad.

Características

• Múltiples objetivos — escanea muchas IPs, nombres de host y redes CIDR (p. ej. 10.0.0.0/24) en una sola ejecución, o cárgalos desde un archivo.
• Escaneo en paralelo — los puertos se sondean de forma concurrente y los hosts se escanean en paralelo, lo que hace que los escaneos grandes sean mucho más rápidos.
• Dos motores de escaneo:
  • connect — escaneo de conexión TCP portátil, no requiere privilegios (por defecto).
  • syn — escaneo SYN semiabierto mediante Scapy (más rápido, requiere root).
• Validación SSH fiable — lee el banner de identificación SSH (RFC 4253) por defecto, con validación opcional de handshake completo mediante Paramiko.
• Auditoría de seguridad SSH (--audit) — convierte el descubrimiento en inteligencia de superficie de ataque para pentesters: enumera los métodos de autenticación aceptados (marcando la autenticación por contraseña), lista los algoritmos KEX/cifrado/MAC/clave de host ofrecidos y marca los débiles u obsoletos, detecta Terrapin (CVE-2023-48795) y correlaciona claves de host compartidas entre objetivos para revelar infraestructura clonada o con balanceo de carga.
• Cero dependencias necesarias — el escaneo connect por defecto y la validación de banner se ejecutan solo con la biblioteca estándar de Python.
• Identificación en tubería (pipelined) — el servicio detrás de cada puerto abierto se identifica (y audita) en el instante en que se encuentra el puerto, en paralelo con el resto del barrido de puertos. Los servicios SSH se confirman sin esperar a que termine todo el escaneo, y cada puerto abierto se etiqueta como [SSH] / [not ssh] para que un puerto abierto nunca se confunda con uno SSH.
• Descubrimiento en vivo por socket — los puertos abiertos y los servicios SSH confirmados se imprimen en el momento en que se encuentran, como host:port, de modo que siempre queda claro a qué objetivo pertenece cada resultado al escanear muchos hosts.
• Progreso en vivo y Ctrl+C robusto — un indicador de progreso en tiempo real muestra que el escaneo está funcionando. Ctrl+C se respeta incluso en Windows (donde una espera ilimitada de hilos normalmente lo traga): la primera pulsación detiene el proceso con elegancia y devuelve resultados parciales; una segunda fuerza una salida inmediata.
• Estado de host claro — distingue puertos abiertos, cerrados y filtrados, de modo que un host con cortafuegos o inalcanzable se informe como tal en lugar de parecer un bloqueo.
• Salida legible por máquina — texto legible por humanos o --json, opcionalmente escrito en un archivo.

Instalación

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

# Installs paramiko (recommended: enables the full --audit deep checks and
# --validate paramiko):
pip install -r requirements.txt

# Optional, only for half-open SYN scans (needs root):
pip install scapy>=2.5

El escaneo connect principal, la validación de banner y las partes de --audit que no requieren dependencias (inventario de algoritmos, indicadores de criptografía débil, Terrapin) funcionan sin paquetes de terceros; paramiko habilita las huellas dactilares de clave de host, la enumeración de métodos de autenticación y la correlación de claves compartidas.

Requiere Python 3.9+.

Uso

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

Opciones

Nota sobre escaneos lentos. Escanear el rango completo 1-65535 contra un host con cortafuegos o inalcanzable es inherentemente lento: cada puerto filtrado debe esperar a que se agote el tiempo de espera. El indicador de progreso muestra que sigue funcionando, y Ctrl+C lo detiene rápidamente. Para ir más rápido, reduce los puertos (p. ej. -p 22,2222), baja el tiempo de espera (-t 1) o aumenta la concurrencia (-w).

auto selecciona el escaneo SYN cuando se ejecuta como root con Scapy instalado, y en caso contrario recurre al escaneo connect sin privilegios.

Ejemplos

Escanea un solo host en los puertos SSH comunes:

python sshfinder.py 192.168.1.1 -p 22,2222

Escanea una subred completa y emite JSON:

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

Escanea muchos objetivos desde un archivo con un escaneo SYN rápido (como root):

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

Valida estrictamente SSH con un handshake completo:

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

Audita la superficie de ataque SSH en una subred (métodos de autenticación, criptografía débil, Terrapin, claves de host compartidas):

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

Salida de auditoría de ejemplo:

=== 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

El inventario de algoritmos, los indicadores de criptografía débil y la comprobación de Terrapin funcionan sin dependencias. Las huellas dactilares de clave de host, la enumeración de métodos de autenticación y la correlación de claves compartidas usan Paramiko (pip install paramiko).

Desarrollo

pip install -r requirements-dev.txt
pytest

Legal

Escanea únicamente sistemas que poseas o para los que tengas autorización explícita de pruebas. El escaneo no autorizado puede ser ilegal en tu jurisdicción.