IP-Tracker es una herramienta OSINT programática especializada en el rastreo, geolocalización y enriquecimiento de datos a partir de direcciones IPv4 e información asociada.
Desarrollada para analistas de seguridad y consultores técnicos, la herramienta permite:
- Resolución y enriquecimiento masivo de direcciones de red.
- Consultas ágiles durante procesos de
Footprintingdentro de fases tempranas del Pentesting. - Integración en flujos de detección y recopilación manual.
Este repositorio ha sido estructurado bajo estándares DevSecOps, asegurando modularidad, separación de responsabilidades e integración segura:
IP-Tracker/
├── src/ # Código fuente principal (Core / Aplicación)
├── scripts/ # Automatizaciones DevSecOps (Sanitización)
├── tests/ # Pruebas unitarias y de integración (Excluido en GitHub)
├── docs/ # Documentación técnica adicional
├── diagrams/ # Diagramas arquitectónicos (Mermaid/MD)
├── .gitlab-ci.yml # Pipeline DevSecOps (GitLab only)
├── .gitignore # Filtros de exclusión
├── LICENSE # Licencia Apache 2.0
└── README.md # Esta documentación base
Important
El repositorio completo con todo el código funcional está disponible en GitLab para acceso completo.
https://gitlab.com/group-cybersecurity-lab/IP-Tracker.git
Para garantizar que el entorno público (GitHub) nunca exponga configuraciones sensibles, rutinas de pruebas agresivas o CI confidencial, el proceso de sincronización es controlado e intermediado.
Se trata de una pieza de automatización de seguridad crítica que actúa de la siguiente forma:
- Aislamiento en Rama Pública: En el entorno aislado (GitLab), el desarrollador invoca el script validando su local y generando una versión clon en una rama segura denominada
public. - Filtrado DevSecOps (Purga): En la rama temporal, el script depura toda la información operativa del laboratorio: elimina rutinas automatizadas de testing (
tests/), variables/configuraciones locales (configs/si existieran), la CI interna (.gitlab-ci.yml) y scripts operacionales sensibles. - Control de Emisión Push Force: Una vez validado localmente el paquete sanitizado con sus respectivas documentaciones y vistas (
src/,docs/,diagrams/,Img/), ejecuta únicamente un envío forzado hacia elOrigindestino: Este repositorio de GitHub. - Resilencia de Laboratorio: Una vez emitido la versión estable exterior, la máquina retorna su estado intacto hacia la rama de trabajo
maindel Laboratorio.
- Distribución de Seguridad: Linux (Kali Linux, Parrot OS, BlackArch) o entornos virtualizados sobre Ubuntu. Compatible con capas Android (Termux) adaptadas.
- Runtime Envrionment: Python 3.9 o superior.
Aprovisionamiento dentro del entorno OSINT de Laboratorio:
git clone https://github.com/Devsebastian44/IP-Tracker.git
cd IP-TrackerNota: Requiere poseer el código fuente del paquete (obtenido a nivel privado en la estructura src/).
# Una vez descargado desde la fuente segura o dentro del laboratorio
python3 src/tracker.py