bopscrk

bopscrk

Genera wordlist intelligenti e potenti per attacchi mirati
Esplora la documentazione »

Guarda la demo · Segnala un bug · Richiedi una funzionalità

Informazioni sul progetto

• Creatore di wordlist per attacchi mirati: inserisci informazioni personali relative al target, combina ogni parola e trasforma i risultati in possibili password. Il modulo lyricpass permette di cercare testi di canzoni correlati agli artisti e includerli nelle wordlist.
• Trasformazioni maiuscole/minuscole e leet personalizzabili: crea set di caratteri personalizzati e pattern di trasformazione tramite un semplice file di configurazione.
• Modalità interattiva e interfaccia a comando singolo supportate.
• Incluso nella distribuzione di penetration testing BlackArch Linux e nell'Rawsec's Cybersecurity Inventory dall'agosto 2019.

Realizzato con

• Python 3 (il ramo secondario mantiene il supporto legacy per Python 2.7)
  • requests
  • alive-progress

Novità

• VERSIONE 2.4.7 PUBBLICATA (02/09/2024): Velocità e prestazioni notevolmente aumentate. La nuova modalità di trasformazione maiuscola/minuscola estensiva permette di generare tutte le possibili trasformazioni di caso.

(torna su)

Per iniziare

Installazione

pip install bopscrk

In alternativa, se vuoi clonare il repository da Github invece di installarlo da Pypi:

git clone --recurse-submodules https://github.com/r3nt0n/bopscrk
cd bopscrk
pip install -r requirements.txt

Esegui la modalità interattiva

bopscrk -i

(torna su)

Utilizzo

  -h, --help         mostra questo messaggio di aiuto ed esci
  -i, --interactive  modalità interattiva, lo script ti chiederà informazioni sul target
  -w                 parole da combinare separate da virgola (modalità non interattiva)
  --min              lunghezza minima per le parole da generare (default: 4)
  --max              lunghezza massima per le parole da generare (default: 32)
  -c, --case         abilita le trasformazioni maiuscole/minuscole
  -l, --leet         abilita le trasformazioni leet
  -n                 numero massimo di parole da combinare ogni volta (default: 2)
  -a , --artists     artisti di cui cercare i testi delle canzoni (separati da virgola)
  -o , --output      file di output per salvare la wordlist (default: tmp.txt)
  -C , --config      specifica il file di configurazione da usare (default: ./bopscrk.cfg)
  --version          stampa la versione ed esci

Per maggiori informazioni, consulta la sezione Utilizzo avanzato.

(torna su)

Come funziona

• Devi fornire alcune parole che fungeranno da base.
• La funzionalità lyricpass permette di introdurre artisti. Lo strumento scaricherà tutti i testi delle sue canzoni e ogni riga sarà aggiunta come nuova parola. Per impostazione predefinita, verranno aggiunti anche i nomi degli artisti e una parola formata dall'iniziale di ogni parola in ogni frase.
• Lo strumento genererà tutte le combinazioni possibili tra di esse.
• Per generare più combinazioni, aggiungerà alcuni separatori comuni (es. "-", "_", "."), numeri e caratteri speciali usati frequentemente nelle password.
• Puoi usare le trasformazioni leet e maiuscole/minuscole per aumentare le possibilità.

Suggerimenti

