For more info see Actions Detailed section.

El directorio bin

• El directorio bin se creará al realizar la acción de configuración. Esta será la ruta del directorio que agregaremos a nuestro shell $PATH (your/install/dir/Some-Tools/bin). En el directorio bin pondremos copias (enlaces simbólicos) de las herramientas que queramos que sean ejecutables en cualquier lugar de nuestra máquina. Por ejemplo, una herramienta como unicorn.py, puede que quieras ejecutar unicorn desde cualquier lugar.

• La acción de configuración también creará bin/PrivEsc-Lin y bin/PrivEsc-Win en el proceso. En este directorio guardaremos nuestros scripts de escalada de privilegios. Así que, cuando quieras usar tus herramientas, puedes iniciar un servidor HTTP de Python y cargar rápidamente los scripts que desees. Los scripts en esas carpetas se actualizarán al mismo tiempo que actualices la(s) herramienta(s) con la acción check-update.

Lista de Herramientas

Resumen

• 59 Herramientas

Nota:

• PEAS incluye tanto scripts linPEAS como winPEAS
• BeRoot incluye tanto scripts de Linux como de Windows

Acciones Detalladas

• setup (Proceso de Configuración):

  • Este debería ser el primer comando que ejecutes.
  • Primero te preguntará qué shell quieres usar entre .bashrc o .zshrc (la acción de configuración incorporada no funcionará si no estás usando uno de los dos shells).
  • El script establecerá la variable $SOME_ROOT
  • Después de la configuración, puedes abrir nuevas pestañas/ventanas de terminal o refrescar tu shell (.bashrc o .zshrc) en la terminal actual para activar la nueva ruta. Para ver tu nueva ruta después puedes hacer echo $PATH
  • En tu archivo de shell (.bashrc o .zshrc), copiaremos tu $PATH antes de hacer modificaciones. Se comentará unas pocas líneas antes del final de tu archivo de shell. Así que si quieres restablecer tu ruta a antes de la configuración de Some-Tools, puedes copiar el comando comentado en tu archivo de shell, limpiar lo que creamos en el archivo y finalmente refrescarlo.
  • Creación del directorio Bin. (bin, bin/PrivEsc-Lin y bin/PrivEsc-Win)
  • Puedes leer la sección de configuración en sometools.sh para tener una mejor comprensión. ```bash $ ./sometools.sh setup
  root@kitploit:~

• install y install-all:

  • Instala una herramienta o todas las herramientas.
  • Si instalas solo una herramienta, en lugar de usar el nombre de la herramienta, puedes usar el número de ID que se muestra cuando ejecutas ./sometools.sh list.
  • Cuando instales una herramienta, se creará un archivo .installed en el directorio de la herramienta. Este archivo nos ayudará con nuestra acción list-installed. ```bash $ ./sometools.sh list # see which tool can be install

  install a tool

  $ ./sometools.sh install LinEnum

  example using an ID number

  $ ./sometools.sh install 7

  installing all tools

  $ ./sometools.sh install-all

  root@kitploit:~

• install-cat and uninstall-cat:

  • Instalar todas las herramientas de una categoría.
  • Desinstalar todas las herramientas de una categoría. ```bash

  install cat

  $ ./sometools.sh install-cat PrivEsc-Win

  uninstall cat

  $ ./sometools.sh uninstall-cat PrivEsc-Win

  root@kitploit:~

• check-update y check-update-all:

  • Verificar actualización de una herramienta instalada o de todas las herramientas instaladas
  • check-update funciona para herramientas que provienen de un repositorio git. Si agregas una nueva herramienta que no es un repositorio git (directorio .git), puedes crear un archivo update-tool.sh con tus instrucciones especiales (el archivo debe llamarse update-tool.sh).
  • Si verificas la actualización de solo una herramienta, en lugar de usar el nombre de la herramienta, puedes usar su número de ID que se muestra al ejecutar ./sometools.sh list. ```bash $ ./sometools.sh list-installed # list currently installed tool(s) $ ./sometools.sh check-update LinEnum

  example using an ID number

  $ ./sometools.sh check-update 7

  example with check-update-all

  $ ./sometools.sh check-update-all

  root@kitploit:~

• ¿Por qué dos check-git? check-git.sh solo indica si la herramienta está desactualizada o no. Si detectamos una versión más reciente, te pediremos que ejecutes check-git-action.sh.

• git-search

  • Buscar un repositorio en GitHub
  • El resultado se ordenará por número de estrellas (puedes cambiar la variable sortSearch si lo deseas)
  • Por defecto, el número de resultados será 10 ```bash $ ./sometools.sh git-search LinEnum

  Output more results. Example with 15 (default is 10)

  $ ./sometools.sh git-search LinEnum 15

  root@kitploit:~

• search-poc
  • Busca un PoC en la herramienta PoC-in-GitHub
  • Para poder usar esta función, la herramienta PoC-in-GitHub debe estar instalada. ```bash $ ./sometools.sh search-poc
  root@kitploit:~

