diff --git a/sqlmap-user's-manual.md b/sqlmap-user's-manual.md index 1dc7808a7..7d1d523db 100644 --- a/sqlmap-user's-manual.md +++ b/sqlmap-user's-manual.md @@ -163,7 +163,7 @@ sqlmap relies on Metasploit to create the shellcode and implements four differen ## 2011 * **September 23**, Miroslav [presents](http://fsec.foi.hr/index.php/Miroslav_Stampar_-_It_all_starts_with_the_%27_-_SQL_injection_from_attackers_point_of_view) **It all starts with the ' (SQL injection from attacker's point of view)** ([slides](http://www.slideshare.net/stamparm/f-sec-2011miroslavstamparitallstartswiththesinglequote-9311238)) talking about methods attackers use in SQL injection attacks at FSec - FOI Security Symposium in Varazdin, Croatia. -* **June 23**, Miroslav [presents](https://ep2012.europython.eu/conference/talks/sqlmap-security-developing-in-python) **sqlmap - security development in Python** ([slides](http://www.slideshare.net/stamparm/euro-python-2011miroslavstamparsqlmapsecuritydevelopmentinpython)) talking about recent features and upcoming enhancements at EuroPython 2011 in Firenze, Italy. +* **June 23**, Miroslav [presents](https://ep2012.europython.eu/conference/talks/sqlmap-security-developing-in-python) **sqlmap - security development in Python** ([slides](http://www.slideshare.net/stamparm/euro-python-2011miroslavstamparsqlmapsecuritydevelopmentinpython)) talking about sqlmap internals at EuroPython 2011 in Firenze, Italy. * **April 10**, [Bernardo and Miroslav](http://www.sqlmap.org/#developers) release sqlmap **0.9** featuring a totally rewritten and powerful SQL injection detection engine, the possibility to connect directly to a database server, support for time-based blind SQL injection and error-based SQL injection, support for four new database management systems and much more. ## 2010 @@ -225,4 +225,245 @@ of Code 2007. takes it over. * **August**, Daniele adds initial support for PostgreSQL and releases version **0.1**. * **July 25**, [Daniele Bellucci](http://dbellucci.blogspot.com) registers the sqlmap project on SourceForge and develops it on the [SourceForge subversion repository](http://sqlmap.svn.sourceforge.net/viewvc/sqlmap/). The skeleton is implemented and -limited support for MySQL added. \ No newline at end of file +limited support for MySQL added. + + +# Download and update +sqlmap can be downloaded from its (http://sourceforge.net/projects/sqlmap/files/ "SourceForge File List page). It is available in two formats: +* (http://downloads.sourceforge.net/sqlmap/sqlmap-0.9.tar.gz" +name="Source gzip compressed). +* (http://downloads.sourceforge.net/sqlmap/sqlmap-0.9.zip" +name="Source zip compressed). + +You can also checkout the latest development version from the (https://github.com/sqlmapproject/sqlmap "git) +repository: +```$ git clone https://github.com/sqlmapproject/sqlmap.git sqlmap-dev``` + +You can update it at any time to the latest development version by running: +```$ python sqlmap.py --update``` + +Or: +```$ git pull``` + +This is strongly recommended **before** reporting any bug to the [mailing list](http://www.sqlmap.org/#ml). + +# Usage + +``` +$ python sqlmap.py -h + + + sqlmap/1.0-dev - automatic SQL injection and database takeover tool + http://www.sqlmap.org + +[!] legal disclaimer: usage of sqlmap for attacking targets without prior mutual consent is illegal. It is the end user's responsibility to obey all applicable local, state and federal laws. Authors assume no liability and are not responsible for any misuse or damage caused by this program + +[*] starting at 16:38:25 + +Usage: python sqlmap.py [options] + +Options: + --version show program's version number and exit + -h, --help show this help message and exit + -v VERBOSE Verbosity level: 0-6 (default 1) + + Target: + At least one of these options has to be specified to set the source to get target urls from + + -d DIRECT Direct connection to the database + -u URL, --url=URL Target url + -l LOGFILE Parse targets from Burp or WebScarab proxy logs + -m BULKFILE Scan multiple targets enlisted in a given textual file + -r REQUESTFILE Load HTTP request from a file + -g GOOGLEDORK Process Google dork results as target urls + -c CONFIGFILE Load options from a configuration INI file + + Request: + These options can be used to specify how to connect to the target url + + --data=DATA Data string to be sent through POST + --param-del=PDEL Character used for splitting parameter values + --cookie=COOKIE HTTP Cookie header + --load-cookies=LOC File containing cookies in Netscape/wget format + --cookie-urlencode URL Encode generated cookie injections + --drop-set-cookie Ignore Set-Cookie header from response + --user-agent=AGENT HTTP User-Agent header + --random-agent Use randomly selected HTTP User-Agent header + --randomize=RPARAM Randomly change value for given parameter(s) + --force-ssl Force usage of SSL/HTTPS requests + --host=HOST HTTP Host header + --referer=REFERER HTTP Referer header + --headers=HEADERS Extra headers (e.g. "Accept-Language: fr\nETag: 123") + --auth-type=ATYPE HTTP authentication type (Basic, Digest or NTLM) + --auth-cred=ACRED HTTP authentication credentials (name:password) + --auth-cert=ACERT HTTP authentication certificate (key_file,cert_file) + --proxy=PROXY Use a HTTP proxy to connect to the target url + --proxy-cred=PCRED HTTP proxy authentication credentials (name:password) + --ignore-proxy Ignore system default HTTP proxy + --delay=DELAY Delay in seconds between each HTTP request + --timeout=TIMEOUT Seconds to wait before timeout connection (default 30) + --retries=RETRIES Retries when the connection timeouts (default 3) + --scope=SCOPE Regexp to filter targets from provided proxy log + --safe-url=SAFURL Url address to visit frequently during testing + --safe-freq=SAFREQ Test requests between two visits to a given safe url + --skip-urlencode Skip URL encoding of POST data + --eval=EVALCODE Evaluate provided Python code before the request (e.g. "import hashlib;id2=hashlib.md5(id).hexdigest()") + + Optimization: + These options can be used to optimize the performance of sqlmap + + -o Turn on all optimization switches + --predict-output Predict common queries output + --keep-alive Use persistent HTTP(s) connections + --null-connection Retrieve page length without actual HTTP response body + --threads=THREADS Max number of concurrent HTTP(s) requests (default 1) + + Injection: + These options can be used to specify which parameters to test for, provide custom injection payloads and optional tampering scripts + + -p TESTPARAMETER Testable parameter(s) + --dbms=DBMS Force back-end DBMS to this value + --os=OS Force back-end DBMS operating system to this value + --invalid-bignum Use big numbers for invalidating values + --invalid-logical Use logical operations for invalidating values + --no-cast Turn off payload casting mechanism + --prefix=PREFIX Injection payload prefix string + --suffix=SUFFIX Injection payload suffix string + --skip=SKIP Skip testing for given parameter(s) + --tamper=TAMPER Use given script(s) for tampering injection data + + Detection: + These options can be used to specify how to parse and compare page content from HTTP responses when using blind SQL injection technique + + --level=LEVEL Level of tests to perform (1-5, default 1) + --risk=RISK Risk of tests to perform (0-3, default 1) + --string=STRING String to match in the response when query is valid + --regexp=REGEXP Regexp to match in the response when query is valid + --code=CODE HTTP response code to match when the query is valid + --text-only Compare pages based only on the textual content + --titles Compare pages based only on their titles + + Techniques: + These options can be used to tweak testing of specific SQL injection techniques + + --technique=TECH SQL injection techniques to test for (default "BEUST") + --time-sec=TIMESEC Seconds to delay the DBMS response (default 5) + --union-cols=UCOLS Range of columns to test for UNION query SQL injection + --union-char=UCHAR Character to use for bruteforcing number of columns + --dns-domain=DNAME Domain name used for DNS exfiltration attack + + Fingerprint: + -f, --fingerprint Perform an extensive DBMS version fingerprint + + Enumeration: + These options can be used to enumerate the back-end database management system information, structure and data contained in the tables. Moreover you can run your own SQL statements + + -b, --banner Retrieve DBMS banner + --current-user Retrieve DBMS current user + --current-db Retrieve DBMS current database + --is-dba Detect if the DBMS current user is DBA + --users Enumerate DBMS users + --passwords Enumerate DBMS users password hashes + --privileges Enumerate DBMS users privileges + --roles Enumerate DBMS users roles + --dbs Enumerate DBMS databases + --tables Enumerate DBMS database tables + --columns Enumerate DBMS database table columns + --schema Enumerate DBMS schema + --count Retrieve number of entries for table(s) + --dump Dump DBMS database table entries + --dump-all Dump all DBMS databases tables entries + --search Search column(s), table(s) and/or database name(s) + -D DB DBMS database to enumerate + -T TBL DBMS database table to enumerate + -C COL DBMS database table column to enumerate + -U USER DBMS user to enumerate + --exclude-sysdbs Exclude DBMS system databases when enumerating tables + --start=LIMITSTART First query output entry to retrieve + --stop=LIMITSTOP Last query output entry to retrieve + --first=FIRSTCHAR First query output word character to retrieve + --last=LASTCHAR Last query output word character to retrieve + --sql-query=QUERY SQL statement to be executed + --sql-shell Prompt for an interactive SQL shell + + Brute force: + These options can be used to run brute force checks + + --common-tables Check existence of common tables + --common-columns Check existence of common columns + + User-defined function injection: + These options can be used to create custom user-defined functions + + --udf-inject Inject custom user-defined functions + --shared-lib=SHLIB Local path of the shared library + + File system access: + These options can be used to access the back-end database management system underlying file system + + --file-read=RFILE Read a file from the back-end DBMS file system + --file-write=WFILE Write a local file on the back-end DBMS file system + --file-dest=DFILE Back-end DBMS absolute filepath to write to + + Operating system access: + These options can be used to access the back-end database management system underlying operating system + + --os-cmd=OSCMD Execute an operating system command + --os-shell Prompt for an interactive operating system shell + --os-pwn Prompt for an out-of-band shell, meterpreter or VNC + --os-smbrelay One click prompt for an OOB shell, meterpreter or VNC + --os-bof Stored procedure buffer overflow exploitation + --priv-esc Database process' user privilege escalation + --msf-path=MSFPATH Local path where Metasploit Framework is installed + --tmp-path=TMPPATH Remote absolute path of temporary files directory + + Windows registry access: + These options can be used to access the back-end database management system Windows registry + + --reg-read Read a Windows registry key value + --reg-add Write a Windows registry key value data + --reg-del Delete a Windows registry key value + --reg-key=REGKEY Windows registry key + --reg-value=REGVAL Windows registry key value + --reg-data=REGDATA Windows registry key value data + --reg-type=REGTYPE Windows registry key value type + + General: + These options can be used to set some general working parameters + + -t TRAFFICFILE Log all HTTP traffic into a textual file + --batch Never ask for user input, use the default behaviour + --charset=CHARSET Force character encoding used for data retrieval + --check-tor Check to see if Tor is used properly + --crawl=CRAWLDEPTH Crawl the website starting from the target url + --csv-del=CSVDEL Delimiting character used in CSV output (default ",") + --eta Display for each output the estimated time of arrival + --flush-session Flush session file for current target + --forms Parse and test forms on target url + --fresh-queries Ignores query results stored in session file + --hex Uses DBMS hex function(s) for data retrieval + --parse-errors Parse and display DBMS error messages from responses + --replicate Replicate dumped data into a sqlite3 database + --save Save options to a configuration INI file + --tor Use Tor anonymity network + --tor-port=TORPORT Set Tor proxy port other than default + --tor-type=TORTYPE Set Tor proxy type (HTTP - default, SOCKS4 or SOCKS5) + --update Update sqlmap + + Miscellaneous: + -z MNEMONICS Use short mnemonics (e.g. "flu,bat,ban,tec=EU") + --beep Sound alert when SQL injection found + --check-payload Offline WAF/IPS/IDS payload detection testing + --check-waf Check for existence of WAF/IPS/IDS protection + --cleanup Clean up the DBMS by sqlmap specific UDF and tables + --dependencies Check for missing sqlmap dependencies + --disable-hash Disable password hash cracking mechanism + --disable-like Disable LIKE search of identificator names + --gpage=GOOGLEPAGE Use Google dork results from specified page number + --mobile Imitate smartphone through HTTP User-Agent header + --page-rank Display page rank (PR) for Google dork results + --purge-output Safely remove all content from output directory + --smart Conduct through tests only if positive heuristic(s) + --test-filter=TSTF Select tests by payloads and/or titles (e.g. ROW) + --wizard Simple wizard interface for beginner users +``` \ No newline at end of file