/shodan-viz

Shodan.io browser built with Vue.js (hook's 1337 edition)

Primary LanguageJavaScript

shodan-viz

Modern web UI for Shodan.io, a search engine for internet-connected devices. Built with d3.js, Highcharts, and Vue.js.

Demo Screenshot

Dependencies

Installation

  1. $ git clone https://github.com/joshporter1/shodan-viz.git
  2. $ cd shodan-viz && bundle install
  • Optional: Use your own API key in config/initializers.yml
  1. Run $ rackup
  2. Navigate to http://localhost:9292 in a modern browser

Docker Install

For users who already have Docker set up, the proper files have been supplies to get a container up and running quickly. If you don't have Docker, check out Docker Toolbox.

  1. $ git clone https://github.com/joshporter1/shodan-viz.git
  2. $ cd shodan-viz && docker-compose up
  3. Navigate to http://<docker-ip>

Querying

The Shodan API uses a fairly simple querying syntax, ranging from single-word queries to those including filters if your API key supports it.

Example queries:

  • Server: SQ-WEBCAM
  • elasticsearch
  • netgear
  • apache
  • scada
  • admin 1234
  • "china telecom"
  • "default password"

Example filtered queries:

  • nginx city:"Baltimore"
  • "china telecom" country:"CN"
  • "admin 1234" os:"Linux"

Note: the included API key does not support filtering.