andreiverse/gorillaИнструмент для генерации wordlist'ов или расширения существующего списка с помощью мутаций.
gorilla — это идеальный инструмент для работы со словарями, объединяющий множество замечательных возможностей:
Если у вас установлен Cargo (Rust), выполните cargo install --git https://github.com/d4rckh/gorilla --branch main
Теперь вы можете запускать gorilla --help
cargo build --release
# бинарный файл будет находиться в папке target/release
Аргумент --from-pattern/-p используется для того, чтобы указать gorilla вычислять пароли на основе шаблона.
Например, следующая команда выведет каждое слово, состоящее из 5 строчных букв.
gorilla --from-pattern "{a-z}{a-z}{a-z}{a-z}{a-z}"
Другие примеры шаблонов: administrator{0-9} (administrator0 -> administrator9); hello_world{a-z}{0-9} (hello_worlda0 -> hello_worldz9).
Если вы хотите сохранить вывод в файл, используйте аргумент --output-file/-o.
Теперь gorilla также поддерживает наборы символов. Они определены в src/char_sets.rs. Вот несколько примеров шаблонов, использующих их: {l} => a b c d ... z; {u} => A B C D ... Z; {d} => 1 2 3 4 ... 9; {s} => (пробел) ! " # $ ... ~. Вы можете комбинировать несколько наборов, например {luds} даст набор символов, содержащий все остальные описанные наборы (#45).
Если вы используете диапазон, и каждый его конец состоит из 1 символа, то это будет диапазон символов. Например:
{a-z} добавит каждый символ алфавита по одному: a, b, c, d, e, f, g,...., x, y и z;{a-c} добавит только a, b и c по одному;{0-9} добавит только 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, по одному.
Если вы используете диапазон, и один из концов содержит более 1 символа, каждый конец будет интерпретирован как 32-битное число без знака, и вместо этого получится диапазон чисел. Например:{2020-2026} добавит 2020, 2021, 2022, 2023, 2024, 2025 и 2026 по одному.{1-100} добавит числа от 1 до 100 (включительно) по одному.Экспериментально: если внутри ваших фигурных скобок есть запятая, строка будет разделена по ней, и каждая часть будет добавлена по одной, например, {Jan,Feb,Mar} добавит Jan, Feb и Mar по одному.
При желании вы можете запустить несколько потоков для шаблонов с помощью параметра --pattern-threads. Я рекомендую устанавливать его равным максимальному количеству потоков, доступных на вашем компьютере.
С помощью аргументов командной строки вы можете выполнять любые поддерживаемые мутации, но ограничены только 1 набором мутаций. Набор мутаций — это множество мутаций, применяемых к слову. Через CLI мутации передаются с помощью аргумента --mutation/-m.
gorilla --from-pattern "administrator" --mutation "prepend:_"
Обычно в этом случае вы захотите использовать аргумент --from-file/-i вместо --from-pattern, чтобы указать словарь, а не одно слово, но для простоты я использую его.
Приведённая выше команда принимает 1 слово и выводит 1 слово: _administrator. Вы можете добавить несколько мутаций, используя тот же параметр.
gorilla --from-pattern "administrator" \
-m "prepend:_" \
-m "append:{0-9}"
Здесь снова берётся 1 слово, но выводится 10 различных. Добавление синтаксиса {0-9} к prepend и append приведёт к генерации нескольких слов. Приведённая выше команда генерирует следующие слова.
_administrator0
_administrator1
_administrator2
[.. snip ..]
_administrator8
_administrator9
Если бы мы передали словарь через файл -i, мы получили бы количество слов из словаря, умноженное на 10.
Пока мы применяли только 1 единственный набор мутаций. Обычно вам потребуется комбинировать несколько таких наборов. Это делается с помощью yaml-файлов. Вы указываете его через аргумент --mutations-file/-f. Пример такого файла находится в sets/simple.yml в этом репозитории и выглядит так:
name: simple
mutation_sets:
- [ nothing ] # => word
- [ reverse ] # => drow
- [ remove_last_letter ] # => wor
- [ remove_first_letter ] # => ord
- [ uppercase_all ] # => WORD
- [ "append:{0-9}" ] # => word1, word2, word3
- [ "2 append:{0-9}" ] # => word11, word22, word33
- [ "replace:o:0", "replace:a:4", "replace:e:3" ] # => w0rd, h3ll0
Каждый файл мутаций должен содержать значения name и mutation_sets, как показано в примере. Приведённые выше наборы мутаций создадут из одного слова ещё 27 слов.
administrator
administrator
rotartsinimda
administrato
dministrator
ADMINISTRATOR
administrator0
[.. snip ..]
administrator9
administrator00
[.. snip ..]
administrator99
4dministr4t0r
Если вы хотите проверить файл мутаций на ошибки перед использованием, вы можете воспользоваться следующим синтаксисом для разбора и вывода сводки.
gorilla --mutations-file muts.yml
(Пока что) вы можете извлекать слова только с конкретной страницы. Теги стилей и скриптов автоматически удаляются.
Вы можете указать страницу с помощью аргумента --from-website/-w. Например
gorilla --from-website https://example.org/
Приведённая выше команда выведет каждое слово с этого сайта. Вы можете добавить другие аргументы, показанные ранее, например --mutations-file/-f, --mutation/-m и, конечно, --output-file/-o, чтобы сохранить их (вместо вывода на экран).
Вы можете применить набор мутаций только к тем словам, которые соответствуют определённым условиям. Это имеет смысл только в yaml-файлах.
Следующий файл мутаций удалит слова, которые не содержат строку admin. В отличие от предыдущих мутаций, эта может удалять слова.
name: filtering_words
mutation_sets:
- [ "if_contains:admin" ]
Другой пример — добавление подчёркивания только к словам, длина которых больше 5 символов.
name: conditional_mutation
mutation_sets:
- [ "if_length:>5", "append:_" ],
- [ "! if_length:>5" ]
Обратите внимание, что нам пришлось добавить ещё один набор мутаций, начинающийся с отрицательной версии первой if-мутации, иначе слова короче 6 символов будут удалены.
gorilla поддерживает множество других мутаций, и, поскольку инструмент находится на ранней стадии разработки, поддерживать их список здесь было бы очень утомительно. Если вам интересны другие мутации, вы можете посмотреть перечисление Action в файле src/mutation.rs.
Форматы определяются в форматирующих наборах через yaml-файлы и передаются gorilla с помощью аргумента --from-formatting/-q. Сейчас создан только один форматирующий набор, он находится в sets/formatting/basic_usernames.yml. Выглядит он (примерно) так.
name: basic_usernames
fields:
- [ f_name ]
- [ l_name ]
formatting_sets:
- [ "{f_name}_{l_name}" ]
- [ "{l_name}{f_name}" ]
- [ ["{f_name}", [1st_letter]], "_{l_name}" ]
- [ ["{f_name}", [1st_letter]], "{l_name}" ]
Обязательные поля: name, fields и formatting_sets. Значение fields — это профиль пользователя, содержащий информацию, которая затем используется в formatting_sets.
Если вы запустите набор, у вас запросят каждое поле, и будут сгенерированы имена пользователей.
примечание: не делайте мутации внутри форматирующих наборов слишком сложными, все они выполняются в одном потоке! Объединяйте форматирующий файл с файлом мутаций, чтобы выполнять мутации параллельно. Не используйте комбинаторные шаблоны внутри наборов мутаций форматирующих наборов.
совет: вы можете использовать другие аргументы обычным образом, например
--mutations-file/-fдля генерации новых слов через мутации или--output-file/-oдля сохранения слов
Каждый форматирующий набор — это массив строк, которые затем объединяются. Так что ["{f_name}", "{l_name}"] эквивалентно ["{f_name}{l_name}"]. Вместо строки можно указать массив — это позволяет применять мутации, которые вы использовали ранее для расширения словарей.
- [ "{f_name}_", [ "{l_name}", [ reverse ] ] ]
Если f_name — это joe, а l_name — doe, то в результате форматирования будет сгенерировано joe_eod. Полезные мутации в форматирующих наборах: remove_last_letter, remove_first_letter и 1st_letter.
Если вы хотите применить форматирующие наборы ко многим профилям пользователей, вы можете использовать аргумент --with-csv/-c для указания CSV-файла. Для форматирующего набора basic_usernames CSV должен выглядеть так:
f_name,l_name
joe,doe
james,smith
robert,smith
>NUMBER/<NUMBER/=NUMBER)