bopscrk

bopscrk

Gere wordlists inteligentes e poderosas para ataques direcionados
Explorar a documentação »

Ver Demonstração · Reportar Erro · Solicitar Funcionalidade

Sobre o Projeto

• Criador de wordlists para ataques direcionados: insira informações pessoais relacionadas ao alvo, combina cada palavra e transforma os resultados em possíveis senhas. O módulo lyricpass permite pesquisar letras relacionadas a artistas e incluí-las nas wordlists.
• Transformações de maiúsculas/minúsculas e leet personalizáveis: crie conjuntos de caracteres e padrões de transformação personalizados através de um simples arquivo de configuração.
• Modo interativo e interface de comando de linha única suportados.
• Incluído na distribuição de pentest BlackArch Linux e no Rawsec's Cybersecurity Inventory desde agosto de 2019.

Construído com

• Python 3 (ramo secundário mantém suporte legado ao Python 2.7)
  • requests
  • alive-progress

Novidades

• 2.4.7 LANÇADO (02/09/2024): Velocidade e desempenho aumentados drasticamente. Novo modo de transformação extensiva de maiúsculas/minúsculas permite gerar todas as transformações possíveis.

(voltar ao topo)

Começando

Instalação

pip install bopscrk

Alternativamente, se quiser clonar o repositório do Github em vez de instalá-lo via Pypi:

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

Executar modo interativo

bopscrk -i

(voltar ao topo)

Uso

  -h, --help         show this help message and exit
  -i, --interactive  interactive mode, the script will ask you about target
  -w                 words to combine comma-separated (non-interactive mode)
  --min              min length for the words to generate (default: 4)
  --max              max length for the words to generate (default: 32)
  -c, --case         enable case transformations
  -l, --leet         enable leet transformations
  -n                 max amount of words to combine each time (default: 2)
  -a , --artists     artists to search song lyrics (comma-separated)
  -o , --output      output file to save the wordlist (default: tmp.txt)
  -C , --config      specify config file to use (default: ./bopscrk.cfg)
  --version          print version and exit

Para mais informações, consulte a seção Uso avançado.

(voltar ao topo)

Como funciona

• Você deve fornecer algumas palavras que servirão de base.
• O recurso lyricpass permite inserir artistas. A ferramenta baixará todas as letras de suas músicas e cada linha será adicionada como uma nova palavra. Por padrão, os nomes dos artistas e uma palavra formada pela inicial de cada palavra em cada frase também serão adicionados.
• A ferramenta gerará todas as combinações possíveis entre elas.
• Para gerar mais combinações, adicionará alguns separadores comuns (ex.: "-", "_", "."), números e caracteres especiais frequentemente usados em senhas.
• Você pode usar transformações leet e de maiúsculas/minúsculas para aumentar suas chances.

Dicas

