bopscrk

bopscrk

Genera listas de palabras inteligentes y potentes para ataques dirigidos
Explorar la documentación »

Ver Demo · Reportar Error · Solicitar Característica

Acerca del Proyecto

• Creador de listas de palabras para ataques dirigidos: introduce información personal relacionada con el objetivo, combina cada palabra y transforma los resultados en posibles contraseñas. El módulo lyricpass permite buscar letras relacionadas con artistas e incluirlas en las listas de palabras.
• Transformaciones de mayúsculas/minúsculas y leet personalizables: crea conjuntos de caracteres personalizados y patrones de transformación a través de un archivo de configuración simple.
• Modo interactivo e interfaz de línea de comandos de una sola línea compatibles.
• Incluido en la distribución de pentesting BlackArch Linux y en Rawsec's Cybersecurity Inventory desde agosto de 2019.

Construido con

• Python 3 (la rama secundaria mantiene soporte heredado de Python 2.7)
  • requests
  • alive-progress

Novedades

• 2.4.7 LANZADA (02/09/2024): La velocidad y el rendimiento aumentaron drásticamente. El nuevo modo de transformación de mayúsculas/minúsculas extensivo permite generar todas las transformaciones posibles de mayúsculas/minúsculas.

(volver al inicio)

Primeros pasos

Instalación

pip install bopscrk

Alternativamente, si quieres clonar el repositorio desde Github en lugar de instalarlo desde Pypi:

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

Ejecutar modo interactivo

bopscrk -i

(volver al inicio)

Uso

  -h, --help         muestra este mensaje de ayuda y sale
  -i, --interactive  modo interactivo, el script te preguntará sobre el objetivo
  -w                 palabras para combinar separadas por comas (modo no interactivo)
  --min              longitud mínima para las palabras a generar (por defecto: 4)
  --max              longitud máxima para las palabras a generar (por defecto: 32)
  -c, --case         habilita transformaciones de mayúsculas/minúsculas
  -l, --leet         habilita transformaciones leet
  -n                 cantidad máxima de palabras a combinar cada vez (por defecto: 2)
  -a , --artists     artistas para buscar letras de canciones (separados por comas)
  -o , --output      archivo de salida para guardar la lista de palabras (por defecto: tmp.txt)
  -C , --config      especificar archivo de configuración a usar (por defecto: ./bopscrk.cfg)
  --version          imprime la versión y sale

Para más información, consulta la sección Uso avanzado.

(volver al inicio)

Cómo funciona

• Tienes que proporcionar algunas palabras que actuarán como base.
• La función lyricpass permite introducir artistas. La herramienta descargará todas las letras de sus canciones y cada línea se añadirá como una nueva palabra. Por defecto, también se añadirán los nombres de los artistas y una palabra formada por la inicial de cada palabra en cada frase.
• La herramienta generará todas las combinaciones posibles entre ellas.
• Para generar más combinaciones, añadirá algunos separadores comunes (por ejemplo, "-", "_", "."), números y caracteres especiales usados frecuentemente en contraseñas.
• Puedes usar transformaciones leet y de mayúsculas/minúsculas para aumentar tus posibilidades.

Consejos

