🔍 HashEye - Herramienta Avanzada de Detección de Tipos de Hash

HashEye es una potente herramienta CLI en Python para detectar y analizar instantáneamente tipos de hash. Proporciona información detallada sobre formatos de hash, niveles de seguridad, análisis de entropía y detección de patrones.

Desarrollado por Isaac Security Labs

🔗 Enlaces:

• GitHub: @ishaklaz
• Telegram: @isaacsecuritylabs

✨ Características

• 🔎 Detección Multi-Formato: Soporta hashes codificados en hexadecimal y Base64
• 🎯 Amplio Soporte de Hashes: Detecta MD5, SHA1, SHA224, SHA256, SHA384, SHA512, NTLM, bcrypt, scrypt y más
• 📊 Análisis de Entropía: Calcula la entropía de Shannon para evaluar la aleatoriedad del hash
• 🔒 Evaluación de Seguridad: Proporciona calificaciones de nivel de seguridad y recomendaciones
• 🎨 Detección de Patrones: Identifica caracteres repetidos y patrones secuenciales
• 📝 Salida JSON: Formato JSON opcional para automatización y scripting
• 📦 Procesamiento por Lotes: Analiza múltiples hashes desde la línea de comandos o desde un archivo
• 🎨 Salida Colorida: Hermosa salida de terminal con colores ANSI
• 🚀 Sin Dependencias: Usa solo la biblioteca estándar de Python

📋 Requisitos

• Python 3.6 o superior
• No se requieren dependencias externas (solo biblioteca estándar)

🚀 Instalación

Método 1: Descarga Directa

1. Descarga hasheye.py en tu sistema
2. Hazlo ejecutable (Linux/macOS):
   root@kitploit:~

   chmod +x hasheye.py
   

Método 2: Clonar el Repositorio

git clone https://github.com/ishaklaz/Hash-Eye.git
cd Hash-Eye

Método 3: Usando pip (si está disponible)

pip install -r requirements.txt

💻 Uso

Uso Básico

Analizar un solo hash:

python3 hasheye.py 5d41402abc4b2a76b9719d911017c592

Opciones de Línea de Comandos

python3 hasheye.py [OPCIONES] [HASH...]

Opciones:

• -h, --help Muestra el mensaje de ayuda y sale
• -j, --json Muestra los resultados en formato JSON
• -f, --file Lee hashes desde un archivo (uno por línea)
• -s, --simple Muestra una salida simplificada sin análisis detallado
• -v, --version Muestra la información de la versión

Ejemplos

1. Análisis de un Solo Hash

python3 hasheye.py 5d41402abc4b2a76b9719d911017c592

Salida:

[+] HashEye Result
──────────────────────────────────────────────────

Hash           : 5d41402abc4b2a76b9719d911017c592
Length         : 32
Format         : HEX
Type(s)        : MD5 / NTLM (posible) / LM Hash (posible)
Entropy        : 3.8750
Security Level : Débil
Recommendation : Considera actualizar a SHA-256 o SHA-512

──────────────────────────────────────────────────
Powered by Isaac Security Labs

2. Salida JSON

python3 hasheye.py 5d41402abc4b2a76b9719d911017c592 --json

Salida:

{
  "hash": "5d41402abc4b2a76b9719d911017c592",
  "length": 32,
  "format": "hex",
  "types": [
    "MD5",
    "NTLM (posible)",
    "LM Hash (posible)"
  ],
  "entropy": 3.875,
  "security_level": "Weak",
  "recommendation": "Consider upgrading to SHA-256 or SHA-512",
  "pattern_analysis": {
    "case_mixed": false,
    "case_lower": true,
    "case_upper": false,
    "repeating_chars": [],
    "has_sequential": false
  }
}

3. Procesamiento por Lotes (Múltiples Hashes)

python3 hasheye.py hash1 hash2 hash3

4. Procesar Hashes desde un Archivo

Crea un archivo hashes.txt:

5d41402abc4b2a76b9719d911017c592
aaf4c61ddcc5e8a2dabede0f3b482cd9aea9434d
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

Luego ejecuta:

python3 hasheye.py --file hashes.txt

5. Salida Simplificada (Sin Detalles)

