Skip to content

An all-in-one web service & frontend for quickly researching IP's, DNS entries, etc.

Notifications You must be signed in to change notification settings

benhagen/dossier

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

dossier

An all-in-one web service & frontend for quickly researching IP addresses DNS entries, etc.

The intent with this application was to develop some simple rest-ful web services for querying information about IP addresses and hostnames/DNS names. The frontend HTML file consumes this API directly via JavaScript and displays results via mustache.js templates. Why? I wanted to tinker with them.

Not really something you should want to deploy for public consumption yet, but it has been incredibly useful as a personal/internal tool.

Current data sources include:

  • DNS/hostname:
  • whois
  • DNS
  • Shodan Information (if API key is provided)

IPv4 Address:

  • Reverse DNS
  • GeoIP Information (via MaxMind)
  • Shodan Information (if API key is provided)
  • ARIN Record (via the Arin WebAPI)

No attempt has been made to implement IPv6.

Endpoints

The following endpoints respond to restful GET queries with JSON formatted information:

  • /dns/[dns address]
  • /ip/[IPv4 address]

Installation

The following steps will get Dossier working on an Ubuntu 12.04 machine:

  1. Download the MaxMind GeoLite Cuty Free datafile from: http://geolite.maxmind.com/download/geoip/database/GeoLiteCity.dat.gz
  2. Unzip and put it in the same directory as app.py
  3. sudo apt-get install python-pip
  4. sudo pip install flask requests pygeoip dnspython shodan
  5. ./app.py
  6. Goto: http://127.0.0.1:5000 in your web browser

The flask application should be configurable as any other WSGI application for "permanent" installation. See: http://flask.pocoo.org/docs/deploying/ for more information. Again, I wouldn't really recommend exposing this to the untrusted users.

Notes

Next Steps:

  • Implement (better) logging
  • Add more information resources

About

An all-in-one web service & frontend for quickly researching IP's, DNS entries, etc.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published