プロジェクトについて

標的型攻撃用ワードリスト作成ツール: 標的に関する個人情報を入力し、すべての単語を組み合わせ、結果をパスワードの候補に変換します。lyricpass モジュールを使用すると、アーティストに関連する歌詞を検索し、それらをワードリストに含めることができます。
カスタマイズ可能な大文字小文字変換とleet変換: シンプルな設定ファイルを通じて、カスタム文字セットや変換パターンを作成できます。
インタラクティブモードとワンラインコマンドインターフェースに対応。
BlackArch Linux ペネトレーションテストディストリビューションおよび Rawsec's Cybersecurity Inventory に2019年8月から収録されています。

使用技術

Python 3（サブブランチは Python 2.7 のレガシーサポートを維持）
- requests
- alive-progress

新機能

2.4.7 リリース (2024/09/02): 速度とパフォーマンスが大幅に向上。新しい拡張ケース変換モードにより、考えられるすべての大文字小文字のバリエーションを生成可能になりました。

(トップに戻る)

はじめに

インストール

pip install bopscrk

または、Pypi からインストールする代わりに Github からリポジトリをクローンする場合:

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

インタラクティブモードの実行

bopscrk -i

(トップに戻る)

使い方


  -h, --help         このヘルプメッセージを表示して終了
  -i, --interactive  インタラクティブモード。スクリプトが標的について質問します
  -w                 組み合わせる単語をカンマ区切りで指定（非対話モード）
  --min              生成する単語の最小長（デフォルト: 4）
  --max              生成する単語の最大長（デフォルト: 32）
  -c, --case         大文字小文字変換を有効化
  -l, --leet         leet変換を有効化
  -n                 一度に組み合わせる最大単語数（デフォルト: 2）
  -a , --artists     歌詞を検索するアーティスト（カンマ区切り）
  -o , --output      ワードリストを保存する出力ファイル（デフォルト: tmp.txt）
  -C , --config      使用する設定ファイルを指定（デフォルト: ./bopscrk.cfg）
  --version          バージョンを表示して終了

詳細については、高度な使い方のセクションを参照してください。

(トップに戻る)

動作の仕組み

提供する必要があるのは、ベースとなる単語です。
lyricpass機能を使用すると、アーティストを指定できます。ツールはそのアーティストのすべての曲の歌詞をダウンロードし、各行を新しい単語として追加します。デフォルトでは、アーティスト名と、各フレーズの頭文字からなる単語も追加されます。
ツールは、それらの間のすべての可能な組み合わせを生成します。
さらに多くの組み合わせを生成するために、パスワードでよく使われる一般的な区切り文字（例: "-", "_", "."）、数字、特殊文字を追加します。
leet変換や大文字小文字変換を使用して、成功率を高めることができます。

//: # (+ 除外用ワードリストを指定して、既に標的に対してテスト済みのワードを結果から除外できます (-x)。)

ヒント

フィールドは空欄のままでも構いません。
単語内でアクセント記号や特殊文字を使用できます（非対話モードの場合、' や " などの特殊文字はバックスラッシュでエスケープしてください。例: bopscrk -w John,O\'hara,Doe,foo,bar）。
その他のフィールドには、カンマ区切りで複数の単語を記述できます。例: 2C,Flipper。
すべての可能なleet変換を生成したい場合は、設定ファイルで recursive_leet オプションを有効にしてください。
すべての可能な大文字小文字変換を生成したい場合は、設定ファイルで extensive_case オプションを有効にしてください。
cfgファイルを通じて、見つかった歌詞のフレーズに適用する変換を選択できます。
非対話モードを使用する場合、インタラクティブモードと同じ結果を得るには、年を長い形式と短い形式（1970,70）の両方で指定する必要があります。
-n 引数には注意が必要です。大きな値を設定すると、ワードリストが非常に大きくなる可能性があります。2～5 の値を推奨します。
コマンドラインで複数のアーティスト名を指定する場合は、カンマ区切りで指定します。例: -a johndoe,johnsmith
コマンドラインでスペースを含むアーティスト名を指定する場合は、引用符で囲んで指定します。例: -a "john doe,john smith"

(トップに戻る)

高度な使い方

.cfg ファイルを使用した動作のカスタマイズ