• Os campos podem ser deixados em branco.
• Você pode usar acentuação nas suas palavras e caracteres especiais (se usar o modo não interativo, escape caracteres especiais como ' e " com barras invertidas, ex.: bopscrk -w John,O\'hara,Doe,foo,bar).
• No campo "outros", você pode escrever várias palavras separadas por vírgula. Exemplo: 2C,Flipper.
• Se quiser produzir todas as transformações leet possíveis, ative a opção recursive_leet no arquivo de configuração.
• Se quiser produzir todas as transformações de maiúsculas/minúsculas possíveis, ative a opção extensive_case no arquivo de configuração.
• Você pode selecionar quais transformações aplicar nas frases das letras encontradas através do arquivo de configuração.
• Usando o modo não interativo, você deve fornecer os anos de forma longa e curta (1970,70) para obter o mesmo resultado que no modo interativo.
• Você deve ter cuidado com o argumento -n. Se definir um valor grande, pode resultar em wordlists muito grandes. Recomendo valores entre 2 e 5.
• Para fornecer vários nomes de artistas via linha de comando, você deve fornecê-los separados por vírgula. Exemplo: -a johndoe,johnsmith
• Para fornecer nomes de artistas com espaços via linha de comando, você deve fornecê-los entre aspas. Exemplo: -a "john doe,john smith"

(voltar ao topo)

Uso avançado

Personalizando o comportamento usando arquivo .cfg

• No arquivo bopscrk.cfg você pode especificar seus próprios conjuntos de caracteres e ativar/desativar opções:

  • extra_combinations (como (john, doe) => 123john, john123, 123doe, doe123, john123doe doe123john) estão ativadas por padrão. Você pode desativá-las no arquivo de configuração para obter wordlists mais focadas.
  • separators_chars: caracteres a serem usados em combinações extras. Pode ser um único caractere ou uma string de caracteres, ex.: !?-/&(
  • separators_strings: strings a serem usadas em combinações extras. Pode ser uma única string ou uma lista de strings separadas por espaço, ex.: 123 34!@
  • leet_charset: caracteres a serem substituídos e seus substitutos correspondentes nas transformações leet, ex.: e:3 b:8 t:7 a:4
  • recursive_leet: ativa uma chamada recursiva à função leet_transforms() para obter todas as transformações leet possíveis. ATENÇÃO: ativado com valores grandes de --max (ex.: maior que 18) pode levar muito tempo. Pode ser true ou false.
  • extensive_case: por padrão, o bopscrk apenas aplica as transformações de maiúsculas/minúsculas mais comuns: todos os caracteres para minúsculas, todos para maiúsculas, cada caractere para maiúsculas, todos os pares para maiúsculas, todos os ímpares para maiúsculas, todas as consoantes para maiúsculas e todas as vogais para maiúsculas. Você pode ativar esta opção para obter TODAS as transformações de maiúsculas/minúsculas possíveis, o que pode resultar em wordlists muito maiores, mas pode ser útil em alguns cenários.

(voltar ao topo)

Lyricpass

Este recurso é baseado em uma versão modificada de uma ferramenta desenvolvida originalmente por initstring. As alterações foram feitas para integrar a entrada e saída da ferramenta com o bopscrk.

Ele recuperará todas as letras de todas as músicas que pertencem aos artistas que você fornecer. Por padrão, armazenará cada artista, cada frase encontrada com substituição de espaço, cada frase encontrada reduzida às suas iniciais (que serão transformadas posteriormente se você tiver ativado as transformações leet e de maiúsculas/minúsculas).

(voltar ao topo)

Roadmap

• Melhorar gerenciamento de memória
  • Escrever wordlists no sistema de arquivos durante a execução e usá-las como cache (#12)
• Melhorar desempenho
  • Melhorar a lógica de paralelismo
• Recursos extras
  • Implementar barra de progresso para manter o usuário informado sobre o estado da execução
  • Implementar arquivo de sessão para rastrear o ponto de execução e ser capaz de parar e retomar sessões (#12)
  • Criar opções de configuração para transformações de maiúsculas/minúsculas personalizadas (ex.: desativar transformações par/ímpar)
  • Implementar saída "pipeável" para permitir integração com outras ferramentas (a flag -q enviará apenas a wordlist final para stdout)

Veja as issues abertas para uma lista completa de funcionalidades propostas (e problemas conhecidos).

(voltar ao topo)

Contribuindo

Contribuições são o que tornam a comunidade open source um lugar incrível para aprender, inspirar e criar. Qualquer contribuição que você fizer será muito apreciada.

Se você tem uma sugestão que possa melhorar este projeto, por favor, faça um fork do repositório e crie um pull request. Você também pode simplesmente abrir uma issue com a tag "enhancement". Não se esqueça de dar uma estrela no projeto! Obrigado novamente!

1. Faça um Fork do Projeto
2. Crie sua Branch de Funcionalidade (git checkout -b feature/AmazingFeature)
3. Faça o Commit das suas Alterações (git commit -m 'Add some AmazingFeature')
4. Envie para a Branch (git push origin feature/AmazingFeature)
5. Abra um Pull Request

Contribuidores

• noraj contribuiu abrindo várias issues e pull requests que permitiram corrigir alguns bugs importantes. Ele também gerenciou por conta própria a adição da ferramenta nos repositórios BlackArch e RawSec, o que aumentou sua popularidade e uso
• nylocx e agoertz-fls contribuíram adicionando suporte ao Python 3
• glozanoa e fabaff contribuíram adicionando o comando bopscrk (melhorias no setup.py)

Obrigado a todos!

(voltar ao topo)

Lista de alterações

• Notas da versão 2.4.7 (02/09/2024)

  • Melhorando a lógica de transformação de maiúsculas/minúsculas (agora respeita a capitalização da palavra original)
  • Incluindo novas operações básicas de transformação de maiúsculas/minúsculas
  • Implementando modo de transformação extensiva de maiúsculas/minúsculas
  • Corrigindo erros de digitação

• Notas da versão 2.4.6 (30/08/2024)

  • Aumentando o desempenho do paralelismo (implementação real de multiprocessamento)
  • Melhor tratamento de erros do analisador de configuração
  • Corrigindo erros de digitação

• Notas da versão 2.4.5 (02/08/2022)

  • Barra de progresso implementada e funcionando
  • Argumento version incluído
  • Documentação melhorada

• Notas da versão 2.4.4 (31/07/2022)

  • Bug de imports relativos corrigido
  • Iniciando refatoração da estrutura geral para permitir inclusão do recurso de barra de progresso

• Notas da versão 2.4.3 (28/07/2022)

  • Corrigindo estrutura do projeto para permitir instalação adequada via pip:
    • Adicionar MANIFEST para excluir arquivos compilados e de teste ao construir distribuição
    • Melhorando estrutura para copiar adequadamente toda a estrutura para os diretórios de pacotes Python dentro de um diretório pai

(voltar ao topo)

Licença

Distribuído sob a Licença Pública Geral GNU v3.0. Veja LICENSE para mais informações.

(voltar ao topo)

Contato

r3nt0n: GitHub - e-mail
bopscrk: GitHub - Pypi

(voltar ao topo)

Agradecimentos

• O módulo lyricpass é baseado em um projeto criado por initstring.
• Fonte Pixel Gothic por Kajetan Andrzejak.
• Best-README-Template por othneildrew.

(voltar ao topo)

Aviso legal

Esta ferramenta foi criada com o único propósito de conscientização e educação em segurança, não deve ser usada contra sistemas que você não tem permissão para testar/atacar. O autor não se responsabiliza por uso indevido ou por qualquer dano que você possa causar. Você concorda que usa este software por sua própria conta e risco.

(voltar ao topo)