• auto-actualización:

  • Esta función ayuda a mantener esta herramienta (Some-Tools) actualizada. Si estás atrasado, te preguntará si deseas hacer pull. ```bash $ ./sometools.sh self-update
  root@kitploit:~

• uninstall:

  • Desinstala una herramienta instalada.
  • En lugar de usar el nombre de la herramienta, puedes usar el número de ID que se muestra al ejecutar ./sometools.sh list. ```bash $ ./sometools.sh uninstall unicorn

  example using an ID number

  $ ./sometools.sh uninstall 4

  root@kitploit:~

• add-tool:

  • add-tool creará un nuevo directorio en la categoría que hayas especificado. También creará 3 archivos en este directorio: install-tool.sh, uninstall-tool.sh y .gitignore.
  • Observar otras herramientas te ayudará a entender cómo añadir la tuya. Es bastante fácil. Son 3 archivos, que la acción add-tool creará por ti.
  • Al añadir una herramienta, recomiendo encarecidamente nombrarla igual que su repositorio. Será más fácil usar la acción check-update después. Pero si quieres un nombre diferente, puedes ver un ejemplo con la herramienta lse en el directorio PrivEsc-Lin. Puede que tengas que cambiar el archivo .gitignore en el directorio de tu herramienta.
  • Si tu herramienta no es un repositorio git, no hay problema. Pero tendrás que modificar el archivo install-tool.sh para que se ajuste a tus necesidades. Si lo haces, la acción check-update no funcionará "de serie" (porque no encontraremos ningún directorio .git). Solución: puedes crear un archivo llamado update-tool.sh (en el directorio de la herramienta) y poner tus comandos de actualización en él. El script some-tools.sh detectará este nombre de archivo al usar la acción check-update. No olvides hacer chmod +x a tu nuevo archivo.
  • .gitignore contendrá el nombre de tu herramienta y .installed. ¿Por qué? Porque no queremos enviar un repositorio git a otro repositorio y no queremos enviar el archivo .installed. ```bash $ ./sometools.sh add-tool newtoolname PrivEsc-Lin

  better example ?

  $ ./sometools.sh add-tool LinEnum PrivEsc-Lin

  root@kitploit:~

• install-tool y update-tool con la API de GitHub

  A veces es necesario descargar herramientas desde la página de releases/latest, como pspy de DominicBreuker. Por lo tanto, para poder actualizar y descargar siempre la última versión, el proceso necesitó un pequeño giro con la API de GitHub. Si agregas una nueva herramienta usando este patrón, puedes usar la función a continuación en tus archivos install-tool.sh y update-tool.sh. ```bash #!/bin/bash

  in this exemple we will download all executables of pspy.

  function gitGetLatestRelease() { gitCounter=0 repoToGet="DominicBreuker/pspy" apiURL="https://api.github.com/repos" while [[ $checkDownloadURL != null ]]; do checkDownloadURL=$(http "$apiURL/$repoToGet/releases/latest" | jq -r ".assets[$gitCounter].browser_download_url") if [[ $checkDownloadURL == null ]]; then break fi # download the release wget "$checkDownloadURL" gitCounter=$((gitCounter + 1)) done } gitGetLatestRelease

  root@kitploit:~

• info:

  • Muestra el archivo README.md de una herramienta instalada.
  • En lugar de usar el nombre de la herramienta, puedes usar su número de identificación que aparece cuando ejecutas ./sometools.sh list.
  • Bat o cat ?
  • Me encanta usar bat en lugar de cat, así que cuando se usa la acción info, some-tools intentará detectar el binario bat. Si lo detecta, te preguntará entre bat o cat.
  • Si no sabes de qué estoy hablando, no te preocupes, cat se usará por defecto sin preguntar si no se detecta bat. ```bash $ ./sometools.sh info LinEnum

  example using an ID number

  $ ./sometools.sh info 7

  root@kitploit:~

• complete-uninstall:

  • Elimina todas las herramientas instaladas, elimina el directorio bin y borra nuestra modificación en .zshrc o .bashrc.
  • Solo eliminaremos la sección "some-tools" en tu archivo .zshrc o .bashrc. Si realizaste algunas modificaciones en el camino, se conservarán.
  • Al completar la desinstalación completa, deberías tener 3 archivos .zshrc o .bashrc. Uno termina en .backup que creamos en la configuración inicial y el segundo, .backup2, antes de eliminar la sección "sometools" en el proceso de desinstalación completa. ```bash $ ./sometools.sh complete-uninstall
  root@kitploit:~

Zsh Functions

• Las funciones de Zsh no contienen herramientas de pentest, contienen pequeños scripts que ayudan mucho a mi flujo de trabajo y pensé que podrían ser útiles para otros también.

• Quizás se pueda usar con otras shells, pero yo lo uso con zsh.

• Esto no se configurará durante el proceso de instalación. Debes hacerlo manualmente. ¿Cómo ? Agregando el fragmento a continuación a tu archivo .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)