Skip to content

Depdep is a merciless sentinel which will seek sensitive files containing critical info leaking through your network

Notifications You must be signed in to change notification settings

bedirhan/depdep

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Depdep is a merciless sentinel which will seek sensitive files containing critical info leaking through your network. Basically, it is a fast and practical sensitive data search tool maintaining personal & commercial data privacy for companies and institutions. It can very well be used by auditors making sure that their network doesn't leak any unauthorized non-compliant data through windows & unix/linux shares.

The usage is easy and configurable, however, certain technical knowledge is necessary, such as using linux console, ability of writing and understanding basic regular expressions, tough the configuration file comes with several sensitive information patterns, etc.

Future Work

  • Process using hostname or ip address
  • Advanced logging operations
  • Advanced debugging operations
  • Detect & process linux shares (NFS)

Installation

In order to run depdep succesfully, you have to install some packages. Packages needed to run depdep succesfully are shown below;

  • nmap -> to scan network and detect opened 445/tcp ports
  • cifs-utils -> to mount windows shares from linux machine
  • mount -> to mount and umount operations
  • smbclient -> to list windows shares
  • samba4-clients -> other operations for listing and accessing windows shares from linux machine
  • findutils -> the find command utility
  • curl -> to upload files to tika and get results

For installation, you can use apt-get. For Kali Linux :

# apt-get install nmap cifs-utils mount smbclient samba4-clients findutils curl

There is tika binary in the script directory. In order to run tika, java must be installed on the system. You can achieve this using apt-get like below;

# apt-get install openjdk-6-jre-headless:amd64

Then you must download tika from internet and run like below;

# /usr/bin/java -jar /opt/tika/tika-server-1.4.jar >/dev/null 2>/dev/null &

Also depdep comes with a script (script/tika.sh) that you can use for managing tika easily. Copy it under /etc/init.d/ and use it below;

# /etc/init.d/tika.sh start
[+] Tika has been started ...

In order to check whether the tika process is running use ps command;

# ps -ef | grep java | grep -v grep
root     13066     1 99 15:52 pts/3    00:00:01 /usr/bin/java -jar /opt/tika/tika-server-1.4.jar

After that, you have to configure depdep configuration file, config/depdep.xml, to run depdep. The configuration is easy to understand and contains directive comments.

Basic Usage

# python depdep.py --config config/depdep.xml

Without "-w 1" option, depdep will resume from its previous work. If you don't want depdep to resume, but start fresh please start it like below;

# python depdep.py --config config/depdep.xml -w 1

About

Depdep is a merciless sentinel which will seek sensitive files containing critical info leaking through your network

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published