python3 hasheye.py 5d41402abc4b2a76b9719d911017c592 --simple

6. Ejemplo de Hash SHA-256

python3 hasheye.py e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

📊 Tipos de Hash Soportados

Hashes Hexadecimales

Hashes Base64

🔍 Entendiendo la Salida

Entropía

La entropía mide la aleatoriedad de un hash:

• Alta (>3.5): Buena aleatoriedad, probablemente un hash correcto
• Media (2.5-3.5): Aleatoriedad moderada
• Baja (<2.5): Baja aleatoriedad, posible hash débil o con patrón

Niveles de Seguridad

• Fuerte: SHA-384, SHA-512 - Seguridad excelente
• Moderado: SHA-224, SHA-256 - Adecuado para la mayoría de los casos de uso
• Débil: MD5, SHA1, NTLM - Considera actualizar

Análisis de Patrones

La herramienta detecta:

• Caracteres repetidos: El mismo carácter aparece varias veces consecutivas
• Patrones secuenciales: Números o caracteres secuenciales
• Análisis de mayúsculas/minúsculas: Mayúsculas y minúsculas mezcladas, todo minúsculas o todo mayúsculas

🛠️ Uso Avanzado

Integración con Scripts

HashEye puede integrarse en tus scripts usando la salida JSON:

#!/bin/bash
result=$(python3 hasheye.py "$hash" --json)
hash_type=$(echo "$result" | python3 -c "import sys, json; print(json.load(sys.stdin)['types'][0])")
echo "Detectado: $hash_type"

Integración con Python

import subprocess
import json

def detect_hash(hash_string):
    result = subprocess.run(
        ['python3', 'hasheye.py', hash_string, '--json'],
        capture_output=True,
        text=True
    )
    return json.loads(result.stdout)

info = detect_hash('5d41402abc4b2a76b9719d911017c592')
print(f"Tipo: {info['types'][0]}")
print(f"Seguridad: {info['security_level']}")

📝 Ejemplos de Hashes Comunes

MD5

python3 hasheye.py 5d41402abc4b2a76b9719d911017c592
# Longitud: 32, Tipo: MD5

SHA1

python3 hasheye.py aaf4c61ddcc5e8a2dabede0f3b482cd9aea9434d
# Longitud: 40, Tipo: SHA1

SHA256

python3 hasheye.py e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
# Longitud: 64, Tipo: SHA256

SHA512

python3 hasheye.py cf83e1357eefb8bdf1542850d66d8007d620e4050b5715dc83f4a921d36ce9ce47d0d13c5d85f2b0ff8318d2877eec2f63b931bd47417a81a538327af927da3e
# Longitud: 128, Tipo: SHA512

🐛 Solución de Problemas

Problema: Los colores no se muestran

Solución: Es posible que tu terminal no admita códigos de escape ANSI. Los colores son opcionales y no afectan la funcionalidad.

Problema: "Desconocido / No es un formato de hash válido"

Solución: Asegúrate de que tu cadena hash contenga solo caracteres hexadecimales (0-9, a-f, A-F) o caracteres Base64 válidos.

Problema: Archivo no encontrado

Solución: Usa rutas absolutas o asegúrate de estar en el directorio correcto al usar la opción --file.

🤝 Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar un Pull Request.

1. Haz un fork del repositorio
2. Crea tu rama de características (git checkout -b feature/CaracteristicaIncreible)
3. Confirma tus cambios (git commit -m 'Añadir alguna CaracteristicaIncreible')
4. Sube a la rama (git push origin feature/CaracteristicaIncreible)
5. Abre un Pull Request

📄 Licencia

Este proyecto está licenciado bajo la Licencia MIT; consulta el archivo LICENSE para más detalles.

🙏 Agradecimientos

• Isaac Security Labs - Por el desarrollo y soporte
• Comunidad de Python por la excelente biblioteca estándar

Conéctate con nosotros:

• 🌐 GitHub: @ishaklaz
• 💬 Telegram: @isaacsecuritylabs

📧 Soporte

Para problemas, preguntas o contribuciones:

• Abre un issue en GitHub
• Únete a nuestro canal de Telegram

Hecho con ❤️ por Isaac Security Labs