bopscrk.cfg ファイルでは、独自の文字セットを指定し、オプションを有効/無効にできます:
- extra_combinations（(john, doe) => 123john, john123, 123doe, doe123, john123doe doe123john など）はデフォルトで有効です。設定ファイルで無効にすると、より焦点を絞ったワードリストを生成できます。
- separators_chars: 追加の組み合わせで使用する文字。単一の文字または文字列（例: !?-/&(）を指定可能
- separators_strings: 追加の組み合わせで使用する文字列。単一の文字列またはスペース区切りの文字列リスト（例: 123 34!@）を指定可能
- leet_charset: leet変換で置き換える文字とその代替文字。例: e:3 b:8 t:7 a:4
- recursive_leet: leet_transforms() 関数を再帰的に呼び出して、すべての可能なleet変換を取得できるようにします。警告: 大きな --max 値（例: 18 より大きい）と組み合わせると、処理に長い時間がかかる可能性があります。true または false を指定可能
- extensive_case: デフォルトでは、bopscrk はより一般的なケース変換のみを適用します: すべて小文字、すべて大文字、各単語の先頭大文字、すべての偶数番目大文字、すべての奇数番目大文字、すべての子音大文字、すべての母音大文字。このオプションを有効にすると、考えられるすべてのケース変換を生成でき、ワードリストは大幅に大きくなりますが、シナリオによっては有用かもしれません。true または false を指定可能
- remove_parenthesis: 見つかった歌詞から変換前にすべての括弧を削除
- take_initials: 見つかった歌詞のフレーズの各単語の頭文字から単語を生成（remove_parenthesis が無効の場合、無意味な単語が生成される可能性があります）
- artist_split_by_word: アーティスト名を単語ごとに分割し、それぞれを新しい単語として追加
- lyric_split_by_word: 見つかった歌詞でも同様
- artist_space_replacement: アーティスト名のスペースを、文字セットで定義された文字/文字列に置き換え

(トップに戻る)

Lyricpass

この機能は、initstring が元々開発したツールの修正版に基づいています。変更点は、入出力を bopscrk と統合するためのものです。

指定したアーティストの全曲の歌詞を取得します。デフォルトでは、各アーティスト、スペース置換後の各フレーズ、各フレーズの頭文字に短縮したものが保存されます（leet変換やケース変換を有効にしている場合、後で変換されます）。

(トップに戻る)

ロードマップ

メモリ管理の改善
- 実行中にワードリストをファイルシステムに書き込み、キャッシュとして使用 (#12)
パフォーマンスの改善
- 並列処理ロジックの改善
追加機能
- ユーザーに実行状況を知らせるプログレスバーの実装
- セッションファイルの実装により、実行ポイントを追跡し、セッションの停止と再開を可能にする (#12)
- カスタマイズされたケース変換のための設定オプションを作成（例: 偶数/奇数変換の無効化）
- 他のツールとの統合を可能にする出力の「パイプ対応」実装（-q フラグで最終ワードリストを標準出力にのみ出力）

提案された機能の完全なリスト（および既知の問題）については、公開されているイシューを参照してください。

(トップに戻る)

コントリビューション

コントリビューションこそが、オープンソースコミュニティを学び、インスパイアし、創造するための素晴らしい場にしています。あなたのご協力を大いに感謝します。

このプロジェクトをより良くするための提案がある場合は、リポジトリをフォークしてプルリクエストを作成してください。また、単に「enhancement」タグを付けてイシューを開くこともできます。プロジェクトにスターを付けるのもお忘れなく！ありがとうございます！

プロジェクトをフォーク
機能ブランチを作成 (git checkout -b feature/AmazingFeature)
変更をコミット (git commit -m 'Add some AmazingFeature')
ブランチにプッシュ (git push origin feature/AmazingFeature)
プルリクエストを開く

コントリビューター

noraj は、いくつかの重要なバグを修正するためのイシューやプルリクエストを開き、貢献しました。また、BlackArch と RawSec のリポジトリへのツール追加を自ら管理し、その人気と使用を促進しました。
nylocx と agoertz-fls は Python3 サポートの追加に貢献しました。
glozanoa と fabaff は bopscrk コマンドの追加（setup.py の改善）に貢献しました。

皆さん、ありがとうございます！

(トップに戻る)

変更履歴

//: # (+ 最終開発バージョン (Github で入手可能))

2.4.7 バージョン情報 (2024/09/02)
- ケース変換ロジックの改善（元の単語の大文字小文字を尊重するようになりました）
- 新しい基本ケース変換操作の追加
- 拡張ケース変換モードの実装
- タイポ修正
2.4.6 バージョン情報 (2024/08/30)
- 並列処理のパフォーマンス向上（真のマルチプロセッシング実装）
- 設定パーサーエラーのより良い処理
- タイポ修正
2.4.5 バージョン情報 (2022/08/02)
- プログレスバーの実装と動作確認
- version 引数を追加
- ドキュメントの改善
2.4.4 バージョン情報 (2022/07/31)
- 相対インポートのバグを修正
- プログレスバー機能の組み込みを可能にするための一般的な構造のリファクタリング開始
2.4.3 バージョン情報 (2022/07/28)
- pip 経由での正しいインストールを可能にするためにプロジェクト構造を修正:
  - MANIFEST を追加して、ビルド時にコンパイル済みファイルとテストファイルを除外
  - 構造を改善し、すべてのファイルを親ディレクトリ内の Python パッケージディレクトリに適切にコピー
  - 設定ファイルへの相対パスを修正
- 誤った設定ファイルが提供された場合の例外をキャッチして通知し終了
2.4 バージョン情報 (2022/07/26)
- pip install 方式を有効にしてインストールプロセスを簡素化