Estado del Proyecto: ✅ COMPLETADO CON ÉXITO Autenticación HMAC-SHA256 implementada, 4/8 endpoints funcionales, 1587 códigos de estación extraídos.

🚀 Inicio Rápido

# Instalar dependencias
pip install requests

# Ejecutar demo
python3 adif_client.py

Uso Básico

from adif_client import AdifClient

# Inicializar cliente
client = AdifClient(
    access_key="and20210615",
    secret_key="Jthjtr946RTt"
)

# Obtener salidas de Madrid Atocha
trains = client.get_departures("10200", "AVLDMD")

for train in trains:
    info = train['commercialPathInfo']
    print(f"Tren {info['commercialPathKey']['commercialCirculationKey']['commercialNumber']}")

# Obtener ruta completa de un tren
route = client.get_train_route(
    commercial_number="03194",
    launching_date=1764889200000,
    origin_station_code="10200",
    destination_station_code="71801"
)

📊 Estado del Proyecto

✅ Funcionalidades Implementadas

Característica	Estado	Descripción
Extracción de claves	✅	Claves extraídas de `libapi-keys.so` con Ghidra
Algoritmo HMAC-SHA256	✅	Implementación completa y validada
Códigos de estación	✅	1587 estaciones extraídas
Endpoints funcionales	✅	4/8 endpoints (50%)
Cliente Python	✅	API completa y lista para usar
Documentación	✅	Completa en `/docs`

📍 Endpoints Disponibles

✅ Funcionales (4/8)

Método	Endpoint	Descripción
`get_departures()`	`/departures/traffictype/`	Salidas de una estación
`get_arrivals()`	`/arrivals/traffictype/`	Llegadas a una estación
`get_train_route()`	`/onepaths/`	Ruta completa de un tren
`get_station_observations()`	`/stationsobservations/`	Observaciones de estaciones

❌ Bloqueados por Permisos (4/8)

/betweenstations/traffictype/ - 401 Unauthorized
/onestation/ - 401 Unauthorized
/severalpaths/ - 401 Unauthorized
/compositions/path/ - 401 Unauthorized

Nota: Los endpoints bloqueados tienen implementación correcta pero las claves no tienen permisos suficientes.

📁 Estructura del Proyecto

adif-api-reverse-engineering/
├── 📄 README.md                    # Este archivo
├── 📄 LICENSE                      # Licencia MIT
│
├── 🐍 Python Scripts (Core)
│   ├── adif_auth.py                # ⭐ Implementación HMAC-SHA256
│   ├── adif_client.py              # ⭐ Cliente completo de la API
│   ├── query_api.py                # CLI interactivo
│   └── generate_curl.py            # Generador de curls
│
├── 📊 Datos
│   ├── station_codes.txt           # ⭐ 1587 códigos de estación
│   └── extracted_keys.txt          # Claves extraídas
│
├── 🧪 Tests
│   ├── test_endpoints_detailed.py  # Test exhaustivo con debug
│   └── test_onepaths_with_real_trains.py  # Test con datos reales
│
├── 📚 Documentación (/docs)
│   ├── FINAL_STATUS_REPORT.md      # Informe completo
│   ├── API_DOCUMENTATION.md        # Documentación de API
│   ├── AUTHENTICATION_ALGORITHM.md # Algoritmo HMAC
│   ├── ENDPOINTS_ANALYSIS.md       # Análisis de endpoints
│   ├── API_REQUEST_BODIES.md       # Payloads documentados
│   ├── GHIDRA_GUIDE.md            # Tutorial de Ghidra
│   ├── NEW_DISCOVERIES.md         # Últimos descubrimientos
│   └── CLAUDE.md                  # Contexto del proyecto
│
├── 📦 APK & Análisis
│   ├── base.apk                   # APK original
│   ├── apk_decompiled/            # Código decompilado (JADX)
│   ├── apk_extracted/             # APK extraído
│   │   ├── assets/stations_all.json  # Fuente de estaciones
│   │   └── lib/x86_64/libapi-keys.so # Librería con claves
│   └── frida_scripts/             # Scripts de análisis dinámico
│
└── 🗂️ Otros
    ├── archived_tests/            # Tests antiguos archivados
    └── api_testing_scripts/       # Scripts auxiliares

