プロジェクトについて

標的型攻撃ワードリスト作成者: ターゲットに関連する個人情報を導入し、すべての単語を組み合わせて、結果をパスワード候補に変換します。 Lyricpassモジュールを使用すると、アーティストに関連する歌詞を検索し、単語リストに含めることができます。
カスタマイズ可能な case変換とleet 変換: 単純な構成ファイルを通じてカスタム文字セットと変換パターンを作成します。
対話型モードと1 行のコマンドインターフェイスがサポートされています。
2019 年 8 月以降、 BlackArch Linux侵入テストディストリビューションとRawsec のサイバーセキュリティインベントリに含まれています。

で構築

Python 3 (セカンダリブランチは Python 2.7 レガシーサポートを維持します)
- リクエスト
- 生きた進歩

はじめる

インストール

 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         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

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

(トップに戻る)

仕組み

基礎となる言葉をいくつか提供する必要があります。
リリックパス機能でアーティストを紹介できます。このツールは彼の曲のすべての歌詞をダウンロードし、各行が新しい単語として追加されます。デフォルトでは、アーティスト名と各フレーズの単語の頭文字からなる単語も追加されます。
このツールは、それらの間で可能なすべての組み合わせを生成します。
さらに多くの組み合わせを生成するには、一般的な区切り文字(「-」、「_」、「.」など)、数字、およびパスワードで頻繁に使用される特殊文字を追加します。
leet 変換とcase 変換を使用してチャンスを増やすことができます。

ヒント

フィールドは空のままにすることができます。
単語内でアクセントや特殊文字を使用できます(非対話モードを使用する場合は、 'や"などの特殊文字をバックスラッシュでエスケープします。例: bopscrk -w John,O'hara,Doe,foo,bar )。
「その他」フィールドには、複数の単語をカンマで区切って書くことができます。例：2C、フリッパー。
考えられるすべての leet 変換を生成したい場合は、構成ファイルでrecursive_leet オプションを有効にします。
考えられるすべての大文字と小文字の変換を生成したい場合は、構成ファイルでextend_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 を超える) で有効にすると、長い時間がかかる可能性があります。真でも偽でも構いません。
- extend_case : デフォルトでは、 bopscrk はより一般的な大文字小文字変換のみを適用します。つまり、すべての文字を下位に、すべての文字を上位に、各文字を上位に、すべてのペアを上位に、すべての奇数を上位に、すべての子音を上位に、すべての母音を上位に適用します。このオプションを有効にすると、考えられるすべての大文字と小文字の変換を取得できます。これにより、単語リストが大幅に大きくなる可能性がありますが、シナリオによっては役立つ場合があります。真でも偽でも構いません。
- 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

(トップに戻る)

リリックパス

この機能は、initstring によって元々開発されたツールの修正バージョンに基づいています。この変更は、入力および出力のツールを bopscrk と統合するために行われます。

あなたが提供したアーティストに属するすべての曲からすべての歌詞を取得します。デフォルトでは、各アーティスト、スペース置換で見つかった各フレーズ、イニシャルに縮小された各フレーズが保存されます(leet 変換と case 変換を有効にしている場合は、後で変換されます)。

(トップに戻る)

ロードマップ

