Some-Tools

Управляйте всеми своими инструментами для пентеста в одном месте и поддерживайте их в актуальном состоянии одной командой 😎

Цель sometools — управлять всеми инструментами, которые не включены в Kali или для которых sudo apt install недоступен. Sometools лучше работает, если инструменты представляют собой репозитории, но его можно настроить для работы и без этого.

Зачем

Я искал способ управлять и поддерживать в актуальном состоянии некоторые инструменты, которые не включены в Kali-Linux. Например, я искал простой способ управления скриптами для повышения привилегий. Однажды я увидел sec-tools от eugenekolo (которые вы можете увидеть внизу страницы), и это дало мне мотивацию немедленно начать работу над своим проектом. Моей главной мотивацией была команда check-update-all, которая позволяет плавно обновлять все установленные инструменты.

Но имейте в виду, что это отличается. Я создал это для людей, работающих с Kali. Должно работать и на других дистрибутивах, но я не включил такие инструменты, как Burp Suite или SQLmap, потому что они поставляются с Kali по умолчанию.

Installation```bash

$ git clone https://github.com/som3canadian/Some-Tools $ cd Some-Tools $ ./sometools.sh setup

after setup, open new terminal or tab

$ ./sometools.sh list

you can look in your .zshrc or .bashrc if you are not sure that the installation worked.

For more info see Actions Detailed section.

## Базовое использование

![Справка Some-Tools](https://assets.kitploit.com/production/public/readmes/3722/2c2f36aa97f4f3058a778becd79c98e26fdedb749e9f2297f3faf2552487e322.png)

**Примечание**: Нет необходимости указывать названия категорий при использовании инструмента. Просто используйте имя инструмента или ID. Вы можете увидеть ID инструмента, выполнив `./sometools.sh list`

Наиболее часто используемые действия:

- list
- install
- check-update-all
- git-search
- self-update```bash
# Inital setup. Should be the first command
$ ./sometools.sh setup
# List all available tools
$ ./sometools.sh list
# List all available tools of a category
$ ./sometools.sh list-cat Utilities
# List install tool(s)
$ ./sometools.sh list-installed
# List installed tools accessible from anywhere on your machine
$ ./sometool.sh list-bin
# Install a tool
$ ./sometools.sh install unicorn
# Using ID instead of tool name
$ ./sometools.sh install 4
# Install all tools of a Category
$ ./sometools.sh install-cat PrivEsc-Win
# Install All tools
$ ./sometools.sh install all
# Check update for all installed tools
# check-update-all command is the main reason why I made this
$ ./sometools.sh check-update-all
# Check for update
$ ./sometools.sh check-update PEAS
# Using ID instead of tool name
$ ./sometools.sh check-update 9
# Search for a tool on github
$ ./sometools.sh git-search LinEnum
# Search for a PoC in the PoC-in-GitHub tool
$ ./sometools.sh search-poc
# Show README.md of an installed tool
$ ./sometools.sh info unicorn
# Using ID instead of tool name
$ ./sometools.sh info 4
# Add a new tool
$ ./sometools.sh add-tool newtoolname PrivEsc-Lin
# Uninstall a tool
$ ./sometools.sh uninstall unicorn
# Using ID instead of tool name
$ ./sometools.sh uninstall 4
# Unistall all tools of a Category
$ ./sometools.sh uninstall-cat PrivEsc-Win
# Update some-tools
$ ./sometools.sh self-update
# Delete all installed tools, remove bin directory and delete our modification in .zshrc or .bashrc
$ ./sometools.sh complete-uninstall

The Bin directory

• Каталог bin будет создан при выполнении действия setup. Это будет путь к каталогу, который мы добавим в переменную $PATH вашей оболочки (your/install/dir/Some-Tools/bin). В каталог bin мы поместим копию (симлинк) инструментов, которые хотим сделать исполняемыми отовсюду на нашей машине. Например, для такого инструмента, как unicorn.py, вы можете захотеть выполнять unicorn из любого места.

• Действие setup также создаст каталоги bin/PrivEsc-Lin и bin/PrivEsc-Win в процессе. В этих каталогах мы будем хранить наши скрипты для повышения привилегий. Таким образом, когда вы захотите использовать свои инструменты, вы можете запустить python http сервер и быстро загрузить нужные скрипты. Скрипты в этих папках будут обновляться одновременно с обновлением инструментов с помощью действия check-update.

Tools List

Summary

• 59 Tools

Note:

• PEAS включает скрипты linPEAS и winPEAS
• BeRoot включает скрипты для Linux и Windows

Actions Detailed

• setup (Процесс настройки):

  • Это должна быть первая команда, которую вы запускаете.
  • Сначала он спросит, какую оболочку вы хотите использовать между .bashrc или .zshrc (встроенное действие setup не будет работать, если вы не используете одну из двух оболочек)
  • Скрипт установит переменную $SOME_ROOT
  • После настройки вы можете открыть новые вкладки/окна терминала или выполнить source вашей оболочки (.bashrc или .zshrc) в текущем терминале, чтобы активировать новый путь. Чтобы увидеть новый путь, выполните echo $PATH
  • В вашем файле оболочки (.bashrc или .zshrc) мы скопируем ваш $PATH перед внесением изменений. Он будет закомментирован за несколько строк до конца вашего файла оболочки. Поэтому, если вы хотите сбросить путь до настройки Some-Tools, вы можете скопировать команду, закомментированную в вашем файле оболочки, очистить то, что мы создали в файле, и, наконец, выполнить source.
  • Создание каталога Bin. (bin, bin/PrivEsc-Lin и bin/PrivEsc-Win)
  • Вы можете прочитать раздел setup в sometools.sh для лучшего понимания. ```bash $ ./sometools.sh setup
  root@kitploit:~

• install и install-all:

  • Установить один инструмент или все инструменты.
  • Если вы устанавливаете только один инструмент, вместо имени инструмента вы можете использовать его ID номер, который показывается при выполнении ./sometools.sh list.
  • Когда вы устанавливаете инструмент, будет создан файл .installed в каталоге инструмента. Этот файл поможет нам с действием list-installed. ```bash $ ./sometools.sh list # see which tool can be install

