File Manual_dumpzilla_en.txt of Package dumpzilla

Overview Repositories Revisions Requests Users Attributes Meta

File Manual_dumpzilla_en.txt of Package dumpzilla

################################################################## [ Index ] ###################################################################

1.- Introduction.
2.- Dependencies installation and Microsoft Windows use tips.
3.- Sintax.
4.- Options.
5.- Examples of use.

############################################################### [ Introduction ] ################################################################

Dumpzilla application is developed in Python 3.x and has as purpose extract all forensic interesting information of Firefox, Iceweasel and Seamonkey browsers to be analyzed. Due to its Python 3.x developement, might not work properly in old Python versions, mainly with certain characters. Works under Unix and Windows 32/64 bits systems. Works in command line interface, so information dumps could be redirected by pipes with tools such as grep, awk, cut, sed... Dumpzilla allows to visualize following sections, search customization and extract certain content.

- Cookies + DOM Storage (HTML 5).
 - User preferences (Domain permissions, Proxy settings...).
 - Downloads.
 - Web forms (Searches, emails, comments..).
 - Historial.
 - Bookmarks.
 - Cache HTML5 Visualization / Extraction (Offline cache).
 - visited sites "thumbnails" Visualization / Extraction .
 - Addons / Extensions and used paths or urls.
 - Browser saved passwords.
 - SSL Certificates added as a exception.
 - Session data (Webs, reference URLs and text used in forms).
 - Visualize live user surfing, Url used in each tab / window and use of forms.

Dumpzilla will show SHA256 hash of each file to extract the information and finally a summary with totals.
Sections which date filter is not possible: DOM Storage, Permissions / Preferences, Addons, Extensions, Passwords/Exceptions, Thumbnails and Session

To use a cache data extraction application (for example MozCache) is recommend to complete the browser forensic analysis.
MozCache: : http://mozcache.sourceforge.net/

####################################################### [ Tips and install dependencies ] #######################################################

Dependencies:
============

