bopscrk

目次

1. プロジェクトについて
   • 新機能
   • 使用技術
2. はじめに
   • インストール
   • インタラクティブモードの実行
3. 使い方
   • 動作の仕組み
   • ヒント
   • 高度な使い方
   • Lyricpass
4. ロードマップ
5. コントリビューション
   • コントリビューター
6. 変更履歴
7. ライセンス
8. 連絡先
9. 謝辞
10. 法的免責事項

プロジェクトについて

• 標的型攻撃用ワードリスト作成ツール: 標的に関する個人情報を入力し、すべての単語を組み合わせ、結果をパスワードの候補に変換します。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: アーティスト名のスペースを、文字セットで定義された文字/文字列に置き換え
  • lyric_space_replacement: 見つかった歌詞でも同様
  • space_replacement_chars: アーティスト名や歌詞フレーズ内のスペースの代わりに挿入する文字。単一の文字または文字列（例: !?-/&(）を指定可能
  • space_replacement_strings: アーティスト名や歌詞フレーズ内のスペースの代わりに挿入する文字列。単一の文字列またはスペース区切りの文字列リスト（例: 123 34!@）を指定可能

• パラメータ設定例

  • すべての単語をドット区切りで組み合わせ、同様にカンマ区切りでも組み合わせる
    separators_chars=.,
  • すべての "a/A" を "4" に、すべての "e/E" を "3" に変換
    leet_charset=a:4 e:3

(トップに戻る)

Lyricpass

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