• search-poc
  • Поиск PoC в инструменте PoC-in-GitHub
  • Чтобы использовать эту функцию, инструмент PoC-in-GitHub должен быть установлен. ```bash $ ./sometools.sh search-poc
  root@kitploit:~

• self-update:

  • Эта функция помогает поддерживать этот инструмент (Some-Tools) в актуальном состоянии. Если версия устарела, вам будет предложено выполнить pull. ```bash $ ./sometools.sh self-update
  root@kitploit:~

• uninstall:

  • Удалить установленный инструмент.
  • Вместо имени инструмента можно использовать его ID номер, который отображается при выполнении ./sometools.sh list. ```bash $ ./sometools.sh uninstall unicorn

  example using an ID number

  $ ./sometools.sh uninstall 4

  root@kitploit:~

• add-tool:

  • add-tool создаст новый каталог в указанной категории. Также будут созданы 3 файла в этом каталоге: install-tool.sh, uninstall-tool.sh и .gitignore.
  • Просмотр других инструментов поможет вам понять, как добавить свой. Это довольно просто. Это три файла, которые действие add-tool создаст для вас.
  • При добавлении инструмента я настоятельно рекомендую называть его так же, как репозиторий. Это облегчит использование действия check-update в дальнейшем. Но если вы хотите другое имя, посмотрите пример с инструментом в каталоге . Возможно, вам придётся изменить файл в каталоге вашего инструмента.

Zsh Functions

• Zsh functions не содержат инструментов для пентеста, они содержат небольшие скрипты, которые значительно помогают моему рабочему процессу, и я подумал, что они могут быть полезны и другим.

• Возможно, их можно использовать и с другими оболочками, но я использую их с zsh.

• Они не будут установлены в процессе настройки. Вам нужно настроить их вручную. Как? Добавив приведённый ниже фрагмент в ваш файл .zshrc.```bash

Custom functions dir

make sure to modify the path below to fit your need

fpath=(~/path/of/sometools/Zsh-Functions $fpath); autoload -U $fpath[1]/*(.:t)

- mkcd: создание каталога и переход в него
- mv: перемещение файла/папки в текущую директорию (с одним аргументом)
- op: открытие файла или папки в файловом менеджере (`op .` для открытия текущей директории)

## Others

- При использовании ID номера вместо имени инструмента используйте ID номер из `./sometools.sh list`, а не `./sometools.sh list-installed`
- Если вы добавляете новый инструмент, требующий специальных инструкций по обновлению, вы можете создать файл `update-tool.sh` в каталоге инструмента (как файлы install-tool.sh и uninstall-tool.sh). При проверке обновлений скрипт some-tools.sh учтёт его.
- Вы **не можете** использовать одно и то же имя для двух инструментов. Это вызовет проблемы. При использовании действия add-tool мы это проверим. Решением было бы указывать название категории при использовании действия, но я **действительно этого не хочу**. Поскольку использование другого имени несложно, на данный момент у меня нет намерения разрабатывать решение, позволяющее использовать одно и то же имя для нескольких инструментов.
- Некоторые устанавливаемые инструменты могут запрашивать права `sudo`!
- Файл `check-git.sh`, включённый в репозиторий, предназначен для действий check-update и check-update-all.
- Я создаю это в свободное время, возможны ошибки. Если количество звёзд начнёт расти, я, возможно, уделю больше времени и усилий.

## License

Каждый инструмент лицензирован под своей собственной лицензией. Что касается Some-Tools, он лицензирован под GNU General Public License v3.0.

⭐ Если вы считаете это полезным, поставьте звезду наверху этой страницы ⭐ или можете купить мне ☕. Спасибо 🔥😎

<a href="https://www.buymeacoffee.com/somecanadian" target="_blank"><img src="https://assets.kitploit.com/production/public/readmes/3722/eecc7380590efb5bd32637f86ef07884b0e9f1f82f7dbf8b2bc7e8410d721225.png" alt="Buy Me A Coffee" height="51" width="217"></a>

## Acknowledgements

- Создано на основе идей <https://github.com/eugenekolo/sec-tools> и <https://github.com/zardus/ctf-tools>.
- Vagrant box от [nicmilot](https://app.vagrantup.com/nicmilot/boxes/kali-full-2020). Вы можете увидеть его другие vagrant box, например: [pwk-kali-2018](https://app.vagrantup.com/nicmilot/boxes/pwk-kali-2018) для VMware Fusion и [Metapsloitable3](https://app.vagrantup.com/nicmilot/boxes/metasploitable3-win2008-vmware) также для VMware Fusion.