• I campi possono essere lasciati vuoti.
• Puoi usare accenti nelle parole e caratteri speciali (se usi la modalità non interattiva, esegui l'escape dei caratteri speciali come ' e " con backslash, es.: bopscrk -w John,O\'hara,Doe,foo,bar).
• Nel campo 'others' puoi scrivere più parole separate da virgola. Esempio: 2C,Flipper.
• Se vuoi produrre tutte le possibili trasformazioni leet, abilita l'opzione recursive_leet nel file di configurazione.
• Se vuoi produrre tutte le possibili trasformazioni di caso, abilita l'opzione extensive_case nel file di configurazione.
• Puoi selezionare quali trasformazioni applicare alle frasi dei testi trovate tramite il file cfg.
• Usando la modalità non interattiva, dovresti fornire gli anni sia nella forma lunga che breve (1970,70) per ottenere lo stesso risultato della modalità interattiva.
• Devi fare attenzione con l'argomento -n. Se imposti un valore grande, potrebbe risultare in wordlist troppo enormi. Raccomando valori tra 2 e 5.
• Per fornire più nomi di artisti tramite riga di comando, dovresti fornirli separati da virgola. Esempio: -a johndoe,johnsmith
• Per fornire nomi di artisti con spazi tramite riga di comando, dovresti fornirli racchiusi tra virgolette. Esempio: -a "john doe,john smith"

(torna su)

Utilizzo avanzato

Personalizzare il comportamento usando il file .cfg

• Nel file bopscrk.cfg puoi specificare i tuoi set di caratteri e abilitare/disabilitare opzioni:

  • extra_combinations (come (john, doe) => 123john, john123, 123doe, doe123, john123doe doe123john) sono abilitate per impostazione predefinita. Puoi disabilitarle nel file di configurazione per ottenere wordlist più mirate.
  • separators_chars: caratteri da usare nelle combinazioni extra. Può essere un singolo carattere o una stringa di caratteri, es.: !?-/&(
  • separators_strings: stringhe da usare nelle combinazioni extra. Può essere una singola stringa o una lista di stringhe separate da spazi, es.: 123 34!@
  • leet_charset: caratteri da sostituire e corrispettivi sostituti nelle trasformazioni leet, es.: e:3 b:8 t:7 a:4
  • recursive_leet: abilita una chiamata ricorsiva alla funzione leet_transforms() per ottenere tutte le possibili trasformazioni leet. ATTENZIONE: abilitata con valori --max elevati (es.: maggiori di 18) potrebbe richiedere molto tempo. Può essere true o false.
  • extensive_case: per impostazione predefinita, bopscrk applica solo le trasformazioni di caso più comuni: tutti i caratteri in minuscolo, tutti in maiuscolo, ogni carattere in maiuscolo, tutte le coppie in maiuscolo, tutte le posizioni dispari in maiuscolo, tutte le consonanti in maiuscolo e tutte le vocali in maiuscolo. Puoi abilitare questa opzione per ottenere TUTTE le possibili trasformazioni di caso, il che può risultare in wordlist molto più grandi, ma potrebbe essere utile in alcuni scenari.

(torna su)

Lyricpass

Questa funzionalità è basata su una versione modificata di un tool sviluppato originariamente da initstring. Le modifiche sono state apportate per integrare l'input e l'output dello strumento con bopscrk.

Recupererà tutti i testi di tutte le canzoni degli artisti che fornisci. Per impostazione predefinita memorizzerà ogni artista, ogni frase trovata con sostituzione degli spazi, ogni frase trovata ridotta alle sue iniziali (che verranno trasformate successivamente se hai attivato le trasformazioni leet e di caso).

(torna su)

Roadmap

• Migliorare la gestione della memoria
  • Scrivere le wordlist nel filesystem durante l'esecuzione e usarle come cache (#12)
• Migliorare le prestazioni
  • Migliorare la logica di parallelismo
• Funzionalità extra
  • Implementare barra di avanzamento per tenere l'utente informato sullo stato di esecuzione
  • Implementare file di sessione per tenere traccia del punto di esecuzione e poter interrompere e riprendere le sessioni (#12)
  • Creare opzioni di configurazione per trasformazioni di caso personalizzate (es.: disabilitare trasformazioni pair/odd)
  • Implementare output "pipabile" per permettere l'integrazione con altri strumenti (il flag -q produrrà solo la wordlist finale su stdout)

Vedi gli open issues per una lista completa delle funzionalità proposte (e dei problemi noti).

(torna su)

Contribuisci

I contributi sono ciò che rende la comunità open source un posto fantastico per imparare, ispirare e creare. Ogni contributo che fai è molto apprezzato.

Se hai un suggerimento che potrebbe migliorare questo progetto, per favore fai un fork del repository e crea una pull request. Puoi anche semplicemente aprire un issue con il tag "enhancement". Non dimenticare di dare una stellina al progetto! Grazie ancora!

1. Fai il fork del Progetto
2. Crea il tuo Branch per la Funzionalità (git checkout -b feature/AmazingFeature)
3. Fai il commit delle tue Modifiche (git commit -m 'Add some AmazingFeature')
4. Fai il push sul Branch (git push origin feature/AmazingFeature)
5. Apri una Pull Request

Contributori

• noraj ha contribuito aprendo diversi issue e pull request che hanno permesso di correggere alcuni bug importanti. Ha anche gestito autonomamente l'aggiunta dello strumento nei repository BlackArch e RawSec, aumentandone la popolarità e l'uso
• nylocx e agoertz-fls hanno contribuito aggiungendo il supporto a Python3
• glozanoa e fabaff hanno contribuito aggiungendo il comando bopscrk (miglioramenti a setup.py)

Grazie a tutti!

(torna su)

Elenco modifiche

• Note versione 2.4.7 (02/09/2024)

  • Migliorata la logica di trasformazione del caso (ora rispetta il caso della parola originale)
  • Incluse nuove operazioni di trasformazione di base del caso
  • Implementata modalità di trasformazione estensiva del caso
  • Corretti refusi

• Note versione 2.4.6 (30/08/2024)

  • Aumentate le prestazioni del parallelismo (implementazione reale del multiprocessing)
  • Migliore gestione degli errori del parser di configurazione
  • Corretti refusi

• Note versione 2.4.5 (02/08/2022)

  • barra di avanzamento implementata e funzionante
  • Argomento version incluso
  • Documentazione migliorata

• Note versione 2.4.4 (31/07/2022)

  • Bug degli import relativi corretto
  • Iniziato il refactoring della struttura generale per permettere l'inclusione della funzionalità della barra di avanzamento

• Note versione 2.4.3 (28/07/2022)

  • Corretta la struttura del progetto per permettere una corretta installazione tramite pip:
    • Aggiunto MANIFEST per escludere file compilati e di test durante la creazione della distribuzione
    • Migliorata la struttura per copiare correttamente tutta la struttura nelle directory dei pacchetti Python all'interno di una directory padre

(torna su)

Licenza

Distribuito sotto la GNU General Public License v3.0. Vedi LICENSE per maggiori informazioni.

(torna su)

Contatti

r3nt0n: Github - email
bopscrk: Github - Pypi

(torna su)

Riconoscimenti

• Il modulo lyricpass è basato su un progetto creato da initstring.
• Font Pixel Gothic di Kajetan Andrzejak.
• Best-README-Template di othneildrew.

(torna su)

Disclaimer legale

Questo strumento è creato al solo scopo di sensibilizzazione e formazione sulla sicurezza, non dovrebbe essere utilizzato contro sistemi per i quali non si ha il permesso di testare/attaccare. L'autore non è responsabile per un uso improprio o per eventuali danni che potresti causare. Accetti di utilizzare questo software a tuo rischio.

(torna su)