
Características:
- Seguimiento de geolocalización de los usuarios que hacen clic en un enlace compartido.
- Imagen personalizable y URL de redireccionamiento.
- Herramienta educativa para demostrar los riesgos de hacer clic en enlaces sospechosos.
Instalación:
Requisitos previos:
- Python 3.x
- pip (Python instalador de paquetes)
- ngrok (para exponer el servidor local a Internet)
- ipgeolocation.io account (API)
Download and Install:
Clonar el repositorio:
git clone https://github.com/davenisc/traceOwl.git
cd traceOwl
Instalar python venv:
apt install python3.11-venv
Crear y activar el entorno virtual:
python -m venv traceOwl_venv
source traceOwl_venv/bin/activate
Instalar las bibliotecas necesarias:
pip install -r requirements.txt
Uso:
Ejecutar el script principal:
python traceowl.py --image https://YOUR_URL_IMAGE.jpg --article https://davenisc.com --title "Exciting Article" --apikey YOUR_IPGEOLOCATION_API_KEY --ngrok http://YOUR_NGROK_URL
Accede a la página de seguimiento:
Si estás en la misma red local (LAN), abre tu navegador web y navega hasta http://127.0.0.1:8000 Si deseas que la página de seguimiento sea accesible a través de Internet, utiliza ngrok.
Usando ngrok
- Descarga e instala ngrok:
- Descarga ngrok de ngrok.com y sigue las instrucciones de instalación para tu sistema operativo.
- Expon tu servidor local a Internet:
ngrok http http://localhost:8000
Después de ejecutar el comando anterior, ngrok te proporcionará una URL pública. Comparte esta URL con tus sujetos de prueba para acceder a la página de seguimiento a través de Internet.
Cómo instalar Ngrok en Linux
Instala ngrok a través de Apt con el siguiente comando:
curl -s https://ngrok-agent.s3.amazonaws.com/ngrok.asc \
| sudo tee /etc/apt/trusted.gpg.d/ngrok.asc >/dev/null \
&& echo "deb https://ngrok-agent.s3.amazonaws.com buster main" \
| sudo tee /etc/apt/sources.list.d/ngrok.list \
&& sudo apt update \
&& sudo apt install ngrok
Ejecuta el siguiente comando para agregar tu token de autenticación al ngrok.yml predeterminado:
ngrok config add-authtoken YOUR_NGROK_AUTH_TOKEN