🔑 Autenticación

Claves Extraídas

ACCESS_KEY = "and20210615"
SECRET_KEY = "Jthjtr946RTt"
USER_KEY_CIRCULATION = "f4ce9fbfa9d721e39b8984805901b5df"
USER_KEY_STATIONS = "0d021447a2fd2ac64553674d5a0c1a6f"

Fuente: apk_extracted/lib/x86_64/libapi-keys.so (Ghidra)

Algoritmo HMAC-SHA256

Implementación basada en AWS Signature v4:

⚠️ CRÍTICO: El orden de headers NO es alfabético:

canonical_headers = (
    f"content-type:application/json\n"
    f"x-elcano-host:{host}\n"          # ← NO alfabético
    f"x-elcano-client:api-elcano\n"
    f"x-elcano-date:{timestamp}\n"
    f"x-elcano-userid:{user_id}\n"
)

Ver adif_auth.py para implementación completa.

🗺️ Códigos de Estación

Total: 1587 estaciones Archivo: station_codes.txt Formato: código TAB nombre TAB tipos_tráfico

Top 10 Estaciones

10200    Madrid Puerta de Atocha          AVLDMD
10302    Madrid Chamartín-Clara Campoamor AVLDMD
71801    Barcelona Sants                  AVLDMD,CERCANIAS
60000    València Nord                    AVLDMD
11401    Sevilla Santa Justa              AVLDMD
50003    Alacant Terminal                 AVLDMD,CERCANIAS
54007    Córdoba Central                  AVLDMD
79600    Zaragoza Portillo                AVLDMD,CERCANIAS
03216    València J.Sorolla               AVLDMD
04040    Zaragoza Delicias                AVLDMD,CERCANIAS

💡 Casos de Uso

1. Monitor de Retrasos

import time
from adif_client import AdifClient

client = AdifClient(ACCESS_KEY, SECRET_KEY)

while True:
    trains = client.get_departures("10200", "ALL")
    for train in trains:
        passthrough = train.get('passthroughStep', {})
        dep_sides = passthrough.get('departurePassthroughStepSides', {})
        delay = dep_sides.get('forecastedOrAuditedDelay', 0)

        if delay > 300:  # Más de 5 minutos
            print(f"⚠️ Retraso de {delay//60} min")

    time.sleep(30)

2. Consultar Rutas Completas

# Obtener trenes con sus rutas
trains_with_routes = client.get_all_departures_with_routes(
    station_code="10200",
    traffic_type="AVLDMD",
    max_trains=5
)

for train in trains_with_routes:
    print(f"🚄 Tren {train['commercial_number']}")
    print(f"   Paradas: {len(train['route'])}")

3. CLI Interactivo

python3 query_api.py

🔬 Herramientas Utilizadas

Ghidra - Extracción de claves de libapi-keys.so
JADX - Decompilación del APK
Python 3 - Implementación del cliente
Frida (opcional) - Análisis dinámico

📖 Documentación

Toda la documentación está en /docs:

FINAL_STATUS_REPORT.md - Informe completo del proyecto
API_DOCUMENTATION.md - Documentación de la API
AUTHENTICATION_ALGORITHM.md - Algoritmo HMAC detallado
GHIDRA_GUIDE.md - Tutorial paso a paso

🎯 Logros del Proyecto

✅ Claves de autenticación extraídas con Ghidra ✅ Algoritmo HMAC-SHA256 implementado y validado ✅ 1587 códigos de estación disponibles ✅ 4/8 endpoints funcionales (50%) ✅ Cliente Python listo para producción ✅ Documentación completa

⚠️ Limitaciones

4/8 endpoints bloqueados por permisos del servidor
Las claves extraídas son de perfil "anónimo/básico"
No hay acceso a información de usuario autenticado

📄 Licencia

MIT License - Ver LICENSE

⚠️ Disclaimer: Proyecto con fines educativos y de investigación. Úsalo de forma responsable.

✨ Créditos

ADIF - Por la aplicación El Cano Móvil
Ghidra & JADX - Herramientas de reverse engineering
Comunidad de seguridad - Por compartir conocimiento

Última actualización: 2025-12-05 Estado: ✅ Proyecto completado con éxito