• Los campos se pueden dejar vacíos.
• Puedes usar acentuación en tus palabras y caracteres especiales (si usas el modo no interactivo, escapa caracteres especiales como ' y " con barras invertidas, ej.: bopscrk -w John,O\'hara,Doe,foo,bar).
• En el campo de otros puedes escribir varias palabras separadas por comas. Ejemplo: 2C,Flipper.
• Si deseas producir todas las transformaciones leet posibles, habilita la opción recursive_leet en el archivo de configuración.
• Si deseas producir todas las transformaciones de mayúsculas/minúsculas posibles, habilita la opción extensive_case en el archivo de configuración.
• Puedes seleccionar qué transformaciones aplicar a las frases de letras encontradas a través del archivo cfg.
• Usando el modo no interactivo, debes proporcionar los años tanto en formato largo como corto (1970,70) para obtener el mismo resultado que en el modo interactivo.
• Debes tener cuidado con el argumento -n. Si estableces un valor grande, podría resultar en listas de palabras demasiado grandes. Recomiendo valores entre 2 y 5.
• Para proporcionar varios nombres de artistas a través de la línea de comandos, debes proporcionarlos separados por comas. Ejemplo: -a johndoe,johnsmith
• Para proporcionar nombres de artistas con espacios a través de la línea de comandos, debes proporcionarlos entre comillas. Ejemplo: -a "john doe,john smith"

(volver al inicio)

Uso avanzado

Personalizar el comportamiento usando el archivo .cfg

• En el archivo bopscrk.cfg puedes especificar tus propios conjuntos de caracteres y habilitar/deshabilitar opciones:

  • extra_combinations (como (john, doe) => 123john, john123, 123doe, doe123, john123doe doe123john) están habilitadas por defecto. Puedes deshabilitarlas en el archivo de configuración para obtener listas de palabras más enfocadas.
  • separators_chars: caracteres a usar en combinaciones adicionales. Puede ser un solo carácter o una cadena de caracteres, ej.: !?-/&(
  • separators_strings: cadenas a usar en combinaciones adicionales. Puede ser una sola cadena o una lista de cadenas separadas por espacios, ej.: 123 34!@
  • leet_charset: caracteres a reemplazar y sustituto correspondiente en transformaciones leet, ej.: e:3 b:8 t:7 a:4
  • recursive_leet: habilita una llamada recursiva a la función leet_transforms() para obtener todas las transformaciones leet posibles. ADVERTENCIA: habilitada con valores grandes de --max (ej.: mayor a 18) podría tomar mucho tiempo. Puede ser true o false.
  • extensive_case: por defecto, bopscrk solo aplica las transformaciones de mayúsculas/minúsculas más comunes: todos los caracteres a minúscula, todos a mayúscula, cada carácter a mayúscula, todos los pares a mayúscula, todos los impares a mayúscula, todas las consonantes a mayúscula y todas las vocales a mayúscula. Puedes habilitar esta opción para obtener TODAS las transformaciones posibles, lo que puede resultar en listas de palabras mucho más grandes, pero podría ser útil en algunos escenarios.

(volver al inicio)

Lyricpass

Esta función se basa en una versión modificada de una herramienta desarrollada originalmente por initstring. Los cambios se realizan para integrar la entrada y salida de la herramienta con bopscrk.

Recuperará todas las letras de todas las canciones que pertenecen a los artistas que proporciones. Por defecto almacenará cada artista, cada frase encontrada con sustitución de espacios, cada frase encontrada reducida a sus iniciales (que se transformarán más tarde si has activado las transformaciones leet y de mayúsculas/minúsculas).

(volver al inicio)

Hoja de ruta

• Mejorar la gestión de memoria
  • Escribir listas de palabras en el sistema de archivos durante la ejecución y usarlas como caché (#12)
• Mejorar el rendimiento
  • Mejorar la lógica de paralelismo
• Funciones adicionales
  • Implementar barra de progreso para mantener al usuario informado del estado de ejecución
  • Implementar archivo de sesión para mantener un registro del punto de ejecución y poder detener y reanudar sesiones (#12)
  • Crear opciones de configuración para transformaciones de mayúsculas/minúsculas personalizadas (ej.: deshabilitar transformaciones pares/impares)
  • Implementar salida "pipeable" para permitir la integración con otras herramientas (la bandera -q simplemente mostrará la lista final de palabras en stdout)

Consulta los problemas abiertos para una lista completa de las funciones propuestas (y problemas conocidos).

(volver al inicio)

Contribuir

Las contribuciones son lo que hace que la comunidad de código abierto sea un lugar tan increíble para aprender, inspirar y crear. Cualquier contribución que hagas será muy apreciada.

Si tienes una sugerencia que pueda mejorar esto, haz un fork del repositorio y crea una pull request. También puedes simplemente abrir un issue con la etiqueta "enhancement". ¡No olvides darle una estrella al proyecto! ¡Gracias de nuevo!

1. Haz un Fork del Proyecto
2. Crea tu Rama de Característica (git checkout -b feature/CaracteristicaIncreible)
3. Haz Commit de tus Cambios (git commit -m 'Añadir alguna CaracteristicaIncreible')
4. Sube a la Rama (git push origin feature/CaracteristicaIncreible)
5. Abre una Pull Request

Colaboradores

• noraj contribuyó abriendo varios issues y pull requests que han permitido corregir algunos errores importantes. También gestionó por su cuenta la adición de la herramienta en los repositorios de BlackArch y RawSec, lo que ha aumentado su popularidad y uso.
• nylocx y agoertz-fls contribuyeron añadiendo soporte para Python 3.
• glozanoa y fabaff contribuyeron añadiendo el comando bopscrk (mejoras en setup.py).

¡Gracias a todos!

(volver al inicio)

Lista de cambios

• Notas de la versión 2.4.7 (02/09/2024)

  • Mejora de la lógica de transformación de mayúsculas/minúsculas (ahora respeta las mayúsculas/minúsculas de la palabra original)
  • Inclusión de nuevas operaciones básicas de transformación de mayúsculas/minúsculas
  • Implementación del modo de transformación extensiva de mayúsculas/minúsculas
  • Corrección de errores tipográficos

• Notas de la versión 2.4.6 (30/08/2024)

  • Aumento del rendimiento del paralelismo (implementación real de multiprocesamiento)
  • Mejor manejo de errores del analizador de configuración
  • Corrección de errores tipográficos

• Notas de la versión 2.4.5 (02/08/2022)

  • Barra de progreso implementada y funcionando
  • Argumento version incluido
  • Documentación mejorada

• Notas de la versión 2.4.4 (31/07/2022)

  • Error de importaciones relativas corregido
  • Comienzo de la refactorización de la estructura general para permitir la inclusión de la función de barra de progreso

• Notas de la versión 2.4.3 (28/07/2022)

  • Corrección de la estructura del proyecto para permitir una instalación adecuada mediante pip:
    • Se añadió MANIFEST para excluir archivos compilados y de prueba al construir la distribución

(volver al inicio)

Licencia

Distribuido bajo la Licencia Pública General de GNU v3.0. Consulte LICENSE para más información.

(volver al inicio)

Contacto

r3nt0n: Github - correo electrónico
bopscrk: Github - Pypi

(volver al inicio)

Agradecimientos

• El módulo lyricpass se basa en un proyecto creado por initstring.
• Fuente Pixel Gothic de Kajetan Andrzejak.
• Best-README-Template por othneildrew.

(volver al inicio)

Aviso legal

Esta herramienta se crea con el único propósito de concienciación y educación en seguridad, no debe ser utilizada contra sistemas para los que no tengas permiso para probar/atacar. El autor no es responsable por el mal uso o por cualquier daño que puedas causar. Aceptas que usas este software bajo tu propio riesgo.

(volver al inicio)