How urban20/scannerip works
1. Propósito general
- Scip3 es una herramienta de reconocimiento de redes y OSINT orientada a escaneo de hosts, enumeración de puertos, fingerprinting de servicios y consulta de reputación/exposición pública vía Shodan.
- El repositorio está organizado como una aplicación de línea de comandos, no como un servicio web.
2. Punto de entrada y orquestación
- src/scip3.py actúa como entrypoint principal.
- Su rol es interpretar argumentos, decidir el modo de operación y coordinar los módulos de escaneo, OSINT, salida y persistencia.
3. Capa de configuración y parámetros
- src/params.py y src/opciones.json concentran la definición/lectura de parámetros de ejecución.
- Esta capa determina cosas como modo normal/agresivo/SYN/descubrimiento, cantidad de hilos, timeout, rango de puertos y flags de salida.
4. Motor de escaneo, dividido por estrategia
- src/escaneos/lineales.py parece cubrir escaneos secuenciales o “normales”.
- src/escaneos/agresivo.py implementa el modo concurrente con multihilos.
- src/escaneos/scapy_escan.py cubre el escaneo SYN/ACK de bajo nivel, dependiente de Scapy y de privilegios en Linux.
- Esta separación sugiere un boundary claro: el orquestador elige un motor y cada motor encapsula su propia forma de sondear puertos.
5. Pipeline de descubrimiento y fingerprinting
- src/fingerprint.py se usa para inferir servicios o dispositivos a partir de respuestas de red y payloads.
- src/data.py, junto con archivos JSON bajo src/json/, aporta tablas auxiliares para mapear puertos, estados y TTLs.
- En la arquitectura, esto funciona como una etapa posterior al escaneo: primero se detecta apertura/estado y luego se intenta clasificar el servicio o sistema.
6. Descubrimiento de red y OSINT
- El README describe un modo de descubrimiento de red (-d) que identifica hosts activos y, en Linux, puede inferir fabricante por MAC, hostname y sistema operativo por TTL.
- También existe un modo OSINT con Shodan (-s) para geolocalización, reputación, histórico de puertos y URLs asociadas.
- Shodan es la única dependencia externa claramente central en la arquitectura de inteligencia de red.
7. Modelo de objetos y utilidades compartidas
- src/objetos.py probablemente define estructuras de datos para hosts, puertos, resultados y metadatos.
- src/func.py concentra utilidades transversales: formateo, validación, conversión, filtrado o helpers de red.
- Estas piezas reducen acoplamiento entre el CLI, los motores de escaneo y la persistencia.
8. Persistencia y gestión de resultados
- src/archivos/archivos.py maneja lectura/escritura de resultados e ისტორiales.
- El README menciona persistencia en TXT, generación de informes personalizados, apertura de sesiones previas y borrado de historial.
- En términos de arquitectura, este es el boundary de salida: los escáneres producen hallazgos y el subsistema de archivos los materializa.
9. Tablas y catálogos de apoyo
- Los JSON en src/json/ (puertos.json, data_puertos.json, status.json, ttl.json) actúan como catálogos locales.
- Su función es mapear puertos conocidos, estados de escaneo y heurísticas de TTL, evitando lógica hardcodeada en el motor.
- Esto sugiere una arquitectura de reconocimiento apoyada en lookup tables estáticas más que en servicios internos.
10. Separación por plataforma
- El proyecto apunta a Windows, Linux y Termux, pero algunas capacidades son específicas de Linux, especialmente el modo SYN y parte del descubrimiento de red.
- Esa diferencia de plataforma es importante para el diagrama: no todos los módulos se ejecutan en todos los entornos con la misma capacidad.
11. Flujo principal de datos
- Entrada del usuario en CLI → parsing de opciones → selección del modo → ejecución del motor de escaneo/OSINT → enriquecimiento con tablas JSON y fingerprinting → formateo de salida → persistencia/log.
- En paralelo, cuando se usa -s, el flujo se desvía hacia Shodan para enriquecer el objetivo con datos externos antes o durante la presentación de resultados.
12. Límites arquitectónicos relevantes
- No hay señales de backend persistente, base de datos relacional o API propia.
- El sistema es básicamente un toolkit local, centrado en ejecución interactiva, acceso a red, consumo de APIs externas y escritura de resultados en disco.
- Su complejidad está en los modos de escaneo y el enriquecimiento de datos, no en infraestructura de despliegue.
Main entry points: scip3.py scip3.py · fingerprint.py fingerprint.py · objetos.py objetos.py · lineales.py Lineales
Components 15
CLI & control
Command-line entrypoint, option handling, and shared runtime settings.
- scip3.py · Main CLI entrypoint that parses arguments and orchestrates execution.
src/scip3.py - params.py · Runtime parameter definitions and option loading.
src/params.py - opciones.json · Serialized execution options and defaults.
src/opciones.json
Scanning
Port scanning strategies and low-level probing engines.
- Lineales · Sequential or normal scanning mode.
src/escaneos/lineales.py - Agresivo · Concurrent multithreaded scanning mode.
src/escaneos/agresivo.py - Scapy scan · Low-level SYN/ACK probing path for Linux and privileged execution.
src/escaneos/scapy_escan.py
Enrichment
Fingerprinting, discovery heuristics, and external OSINT lookup.
- fingerprint.py · Service and device inference from network responses.
src/fingerprint.py - data.py · Shared lookup and enrichment helpers for scan results.
src/data.py - objetos.py · Core result and host objects shared across modules.
src/objetos.py - func.py · Cross-cutting utility functions used by scanning and output code.
src/func.py
Results
Persistence, reporting, and session/history handling.
- archivos.py · Read/write of results, history, and saved sessions.
src/archivos/archivos.py
Lookup data
Static catalogs used to map ports, statuses, and TTL heuristics.
- puertos.json · Known port catalog for enrichment and presentation.
src/json/puertos.json - data_puertos.json · Additional port metadata used during classification.
src/json/data_puertos.json - status.json · State labels and scan-status mapping.
src/json/status.json - ttl.json · TTL heuristics for host and OS inference.
src/json/ttl.json
Connections 22
- scip3.py → params.py: loads · Entrypoint reads runtime parameters and mode selection.
- scip3.py → Lineales: selects · Routes normal scans to the sequential engine.
- scip3.py → Agresivo: selects · Routes aggressive scans to the concurrent engine.
- scip3.py → Scapy scan: selects · Routes low-level SYN scanning to the Scapy path.
- scip3.py → fingerprint.py: enriches · Coordinates fingerprinting after probe results are available.
- scip3.py → archivos.py: persists · Sends final results and session actions to storage.
- params.py → opciones.json: reads · Option definitions and defaults are stored in JSON.
- Lineales → data.py: uses · Sequential scan consults shared enrichment helpers.
- Agresivo → data.py: uses · Concurrent scan consults shared enrichment helpers.
- Scapy scan → data.py: uses · Low-level scan consults shared enrichment helpers.
- Lineales → objetos.py: builds · Produces host and port result objects.
- Agresivo → objetos.py: builds · Produces host and port result objects.
- Scapy scan → objetos.py: builds · Produces host and port result objects.
- fingerprint.py → puertos.json: looks up · Maps observed ports to known services.
- fingerprint.py → data_puertos.json: looks up · Uses auxiliary port metadata for classification.
- fingerprint.py → status.json: maps · Normalizes scan outcomes to status labels.
- fingerprint.py → ttl.json: infers · Uses TTL heuristics for network and OS hints.
- fingerprint.py → func.py: uses · Shares formatting and transformation helpers.
- archivos.py → objetos.py: stores · Persists structured results and sessions.
- archivos.py → func.py: uses · Relies on helpers for formatting and validation.
- scip3.py → objetos.py: orchestrates · Main flow passes structured results between stages.
- scip3.py → func.py: uses · CLI layer uses shared utility helpers.