owasp/wwwgrepRepositório Web da Fundação OWASP
WWWGrep é um mecanismo de “grepping” de busca rápida que examina elementos HTML por tipo e permite pesquisas focadas (única), múltiplas (URLs baseadas em arquivo) e recursivas (em relação ao domínio raiz ou não) a serem realizadas. Nomes de cabeçalhos e valores também podem ser pesquisados recursivamente dessa maneira. WWWGrep foi projetado para ajudar tanto os atacantes quanto os construtores a examinar rapidamente bases de código sob inspeção. Alguns casos de uso e exemplos são mostrados abaixo.
Instalação
git clone
pip3 install -r requirements.txt
python3 wwwgrep.py <arguments and parameters>
Dependências (pip3 install -r requirements.txt)
- Python 3.5+
- BeautifulSoup 4
- UrlLib.parse
- requests_html
- argparse
- requests
- re
- os.path
wwwgrep.py [target/file] [search_string] [search params/criteria/recursion etc]
Search Inputs
search_string Specify the string to search for or alternatively “”
for all objects of type specified in search parameters
-t --target Specify a single URL as a target for the search
-f --file Specify a file containing a list of URLs to search
Recursion
-rr --recurse-root Limits URL recursion to the domain provided in the target
-ra --recurse-any Allows recursion to extend beyond the domain of the target
Matching Criteria
-i --ignore-case Performs case insensitive matching (default is to respect case)
-d --dedupe Allow duplicate findings per page (default is to de-duplicate findings)
-r --no-redirects Do not allow redirects (default is to allow redirects)
-b --no-base-url Omit the URL of the match from the output (default is to include the URL)
-x --regex Allows the use of RegEX matches (search_string is treated as a RegEX, default is off)
-e --separator Specify and output specifier (default is : )
-j --java-render Turns on JavaScript rendering of page objects and text (default is off)
-p --linked-js-on Turns on searching of linked (script src tags) Java Script (default is off)
Request Parameters
-ps --https-proxy Specify a proxy for the HTTPS protocol in https://<ip>:<port> format
-pp --http-proxy Specify a proxy for the HTTP protocol in http://<ip>:<port> format
-hu --user-agent Specify a string to use as the user agent in the request
-ha --auth-header Specify a bearer token or other auth string to use in the request header
Search Parameters
-s --all Search all page HTML and scripts for terms that match the search specification
-sr --relative Search page links that match the search specification as relative URLs
-sa --absolute Search page links that match the search specification as absolute URLs
-si --input-fields Search page input fields that match the search specification
-ss --scripts Search scripts tags that match the search specification
-st --text Search visible text on the page that matches the search specification
-sc --comments Search comments on the page that match the search specification
-sm --meta Search in page metadata for matches to the search specification
-sf --hidden Search in hidden fields for specific matches to the search specification
-sh --header-name Search response headers for specific matches to the search specification
-sv --header-value Search response header values for specific matches to the search specification
Encontre todos os campos de entrada chamados login em um site recursivamente sem sair do domínio raiz e sem considerar maiúsculas/minúsculas na correspondência
wwwgrep.py -t https://www.target.com -i -si “login” -rr
Encontre todos os comentários contendo o termo “to do” em todas as páginas de um site
wwwgrep.py -t https://www.target.com -i -sc “to do” -rr
Encontre todos os comentários em uma página web específica
wwwgrep.py -t https://www.target.com/some_page -i -sc “”
Encontre todos os campos ocultos dentro de uma lista de aplicações web contidas no arquivo input.txt usando recursão no site
wwwgrep.py -f input.txt -sf “” -rr