shaha

Construtor de banco de dados de hash e ferramenta de consulta reversa. SHA + aha!

Construa bancos de dados de hash pré-calculados a partir de wordlists e consulte-os para encontrar pré-imagens.

Instalação

cargo install shaha

Ou compile a partir do código-fonte:

git clone https://github.com/oritwoen/shaha
cd shaha
cargo build --release

Uso

Construir um banco de dados de hash

# Algoritmo único (padrão: sha256)
shaha build words.txt

# Múltiplos algoritmos
shaha build words.txt -a md5 -a sha256 -a keccak256

# Arquivo de saída personalizado
shaha build words.txt -o mydb.parquet

# Com metadados de fonte
shaha build rockyou.txt -a hash160 -s rockyou

Consultar por pré-imagem

# Encontrar pré-imagem por hash
shaha query 5e884898da28047151d0e56f8dc6292773603d0d6aabbdd62a11ef721d1542d8

# Busca por prefixo
shaha query 5e8848

# Filtrar por algoritmo
shaha query 5e8848 -a sha256

# Formatos de saída
shaha query 5e8848 --format plain   # padrão
shaha query 5e8848 --format json
shaha query 5e8848 --format table

Informações do banco de dados

shaha info hashes.parquet

Output:

Database: "hashes.parquet"
Records:  1000000
Size:     45.32 MB
Algorithms: sha256, md5, keccak256
Sources:  rockyou

Algoritmos

Formato de Armazenamento

Os bancos de dados são armazenados como arquivos Apache Parquet com compressão ZSTD.

Esquema:

• hash (Binary) - bytes do hash
• preimage (Utf8) - dados de entrada originais
• algorithm (Utf8) - nome do algoritmo
• sources (List) - origens das wordlists

Arquivos Parquet podem ser consultados com DuckDB, Polars, Spark ou Cloudflare R2 SQL.

Casos de Uso

• Pesquisa de segurança - consultas reversas de hash
• Desafios CTF - quebra rápida de hash
• Perícia forense - identificar senhas conhecidas
• Análise de blockchain - pesquisa de endereços Bitcoin/Ethereum

Configuração

A configuração é carregada de (em ordem de prioridade):

1. Bandeiras CLI
2. Variáveis de ambiente
3. .shaha.toml no diretório atual
4. ~/.config/shaha/config.toml

Exemplo de arquivo de configuração

[storage.r2]
endpoint = "https://account-id.r2.cloudflarestorage.com"
bucket = "my-bucket"
access_key_id = "your-access-key"
secret_access_key = "your-secret-key"
region = "auto"
path = "hashes.parquet"

[defaults]
algorithms = ["sha256", "md5"]
output = "hashes.parquet"

Armazenamento R2/S3

Construa e consulte diretamente do Cloudflare R2 ou armazenamento compatível com S3:

# Construir para R2
shaha build words.txt --r2

# Consultar do R2
shaha query 5e8848 --r2

Variáveis de ambiente:

• SHAHA_R2_ENDPOINT - URL do endpoint S3/R2
• SHAHA_R2_BUCKET - Nome do bucket
• SHAHA_R2_ACCESS_KEY_ID ou AWS_ACCESS_KEY_ID
• SHAHA_R2_SECRET_ACCESS_KEY ou AWS_SECRET_ACCESS_KEY
• SHAHA_R2_PATH - Caminho dentro do bucket
• SHAHA_R2_REGION - Região (padrão: "auto")

Roteiro

• Catálogo de Dados R2 - Integração Apache Iceberg para consultas mais rápidas

Licença

MIT