- Python 3.x (GNU/Linux Repositories or http://www.python.org/download/)
- Unix Systems with UTF-8 locale /  Windows Systems
- Python Magic Module: https://github.com/ahupp/python-magic

Install Magic Module in Windows:
===============================

1.- Install Magic Module: https://github.com/ahupp/python-magic (python setup.py install)
2.- Get the GnuWin32 File utility (Binaries and Dependencies): http://gnuwin32.sourceforge.net/packages/file.htm
3.- Place magic1.dll from the Binaries package into your C:\windows\system32 directory. 
4.- Put "magic" from the Binaries package into your C:\windows\system32 directory.
5.- Place zlib1.dll and regex2.dll from the Dependencies package into your system32 directory.

Windows Console Tips:
====================

In Windows command line:

set PYTHONIOENCODING=UTF-8

Why? http://wiki.python.org/moin/PrintFails#Windows

Ok, but I still see strange characters in the console !!

Solution 1: Redirect output to a file (>)
Solution 2: Unix is Sexy

Install Magic Module in Unix:
============================

Download Magic Module: https://github.com/ahupp/python-magic

$ cd python-magic-master/
# python setup.py install

################################################################# [ Sintax ] ##################################################################

Dumpzilla command line:
======================

Locate the profile browser directory which will for audit:

- Windows: 'C:\Documents and Settings\xx\Application Data\Mozilla\Firefox\Profiles\xxxx.default'
 - Unix: '$HOME/.mozilla/firefox/xxxx.default/'

Sintax: python dumpzilla.py browser_profile_directory [Options]

Options:

--All (Show everything but the DOM data. Doesn't extract thumbnails or HTML 5 offline)
--Cookies [-showdom -domain <string> -name <string> -hostcookie <string> -access <date> -create <date> -secure <0/1> -httponly <0/1> -range_last -range_create <start> <end>]
--Permissions [-host <string>]
--Downloads [-range <start> <end>]
--Forms	[-value <string> -range_forms <start> <end>]
--History [-url <string> -title <string> -date <date> -range_history <start> <end> -frequency]
--Bookmarks [-range_bookmarks <start> <end>]
--Cacheoffline [-range_cacheoff <start> <end> -extract <directory>]
--Thumbnails [-extract_thumb <directory>]
--Range <start date> <end date>
--Addons
--Passwords (Decode only in Unix)
--Certoverride
--Session
--Watch [-text <string>] (Only Unix: Show in daemon mode the URLs and text form in real time. -text' Option allow filter,  support all grep Wildcards. Exit: Ctrl + C).

Wildcards: '%'  Any string of any length (Including zero length)
           '_'  Single character
	   '\'  Escape character

Date syntax: YYYY-MM-DD HH:MM:SS

################################################################# [ Options ] ##################################################################

--All                             Show all except DOM data and do not extract content (thumbnails or HTML5 offline cache)

--Cookies                         Show cookies and DOM storage if is specified.

-showdom                        Show DOM stored data and cookies.
  -domain <string>                Filter by domain name (Wildcards support).
  -name <string>                  Filter by cookie name (Wildcards support).
  -hostcookie <string>            Filter by Vhost (Wildcards support).
  -access <date>                  Filter by access date (Wildcards support).
  -create <date>                  Filter by creation date (Wildcards support).
  -secure <0/1>                   Filter by cookies with secure flag secure enabled 0:Yes / 1:No.
  -httponly <0/1>                 Filter by HttpOnly type 1:Yes / 0:No.
  -range_last <start> <end>       Filter last access date by range (YYYY-MM-DD HH:MM:SS).
  -range_create <start> <end>     Filter data creation date by range (YYYY-MM-DD HH:MM:SS).

--Permissions                     Show user preferences and permissions set on certain webs.

-host <string>                  Filter by domain (Wildcards support).

--Downloads                       Show the downloads, also history stored, and list directories download.

-range <start> <end>            Filter by download initialization dates (YYYY-MM-DD HH:MM:SS).

--Forms                           Show used forms data and written text in them (Email, comments, searches,...).

-value <string>                 Filter written text in a form (Wildcards support).
  -range_forms <start> <end>      Filter form used date by range (YYYY-MM-DD HH:MM:SS).

--History                         Show visualized webs.

-url <string>                   Filter by URL (Wildcards support).
  -title <title>                  Filter by web "title" (Wildcards support).
  -date <date>                    Filter by access date (Wildcards support).
  -range_history <start> <end>    Filter visualization date by range (YYYY-MM-DD HH:MM:SS).
  -frequency                      Show most visited sites first.

--Bookmarks                       Show stored sites in bookmarks.

-range_bookmarks <start> <end>  Filter last update / installation by date range (YYYY-MM-DD HH:MM:SS).

--Cacheoffline                    Show which domains store offline data (html5) and allow extract their data.

-range_cacheoff <start> <end>   Filter stored date by range (YYYY-MM-DD HH:MM:SS).
  -extract <directory>            Extract offline cache content to specified directory.

--Thumbnails                      Extract browser start or new tab/window thumbnails.

-extract_thumb <directory>      Extract thumbnails pictures (If exist) to specified directory.

--Range <start> <end>             Filter Cookies, Downloads, Forms, history, Bookmarks and offline Cache date by range (YYYY-MM-DD HH:MM:SS).
				  Do not filter: DOM Storage, Permissions / Preferences, Addons, Extensions, Passwords/Exceptions, Thumbnails and  Session.

--Addons                          Show browser used Addons / Extensions and paths / URLs.

--Passwords                       Show stored users and passwords, and decode it (if master key was not used).(Python 2.x)

--Certoverride                    Show added SSL certificates.

--Session                         Show last and next-to-last session data. Last Webs and used forms.

--Watch                           Show in daemon mode the URLs and text form in real time. To finish: Ctrl + C
                                  Edit line 18 with Python3.x path on "python3_path". Example: python3_path = /usr/bin/python3.3

-text <string>                  Filter by text strings, (grep Wildcards support). Example: --Watch -text  "yahoo\|live\|gmail"

############################################################# [ Examples of use ] ###############################################################

=====================================
Cookies with Wildcards and data range:
=====================================

These commands have the same output:

$ python3.2 dumpzilla.py .yle8qt6e.default --Cookies -create 02:35 -name GAPS
$ python3.2 dumpzilla.py .yle8qt6e.default --Cookies -create 02:35:1% -name _AP%
$ python3.2 dumpzilla.py .yle8qt6e.default --Cookies -create 2013-0_-04 %:35:1% -name %A__ -hostcookie www.google.com

Domain: google.com
	Host: www.google.com
	Name: GAPS
	Value: 1:IvFZXoV-6ihRuP658dfr7FjLQcnrhw:0X5FWx6hkt0Fp77C
	Path: /accounts
	Expiry: 2015-03-04 02:35:14
	Last acess: 2013-03-04 02:35:14
	Creation Time: 2013-03-04 02:35:14
	Secure: 0
	HttpOnly: 1

This command print domains and their DOM data with accessed cookies between two given dates.

$ python3.2 dumpzilla.py .yle8qt6e.default --Cookies -domain google%  -range_last "2013-03-04 01:28:09" "2013-03-04 01:28:51" -secure 0 -httponly 0 -showdom

Domain: google.de
	Host: .google.de
	Name: PREF
	Value: ID=e59d6b724e975713:U=ed7938110e81ef61:FF=0:LD=en:TM=1361492092:LM=1361492092:S=XE3J6pRySWKjnNuT
	Path: /
	Expiry: 2015-02-22 01:14:52
	Last acess: 2013-03-04 01:28:11
	Creation Time: 2013-02-22 01:14:52
	Secure: 0
	HttpOnly: 0

Domain: secure.shared.live.com
	DOM data: 1361915953829

==================================
Use of escape characters to filter:
==================================

Not using escape characters:

$ python3.2 dumpzilla.py .yle8qt6e.default --Cookies -name "_ag%"

Domain: objectmix.com
	Host: .objectmix.com
	Name: _agads
	Value: ID=9cd33476f2c9ad11:T=1361492099:S=ALNI_MaEx-Nl-AeR5nAgJq8o_Hz44yDfow
	Path: /
	Expiry: 2015-02-22 01:14:59
	Last acess: 2013-03-04 14:44:13
	Creation Time: 2013-03-04 14:44:13
	Secure: 0
	HttpOnly: 0

Domain: objectmix.com
	Host: .objectmix.com
	Name: Xagads
	Value: 0
	Path: /
	Expiry: 2014-02-22 01:15:01
	Last acess: 2013-03-04 14:44:55
	Creation Time: 2013-03-04 14:44:55
	Secure: 0
	HttpOnly: 0

Using escape characters (two ways, same output)

$ python3.2 dumpzilla.py .yle8qt6e.default --Cookies -name "\_ag%"
$ python3.2 dumpzilla.py .yle8qt6e.default --Cookies -name \\_ag%

==================================================================
Audit real time surfing filtering Yahoo, hotmail and Gmail content:
==================================================================

Remember that "-text" option of "--Watch" can use grep wildcards. This command prints all the windows / tabs that contain "-text".

$ python3.2 dumpzilla.py .mozilla/firefox/yle8qt6e.default --Watch -text  "yahoo\|live\|gmail"

Title: Redactar - luser1985@gmail.com - Gmail
	URL: https://mail.google.com/mail/?shva=1#drafts/13d4aa3d5e74265e

Title: (29 no leídos) - Karl Müller - Yahoo! Mail
	URL: http://es-mg42.mail.yahoo.com/neo/launch?.rand=4vhbkln5s409p#mail

Title: Yahoo! - 404 Not Found
	URL: http://es-mg42.mail.yahoo.com/app/minty/options/general
	Form: {'s1p': 'Big Butt'}

Title: A password is not enough
	URL: https://account.live.com/Proofs/Manage?ru=https://login.live.com/login.srf%3flc%3d3082%26sf%3d1%26id%36%26cbcxt%3dmai%2mspp_shared%3d1%26seclog%3d0%26wa%3dwsignin1.0%26wp%6ru%3dhttp://mail.live.com/default.aspx&mkt=ES-ES&uiflavor=web&id=6455&lqsp=ntprob%3d-1&mpcxt=AFP&oru=http://mail.live.com/default.aspx&lmif=100
	Form: {'Question': {'selectedIndex': 0, 'value': '0'}, 'DisplayPhoneNumber': '650457892', 'EmailAddress': 'recovery@hotmail.com', 'DisplayPhoneCountryISO': {'selectedIndex': 60, 'value': 'ES'}}

=========================
Combining mutiple options:
=========================

$ python3.2 dumpzilla.py .yle8qt6e.default --Cookies  -access "16:32:18" --Permissions -host addons.cdn.mozilla.net --History -date "14:27:32"

Execution time: 2013-03-05 18:55:23.691384
	Mozilla Profile: .mozilla/firefox/yle8qt6e.default

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
	Cookies              [SHA256 hash: d05199c0ff5db35bedb47e536076d0aeda108940edb47e536076d0aeda108940]
	++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

Domain: filldisk.com
	Host: .filldisk.com
	Name: __utmz
	Value: 30275752.1362488826.1.1.utmcsr=(direct)|utmccn=(direct)|utmcmd=(none)
	Path: /
	Expiry: 2013-09-04 05:32:18
	Last acess: 2013-03-05 16:32:18
	Creation Time: 2013-03-05 14:07:05
	Secure: 0
	HttpOnly: 0

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
	DOM Storage          [SHA256 hash: d2edb47e536076d0aeda1089408004d7a11e361a45c660dd507d2aed2b10061b]
	++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

Domain: secure.shared.live.com
	Domain: 2.filldisk.com
	Domain: 1.filldisk.com
	Domain: secure.shared.live.com
	
	++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
	Permissions          [SHA256 hash: 1448abfa05363d0b68bcaeb75bb1bbf2bf873edb47e536076d0aeda10894019c]
	++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
	
	Host: addons.cdn.mozilla.net
	Type: sts/subd
	Permission: 2
	ExpiteType: 0
	ExpiteTime: 1970-01-01 01:00:00
	
	++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
	Preferences          [SHA256 hash: eedb47e536076d0aeda108940371076d8be30ae13751ddd3e42e793cda78a4fd]
	++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

Browser cache disk capacity: 228352
	
	Download directory: /home/jasmin/Descargas
	Last Download directory: /home/jasmin/Escritorio
	
	Browser Version: 19.0
	
	URL proxy autoconfig: http://caca.com/
	
	FTP backup proxy: 127.0.0.1
	FTP backup proxy port: 4001
	Socks backup proxy: 127.0.0.1
	Socks backup proxy port: 4001
	SSL backup proxy: 127.0.0.1
	SSL backup proxy port: 4001
	FTP proxy: 127.0.0.1
	FTP proxy port: 4001
	Http proxy: 127.0.0.1
	Http proxy port: 4001
	Share proxy settings: true
	Socks proxy: 127.0.0.1
	Socks proxy port: 4001
	SSL proxy port: 4001
	Type Proxy: 1 (0: No proxy | 4: Auto detect settings | 1: Manual configuration | 2: URL autoconfig)

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
	History              [SHA256 hash: edb47e536076d0aeda108940f9cabf311389c5b79810a2ac7369bc797307a80e]
	++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

Last visit: 2013-03-05 14:27:32
	Title: لوحة المفاتيح SwiftKey X للأندرويد وتدعم العربية
	URL: http://www.vip4soft.com/%D9%84%D9%88%D8%AD%D8%A9-%D8%A7%D9%84%D9%85%D9%81%D8%A7%D8%AA%D9%8A%D8%AD-swiftkey-x-%D9%84%D9%84%D8%A3%D9%86%D8%AF%D8%B1%D9%88%D9%8A%D8%AF-%D9%88%D8%AA%D8%AF%D8%B9%D9%85-%D8%A7%D9%84%D8%B9%D8%B1.html
	Frequency: 1

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
	Total information
	++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

Total Cookies: 3
	Total DOM Data: 14
	WARNING: For show the DOM storage data , use the option -showdom
	Total Permissions: 2
	Total urls in History: 1

================================
Get the Passwords (NO python3.x):
================================

Show configured webs in order to not save credentials, encoded credentials and their decoded. (Only executing dumpzilla under 2.x brach)

$ python2.7 dumpzilla.py .mozilla/firefox/yle8qt6e.default --Passwords

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
	Exceptions/Passwords [SHA256 hash: 15ba116a979ba4edb47e536076d0aeda1089401cce582b2d78c2fa5fb24a570c]
	+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

Exception Web: https://www.facebook.com
	Exception Web: http://www.gmx.net
	Exception Web: https://login.yahoo.com
	Exception Web: https://accounts.google.com

Web: http://www.shodanhq.com
	User field: username
	Password field: password
	User login (crypted): MDoEEPgAAAAAAAAAAAAAAAAAAAEwFAYIKoZIhvcNAwcECE5kYU15qEEzBBA0nPH2m3bNM3wVEziqY02u
	Password login (crypted): MEoEEPgAAAAAAAAAAAAAAAAAAAEwFAYIKoZIhvcNAwcECE+XsaqLhIfIBCBoHtRGHjQ/Vq3FbPZgq2sGDL/YT9P5PHiUZ0QW6vktew==
	Encripton type: 1
	Created: 2013-03-05 13:19:22
	Last used: 2013-03-05 13:19:22
	Change: 2013-03-05 13:19:22
	Frequency: 21

Web: https://www.facebook.com
	User field: email
	Password field: pass
	User login (crypted): MEoEEPgAAAAAAAAAAAAAAAAAAAEwFAYIKoZIhvcNAwcECIkQJPfZJbL/BCB/lc86x0KEyhw8NBwR/dhJGdXuV0QDCcLqaFg/rVayBw==
	Password login (crypted): MDIEEPgAAAAAAAAAAAAAAAAAAAEwFAYIKoZIhvcNAwcECNHMNFUnu2I+BAiA6BBtclMuFQ==
	Encripton type: 1
	Created: 2013-03-05 13:21:07
	Last used: 2013-03-05 13:21:07
	Change: 2013-03-05 13:21:07
	Frequency: 9

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
	Decode Passwords
	+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

Web: http://www.shodanhq.com:
	Username: Bladimir
	Passsword: Вакансиидерьмо

Web: https://www.facebook.com:
	Username: justinbieber@hotmail.com
	Passsword: 12345

Total passwords: 2
	Total passwords decode: 2

========================
Dumpzilla with grep pipe:
========================

Show installed extensions and paths in C:\ (Windows) used by their.

$ python3.2 dumpzilla.py .yle8qt6e.default --Addons | grep -A 1 -B 1 -i "C:"

Type: theme
	Descriptor: C:\Program Files\Mozilla Firefox\extensions\{972ce4c6-7e08-4474-a285-3208198ce6fd}
	Version: 19.0
	--
	Type: extension
	Descriptor: C:\Documents and Settings\jasminpc\Application Data\Mozilla\Firefox\Profiles\5s28qo2r.default\extensions\exif_viewer@mozilla.doslash.org.xpi
	Version: 2.00
	--
	APP: chrome://exif/content/exif.xul#history-loc-1
	URL/PATH: C:\DocumentsandSettings\AllUsers\Documents\Porn\Sandra_2011\beach.jpg"
	--
	APP: chrome://exif/content/exif.xul#history-loc-1
	URL/PATH: C:\DocumentsandSettings\AllUsers\Documents\Porn\Sandra_2011\ricorico.jpg"

################################################################# [ CopyLeft ] ##################################################################

License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it.  There is NO WARRANTY, to the extent permitted by law.

Places

File Manual_dumpzilla_en.txt of Package dumpzilla

Places