メモリ管理を改善する
- 実行中にワードリストをファイルシステムに書き込み、キャッシュとして使用します (#12)
パフォーマンスの向上
- 並列処理ロジックを改善する
追加機能
- ユーザーに実行状態を知らせるためのプログレスバーを実装する
- 実行ポイントを追跡し、セッションを停止および再開できるようにするセッションファイルを実装します (#12)
- カスタマイズされたケース変換の構成オプションを作成します (例: ペア/奇数変換を無効にする)
- 他のツールとの統合を可能にするために「pipable」出力を実装します ( -qフラグは最終的なワードリストを stdout に出力するだけです)

提案された機能 (および既知の問題) の完全なリストについては、未解決の問題を参照してください。

(トップに戻る)

貢献する

オープンソースコミュニティは、貢献によって、学び、インスピレーションを与え、創造するための素晴らしい場所になります。皆様の貢献は大変感謝しております。

これを改善するための提案がある場合は、リポジトリをフォークしてプルリクエストを作成してください。「拡張」タグを付けて問題を開くこともできます。プロジェクトにスターを付けることを忘れないでください。再度、感謝します！

プロジェクトをフォークする
機能ブランチを作成します ( 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 の改善)

皆さんありがとうございました！

(トップに戻る)

変更リスト

2.4.7 version notes (02/09/2024)
- 大文字と小文字の変換ロジックを改善しました (元の単語の大文字と小文字が区別されるようになりました)
- 新しい基本的なケース変換操作を含む
- 拡張ケース変換モードの実装
- タイプミスを修正する
2.4.6 version notes (30/08/2024)
- 並列処理パフォーマンスの向上(実際のマルチプロセッシングの実装)
- 構成パーサーエラーの処理の改善
- タイプミスを修正する
2.4.5 version notes (02/08/2022)
- プログレスバーが実装され、機能しています
- version引数が含まれています
- ドキュメントが改善されました
2.4.4 version notes (31/07/2022)
- 相対インポートのバグが修正されました
- プログレスバー機能を含めることができるように一般的な構造のリファクタリングを開始します
2.4.3 version notes (28/07/2022)
- pip 経由で適切にインストールできるようにプロジェクト構造を修正します。
  - dist をビルドするときにコンパイル済みファイルとテストファイルを除外するために MANIFEST を追加します
  - すべての構造を親ディレクトリ内の Python パッケージディレクトリに適切にコピーするように構造を改善しました。
  - 設定ファイルへの相対パスを修正する
- 間違った構成ファイルが提供された場合に例外をキャッチします (通知して終了)
2.4 version notes (26/07/2022)
- pip install方法を有効にしてインストールプロセスを簡単にします
- より優れたメモリ管理 (キャッシュされたワードリストの I/O ファイルの書き込みと読み取り) の実装を開始していますが、まだ機能していません
- 依存関係に関連する軽微なバグの更新と修正
- 削除された機能: 「他の単語リストから除外」は役に立たないようです。この特定の作業を行うための他のツールがあります
2.3.1 version notes
- Windows システムで実行する場合の名前空間のバグ (aux.py モジュールに関連し、auxiliars.py に名前変更) を修正しました。
- Unittest (および変換、除外、結合関数の単純な単体テスト)が実装されました。
2.3 version notes (15/10/2020)
- cfg ファイルを使用したアーティストと歌詞変換のカスタマイズ可能な構成
- setup.py の要件が更新されました
- マルチスレッドロジックの改善
- リートとケースの順序を逆にして業務効率を向上
- 歌詞スペース置換のバグを修正しました
- 重複を削除するときのバグが修正されました(タイプエラー: ハッシュ不可能なタイプ: 'list' )
- メモリ管理と効率の向上
- モジュールに分割してプロジェクト構造を改善する
- ワードリスト除外機能のバグを修正しました
2.2 version notes (11/10/2020
- 設定ファイルの実装
- 新機能:設定ファイルを通じてカスタム文字セットと変換パターンを作成できるようにします
- 新機能:再帰的 leet 変換が実装されました (デフォルトでは無効になっていますが、cfg ファイルで有効にできます)
2.2~beta version notes (10/10/2020)
- Lyricpass統合は、initstring によってリリースされた最後のバージョンで実行できるように更新されました。
- --lyrics-allオプションが削除されました (他のオプションに統合された機能)
2.1 version notes (11/07/2020)
- 最小長と最大長のバグを修正
2.0/1.5 version notes (17/06/2020)
- Python 3 がサポートされるようになりました: マスターブランチは Python 3 に移行します。セカンダリブランチは Python 2.7 レガシーサポートを維持します
0-1.2(beta) version notes
- EXCLUDE WORDLISTS : マルチスレッドの除外を使用した速度の向上
- 新機能: アーティストに関連した歌詞検索により、ワードリストの可能性が増加します。